Pencocokan Cookie adalah fitur yang memungkinkan Anda mencocokkan cookie—misalnya, ID untuk pengguna yang menjelajahi situs Anda—dengan ID Pengguna Google khusus bidder yang terkait, dan membuat daftar pengguna yang dapat membantu Anda membuat pilihan bidding yang lebih efektif. Panduan ini menjelaskan konsep yang digunakan dalam Pencocokan Cookie, serta berbagai alur kerja Pencocokan Cookie, dan variasi apa pun yang mungkin dimiliki untuk kasus penggunaan tertentu.
Konsep
Apa itu Pencocokan Cookie?
Pemilik domain biasanya menetapkan konten cookie untuk pengguna yang menjelajahi situs mereka, yang digunakan untuk mengidentifikasi pengguna dalam domain tersebut. Meskipun jika dua pemilik domain setuju untuk bertukar data ini, model keamanan browser internet membatasi satu pemilik domain agar tidak membaca cookie yang ditetapkan oleh domain lain.
Dalam konteks iklan digital, Google mengidentifikasi pengguna dengan cookie
yang termasuk dalam domain doubleclick.net
, dan bidder
yang berpartisipasi dalam Bidding Real-Time mungkin memiliki domain sendiri tempat mereka
mengidentifikasi beberapa kumpulan pengguna yang ingin mereka tampilkan untuk menampilkan iklan. Pencocokan Cookie
memungkinkan bidder mencocokkan cookie mereka dengan cookie Google, sehingga mereka dapat
menentukan apakah tayangan yang dikirim dalam permintaan bid dikaitkan dengan salah satu
pengguna yang ditargetkan, mereka akan menerima data cookie mereka sendiri atau
ID Pengguna Google khusus bidder yang merupakan bentuk terenkripsi dari cookie
doubleclick.net
dalam permintaan bid.
Layanan pencocokan cookie yang dijelaskan dalam panduan ini memfasilitasi pembuatan dan pemeliharaan pengaitan antara cookie bidder dan User-ID Google, serta memungkinkan seseorang mengisi daftar pengguna.
Tabel pencocokan
Tabel pencocokan dapat digunakan untuk memetakan ID atau data lainnya dari satu domain ke domain lain. Bidder dapat menggunakan Layanan Pencocokan Cookie untuk mengisi tabel pencocokan mereka sendiri dengan memetakan cookie mereka untuk pengguna tertentu ke ID Pengguna Google pengguna, atau untuk mengisi tabel pencocokan yang dihosting oleh Google. Tabel pencocokan diperlukan agar aplikasi bidder dapat mengakses data cookie bagi pengguna yang sedang melihat tayangan.
Tabel pencocokan yang dihosting Google
Untuk pemeliharaan, peningkatan latensi, dan akses yang lebih mudah guna mencocokkan data bagi pengguna di region tertentu, sebaiknya Anda mengizinkan Google untuk menghosting tabel pencocokan Anda. Hal ini memungkinkan Anda menentukan string berenkode base64 yang aman untuk web—selanjutnya disebut sebagai data pencocokan yang dihosting—yang akan dipetakan ke ID Pengguna Google untuk pengguna tertentu. Setelah ditetapkan, kecocokan dapat digunakan dengan cara berikut:
Bidding Real-Time: Dalam permintaan bid berikutnya untuk tayangan yang terkait dengan pengguna, Google akan mengirimkan data pencocokan yang dihosting yang Anda cocokkan dengan ID Pengguna Google mereka. Jika endpoint bidding Anda dikonfigurasi untuk menggunakan protokol RTB Google, Anda akan menerimanya sebagai byte yang didekode melalui kolom
BidRequest.hosted_match_data
. Dalam implementasi OpenRTB Google,BidRequest.user.buyeruid
akan menampilkan data ini sebagai string berenkode base64 yang aman untuk web.Daftar Pengguna: Daftar pengguna dapat diisi dengan ID Pengguna Google atau data pencocokan yang dihosting.
- Pra-penargetan: Anda dapat mengonfigurasi pra-penargetan sehingga Anda hanya menerima permintaan bid yang berisi data pencocokan yang dihosting. Cara ini dapat digunakan untuk menghilangkan tayangan yang kurang relevan bagi pengguna di luar ruang cookie Anda.
Daftar pengguna
Daftar pengguna dapat dibuat dan dikelola dengan Real-Time Bidding API. Setelah dibuat, Anda dapat mengisi daftar ini dengan alur kerja Pencocokan Cookie yang dijelaskan di bawah, atau melalui Layanan Uploader Massal.
Memulai
Untuk mulai menggunakan Pencocokan Cookie, Anda harus menghubungi Manajer Akun Teknis, yang dapat mengaktifkan alur kerja tertentu dan membantu Anda mengonfigurasi hal berikut:
- ID Jaringan Pencocokan Cookie (NID): ID string yang secara unik mengidentifikasi akun bidder untuk Pencocokan Cookie dan operasi terkait lainnya.
- URL Pencocokan Cookie: URL dasar untuk endpoint yang akan menerima dan menangani permintaan masuk sebagai bagian dari alur kerja Pencocokan Cookie. Bidder dapat menyematkan makro di URL ini untuk mengontrol pengurutan parameter yang diteruskan ke URL tersebut dalam alur kerja Pencocokan Cookie.
- Tag Pencocokan: Tag yang harus Anda tempatkan di browser pengguna untuk alur kerja Pencocokan Cookie yang dimulai bidder. Iklan ini dapat ditayangkan bersama iklan, atau ditempatkan di properti web di luar iklan.
- URL Laporan Pencocokan Cookie (opsional): Di Alur Kerja Pencocokan Cookie Searah, ini adalah URL opsional yang dapat diberikan untuk menentukan endpoint yang akan menerima detail error jika pencocokan cookie gagal melalui pengalihan HTTP 302. Secara default, respons hanya akan dikirim ke URL ini jika terjadi error pada operasi pencocokan cookie, tetapi bidder dapat meminta agar pengalihan selalu dikirim.
- URL Bantuan Cookie Match: Untuk bursa yang menerapkan alur kerja Cookie Match Assist, ini adalah URL dasar dari endpoint yang dimaksudkan untuk merespons permintaan masuk.
- Kuota Bantuan Pencocokan Cookie: Untuk bursa yang menerapkan alur kerja Bantuan Pencocokan Cookie, ini adalah jumlah maksimum permintaan yang dapat diterima URL Pencocokan Cookie mereka setiap detik. Hal ini dimaksudkan untuk mencegah permintaan CMA membebani server bursa dengan permintaan.
Makro pencocokan cookie
Dalam alur kerja Pencocokan Cookie yang didukung, URL Pencocokan Cookie bidder biasanya memiliki parameter yang ditambahkan dalam urutan tanpa jaminan. Bidder dengan integrasi yang memerlukan pengurutan parameter yang konsisten dapat menempatkan makro di URL Pencocokan Cookie untuk menjamin penempatannya.
Makro yang didukung
Secara opsional, bidder dapat mengonfigurasi URL Pencocokan Cookie mereka untuk menyertakan satu atau
beberapa makro dalam bentuk %%GOOGLE_<PARAM_NAME>%%
atau
%%GOOGLE_<PARAM_NAME>_PAIR%%
. Makro yang didukung dan
nilainya yang diperluas adalah:
Macro | Nilai yang diperluas |
---|---|
GOOGLE_GID | GOOGLE_USER_ID |
GOOGLE_GID_PAIR | &google_gid=GOOGLE_USER_ID |
GOOGLE_CVER | COOKIE_VERSION_NUMBER |
GOOGLE_CVER_PAIR | &cver=COOKIE_VERSION_NUMBER |
GOOGLE_ERROR | ERROR_ID |
GOOGLE_ERROR_PAIR | &google_error=ERROR_ID |
GOOGLE_PUSH | PIXEL_MATCH_DATA |
GOOGLE_PUSH_PAIR | &google_push=PIXEL_MATCH_DATA |
GOOGLE_ALL_PARAMS | google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&google_error=ERROR_ID |
Contoh makro
Bidder memiliki integrasi pencocokan cookie dengan endpoint yang dihosting di
https://user.bidder.com.cookies
, dan penerapannya memerlukan
parameter yang ditentukan bidder preset selain parameter Pencocokan Pixel
dalam urutan berikut: google_push
,
google_gid
, google_cver
, dan
google_error
. Bidder dapat melakukannya dengan menetapkan
URL Pencocokan Cookie mereka ke:
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
Saat Google mengirimkan permintaan pencocokan ke bidder ini, permintaan tersebut akan diperluas menjadi seperti berikut:
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
Alur kerja Layanan Pencocokan Cookie
Layanan Pencocokan Cookie Google saat ini mendukung tiga alur kerja untuk berbagai kasus penggunaan yang dijelaskan di bawah.
Dimulai oleh bidder: Pencocokan Cookie Dua Arah
Pencocokan Cookie Dua Arah mengacu pada alur kerja yang dimulai oleh bidder, dengan menempatkan tag pencocokan di browser pengguna yang mengarahkannya ke Google. Dengan alur kerja ini, Google dan bidder dapat mengisi tabel pencocokan. Berikut adalah contoh sederhana dari alur kerja ini.
Langkah 1: Tempatkan tag pencocokan
Untuk memulai alur ini, bidder harus menempatkan tag pencocokannya sedemikian rupa sehingga dirender di browser pengguna. Tag pencocokan sederhana yang hanya menampilkan ID Pengguna Google kepada bidder dapat disusun sebagai berikut:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
Ada parameter tambahan yang dapat Anda sertakan dalam tag pencocokan untuk memenuhi berbagai kasus penggunaan. Untuk mempelajari parameter ini lebih lanjut, lihat Parameter URL Tag Cocok.
Langkah 2: Google merespons dengan pengalihan, termasuk data pencocokan
Tag pencocokan akan menyebabkan Layanan Pencocokan Cookie Google menerima
permintaan dari browser pengguna, yang akan mengeluarkan pengalihan HTTP 302
ke URL Pencocokan Cookie bidder. Pengalihan akan menyertakan parameter kueri yang menentukan ID Pengguna Google dan nomor versinya di URL, dan bidder juga akan menerima cookie mereka yang disertakan dalam header permintaan. Dalam praktiknya, untuk URL pencocokan cookie yang ditentukan sebagai https://ad.network.com/pixel
, URL alihan untuk tag pencocokan sederhana seperti yang terlihat di atas dapat terlihat seperti berikut:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
ID Pengguna Google yang diteruskan melalui parameter google_gid
adalah string berenkode base64 yang aman untuk web tanpa padding. Untuk bidder yang memilih menghosting tabel pencocokan, sebaiknya mereka
menyimpan string persis yang ditampilkan oleh Layanan Pencocokan Cookie. Dalam permintaan bid berikutnya, ini akan sesuai dengan nilai yang ditentukan melalui BidRequest.google_user_id
dalam protokol RTB Google, atau BidRequest.user.id
dalam penerapan OpenRTB Google.
Versi yang ditentukan dalam google_cver
menunjukkan nomor versi
numerik untuk User-ID Google. ID Pengguna Google untuk pengguna tertentu akan jarang berubah, setelah itu akan ditingkatkan.
Jika Google mengalami error saat memproses permintaan pencocokan Anda, parameter google_error
akan ditentukan.
Langkah 3: Bidder memproses pengalihan dan merespons dengan piksel
Bidder menerima pengalihan ke URL pencocokan cookie mereka, termasuk parameter yang ditentukan pada langkah pertama, dan yang diberikan oleh Google di langkah kedua. Selain itu, mereka juga akan menerima cookie di header HTTP. Jika operasi berhasil, bidder yang menghosting tabel pencocokannya sendiri dapat mencocokkan cookie-nya dengan ID Pengguna Google yang disertakan dalam respons. Sebaiknya Bidder menyimpan string persis seperti yang ditampilkan oleh Layanan Pencocokan Cookie.
Jika operasi tidak berhasil, bidder akan menerima parameter google_error
dalam pengalihan. Ini adalah nilai numerik yang sesuai dengan berbagai status error yang mengidentifikasi error tertentu yang terjadi. Anda dapat mempelajari lebih lanjut kemungkinan nilai error di sini.
Jika menerima error, Anda dapat mencoba mencocokkan lagi pengguna tersebut dengan menempatkan tag pencocokan baru.
Bidder harus selalu merespons dengan menayangkan gambar piksel tidak terlihat 1x1, atau
menampilkan respons HTTP 204
Tidak Ada Konten.
Diagram alur kerja Pencocokan Cookie
Alur kerja ini diilustrasikan oleh diagram di bawah, dengan permintaan dan respons diwakili oleh panah, dan item data yang menyertainya dicantumkan dalam tanda kurung.
![](https://developers.google.cn/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=8&hl=id)
Parameter URL Tag Pencocokan
Parameter | Deskripsi |
---|---|
google_nid |
ID Jaringan (NID) untuk akun bidder. ID ini dapat diambil melalui resource Bidder. |
google_cm |
Menunjukkan kepada Layanan Pencocokan Cookie Google bahwa pencocokan cookie harus dijalankan. Nilai parameter diabaikan dan dapat dihilangkan. |
google_sc |
Parameter ini tidak digunakan lagi. Menetapkan cookie Google bagi pengguna jika tidak ada. Nilai parameter diabaikan dan dapat dihilangkan. Menghapus parameter akan menghasilkan error jika tidak ada cookie. |
google_no_sc |
Parameter ini tidak digunakan lagi. Hal ini menunjukkan kepada Layanan Pencocokan Cookie Google bahwa cookie tidak boleh ditetapkan untuk pengguna jika cookie tersebut tidak ada. Nilai parameter diabaikan dan dapat dihilangkan. |
google_hm |
Data yang ingin disimpan oleh bidder di tabel pencocokan yang dihosting Google.
Nilainya adalah string berenkode base64 yang aman untuk web (padding opsional). Data mentah harus berukuran maksimal 40
byte. Misalnya, |
google_redir |
String berenkode URL yang dapat ditentukan bidder jika ingin mengarahkan
Google agar mengirim pengalihan HTTP 302 ke URL yang dienkode untuk
tag pencocokan ini. Hal ini memungkinkan Google ditempatkan di posisi terdepan dalam panggilan berantai kepada partner. Hal ini akan mengakibatkan error jika ditentukan tanpa
google_hm , atau dengan google_cm . |
google_ula |
String yang digunakan untuk menambahkan pengguna ke daftar pengguna yang ada. Format
nilai yang diharapkan adalah userlistid[,timestamp] :
Parameter URL ini dapat diulang untuk menambahkan pengguna ke beberapa daftar. |
gdpr |
Menunjukkan bahwa permintaan ini tunduk pada batasan GDPR terkait penggunaan data. Untuk mengetahui detail selengkapnya, lihat
Persyaratan izin pengguna Uni Eropa di bawah, atau Dampak terhadap kelayakan
pencocokan cookie di
Dokumentasi TCF v2.0 IAB Authorized Buyers.
Contoh: |
gdpr_consent |
String TC yang mewakili izin pengguna akhir. Untuk mengetahui detail selengkapnya, lihat Persyaratan izin pengguna Uni Eropa di bawah, atau Bagaimana string TC akan diteruskan? dalam dokumentasi TCF v2.0 IAB Authorized Buyers. |
process_consent |
Menunjukkan bahwa bidder telah memperoleh izin pengguna akhir untuk penggunaan data yang ditentukan dalam
Kebijakan Izin Pengguna Uni Eropa Google.
Jika permintaan tersebut tidak tunduk pada Kebijakan Izin Pengguna Uni Eropa, atau jika ada parameter izin lain yang tersedia di permintaan ( Contoh: |
Selain parameter di atas, bidder dapat menentukan nilainya sendiri, yang
akan ditambahkan sebagai parameter ke URL alihan. Perhatikan bahwa parameter yang ditentukan bidder
yang diberi nama dengan awalan google_
akan diabaikan karena
parameter tersebut dicadangkan oleh Google untuk pengembangan di masa mendatang, dan mempertahankan
urutan parameter tidak dijamin. Tag pencocokan yang mencakup parameter yang ditentukan bidder mungkin terlihat seperti ini:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
Parameter URL Pengalihan
URL alihan dibuat dari URL Pencocokan Cookie dasar yang dikonfigurasi untuk
akun bidder, termasuk google_
dan parameter yang ditentukan bidder,
bergantung pada parameter yang ditentukan dalam tag pencocokan. Parameter respons google_
berikut ditentukan:
Parameter | Deskripsi |
---|---|
google_gid |
ID Pengguna Google. Tetapkan jika google_cm ditentukan dalam permintaan dan permintaan berhasil. |
google_cver |
Versi cookie. Tetapkan jika google_cm ditentukan dalam permintaan dan permintaan berhasil. |
google_error |
Nilai integer yang menunjukkan error permintaan secara keseluruhan. Saat diterima, ini menunjukkan bahwa tidak ada operasi yang dilakukan, dan tidak ada parameter respons
|
google_hm |
Hanya muncul jika upaya untuk menulis ke tabel pencocokan yang dihosting Google gagal. Jika hal itu terjadi, nilainya adalah salah satu kode status berikut:
|
google_ula |
Status operasi penambahan daftar pengguna, diulang jika beberapa Contoh: Operasi
|
Skenario contoh alur kerja Pencocokan Cookie
Skenario berikut menjelaskan seperti apa pencocokan cookie untuk pengguna pada umumnya yang menjelajahi halaman web.
Skenario 1: Pengguna menghapus cookie dan menjelajahi situs
Juwita menghapus cache semua cookie mereka. Selanjutnya, mereka mengunjungi halaman beranda ExampleNews.com.
Berikut ini prosesnya:
- ExampleNews.com merender, dan memanggil iklan dari Google (Ad Manager).
- Karena unit iklan memenuhi syarat untuk alokasi dinamis, Google mengirimkan permintaan bid ke FinestDSP dan bidder lain melalui layanan Bidding Real-Time.
- Aplikasi bidder FinestDSP menerima dan memproses permintaan bid, serta mengirimkan respons bid-nya.
- Google menerima respons bid dari bidder, termasuk respons FinestDSP yang menentukan iklan dengan tag pencocokan (piksel).
- FinestDSP memenangkan lelang. Google menayangkan iklan dan tag pencocokan FinestDSP kepada Jihan.
- Tag pencocokan memanggil Layanan Pencocokan Cookie Google, dengan menentukan
parameter
google_nid
dangoogle_cm
. - Layanan Pencocokan Cookie membaca cookie Google Jenar, dan mengirimkan browser
Juwita pengalihan ke URL Pencocokan Cookie FinestDSP dengan
parameter
google_user_id
dangoogle_cver
yang ditetapkan. - Browser Jeni memuat pengalihan ke URL Pencocokan Cookie FinestDSP.
- Endpoint pencocokan cookie FinestDSP memproses permintaan pengalihan,
yang mencakup parameter URL yang ditetapkan oleh Google, dan cookie-nya untuk Juwita di
header HTTP. FinestDSP sekarang dapat menyimpan pemetaan cookie ke
google_user_id
di tabel pencocokannya. - FinestDSP merespons pengalihan dengan piksel 1x1 yang tidak terlihat.
![](https://developers.google.cn/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=8&hl=id)
Skenario 2: Pengguna dengan pemetaan yang ada
Seminggu setelah Skenario 1, Jane mengunjungi ExampleNews.com lagi. Setelah Jane memiliki cookie bidder dan Ad Manager di komputernya, berikut cara kerja pencocokan.
- Halaman web dirender, yang menyebabkan Google (Ad Manager) meminta iklan yang akan dirender di halaman.
- Selama lelang iklan, Google mengirimkan permintaan bid kepada bidder yang berlaku, termasuk FinestDSP.
- FinestDSP menerima permintaan bid, termasuk sinyal seperti
google_user_id
. - FinestDSP mencari
google_user_id
di tabel pencocokannya, dan menemukan cookie yang terkait dengan Juwita yang dibuat seminggu sebelumnya (di Skenario 1). - Berdasarkan informasi yang terkait dengan cookie, logika bidding FinestDSP menempatkan bid pada tayangan, dan memenangkan lelang.
- Jane mungkin melihat iklan yang disesuaikan dengan minat mereka, berdasarkan informasi yang dimiliki FinestDSP.
Dimulai oleh bidder: Pencocokan Cookie Searah
Pencocokan Cookie Searah mirip dengan alur kerja Dua arah,
kecuali jika diubah sedemikian rupa sehingga hanya Google yang menghosting dan mengisi tabel
pencocokan. Hal ini dapat digunakan saat bidder tidak diizinkan untuk menghosting
ID Pengguna Google di tabel pencocokannya sendiri. Untuk menggunakan alur ini, bidder
harus mengizinkan Google menghosting tabel pencocokan, tidak dapat lagi menentukan
google_cm
dalam permintaan ke Layanan Pencocokan Cookie Google, dan
sebagai akibatnya tidak akan menerima google_gid
untuk mengisi tabel
pencocokan mereka sendiri. Setelah Google menetapkan kecocokan untuk pengguna, bidder dapat menambahkannya ke daftar pengguna menggunakan data cookie mereka sendiri. Demikian pula, permintaan bid untuk pengguna ini akan mengecualikan ID Pengguna Google, tetapi menyertakan data pencocokan yang dihosting. Contoh
sederhana dari alur kerja yang direvisi dirangkum dalam langkah-langkah di bawah.
Langkah 1: Tempatkan tag pencocokan yang diarahkan ke URL Pencocokan Cookie bidder
Untuk memulai alur ini, bidder harus menempatkan tag pencocokan sedemikian rupa sehingga
dirender di browser pengguna. Tidak seperti alur kerja untuk pengguna yang tidak berasal dari negara bagian AS dengan pembatasan privasi, tag pencocokan harus mengarahkan browser pengguna ke URL Pencocokan Cookie Anda. Misalnya, dengan URL Pencocokan Cookie yang dikonfigurasi sebagai https://ad.network.com/pixel
, URL tersebut akan terlihat seperti ini:
<img src="https://ad.network.com/pixel" />
Saat dimuat di browser pengguna, API ini akan meminta piksel dari URL Pencocokan Cookie bidder. Permintaan ini akan berisi cookie-nya di header HTTP, yang harus diekstrak untuk langkah berikutnya.
Langkah 2: Alihkan ke layanan Pencocokan Cookie Google
Endpoint pencocokan cookie bidder harus dialihkan ke layanan Pencocokan
Cookie Google, termasuk parameter google_hm
yang diisi dengan
data cookie berenkode base64 yang aman untuk web. URL alihan mungkin terlihat seperti berikut:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
Langkah 3: Browser pengguna dialihkan ke layanan Pencocokan Cookie Google
Google akan menerima pengalihan yang berisi parameter yang Anda tentukan, selain cookie Google di header HTTP.
Langkah 4: Google menayangkan piksel saat berhasil atau saat pengalihan error jika URL laporan ditentukan
Jika operasi pencocokan cookie berhasil—atau jika tidak ada URL
Laporan Pencocokan Cookie yang ditentukan untuk akun bidder—Google akan menampilkan piksel transparan 1x1 secara default, dan alur kerjanya akan berakhir di sini.
Tayangan untuk pengguna ini dalam permintaan bid berikutnya akan menyertakan data pencocokan yang dihosting bidder di BidRequest.hosted_match_data
untuk Protokol Google, atau BidRequest.user.buyeruid
untuk implementasi OpenRTB Google. Bidder juga dapat mengisi daftar pengguna menggunakan data pencocokan yang dihosting
yang mereka tentukan.
Atau, jika terjadi error, Google akan mengirim pengalihan ke URL Laporan Pencocokan Cookie bidder beserta penyebab error yang ditentukan di parameter google_error
. Jika URL Laporan Pencocokan Cookie bidder adalah https://ad.network.com/report
, URL alihan akan terlihat seperti ini:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
Langkah 5: Browser pengguna mengalihkan ke URL Laporan Pencocokan Cookie bidder
Browser pengguna akan dialihkan ke URL Laporan Pencocokan Cookie bidder,
termasuk alasan error (jika ada) yang ditentukan oleh Google di
parameter google_error
. Untuk mempelajari lebih lanjut cara menafsirkan kode error, lihat deskripsi parameter.
Langkah 6: Bidder menayangkan piksel transparan 1x1
Bidder harus merespons dengan menayangkan piksel transparan 1x1 ke browser pengguna.
Diagram alur kerja Pencocokan Cookie untuk pengguna dari negara bagian Amerika Serikat dengan pembatasan privasi
Alur kerja default untuk pengguna di negara bagian Amerika Serikat dengan pembatasan privasi diilustrasikan oleh diagram di bawah, dengan permintaan dan respons diwakili dengan panah, dan item data yang menyertainya dicantumkan dalam tanda kurung.
![](https://developers.google.cn/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=8&hl=id)
Parameter URL untuk pengalihan bidder ke layanan Pencocokan Cookie Google
Parameter | Deskripsi |
---|---|
google_nid |
ID Jaringan (NID) untuk akun bidder. ID ini dapat diambil melalui resource Bidder. |
google_sc |
Parameter ini tidak digunakan lagi. Menetapkan cookie Google bagi pengguna jika tidak ada. Nilai parameter diabaikan dan dapat dihilangkan. Menghapus parameter akan menghasilkan error jika tidak ada cookie. |
google_no_sc |
Parameter ini tidak digunakan lagi. Hal ini menunjukkan kepada Layanan Pencocokan Cookie Google bahwa cookie tidak boleh ditetapkan untuk pengguna jika cookie tersebut tidak ada. Nilai parameter diabaikan dan dapat dihilangkan. |
google_hm |
Berisi data yang ingin disimpan oleh bidder di tabel pencocokan yang dihosting Google. |
google_redir |
URL berenkode yang Anda inginkan agar dikirim oleh Google sebagai pengalihan HTTP 302. URL
yang ditentukan akan menerima pengalihan dengan parameter google_error
untuk error dan operasi yang berhasil. |
google_ula |
String yang digunakan untuk menambahkan pengguna ke daftar pengguna yang ada. Format
nilai yang diharapkan adalah userlistid[,timestamp] :
Parameter URL ini dapat diulang untuk menambahkan pengguna ke beberapa daftar. |
gdpr |
Menunjukkan bahwa permintaan ini tunduk pada batasan GDPR terkait penggunaan data. Untuk mengetahui detail selengkapnya, lihat
Persyaratan izin pengguna Uni Eropa di bawah, atau Dampak terhadap kelayakan
pencocokan cookie di
Dokumentasi TCF v2.0 IAB Authorized Buyers.
Contoh: |
gdpr_consent |
String TC yang mewakili izin pengguna akhir. Untuk mengetahui detail selengkapnya, lihat Persyaratan izin pengguna Uni Eropa di bawah, atau Bagaimana string TC akan diteruskan? dalam dokumentasi TCF v2.0 IAB Authorized Buyers. |
process_consent |
Menunjukkan bahwa bidder telah memperoleh izin pengguna akhir untuk penggunaan data yang ditentukan dalam
Kebijakan Izin Pengguna Uni Eropa Google.
Jika permintaan tersebut tidak tunduk pada Kebijakan Izin Pengguna Uni Eropa, atau jika ada parameter izin lain yang tersedia di permintaan ( Contoh: |
Parameter URL untuk Google mengalihkan ke URL Laporan Pencocokan Cookie Bidder
Parameter | Deskripsi |
---|---|
google_error |
Nilai integer yang menunjukkan error permintaan secara keseluruhan. Saat diterima, ini menunjukkan bahwa tidak ada operasi yang dilakukan, dan tidak ada parameter respons
|
Dimulai Google: Pencocokan Piksel Dua Arah
Pencocokan Piksel Dua Arah adalah alur kerja untuk Layanan Pencocokan Cookie Google tempat Google mencoba mencocokkan ID Pengguna Google dengan bidder yang dipilih secara algoritmis selain pemenang lelang Bidding Real-Time. Saat iklan ditempatkan, Google akan menempatkan tag pencocokan yang mengarahkan browser pengguna untuk memuat piksel transparan dari URL Pencocokan Cookie bidder yang dipilih. Tindakan ini akan memungkinkan Google dan bidder mengisi tabel pencocokan dengan pengguna tertentu. Berikut adalah contoh sederhana dari alur kerja ini.
Langkah 1: Google menempatkan tag pencocokan
Saat halaman penayang yang berpartisipasi dimuat di browser pengguna, dan
slot iklan di halaman tersebut diisi oleh Google, tag pencocokan dapat ditempatkan yang
meminta piksel dari bidder yang dipilih secara algoritmis. Tag Pencocokan Piksel
yang ditempatkan oleh Google menggabungkan URL Pencocokan Cookie bidder dengan
parameter tambahan yang
dapat digunakan oleh bidder untuk mengisi tabel pencocokannya. Untuk URL Pencocokan Cookie
yang ditentukan sebagai https://ad.network.com/pixel
, strukturnya adalah
sebagai berikut:
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
Langkah 2: Bidder harus merespons dengan mengalihkan ke URL Layanan Pencocokan Cookie Google
Bidder yang menerima permintaan pencocokan piksel harus merespons dengan pengalihan ke Layanan Pencocokan Cookie Google yang disusun sebagai berikut:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
Perhatikan bahwa URL alihan di atas mirip dengan URL yang digunakan dalam
tag pencocokan untuk Alur Kerja Pencocokan Cookie yang Dimulai Bidder.
Dalam Pencocokan Piksel, parameter google_cm
diganti dengan parameter
google_push
, dan nilainya harus sama dengan nilai
yang diberikan oleh Google dalam permintaan. Sama halnya dengan alur kerja
yang dimulai oleh bidder, parameter tambahan
dapat ditentukan untuk memenuhi kasus penggunaan tambahan.
Langkah 3: Google memproses pengalihan dan merespons dengan piksel
Google mencatat kecocokan yang telah dibuat untuk pengguna, dan menangani operasi tambahan apa pun yang diminta melalui parameter kueri. Terakhir, Google akan merespons dengan piksel transparan 1x1.
Diagram alur kerja Pencocokan Piksel
Alur kerja ini diilustrasikan oleh diagram di bawah, dengan permintaan dan respons diwakili oleh panah, dan item data yang menyertainya dicantumkan dalam tanda kurung.
![](https://developers.google.cn/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=8&hl=id)
Parameter permintaan tag pencocokan Google
Parameter | Deskripsi |
---|---|
google_gid |
ID Pengguna Google. Untuk pengguna yang tidak berasal dari negara bagian AS dengan pembatasan privasi, hal ini akan selalu ditentukan di tag pencocokan Google. |
google_cver |
Versi cookie. Nilai ini akan selalu ditentukan di tag pencocokan Google. |
google_push |
Menunjukkan bahwa permintaan ini memulai alur kerja Pencocokan Pixel. Nilai harus ditampilkan melalui parameter yang sesuai dalam respons pengalihan bidder. |
Parameter pengalihan Pencocokan Piksel bidder
Parameter | Deskripsi |
---|---|
google_nid |
ID Jaringan (NID) untuk akun bidder. ID ini dapat diambil melalui resource Bidder. |
google_push |
Menunjukkan bahwa pengalihan ini sedang menyelesaikan alur kerja Pencocokan Piksel. Nilai dari tag pencocokan Google yang sesuai harus ditentukan di sini. |
google_hm |
Berisi data yang ingin disimpan oleh bidder di tabel pencocokan yang dihosting Google. |
google_ula |
String yang digunakan untuk menambahkan pengguna ke daftar pengguna yang ada. Format
nilai yang diharapkan adalah userlistid[,timestamp] :
Parameter URL ini dapat diulang untuk menambahkan pengguna ke beberapa daftar. |
Dimulai oleh Google: Pencocokan Piksel Searah
Pencocokan Piksel Searah berbeda dengan alur kerja Dua arah karena tag pencocokan Google tidak menyertakan parameter yang menentukan User ID Google, tetapi akan terus mengisi tabel pencocokan yang dihosting Google. Hal ini dapat digunakan jika bidder tidak diizinkan untuk menghosting ID Pengguna Google di tabel pencocokannya sendiri. Contoh sederhana dari alur kerja yang direvisi dirangkum dalam langkah-langkah di bawah ini.
Langkah 1: Google menempatkan tag pencocokan
Google menempatkan tag pencocokan untuk bidder yang dipilih secara algoritmis. Tag pencocokan menyertakan
parameter google_push
. Berikut contohnya:
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
Langkah 2: Browser pengguna meminta piksel dari URL Pencocokan Masak milik bidder
Browser pengguna meminta piksel dari URL Pencocokan Cookie bidder, termasuk cookie bidder di header HTTP.
Langkah 3: Alihkan ke Layanan Pencocokan Cookie Google
Endpoint pencocokan cookie bidder harus dialihkan ke layanan Pencocokan
Cookie Google, termasuk parameter google_hm
yang diisi dengan
data cookie berenkode base64 yang aman untuk web. URL alihan mungkin terlihat seperti berikut:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA
Langkah 4: Browser pengguna dialihkan ke layanan Pencocokan Cookie Google
Google akan menerima pengalihan yang berisi parameter yang Anda tentukan, selain cookie Google di header HTTP. Jika operasi berhasil, tayangan untuk pengguna ini dalam permintaan bid berikutnya akan menyertakan data pencocokan yang dihosting bidder di BidRequest.hosted_match_data
untuk Protokol Google, atau BidRequest.user.buyeruid
untuk penerapan OpenRTB Google. Bidder juga dapat mengisi daftar pengguna menggunakan data pencocokan
yang dihosting yang mereka tentukan.
Terakhir, Google mengembalikan piksel transparan 1x1 ke browser pengguna.
Bantuan Pencocokan Cookie
Bidding Terbuka memungkinkan bursa menggunakan alur kerja pencocokan cookie yang diawali bidder dan yang dimulai Google, untuk mencocokkan User-ID Google dengan cookie mereka. Cookie Match Assist (CMA) adalah fitur tambahan untuk bursa yang memungkinkan mereka membuat tabel pencocokan dengan bidder mereka sendiri.
Cara kerja Bantuan Pencocokan Cookie
Saat menempatkan iklan, Google memilih pertukaran yang berpartisipasi secara algoritmis dan menempatkan tag Bantuan Pencocokan Cookie yang memiliki struktur berikut:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
Tag pencocokan CMA Google menyebabkan URL Pencocokan Cookie bursa menerima permintaan piksel.
- Endpoint Pencocokan Cookie bursa menerima permintaan, dan layanan pencocokan cookie miliknya bertanggung jawab untuk mencocokkan ID pengguna dengan salah satu bidder-nya. Pada diagram di bawah, layanan pencocokan cookie bursa merespons browser pengguna dengan pengalihan ke salah satu endpoint bidder-nya.
- Bidder menerima permintaan tersebut, beserta parameter apa pun yang ditentukan oleh bursa untuk mencocokkan ID pengguna dengan cookie mereka.
![](https://developers.google.cn/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=8&hl=id)
Batasan
Batasi frekuensi permintaan untuk pencocokan baru
Bidder bertanggung jawab membatasi jumlah panggilan ke layanan Pencocokan Cookie bagi pengguna yang memiliki entri baru di tabel pencocokan yang dihosting Google. Entri dalam tabel pencocokan yang dihosting dapat dianggap habis masa berlakunya dalam waktu 14 hari, setelah itu dapat dimuat ulang.
Merespons semua permintaan pencocokan piksel
Bidder yang menggunakan alur kerja Pencocokan Pixel diharapkan merespons semua
permintaan Pixel Match yang masuk dengan respons termasuk parameter
google_push
. Hal ini memungkinkan Google menegakkan kebijakan dengan memantau penggunaan. Jika
rasio respons bidder turun di bawah 90%, Google akan men-throttle jumlah
permintaan Pixel Match yang dikirimkan ke akun mereka.
Menggunakan endpoint HTTPS
Endpoint harus digunakan di semua alur kerja Pencocokan Cookie menggunakan HTTPS.
Saat merespons permintaan Pencocokan Pixel yang dikirimkan kepada Anda melalui HTTPS, Anda harus mengalihkan ke Layanan Pencocokan Cookie melalui HTTPS. Demikian pula, endpoint Bantuan Pencocokan Cookie yang mengalihkan ke bidder juga harus menggunakan HTTPS. Jika Anda mengirim permintaan ke Google melalui HTTP lebih sering dari sekali setiap 2 menit, jumlah permintaan pencocokan yang dikirim ke akun Anda akan dibatasi.
Persyaratan izin pengguna Uni Eropa
Permintaan Pencocokan Cookie yang tunduk pada Kebijakan Izin Pengguna Uni Eropa Google harus menunjukkan izin pengguna akhir. Permintaan tersebut diperlukan untuk menunjukkan bahwa izin telah dikumpulkan menggunakan salah satu cara berikut:
- TCFv2: Mencakup parameter
gdpr
dangdpr_consent
. Untuk mengetahui detailnya, lihat Dokumentasi TCF v2.0 IAB Authorized Buyers. process_consent
: pernyataan bahwa bidder telah memperoleh izin pengguna yang diperlukan.
Contoh
Contoh di bawah ini menggambarkan cara menggunakan layanan Pencocokan Cookie untuk mencapai tujuan tertentu. Perlu diperhatikan bahwa kecuali jika dinyatakan sebaliknya, pengguna yang ditindaklanjuti dianggap tidak berasal dari negara bagian AS dengan pembatasan privasi.
Mengisi tabel pencocokan yang dihosting bidder
Bidder dapat menggunakan alur kerja Pencocokan Cookie untuk mengisi tabel pencocokannya sendiri dengan hanya memberikan parameter google_nid
dan google_cm
di tag pencocokannya. Ini mungkin terlihat seperti:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
Jika URL Pencocokan Cookie bidder ditetapkan ke https://ad.network.com/pixel?id=1
,
dan operasi pencocokan cookie berhasil, pengalihan yang dikirim Google sebagai
respons terhadap tag pencocokan bidder mungkin terlihat seperti ini:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
Jika operasi pencocokan cookie gagal karena pengguna tidak memiliki cookie Google, responsnya adalah:
https://ad.network.com/pixel?id=1&google_error=3
Kode error bergantung pada penyebab utama error. Untuk mempelajari lebih lanjut kemungkinan kode error untuk alur kerja Pencocokan Cookie, lihat parameter URL pengalihan.
Tambahkan ke daftar pengguna tunggal
Parameter google_ula
dapat ditentukan dalam tag pencocokan bidder untuk menambahkan pengguna ke daftar pengguna dengan ID yang diberikan. Jika tabel pencocokan yang dihosting Google atau
yang dihosting bidder memiliki entri baru untuk pengguna, bidder dapat menempatkan
tag pencocokan termasuk parameter google_nid
dan google_ula
untuk menambahkan pengguna ke daftar yang ditentukan tanpa memulai alur kerja
Pencocokan Cookie lengkap. Lihat batasan
dalam memanggil Cookie Matching Service untuk mengetahui detail selengkapnya. Tag pencocokan
yang sesuai mungkin terlihat seperti:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Agar respons berhasil, jika URL Pencocokan Cookie bidder adalah
https://ad.network.com/pixel
, URL alihan Google akan menjadi:
https://ad.network.com/pixel?google_ula=12345,0
Jika terjadi error secara keseluruhan, misalnya tidak ada cookie Google untuk pengguna, URL alihan akan menyertakan parameter google_error
:
https://ad.network.com/pixel?google_error=3
Jika terjadi error secara khusus terkait penambahan pengguna ke daftar,
Anda akan menerima google_ula
dalam pengalihan. Tidak seperti parameter tag pencocokan yang sesuai, parameter ini mengganti stempel waktu dengan kode status untuk menunjukkan keberhasilan operasi. Misalnya, jika permintaan gagal
karena akun bidder tidak memiliki akses ke daftar pengguna yang ditentukan, URL
pengalihannya akan menjadi:
https://ad.network.com/pixel?google_ula=12345,2
Tambahkan ke beberapa daftar pengguna
Bidder dapat menentukan bahwa pengguna harus ditambahkan ke beberapa daftar pengguna dengan
menyertakan beberapa parameter google_ula
di tag pencocokan. Dalam
praktiknya, hal ini mungkin terlihat seperti:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
Status operasi untuk setiap daftar pengguna dilaporkan juga melalui
parameter google_ula
yang berbeda dalam pengalihan:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
Dalam pengalihan di atas, kita dapat melihat bahwa operasi berhasil untuk daftar pengguna dengan ID 45678
, tetapi gagal untuk ID daftar pengguna 12345
karena bidder tidak memiliki izin untuk mengaksesnya.
Telusuri alur kerja Pencocokan Cookie dan tambahkan ke daftar pengguna
Untuk menjalankan pencocokan cookie dan menambahkan pengguna ke daftar pengguna dalam satu permintaan, tag pencocokan bidder harus menyertakan google_cm
dan google_ula
:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />
URL alihan yang ditentukan oleh Google akan menyertakan google_gid
,
google_cver
, dan google_ula
. Hal ini mungkin terlihat seperti
berikut:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Menyimpan kecocokan di tabel pencocokan yang dihosting Google
Jika bidder ingin menyimpan data cookie-nya di tabel pencocokan yang dihosting Google,
dan tidak bermaksud menyimpan kecocokan dengan User-ID Google di tabel pencocokannya
sendiri, tag pencocokannya harus menyertakan parameter google_hm
dengan
nilainya harus berupa string berenkode base64 yang aman untuk web. Untuk pengguna yang
data cookie bidder yang tidak dienkode adalah Cookie number 1!
, nilai yang dienkode
adalah Q29va2llIG51bWJlciAxIQ==
, yang akan digunakan dalam
tag pencocokan seperti berikut:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Agar respons berhasil, jika URL Pencocokan Cookie bidder adalah
https://cookie-monster.com/pixel
, URL alihan Google akan
menjadi:
https://cookie-monster.com/pixel
Parameter google_gid
tidak ada dalam pengalihan karena tag yang cocok tidak menyertakan google_cm
, dan google_hm
tidak disertakan dalam respons yang berhasil. Dalam permintaan bid mendatang untuk tayangan
bagi pengguna ini, bidder akan menerima data pencocokan yang dihosting di
BidRequest.hosted_match_data
untuk protokol RTB Google, atau
BidRequest.user.buyeruid
untuk penerapan OpenRTB Google.
Jika bidder menggunakan tag pencocokan yang nilai
google_hm
tidak dienkode base64—seperti
chocolate_chunk!
—URL alihan mungkin terlihat seperti
berikut:
https://cookie-monster.com/pixel?google_hm=2
URL alihan di atas menyertakan nilai google_hm
2
, yang menunjukkan bahwa operasi gagal karena nilainya tidak dapat didekode.
Tabel pencocokan bidder dan yang dihosting Google dengan daftar pengguna
Jika bidder menghosting daftar penggunaannya sendiri selain daftar pengguna
yang dihosting Google, dan menginginkan satu tag pencocokan untuk mencocokkan kedua tabel dan menambahkan pengguna ke
daftar pengguna tertentu, tag pencocokannya harus menyertakan parameter google_cm
,
google_hm
, dan google_ula
. Jika data cookie bidder
adalah Cookie number 1!
, nilai yang dienkode adalah
Q29va2llIG51bWJlciAxIQ==
, yang akan menghasilkan tag pencocokan seperti
berikut:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
Jika respons berhasil, dengan URL Pencocokan Cookie bidder adalah
https://cookie-monster.com/pixel
, URL alihan Google akan terlihat seperti berikut:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
Saat menerima pengalihan, bidder dapat mencocokkan ID Pengguna Google yang ditentukan
di google_gid
dengan data cookie mereka di tabel pencocokan. Selain itu, mereka dapat menentukan bahwa tabel pencocokan yang dihosting Google dan operasi daftar pengguna telah berhasil. Akibatnya, setiap Pra-penargetan bidder
yang dikonfigurasi untuk menargetkan ID daftar pengguna yang ditentukan sekarang akan menyebabkan bidder
menerima permintaan bid untuk tayangan dari pengguna. Demikian pula, dalam permintaan
bid ini, bidder akan menerima data pencocokan yang dihosting di
BidRequest.hosted_match_data
untuk protokol RTB Google, atau
BidRequest.user.buyeruid
untuk penerapan OpenRTB Google.