Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. Amazon App Store
Code

Cara Migrasi ke Amazon dalam Aplikasi Pembelian Dari Google

by
Difficulty:IntermediateLength:LongLanguages:
Sponsored Content

This sponsored post features a product relevant to our readers while meeting our editorial guidelines for being objective and educational.

Indonesian (Bahasa Indonesia) translation by Ilham Saputra (you can also view the original English article)

Final product image
What You'll Be Creating

Selamat Datang. Jika Anda baru di Amazon Appstore, lihat panduan pengantar terbaru kami, Cara Mengirim Aplikasi Anda ke Amazon Appstore. Dalam episode hari ini, saya akan memandu Anda melalui manfaat dan persyaratan Amazon In-App Purchasing (IAP). Secara khusus, saya akan menjelaskan bagaimana Anda dengan aplikasi Google Play yang memanfaatkan Google IAB dapat dengan mudah memigrasikan aplikasi mereka untuk bekerja dengan Amazon IAP.

Manfaat dari Amazon Appstore

Sebelum kita menyelam, saya hanya ingin merangkum manfaat dari Amazon Appstore.

Saat Anda menambahkan aplikasi ke Amazon Appstore, aplikasi ini dapat dilihat oleh pengguna Android dan Fire di lebih dari 200 negara, dan pengembang kini dapat mencantumkan aplikasi web PC, Mac, dan HTML5 serta aplikasi Android mereka. Dengan mengirimkan aplikasi, aplikasi web, atau game ke program, Anda dapat mengembangkan bisnis dan pendapatan Anda.

Menurut Statista, saat ini ada lebih dari 600.000 aplikasi di Amazon Appstore.

Selain tutorial hari ini, Anda dapat menemukan banyak informasi bermanfaat di portal Pengembang Amazon.

Pindah Dari Google Play ke Amazon App Store

Jika aplikasi Android Anda sudah ada di Google Play store, akan lebih mudah untuk bergabung dengan Amazon Appstore. Amazon melaporkan bahwa lebih dari 85% aplikasi Android hanya bekerja di Kindle Fire tanpa pengembangan tambahan yang diperlukan. Berikut adalah video singkat yang membimbing Anda melalui proses, Pindah dari Google Play ke Amazon Appstore (video):

Tetapi jika Anda menggunakan IAB Google, Anda harus beralih, dan saya akan menunjukkan caranya.

Sebelum melangkah lebih jauh, saya ingin mendorong Anda untuk menghubungi dengan pertanyaan apa pun yang mungkin Anda miliki tentang tutorial. Posting mereka di komentar di bawah atau ke saya @lookahead_io di Twitter. Beri tahu kami jika Anda ingin melihat lebih banyak tutorial tentang Amazon Appstore atau AWS secara umum.

Memahami API Pembelian Dalam Aplikasi

Dengan API Pembelian Dalam Aplikasi, Anda dapat mengaktifkan kumpulan fitur dan skenario yang menarik seperti:

  • Membuat model "freemium" untuk aplikasi Anda, di mana aplikasi itu sendiri gratis tetapi Anda mengenakan biaya premium untuk layanan atau fungsi lanjutan
  • Memungkinkan pelanggan untuk membeli mata uang dalam aplikasi langsung dalam pengalaman aplikasi Anda
  • Memungkinkan pelanggan untuk berlangganan konten yang tersedia dalam aplikasi Anda
  • Membuat konten tersedia untuk dibeli agar dapat dilihat dalam aplikasi Anda

Amazon In-App Purchasing API memungkinkan aplikasi Anda untuk menyajikan, memproses, dan memenuhi pembelian konten digital dan langganan dalam pengalaman aplikasi Anda. Untuk mengaktifkan set fitur ini, cukup terapkan API Pembelian Dalam Aplikasi sebagaimana diperinci dalam bagian implementasi di bawah ini:

Amazon In-Appp Purchasing API Implementation Flowchart

API Pembelian Dalam Aplikasi dirancang untuk merangkum kerumitan di balik proses pembelian sambil menyediakan API berfitur lengkap. API Pembelian Dalam Aplikasi akan menangani detail tentang arus pembelian, pemrosesan pembayaran, memberikan tanda terima ke aplikasi Anda, dan mengelola hak atas konten yang dapat dibeli.

Setelah membangun etalase, Anda dapat menggunakan API Pembelian Dalam Aplikasi untuk menjual item yang dapat dibeli:

Ada tiga jenis barang yang dapat dibeli:

  • Barang habis pakai: konten yang tidak memerlukan hak hak akses atau penggunaan, dapat dibeli beberapa kali oleh pelanggan, hanya tersedia pada perangkat tempat ia dibeli, dan tidak memerlukan jenis pemeriksaan hak untuk digunakan.
  • Hak: konten yang membutuhkan hak atau hak akses untuk menggunakan, dapat dibeli hanya sekali oleh pelanggan, dan tersedia di semua perangkat yang kompatibel yang terdaftar ke akun pelanggan.
  • Langganan: konten yang membutuhkan hak atau hak akses untuk digunakan, terikat oleh jangka waktu tertentu, pembaruan otomatis, dan tersedia di semua perangkat yang memenuhi syarat yang terdaftar di akun Amazon pelanggan

Klien Amazon

Klien Amazon adalah bagian integral dari API Pembelian Dalam Aplikasi. Setelah Anda memulai pembelian, Klien Amazon memunculkan dan menyajikan antarmuka pengguna bermerek Amazon untuk menyelesaikan transaksi. Aliran ini digunakan oleh semua aplikasi yang memilih untuk menggunakan API Pembelian Dalam Aplikasi.

Jika Klien Amazon tidak diinstal atau tidak tersedia, pesan akan muncul ke pelanggan yang menunjukkan tindakan yang tepat.

Klien Amazon menyajikan antarmuka pengguna untuk semua aspek alur kerja pembelian. Ini menyediakan logika untuk menampilkan barang yang dapat dibeli, melakukan pembelian 1-Klik itu sendiri, dan menangani setiap prakondisi atau skenario kesalahan yang muncul.

Memberikan tautan langsung ke Klien Amazon dari dalam aplikasi Anda adalah alat yang efektif untuk mempromosikan aplikasi Anda. Jenis tautan ini disebut sebagai tautan dalam. Informasi lebih lanjut tentang tautan dalam dapat ditemukan di dokumentasi.

Pemisahan Tanggung Jawab

Saat mengembangkan dengan Amazon In-App Purchasing API, penting untuk memahami bagian mana dari alur pembelian yang harus diterapkan aplikasi, dan bagian mana yang ditangani oleh Klien Amazon.

Klien Amazon akan mengurus alur kerja pembelian, mulai ketika pelanggan memutuskan untuk membeli barang dan berakhir ketika toko memberikan aplikasi tanda terima untuk pembelian (atau status lain dalam kasus pembelian gagal). Pengembang tidak boleh menyediakan dialog pembelian, logika waktu transaksi, atau dialog "Terima kasih". Ini semua disediakan oleh Klien Amazon. Silakan lihat bagian Pedoman Antarmuka Pengguna dan Konvensi untuk detail lebih lanjut.

Jika pembelian tidak berhasil, Klien Amazon akan menyajikan pesan kepada pelanggan; aplikasi Anda tidak boleh mengirim pesan kepada pelanggan. Misalnya, jika pelanggan tidak memiliki kartu kredit yang valid di file, klien mengalihkan pelanggan ke halaman di mana mereka dapat memperbarui informasi pembayaran mereka. Anda tidak boleh memberikan konfirmasi atau dialog interstisial lainnya kepada pelanggan terkait arus pembelian.

Aplikasi Anda Amazon
Menyajikan katalog barang-barang dalam aplikasi ke pelanggan untuk pembelian Mengelola arus pembelian
Membuka fungsionalitas pembelian Melakukan proses pembayaran
Unduh konten yang dikirim dari jarak jauh Menangani komunikasi aman dengan platform Amazon, termasuk keamanan pembayaran
Menampilkan dan menggunakan barang digital yang diunduh
Memverifikasi hak dan memvalidasi pembelian penerimaan
Melacak pembelian pelanggan dan inventaris habis pakai
Mengatur langganan, termasuk pembaruan otomatis dan pencabutan hak

Sumber Konten

Aplikasi Anda dapat memanfaatkan API Pembelian Dalam Aplikasi dalam berbagai cara. Cara Anda memilih untuk menerapkannya dapat memengaruhi cara Anda membangun aplikasi. Tidak peduli bagaimana Anda memilih untuk menerapkannya, ada dua alur dasar yang tersedia untuk Anda: konten yang tersedia secara lokal dan konten yang dapat dikirimkan.

Konten yang Tersedia Secara Lokal

Konten yang tersedia secara lokal dibuka kuncinya atau disediakan untuk pelanggan saat pembelian. Di bawah model ini, aplikasi Anda sudah memiliki semua yang dibutuhkan bagi pelanggan untuk menggunakan barang yang dapat dibeli kecuali hak untuk menggunakannya. Anda dapat menggunakan ketiga jenis barang yang dapat dibeli dengan model ini.

Aplikasi Anda harus berisi pengenal unik untuk setiap item yang dapat dibeli (SKU), kemampuan untuk menyajikan katalog kepada pelanggan, dan logika dalam aplikasi untuk membuka kunci barang yang dapat dibeli setelah transaksi sukses.

Penyampaian Konten

Konten yang dikirim memungkinkan Anda untuk membuat konten baru tersedia bagi pelanggan. Di bawah model ini, aplikasi Anda akan mengunduh konten baru dari server Anda dan membuatnya tersedia bagi pelanggan.

Aplikasi Anda harus berisi pengenal unik untuk setiap item yang dapat dibeli (SKU), kemampuan untuk menyajikan katalog kepada pelanggan, dan logika dalam aplikasi untuk mengunduh, bertahan, dan menyediakan konten yang diunduh setelah transaksi yang berhasil.

Ingat: IAP v1.0 Sudah Tidak Digunakan Lagi

Pada bulan Juli 2014, Amazon merilis API In-App Purchasing (IAP) v2.0, yang mencakup beberapa pembaruan penting. Mulai 30 April 2016, Amazon menghentikan IAP v1.0 untuk pengiriman aplikasi baru dan yang diperbarui. Meskipun penghentian ini tidak memengaruhi aplikasi yang sudah aktif di Amazon Appstore, aplikasi apa pun yang dikirimkan sebagai aplikasi baru atau yang diperbarui setelah 11 Mei 2016 perlu menggunakan IAP v2.0.

Bermigrasi dari Penagihan Google Play In-App Billing (IAB) v3.0 ke Amazon In-App Purchasing (IAP) v2.0

Sekarang, mari kita bahas perbedaan antara Google Play In-App Billing (IAB) dan Amazon In-App Purchasing (IAP) dan berikan deskripsi tingkat tinggi tentang cara menyesuaikan aplikasi Anda untuk menggunakan kedua set API.

Apa Itu IAB dan IAP?

Fitur Penagihan Dalam Aplikasi Google Play memungkinkan pengguna melakukan pembelian barang virtual langsung dari aplikasi Anda. Misalnya, pengguna dapat membeli tingkat tambahan ke permainan yang ia mainkan.

Pembelian Dalam Aplikasi Amazon adalah fitur yang setara untuk Amazon API. Jika Anda memiliki aplikasi yang menggunakan fitur Penagihan Dalam Aplikasi Google Play, Anda dapat dengan mudah memodifikasi kode Anda untuk menggunakan fitur In-App Purchasing yang setara dengan Amazon. Kedua set API memiliki fungsi serupa dengan beberapa perbedaan dalam penamaan dan terminologi.

Persyaratan untuk Amazon Appstore dan Amazon Devices

Jika Anda akan mengirimkan aplikasi yang menerapkan IAB Google Play ke Amazon Appstore agar tersedia untuk dijalankan di perangkat Amazon, seperti tablet Api, aplikasi Anda harus menerapkan IAP Amazon untuk pembelian dalam aplikasi. IAB Google Play tidak akan berfungsi di perangkat Amazon.

Amazon IAP v2.0 vs. Google Play IAB v3.0

Perbandingan Fitur

Tabel di bawah ini menunjukkan perbandingan antara API IAP Amazon dan API IAB Google Play:

Fitur IAP v2.0 (Amazon) IAB v3.0 (Google Play)
Komentar
Pembelian
Maksud yang ditangani oleh API.
Y N
Kerangka panggilan API sederhana disediakan.
Y N
Bahan habis pakai Y Y
Barang konsumsi perorangan dapat dibeli beberapa kali.
Y Y
Hak
Dibeli satu kali. Pengguna diberi tahu jika mereka mencoba membeli hak yang sudah mereka miliki. Y Y
Langganan
Berbagai opsi untuk periode waktu langganan berlangsung. Y Y Pilihan Amazon: Mingguan, Dua mingguan, Bulanan, Bi-Bulanan, Triwulanan, Semi-tahunan, Tahunan Google Play Pilihan: Bulanan, Tahunan, Musiman (khusus)
Mendukung periode uji coba gratis. Y Y
Opsi perpanjangan otomatis Y Y
Opsi penagihan tangguhan N Y
Verifikasi tanda terima

Layanan verifikasi tanda terima untuk pembelian Y Y Meskipun Google Play menyediakan verifikasi tanda terima, proses verifikasi penerimaan Google Play tidak otomatis.

Objek Managed Google Play vs. Habis dan Kepemilikan Amazon

Sementara IAP Google Play dan IAP Amazon keduanya memungkinkan pelanggan Anda melakukan pembelian dalam aplikasi yang sama, Google Play dan Amazon menggunakan terminologi yang berbeda untuk jenis pembelian mereka. Tabel berikut mencatat Google Play yang setara untuk setiap jenis pembelian Amazon:

Amazon Deskripsi Setara dengan Google Play Contoh
Habis Beli yang dibuat, lalu dikonsumsi dalam aplikasi, biasanya permainan. Dapat dibeli beberapa kali. Produk dalam aplikasi yang dikelola Kehidupan ekstra atau bergerak (dalam permainan), amunisi tambahan untuk karakter dalam game.
Hak Pembelian satu kali untuk membuka akses ke fitur atau konten dalam aplikasi atau game. Produk dalam aplikasi yang dikelola Buka level tambahan dalam game atau fitur "hanya anggota premium" dalam aplikasi.
Berlangganan Menawarkan akses ke set konten premium atau fitur untuk jangka waktu terbatas. Berlangganan Langganan majalah online, akses liga sepakbola fantasi.

Seperti yang Anda lihat, Google Play's IAB memperlakukan semua pembelian non-langganan dengan cara yang sama; barang dibeli, lalu dikonsumsi oleh pengguna. Setelah item telah dikonsumsi, item tersebut disediakan dalam aplikasi, dan konsumsi dicatat. Untuk item yang kemungkinan akan menjadi pembelian satu kali, seperti membuka level permainan baru, Anda memiliki opsi sebagai pengembang untuk memperlakukan item sebagai logika yang dapat dikonsumsi atau tidak dikonsumsi dan memperkenalkan untuk memastikan bahwa pembelian item tersebut hanya terjadi sekali.

Dengan IAP Amazon, pembelian satu kali ini dipisahkan berdasarkan desain dari pembelian, seperti kehidupan ekstra, yang dapat dibeli pengguna aplikasi lagi dan lagi.

Porting Kode Anda

Mari memandu Anda melalui porting Aplikasi dari API IAB Google Play ke API IAP Amazon:

  1. Konfigurasikan file AndroidManifest.xml Anda untuk mendukung IAP Amazon.
  2. Di aplikasi Anda, terapkan logika untuk memediasi antara IAB dan IAP.
  3. Tambahkan dan terapkan API IAP Amazon.
  4. Uji aplikasi Anda.

Mengonfigurasi File AndroidManifest.xml Anda

Konfigurasikan file AndroidManifest.xml Anda untuk menentukan Penerima Respons IAP untuk aplikasi Anda. Penerima Respons IAP memastikan bahwa komunikasi niat dari Klien Amazon disadap oleh aplikasi Anda. Perhatikan bahwa jika Anda mendukung IAB Google Play dan IAP Amazon, Anda tidak perlu menghapus elemen yang terkait dengan IAB; mereka hanya akan diabaikan oleh IAP.

Di file AndroidManifest.xml Anda, tambahkan tag <receiver>  yang sesuai untuk IAP ResponseReceiver:

Menerapkan Logika untuk Memediasi Antara IAB dan IAP

Anda dapat menggunakan basis kode yang sama untuk aplikasi Anda, terlepas dari di mana aplikasi Anda dihosting. Cukup tambahkan logika ke aplikasi Anda untuk menentukan apakah aplikasi diunduh dari Amazon Appstore atau dari Google Play. Bergantung pada tempat pengguna mengunduh aplikasi, jalankan metode yang sesuai untuk IAP atau IAB.

Kode contoh berikut menentukan apakah paket diinstal dari Google Play atau Amazon Appstore:

Menambah dan Menerapkan API IAP Amazon

Untuk sebagian besar, IAP Amazon bekerja sama dengan IAB Google Play. Saat Anda membuat jalur dalam kode untuk menerapkan IAP API, Anda harus dapat menggunakan alur logika yang mirip dengan IAB, tetapi perlu memperhitungkan kelas dan nama metode yang berbeda.

Tabel berikut memetakan metode IAP yang paling sering digunakan ke persamaan IAB mereka:

Metode PurchasingService Callback PurchasingListener Objek respons Panggilan IAB setara
getUserData() onUserDataResponse() UserDataResponse N/A
getPurchaseUpdates() onPurchaseUpdatesResponse() PurchaseUpdatesResponse getPurchases()
getProductData() onProductDataResponse() ProductDataResponse getSkuDetails()
purchase() onPurchaseResponse() PurchaseResponse getBuyIntent()
notifyFulfillment() N/A N/A consumePurchase()

Perhatikan bahwa panggilan notifyFulfillment() Amazon dan panggilan Google Play’s consumePurchase() saling terkait satu sama lain. Memanggil consumPurchase() pada item yang dikelola untuk IAB akan mengembalikan status item ke "tidak membeli", pada dasarnya mengonversinya menjadi barang konsumsi. Setelah itu, tanda terima tidak akan lagi muncul di respon dari panggilan berikutnya untuk getPurchases(). Amazon akan mengembalikan tanda terima untuk barang habis pakai dalam panggilan untuk getPurchaseUpdates() sampai aplikasi memanggil notifyFulfillment().

Untuk informasi lebih lanjut tentang kelas dan metode IAP, lihat Referensi API Pembelian Dalam Aplikasi v2.0.

Menguji Aplikasi Anda

Unduh dan instal alat App Tester untuk menguji aplikasi IAP v2.0-terintegrasi Anda. Alat ini juga dapat menguji Mobile Associates APIs, jika aplikasi Anda menggunakan itu juga. Ikuti petunjuk dan tautan dalam Pengujian In-App Purchasing (IAP) untuk menginstal dan menggunakan Penguji Aplikasi.

Setelah menguji aplikasi Anda secara lokal, Anda dapat menggunakan layanan Pengujian Aplikasi Langsung untuk menguji beta aplikasi Anda di lingkungan produksi langsung dengan sekelompok pengguna terpilih.

Penutup

Saya harap Anda menikmati panduan hari ini dan juga cara kami sebelumnya Cara Mengirimkan Aplikasi Anda ke episode Amazon Appstore. Harap beri tahu kami area Amazon Appstore mana yang ingin Anda sembunyikan lebih detail. Anda dapat mempostingnya di komentar di bawah atau menghubungi saya di Twitter @lookahead_io.

Jika Anda menyukai tutorial ini, pastikan untuk memeriksa seri saya untuk membangun startup dengan PHP, dan ikuti terus halaman tutorial Envato Tuts+ untuk melihat beberapa tutorial dan seri saya yang lain.

Link Terkait

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.