Pencocokan Cookie adalah fitur yang memungkinkan Anda mencocokkan cookie—misalnya, ID untuk pengguna yang menjelajahi situs Anda—dengan ID Pengguna Google khusus bidder yang sesuai, 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 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 setuju untuk bertukar data ini, model keamanan browser internet membatasi salah 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 mereka 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 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 pengelolaan pengaitan antara cookie bidder dan ID Pengguna Google, serta memungkinkan pengisian 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 bidder dapat mengakses data cookie untuk pengguna yang melihat tayangan.
Tabel pencocokan yang dihosting Google
Untuk memudahkan pemeliharaan, peningkatan latensi, dan akses ke data pencocokan bagi pengguna di wilayah tertentu, sebaiknya Anda mengizinkan Google menghosting tabel pencocokan. Hal ini memungkinkan Anda menentukan string berenkode base64 yang aman untuk web— selanjutnya disebut sebagai data kecocokan yang dihosting—yang akan dipetakan ke ID Pengguna Google untuk pengguna tertentu. Setelah dibuat, kecocokan dapat digunakan dengan cara berikut:
Bidding Real-Time: Dalam permintaan bid berikutnya untuk tayangan iklan yang terkait dengan pengguna, Google akan mengirimkan data kecocokan yang dihosting yang Anda cocokkan dengan ID Pengguna Google-nya. Dalam penerapan OpenRTB Google,
BidRequest.user.buyeruid
akan menentukannya sebagai string berenkode base64 yang aman bagi web. Jika endpoint bidding Anda dikonfigurasi untuk menggunakan protokol Google RTB yang tidak digunakan lagi, Anda akan menerima protokol ini sebagai byte yang didekode melalui kolomBidRequest.hosted_match_data
.Daftar Pengguna: Daftar pengguna dapat diisi dengan ID Pengguna Google atau data pencocokan yang dihosting.
- Pra-penargetan: Anda dapat mengonfigurasi pra-penargetan sehingga hanya menerima permintaan bid yang berisi data pencocokan yang dihosting. Hal 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 API Bidding Real-Time. Setelah dibuat, Anda dapat mengisi daftar ini dengan alur kerja Pencocokan Cookie yang dijelaskan di bawah, atau melalui Layanan Uploader Massal.
Memulai
Untuk memulai Pencocokan Cookie, Anda harus menghubungi Technical Account Manager, yang dapat mengaktifkan alur kerja tertentu dan membantu Anda mengonfigurasi hal berikut:
- ID Jaringan (NID) Pencocokan Cookie: 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 ini dalam alur kerja Pencocokan Cookie.
- Tag Pencocokan: Tag yang harus Anda tempatkan di browser pengguna untuk alur kerja Pencocokan Cookie yang dimulai oleh bidder. Iklan 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 Cookie Match Assist: Untuk bursa yang menerapkan alur kerja Cookie Match Assist, ini adalah URL dasar endpoint yang dimaksudkan untuk merespons permintaan yang masuk.
- Kuota Cookie Match Assist: Untuk bursa yang menerapkan alur kerja Bantuan Cookie Match, 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
Di salah satu alur kerja Pencocokan Cookie yang didukung, URL Pencocokan Cookie bidder biasanya memiliki parameter yang ditambahkan dalam urutan yang tidak dijamin. Bidder dengan integrasi yang memerlukan pengurutan parameter yang konsisten dapat menempatkan makro di URL Pencocokan Cookie untuk menjamin penempatannya.
Makro yang didukung
Bidder dapat mengonfigurasi URL Pencocokan Cookie secara opsional 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 bawaan yang ditentukan bidder selain parameter Pencocokan Piksel
dalam urutan berikut: google_push
,
google_gid
, google_cver
, dan
google_error
. Bidder dapat melakukannya dengan menetapkan
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 kemudian Google 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 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, tempat mereka menempatkan tag pencocokan di browser pengguna yang mengarahkannya ke Google. Alur kerja ini memungkinkan Google dan bidder mengisi tabel pencocokan. Di bawah ini adalah contoh sederhana dari alur kerja ini.
Langkah 1: Tempatkan tag kecocokan
Untuk memulai alur ini, bidder harus menempatkan tag pencocokannya sedemikian rupa sehingga dapat dirender di browser pengguna. Tag pencocokan sederhana yang hanya menampilkan ID Pengguna Google ke 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 kasus penggunaan yang berbeda. Untuk mempelajari parameter ini lebih lanjut, lihat Mencocokkan Parameter URL Tag.
Langkah 2: Google merespons dengan pengalihan, termasuk 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 User-ID Google dan nomor versinya di URL, dan bidder juga akan menerima cookie mereka yang disertakan di header permintaan. Dalam prakteknya, 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 bagi web dan tidak ditambahkan padding. Untuk bidder yang memilih menghosting tabel pencocokan, 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
di OpenRTB, atau
BidRequest.google_user_id
dalam protokol Google RTB
yang tidak digunakan lagi.
Versi yang ditentukan di google_cver
menunjukkan nomor versi
angka untuk ID Pengguna Google. ID Pengguna Google untuk pengguna tertentu tidak akan sering berubah, lalu ID ini akan bertambah.
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 di langkah pertama, dan parameter yang disediakan Google di langkah kedua. Selain itu, mereka juga akan menerima cookie mereka di header HTTP. Jika operasi berhasil, bidder yang menghosting tabel pencocokan mereka sendiri dapat mencocokkan cookie mereka dengan ID Pengguna Google yang disertakan dalam respons. Sebaiknya pembeli 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 status error
yang berbeda yang mengidentifikasi error tertentu yang terjadi. Anda dapat mempelajari
lebih lanjut kemungkinan nilai error di sini.
Jika menerima error, Anda dapat mencoba mencocokkan kembali pengguna tersebut dengan
menempatkan tag pencocokan baru.
Bidder harus selalu merespons dengan menayangkan gambar piksel tak terlihat 1x1, atau
sebagai alternatif, menampilkan respons Tidak Ada Konten HTTP 204
.
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 tercantum dalam tanda kurung.
Mencocokkan Parameter URL Tag
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 harus melakukan pencocokan cookie. Nilai parameter diabaikan dan dapat dihilangkan. |
google_sc |
Parameter ini tidak digunakan lagi. Menetapkan cookie Google untuk pengguna jika cookie tidak ada. Nilai parameter diabaikan dan dapat dihilangkan. Menghapus 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 cookie tidak boleh ditetapkan untuk pengguna jika cookie tidak ada. Nilai parameter diabaikan dan dapat dihilangkan. |
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 ke URL dan dapat ditentukan oleh bidder jika mereka ingin mengarahkan
Google untuk mengirim pengalihan HTTP 302 ke URL yang dienkode untuk
tag pencocokan ini. Hal ini memungkinkan Google ditempatkan di bagian 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 detail selengkapnya, lihat
Persyaratan izin pengguna Uni Eropa di bawah, atau Dampak pada kelayakan pencocokan
cookie dalam
dokumentasi IAB TCF v2.0 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 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 parameternya sendiri, yang
akan ditambahkan sebagai parameter ke URL alihan. Perhatikan bahwa parameter yang ditentukan
pembeli yang diberi nama dengan awalan google_
akan diabaikan karena
parameter tersebut dicadangkan oleh Google untuk pengembangan di masa mendatang, dan pelestarian
urutan parameter tidak dijamin. Tag pencocokan yang mencakup parameter yang ditentukan bidder dapat terlihat seperti ini:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
Parameter URL Alihan
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 bilangan bulat yang menunjukkan error permintaan secara keseluruhan. Saat
diterima, status ini menunjukkan bahwa tidak ada operasi yang telah dilakukan, dan tidak ada parameter respons
|
google_hm |
Hanya muncul jika upaya menulis ke tabel kecocokan 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 untuk pengguna umum yang menjelajahi halaman web.
Skenario 1: Pengguna menghapus cookie dan menjelajahi situs
Jani menghapus cache semua cookie. Kemudian, 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 lainnya melalui layanan Bidding Real-Time.
- Aplikasi bidder FinestDSP menerima dan memproses permintaan bid, serta mengirim 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 mengirim pengalihan ke URL Pencocokan Cookie FinestDSP dengan parameter
google_gid
dangoogle_cver
yang ditetapkan ke browser Jane. - 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 mereka untuk Jenar di header HTTP. FinestDSP kini dapat menyimpan pemetaan cookie mereka ke
google_gid
di tabel kecocokan. - 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 kerja pencocokan.
- Halaman web dirender, sehingga 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_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 menempatkan bid pada tayangan iklan, dan memenangkan lelang.
- Jane mungkin melihat iklan yang disesuaikan dengan minatnya, berdasarkan informasi yang dimiliki FinestDSP.
Dimulai oleh bidder: Pencocokan Cookie Satu Arah
Pencocokan Cookie Searah mirip dengan alur kerja Dua Arah,
kecuali jika diubah sedemikian rupa sehingga hanya Google yang menghosting dan mengisi tabel
kecocokan. Hal ini dapat digunakan jika bidder tidak diizinkan untuk menghosting
ID Pengguna Google di tabel pencocokan mereka 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
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 User-ID Google, tetapi menyertakan data pencocokan yang dihosting. Contoh sederhana alur kerja yang direvisi diringkas 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 sehingga
dirender di browser pengguna. Tidak seperti alur kerja untuk pengguna yang bukan 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
, tampilannya akan seperti ini:
<img src="https://ad.network.com/pixel" />
Saat dimuat di browser pengguna, browser akan meminta piksel dari URL Pencocokan Cookie pembeli. Permintaan ini akan berisi cookie mereka di header HTTP, yang harus diekstrak untuk langkah berikutnya.
Langkah 2: Alihkan 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 base64 dan 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 pada pengalihan berhasil atau error jika URL laporan ditentukan
Jika operasi pencocokan cookie berhasil—atau jika tidak ada URL Laporan Pencocokan Cookie yang telah ditentukan untuk akun bidder—Google akan menayangkan piksel transparan 1x1 secara default, dan alur kerja akan berakhir di sini.
Tayangan untuk pengguna ini dalam permintaan bid berikutnya akan menyertakan data pencocokan
yang dihosting bidder di BidRequest.user.buyeruid
untuk OpenRTB, atau
BidRequest.hosted_match_data
untuk Protokol Google RTB
yang tidak digunakan lagi. Bidder juga dapat mengisi daftar pengguna menggunakan data pencocokan yang dihosting
yang mereka tentukan.
Jika tidak, jika terjadi error, Google akan mengirim pengalihan ke URL Laporan Pencocokan Cookie
pembeli dengan penyebab error yang ditentukan dalam
parameter google_error
. Jika URL Laporan Pencocokan Cookie
pembeli adalah https://ad.network.com/report
, URL alihan akan terlihat
seperti:
<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 batasan privasi
Alur kerja default untuk pengguna di negara bagian Amerika Serikat dengan batasan privasi diilustrasikan oleh diagram di bawah, dengan permintaan dan respons diwakili oleh panah, dan item data yang menyertainya tercantum dalam tanda kurung.
Parameter URL untuk bidder yang dialihkan 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 tidak ada. Nilai parameter diabaikan dan dapat dihilangkan. Menghapus 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 cookie tidak boleh ditetapkan untuk pengguna jika cookie tidak ada. Nilai parameter diabaikan dan dapat dihilangkan. |
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 di bawah, 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 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 tidak tunduk pada Kebijakan Izin Pengguna Uni Eropa, atau jika ada parameter izin lain yang tersedia di 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. Saat
diterima, status ini menunjukkan bahwa tidak ada operasi yang telah dilakukan, dan tidak ada parameter respons
|
Dimulai oleh 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 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. Hal ini akan memungkinkan Google dan bidder mengisi tabel pencocokan dengan pengguna tertentu. Berikut adalah contoh sederhana alur kerja ini.
Langkah 1: Google menempatkan tag pencocokan
Saat halaman penerbit 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 algoritma. Tag Pencocokan Piksel
yang ditempatkan oleh Google menggabungkan URL Pencocokan Cookie bidder dengan
parameter tambahan yang
dapat digunakan bidder untuk mengisi tabel pencocokannya. Untuk URL Pencocokan Cookie yang ditentukan sebagai https://ad.network.com/pixel
, URL tersebut akan 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 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. Selain itu, mirip dengan alur kerja yang dimulai
pembeli, 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 di bawah, dengan permintaan dan respons direpresentasikan oleh tanda 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 bukan berasal dari negara bagian AS dengan pembatasan privasi, hal ini akan selalu ditentukan di tag pencocokan Google. |
google_cver |
Versi cookie. Nama 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. |
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) di bawah, atau **Bagaimana string TC akan diteruskan?** di [dokumentasi IAB TCF v2.0 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 Pixel. 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) di bawah, atau **Bagaimana string TC akan diteruskan?** di [dokumentasi TCF v2.0 IAB Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378). |
Dimulai Google: Pencocokan Piksel Satu Arah
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. Ini dapat digunakan jika bidder tidak diizinkan untuk menghosting ID Pengguna Google di tabel pencocokannya sendiri. Contoh sederhana alur kerja yang direvisi diringkas dalam langkah-langkah di bawah.
Langkah 1: Google menempatkan tag kecocokan
Google menempatkan tag kecocokan untuk bidder yang dipilih secara algoritme. 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 Memasak 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 bagi web milik mereka. 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.user.buyeruid
untuk
OpenRTB, atau BidRequest.hosted_match_data
untuk Protokol
RTB Google yang tidak digunakan lagi. Bidder juga dapat mengisi daftar pengguna menggunakan data pencocokan yang dihosting
yang mereka tentukan.
Terakhir, Google menampilkan piksel transparan 1x1 ke browser pengguna.
Cookie Match Assist
Bidding Terbuka memungkinkan bursa menggunakan alur kerja pencocokan cookie yang dimulai bidder dan dimulai 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 Cookie Match Assist
Saat menempatkan iklan, Google akan memilih bursa yang berpartisipasi secara algoritmis dan menempatkan tag Cookie Match Assist 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, dengan layanan pencocokan cookie-nya sendiri bertanggung jawab untuk mencocokkan ID pengguna dengan salah satu bidder-nya. Dalam diagram di bawah, layanan pencocokan cookie bursa merespons browser pengguna dengan pengalihan ke salah satu endpoint bidder-nya.
- Bidder menerima permintaan, beserta parameter apa pun yang ditentukan oleh bursa untuk mencocokkan ID pengguna dengan cookie-nya.
Pembatasan
Membatasi frekuensi permintaan untuk kecocokan baru
Bidder bertanggung jawab membatasi jumlah panggilan ke layanan Pencocokan Cookie bagi pengguna yang memiliki entri baru dalam tabel pencocokan yang dihosting Google. Entri dalam tabel kecocokan yang dihosting dapat dianggap 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 turun di bawah 90%, Google akan membatasi jumlah
permintaan Pixel Match yang dikirim ke akun mereka.
Menggunakan endpoint HTTPS
Endpoint yang digunakan di semua alur kerja Pencocokan Cookie harus menggunakan HTTPS.
Saat merespons permintaan Pixel Match yang dikirimkan kepada Anda melalui HTTPS, Anda harus mengalihkan ke Layanan Pencocokan Cookie melalui HTTPS. Demikian pula, endpoint Cookie Match Assist yang mengalihkan ke bidder juga harus menggunakan HTTPS. Jika Anda mengirim permintaan ke Google melalui HTTP lebih 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: Ini mencakup parameter
gdpr
dangdpr_consent
. Untuk mengetahui detailnya, lihat dokumentasi IAB TCF v2.0 Authorized Buyers. process_consent
: pernyataan bahwa bidder telah mendapatkan izin pengguna yang diperlukan.
Contoh
Contoh di bawah ini mengilustrasikan cara menggunakan layanan Pencocokan Cookie untuk mencapai tujuan tertentu. Perhatikan bahwa kecuali jika dinyatakan sebaliknya, dianggap bahwa pengguna yang ditindaklanjuti tidak berasal dari negara bagian Amerika Serikat dengan pembatasan 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
di 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 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 error yang mendasarinya. Untuk mempelajari lebih lanjut kemungkinan kode error untuk alur kerja Pencocokan Cookie, lihat parameter URL alihan.
Menambahkan ke daftar satu pengguna
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
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
saat memanggil Layanan Pencocokan Cookie untuk mengetahui detail selengkapnya. Tag pencocokan yang sesuai dapat terlihat seperti ini:
<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 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 ada error khusus terkait penambahan pengguna ke daftar,
Anda akan menerima google_ula
dalam pengalihan. Tidak seperti
parameter tag kecocokan 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 alihan 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 pencocokan. Dalam prakteknya, tampilannya mungkin seperti ini:
<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
Pada 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.
Ikuti alur kerja Pencocokan Cookie dan tambahkan 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 alihan 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 di tabel kecocokan yang dihosting Google
Jika bidder ingin menyimpan data cookie mereka di tabel pencocokan yang dihosting Google, dan tidak bermaksud menyimpan pencocokan dengan User-ID Google di tabel pencocokannya sendiri, tag pencocokannya harus menyertakan parameter google_hm
dengan nilainya harus berupa string berenkode base64 yang aman bagi web. Untuk pengguna dengan
data cookie yang tidak dienkode dari bidder adalah Cookie number 1!
, nilai
yang dienkode akan menjadi 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" />
Untuk respons yang berhasil, dengan 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 di pengalihan karena tag pencocokan 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 kecocokan yang dihosting di
BidRequest.user.buyeruid
untuk OpenRTB, atau
BidRequest.hosted_match_data
untuk protokol Google RTB
yang tidak digunakan lagi.
Jika bidder menggunakan tag pencocokan dengan nilai
google_hm
yang tidak dienkode base64—seperti
chocolate_chunk!
—URL alihan mungkin terlihat seperti
berikut:
https://cookie-monster.com/pixel?google_hm=2
URL pengalihan di atas menyertakan nilai google_hm
sebesar
2
, yang menunjukkan bahwa operasi gagal karena nilai tersebut
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 ingin satu tag pencocokan 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
pembeli adalah Cookie number 1!
, nilai yang dienkode akan menjadi
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 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 operasi daftar pengguna dan tabel pencocokan yang dihosting Google berhasil. Akibatnya, setiap Pra-penargetan yang dikonfigurasi untuk bidder
yang dikonfigurasi untuk menargetkan ID daftar pengguna yang ditentukan kini 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.user.buyeruid
untuk OpenRTB, atau
BidRequest.hosted_match_data
untuk protokol Google RTB
yang tidak digunakan lagi.