Payload dan skenario data konversi

Sekilas: Gunakan data konversi untuk mengidentifikasi berbagai skenario konversi, menyesuaikan pengalaman pengguna, dan lainnya.

Ringkasan

Panduan berikut berisi berbagai skenario konversi pengguna dan payload data konversi terkait:

Data konversi tersedia di platform menggunakan salah satu dari berikut ini:

Karena pengorbanan akurasi/latensi, data konversi untuk ID perangkat yang sama mungkin berbeda di seluruh API.

Bidang payload data konversi non-organik

Bidang selalu tersedia

Tabel berikut mencantumkan bidang yang selalu ada untuk konversi non-organik, terlepas dari media_sourcekonversi.

Nama kolom payload Nama kolom data lengkap Catatan
media_source Sumber media

Penerbit yang dikaitkan. Setara dengan parameter pid di tautan atribusi

install_time Install time  
click_time Waktu sentuh yang diatribusikan Waktu terjadinya klik atau tayangan dalam UTC
is_first_launch N/A true, false
af_status

Data lengkap dibagi menjadi laporan terpisah: organik, non-organik

"Non-organic"
af_siteid ID situs  
adgroup_id ID iklan  
adset adset  
adset_id ID adset  
agency Partner null, atau nama agensi (untuk kampanye yang dijalankan oleh agensi)
campaign Kampanye  
campaign_id ID kampanye  
http_referrer HTTP Referrer  
retargeting_conversion_type Jenis Konversi Penargetan Ulang "tidak ada", atau retargeting_conversion_type
af_sub[n] (n=1—5) Sub Param [n] (n=1–5)  

Kolom tersedia dalam beberapa kasus

Kolom dalam tabel berikut tersedia dalam beberapa kasus, bergantung pada cara SRN mengisi event individu.

Nama kolom payload Nama kolom data lengkap Catatan
af_channel Channel

SRN mengisi parameter ini:

  • AppLovin
  • Google Ads
  • Iklan Meta
  • Snapchat
  • TikTok untuk Bisnis
  • Twitter

Contoh: Facebook—Instagram, Google—YouTube 

orig_cost  

Catatan (1)

costs_cents_USD  

Catatan (1)

af_cpi  

Catatan (1)

Catatan

(1) Kolom biaya diisi dengan nilai yang dibagikan oleh jaringan iklan. Agar jaringan iklan berbagi data biaya dengan AppsFlyer, Anda harus mengaktifkan integrasi biaya di halaman Integrasi aktif . Beberapa SRN mendukung pembagian biaya secara massal. Dalam hal ini, bidang biaya tingkat kejadian kembali sebagai 0. 

Kolom Tambahan

Lihat kamus kolom data lengkap untuk informasi tambahan.

Batasan

Nama parameter khusus

Parameter khusus tidak dapat disebut nama (huruf kecil "n". Nama valid).

Jika sebuah parameter disebut nama, maka akan dihapus dari payload.


Data konversi UA dengan SRN

Jaringan pelaporan mandiri (SRN) adalah jaringan iklan yang menerapkan mekanisme atribusi mereka sendiri, misalnya Meta ads dan Google. 

SRN tidak menggunakan tautan atribusi. Artinya:

  • Bidang payload sudah ditentukan sebelumnya
  • Anda tidak dapat menambahkan kolom ke payload dengan menambahkan parameter ke tautan atribusi.

SRN melaporkan konversi ke AppsFlyer. Data konversi tersedia di aplikasi. Kolom yang tersedia bervariasi menurut SRN dan dirinci dalam bilah SRN individual yang mengikuti. 

Catatan tentang Meta ads

Jika Anda menjalankan kampanye di Meta ads dan tidak menandatangani persyaratan layanan Meta, AppsFlyer mengatribusikan penginstalan. Ketersediaan laporan terbatas sebagai berikut:

  • Tersedia: Dashboard dan laporan agregat dan analitik 
  • Tidak tersedia: Data lengkap 
Meta ads Google ASA Snap Twitter Oath

Data konversi Meta ads

Nama kolom Catatan Sumber data
match_type Selalu "srn" AppsFlyer
media_source Selalu "Meta ads" (iklan Meta) AppsFlyer
agency null atau nilai parameter af_prt di tautan atribusi Iklan Meta
http_referrer Selalu null Iklan Meta
retargeting_conversion_type   AppsFlyer
af_channel   Meta ads (publisher_platform)
af_status Selalu "Non-organik" AppsFlyer
ad_id Hanya untuk penggunaan internal Meta ads. Meta ads (ad_id)
click_time   AppsFlyer
install_time   AppsFlyer 
is_first_launch true, false Perangkat
adset_id Tersedia dalam data lengkap: ID Adset Meta ads (campaign_id)
is_fb Selalu benar AppsFlyer
campaign Tersedia dalam data-lengkap: Nama Kampanye Meta ads (campaign_group_name)
campaign_id Tersedia dalam data-lengkap: ID Kampanye Meta ads (campaign_group_id)
is_paid Selalu benar Iklan Meta
adgroup Tersedia dalam data-lengkap: Iklan Meta ads (adgroup_name)
adgroup_id Tersedia dalam data-lengkap: ID Iklan Meta ads (adgroup_id)
adset Tersedia dalam data-lengkap: Adset Meta ads (campaign_name)
af_siteid Selalu null Iklan Meta
af_sub[1-5] Selalu null Pemasang iklan

Catatan Kolom terkait biaya tidak tersedia karena Meta ads tidak membagikan data biaya saat konversi. Jika pembagian-biaya diaktifkan, Meta ads membagikan data biaya dengan AppsFlyer beberapa kali sehari.

Konversi UA dengan jaringan iklan lain

Untuk jaringan iklan lainnya, data di payload dipengaruhi langsung oleh parameter di tautan atribusi.

Periksa payload JSON berikut ini.

Catatan! Data konversi kembali sebagai struktur data seperti peta. Pengembang tidak berinteraksi dengan JSON mentah.

Applovin

Tautan atribusi:

https://app.appsflyer.com/com.company.app?af_ad=ad_name&af_ad_type=INTER
  &af_channel=video&af_siteid=123_site_id&af_c_id=b8******************************&
  af_adset=_DEFAULT&pid=applovin_int&c=campaign_name
  &af_click_lookback=7d&clickid=10****************
  &advertising_id=50********************************&af_ip=

Payload:

{
      "adgroup": null,
      "campaign": "campaign_name",
      "media_source": "applovin_int",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "install_time": "2018-12-30 23:49:54.186",
      "adgroup_id": null,
      "orig_cost": "0.0",
      "click_time": "2018-12-24 14:29:33.738",
      "agency": null,
      "cost_cents_USD": "0",
      "af_ad_type": "INTER",
      "af_c_id": "b8******************************",
      "adset": null,
      "advertising_id": "50********************************",
      "af_sub1": null,
      "clickid": "10****************",
      "af_click_lookback": "7d",
      "af_siteid": "123_site_id",
      "af_ad": "ad_name",
      "http_referrer": null,
      "af_channel": "video",
      "af_adset": "_DEFAULT",
      "af_sub5": null,
      "af_sub4": null,
      "af_cpi": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic"
  }
  
  • Parameter di tautan atribusi muncul sebagai kolom di payload
  • Kolom lain di payload yang tidak ada di link atribusi muncul dengan nilai null
  • AppLovin mendukung pembagian biaya iklan tetapi mengirimkan data biaya ke AppsFlyer secara massal. Bidang terkait biaya kembali sebagai 0.

ironSource

Tautan atribusi:

https://app.appsflyer.com/id123456789?
  af_ua=Mozilla/5.0+(iPhone;+CPU+iPhone+OS+12_1_2+like+Mac+OS+X)+AppleWebKit/605.1.15+(KHTML,+like+Gecko)+Mobile/16C101
  &clickid=ab*******************&redirect=false
  &ua=Mozilla/5.0+(iPhone;+CPU+iPhone+OS+12_1_2+like+Mac+OS+X)+AppleWebKit/605.1.15+(KHTML,+like+Gecko)+Mobile/16C101
  &af_lang=pt&imei=&af_sub1=&advertising_id=&af_ip=192.168.0.1&pid=ironsource_int
  &device_ip=192.168.0.1&c=campaign_name
  &idfa=01**********************************&af_siteid=123_site_id&
  af_enc_data=cN*********************************************************************

Payload:

{
      "adgroup": null,
      "af_enc_data": "cN**************************************************************************************",
      "campaign": "campaign_name",
      "media_source": "ironsource_int",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "install_time": "2018-12-30 23:59:32.194",
      "adgroup_id": null,
      "redirect": "false",
      "orig_cost": "0.75",
      "click_time": "2018-12-30 23:58:54.517",
     "agency": null,
      "cost_cents_USD": "75",
      "adset": null,
      "advertising_id": "35**********************************",
      "af_sub1": null,
      "af_ip": "192.168.0.1",
      "clickid": "ab*******************",
      "af_sub3": null,
      "af_cost_value": "0.75",
      "af_ref": "ironsource_5f******************************************",
      "af_siteid": "123_site_id",
      "http_referrer": null,
      "af_cost_model": "cpi",
      "af_ua": "Mozilla/5.0 (Linux; Android 8.0.0; SM-N950F Build/R16NW; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/71.0.3578.99 Mobile Safari/537.36",
      "af_cost_currency": "USD",
      "af_sub5": null,
      "af_sub4": null,
      "af_lang": "en",
      "af_cpi": null,
      "af_click_lookback": "7d",
      "af_sub2": null,
      "af_status": "Non-organic"
  }
  

ironSource membagikan data terkait biaya dengan AppsFlyer setelah konversi menggunakan bidang orig_cost, costs_cents_USD, dan af_cost_value .

Namun, data terkait biaya tidak muncul di tautan atribusi. ironSource mengenkripsi data biaya dan menyimpannya di bidang af_enc_data .

Menargetkan ulang data konversi

Penargetan ulang mencakup dua jenis konversi, atribusi ulang atau interaksi ulang.

 Tips

Data konversi untuk penargetan ulang tidak selalu memberikan indikasi yang jelas tentang jenis konversi. Lihat sumber data konversi alternatif.

Atribusi ulang dengan SRN

Saat pengguna diatribusikan ulang melalui SRN, payload data konversi tidak menunjukkan bahwa ini adalah kampanye penargetan ulang. Karena SRN tidak menggunakan tautan atribusi, tidak ada cara untuk menetapkan parameter is_retargeting=true pada tautan atribusi. Untuk SRN yang mendukung penargetan ulang, AppsFlyer menentukan apakah pengguna harus diatribusikan ulang atau tidak.

Artinya, tidak ada cara untuk menentukan, pada tingkat SDK, apakah penginstalan berasal dari kampanye penargetan ulang. Satu-satunya cara adalah mengatur nama kampanye sedemikian rupa sehingga menunjukkan kampanye penargetan ulang.

 Catatan

Menyetel nama kampanye sedemikian rupa sehingga menunjukkan penargetan ulang bukanlah metode yang sangat mudah. Lihat contoh untuk mempelajari lebih lanjut.

Atribusi ulang dengan jaringan iklan biasa

Atribusi ke jaringan iklan bergantung pada tautan atribusi. Baik tautan atribusi reguler atau OneLink, dengan penargetan ulang tautan atribusi selalu memiliki parameter is_retargeting=true yang ditetapkan di dalamnya.

Kampanye penargetan ulang dengan Criteo

Link Atribusi

https://app.appsflyer.com/id1234567895?pid=criteo_int&af_click_lookback=30d&
  c=campaign_name&is_retargeting=true&redirect=false&idfa=68**********************************
  &af_reengagement_window=30d

Payload data konversi

{
      "adgroup": null,
      "campaign": "campaign_name",
      "media_source": "criteo_int",
      "retargeting_conversion_type": "re-attribution",
      "adset_id": null,
      "campaign_id": null,
      "af_reengagement_window": "30d",
      "install_time": "2018-12-01 23:13:03.126",
      "adgroup_id": null,
      "redirect": "false",
      "af_sub5": null,
      "click_time": "2018-11-18 20:02:31.559",
      "agency": null,
      "cost_cents_USD": "0",
      "is_retargeting": "true",
      "af_cpi": null,
      "af_click_lookback": "30d",
      "af_siteid": null,
      "idfa": "68**********************************",
      "http_referrer": null,
      "orig_cost": "0.0",
      "af_sub4": null,
      "adset": null,
      "af_sub1": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic"
  }
  • parameter retargeting_conversion_type - parameter ini menunjukkan jenis penargetan ulang. Dapat berupa atribusi ulang, interaksi ulang, atau tidak ada.
  • parameter is_retargeting: true - parameter ini menunjukkan bahwa penginstalan adalah penginstalan yang dikaitkan ulang
  • af_reengagement_window: Jendela atribusi interaksi ulang adalah jumlah hari di mana peristiwa dapat dikaitkan ke pengguna yang berinteraksi ulang. Karena ini adalah konversi atribusi ulang, parameter ini berlebihan.

Atribusi ulang dengan deferred deep linking

Sering kali, Anda ingin menautkan langsung pengguna yang dikaitkan ulang yang mana, menurut definisi dikaitkan ulang, tidak menginstal aplikasi. Misalnya, Anda menetapkan kampanye yang bertujuan untuk mengembalikan pengguna yang meng-uninstal aplikasi. Kampanye mempromosikan produk atau layanan dan Anda ingin melayani pengguna dengan konten yang terkait dengan produk atau layanan yang Anda iklankan.

Ini disebut sebagai Deferred Deep Linking (Tautan Langsung yang Tertunda) Payload data konversi untuk Deferred Deep Linking berasal dari metode onConversionDataSuccess .

Deferred Deep Linking dengan SRN

Parameter Deep Link (Tautan Langsung) yang ditentukan dalam kampanye SRN tidak tersedia di luar SRN. Ini termasuk parameter af_dp , yang menyimpan jalur skema di aplikasi. Satu-satunya pengecualian untuk hal ini adalah saat menggunakan kampanye Aplikasi Google pada Feeds. Untuk menerapkan deferred deep linking (tautan langsung yang tertunda), logika tambahan harus diterapkan untuk kampanye SRN. Gunakan data dalam tanggapan onConversionSuccess , seperti kampanye, set iklan, grup iklan, untuk mengalihkan pengguna Anda secara terprogram.

Data konversi untuk deferred deep linking dengan Meta ads

Android iOS
{
     "adset":"Adidas Running Shoes Women",
       "adgroup": null,
     "campaign_id":"6**********",
     "af_status":"Non-organic",
     "retargeting_conversion_type": "none",
     "agency":null,
     "af_sub3":null,
     "af_siteid":null,
     "adset_id":"6**********",
     "is_fb":true,
     "is_first_launch":true,
     "click_time":"2017-07-18 12:55:05",
     "iscache":false,
     "ad_id":"6**********",
     "af_sub1":null,
     "campaign":"running shoes summer collection",
     "is_paid":true,
     "af_sub4":null,
     "adgroup_id":"6**********",
     "is_mobile_data_terms_signed":true,
     "af_channel":"Facebook",
     "af_sub5":null,
     "media_source":"Meta ads",
     "install_time":"2017-07-19 08:06:56.189",
     "af_sub2":null
  }

Anda dapat menggunakan data dalam respons getConversionData, seperti kampanye, adset, dll. untuk mengalihkan pengguna secara terprogram dan menyajikan konten yang relevan kepada mereka.

 Contoh

Aplikasi ini adalah aplikasi eCommerce yang memiliki spesialisasi di bidang pakaian olahraga. Pengguna yang belum menginstal aplikasi diajak oleh iklan dan menginstal aplikasi. Setelah aplikasi mulai, SDK mengembalikan data konversi. Developer membuat aplikasi membuka aktivitas (kampanye) koleksi sepatu lari musim panas di toko dan melayani kategori sepatu lari untuk wanita (adset).

Deferred deep linking dengan tautan atribusi

Ada tiga cara untuk menautkan pengguna secara langsung:

Skema URI

Ketika menggunakan Skema URI, untuk tautan atribusi dan OneLink, tautan atribusi dan payload adalah sebagai berikut:

Link Atribusi

http://app.appsflyer.com/com.appsflyer.nivisampleapp?pid=media_source_name
  &c=campaign_name&af_dp=superapp%3A%2F%2deeplink-activity

OneLink

// short OneLink
  https://dhba.onelink.me/2rAD/71ba577e
  
  //long OneLink
  https://dhba.onelink.me/2rAD?pid=media_source_name&c=campaign_name
  &is_retargeting=true&af_dp=superapp%3A%2F%2deeplink-activity
  

Payload

{
      "af_deeplink": true,
      "campaign": "campaign_name",
      "media_source": "media_source_name",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "orig_cost": "0.0",
      "click_time": "2018-12-30 23:59:09",
      "install_time": "2018-12-30 23:59:39.330",
      "agency": null,
      "cost_cents_USD": "0",
      "adset": "AD_SET_NAME",
      "ad_id": "AD_ID",
      "af_siteid": null,
      "http_referrer": null,
      "af_cpi": null,
      "af_sub5": null,
      "af_sub4": null,
      "af_sub1": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic",
      "scheme": "superapp",
      "host": "deeplink_activity"
  }
  • af_deeplink: true - ketika parameter ini muncul dan diatur ke true, lihat untuk bidang skema dan tuan rumah
  • skema dan tuan rumah - bidang-bidang ini datang dari parameter af_dp di tautan atribusi dan mengindikasikan skema dan aktivitas yang seharusnya sudah ditautkan langsung dengan pengguna

Tautan universal iOS dan tautan aplikasi Android

Ini adalah dua dari tiga cara untuk melakukan deep linking (tautan langsung).

Ketika menggunakan tautan universal atau tautan aplikasi, OneLink dan payload adalah sebagai berikut:

OneLink

// short OneLink
  https://dhba.onelink.me/2rAD/71ba577e
  
  //long OneLink
  https://dhba.onelink.me/2rAD?pid=media_source_name&c=campaign_name
  &is_retargeting=true
  

Payload

{
      "install_time": "2019-01-08 16:24:49.853",
      "cost_cents_USD": "0",
      "campaign": "campaign_name",
      "retargeting_conversion_type": "none",
      "is_first_launch": true,
      "click_time": "2019-01-08 16:24:14.322",
      "af_click_lookback": "7d",
      "orig_cost": "0.0",
      "af_status": "Non-organic",
      "iscache": "true",
      "shortlink": "71ba577e",
      "media_source": "media_source_name",
      "is_retargeting": true
  }
  • bidang shortlink - ini adalah bidang yang menunjukkan OneLink spesifik dari mana pengguna datang. Hal ini membantu developer tahu cara untuk lanjut dalam hal mengaktifkan aktivitas dan memberikan konten. Bidang lain seperti kampanye juga dapat digunakan untuk tujuan ini.

     Penting!

    Bidang shortlink tidak tampak di payload ketika menggunakan OneLink panjang.

    Di kedua kasus (OneLink pendek atau panjang), kami merekomendasikan untuk menambahkan parameter kustom yang mengindikasikan aktivitas. Contohnya &deep_link_activity=shoes_cateogry

 Catatan

Menggunakan tautan universal dan tautan aplikasi hanya mungkin dengan OneLink.

Interaksi ulang dengan SRN

Seperti dengan kampanye Atribusi Ulang, ketika pengguna berinteraksi ulang melalui sebuah SRN, data konversi tidak mengindikasikan bahwa ini adalah kampanye interaksi ulang. Anda dapat mengatur nama kampanya sehingga mengindikasikan bahwa ini adalah kampanye interaksi ulang.

Interaksi Ulang dengan jaringan iklan reguler

Di sini juga, payload data konversi tidak mengindikasikan bahwa pengguna datang dari kampanye interaksi ulang. Untuk mengatasi keterbatasan ini, Anda dapat mengatur nama kampanye untuk mengindikasikan interaksi ulang.

Interaksi ulang dengan deep linking

Bagian besar dari Interaksi Ulang adalah mengirimkan pengguna ke suatu aktivitas spesifik. Contohnya, jika Anda mengiklankan beberapa produk atau obral. Di kasus seperti ini, Anda ingin mengirimkan pengguna yang mengeklik iklan langsung ke aktivitas aplikasi untuk produk atau obral ini.

Untuk melakukan hal tersebut, Anda menggunakan Deep Linking. Data konversi di Deep Linking sangatlah penting. Data ini menyimpan informasi yang dibutuhkan developer untuk mengkustomisasi pengalaman pengguna dan mengirimkan mereka ke aktivitas yang tepat.

Interaksi ulang: deep linking dengan SRN

Data konversi tidak tersedia ketika pengguna yang berinteraksi ulang datang dari sebuah SRN. Programmer perlu untuk menggunakan metode SRN untuk membuat peluncuran aplikasi berjalan lancar.

Interaksi Ulang: deep linking dengan jaringan iklan

Ketika pengguna berinteraksi ulang dan aplikasi diluncurkan, data konversi berikut ini tersedia di metode onAppOpenAttribution :

Untuk iOS dan Android, saat menggunakan OneLink versi pendek, data konversinya adalah peta terstruktur dari semua parameter dalam link:

Contoh:

{
     af_dp: "superapp://Deeplink",
     pid: "media_source_name"
     c: "campaign_name",
     link: "https://abcd.onelink.me/12ab/12ab34c"
     is_retargeting: true
  }
  • Programmer aplikasi dapat menggunakan parameter seperti af_dp dan nama kampanye untuk mengirimkan pengguna ke aktivitas spesifik dan memberikan konten yang relevan.

 Penting!

Kami merekomendasikan untuk menggunakan OneLink versi pendek. Klik di sini untuk mempelajari lebih lanjut.

Alasan lain untuk menggunakan OneLink versi pendek adalah struktur data konversi yang dikembalikan oleh versi panjang. Saat menggunakan versi panjang, data konversi adalah peta dengan satu bidang yang disebut link yang menampung seluruh OneLink panjang.

{
     "link": "https://abcd.onelink.me/12ab?pid=media_source&c=campaign_name&is_retargeting=true&af_dp=superapp%3A%2F%2FDeepLink"
  }
  

Sumber data konversi alternatif

  • Push API menawarkan muatan konversi mendetail yang menunjukkan atribusi ulang atau keterlibatan ulang. Payload Push API menyertakan bidang yang disebut re_targeting_conversion_type. Kolom ini menunjukkan jenis konversi, baik atribusi ulang atau interaksi ulang. Untuk mempelajari lebih lanjut, lihat panduan Push APIkami.
  • Laporan Data Lengkap juga berisi indikator untuk jenis konversi. Di laporan data lengkap untuk penargetan ulang konversi, terdapat kolom bernama Nama Event. Nilai dalam kolom ini adalah interaksi ulang atau atribusi ulang menurut jenis konversi.

Contoh akuisisi pengguna campuran dan atribusi ulang

  1. Seorang pengguna menginstal aplikasi Anda, lalu meng-uninstal-nya. Tindakan penginstalan menempatkan pengguna di jendela atribusi ulang. Anda megatur kampanye akuisisi pengguna  (tidak menargetkan ulang) dengan Meta ads. Anda juga mengatur integrasi AppsFlyer dengan Meta ads untuk mengizinkan penargetan ulang.

    Saat masih dalam jendela atribusi ulang, pengguna melihat iklan, mengekliknya, dan menginstal ulang aplikasi. Sejauh yang dilihat AppsFlyer, pengguna adalah pengguna yang diatribusikan ulang.

    Hal ini disebabkan oleh dua faktor:
    1. Konfigurasi dengan Meta ads mengizinkan penargetan ulang
    2. Pengguna berada di jendela atribusi ulang

    Dalam hal ini, nama kampanye tidak menunjukkan atribusi ulang.
  2. Mari kita ambil contoh yang sama, hanya kali ini pengguna berada di luar jendela atribusi ulang. Dalam hal ini, penginstalan adalah penginstalan non-organik yang baru.
  3. Mari kita lihat contoh lain. Anda mengatur kampanye penargetan ulang di Meta ads. Beberapa pengguna menemukan kampanye dan menginstal aplikasi. Namun, pengguna ini menginstal aplikasi untuk pertama kalinya. Pengguna tersebut tidak dianggap sebagai pengguna yang diatribusikan ulang. Sebaliknya, AppsFlyer menganggap mereka sebagai pengguna yang berasal dari kampanye akuisisi pengguna.