Rich in-app event—Tinjauan

In-app event yang ingin Anda kirim mewajibkan pengembang menerapkan kode jika berlaku di aplikasi Anda. Nama event dan parameter event diklasifikasikan sebagai berikut:

• Predefined (Telah ditentukan sebelumnya) : Ini adalah nama event dan parameter event yang biasanya digunakan di antara berbagai aplikasi. Kami sangat menyarankan untuk menggunakan nama event dan parameter event yang telah ditentukan sebelumnya sebanyak mungkin karena alasan berikut:
  • Penamaan yang telah ditentukan sebelumnya memungkinkan pemetaan event secara otomatis ke mitra. 
  • Jika AppsFlyer memutuskan untuk mengubah nama event atau parameter event apa pun, implementasi Anda kompatibel dengan versi sebelumnya.
• Kustom: Ini adalah nama event dan parameter yang Anda tetapkan untuk skenario pengguna tertentu yang terjadi di aplikasi Anda. Anda dapat menggunakan nama event kustom atau string nama parameter, tetapi perlu diingat bahwa event kustom memerlukan pemeliharaan oleh pengembang Anda. Lihat Tips dan Batasan.

Setiap kali Anda mengirim in-app event seperti pembelian atau pemesanan penerbangan, Anda mengirimkannya dengan pendapatan terkait. Satu-satunya parameter yang menghasilkan pendapatan dalam in-app event adalah af_revenue

• Mencatat pendapatan di SDK
• Mencatat Pendapatan di Unity

Anda juga dapat mencatat pendapatan negatif jika pengguna membatalkan pembelian atau jika Anda melakukan pengembalian dana. Untuk mencatat pendapatan negatif, yang harus Anda lakukan adalah menambahkan tanda minus (-) ke nilai pendapatan yang Anda berikan ke af_revenue

af_revenueadalah satu-satunya parameter yang mengakumulasi pendapatan pengguna Anda. Selalu gunakan bersama event in-app yang mewakili penghasil pendapatan sebenarnya dalam logika bisnis Anda.

af_revenuejuga dapat menghasilkan nilai pendapatan negatif jika Anda perlu mencatat event seperti transaksi yang dibatalkan atau pengembalian dana.

Nilai pendapatan hanya boleh berisi angka (dan koma desimal, jika diperlukan):

• Jangan sertakan karakter lain atau format nilai pendapatan dengan cara lain mana pun. Artinya tidak boleh ada koma, tanda mata uang f(atau contoh $), karakter khusus, atau teks.
• AppsFlyer memberikan nilai pendapatan dengan presisi hingga lima desimal.
• Kisaran nilai ini harus -10.000 hingga 10.000 dalam dolar atau jumlah mata uang asli yang setara. Nilai di luar rentang ini disertakan dalam laporan data lengkap, namun tidak dalam laporan teragregasi.
• Contoh: 1234.56
• Jika pendapatan dikirim sebagai string, nilai di dalam tanda kutip harus valid. Misalnya: "1234.56".

Catatan:

• AppsFlyer menampilkan pendapatan persis seperti yang dikirim dari SDK. Nilai ini tidak termasuk penghitungan untuk PPN atau komisi toko aplikasi, dll., kecuali ini disertakan oleh pengembang di sisi SDK sebelum dikirim ke AppsFlyer.

af_currency mewakili mata uang yang dinyatakan dalam af_revenue (atau af_price). Jika af_currency tidak ada di parameter event, AppsFlyer mengirimkannya dengan nilai default "USD".

Anda dapat menggunakanaf_pricesebagai parameter moneter yang tidak dihitung sebagai pendapatan (seperti di event “Tambah ke Keranjang Belanja”). Parameter ini mengacu pada harga barang individual. Jumlah total semua pembelian muncul di bawah parameter af_revenue.

Mata uang pendapatan

Penting untuk memahami cara AppsFlyer menangani pengaturan mata uang dan konversi mata uang.

AppsFlyer menangani selisih antara mata uang pengaturan aplikasi dan mata uang in-app event menggunakan konversi mata uang.

Diagram di atas menunjukkan proses berikut:

1. In-app event dikirim - mata uang berbeda untuk setiap event
2. AppsFlyer menormalkan semua mata uang ke USD
3. AppsFlyer memproses data pendapatan
4. Data pendapatan di dasbor ditampilkan dalam mata uang pengaturan aplikasi
5. AppsFlyer mengisi data pendapatan dalam laporan data lengkap dalam mata uang pengaturan event dan aplikasi

AppsFlyer menggunakan Open Exchange Rates untuk konversi mata uang. Nilai tukar ini diperbarui setiap jam. Kapan pun AppsFlyer melakukan konversi mata uang, AppsFlyer menggunakan nilai tukar pembaruan per jam terakhir.

Konversi mata uang

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"category_a");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"EUR");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

Tampilan mata uang

Mata uang ditetapkan dalam pengaturan aplikasi. Mata uang yang Anda tetapkan di pengaturan aplikasi, adalah mata uang yang muncul di dasbor. Mata uang apa pun yang Anda kirimkan untuk in-app event, pendapatan di dasbor selalu muncul dalam mata uang yang Anda tetapkan di pengaturan aplikasi.

Setelah Anda menentukan in-app event yang ingin Anda ukur, gunakan Pembuat in-app event kami untuk menentukan event dan parameter sebagai berikut:

1. Pilih nama event yang paling sesuai dengan skenario yang ingin Anda rekam.
2. Pilih parameter event yang ingin Anda kaitkan dengan event. Pilih parameter yang akan memberikan konteks tambahan pada event dan memperkaya data.
3. Unduh file yang telah selesai dari pembuat in-app event, lalu bagikan dengan pengembang Anda.

Tabel berikut menyediakan tautan ke artikel yang menyertakan contoh dan alur kejadian dalam aplikasi umum yang kami sarankan untuk direkam per bisnis vertikal.

Bisnis vertikal	Judul artikel
	Event aplikasi game yang direkomendasikan
	Event aplikasi eCommerce yang direkomendasikan
	Event aplikasi hiburan yang direkomendasikan
	Event aplikasi keuangan dan perbankan yang direkomendasikan
	Event aplikasi pinjaman P2P yang direkomendasikan
	Event aplikasi pendidikan online yang direkomendasikan
	Event aplikasi jasa transportasi online (ride-hailing) yang direkomendasikan
	Event aplikasi pemesanan penerbangan yang direkomendasikan
	Event aplikasi pemesanan hotel yang direkomendasikan
	Event aplikasi perawatan kesehatan yang direkomendasikan
	Event aplikasi telekomunikasi yang direkomendasikan
	Event aplikasi eWallet yang direkomendasikan
	Acara taruhan olahraga yang direkomendasikan

In-app event diatribusikan ke sumber media yang bertanggung jawab atas penginstalan di sepanjang masa pakai pengguna. Data event ditampilkan sebagai Life Time Value (Nilai Masa Pakai) atau Activity data (data Aktivitas). 

Anda dapat melihat data in-app event di lokasi berikut:

• Halaman ikhtisar dasbor: Menampilkan performa akuisisi pengguna (UA) LTV secara real-time. Catatan : Ini mencakup pendapatan yang dibagi antara pengguna organik dan non-organik yang dilaporkan melalui in-app event, dan penargetan ulang pendapatan yang diatribusikan dua kali.
• Halaman event: Menampilkan kinerja acara dalam aplikasi LTV di seluruh sumber media
• Laman aktivitas : Menampilkan aktivitas dalam aplikasi untuk rentang tanggal yang dipilih.
• Laporan in-app event data lengkap: Menampilkan data aktivitas, artinya, daftar kronologis tindakan yang dilakukan oleh seluruh basis pengguna Anda. Laporan ini menyertakan nilai parameter event, misalnya:

  {
    "af_level":"10",
    "af_score":"3387",
    "arena":"7",
    "char_type":"paladin"
  }

  Perhatikan bahwa pelaporan data lengkap adalah fitur premium.

Ingat hal berikut ini saat menentukan nama dan parameter event di aplikasi:

• Untuk konsistensi data dalam pelaporan data lengkap, sebaiknya tentukan dan gunakan nama dan struktur in-app event yang sama di semua platform.
• Gunakan jumlah event minimal untuk mempermudah dalam membandingkan kualitas pengguna yang berasal dari sumber yang berbeda.
• Penting bagi Anda untuk memastikan privasi pengguna Anda. Jangan mengisi nilai in-app event dengan data terbatas yang dapat mengidentifikasi mereka secara langsung. Misalnya alamat email, nama, nomor identitas, dan di beberapa lokasi kode pos. Untuk informasi selengkapnya tentang data yang dibatasi, baca kebijakan privasi layanan.
• Perhatikan bahwa AppsFlyer mengumpulkan alamat IP perangkat selama interaksi. Dalam beberapa yurisdiksi atau skenario penggunaan, alamat IP dapat dianggap sebagai informasi pribadi (PII). Kami menggunakan alamat IP untuk mendapatkan lokasi geografis yang luas (kota, tingkat kecamatan) perangkat tetapi bukan alamat spesifik. Jika perlu, Anda dapat memilih untuk menyembunyikan alamat IP agar tidak muncul dalam laporan data lengkap. 
• Event in-app adalah satu-satunya sumber data pendapatan di AppsFlyer. Anda dapat melampirkan nilai pendapatan tertentu untuk setiap event dan melihatnya di dashboard aplikasi. Pelajari lebih lanjut tentang parameter monetisasi.

  

Ingat hal berikut ini saat menentukan nama dan parameter event di aplikasi:

• Sebaiknya gunakan hanya karakter alfanumerik huruf kecil (az dan 0-9) untuk nama in-app event Anda. Nama peristiwa peka huruf besar/kecil, artinya af_purchase dan af_PURCHASE adalah dua peristiwa berbeda dalam data lengkap. Namun, dalam laporan gabungan (misalnya, Ikhtisar, atau event), laporan tersebut dapat ditampilkan sebagai satu event.
• Ada batas kardinalitas 300 event unik per hari. Pelajari lebih lanjut
• Pengguna unik hanya dihitung untuk 100 event pertama setelah mereka menginstal aplikasi.
• Nama event tidak boleh diawali dengan karakter berikut: " = + - 
• Nilai event tidak boleh berisi karakter + , kecuali dalam URL yang disandikan atau disandikan sesuai ASCII.
• Nama event tidak boleh berisi spasi kosong. Anda dapat gunakan spasi yang digarisbawahi (tanda hubung bawah) sebelum atau sesudah nama event.
• Nilai event tidak boleh melebihi 2000 karakter karena nilai mungkin akan dipersingkat dalam laporan data lengkap. 
• Jika Anda menyertakan URL pengarah sebagai nilai event, itu harus berupa URL yang disandikan .
• Meta ads memiliki beberapa batasan mengenai nama peristiwa dan parameter. Baca tentang batasan di sini.

Anda dapat mengirim nilai pendapatan dengan nama parameter dan event apa pun. Namun, untuk mendaftarkan pendapatan (termasuk pendapatan negatif) di data lengkap dan gabungan AppsFlyer, Anda HARUS menggunakan parameter af_revenue. Selalu gunakan parameter tersebut bersama in-app event yang mewakili penghasil pendapatan sebenarnya dalam logika bisnis Anda.

af_currency mewakili mata uang yang dinyatakan dalam af_revenue (atau af_price ). Jika af_currency tidak ada di parameter event, AppsFlyer mengirimkannya dengan nilai default "USD".

Untuk informasi selengkapnya tentang parameter af_revenue , lihat panduan Atribusi Pendapatan .

In-app event diatribusikan ke sumber media asli penginstalan aplikasi.

Saat menginstal aplikasi (peluncuran aplikasi pertama) AppsFlyer menggunakan berbagai metode atribusi untuk menentukan atribusi penginstalan. Pada saat yang sama, AppsFlyer SDK membuat ID AppsFlyerunik yang baru, yang dikaitkan dengan rincian atribusi.

Setiap in-app event yang dilakukan oleh perangkat yang sama dalam aplikasi memiliki ID ini. Hal ini memungkinkan AppsFlyer untuk mengatribusikan event tersebut ke sumber media asli. Pengiklan dapat menggunakan ini untuk mengikuti perjalanan pengguna lengkap di aplikasi mereka.

Event pengguna yang baru-baru ini ditargetkan ulang dapat memiliki atribusi ganda.

AppsFlyer mengatribusikan event penginstalan yang diatribusikan sebagai organik jika:

• Sudah lebih dari 24 bulan sejak tanggal penginstalan
• Persyaratan sumber media menginstruksikan penghapusan data tingkat pengguna
• Pengguna menghapus data aplikasi yang tersimpan di perangkat, memaksa pembuatan ID AppsFlyer yang baru.

Jika pengguna menginisiasi event (aktivitas) saat koneksi internet tidak tersedia, AppsFlyer tetap dapat merekamnya. Ini cara kerjanya:

1. SDK mengirimkan event ke server AppsFlyer dan menunggu respons yang berhasil.
2. Jika SDK tidak menerima respons yang berhasil, event tersebut disimpan dalam cache.
3. Setelah respons berhasil berikutnya diterima, event yang disimpan dikirim ke server lagi.
4. Jika ada beberapa event dalam cache, mereka akan dikirim ke server, satu demi satu.

Event In-App Kompleks memungkinkan pengiriman beberapa event dalam satu panggilan API.

Ini berguna saat Anda ingin melihat beberapa tindakan pengguna yang terkait erat dikelompokkan bersama (misalnya, menambahkan beberapa produk ke keranjang dalam satu sesi).
Contoh:

{
  "af_revenue":"50.87",
  "af_currency":"USD",
  "af_receipt_id":"57601333",
  "product":[ 
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1177_8185",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"0153_9077",
	 "af_price":"14.99",
	 "af_quantity":"1"
   }
  ]
}

Anda dapat menambahkan beberapa item dalam satu transaksi. Alih-alih satu nilai per parameter event, Anda dapat memiliki array item yang menjelaskan transaksi, dipisahkan dengan koma. Formatnya harus berupa string JSON.

"{\"af_content_id\": [\"123\",\"988\",\"399\"], \"af_quantity\": [\"2\",\"1\",\"1\"], \"af_price\": [\"25\",\"50\",\"10\"], \"af_revenue\": \"110\", \"af_currency\": \"USD\"}"

Kami memiliki mekanisme deduplikasi in-app event. Ini memeriksa semua in-app event untuk melihat apakah ada in-app event yang identik yang berasal dari appsflyer_id yang sama kurang dari 10 detik sebelumnya. Jika event tersebut ditemukan, mekanisme menghapus duplikat tersebut.

Dua event dianggap identik jika kolom berikut di kedua event itu sama:

• eventName
• nilai event
• ID Aplikasi
• AppsFlyer ID

AppsFlyer mempertahankan data tingkat pengguna (data lengkap) selama 24 bulan kecuali jika diatur, diwajibkan, atau diizinkan oleh undang-undang. Beberapa SRN/mitra memerlukan penyedia atribusi, termasuk AppsFlyer, untuk menghapus data tingkat pengguna terkait SRN/mitra sebelum berakhirnya periode 24 bulan.

Setelah dihapus, event yang terkait dengan pengguna yang dihapus ditampilkan sebagai organik. Data agregat sebelumnya tidak diubah. Untuk informasi lebih lanjut, lihat Kewajiban penyimpanan dan penghapusan data.

• SDK Android dan SDK iOS secara otomatis menambahkan parameter OS (sistem operasi).
• Untuk S2S API, mulai 1 Juli 2021, Anda harus mengirimkan parameter OS (sistem operasi) untuk aplikasi iOS. Jika Anda tidak mengirim parameter ini, data dianggap berasal dari pengguna iOS 14.5, dan ini memengaruhi cara penyediaan data lengkap.