เข้าถึงรหัสบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาและลบข้อมูลผู้ใช้ที่เชื่อมโยง

คุณสามารถเข้าถึงรหัสบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาสำหรับเว็บและลบข้อมูลการกำหนดเป้าหมายโฆษณาที่เกี่ยวข้องได้

เข้าถึงรหัสบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาบนเว็บ

รหัสของบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาบนเว็บเข้าถึงได้โดยตรงจากคุกกี้ของบุคคลที่หนึ่งที่ 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" หากคำขอมีรูปแบบไม่ถูกต้อง

ข้อมูลนี้มีประโยชน์ไหม

เราจะปรับปรุงได้อย่างไร
true
บันทึกประจำรุ่น

อ่านเกี่ยวกับฟีเจอร์ล่าสุดของ Ad Manager และการอัปเดตในศูนย์ช่วยเหลือ

ดูว่ามีอะไรใหม่

ค้นหา
ล้างการค้นหา
ปิดการค้นหา
เมนูหลัก
14161482974982528214
true
ค้นหาศูนย์ช่วยเหลือ
true
true
true
true
true
148
false
false