Anda dapat mengakses ID pihak pertama penayang untuk web dan menghapus data penargetan iklan terkait.
Mengakses ID pihak pertama penayang di web
ID pihak pertama penayang di web dapat diakses langsung dari cookie pihak pertama yang ditetapkan JavaScript di domain penayang. ID yang ditujukan untuk penggunaan eksternal oleh penayang dan partner kami ditemukan dalam cookie __gpi. Cookie lainnya (bernama __gads) tidak ditujukan untuk penggunaan eksternal oleh penayang atau partner kami, dan tidak diizinkan untuk penggunaan yang dipersonalisasi.
Nilai cookie __gpi berbentuk sebagai berikut:
UID=<unique_user_ID>:T=<creation_unix_timestamp_in_seconds>:RT=<refresh_unix_timestamp_in_seconds>:S=<google_generated_authenticity_signature>
Contoh nilai __gpi:
UID=00000a1b2c3def45:T=1709171636:RT=1709171636:S=ALNI_Ma_CBr2wmXJhLdNKG9z4FWhjVVIog
Nilai ID (UID) dan stempel waktu (T) adalah satu-satunya komponen yang ditujukan untuk penggunaan eksternal oleh penayang dan partner kami:
- UID saat ini adalah string heksadesimal 16 karakter, tetapi panjangnya tidak boleh dianggap stabil dan dapat berubah dari waktu ke waktu.
- T adalah bilangan bulat basis 10 yang mewakili stempel waktu unix pembuatan ID.
Dua komponen lainnya adalah detail implementasi internal yang dapat berubah dan tidak boleh diandalkan.
Cookie __gpi dan __gads saat ini memiliki usia maksimum 13 bulan, kecuali jika batasan browser menghapus total cookie lebih awal (seperti batasan ITP Safari pada cookie yang ditetapkan JavaScript). Jika cookie dihapus, Google akan mencoba mengisi ulang dengan nilai baru, jika diizinkan.
Selain __gpi dan __gads, penyimpanan cookie juga dapat berisi cookie keikutsertaan pengguna __gpi_opt_out. Jika memiliki nilai 1, pengguna telah menonaktifkan penggunaan yang dipersonalisasi untuk Google Ads di domain tersebut (melalui kontrol Opsi Iklan Google).
Sebelum mengakses cookie tersebut, Anda harus memastikan bahwa penggunaan cookie oleh Anda mematuhi semua hukum, pedoman, peraturan, dan aturan terkait privasi, keamanan data, dan perlindungan data di semua wilayah hukum yang berlaku.
Lihat contoh metode JavaScript untuk mengambil ID
/**
* Menampilkan ID Pihak Pertama Penayang dan Stempel Waktu.
* @returns {{UID: string|undefined, T: string|undefined}} Objek
* yang berisi string UID dan Stempel Waktu, jika tersedia.
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// Dapatkan kunci+nilai cookie
const gpiCookie = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// Gunakan ekspresi reguler untuk penguraian
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// Menampilkan nilai yang diekstrak
return {
UID: regex_match[1],
T: regex_match[2]
};
}
Lihat contoh penggunaan
try {
const parsedValues = getPublisherFirstPartyIdAndCreationTimestamp();
console.log(parsedValues);
console.log(parsedValues['UID']); // Nilai ID
console.log(parsedValues['T']); // Stempel waktu pembuatan
} catch (error) {
console.error(error.message);
}Menghapus data pengguna yang terkait dengan ID pihak pertama penayang di web
Penayang dapat meminta agar data pengguna yang terkait dengan __gpi tertentu dihapus dari sistem penyimpanan penargetan iklan internal Google.
Untuk meminta penghapusan data yang terkait dengan komponen UID dari __gpi tertentu, penayang harus mengirim permintaan HTTP dalam bentuk berikut:
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
Perhatikan nilai-nilai berikut untuk formulir:
- id adalah nilai ID. Ini harus berupa angka heksadesimal 16 karakter dan merupakan komponen UID yang diambil oleh metode akses yang dijelaskan di atas.
- iu adalah kode jaringan Ad Manager penayang.
- idtype mengidentifikasi jenis ID. Untuk ID pihak pertama penayang di web, nilainya harus "sco" untuk menunjukkan cookie cakupan situs.
Contoh:
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
Respons yang seharusnya
Kode status respons HTTP “200”, yang menunjukkan bahwa permintaannya OK, akan ditampilkan jika ketiga parameter tersebut ada dengan nilai yang valid:
- Nilai “id” adalah nilai heksadesimal 16 karakter.
- Nilai “iu” adalah kode jaringan Ad Manager yang valid
- Nilai “idtype” harus “sco” untuk menunjukkan bahwa ini adalah ID pihak pertama penayang di web
Kode status respons HTTP “400” akan ditampilkan jika permintaan tidak diformat dengan benar.
