Halaman ini diterjemahkan oleh Cloud Translation API.

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.

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
       &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).

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
       &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.

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
       &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).

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
       &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

Penting: Play Install Referrer API gclid (diteruskan sebagai market_referrer_gclid) dan deep link gclid (diteruskan sebagai gclid) adalah dua sumber terpisah untuk gclid dan tidak boleh digunakan secara bergantian. Sebagai pengingat, nilai gclid ini harus disimpan selama 180 hari, atau sampai deep link lain yang lebih baru gclid menggantikan gclid deeplink yang ada, atau gclid Perujuk Play Install menggantikan gclid Referrer API Play Install yang ada.

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
       &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.

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
       &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

Catatan: gbraid tidak dapat dimanfaatkan dalam skenario Penginstalan karena pengguna pertama kali dialihkan ke iTunes.