Pencocokan Cookie adalah fitur yang memungkinkan Anda mencocokkan cookie Anda—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 yang mungkin dimiliki untuk kasus penggunaan tertentu.
Konsep
Apa yang dimaksud dengan Pencocokan Cookie?
Pemilik domain biasanya menetapkan konten cookie untuk pengguna yang menjelajahi situs mereka, yang digunakan untuk mengidentifikasi pengguna dalam domain tersebut. Meskipun dua pemilik domain akan setuju untuk menukar data ini, model keamanan browser internet membatasi salah satu pemilik domain 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 Bid Real-Time mungkin memiliki domain sendiri tempat mereka mengidentifikasi beberapa kumpulan pengguna yang ingin mereka tampilkan iklan. Pencocokan Cookie
memungkinkan bidder mencocokkan cookie mereka dengan cookie Google, sehingga mereka dapat
menentukan apakah tayangan iklan yang dikirim dalam permintaan bid terkait 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 ID Pengguna Google, serta memungkinkan pengisian daftar pengguna.
Tabel pencocokan
Tabel kecocokan dapat digunakan untuk memetakan ID atau data lain 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 tersebut, atau untuk mengisi tabel pencocokan yang dihosting oleh Google. Tabel pencocokan diperlukan agar aplikasi bidder bidder dapat mengakses data cookie untuk pengguna yang melihat tayangan iklan.
Tabel pencocokan yang dihosting Google
Untuk memudahkan pemeliharaan, peningkatan latensi, dan akses ke data pertandingan bagi pengguna di wilayah tertentu, sebaiknya Anda mengizinkan Google menghosting tabel pertandingan Anda. Dengan begitu, Anda dapat menentukan string berenkode base64 yang aman untuk web— selanjutnya disebut data pencocokan yang dihosting—yang akan dipetakan ke ID Pengguna Google untuk pengguna tertentu. Setelah kecocokan ditetapkan, kecocokan tersebut dapat digunakan dengan cara berikut:
Bidding Real-Time: Dalam permintaan bid berikutnya untuk tayangan iklan yang terkait dengan pengguna, Google akan mengirimkan data pencocokan yang dihosting yang Anda cocokkan dengan ID Pengguna Google mereka. Google akan menentukan
BidRequest.user.buyeruid
sebagai string berenkode base64 yang aman untuk web.Daftar Pengguna: Daftar pengguna dapat diisi dengan ID Pengguna Google atau data kecocokan yang dihosting.
- Pra-penargetan: Anda dapat mengonfigurasi pra-penargetan sehingga Anda hanya menerima permintaan bid yang berisi data pencocokan yang dihosting. Hal ini dapat digunakan untuk menghilangkan tayangan iklan 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 berikut, atau melalui Layanan Pengupload Massal.
Memulai
Untuk mulai menggunakan Pencocokan Cookie, Anda harus menghubungi Account Manager Teknis Anda, 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 urutan 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. Hal ini dapat ditayangkan bersama iklan, atau ditempatkan di properti web di luar iklan.
- URL Laporan Pencocokan Cookie (opsional): Dalam 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 Pencocokan Cookie: Untuk bursa yang menerapkan alur kerja Bantuan Pencocokan Cookie, ini adalah URL dasar endpoint yang dimaksudkan untuk merespons permintaan yang masuk.
- Kuota Bantuan Pencocokan Cookie: Untuk bursa yang menerapkan alur kerja Bantuan Pencocokan Cookie, ini adalah jumlah maksimum permintaan yang dapat diterima oleh URL Pencocokan Cookie mereka setiap detik. Tindakan 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 pengurutan yang tidak dijamin. Bidder dengan integrasi yang memerlukan pengurutan parameter yang konsisten dapat menempatkan makro di URL Pencocokan Cookie untuk menunjukkan penempatannya.
Makro yang didukung
Bidder dapat secara opsional 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 nilai yang diperluasnya 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 telah ditetapkan yang ditentukan bidder selain parameter Pencocokan Piksel
dalam urutan berikut: google_push
,
google_gid
, google_cver
, dan
google_error
. Bidder dapat melakukannya dengan menyetel
URL Pencocokan Cookie 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 kemudian mengirimkan permintaan kecocokan 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 mendukung tiga alur kerja berikut.
Diprakarsai bidder: Pencocokan Cookie Bidireksional
Pencocokan Cookie Bidireksional mengacu pada alur kerja yang dimulai bidder, yang menempatkan tag pencocokan di browser pengguna yang mengarahkannya ke Google. Alur kerja ini memungkinkan Google dan bidder mengisi tabel kecocokan. Berikut adalah contoh alur kerja ini.
Langkah 1: Tempatkan tag kecocokan
Untuk memulai alur ini, bidder harus menempatkan tag kecocokan mereka sehingga dirender di browser pengguna. Tag pencocokan 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 kecocokan untuk memenuhi berbagai kasus penggunaan. Untuk mempelajari parameter ini lebih lanjut, lihat Parameter URL Tag Pencocokan.
Langkah 2: Google merespons dengan pengalihan yang mencakup data kecocokan
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 pengalihan untuk tag pencocokan sebelumnya 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
yang dienkode base64 yang aman untuk web dan tidak diisi. Untuk bidder yang memilih untuk menghosting tabel kecocokan, sebaiknya mereka menyimpan string persis yang ditampilkan oleh Layanan Pencocokan Cookie. Dalam permintaan bid berikutnya, nilai ini akan sesuai dengan nilai yang ditentukan melalui
BidRequest.user.id
.
Versi yang ditentukan dalam google_cver
menunjukkan nomor versi
numerik untuk ID Pengguna Google. ID Pengguna Google untuk pengguna tertentu jarang berubah, setelah itu ID ini akan di-increment.
Jika Google mengalami error saat memproses permintaan kecocokan Anda, parameter
google_error
akan ditentukan.
Langkah 3: Proses bidder mengalihkan dan merespons dengan piksel
Bidder menerima pengalihan ke URL pencocokan cookie mereka, termasuk parameter yang mereka tentukan pada langkah pertama, dan parameter yang diberikan Google pada langkah kedua. Selain itu, mereka juga akan menerima cookie di header HTTP. Jika operasi berhasil, bidder yang menghosting tabel kecocokan sendiri dapat mencocokkan cookie mereka dengan ID Pengguna Google yang disertakan dalam respons. Sebaiknya bidder menyimpan string persis 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 dalam
deskripsi parameter URL
google_error
. Jika menerima error, Anda dapat mencoba mencocokkan pengguna tersebut lagi dengan menempatkan tag pencocokan baru.
Bidder harus selalu merespons dengan menayangkan gambar piksel tidak terlihat 1x1, atau
sebagai alternatif, menampilkan respons HTTP 204
No Content.
Diagram alur kerja Pencocokan Cookie
Alur kerja ini diilustrasikan oleh diagram berikut, dengan permintaan dan respons diwakili oleh panah, dan item data yang menyertainya dicantumkan dalam tanda kurung.

Parameter URL Tag Pencocokan
Parameter | Deskripsi |
---|---|
google_nid |
ID Jaringan (NID) untuk akun bidder. ID ini dapat diambil melalui resource Bidders. |
google_cm |
Menunjukkan kepada Layanan Pencocokan Cookie Google bahwa layanan tersebut harus melakukan pencocokan cookie. Nilai parameter diabaikan dan dapat dihapus. |
google_sc |
Parameter ini tidak digunakan lagi. Menetapkan cookie Google untuk pengguna jika cookie belum ada. Nilai parameter diabaikan dan dapat dihapus. Menghilangkan parameter akan menyebabkan error jika tidak ada cookie. |
google_no_sc |
Parameter ini tidak digunakan lagi. Hal ini menunjukkan kepada Layanan Pencocokan Cookie Google bahwa layanan tersebut tidak boleh menetapkan cookie untuk pengguna jika cookie tidak ada. Nilai parameter diabaikan dan dapat dihapus. |
google_hm |
Data yang ingin disimpan bidder dalam tabel pencocokan yang dihosting Google. Nilainya adalah string berenkode base64 yang aman untuk web (padding opsional). Data mentah harus berukuran 40 byte atau kurang. Misalnya |
google_redir |
String yang dienkode URL yang dapat ditentukan bidder jika mereka ingin mengarahkan
Google untuk mengirim pengalihan HTTP 302 ke URL yang dienkode untuk
tag kecocokan ini. Hal ini memungkinkan Google ditempatkan di depan dalam panggilan berantai ke partner. Hal ini akan menghasilkan error jika ditentukan tanpa
google_hm , atau dengan google_cm . |
google_ula |
String yang digunakan untuk menambahkan pengguna ke daftar pengguna yang ada. Format yang diharapkan untuk nilai adalah userlistid[,timestamp] :
Parameter URL ini dapat diulang untuk menambahkan pengguna ke beberapa daftar. |
gdpr |
Menunjukkan bahwa permintaan tunduk pada pembatasan GDPR terkait penggunaan data. Untuk mengetahui detail selengkapnya, lihat
Persyaratan izin pengguna Uni Eropa, atau Dampak pada kelayakan pencocokan cookie dalam
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, atau Bagaimana string TC akan diteruskan? di 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 tidak tunduk pada Kebijakan Izin Pengguna Uni Eropa, atau jika ada parameter izin lain yang tersedia dalam permintaan ( Contoh: |
Selain parameter sebelumnya, bidder dapat menentukan parameter mereka sendiri, yang
akan ditambahkan sebagai parameter ke URL pengalihan. 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 urutan
parameter tidak dijamin. Tag kecocokan yang menyertakan parameter
yang ditentukan bidder mungkin terlihat seperti:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
Mengalihkan Parameter URL
URL pengalihan 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. Ditetapkan jika google_cm ditentukan dalam permintaan dan permintaan berhasil. |
google_cver |
Versi cookie. Ditetapkan jika google_cm ditentukan dalam permintaan dan permintaan berhasil. |
google_error |
Nilai bilangan bulat yang menunjukkan error permintaan secara keseluruhan. Jika
diterima, berarti tidak ada operasi yang telah dilakukan, dan tidak ada parameter respons
|
google_hm |
Hanya muncul jika upaya penulisan ke tabel pertandingan 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
|
Contoh skenario alur kerja Pencocokan Cookie
Skenario berikut menjelaskan seperti apa pencocokan cookie bagi pengguna umum yang menjelajahi halaman web.
Skenario 1: Pengguna menghapus cookie dan menjelajahi situs
Jane menghapus cache semua cookie miliknya. Kemudian, mereka membuka 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 Jane.
- Tag pencocokan memanggil Layanan Pencocokan Cookie Google, yang menentukan parameter
google_nid
dangoogle_cm
. - Layanan Pencocokan Cookie membaca cookie Google Jane, dan mengirimkan pengalihan browser Jane ke URL Pencocokan Cookie FinestDSP dengan parameter
google_gid
dangoogle_cver
yang ditetapkan. - Browser Jane 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 Jane di
header HTTP. FinestDSP kini dapat menyimpan pemetaan cookie mereka ke
google_gid
dalam tabel kecocokan mereka. - FinestDSP merespons pengalihan dengan piksel 1x1 yang tidak terlihat.

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 pencocokan dilakukan.
- Halaman web dirender, sehingga Google (Ad Manager) meminta iklan yang akan dirender di halaman tersebut.
- Selama lelang iklan, Google mengirimkan permintaan bid kepada bidder yang berlaku, termasuk FinestDSP.
- FinestDSP menerima permintaan bid, termasuk sinyal seperti
google_gid
. - FinestDSP mencari
google_gid
di tabel kecocokannya, dan menemukan cookie yang terkait dengan Jane yang dibuat seminggu sebelumnya (dalam Skenario 1). - Berdasarkan informasi yang terkait dengan cookie, logika bidding FinestDSP mengajukan bid pada tayangan iklan, dan memenangkan lelang.
- Jane mungkin melihat iklan yang disesuaikan dengan minatnya, berdasarkan informasi yang dimiliki FinestDSP.
Diprakarsai bidder: Pencocokan Cookie Satu Arah
Pencocokan Cookie Satu Arah mirip dengan alur kerja Dua Arah,
kecuali diubah sedemikian rupa sehingga hanya Google yang menghosting dan mengisi tabel
pencocokan. Hal ini dapat digunakan dalam kasus saat bidder tidak diizinkan untuk menghosting ID Pengguna Google di tabel pencocokan mereka sendiri. Untuk menggunakan alur ini, bidder
harus mengizinkan Google menghosting tabel kecocokan, tidak dapat lagi menentukan
google_cm
dalam permintaan ke Layanan Pencocokan Cookie Google, dan
oleh karena itu tidak akan menerima google_gid
untuk mengisi tabel kecocokan
mereka sendiri. Setelah Google menemukan kecocokan untuk pengguna, bidder dapat menambahkan pengguna tersebut 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 alur kerja yang direvisi diringkas dalam langkah-langkah berikut.
Langkah 1: Tempatkan tag pencocokan yang diarahkan ke URL Pencocokan Cookie bidder
Untuk memulai alur ini, bidder harus menempatkan tag kecocokan sehingga dirender di browser pengguna. Tidak seperti alur kerja untuk pengguna yang tidak berasal dari negara bagian AS dengan batasan 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
, tampilannya akan seperti ini:
<img src="https://ad.network.com/pixel" />
Saat dimuat di browser pengguna, kode ini akan meminta piksel dari URL Pencocokan Cookie bidder. Permintaan ini akan berisi cookie mereka di header HTTP, yang harus diekstrak untuk langkah berikutnya.
Langkah 2: Lakukan pengalihan ke layanan Pencocokan Cookie Google
Endpoint pencocokan cookie bidder harus mengalihkan ke layanan Pencocokan Cookie Google, termasuk parameter google_hm
yang diisi dengan data cookie yang dienkode dalam base64 yang sesuai untuk web. URL pengalihan 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 pada pengalihan keberhasilan atau 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 menayangkan piksel transparan 1x1 secara default, dan alur kerja akan berakhir di sini.
Tayangan iklan untuk pengguna ini dalam permintaan bid berikutnya akan menyertakan data pencocokan yang dihosting bidder di BidRequest.user.buyeruid
. Bidder juga dapat mengisi daftar pengguna menggunakan data pencocokan yang dihosting yang mereka tentukan.
Jika tidak, jika terjadi error, Google akan mengirimkan pengalihan ke URL Pelaporan Pencocokan Cookie bidder dengan penyebab error yang ditentukan dalam parameter google_error
. Jika URL Laporan Pencocokan Cookie bidder
adalah https://ad.network.com/report
, URL pengalihan akan terlihat
seperti:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
Langkah 5: Browser pengguna dialihkan 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 dalam
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 batasan privasi
Alur kerja default untuk pengguna di negara bagian AS dengan batasan privasi diilustrasikan oleh diagram berikut, di mana permintaan dan respons diwakili oleh panah, dan item data yang menyertainya dicantumkan dalam tanda kurung.

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 Bidders. |
google_sc |
Parameter ini tidak digunakan lagi. Menetapkan cookie Google untuk pengguna jika cookie belum ada. Nilai parameter diabaikan dan dapat dihapus. Menghilangkan parameter akan menyebabkan error jika tidak ada cookie. |
google_no_sc |
Parameter ini tidak digunakan lagi. Hal ini menunjukkan kepada Layanan Pencocokan Cookie Google bahwa layanan tersebut tidak boleh menetapkan cookie untuk pengguna jika cookie tidak ada. Nilai parameter diabaikan dan dapat dihapus. |
google_hm |
Berisi data yang ingin disimpan bidder dalam tabel pencocokan yang dihosting Google. |
google_redir |
URL yang dienkode yang Anda inginkan agar Google mengirimkan 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 yang diharapkan untuk nilai adalah userlistid[,timestamp] :
Parameter URL ini dapat diulang untuk menambahkan pengguna ke beberapa daftar. |
gdpr |
Menunjukkan bahwa permintaan tunduk pada pembatasan GDPR terkait penggunaan data. Untuk mengetahui detail selengkapnya, lihat
Persyaratan izin pengguna Uni Eropa, atau Dampak pada kelayakan pencocokan cookie dalam
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, atau Bagaimana string TC akan diteruskan? di 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 tidak tunduk pada Kebijakan Izin Pengguna Uni Eropa, atau jika ada parameter izin lain yang tersedia dalam permintaan ( Contoh: |
Parameter URL untuk pengalihan Google ke URL Laporan Pencocokan Cookie Bidder
Parameter | Deskripsi |
---|---|
google_error |
Nilai bilangan bulat yang menunjukkan error permintaan secara keseluruhan. Jika
diterima, berarti tidak ada operasi yang telah dilakukan, dan tidak ada parameter respons
|
Diprakarsai Google: Pencocokan Piksel Dua Arah
Pencocokan Pixel Bidireksional adalah alur kerja untuk Layanan Pencocokan Cookie Google, tempat Google mencoba mencocokkan ID Pengguna Google dengan bidder yang dipilih secara algoritma 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 kecocokan dengan pengguna tertentu. Berikut adalah contoh alur kerja ini.
Langkah 1: Google menempatkan tag kecocokan
Saat halaman penerbit yang berpartisipasi dimuat di browser pengguna, dan slot iklan di halaman tersebut diisi oleh Google, tag kecocokan dapat ditempatkan yang meminta piksel dari bidder yang dipilih secara algoritma. Tag Pencocokan Piksel yang ditempatkan oleh Google menggabungkan URL Pencocokan Cookie bidder dengan parameter tambahan yang dapat digunakan bidder untuk mengisi tabel pencocokan mereka. Untuk URL Pencocokan Cookie
yang ditentukan sebagai https://ad.network.com/pixel
, URL tersebut disusun 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 pengalihan 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 pengalihan sebelumnya 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. Mirip dengan alur kerja yang dimulai bidder, parameter tambahan dapat ditentukan untuk memenuhi kasus penggunaan tambahan.
Langkah 3: Google memproses pengalihan dan merespons dengan piksel
Google mencatat bahwa kecocokan telah dibuat untuk pengguna, dan menangani operasi tambahan yang diminta melalui parameter kueri. Terakhir, Google merespons dengan piksel transparan 1x1.
Diagram alur kerja Pencocokan Piksel
Alur kerja ini diilustrasikan oleh diagram berikut, dengan permintaan dan respons diwakili oleh panah, dan item data yang menyertainya dicantumkan dalam tanda kurung.

Parameter permintaan tag pencocokan Google
Parameter | Deskripsi |
---|---|
google_gid |
ID Pengguna Google. Untuk pengguna yang tidak berasal dari negara bagian AS dengan batasan privasi, nilai ini akan selalu ditentukan dalam tag kecocokan Google. |
google_cver |
Versi cookie. Hal ini akan selalu ditentukan dalam tag pencocokan Google. |
google_push |
Menunjukkan bahwa permintaan ini memulai alur kerja Pencocokan Piksel. Nilai harus ditampilkan melalui parameter yang sesuai dalam respons pengalihan bidder. |
gdpr_consent |
String TC yang mewakili izin pengguna akhir. Untuk mengetahui detail selengkapnya, lihat [Persyaratan izin pengguna Uni Eropa](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements), atau **Bagaimana string TC akan diteruskan?** di [Dokumentasi TCF v2.0 IAB Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378). |
Parameter pengalihan Pencocokan Piksel Bidder
Parameter | Deskripsi |
---|---|
google_nid |
ID Jaringan (NID) untuk akun bidder. ID ini dapat diambil melalui resource Bidders. |
google_push |
Menunjukkan bahwa pengalihan ini menyelesaikan alur kerja Pencocokan Piksel. Nilai dari tag kecocokan Google yang sesuai harus ditentukan di sini. |
google_hm |
Berisi data yang ingin disimpan bidder dalam tabel pencocokan yang dihosting Google. |
google_ula |
String yang digunakan untuk menambahkan pengguna ke daftar pengguna yang ada. Format yang diharapkan untuk nilai adalah userlistid[,timestamp] :
Parameter URL ini dapat diulang untuk menambahkan pengguna ke beberapa daftar. |
gdpr_consent |
String TC yang mewakili izin pengguna akhir. Untuk mengetahui detail selengkapnya, lihat [Persyaratan izin pengguna Uni Eropa](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements), atau **Bagaimana string TC akan diteruskan?** di [Dokumentasi TCF v2.0 IAB Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378). |
Diprakarsai Google: Pencocokan Piksel Satu Arah
Pencocokan Piksel Satu Arah berbeda dari alur kerja Dua Arah karena tag pencocokan Google tidak menyertakan parameter yang menentukan ID Pengguna Google, tetapi akan terus mengisi tabel pencocokan yang dihosting Google. Hal ini dapat digunakan dalam kasus saat bidder tidak diizinkan untuk menghosting ID Pengguna Google di tabel pencocokan mereka sendiri. Contoh alur kerja yang direvisi diringkas dalam langkah-langkah berikut.
Langkah 1: Google menempatkan tag kecocokan
Google menempatkan tag kecocokan untuk bidder yang dipilih secara algoritma. Tag kecocokan 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 Cookie bidder
Browser pengguna meminta piksel dari URL Pencocokan Cookie bidder, termasuk cookie bidder di header HTTP.
Langkah 3: Lakukan pengalihan ke Layanan Pencocokan Cookie Google
Endpoint pencocokan cookie bidder harus mengalihkan ke layanan Pencocokan Cookie Google, termasuk parameter google_hm
yang diisi dengan data cookie yang dienkode dalam base64 yang sesuai untuk web. URL pengalihan 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 iklan untuk pengguna ini dalam permintaan bid berikutnya akan menyertakan data pencocokan yang dihosting bidder di BidRequest.user.buyeruid
.
Bidder juga dapat mengisi daftar pengguna menggunakan data pencocokan yang dihosting yang mereka tentukan.
Terakhir, Google menampilkan piksel transparan 1x1 ke browser pengguna.
Bantuan Pencocokan Cookie
Bidding Terbuka memungkinkan bursa menggunakan alur kerja pencocokan cookie yang diprakarsai bidder dan diprakarsai Google, untuk mencocokkan ID Pengguna Google dengan cookie mereka. Bantuan Pencocokan Cookie (CMA) adalah fitur tambahan untuk bursa yang memungkinkan bursa membuat tabel pencocokan dengan bidder mereka sendiri.
Cara kerja Bantuan Pencocokan Cookie
Saat menempatkan iklan, algoritma Google secara algoritmik memilih bursa yang berpartisipasi 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 Ad Exchange menerima permintaan piksel.
- Endpoint Pencocokan Cookie Ad Exchange menerima permintaan, dengan layanan pencocokan cookie-nya sendiri bertanggung jawab untuk mencocokkan ID pengguna dengan salah satu bidder-nya. Dalam diagram berikut, layanan pencocokan cookie Exchange merespons browser pengguna dengan pengalihan ke salah satu endpoint bidder-nya.
- Bidder menerima permintaan, beserta parameter apa pun yang ditentukan oleh exchange untuk mencocokkan ID pengguna dengan cookie-nya.

Pembatasan
Membatasi frekuensi permintaan untuk pertandingan baru
Bidder bertanggung jawab untuk membatasi jumlah panggilan ke layanan Pencocokan Cookie bagi pengguna yang memiliki entri baru dalam tabel pencocokan yang dihosting Google. Entri dalam tabel pertandingan yang dihosting dapat dianggap telah berakhir masa berlakunya dalam 14 hari, setelah itu entri dapat diperbarui.
Merespons semua permintaan pencocokan piksel
Bidder yang menggunakan alur kerja Pencocokan Piksel diharapkan merespons semua permintaan Pencocokan Piksel yang masuk dengan respons yang menyertakan parameter google_push
. Hal ini memungkinkan Google menerapkan kebijakan dengan memantau penggunaan. Jika rasio respons bidder kurang dari 90%, Google akan membatasi jumlah permintaan Pixel Match yang dikirim ke akunnya.
Menggunakan endpoint HTTPS
Endpoint yang digunakan dalam semua alur kerja Pencocokan Cookie harus menggunakan HTTPS.
Saat merespons permintaan Pixel Match yang dikirimkan kepada Anda melalui HTTPS, Anda diwajibkan untuk 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 daripada sekali setiap 2 menit, jumlah permintaan kecocokan 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 harus menunjukkan bahwa izin telah dikumpulkan menggunakan salah satu cara berikut:
- TCFv2: Ini mencakup parameter
gdpr
dangdpr_consent
. Untuk mengetahui detailnya, lihat dokumentasi TCF v2.0 IAB Authorized Buyers. process_consent
: pernyataan bahwa bidder telah mendapatkan izin pengguna yang diperlukan.
Contoh
Contoh berikut mengilustrasikan cara menggunakan layanan Pencocokan Cookie untuk mencapai tujuan tertentu. Perhatikan bahwa kecuali dinyatakan lain, diasumsikan bahwa pengguna yang dikenai tindakan tidak berasal dari negara bagian AS dengan batasan privasi.
Mengisi tabel pencocokan yang dihosting bidder
Bidder dapat menggunakan alur kerja Pencocokan Cookie untuk mengisi tabel pencocokan mereka sendiri dengan hanya memberikan parameter google_nid
dan google_cm
dalam tag pencocokan mereka. 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:
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 error yang mendasarinya. 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 di tag pencocokan bidder untuk menambahkan pengguna ke daftar pengguna dengan ID yang diberikan. Jika tabel kecocokan yang dihosting Google atau bidder memiliki entri baru untuk pengguna, bidder dapat menempatkan tag kecocokan yang menyertakan parameter google_nid
dan google_ula
untuk menambahkan pengguna ke daftar yang ditentukan tanpa memulai alur kerja Pencocokan Cookie lengkap. Lihat pembatasan
pada pemanggilan Layanan Pencocokan Cookie untuk mengetahui detail selengkapnya. Tag kecocokan
yang sesuai mungkin terlihat seperti:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Untuk respons yang berhasil, dengan URL Pencocokan Cookie bidder adalah
https://ad.network.com/pixel
, URL pengalihan Google adalah:
https://ad.network.com/pixel?google_ula=12345,0
Jika terjadi error secara keseluruhan—misalnya, tidak ada cookie Google untuk pengguna—URL pengalihan akan menyertakan parameter
google_error
:
https://ad.network.com/pixel?google_error=3
Jika ada error khusus terkait penambahan pengguna ke daftar,
Anda akan menerima google_ula
dalam pengalihan. Tidak seperti parameter tag kecocokan yang sesuai, parameter ini menggantikan 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 pengalihan akan menjadi:
https://ad.network.com/pixel?google_ula=12345,2
Menambahkan ke beberapa daftar pengguna
Bidder dapat menentukan bahwa pengguna harus ditambahkan ke beberapa daftar pengguna dengan
menyertakan beberapa parameter google_ula
dalam tag kecocokan. 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 dengan cara yang sama melalui
parameter google_ula
yang berbeda dalam pengalihan:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
Dalam pengalihan sebelumnya, 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.
Menjalankan alur kerja Pencocokan Cookie dan menambahkan ke daftar pengguna
Untuk melakukan 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 pengalihan yang ditentukan oleh Google akan mencakup google_gid
,
google_cver
, dan google_ula
. Tampilannya mungkin seperti
berikut:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Menyimpan kecocokan dalam tabel kecocokan yang dihosting Google
Jika bidder ingin menyimpan data cookie mereka dalam tabel kecocokan yang dihosting Google, dan tidak bermaksud menyimpan kecocokan dengan ID Pengguna Google dalam tabel kecocokan mereka sendiri, tag kecocokan mereka harus menyertakan parameter google_hm
yang 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 kecocokan seperti berikut:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Untuk respons yang berhasil, dengan URL Pencocokan Cookie bidder adalah
https://cookie-monster.com/pixel
, URL pengalihan Google adalah:
https://cookie-monster.com/pixel
Parameter google_gid
tidak ada dalam pengalihan karena tag kecocokan tidak menyertakan google_cm
, dan google_hm
tidak disertakan dalam respons yang berhasil. Dalam permintaan bid mendatang untuk tayangan iklan
bagi pengguna ini, bidder akan menerima data pencocokan yang dihosting di
BidRequest.user.buyeruid
.
Jika bidder menggunakan tag pencocokan dengan nilai
google_hm
yang tidak dienkode base64—seperti
chocolate_chunk!
—URL pengalihan mungkin terlihat seperti
berikut:
https://cookie-monster.com/pixel?google_hm=2
URL pengalihan sebelumnya menyertakan nilai google_hm
2
, yang menunjukkan bahwa operasi gagal karena nilai tidak dapat
didekode.
Tabel kecocokan yang dihosting Google dan bidder dengan daftar pengguna
Jika bidder menghosting daftar pengguna mereka sendiri selain daftar pengguna yang dihosting Google, dan menginginkan satu tag kecocokan untuk mencocokkan kedua tabel dan menambahkan pengguna ke daftar pengguna tertentu, tag kecocokan mereka 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" />
Untuk respons yang berhasil, dengan URL Pencocokan Cookie bidder adalah
https://cookie-monster.com/pixel
, URL pengalihan Google akan
terlihat seperti berikut:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
Setelah menerima pengalihan, bidder dapat mencocokkan ID Pengguna Google yang ditentukan
di google_gid
dengan data cookie mereka di tabel pencocokan mereka. Selain itu, mereka dapat menentukan bahwa operasi daftar pengguna dan tabel kecocokan yang dihosting Google berhasil. Akibatnya, setiap Penargetan awal yang dikonfigurasi bidder untuk menargetkan ID daftar pengguna tertentu kini akan menyebabkan bidder menerima permintaan bid untuk tayangan dari pengguna tersebut. Demikian pula, dalam permintaan bid ini, bidder akan menerima data kecocokan yang dihosting di
BidRequest.user.buyeruid
.