Atribusi Aplikasi yang Mematuhi Privasi

Ringkasan

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

Aplikasi Android

Cakupan

Penginstalan Aplikasi & Engagement Aplikasi melalui semua kampanye Google Ads

Latar belakang

Saat ini, pengguna Android yang telah 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 tetap ada di perangkat. Selain itu, Google dapat menggunakan gbraid, parameter URL klik gabungan, dalam skenario lain saat izin tingkat pengguna belum diberikan.

Panduan

Konsumen App Conversion Tracking and Remarketing API harus memastikan bahwa gclid dan gbraid disimpan dan diteruskan dengan benar.

Skenario yang Didukung

Skenario yang Didukung: Penginstalan (pengguna belum pernah menginstal aplikasi sebelumnya)

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

ID Iklan Tersedia

Jika ID Iklan Android tersedia, maka market_referrer_gclid harus dikirim dengan peristiwa first_open yang sesuai dan SEMUA sesi & peristiwa aplikasi hilir (yaitu session_start,add_to_cart, in_app_purchase, dll.).

Contoh: Pembukaan Pertama
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
       &eea=0
       &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: Peristiwa Sesi dan 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
       &eea=0
       &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, maka market_referrer_gclid harus dikirim dengan peristiwa first_open yang sesuai, dan SEMUA sesi & peristiwa aplikasi hilir (yaitu session_start, add_to_cart, in_app_purchase, dll.), beserta kolom/nilai tambahan, gclid_only_request=1. Catatan: Nilai rdid harus berupa semua nol (karena pengguna tidak memberikan izin).

Contoh: Pembukaan Pertama
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
       &eea=0
       &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: Peristiwa 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
       &eea=0
       &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 gbraid dari URL perujuk dan simpan di perangkat atau sisi server yang dikunci oleh ID pihak pertama. Setiap nilai harus disimpan selama 180 hari, atau hingga digantikan oleh nilai lain yang lebih baru. Nilai deeplink gclid harus diteruskan melalui kolom permintaan konversi gclid, dan nilai deeplink gbraid harus diteruskan melalui kolom permintaan konversi gbraid.

ID Iklan Tersedia

Jika ID Iklan Android tersedia, gclid dan gbraid harus dikirim dengan peristiwa session_start yang sesuai dan SEMUA sesi & peristiwa aplikasi hilir (yaitu session_start,add_to_cart, in_app_purchase, dll.).

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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
ID Iklan TIDAK Tersedia

Jika ID Iklan Android TIDAK tersedia, gclid harus dikirim dengan peristiwa session_start yang sesuai dan SEMUA sesi dan peristiwa aplikasi hilir (yaitu session_start, add_to_cart, in_app_purchase, dll.). Catatan: Nilai rdid harus berupa nol semua (karena pengguna telah memilih untuk tidak menggunakan 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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Skenario yang Didukung: Penginstalan + Engagement

Saat penginstalan aplikasi didorong oleh deep link ke Google Play Store, diikuti dengan sesi aplikasi yang didorong oleh deep link ke aplikasi, parsing nilai gclid dari kolom install_referrer Play Install Referrer API, dan nilai gclid dan gbraid dari URL perujuk dan simpan di perangkat atau sisi server yang dikunci oleh ID pihak pertama. Setiap nilai harus disimpan selama 180 hari, atau hingga digantikan oleh nilai lain yang lebih baru. Nilai gclid perujuk penginstalan kemudian harus diteruskan melalui kolom permintaan konversi market_referrer_gclid, nilai deeplink gclid harus diteruskan melalui kolom permintaan konversi gclid, dan nilai deeplink gbraid harus diteruskan melalui kolom permintaan konversi gbraid.

ID Iklan Tersedia

Jika 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 hilir, teruskan market_referrer_gclid, tetapi JANGAN teruskan gclid (deep link).

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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
ID Iklan TIDAK Tersedia

Jika ID Iklan Android TIDAK tersedia, market_referrer_gclid DAN gclid harus dikirim dengan peristiwa session_start yang sesuai, dan SEMUA peristiwa sesi dan aplikasi hilir (yaitu session_start, add_to_cart, in_app_purchase, dll.). Catatan: Nilai rdid harus berupa nol semua (karena pengguna telah menonaktifkan 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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Aplikasi iOS

Cakupan

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

Latar belakang

Pengguna iOS14.5+ yang belum mengizinkan pelacakan aplikasi tidak dapat dilacak menggunakan IDFA (sesuai kebijakan ATT Apple). Sebagai gantinya, Google menggunakan gbraid, parameter URL klik gabungan. Selain itu, Google dapat menggunakan gbraid dalam skenario lain jika izin tingkat pengguna tidak diberikan.

Panduan

Konsumen App Conversion Tracking and Remarketing API 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, uraikan nilai gclid dan gbraid dari URL perujuk, lalu simpan di sisi perangkat atau sisi server yang dikunci oleh ID pihak pertama. Setiap nilai harus disimpan selama 180 hari, atau hingga digantikan oleh nilai lain yang lebih baru. Nilai gclid harus diteruskan melalui kolom permintaan konversi gclid, dan nilai gbraid harus diteruskan melalui kolom permintaan konversi gbraid.

IDFA Tersedia

Jika 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 juga harus dikirim dengan sesi hilir & peristiwa aplikasi (yaitu session_start, add_to_cart, in_app_purchase, dll.). Untuk sesi hilir 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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic
IDFA TIDAK Tersedia

Jika IDFA TIDAK tersedia, gbraid wajib dikirim dengan peristiwa session_start yang sesuai bersama dengan kolom/nilai tambahan, app_open_source=ad_click. dan SEMUA peristiwa aplikasi hilir (yaitu add_to_cart, in_app_purchase, dll.). Catatan: Kolom gclid harus dihilangkan, dan nilai rdid harus berupa nol semua (karena pengguna tidak memberikan izin). gbraid JUGA harus dikirim dengan sesi hilir & peristiwa aplikasi yang sesuai (yaitu session_start, add_to_cart, in_app_purchase, dll.). Untuk sesi hilir 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
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &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
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
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
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic