Pencocokan Cookie adalah fitur yang memungkinkan Anda mencocokkan cookie—untuk contoh, ID untuk pengguna yang menjelajahi situs Anda—dengan ID Pengguna Google khusus bidder, dan membuat daftar pengguna yang dapat membantu Anda pilihan bidding yang lebih efektif. Panduan ini menjelaskan konsep yang digunakan dalam Cookie Pencocokan, serta berbagai alur kerja Pencocokan Cookie, dan variasinya yang mungkin mereka miliki untuk kasus penggunaan tertentu.
Konsep
Apa itu Pencocokan Cookie?
Pemilik domain biasanya menetapkan konten cookie untuk pengguna yang menjelajah di situs mereka, yang digunakan untuk mengidentifikasi pengguna dalam domain tersebut. Meskipun dua pemilik domain akan setuju untuk bertukar data ini, model keamanan browser internet membatasi seseorang agar tidak membaca cookie yang ditetapkan oleh {i>Directory<i}
Dalam konteks iklan digital, Google mengidentifikasi pengguna dengan cookie
yang merupakan bagian dari domain doubleclick.net
, dan bidder
yang berpartisipasi dalam Bidding Real-Time mungkin memiliki domain sendiri tempat mereka
mengidentifikasi sejumlah pengguna yang diinginkan untuk menampilkan iklan. Pencocokan Cookie
memungkinkan bidder mencocokkan cookie mereka dengan milik Google, sehingga mereka dapat
menentukan apakah tayangan yang dikirim dalam permintaan bid dikaitkan dengan salah satu
menjadi target, mereka akan menerima data cookie mereka sendiri atau
ID Pengguna Google khusus bidder yang merupakan bentuk terenkripsi
doubleclick.net
dalam permintaan bid.
Layanan pencocokan cookie yang dijelaskan dalam panduan ini memfasilitasi pembuatan dan pemeliharaan pengaitan antara cookie bidder dan Google ID pengguna, dan juga memungkinkan seseorang mengisi daftar pengguna.
Tabel pencocokan
Tabel pencocokan dapat digunakan untuk memetakan ID atau data lain dari satu domain untuk lain. Bidder dapat menggunakan Layanan Pencocokan Cookie untuk mengisi Bidder tabel pencocokan dengan memetakan cookie mereka untuk pengguna tertentu ke cookie Google User-ID, atau untuk mengisi tabel pencocokan yang dihosting oleh Google. Tabel pencocokan adalah diperlukan oleh aplikasi bidder bidder untuk mengakses data cookie bagi pengguna tayangan iklan ditampilkan.
Tabel pencocokan yang dihosting Google
Untuk pemeliharaan yang lebih mudah, peningkatan latensi, dan akses untuk mencocokkan data untuk pengguna di wilayah tertentu, sebaiknya Anda mengizinkan Google untuk menghosting tabel pencocokan. Hal ini memungkinkan Anda menentukan string berenkode base64 yang aman bagi web— selanjutnya disebut sebagai data pencocokan yang dihosting—yang akan dipetakan ke ID Pengguna Google untuk pengguna tertentu. Setelah kecocokan ditetapkan, digunakan dengan cara berikut:
Bidding Real-Time: Dalam permintaan bid berikutnya untuk tayangan yang dikaitkan dengan pengguna, Google akan mengirimkan data pencocokan yang dihosting cocok 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 OpenRTB Google implementasi,BidRequest.user.buyeruid
akan menampilkan data sebagai string berenkode base64 yang aman bagi 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. Hal ini dapat digunakan untuk menghilangkan tayangan untuk 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 Manajer Akun Teknis, yang dapat mengaktifkan alur kerja tertentu dan membantu Anda lakukan konfigurasi berikut ini:
- ID Jaringan Pencocokan Cookie (NID): ID string yang mengidentifikasi secara unik 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 dalam alur kerja Pencocokan Cookie.
- Tag Pencocokan: Tag yang harus Anda tempatkan di browser pengguna untuk alur kerja Pencocokan Cookie yang dimulai bidder. Konten ini dapat ditayangkan bersama iklan. atau ditempatkan di properti web selain iklan.
- URL Laporan Pencocokan Cookie (opsional): Dalam mode Searah Alur Kerja Pencocokan Cookie, ini adalah URL opsional yang dapat diberikan untuk menentukan endpoint yang akan menerima detail error jika cookie pencocokan gagal melalui pengalihan HTTP 302. Secara default, respons hanya akan dikirim ke URL ini jika terjadi error dengan operasi pencocokan cookie, namun 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 masuk.
- Kuota Cookie Match Assist: Untuk bursa yang menerapkan Alur kerja Bantuan Pencocokan Cookie, ini adalah jumlah maksimum permintaan yang dapat diterima URL Pencocokan Cookie mereka kedua. Hal ini dimaksudkan untuk mencegah permintaan CMA membebani berlebih server pertukaran dengan permintaan.
Makro pencocokan cookie
Di salah satu alur kerja Pencocokan Cookie yang didukung, URL Pencocokan Cookie bidder biasanya memiliki parameter yang ditambahkan pada pemesanan tanpa jaminan. Bidder dengan integrasi yang memerlukan konsistensi urutan parameter dapat menempatkan makro di URL Pencocokan Cookie untuk menjamin penempatan iklan.
Makro yang didukung
Secara opsional, bidder dapat mengonfigurasi URL Pencocokan Cookie mereka untuk menyertakan satu atau
lebih banyak makro dalam bentuk %%GOOGLE_<PARAM_NAME>%%
atau
%%GOOGLE_<PARAM_NAME>_PAIR%%
. Makro yang didukung dan
nilai yang diluaskan 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 implementasinya memerlukan
parameter yang ditentukan bidder preset selain Pencocokan Pixel
parameter 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 kemudian Google mengirimkan permintaan kecocokan ke bidder ini, permintaan tersebut akan diperluas menjadi sesuatu 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 ini.
Diawali bidder: Pencocokan Cookie Dua Arah
Pencocokan Cookie Dua Arah mengacu pada alur kerja yang dimulai bidder, dengan mereka menempatkan tag pencocokan di browser pengguna yang mengarahkannya ke Google. Ini memungkinkan Google dan bidder mengisi tabel pencocokan. Berikut adalah contoh sederhana dari alur kerja ini.
Langkah 1: Tempatkan tag pencocokan
Untuk memulai alur ini, bidder harus menempatkan tag pencocokan seperti yang 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 di tag pencocokan agar harus dipenuhi kasus penggunaan yang berbeda. Untuk mempelajari parameter ini lebih lanjut, lihat Parameter URL Tag Pencocokan.
Langkah 2: Google merespons dengan pengalihan, termasuk data kecocokan
Tag pencocokan tersebut akan menyebabkan Layanan Pencocokan Cookie Google menerima
permintaan dari browser pengguna, yang akan mengeluarkan HTTP 302
dialihkan ke URL Pencocokan Cookie bidder. Pengalihan akan menyertakan kueri
parameter yang menentukan User ID Google dan nomor versinya di URL, dan
bidder juga akan menerima cookie mereka yang disertakan di header permintaan. Di beberapa
untuk URL pencocokan cookie yang ditentukan sebagai https://ad.network.com/pixel
,
URL pengalihan untuk tag pencocokan sederhana seperti yang terlihat di atas dapat terlihat seperti
berikut ini:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
ID Pengguna Google yang diteruskan melalui parameter google_gid
adalah
berenkode base64 yang aman bagi web tanpa padding
{i>string<i}. Bagi bidder yang memilih untuk menghosting tabel pencocokan, sebaiknya mereka
menyimpan string persis yang dikembalikan oleh Layanan Pencocokan Cookie. Dalam berikutnya
permintaan bid, hal ini akan sesuai dengan nilai yang ditentukan melalui BidRequest.google_user_id
dalam protokol RTB Google, atau BidRequest.user.id
dalam
Implementasi OpenRTB.
Versi yang ditentukan dalam google_cver
menunjukkan versi numerik
nomor versi untuk User-ID Google. ID Pengguna Google untuk pengguna tertentu akan
jarang berubah, dan setelah itu
ukurannya akan bertambah.
Jika Google mengalami error saat memproses permintaan pencocokan Anda,
Sebagai gantinya, parameter google_error
akan ditentukan.
Langkah 3: Bidder memproses pengalihan dan merespons dengan piksel
Bidder menerima pengalihan ke URL pencocokan cookie mereka termasuk yang ditentukan pada langkah pertama, dan parameter yang diberikan Google dalam langkah kedua. Selain itu, mereka juga akan menerima cookie di HTTP {i>header<i}. Jika operasi berhasil, bidder yang menghosting tabel pencocokannya sendiri dapat mencocokkan cookie mereka dengan ID Pengguna Google yang disertakan dalam respons. Penting merekomendasikan agar bidder menyimpan string persis yang ditampilkan oleh Pencocokan Cookie Layanan.
Jika operasi tidak berhasil, bidder akan menerima google_error
di pengalihan. Ini adalah nilai numerik yang terkait dengan
status {i>error<i} yang mengidentifikasi
kesalahan tertentu yang terjadi. Anda dapat mempelajari
informasi selengkapnya tentang nilai error yang mungkin ada di sini.
Jika menerima pesan {i>error<i}, Anda dapat mencoba mencocokkan kembali pengguna tersebut dengan
menempatkan tag pencocokan baru.
Bidder harus selalu merespons dengan menayangkan gambar piksel tak terlihat 1x1, atau
atau menampilkan respons No Content HTTP 204
.
Diagram alur kerja Pencocokan Cookie
Alur kerja ini diilustrasikan oleh diagram di bawah ini, di mana permintaan dan respons diwakili oleh panah, dan item data yang menyertainya tercantum dalam tanda kurung.
Parameter URL Tag Pencocokan
Parameter | Deskripsi |
---|---|
google_nid |
ID jaringan (NID) untuk akun bidder. ID ini dapat diambil melalui Bidder resource Anda |
google_cm |
Menunjukkan kepada Layanan Pencocokan Cookie Google bahwa layanan harus berfungsi pencocokan cookie. Nilai parameter diabaikan dan dapat dihilangkan. |
google_sc |
Parameter ini tidak digunakan lagi. Menyetel cookie Google untuk jika tidak ada. Nilai parameter diabaikan dan dapat dihilangkan. Tidak mencantumkan parameter akan menyebabkan error jika tidak ada cookie sudah ada. |
google_no_sc |
Parameter ini tidak digunakan lagi. Ini menunjukkan bahwa Layanan Pencocokan Cookie yang seharusnya tidak menetapkan cookie untuk pengguna jika salah satunya 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 bagi web (padding opsional). Data mentah harus bernilai 40
{i>byte<i} atau kurang. Misalnya, |
google_redir |
String yang dienkode ke URL yang dapat ditentukan bidder jika mereka ingin mengarahkan
Google akan mengirim pengalihan HTTP 302 ke URL yang dienkode untuk
tag pencocokan ini. Hal ini memungkinkan Google ditempatkan di bagian depan dalam rantai
panggilan ke partner. Ini akan mengakibatkan kesalahan
jika ditentukan tanpa
google_hm , atau dengan google_cm . |
google_ula |
String yang digunakan untuk menambahkan pengguna ke daftar pengguna yang ada. Nilai
format 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 data
tingkat penggunaan. Untuk detail selengkapnya, lihat
Persyaratan izin pengguna Uni Eropa di bawah, atau Dampak pada pencocokan cookie
kelayakan Anda di
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 ini, 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
adalah parameter izin lainnya yang tersedia di permintaan
( Contoh: |
Selain parameter di atas, bidder dapat menentukan parameternya sendiri, yang
akan ditambahkan sebagai parameter ke URL pengalihan. Perlu diketahui bahwa ditentukan bidder
parameter yang diberi nama dengan awalan google_
akan diabaikan karena
yang dicadangkan oleh Google untuk pengembangan di masa mendatang, dan pelestarian
parameter' pemesanan tidak dijamin. Tag pencocokan termasuk yang ditentukan bidder
parameter akan 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 apa yang ditentukan
dalam tag pencocokan. google_
berikut
parameter respons 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. Kapan
diterima, ini menunjukkan bahwa tidak ada operasi
yang telah dilakukan, dan tidak ada
|
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 awam yang menjelajahi laman 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 bid ke FinestDSP dan bidder lainnya melalui layanan Bidding Real-Time.
- Permohonan bidder FinestDSP menerima dan memproses permintaan bid, dan 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 ke Jula.
- Tag pencocokan memanggil Layanan Cookie Match Google, yang menentukan
Parameter
google_nid
dangoogle_cm
. - Layanan Cookie Match membaca cookie Google milik Jani, dan mengirimkan cookie
pengalihan ke URL Pencocokan Cookie FinestDSP dengan
Parameter
google_user_id
dangoogle_cver
ditetapkan. - Browser Jeni memuat pengalihan ke URL Cookie Match 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_user_id
di tabel pencocokannya. - 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 komputer mereka, berikut cara mencocokkan berhasil.
- 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
dalam tabel pencocokannya, dan menemukan {i>cookie <i}yang terkait dengan Jane yang dibuat seminggu sebelumnya (dalam Skenario 1). - Berdasarkan informasi yang terkait dengan cookie, bidding FinestDSP menempatkan bid pada tayangan, dan memenangkan lelang.
- Jani mungkin melihat iklan yang disesuaikan dengan minatnya, 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 kecocokan
tabel sementara. Hal ini dapat digunakan dalam kasus di mana bidder tidak diizinkan untuk menghosting
ID Pengguna Google di tabel pencocokannya sendiri. Untuk menggunakan alur ini, bidder
harus mengizinkan Google untuk menghosting tabel pencocokan, tidak dapat lagi menentukan
google_cm
dalam permintaan ke Layanan Pencocokan Cookie Google, dan
tidak akan menerima google_gid
untuk mengisinya sendiri
tabel pencocokan. Setelah Google menemukan kecocokan untuk pengguna, bidder dapat menambahkan
ke daftar pengguna menggunakan data cookie mereka sendiri. Demikian pula, permintaan bid untuk
pengguna tersebut akan mengecualikan User-ID Google, tetapi menyertakan data pencocokan yang dihosting. J
contoh sederhana dari alur kerja yang direvisi dirangkum dalam langkah-langkah di bawah ini.
Langkah 1: Tempatkan tag pencocokan yang diarahkan ke URL Pencocokan Cookie bidder
Untuk memulai alur ini, bidder harus menempatkan tag pencocokan sedemikian rupa
dirender di browser pengguna. Berbeda dengan alur kerja untuk pengguna yang tidak berasal dari negara bagian AS yang menerapkan pembatasan privasi,
tag pencocokan harus mengarahkan browser pengguna ke Cookie Anda
URL yang cocok. Misalnya, dengan URL Pencocokan Cookie yang dikonfigurasi sebagai
https://ad.network.com/pixel
, akan terlihat seperti ini:
<img src="https://ad.network.com/pixel" />
Saat memuat di browser pengguna, fitur ini akan meminta piksel dari URL Pencocokan Cookie. 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 dialihkan ke Cookie Google
Layanan yang cocok, termasuk parameter google_hm
yang diisi dengan
data cookie berenkode base64 yang aman bagi web. URL pengalihan mungkin terlihat seperti
berikut ini:
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, di selain cookie Google di header HTTP.
Langkah 4: Google menayangkan piksel pada keberhasilan atau pengalihan error jika URL laporan ditentukan
Jika operasi pencocokan cookie berhasil—atau jika tidak ada Cookie
URL Laporan Pencocokan telah ditentukan untuk akun bidder—Google
akan menyajikan piksel transparan 1x1 secara {i>default<i}, dan alur kerja akan berakhir di sini.
Tayangan untuk pengguna ini dalam permintaan bid berikutnya akan menyertakan informasi dari bidder
data pencocokan yang dihosting di BidRequest.hosted_match_data
untuk Google
Protocol, atau BidRequest.user.buyeruid
untuk OpenRTB Google
terlepas dari implementasi layanan. Bidder juga dapat mengisi daftar pengguna menggunakan data pencocokan yang dihosting
yang mereka tentukan.
Atau, jika terjadi error, Google akan mengirimkan pengalihan ke
URL Laporan Pencocokan Cookie dengan penyebab error yang ditentukan dalam
Parameter google_error
. Jika URL Laporan Pencocokan Cookie bidder
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 kesalahan (jika ada) yang disebutkan oleh Google dalam
Parameter google_error
. Untuk mempelajari lebih lanjut cara menafsirkan error
kode parameter, lihat deskripsi parameter.
Langkah 6: Bidder menayangkan piksel transparan 1x1
Bidder harus merespons dengan menayangkan piksel transparan 1x1 ke piksel browser.
Diagram alur kerja Pencocokan Cookie untuk pengguna dari negara bagian AS yang memiliki pembatasan privasi
Alur kerja default untuk pengguna di negara bagian Amerika Serikat yang memiliki pembatasan privasi diilustrasikan oleh diagram di bawah ini, di mana permintaan dan respons direpresentasikan oleh tanda panah, dan data item yang menyertainya dicantumkan 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 Bidder resource Anda |
google_sc |
Parameter ini tidak digunakan lagi. Menyetel cookie Google untuk jika tidak ada. Nilai parameter diabaikan dan dapat dihilangkan. Tidak mencantumkan parameter akan menyebabkan error jika tidak ada cookie sudah ada. |
google_no_sc |
Parameter ini tidak digunakan lagi. Ini menunjukkan bahwa Layanan Pencocokan Cookie yang seharusnya tidak menetapkan cookie untuk pengguna jika salah satunya tidak ada. Nilai parameter diabaikan dan dapat dihilangkan. |
google_hm |
Berisi data yang ingin disimpan bidder dalam pencocokan yang dihosting Google tabel sementara. |
google_redir |
URL berenkode yang Anda inginkan untuk dikirimi pengalihan HTTP 302 oleh Google. Tujuan
URL yang ditentukan akan menerima pengalihan dengan google_error
parameter untuk {i>error<i} dan
operasi yang berhasil. |
google_ula |
String yang digunakan untuk menambahkan pengguna ke daftar pengguna yang ada. Nilai
format 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 data
tingkat penggunaan. Untuk detail selengkapnya, lihat
Persyaratan izin pengguna Uni Eropa di bawah, atau Dampak pada pencocokan cookie
kelayakan Anda di
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 ini, 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
adalah parameter izin lainnya 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. Kapan
diterima, ini menunjukkan bahwa tidak ada operasi
yang telah dilakukan, dan tidak ada
|
dimulai Google: Pencocokan Piksel Dua Arah
Pencocokan Piksel Dua Arah adalah alur kerja untuk Pencocokan Cookie Google Layanan yang digunakan Google untuk mencoba mencocokkan User-ID Google dengan User-ID Google bidder yang dipilih 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. Ini akan mengaktifkan baik Google maupun bidder untuk mengisi tabel pencocokan dengan pengguna tertentu. Di bawah ini 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 itu diisi oleh Google, tag pencocokan dapat ditempatkan
meminta piksel dari bidder yang dipilih secara algoritma. 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
ditetapkan sebagai https://ad.network.com/pixel
, maka strukturnya adalah
berikut ini:
<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 wajib merespons dengan mengalihkan ke Layanan Pencocokan Cookie Google dengan struktur 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 di
pencocokan untuk Alur Kerja Pencocokan Cookie yang Dimulai Bidder.
Dalam Pencocokan Pixel, parameter google_cm
diganti dengan
google_push
, dan nilainya harus sama dengan nilai
yang disediakan oleh Google dalam permintaan. Juga serupa dengan yang dimulai bidder
alur kerja, 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 ini, di mana permintaan dan respons diwakili oleh panah, dan item data yang menyertainya tercantum dalam tanda kurung.
Parameter permintaan tag pencocokan Google
Parameter | Deskripsi |
---|---|
google_gid |
ID Pengguna Google. Untuk pengguna yang bukan dari negara bagian AS yang memiliki pembatasan privasi, pemberitahuannya akan yang ditentukan dalam tag pencocokan Google. |
google_cver |
Versi cookie. Ini akan selalu ditentukan dalam pencocokan Google . |
google_push |
Menunjukkan bahwa permintaan ini memulai alur kerja Pencocokan Pixel. Nilai harus ditampilkan melalui parameter yang sesuai dalam respons pengalihan. |
Parameter pengalihan Pencocokan Piksel bidder
Parameter | Deskripsi |
---|---|
google_nid |
ID jaringan (NID) untuk akun bidder. ID ini dapat diambil melalui Bidder resource Anda |
google_push |
Menunjukkan bahwa pengalihan ini sedang menyelesaikan Pencocokan Pixel alur kerja. Nilai dari tag pencocokan Google yang sesuai harus yang ditentukan di sini. |
google_hm |
Berisi data yang ingin disimpan bidder dalam pencocokan yang dihosting Google tabel sementara. |
google_ula |
String yang digunakan untuk menambahkan pengguna ke daftar pengguna yang ada. Nilai
format yang diharapkan adalah userlistid[,timestamp] :
Parameter URL ini dapat diulang untuk menambahkan pengguna ke beberapa daftar. |
dimulai Google: Pencocokan Piksel Searah
Pencocokan Piksel Searah berbeda dengan alur kerja Dua Arah bahwa tag pencocokan Google tidak menyertakan parameter yang menentukan tetapi akan terus mengisi tabel pencocokan yang dihosting Google. Ini dapat digunakan jika bidder tidak diizinkan untuk menghosting ID Pengguna Google tabel pencocokan itu 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 algoritma. Tag pencocokan mencakup
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 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 Cookie Google
Layanan yang cocok, termasuk parameter google_hm
yang diisi dengan
data cookie berenkode base64 yang aman bagi web. URL pengalihan mungkin terlihat seperti
berikut ini:
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, di
selain cookie Google di header HTTP. Jika operasinya adalah
berhasil, tayangan untuk pengguna ini dalam permintaan bid berikutnya akan mencakup
data kecocokan yang dihosting bidder di BidRequest.hosted_match_data
untuk
Protokol Google, atau BidRequest.user.buyeruid
untuk
Implementasi OpenRTB. Bidder juga dapat mengisi daftar pengguna menggunakan
mencocokkan data
yang mereka tentukan.
Terakhir, Google menampilkan piksel transparan 1x1 ke browser pengguna.
Bantuan Pencocokan Cookie
Bidding Terbuka memungkinkan bursa menggunakan dimulai oleh bidder dan diinisiasi Google alur kerja pencocokan cookie, untuk mencocokkan User-ID Google dengan cookie mereka. {i>Cookie<i} Match Assist (CMA) adalah fitur tambahan untuk bursa yang memungkinkan mereka membuat tabel pencocokan dengan bidder mereka sendiri.
Cara kerja Bantuan Cookie Match Assist
Saat menempatkan iklan, Google secara algoritmis memilih dan menempatkan tag Bantuan Pencocokan Cookie yang memiliki hal berikut struktur:
<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 {i>pixel<i}.
- Endpoint Pencocokan Cookie bursa menerima permintaan, dengan layanan pencocokan cookie bertanggung jawab untuk mencocokkan ID pengguna salah satu biddernya. Pada diagram di bawah, pencocokan cookie bursa layanan merespons browser pengguna dengan pengalihan ke salah satu permintaan endpoint.
- Bidder menerima permintaan tersebut beserta parameter yang ditentukan oleh pertukaran untuk mencocokkan ID pengguna dengan {i>cookie<i} mereka.
Pembatasan
Batasi frekuensi permintaan untuk kecocokan baru
Bidder bertanggung jawab membatasi jumlah panggilan ke Cookie Layanan pencocokan untuk pengguna yang memiliki entri baru dalam pencocokan yang dihosting Google tabel sementara. Entri dalam tabel pencocokan yang dihosting dapat dianggap habis masa berlakunya setelah 14 hari, dan setelah itu data tersebut 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 yang mencakup google_push
. Hal ini memungkinkan Google menegakkan kebijakan dengan memantau penggunaan. Jika
respons bidder turun di bawah 90%, Google akan membatasi jumlah
Permintaan Pixel Match dikirim ke akun mereka.
Menggunakan endpoint HTTPS
Endpoint yang digunakan di semua alur kerja Pencocokan Cookie harus digunakan dengan HTTPS.
Saat merespons permintaan Pixel Match yang dikirimkan kepada Anda melalui HTTPS, Anda yang diperlukan untuk mengalihkan ke Layanan Pencocokan Cookie melalui HTTPS. Demikian juga, 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 kepada Pengguna Uni Eropa Google Kebijakan Izin harus menunjukkan izin pengguna akhir. Permintaan tersebut diperlukan untuk menunjukkan bahwa izin telah dikumpulkan menggunakan salah satu cara berikut:
- TCFv2: Mencakup
gdpr
dangdpr_consent
parameter. Untuk mengetahui detailnya, lihat Dokumentasi TCF v2.0 IAB Authorized Buyers. process_consent
: pernyataan yang telah diperoleh bidder persetujuan pengguna yang diperlukan.
Contoh
Contoh di bawah ini menggambarkan cara menggunakan layanan Pencocokan Cookie untuk mencapai tujuan tertentu. Perhatikan bahwa kecuali jika dinyatakan lain, mengasumsikan bahwa pengguna yang ditindaklanjuti bukan dari Negara bagian AS yang memberlakukan pembatasan privasi.
Mengisi tabel pencocokan yang dihosting bidder
Bidder dapat menggunakan alur kerja Pencocokan Cookie untuk mengisi pencocokan mereka sendiri
tabel dengan hanya menyediakan google_nid
dan google_cm
dalam 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
respons terhadap tag pencocokan bidder mungkin akan 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 selengkapnya tentang kemungkinan kode error untuk alur kerja Pencocokan Cookie, lihat parameter URL pengalihan.
Tambahkan ke daftar pengguna tunggal
Parameter google_ula
dapat ditentukan dalam kecocokan bidder
tag untuk menambahkan pengguna ke daftar pengguna dengan ID yang diberikan. Jika Google atau
tabel pencocokan yang dihosting bidder memiliki entri baru untuk pengguna, bidder dapat menempatkan
tag pencocokan yang mencakup google_nid
dan google_ula
parameter untuk menambahkan pengguna ke daftar yang ditentukan tanpa memulai
Alur kerja Pencocokan Cookie. Lihat batasan
untuk memanggil Layanan Pencocokan Cookie untuk detail lainnya. Model
tag pencocokan akan terlihat seperti ini:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Agar respons 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 ada 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 terjadi {i>error<i} khususnya tentang
menambah pengguna ke daftar,
Anda akan menerima google_ula
di pengalihan. Tidak seperti
parameter tag pencocokan yang sesuai, hal ini akan menggantikan stempel waktu dengan status
kode untuk menunjukkan keberhasilan operasi. Misalnya, jika permintaan gagal
karena akun bidder tidak memiliki akses ke daftar pengguna yang ditentukan,
URL pengalihannya adalah:
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
dalam tag pencocokan. Di beberapa
ini akan terlihat 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 juga melalui
parameter google_ula
yang berbeda di pengalihan:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
Pada pengalihan di atas, kita dapat melihat bahwa operasi telah berhasil untuk pengguna.
daftar 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
. Hal ini mungkin terlihat seperti
berikut ini:
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 mereka di tabel pencocokan yang dihosting Google,
dan tidak bermaksud menyimpan kecocokan dengan ID Pengguna Google dalam pencocokannya sendiri
tabel, tag pencocokannya harus menyertakan parameter google_hm
dengan
nilainya harus berupa string berenkode base64 yang aman bagi web. Bagi pengguna di mana
data cookie bidder yang tidak dienkode adalah Cookie number 1!
,
nilainya akan menjadi Q29va2llIG51bWJlciAxIQ==
, yang akan digunakan dalam
cocokkan tag seperti berikut:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Agar respons 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 dalam pengalihan karena
tag pencocokan tidak menyertakan google_cm
, dan google_hm
adalah
tidak disertakan dalam respons yang berhasil. Pada permintaan bid di masa mendatang untuk tayangan
untuk pengguna ini, bidder akan menerima data pencocokan yang dihosting di
BidRequest.hosted_match_data
untuk protokol RTB Google, atau
BidRequest.user.buyeruid
untuk implementasi OpenRTB Google.
Jika bidder menggunakan tag pencocokan yang nilai
google_hm
tidak dienkode dengan format base64—seperti
chocolate_chunk!
—URL alihan mungkin terlihat seperti
berikut ini:
https://cookie-monster.com/pixel?google_hm=2
URL alihan di atas menyertakan nilai google_hm
2
, menunjukkan bahwa operasi gagal karena nilainya dapat
tidak dapat didekode.
Tabel pencocokan bidder dan yang dihosting Google dengan daftar pengguna
Jika bidder menghosting daftar penggunaannya sendiri selain pengguna yang dihosting Google
dan menginginkan satu tag pencocokan cocok dengan kedua tabel dan menambahkan pengguna
daftar pengguna tertentu, tag pencocokannya harus menyertakan google_cm
,
Parameter google_hm
, dan google_ula
. Jika
data cookie adalah Cookie number 1!
, nilai yang dienkode akan menjadi
Q29va2llIG51bWJlciAxIQ==
, yang akan menghasilkan tag pencocokan seperti
berikut ini:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
Agar respons berhasil, dengan URL Pencocokan Cookie bidder adalah
https://cookie-monster.com/pixel
, URL alihan Google akan
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 di tabel pencocokan. Di beberapa
mereka dapat menentukan bahwa tabel pencocokan
dan daftar pengguna yang dihosting Google
operasi berhasil. Akibatnya, setiap Pra-penargetan bidder
dikonfigurasikan untuk menargetkan ID daftar pengguna yang ditentukan sekarang akan menyebabkan bidder
menerima permintaan bid untuk tayangan dari pengguna. Demikian juga, dalam bid ini
permintaan, bidder akan menerima data pencocokan yang dihosting di
BidRequest.hosted_match_data
untuk protokol RTB Google, atau
BidRequest.user.buyeruid
untuk implementasi OpenRTB Google.