Push API streaming raw-data (V2)

Pesan Push API tergantung pada metode HTTP:

• GET: parameter data ditambahkan ke string URL
• POST: parameter data terdapat dalam isi pesan dalam format JSON
• Contoh berikut berisi bidang null/kosong. Di masa mendatang, kami berencana untuk berhenti mengirim bidang kosong/null. 
  
  • Android_Push_API_ V2.0.json
  • iOS_Push_API_V2.json

Bidang tersedia

• Pesan Push API berisi bidang seperti yang dijelaskan di sini.
• Bidang tambahan akan ditambahkan dari waktu ke waktu, karena ini ditambahkan ke platform AppsFlyer. Mekanisme impor/penguraian Anda harus mempertimbangkan hal ini. 

Format bidang stempel waktu

• Untuk bidang stempel waktu di UTC: format   yyyy-mm-dh jj: mm: ss.sss. Sebagai contoh, ditampilkan sebagai 2019-09-17 00: 09: 25.123 Suatu event terjadi pada pukul 14:00 waktu Tokyo. Waktu event dikonversi ke UTC, yaitu 05:00. Waktu yang dicatat adalah waktu UTC. 
• Untuk bidang tanda waktu di zona waktu dipilih: format yyyy-mm-dd hh:mm:ss.sss±th:tm. Misalnya 2019-01-20 04:51:16.000+0000 . Sebuah event berlangsung pada pukul 14:00 waktu Tokyo. Waktu event yang ditampilkan dicatat sebagai 14:00+09:00. 09:00 adalah zona waktu Tokyo. 

• Bidang data lengkap tersedia melalui Push API
• Deskripsi terperinci dari semua bidang data lengkap di AppsFlyer terlepas dari metode pengirimannya

Pastikan server Anda sesuai dengan persyaratan yang tercantum di sini. 

• Gunakan daftar periksa berikut untuk merencanakan pengaturan titik akhir. Angka-angka pada gambar sesuai dengan jumlah baris pada daftar periksa.

Titik akhir 

• Sesi ini berisi prosedur untuk menambahkan, menguji, mengubah, dan menghapus titik akhir. 
• Hanya admin yang dapat membuat perubahan pada pengaturan API. Anggota tim dapat melihat pengaturan Push API.

Untuk menambahkan titik akhir Push API:

1. Buka Integrasi > Akses API. Gulir ke bawah ke sesi Push API.
   Sesi Push API ditampilkan.
2. Klik Tambahkan Titik Akhir. 
3. Pilih metode HTTP: POSTatau GET
4. Masukkan Titik akhir URL.  Jika Anda mendapatkan pesan URL ini tidak aman, hubungi tim dukungan AppsFlyer.
5. Pilih satu tipe event atau lebih.Catatan! Jika pesan in-app event dinonaktifkan, ini berarti tidak ada in-app event yang telah direkam hingga saat ini. 
6. Pilih bidang untuk mengisi pesan Push API. Catatan:
   
   • Bidang-bidang wajib yang selalu dikirim: ID Aplikasi, Nama event, Waktu event, IDFA (iOS) atau ID Iklan (Android)
   • Gunakan kontrol yang dijabarkan pada gambar berikut untuk memilih bidang opsional. 

     

     • Bidang yang paling sering dipilih adalah bidang yang dipilih sebelumnya. Bidang-bidang tersebut dapat dihapus dari pilihan.
     • Pilih bidang opsional sesuai kebutuhan.
     • Gunakan  Hapus semua  untuk menghapus semua bidang pilihan.
     • Kami tidak mengirim bidang null/kosong dan kunci terkait. Pertimbangkan ini saat merencanakan proses impor/parsing Anda.
7. Pilih satu atau lebih (hingga 52 event) atau  Semua in-app event.
   
   • Daftar ini diisi oleh tipe event yang telah direkam. Jika acara tidak ada, kirimkan event dengan tipe ini menggunakan perangkat uji. 
8. Klik Simpan
   Push API sekarang aktif
   Data konversi dikirim ke titik akhir.
9. Uji titik akhir menggunakan prosedur berikut.
10. Jika Anda ingin menerima event yang diatribusikan ke Facebook, Anda harus menerima Persyaratan layanan Facebook terlebih dahulu.

Untuk menguji titik akhir:

1. Klik Kirim Pengujian. 
   Pesan hasil pengujian tampil di bawah tombol Kirim pengujian . 
   Sebuah pesan ujian dikirimkan ke titik akhir. Jika pengujian gagal, pastikan memiliki alamat IP AppsFlyer yang diizinkan. 
2. Periksa apakah titik akhir menerima pesan pengujian.
   Salinan pesan yang dikirim sebagai berikut.

{                  
  "idfv": "123456789",
  "device_category": "phone",
  "af_sub1": "sub1-12345",
  "customer_user_id": "Customer User ID",
  "is_lat": null,
  "contributor_2_af_prt": "attributionagency",
  "bundle_id": "bundleIdentifier_test",
  "gp_broadcastreferrer": "",
  "contributor_2_touch_time": "2019-12-31 00:05:42.805",
  "contributor_3_touch_type": "click",
  "event_source": "SDK",
  "af_cost_value": "10",
  "contributor_1_match_type": "id_matching",
  "app_version": "app_version",
  "contributor_3_af_prt": "attributionagency",
  "custom_data": null,
  "contributor_2_touch_type": "click",
  "gp_install_begin": "2019-12-31 00:07:14.000",
  "city": "Redmond",
  "amazon_aid": "9173fe74-0578-4658-a461-ebb0b4fce6d6",
  "gp_referrer": "af_tranid=000712-31122019254604&pid=pdsagency_int&c=pushapi_v2",
  "af_cost_model": "CPI",
  "af_c_id": "cid12345",
  "attributed_touch_time_selected_timezone": "2019-12-31 00:06:32.891+0000",
  "selected_currency": "EUR",
  "app_name": "com.pds.pushapi2.v2.transparent.com",
  "install_time_selected_timezone": "2019-12-31 00:07:14.961+0000",
  "postal_code": "98052",
  "wifi": false,
  "install_time": "2019-12-31 00:07:14.961",
  "operator": "ORANGE",
  "attributed_touch_type": "click",
  "af_attribution_lookback": "25d",
  "keyword_match_type": null,
  "af_adset_id": "adset12345",
  "device_download_time_selected_timezone": "2019-12-31 00:07:14.961+0000",
  "contributor_2_media_source": "contrib2",
  "contributor_2_match_type": "id_matching",
  "api_version": "2.0",
  "attributed_touch_time": "2019-12-31 00:06:32.891",
  "revenue_in_selected_currency": null,
  "is_retargeting": false,
  "country_code": "US",
  "gp_click_time": "2019-12-31 00:07:12.000",
  "contributor_1_af_prt": "attributionagency",
  "match_type": "id_matching",
  "appsflyer_id": "e126a3b3-3406-4196-a964-563c9ae44ff8",
  "dma": "819",
  "http_referrer": "https://www.amazon.com/gp/bestsellers/gift-cards/ref=sv_gc_0",
  "af_sub5": "sub5-12345",
  "af_prt": "attributionagency",
  "event_revenue_currency": null,
  "store_reinstall": null,
  "install_app_store": null,
  "media_source": "pdsagency_int",
  "deeplink_url": null,
  "campaign": "pushapi_v2",
  "af_keywords": "keywords12345",
  "region": "NA",
  "cost_in_selected_currency": "1000",
  "event_value": null,
  "ip": "20.168.174.166",
  "oaid": null,
  "event_time": "2019-12-31 00:07:14.961",
  "is_receipt_validated": null,
  "contributor_1_campaign": "camp1",
  "af_sub4": "sub4-12345",
  "imei": null,
  "contributor_3_campaign": "camp3",
  "event_revenue_usd": null,
  "af_sub2": "sub2-12345",
  "original_url": "https://app.appsflyer.com/com.pds.pushapi2.v2.transparent.com?c=pushapi_v2&pid=pdsagency_int&clickid=click12345&af_ref=000632-31122019&advertiserId=9173fe74-0578-4658-a461-ebb0b4fce6d6&android_id=3e06b4caebc19356&sha1_android_id=sha12345&af_siteid=136396&af_sub_siteid=sub_siteid12345&af_c_id=cid12345&af_adset=adset12345&af_adset_id=adset12345&af_ad=ad12345&af_ad_id=adid12345&af_ad_type=adtype12345&af_channel=channel12345&af_keywords=keywords12345&is_retargeting=False&af_dp=ebay%3A%2F%2Fshoppingcart&af_web_dp=www.dp.com&af_sub1=sub1-12345&af_sub2=sub2-12345&af_sub3=sub3-12345&af_sub4=sub4-12345&af_sub5=sub5-12345&af_cost_model=CPI&af_cost_value=10&af_cost_currency=EUR&sha1_advertising_id=sha12345&sha1_el=sha12345&af_installpostback=false&af_force_dp=true&af_chrome_lp=true&af_ec=1&af_click_lookback=25d&af_viewthrough_lookback=1h&af_reengagement_window=2d&af_prt=attributionagency",
  "contributor_2_campaign": "camp2",
  "android_id": "3e06b4caebc19356",
  "contributor_3_media_source": "contrib3",
  "af_adset": "adset12345",
  "af_ad": "ad12345",
  "state": "WA",
  "network_account_id": null,
  "device_type": "Samsung::SH-220",
  "idfa": null,
  "retargeting_conversion_type": null,
  "af_channel": "channel12345",
  "af_cost_currency": "EUR",
  "contributor_1_media_source": "contrib1",
  "keyword_id": null,
  "device_download_time": "2019-12-31 00:07:14.961",
  "contributor_1_touch_type": "click",
  "af_reengagement_window": "2d",
  "af_siteid": "136396",
  "language": "English",
  "app_id": "com.pds.pushapi2.v2.transparent.com",
  "contributor_1_touch_time": "2019-12-31 00:06:07.847",
  "event_revenue": null,
  "af_ad_type": "adtype12345",
  "carrier": "carrier",
  "event_name": "install",
  "af_sub_siteid": "sub_siteid12345",
  "advertising_id": "9173fe74-0578-4658-a461-ebb0b4fce6d6",
  "os_version": "6.0",
  "platform": "android",
  "af_sub3": "sub3-12345",
  "contributor_3_match_type": "id_matching",
  "selected_timezone": "UTC",
  "af_ad_id": "adid12345",
  "contributor_3_touch_time": "2019-12-31 00:05:17.757",
  "user_agent": "Dalvik/1.6.0 (Linux; U; Android 6.0; Redmi Note 4 Build/KOT49I.F320S22g",
  "is_primary_attribution": null,
  "sdk_version": "v4.8.0",
  "event_time_selected_timezone": "2019-12-31 00:07:14.961+0000"
}

Menghapus titik akhir

 Untuk menghapus titik akhir:

1. Buka Integrasi > Akses API.
   Gulir ke bawah ke bagian akses Push API. 
2. Klik Hapus titik akhir.
3. Klik Save.
   Titik akhir dihapus. 

Migrasi titik akhir dari V1.0 ke V2.0

Untuk memigrasi titik akhir dari V1.0 ke V2.0:

1. Buka Integrasi > Akses API. Gulir ke bawah ke sesi Push API.
   Sesi Push API ditampilkan.
2. Temukan titik akhir yang akan dimigrasi.
3. Pilih bidang untuk mengisi pesan Push API.
   
   • Bidang-bidang wajib yang selalu dikirim: ID Aplikasi, Nama event, Waktu event, IDFA (iOS) atau ID Iklan (Android)
   • Gunakan kontrol yang dijabarkan pada gambar berikut untuk memilih bidang opsional. 

     

     • Bidang yang paling sering dipilih adalah bidang yang dipilih sebelumnya. Bidang-bidang tersebut dapat dihapus dari pilihan.
     • Pilih bidang opsional sesuai kebutuhan.
     • Gunakan  Hapus semua  untuk menghapus semua bidang pilihan.
     • Dalam waktu dekat, kami akan berhenti mengirim bidang null/kosong serta kode terkait. Pertimbangkan ini saat merencanakan proses impor/parsing Anda.
4. Pilih satu atau lebih (hingga 52 event) atau  Semua in-app event.
   
   • Daftar ini diisi oleh tipe event yang telah direkam. Jika acara tidak ada, kirimkan event dengan tipe ini menggunakan perangkat uji. 
5. Klik Simpan
   • Push API telah dimigrasi. 
   • Data konversi terus dikirim ke titik akhir.

Petunjuk: Pesan URL ini tidak aman tampil saat Anda mengatur URL titik akhir.

Tindakan yang diperlukan: Hubungi tim dukungan AppsFlyer; termasuk ID aplikasi, dan screenshot pesan kesalahan.  

Jika Anda tidak menerima pesan pengujian dan Anda membatasi akses ke server berdasarkan alamat IP: pastikan Anda memiliki semua alamat IP AppsFlyer yang diizinkan. 

Penargetan ulang event dalam aplikasi diduplikasi ketika event pembelian terjadi sebagai bagian dari kampanye penargetan ulang selama jendela interaksi ulang UA. Ini dilakukan untuk menghubungkan pendapatan dengan sumber media UA dan sumber media penargetan ulang. 

Anda hanya akan mendapatkan duplikat event jika Anda telah mengaktifkan keduanya:

• Instal in-app event
• Event penargetan ulang dalam aplikasi 

Event dalam aplikasi yang dikaitkan dengan sumber media UA (instal acara dalam aplikasi) sebagai bagian dari kampanye penargetan ulang memiliki bidang is_primary_attribution=false. 

Bagaimana cara mengidentifikasi event penargetan ulang duplikat?

Bidang is_primary_attribution boolean   mengidentifikasi sumber media primer dan sekunder dalam kampanye penargetan ulang:

• False: mengidentifikasi sumber media UA asli. Catatan : Ini adalah satu-satunya skenario di mana nilainya adalah false. 
• True: mengidentifikasi sumber media keterlibatan ulang 

Alasan untuk ini adalah sebagai berikut: Jika pengguna, sebagai hasil dari kampanye penargetan ulang, terlibat dengan kampanye, jendela interaksi ulang terbuka. Sumber media interaksi ulang dianggap sebagai sumber media primer ketika jendela interaksi ulang terbuka, dan sumber UA adalah sekunder. Setelah jendela ditutup, sumber media UA asli kembali menjadi yang utama. 

• Pesan in-app event hanya dapat dipilih setelah salah satu in-app event telah direkam.
• Gunakan perangkat uji untuk menghasilkan in-app event atau gunakan S2S API untuk melakukannya secara manual. 

Secara default, Facebook tidak merilis data tingkat pengguna hingga Anda menyetujui Persyaratan Layanan Facebook.

Setelah Anda menyetujui persyaratan, data tingkat pengguna yang berasal dari Facebook dan sumber data lengkap lainnya dikirim via Push API.

Apakah Anda menggunakan Amazon CloudFront sebagai titik akhir Anda? Jika demikian, periksa apakah CloudFront menolak pesan dengan kode tolak 421. Jika demikian, lihat Memilih Cara CloudFront Melayani Permintaan HTTPS