คุณสามารถเข้าถึงรหัสบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาสำหรับเว็บและลบข้อมูลการกำหนดเป้าหมายโฆษณาที่เกี่ยวข้องได้
เข้าถึงรหัสบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาบนเว็บ
รหัสของบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาบนเว็บเข้าถึงได้โดยตรงจากคุกกี้ของบุคคลที่หนึ่งที่ JavaScript ตั้งค่าไว้ภายใต้โดเมนของผู้เผยแพร่โฆษณา รหัสที่มีไว้สําหรับการใช้งานภายนอกโดยผู้เผยแพร่โฆษณาและพาร์ทเนอร์จะอยู่ในคุกกี้ __gpi
คุกกี้อีกรายการหนึ่ง (ชื่อ __gads
) ไม่ได้มีไว้สำหรับผู้เผยแพร่โฆษณาหรือพาร์ทเนอร์ของเราเพื่อการใช้งานภายนอก และไม่อนุญาตให้ใช้เพื่อการปรับตามโปรไฟล์ของผู้ใช้
ค่าของคุกกี้ __gpi
มีรูปแบบดังนี้
UID=<unique_user_ID>:T=<creation_unix_timestamp_in_seconds>:RT=<refresh_unix_timestamp_in_seconds>:S=<google_generated_authenticity_signature>
ตัวอย่างค่า __gpi
UID=00000a1b2c3def45:T=1709171636:RT=1709171636:S=ALNI_Ma_CBr2wmXJhLdNKG9z4FWhjVVIog
ค่าของรหัส (UID) และการประทับเวลา (T) เป็นคอมโพเนนต์เดียวที่นักพัฒนาแอปและพาร์ทเนอร์ของเรามีไว้เพื่อการใช้งานภายนอก
- ปัจจุบัน UID จะเป็นสตริงเลขฐานสิบหก 16 อักขระ แต่ความยาวนี้ไม่ควรถือว่าคงที่และอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป
- T คือจำนวนเต็มเลขฐาน 10 ที่แสดงการประทับเวลา Unix ของการสร้างรหัส
ส่วนอีก 2 รายการที่เหลือเป็นรายละเอียดการใช้งานภายในซึ่งอาจมีการเปลี่ยนแปลงและไม่ควรนำมาใช้
ปัจจุบันคุกกี้ __gpi
และ __gpi
มีอายุสูงสุด 13 เดือน เว้นแต่ข้อจำกัดของเบราว์เซอร์จะล้างข้อมูลคุกกี้ออกก่อน (เช่น ข้อจำกัด ITP ของ Safari สำหรับคุกกี้ที่ JavaScript ตั้งค่า) หากลบคุกกี้ออก Google จะพยายามป้อนค่าใหม่ลงในคุกกี้อีกครั้ง (หากได้รับอนุญาต)
นอกจาก __gpi
และ __gpi
แล้ว ที่เก็บคุกกี้อาจมีคุกกี้การเลือกไม่ใช้ของผู้ใช้ __gpi
ด้วย หากมีค่าเป็น 1 แสดงว่าผู้ใช้ปิดใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้สําหรับ Google Ads ในโดเมนนั้น (ผ่านการควบคุมตัวเลือกโฆษณาของ Google)
ก่อนเข้าถึงคุกกี้เหล่านั้น คุณควรตรวจสอบว่าการใช้คุกกี้เป็นไปตามกฎหมาย คำสั่ง ข้อบังคับ และกฎทั้งหมดในเขตอำนาจศาลที่เกี่ยวข้องซึ่งว่าด้วยความเป็นส่วนตัว การรักษาความปลอดภัยของข้อมูล และการคุ้มครองข้อมูล
ดูตัวอย่างเมธอด JavaScript เพื่อดึงข้อมูลรหัส
/**
* แสดงผลรหัสบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาและการประทับเวลา
* @returns {{UID: string|undefined, T: string|undefined}} An object
* ที่มีสตริง UID และการประทับเวลา (หากมี)
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// Get the cookie key+value
const gpiCookie = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// ใช้นิพจน์ทั่วไปในการแยกวิเคราะห์
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// แสดงค่าที่ดึงมา
return {
UID: regex_match[1],
T: regex_match[2]
};
}
ดูตัวอย่างการใช้งาน
try {
const parsedValues = getPublisherFirstPartyIdAndCreationTimestamp();
console.log(parsedValues);
console.log(parsedValues['UID']); // The value of the ID
console.log(parsedValues['T']); // The creation timestamp
} catch (error) {
console.error(error.message);
}
ลบข้อมูลผู้ใช้ที่เชื่อมโยงกับรหัสบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาบนเว็บ
ผู้เผยแพร่โฆษณาสามารถขอให้ลบข้อมูลผู้ใช้ที่เชื่อมโยงกับ __gpi
หนึ่งๆ ออกจากระบบพื้นที่เก็บข้อมูลการกำหนดเป้าหมายโฆษณาภายในของ Google ได้
หากต้องการขอลบข้อมูลที่เชื่อมโยงกับคอมโพเนนต์ UID ของ __gpi
หนึ่งๆ ผู้เผยแพร่โฆษณาควรส่งคำขอ HTTP ในรูปแบบต่อไปนี้
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
โปรดจดบันทึกค่าต่อไปนี้สำหรับแบบฟอร์ม
- id คือค่าของรหัส โดยควรเป็นตัวเลขฐานสิบหก 16 อักขระ และเป็นคอมโพเนนต์ UID ที่ดึงข้อมูลโดยวิธีการเข้าถึงที่อธิบายไว้ข้างต้น
- iu คือรหัสเครือข่าย Ad Manager ของผู้เผยแพร่โฆษณา
- idtype ระบุประเภทของรหัส สำหรับรหัสของบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาบนเว็บ ค่าควรเป็น "sco" เพื่อระบุคุกกี้ระดับเว็บไซต์
ตัวอย่าง
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
การตอบกลับที่คาดหวัง
ระบบจะแสดงรหัสสถานะการตอบกลับ HTTP "200" ซึ่งบ่งบอกว่าคําขอถูกต้อง หากมีพารามิเตอร์ 3 รายการที่มีค่าที่ถูกต้อง ดังนี้
- ค่า "id" คือค่าฐานสิบหก 16 อักขระ
- ค่า "iu" คือรหัสเครือข่าย Ad Manager ที่ถูกต้อง
- ค่า "idtype" ควรเป็น "sco" เพื่อระบุว่านี่คือรหัสของบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาบนเว็บ
ระบบจะแสดงรหัสสถานะการตอบกลับ HTTP "400" หากคำขอมีรูปแบบไม่ถูกต้อง