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 ada di 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 mengisinya ulang dengan nilai baru, jika diizinkan.
Selain __gpi dan __gads, penyimpanan cookie juga dapat berisi cookie ketidakikutsertaan pengguna __gpi_opt_out. Jika nilainya 1, pengguna telah menonaktifkan penggunaan personalisasi 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 ID pihak pertama tertentu dihapus. Anda dapat menggunakan API penghapusan data untuk mengirimkan permintaan untuk satu ID. Tersedia dua opsi. Opsi 1 mendukung Data Deletion Request Framework IAB.
Opsi 1 (mendukung Data Deletion Request Framework IAB)
dsrdelete.json Anda.dsrdelete.json dan menghostingnya di root domain Anda. Anda dapat mempelajari lebih lanjut file dsrdelete.json serta kolom wajib dan opsionalnya dalam dokumentasi IAB.Mengirim permintaan
Atribut wajib
Tinjau atribut wajib untuk permintaan penghapusan data Anda dalam tabel berikut. Untuk mengetahui detail lengkap tentang parameter, kode contoh, dan persyaratan lainnya, buka Data Deletion Request Framework IAB.
| Atribut | Deskripsi | Nilai contoh |
|---|---|---|
| sub.identifierType | Jenis ID | pfpid_domain |
| sub.identifierValue | ID yang Anda minta untuk dihapus | 0000128ff97be809 |
| sub.identifierFormat | Format ID pengguna | plaintext |
Opsi 2 (Tidak digunakan lagi)
Untuk meminta penghapusan data yang terkait dengan komponen UID dari __gpi tertentu, penayang harus mengirim permintaan HTTPS dalam bentuk berikut:
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
Perhatikan nilai-nilai berikut untuk bentuk di atas:
- id adalah nilai ID. Nilai 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 HTTPS "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 ID ini adalah ID pihak pertama penayang di web.
Kode status respons HTTPS "400" akan ditampilkan jika permintaan tidak diformat dengan benar.
Menghapus data pengguna yang terkait dengan IDFV di iOS14+
Penayang Ad Manager dapat meminta agar data pengguna yang terkait dengan ID vendor (IDFV) tertentu dihapus. Anda dapat menggunakan API penghapusan data untuk mengirimkan permintaan untuk satu ID. API penghapusan data ini sesuai dengan Data Deletion Request Framework IAB.
Sebelum mengirimkan permintaan penghapusan data, Anda harus menghubungi pengelola akun Anda terlebih dahulu dan meminta untuk ditambahkan ke registry kami untuk framework IAB. Anda harus mengirimkan domain yang akan menghosting file dsrdelete.json Anda.
Setelah domain Anda terdaftar di Google, Anda harus membuat file dsrdelete.json dan menghostingnya di root domain Anda. Anda dapat mempelajari lebih lanjut file dsrdelete.json, serta kolom wajib dan opsionalnya dalam dokumentasi IAB.
Mengirim permintaan penghapusan data IDFV
Untuk meminta penghapusan data IDFV, mulai permintaan menggunakan URL berikut:
Atribut wajib
Tinjau atribut wajib untuk permintaan penghapusan data IDFV Anda dalam tabel berikut. Untuk mengetahui detail lengkap tentang parameter, kode contoh, dan persyaratan lainnya, buka Data Deletion Request Framework IAB.
| Atribut | Deskripsi |
Nilai contoh |
|---|---|---|
| sub.identifierType | Jenis ID | idfv |
| sub.identifierValue | ID yang Anda minta untuk dihapus | 82e812aa-1972-49ad-aad8-6092387e1275 |
| sub.identifierFormat | Format ID pengguna | plaintext |