Atribusi Aplikasi yang Mematuhi Privasi

Ringkasan

Konsumen API yang memanfaatkan Tracking Konversi Aplikasi dan API Pemasaran Ulang Google Ads untuk langsung meneruskan konversi aplikasi harus mengikuti panduan Android berikut: iOS. Ini akan memastikan klik dari pengguna yang memilih tidak ikut pelacakan iklan atau personalisasi iklan hanya diatribusikan menggunakan alur kerja yang mematuhi privasi. Lihat Spesifikasi Permintaan &Respons untuk mengetahui informasi tambahan terkait definisi parameter dan nilai yang diharapkan.

Apl Android

Cakupan

Instal Aplikasi & Engagement Aplikasi melalui semua kampanye Google Ads

Latar belakang

Saat ini, pengguna Android yang memilih tidak ikut personalisasi iklan tidak dapat dilacak menggunakan ID Iklan Android (sesuai kebijakan Google). Sebagai gantinya, Google menggunakan gclid, parameter URL klik yang tidak terus ada dengan perangkat.

Panduan

Konsumen Tracking Konversi dan Pemasaran Ulang Aplikasi harus memastikan bahwa gclid disimpan dan diteruskan dengan benar.

Skenario yang Didukung

Skenario yang Didukung: Instal (pengguna belum pernah menginstal aplikasi)

Saat penginstalan aplikasi didorong oleh deep link yang dialihkan ke Google Play Store, dan pengguna pertama kali membuka aplikasi, uraikan nilai gclid dari kolom Play Install Referrer API install_referrer dan simpan di perangkat atau sisi server yang dikunci oleh ID pihak pertama. gclid ini harus disimpan selama 180 hari, atau hingga Perujuk Instal Play lain yang lebih baru gclid menggantikannya.gclid ini dapat diteruskan melalui kolom permintaan konversi market_referrer_gclid.

ID Iklan Tersedia

Saat ID Iklan Android tersedia, market_referrer_gclid harus dikirim dengan peristiwa first_open yang sesuai. market_referrer_gclid dapat dikirim dengan sesi downstream &peristiwa aplikasi (yaitu session_start, add_to_cart, in_app_purchase, dll.).

Contoh: Pertama Dibuka
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
Contoh: Sesi dan Peristiwa Aplikasi
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
ID Iklan TIDAK Tersedia

Jika ID Iklan Android TIDAK tersedia, market_referrer_gclid harus dikirim dengan peristiwa first_open yang sesuai, dan SEMUA sesi downstream & peristiwa aplikasi (yaitu session_start, add_to_cart, in_app_purchase, dll.), bersama dengan kolom/nilai tambahan, gclid_only_request=1. Catatan: Nilai rdid harus berupa nol (karena pengguna tidak memberi izin).

Contoh: Pertama Dibuka
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
Contoh: Sesi aplikasi &amp
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

Skenario yang Didukung: Engagement Aplikasi (pengguna telah menginstal aplikasi)

Saat sesi aplikasi didorong oleh deep link, urai nilai gclid dan simpan di perangkat atau sisi server yang dikuncikan oleh ID pihak pertama.
gclid harus disimpan selama 180 hari, atau hingga gclid yang lebih baru menggantikannya. Nilai ini kemudian dapat diteruskan melalui kolom permintaan konversi gclid.

ID Iklan Tersedia

Saat ID Iklan Android tersedia, gclid harus dikirim dengan peristiwa session_start yang sesuai. gclid dapat dikirim dengan peristiwa aplikasi (yaitu add_to_cart, in_app_purchase, dsb.). gclid TIDAK boleh diteruskan dengan peristiwa session_start downstream.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
Contoh: Peristiwa Aplikasi
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
Contoh: Sesi Berikutnya/Organik
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
ID Iklan TIDAK Tersedia

Saat ID Iklan Android TIDAK tersedia, gclid harus ada untuk dikirim dengan peristiwa session_start yang sesuai dan SEMUA sesi downstream dan peristiwa aplikasi (yaitu session_start, add_to_cart, in_app_purchase, dll.). Catatan: Nilai RID harus berupa nol (karena pengguna tidak ikut personalisasi iklan).

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
Contoh: Peristiwa Aplikasi
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
Contoh: Sesi Berikutnya/Organik
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1

Skenario yang Didukung: Penginstalan + Engagement

Saat penginstalan aplikasi didorong oleh deeplink ke Google Play Store, diikuti dengan sesi aplikasi yang didorong oleh deeplink ke aplikasi, urai nilai gclid Play Install Referrer API dan deeplink dan simpan baik di perangkat maupun sisi server yang dikuncikan oleh ID pihak pertama. Nilai gclid ini harus disimpan selama 180 hari, atau sampai link dalam gclid yang lebih baru menggantikan gclid deep link yang ada gclid, atau gclid Play Install Referrer API yang ada menggantikan gclid Play Install Referrer API yang ada. Play Install Referrer API gclid harus diteruskan melalui market_referrer_gclid field, DAN deep link gclid harus diteruskan melalui kolom gclid.

ID Iklan Tersedia

Saat ID Iklan Android tersedia, market_referrer_gclid DAN gclid harus dikirim dengan peristiwa session_start dan peristiwa aplikasi yang sesuai (yaitu add_to_cart, in_app_purchase, dll.). Untuk peristiwa session_start downstream, teruskan market_referrer_gclid, tetapi (deep link) gclid TIDAK boleh diteruskan.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
Contoh: Peristiwa Aplikasi
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
Contoh: Sesi Berikutnya/Organik
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
ID Iklan TIDAK Tersedia

Saat ID Iklan Android TIDAK tersedia, market_referrer_gclid DAN gclid harus dikirim dengan peristiwa session_start yang sesuai, serta SEMUA sesi downstream dan sesi aplikasi (yaitu session_start, add_to_cart, in_app_purchase, dll.). Catatan: Nilai rdid harus semuanya nol (karena pengguna memilih untuk tidak menerima personalisasi iklan).

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
Contoh: Peristiwa Aplikasi
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
Contoh: Sesi Berikutnya/Organik
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

Aplikasi iOS

Cakupan

Engagement Aplikasi melalui Penelusuran, Shopping & Google Ads iOS + Deeplink

Latar belakang

Pengguna iOS14.5+ yang belum ikut serta dalam pelacakan aplikasi tidak dapat dilacak menggunakan IDFA (sesuai dengan kebijakan ATT Apple). Sebagai gantinya, Google menggunakan gbraid, parameter URL klik gabungan.

Panduan

Konsumen Tracking Konversi dan Pemasaran Ulang Aplikasi harus memastikan bahwa semua parameter klik diteruskan dengan benar, termasuk gclid dan gbraid.

Skenario yang Didukung

Skenario yang Didukung: Engagement Aplikasi (pengguna telah menginstal aplikasi)

Saat sesi aplikasi didorong oleh deep link, urai nilai gclid dan gbraid, lalu simpan nilai tersebut di perangkat atau sisi server yang dikuncikan oleh ID pihak pertama. Nilai ini harus disimpan selama 180 hari, atau sampai diganti dengan nilai yang lebih baru. Nilai gclid kemudian dapat diteruskan melalui kolom permintaan konversi gclid, dan nilai gbraid kemudian dapat diteruskan melalui kolom permintaan konversi gbraid.

IDFA Tersedia

Saat IDFA tersedia, gclid DAN gbraid harus dikirim dengan peristiwa session_start yang sesuai, beserta kolom/nilai tambahan, app_open_source=ad_click. gclid dan gbraid dapat dikirim dengan sesi downstream & peristiwa aplikasi (yaitu session_start, add_to_cart, in_app_purchase, dll.). Untuk sesi downstream berikutnya, sertakan kolom/nilai tambahan, app_open_source=organic.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &app_open_source=ad_click
Contoh: Peristiwa Aplikasi
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u
Contoh: Sesi Berikutnya/Organik
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u
       &app_open_source=organic
IDFA TIDAK Tersedia

Jika IDFA TIDAK tersedia, gbraid wajib dikirim dengan peristiwa session_start yang sesuai beserta kolom/nilai tambahan, app_open_source=ad_click. dan SEMUA peristiwa aplikasi downstream (yaitu add_to_cart, in_app_purchase, dll.). Catatan: Kolom gclid harus dihilangkan, dan nilai rdid harus semuanya nol (karena pengguna tidak memberi izin). gbraid JUGA diperlukan untuk dikirim dengan sesi downstream & peristiwa aplikasi yang sesuai (yaitu session_start, add_to_cart, in_app_purchase, dll.). Untuk sesi downstream berikutnya, sertakan kolom/nilai tambahan, app_open_source=organic.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &app_open_source=ad_click
Contoh: Peristiwa Aplikasi
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
Contoh: Sesi Berikutnya/Organik
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &app_open_source=organic