Rich in-app event—Tinjauan

Sekilas: Rekam rich in-app event pasca penginstalan (seperti login, pendaftaran, atau pembelian dalam aplikasi) yang diatribusikan dengan sumber media dan kampanye.

 Bacaan terkait

Untuk gambaran lengkap tentang cara bekerja rich in-app event, pastikan untuk membaca artikel berikut:

Mengapa merekam in-app event?

In-app event memberikan wawasan tentang apa yang terjadi di aplikasi Anda dan merupakan alat yang ideal untuk menentukan nilai pengguna aplikasi dan kualitas lalu lintas yang berasal dari sumber media yang berbeda . Merekam in-app event membantu Anda mengukur KPI seperti ROI (Laba atas Investasi) dan LTV (Nilai Periode Retensi).

Jika pengguna melakukan registrasi, menyelesaikan tutorial, menambahkan item ke keranjang belanja, atau melakukan pembelian, maka data in-app event dapat mencatat event beserta detailnya. Implementasi in-app event adalah wajib untuk semua tujuan analisis pasca penginstalan.

Tentang in-app events

In-app event terdiri dari nama event dan dapat menyertakan parameter event. Saat Anda menambahkan parameter event ke in-app event, ini disebut sebagai rich in-app event. Parameter event memberi Anda lebih banyak konteks dan informasi tentang event yang terjadi. Misalnya, meskipun parameter ini membantu mengetahui bahwa pengguna melakukan pemesanan, parameter event dapat memberi Anda detail seperti jenis pembelian, tujuan, dan pendapatan.

travel.png

Event kustom dan yang telah ditentukan sebelumnya

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.

Mengirim event

Ada beberapa cara untuk mengirim in-app event ke AppsFlyer:

  • SDK AppsFlyer: Ini adalah cara paling umum untuk mengirim event. Anda dapat mengirimkan rich in-app event yang merekam tindakan pengguna di aplikasi menggunakan API in-app event AppsFlyer pada level SDK.
  • API Sever-to-server: Gunakan API server-ke-server untuk mengirim event yang terjadi di luar aplikasi seluler, langsung ke AppsFlyer. Misalnya, jika Anda memiliki pengguna yang aktif baik di web dan antarmuka aplikasi seluler, Anda dapat merekam event dari kedua sumber dan mengatribusikannya ke pengguna yang sama di AppsFlyerpsFlyer. Event tersebut bisa berupa in-app event atau lainnya, seperti event situs web, event pusat panggilan atau pembelian di toko fisik (brick and mortar) Anda.
  • Validasi tanda terima Ini adalah mekanisme aman di mana platform pembayaran, misalnya, Apple dan Google, memvalidasi bahwa pembelian dalam aplikasi terjadi seperti yang dilaporkan. Memvalidasi pembelian adalah alat utama untuk mencegah penipuan event pendapatan. Fitur ini juga membantu Anda untuk melihat pendapatan sebenarnya, dan menyaring pembelian dalam aplikasi yang belum selesai. 
  • Aplikasi hybrid: Aplikasi ini menggabungkan tampilan asli dan konten HTML dan juga dapat merekam in-app event. Namun, karena SDK hanya dapat mengirim event dari sisi native, pengembang harus meneruskan semua data event ke kode native.

Mengatur in-app event

Proses penyiapan in-app event mengharuskan pemasar dan pengembang bekerja sama sebagai berikut:

Langkah Peran Tugas Detail

1

Pemasar

Tentukan in-app event yang ingin Anda ukur. Tentukan dan komunikasikan nama event dan parameter event kepada pengembang Anda.  

Disarankan untuk memulai dengan 3-5 event yang dapat Anda gunakan sebagai KPI untuk mengukur kualitas pengguna Anda (misalnya, pembelian, pendaftaran, dan berbagi). Parameter event bersifat opsional, dan Anda dapat menggunakan parameter event apa pun dengan nama event apa pun.

Lihat Event yang direkomendasikan menurut bisnis vertikal untuk in-app event yang umum.

2 Pengembang

Terapkan kode di aplikasi Anda jika berlaku. 

Lihat dokumentasi pengembang di sini.

3 [Opsional] Pemasar Bekerja samalah dengan pengembang untuk mengatur Bidang ID Pengguna Pelanggan/Customer User ID field (CUID)

Bidang ini membantu memperkaya data in-app event dengan merujuk silang data atribusi AppsFlyer dengan data Anda yang lain menggunakan kode CUID.

4 [Opsional] Pemasar Petakan event ke mitra yang relevan di dasbor.  Ini adalah tugas yang berkelanjutan, tergantung pada mitra yang Anda integrasikan.

Menentukan in-app event

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.

 Contoh

Seorang pemasar untuk aplikasi eCommerce ingin merekam jenis konten yang dilihat pengguna untuk lebih memahami kategori apa yang paling populer dan menghubungkan tampilan produk dengan penjualan produk.

Tabel berikut menunjukkan contoh struktur event yang diberikan pemasar kepada pengembang:
eventName Parameter event Nilai parameter Kapan event tersebut dipicu?
af_content_view af_price Harga produk

Saat pengguna melihat halaman rincian produk tertentu

af_content_type Nama kategori produk, misalnya, sepatu
af_content_id

ID produk, misalnya, SKU

Event yang direkomendasikan oleh bisnis vertikal

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
InApp_Events_games.png  Event aplikasi game yang direkomendasikan
InApp_Events_ecommerce.png Event aplikasi eCommerce yang direkomendasikan
InApp_Events_streaming.png Event aplikasi hiburan yang direkomendasikan
banking.png Event aplikasi keuangan dan perbankan yang direkomendasikan
InApp_Events_lending.png Event aplikasi pinjaman P2P yang direkomendasikan
education.png Event aplikasi pendidikan online yang direkomendasikan
InApp_Events_ride.png Event aplikasi jasa transportasi online (ride-hailing) yang direkomendasikan
InApp_Events_flight.png Event aplikasi pemesanan penerbangan yang direkomendasikan
InApp_Events_hotel.png Event aplikasi pemesanan hotel yang direkomendasikan
5669_Healthcare_icon_3.png Event aplikasi perawatan kesehatan yang direkomendasikan
telecommunications_icon.png Event aplikasi telekomunikasi yang direkomendasikan
InApp_Events_eWallet.png Event aplikasi eWallet yang direkomendasikan
soccer_ball.png Acara taruhan olahraga yang direkomendasikan

Lihat data in-app event

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 dashbor Menampilkan kinerja akuisisi pengguna (UA) LTV waktu nyata
  • Halaman event: Menampilkan kinerja acara dalam aplikasi LTV di seluruh sumber media
  • Laporan in-app event data lengkapMenampilkan 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.

Tips 

Perhatikan hal berikut saat menambahkan nama dan parameter event:

  • 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.

    revenue_data.png

Batasan

Perhatikan hal berikut saat menambahkan nama dan parameter event:

  • Sebaiknya gunakan hanya karakter alfanumerik huruf kecil (az dan 0-9) untuk nama in-app event Anda. Nama event peka huruf besar/kecil, artinya af_purchase dan af_PURCHASE adalah dua event berbeda dalam data lengkap. Namun, dalam laporan agregat (misalnya, Ikhtisar, atau Event) nama event 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 melebihi 1000 karakter. 
  • Jika Anda menyertakan URL pengarah sebagai nilai event, itu harus berupa URL yang disandikan .
  • Facebook memiliki beberapa batasan terkait nama dan parameter event. Baca tentang batasan di sini.

Pertanyaan Umum

Bagian berikut mencakup berbagai Pertanyaan yang Sering Diajukan (FAQ) tentang in-app event.

Bagaimana cara menggunakan parameter pendapatan?

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 .

Bagaimana cara AppsFlyer mengatribusikan event?

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:

Apakah event direkam jika perangkat sedang offline?

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.

 Catatan

Cache SDK dapat menyimpan hingga 40 event, yang berarti bahwa hanya 40 event pertama yang dilakukan secara offline yang disimpan. Yang berikutnya, hingga respons sukses berikutnya, akan dihapus.

Waktu event yang muncul dalam data lengkap adalah waktu event dikirim ke AppsFlyer setelah perangkat online kembali. Ini bukanlah waktu aktual berlangsungnya event.

Apa yang dimaksud dengan in-app event yang kompleks dan bagaimana cara mengaturnya?

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"
   }
  ]
}

 Perhatian

Event In-App Kompleks menyebabkan masalah postback di Facebook dan Criteo. Jika Anda memerlukan event untuk dipetakan sepenuhnya dengan Facebook dan Criteo, kirim masing-masing event per tindakan pengguna (misalnya, kirim event Add to cart (Tambahkan ke keranjang) per setiap item yang ditambahkan). Gunakan data lengkap in-app event untuk mengelompokkan event ini bersama-sama.

Bisakah saya menambahkan beberapa item ke satu transaksi?

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.

 Contoh

Pada transaksi yang sama, Mr A. Flyer membeli dua baju yang sama, sepasang sepatu, dan sebuah topi dari toko online yang berbasis di AS. Urutan di mana setiap item terdaftar harus identik untuk setiap parameter.


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

Beberapa item dikirim berikutnya sebagai larik di postback . Saat ini, Facebook dan Twitter tidak dapat mengurai parameter array dengan tepat. Untuk membantu masalah ini, AppsFlyer menjumlahkan jumlah item (af_quantity) alih-alih mengirimkannya ke SRN ini sebagai larik. Dalam contoh kita, Facebook akan mendapatkan af_quantity=4 .

 Catatan

Penggunaan item berganda dapat dilakukan dengan event in-app berikut:

af_add_to_cart, af_add_to_wishlist, af_tutorial_completion, af_initiated_checkout, af_purchase, af_rate, af_spent_credits, af_content_view, af_travel_booking, af_update 

Bagaimana AppsFlyer menangani deduplikasi event?

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

 Catatan

Deduplikasi hanya berfungsi untuk in-app event yang dikirim dari SDK.

In-app event S2S tidak diduplikasi.

Berapa lama AppsFlyer menyimpan data tingkat pengguna dan apa kewajiban penghapusannya?

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.

Apakah saya perlu menambahkan parameter OS (sistem operasi) ke event saya?

  • 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.
Apakah artikel ini membantu?