Macro postback untuk jaringan iklan

Direkomendasikan untuk
Jaringan Iklan
Tanggal terakhir diupdate:

Sekilas: Sebagai jaringan iklan, Anda dapat menentukan konten dan titik akhir dari postback yang dikirimkan kepada Anda sebagai bagian dari integrasi Anda dengan AppsFlyer. Postback terkait interaksi pengguna aplikasi seperti penginstalan, in-appevent, interaksi ulang, dan sebagainya.

Panduan postback mitra terintegrasi terkait:

Postback untuk jaringan iklan

  • Konfigurasi postback: Untuk meminta perubahan pada pengaturan postback Anda, hubungi integrations@appsflyer.com atau manajer pengembangan mitra AppsFlyer Anda. 
  • Jenis postback: Postback tersedia untuk penginstalan dan in-app event, penginstalan dan in-app event yang diblokir (karena kecurangan yang teridentifikasi oleh Protect360 atau melanggar aturan validasi penargetan).
Sumber data postback
Source Description
Parameter link atribusi

Parameter yang diberikan oleh mitra pada URL klik dan tayangan

Misalnya: parameter ID klik pada tautan atribusi - "&click_id=CLICK_ID"
ID mitra di AppsFlyer

ID unik disediakan pada pemasang iklan oleh mitra

Misalnya: ID aplikasi, ID akun, ID pengguna, ID jaringan
Informasi turunan SDK

Informasi yang diekstrak dari perangkat oleh SDK AppsFlyer

Misalnya: ID perangkat iOS dapat diekstrak dengan menggunakan "&IDFA=(idfa)" di postback
Berasal dari platform AppsFlyer

Informasi yang diperoleh dari platform AppsFlyer. 
Protect360 dan aturan validasi Informasi tentang penginstalan yang diidentifikasi sebagai kecurangan dan penginstalan yang melanggar aturan penargetan kampanye, dan in-app event terkait

Macro postback

Saat disertakan dalam postback, macro diganti dengan data yang relevan dengan pengguna. Misalnya, untuk mendapatkan alamat IP pengguna yang menginstal aplikasi, sertakan country_code=(ip) dalam struktur postback.  Macro yang didukung tercantum dalam tabel berikut:

Kolom pada tabel berikut memiliki arti berikut:

  • Source (Sumber): Dari mana data berasal.
    • Tautan: Tautan atribusi
    • SDK: SDK AppsFlyer yang disematkan di aplikasi atau API server-to-server
    • AF: Setelah diproses oleh AppsFlyer
  • Kirim semua: Jika ya, Anda dapat menerima data penginstalan dan event yang diatribusikan ke jaringan lain atau organik.  (Artinya tidak diatribusikan ke Anda). 
  • [Basis] Macro untuk semua postback: Macro yang relevan dengan penginstalan, in-app event, dan postback event yang ditolak
  • [Opsional] untuk in-app event dan event yand ditolak seperti yang ditunjukkan dalam kolom (ditolak, in-app)
Macro—penginstalan, in-app event, dan event yang ditolak
Macro postback (nama) Source Send all Description [Basis] Macro untuk semua postback [Opsional] In-app dan event yang ditolak
advertising_id SDK Ya ID perangkat yang dapat diatur ulang pengguna, ATAU GAID. Juga tersedia sebagai: (sha1-advertiserId) Ya  
app_name SDK Ya Nama aplikasi yang ditetapkan oleh pemasang iklan Ya  
appsflyer_id SDK Ya AppsFlyer unique identifier recorded upon conversion Ya  
attributed_touch_type SDK Tidak Possible values: click, impression, TV, pre-install Ya  
blocked_reason AF Tidak Alasan kecurangan/aturan validasi Tidak Ditolak
blocked_reason_value AF Tidak Nilai alasan kecurangan/aturan validasi (seperti ID situs) Tidak Ditolak
blocked_sub_reason AF Tidak Sub-alasan kecurangan/aturan validasi Tidak Ditolak
bundle_id SDK Ya iOS: Identifikasi untuk mencocokkan satu aplikasi atau sekelompok aplikasi di iOS (Lihat ID paket pengembang Apple) Android: Nama aplikasi Ya  
country_code AF Ya Kode Negara menggunakan ISO 3166 (alpha-2) Misalnya: US, CN. Ya  
event_name SDK Ya Nama yang dialokasikan ke event Tidak In-app
event_revenue_USD AF Ya Event value in USD Tidak In-app
event_revenue SDK Ya Nilai event yang dilaporkan oleh SDK menggunakan event_revenue_currency atau mata uang yang dipilih oleh Anda. Tidak In-app
event_revenue
_currency		 SDK Ya Kode mata uang pendapatan event yang dilaporkan dalam event atau mata uang yang dipilih oleh Anda Tidak In-app
event_time SDK Ya Event Time Tidak In-app
event_value SDK Ya in-app event menyertakan atribut dengan nilai, yang dapat dikirim seluruhnya di postback dalam format JSON. Penyandian URL menggunakan macro (penyandian). Tidak In-app
idfa SDK Ya ID iklan pengguna yang dapat diatur ulang ditemukan di perangkat iOS juga tersedia sebagai: (sha1-idfa) Ya  
idfv SDK Ya Pengenal unik per pengguna per vendor di perangkat IOS Ya  
install_time SDK Ya Stempel waktu penginstalan Ya  
install_unix_ts SDK Ya Install timestamp in unix format Ya  
is_attributed AF Ya A flag marking if the install or event is attributed to this media source Ya  
is_lat SDK Ya Batas Pelacakan Iklan (Limit ad tracking/LAT): iOS: Sejak iOS 14, LAT dihentikan oleh Apple. Tentukan status privasi pengguna menggunakan ATT. Dalam hal ini abaikan is_lat. Sebelum iOS 14, jika true (benar), IDFA tidak tersedia dan diatur ke 0. Android: Jika true (benar), pengguna menonaktifkan iklan berbasis minat. Ini tidak mencegah pengumpulan GAID. Ya  
is_primary_attribution AF Ya

Jika false (salah), lihat is_retargeting.

 Tidak In-app
is_retargeting Link Tidak

Gunakan bersama dengan is_primary_attribution. Pelajari lebih lanjut tentang atribusi ganda dari event penargetan ulang.

Jika true (1), event dilaporkan sebagai bagian dari kampanye penargetan ulang dan sumber medianya adalah sumber media penargetan ulang.

Jika false (0) dan is_primary_attribution false, event menjadi bagian dari kampanye penargetan ulang tetapi sumber media yang dirujuk adalah sumber media atribusi pengguna

 

 Tidak  
language SDK Ya Bahasa (lokal) dilaporkan oleh perangkat dan diatur oleh OS perangkat. Ya  
oaid SDK Ya ID yang dapat diatur ulang pengguna di beberapa perangkat Android biasanya sebagai alternatif untuk GAID Ya  
partner_event_id AF Ya Nama/ID event terkait di platform mitra Tidak In-app
platform SDK Ya Platform perangkat: iOS, Android, atau Windows Mobile Ya  
retargeting_
conversion_type		 AF Tidak Tanda bendera jika ini adalah atribusi ulang atau interaksi ulang Khusus penargetan ulang  
app_version SDK Ya Nama versi aplikasi yang diatur oleh pengembang di kode aplikasi Ya  
app_id SDK Ya The app ID as reported by the app  Ya  
att-0-1 SDK Ya

Possible values:

  • 1: The ATT status is authorized or af_authorized.
  • 0: Any other ATT status. 
 Ya  
att-status SDK Ya

The ATT status reported by iOS. Like authorized, not_determined. 

In some cases there is no value and "" is returned. 

 Ya  
af_ad LINK Tidak

Ad Name (see more) provided by the advertiser/publisher

 Ya Ya
af_ad_id LINK Tidak

Provided by the advertiser/publisher

 Ya Ya
af_adset Link Tidak
  • Provided by the advertiser/publisher.
  • Adset is an intermediate level in the hierarchy between Campaign and Ad. See more
Ya Ya
af_adset_id Link Tidak Provided by the advertiser/publisher Ya Ya
c Link Tidak Provided by the advertiser/publisher. Campaign names that exceed 100 characters in length are displayed on the dashboard as "c_name_exceeded_max_length" Ya Ya
af_c_id Link Tidak Provided by the advertiser/publisher Ya Ya
af_siteid Link Tidak Ya Ya
af_subsite_id Link Tidak
  • Sub-jaringan iklan/ID Penerbit. 
  • Jika selain penerbit utama (ID situs), ada sub-penerbit, atau jika Anda menyertakan informasi tambahan, seperti jenis iklan/penempatan dalam aplikasi, seperti spanduk, iklan interstisial, video, dll. gunakan af_sub_siteid. Misalnya: af_sub_siteid =ABCD_4567
 Ya Ya
af_ad_type Link Tidak

Use the following naming convention:

  • teks: unit iklan yang hanya berisi teks, misalnya hasil pencarian
  • banner: a basic format that appears at the top or bottom of the device screen
  • interstitial: a full-page ad that appears during breaks in the current experience
  • video: a video standar, non-reward
  • rewarded_video: an ad unit offering in-app rewards in exchange for watching a video
  • playable: an ad unit containing an interactive preview of the app experience
  • sponsored_content: a link included in a piece of sponsored content, like an advertorial article
  • audio: an audio ad
Ya Ya
imei SDK Ya

A unique number used to identify mobile phones

 Ya  

Macro khusus in-app event

Contoh berikut terkait dengan postback in-app event yang tersedia untuk mitra.

Contoh

Event postback template "&event=(event)&json=(encode)" was translated to the following postback for a specific af_purchase event:

&event=af_purchase&json=%7B%22af_quantity%22%3A1%2C%22
af_revenue%22%3A%2212000%22%2C%22af_currency%22%3A%
22USD%22%2C%22af_content_id%22%3A%221107%22%2C%22
af_content_type%22%3A%22default_type%22%7D%0A

Nilai JSON yang disandikan dari postback ini adalah

{"af_quantity":1,"af_revenue":"12000","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}


Nilai yang disandikan

Postback dapat berisi karakter tidak beraturan, yang bukan alfanumerik. Untuk mentransfer nilai ini dengan benar melalui postback, URL AppsFlyer menyandikan nilai non alfanumerik.

Untuk memecahkan kode atau menyandikan postback, gunakan layanan web penyandian. 

Sample postbacks

General install postback examples

Android iOS 
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)

General in-app event postback examples

Android iOS 
http://YourCompanyDomain.com?site_id=(publisher_id)&
device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android_id)&
install_time=(install_unix_ts)&event_name=(event_name)&currency=(currency)&
json=(event_value)

 Contoh postback in-app event

Event Parameters:

  • Nama Event: af_revenue
  • Pendapatan Event: 120.00
  • Mata Uang Event: USD
  • Event Value: {"af_quantity":1,"af_revenue":"120","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

Postback:

http://YourCompanyDomain.com?clickid=8594845&site_id=click123&device_ip=
38.166.144.142&advertising_id=121sxxxx-xxxx-xxxx-xxxx-52454bd7500b&
android_id=9aaeecc4455xxxxx&;install_time=1451923560&event_name=af_purchase&
currency=USD&revenue=120.00&json=%7B%22af_quantity%22%3A1%2C%22 />af_revenue
%22%3A%22120.10%22%2C%22af_currency%22%3A%22USD%22%2C%22af_content_id
%22%3A%221107%22%2C%22af_content_type%22%3A%22default_type%22%7D%0A