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 ×tamp=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 ×tamp=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 ×tamp=1432681913.123456 &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gclid_only_request=1
Contoh: Sesi 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 ×tamp=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.
Contoh: Sesi Deeplink
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 ×tamp=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 ×tamp=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 ×tamp=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).
Contoh: Sesi Deeplink
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 ×tamp=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 ×tamp=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 ×tamp=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.
Contoh: Sesi Deeplink
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 ×tamp=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 ×tamp=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 ×tamp=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).
Contoh: Sesi Deeplink
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 ×tamp=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 ×tamp=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 ×tamp=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
.
Contoh: Sesi Deeplink
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 ×tamp=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 ×tamp=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 ×tamp=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
.
Contoh: Sesi Deeplink
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 ×tamp=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 ×tamp=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 ×tamp=1432681913.123456 &gbraid=Cj0KEQjw0dy4BRCuuL_e5M &app_open_source=organic