การจับคู่คุกกี้

การจับคู่คุกกี้ คือคุณลักษณะที่ช่วยให้คุณสามารถจับคู่คุกกี้ของคุณ ตัวอย่างเช่น รหัสสำหรับผู้ใช้ที่เรียกดูเว็บไซต์ของคุณโดยมีรหัส รหัสผู้ใช้ Google เฉพาะของผู้เสนอราคา และสร้างรายชื่อผู้ใช้ที่ช่วยให้คุณ ตัวเลือกการเสนอราคาที่มีประสิทธิภาพมากขึ้น คู่มือนี้จะอธิบายแนวคิดที่ใช้ในคุกกี้ การจับคู่ รวมถึงเวิร์กโฟลว์การจับคู่คุกกี้ที่แตกต่างกัน และรูปแบบต่างๆ ที่ควรทราบสำหรับกรณีการใช้งานบางกรณี

แนวคิด

โดยปกติแล้ว เจ้าของโดเมนจะกำหนดเนื้อหาของคุกกี้สำหรับผู้ใช้ที่เรียกดู เว็บไซต์ของตนเอง ซึ่งใช้เพื่อระบุผู้ใช้ภายในโดเมนนั้นๆ แม้ว่าจะ 2 เจ้าของโดเมนอาจตกลงที่จะแลกเปลี่ยนข้อมูลนี้ ซึ่งเป็นโมเดลการรักษาความปลอดภัย ของอินเทอร์เน็ตเบราว์เซอร์จะจำกัดไม่ให้เบราว์เซอร์หนึ่งอ่านคุกกี้ที่ผู้อื่นตั้งค่าไว้

ในบริบทของการโฆษณาดิจิทัล Google จะระบุผู้ใช้ด้วยคุกกี้ ที่เป็นของโดเมน doubleclick.net และผู้เสนอราคา การเข้าร่วมการเสนอราคาแบบเรียลไทม์อาจมีโดเมนของตนเอง ระบุกลุ่มผู้ใช้ที่ต้องการแสดงโฆษณา การจับคู่คุกกี้ ทำให้ผู้เสนอราคาจับคู่คุกกี้ของตนกับของ Google ได้ ให้พิจารณาว่าการแสดงผลที่ส่งในคำขอราคาเสนอเชื่อมโยงกับรายการใดรายการหนึ่งหรือไม่ ผู้ใช้ที่ถูกกำหนดเป้าหมาย ผู้ใช้จะได้รับ ข้อมูลคุกกี้ของตนเองหรือ รหัสผู้ใช้ Google สำหรับผู้เสนอราคาโดยเฉพาะ ซึ่งเป็นรูปแบบที่เข้ารหัส คุกกี้ doubleclick.net รายการในคำขอราคาเสนอ

บริการจับคู่คุกกี้ที่อธิบายไว้ในคู่มือนี้จะช่วยอำนวยความสะดวกในการสร้าง และการรักษาการเชื่อมโยงระหว่างคุกกี้ของผู้เสนอราคาและ Google รหัสผู้ใช้ และอนุญาตให้ผู้ใช้ป้อนข้อมูลรายการผู้ใช้ได้ด้วย

ตารางจับคู่

สามารถใช้ตารางจับคู่เพื่อแมปรหัสหรือข้อมูลอื่นจากโดเมนหนึ่งกับ อีกรายการ ผู้เสนอราคาสามารถใช้บริการจับคู่คุกกี้เพื่อป้อนข้อมูลของตัวเอง จับคู่ตารางโดยจับคู่คุกกี้ของผู้ใช้ รหัสผู้ใช้ หรือสร้างตารางการจับคู่ที่โฮสต์โดย Google ตารางจับคู่คือ จำเป็นสำหรับแอปพลิเคชันผู้เสนอราคาของผู้เสนอราคาในการเข้าถึงข้อมูลคุกกี้สำหรับผู้ใช้ กำลังแสดงผล

ตารางจับคู่ที่โฮสต์โดย Google

เพื่อการบำรุงรักษาที่ง่ายขึ้น การปรับปรุงเวลาในการตอบสนอง และการเข้าถึงข้อมูลการจับคู่สำหรับ ผู้ใช้ในบางภูมิภาค ขอแนะนำให้คุณอนุญาตให้ Google โฮสต์ ตารางที่ตรงกัน ซึ่งจะช่วยให้คุณระบุสตริงที่เข้ารหัสแบบ Web-safe base64 ได้ หลังจากนั้นจะเรียกว่าข้อมูลการจับคู่ที่โฮสต์ไว้ ซึ่งจะจับคู่กับ รหัสผู้ใช้ Google สำหรับผู้ใช้ที่กำหนด เมื่อสร้างการแข่งขันแล้ว คุณสามารถ ที่ใช้ในลักษณะต่อไปนี้

  • การเสนอราคาแบบเรียลไทม์: ในคำขอราคาเสนอสำหรับการแสดงผลในภายหลัง ที่เชื่อมโยงกับผู้ใช้ Google จะส่งข้อมูลการจับคู่ที่โฮสต์ไว้ให้คุณ ตรงกับ User ID ของ Google หากมีการกําหนดค่าปลายทางการเสนอราคาแล้ว หากต้องการใช้โปรโตคอล RTB ของ Google คุณจะได้รับไบต์ที่ถอดรหัสแล้วผ่าน ฟิลด์ BidRequest.hosted_match_data ใน OpenRTB ของ Google การใช้งาน BidRequest.user.buyeruid จะแสดงผล เป็นสตริงที่เข้ารหัสแบบ Web-safe base64

  • รายการผู้ใช้: ป้อนข้อมูลผู้ใช้ได้ ด้วย User-ID ของ Google หรือข้อมูลการจับคู่ที่โฮสต์ไว้

  • การกำหนดเป้าหมายล่วงหน้า: คุณสามารถกำหนดค่าการกำหนดเป้าหมายล่วงหน้าให้รับเฉพาะคำขอราคาเสนอได้ ที่มีข้อมูลการจับคู่ที่โฮสต์ไว้ ข้อมูลนี้อาจนำมาใช้เพื่อกำจัดรายการที่มีความเกี่ยวข้องน้อยได้ การแสดงผลสำหรับผู้ใช้ที่อยู่นอกพื้นที่คุกกี้ของคุณ

รายการผู้ใช้

สร้างและจัดการรายการผู้ใช้ได้ด้วย Real-Time Bidding API เมื่อสร้างแล้ว คุณสามารถป้อนข้อมูลรายการเหล่านี้ด้วยเวิร์กโฟลว์การจับคู่คุกกี้ ตามที่อธิบายไว้ด้านล่าง หรือผ่านบริการอัปโหลดจํานวนมาก

เริ่มต้นใช้งาน

หากต้องการเริ่มต้นการจับคู่คุกกี้ คุณต้องติดต่อ ผู้จัดการลูกค้าด้านเทคนิคที่สามารถเปิดใช้งานเวิร์กโฟลว์ที่เฉพาะเจาะจงและช่วยเหลือคุณ กำหนดค่าดังต่อไปนี้

  • รหัสเครือข่ายการจับคู่คุกกี้ (NID): รหัสสตริงที่ระบุโดยไม่ซ้ำกัน บัญชีผู้เสนอราคาสำหรับการจับคู่คุกกี้และการดำเนินการอื่นๆ ที่เกี่ยวข้อง
  • URL การจับคู่คุกกี้: URL ฐานสำหรับปลายทางที่จะยอมรับ และจัดการคำขอที่เข้ามาโดยเป็นส่วนหนึ่งของเวิร์กโฟลว์การจับคู่คุกกี้ ผู้เสนอราคาสามารถฝังมาโครใน URL นี้เพื่อ ควบคุมลำดับของพารามิเตอร์ที่ส่งไปยังพารามิเตอร์นั้นในเวิร์กโฟลว์การจับคู่คุกกี้
  • แท็กจับคู่: แท็กที่คุณต้องวางในเบราว์เซอร์ของผู้ใช้สำหรับแท็ก เวิร์กโฟลว์การจับคู่คุกกี้ที่ผู้เสนอราคาเป็นผู้เริ่ม ซึ่งสามารถแสดงพร้อมกับโฆษณาได้ หรือแสดงอยู่ในผลิตภัณฑ์และบริการบนอินเทอร์เน็ตนอกโฆษณา
  • URL รายงานการจับคู่คุกกี้ (ไม่บังคับ): ไม่ได้แบบทิศทางเดียว เวิร์กโฟลว์การจับคู่คุกกี้ นี่คือ URL ที่ไม่บังคับซึ่งสามารถระบุไปยัง ระบุปลายทางที่จะได้รับรายละเอียดข้อผิดพลาดในเหตุการณ์ที่คุกกี้นั้น จับคู่ไม่สำเร็จผ่านการเปลี่ยนเส้นทาง HTTP 302 โดยค่าเริ่มต้น ระบบจะตอบกลับ ที่ส่งไปยัง URL นี้หากเกิดข้อผิดพลาดเกี่ยวกับการจับคู่คุกกี้ แต่ผู้เสนอราคาอาจขอให้ส่งการเปลี่ยนเส้นทางเสมอ
  • URL สนับสนุนการจับคู่คุกกี้: สำหรับ Exchange ที่ใช้ ขั้นตอนการทำงานของ Cookie Match Assist URL ฐานของปลายทางที่มีไว้เพื่อตอบกลับคำขอที่เข้ามา
  • โควต้าการสนับสนุนการจับคู่คุกกี้: สำหรับ Exchange ที่ใช้ ขั้นตอนการทำงานของ Cookie Match Assist จำนวนคำขอสูงสุดที่ URL การจับคู่คุกกี้ของตนสามารถรับได้ อย่างที่สอง ทั้งนี้เพื่อป้องกันไม่ให้คำขอ CMA ทำงานหนักเกินไป ของ Exchange ที่มีคำขอ

ในเวิร์กโฟลว์การจับคู่คุกกี้ใดก็ได้ที่รองรับ โดยทั่วไป URL จับคู่คุกกี้ของผู้เสนอราคาจะมีพารามิเตอร์ต่อท้าย เป็นการสั่งซื้อที่ไม่รับประกันการแสดงผล ผู้เสนอราคาที่มีการผสานรวมที่ต้องการความสอดคล้องกัน การจัดลำดับพารามิเตอร์สามารถวางมาโครใน URL การจับคู่คุกกี้เพื่อ รับประกันตำแหน่งของโฆษณา

มาโครที่รองรับ

ผู้เสนอราคาอาจกำหนดค่า URL การจับคู่คุกกี้ให้รวม URL หรือ มาโครเพิ่มเติมในรูปแบบ %%GOOGLE_<PARAM_NAME>%% หรือ %%GOOGLE_<PARAM_NAME>_PAIR%% มาโครที่รองรับและมาโคร ค่าที่ขยายได้แก่

มาโคร ค่าที่ขยาย
GOOGLE_GID GOOGLE_USER_ID
GOOGLE_GID_PAIR &amp;google_gid=GOOGLE_USER_ID
GOOGLE_CVER COOKIE_VERSION_NUMBER
GOOGLE_CVER_PAIR &amp;cver=COOKIE_VERSION_NUMBER
GOOGLE_ERROR ERROR_ID
GOOGLE_ERROR_PAIR &amp;google_error=ERROR_ID
GOOGLE_PUSH PIXEL_MATCH_DATA
GOOGLE_PUSH_PAIR &amp;google_push=PIXEL_MATCH_DATA
GOOGLE_ALL_PARAMS google_gid=GOOGLE_USER_ID&amp;cver=COOKIE_VERSION_NUMBER&amp;google_error=ERROR_ID

ตัวอย่างมาโคร

ผู้เสนอราคามีการผสานรวมการจับคู่คุกกี้กับปลายทางที่โฮสต์ที่ https://user.bidder.com.cookies และการใช้งานต้องมี พารามิเตอร์ที่ผู้เสนอราคากำหนดไว้ล่วงหน้านอกเหนือจากการจับคู่ Pixel ตามลำดับต่อไปนี้ google_push google_gid, google_cver และ google_error ผู้เสนอราคาสามารถทำได้โดยการตั้งค่า URL จับคู่คุกกี้กับ:

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%%

เมื่อ Google ส่งคำขอจับคู่ไปยังผู้เสนอราคารายนี้ในภายหลัง ระบบก็จะขยายคำขอ ไปเป็นแบบต่อไปนี้

https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3

ปัจจุบัน บริการจับคู่คุกกี้ของ Google สนับสนุนเวิร์กโฟลว์ 3 รูปแบบสำหรับ Use Case ที่แตกต่างกันตามที่อธิบายไว้ด้านล่าง

การจับคู่คุกกี้แบบ 2 ทิศทางหมายถึงเวิร์กโฟลว์ที่เริ่มโดยผู้เสนอราคา โดยที่ จะวางแท็กจับคู่ไว้ในเบราว์เซอร์ของผู้ใช้ เพื่อนําแท็กไปยัง Google ช่วงเวลานี้ จะช่วยให้ทั้ง Google และผู้เสนอราคาสร้างตารางการจับคู่ได้ ด้านล่างนี้คือ ตัวอย่างง่ายๆ ของเวิร์กโฟลว์นี้

ขั้นตอนที่ 1: วางแท็กจับคู่

ในการเริ่มต้นขั้นตอนนี้ ผู้เสนอราคาจะต้องวางแท็กจับคู่ของตน ที่แสดงผลในเบราว์เซอร์ของผู้ใช้ แท็กจับคู่แบบง่ายที่แสดง รหัสผู้ใช้ Google สำหรับผู้เสนอราคาอาจมีโครงสร้างดังนี้

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />

มีพารามิเตอร์เพิ่มเติมที่คุณสามารถใส่ในแท็กจับคู่เพื่อเติมเต็ม Use Case ที่แตกต่างกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์เหล่านี้ได้ที่ จับคู่พารามิเตอร์ URL ของแท็ก

ขั้นตอนที่ 2: Google ตอบกลับด้วยการเปลี่ยนเส้นทางรวมถึงข้อมูลการจับคู่

แท็กจับคู่จะทำให้บริการจับคู่คุกกี้ของ Google ได้รับ จากเบราว์เซอร์ของผู้ใช้ ซึ่งจะออก HTTP 302 เปลี่ยนเส้นทางไปยัง URL การจับคู่คุกกี้ของผู้เสนอราคา การเปลี่ยนเส้นทางจะรวมคำค้นหา ที่ระบุรหัสผู้ใช้ Google และหมายเลขเวอร์ชันใน URL และ ผู้เสนอราคาจะได้รับคุกกี้ที่รวมอยู่ในส่วนหัวของคำขอด้วย ใน สำหรับ URL การจับคู่คุกกี้ที่ระบุเป็น https://ad.network.com/pixel URL เปลี่ยนเส้นทางสำหรับแท็กจับคู่อย่างง่ายอย่างที่เห็นด้านบนอาจมีลักษณะดังนี้ ดังต่อไปนี้:

https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

รหัสผู้ใช้ Google ที่ส่งผ่านพารามิเตอร์ google_gid คือ เข้ารหัสฐาน 64 ที่ปลอดภัยสำหรับเว็บโดยไม่ต้องมีการเข้ารหัส สตริง สำหรับผู้เสนอราคาที่เลือกโฮสต์ตารางการจับคู่ ขอแนะนำให้ จัดเก็บสตริงที่ตรงกันซึ่งแสดงผลโดยบริการจับคู่คุกกี้ ในอีก การดำเนินการนี้จะสอดคล้องกับค่าที่ระบุผ่าน BidRequest.google_user_id ในโปรโตคอล RTB ของ Google หรือ BidRequest.user.id ใน การใช้งาน OpenRTB

เวอร์ชันที่ระบุใน google_cver จะระบุตัวเลข หมายเลขเวอร์ชันของ Google User ID รหัสผู้ใช้ Google ของผู้ใช้ที่กำหนดจะ ไม่บ่อยนัก ซึ่งหลังจากนั้นจะค่อยๆ เพิ่มขึ้น

หาก Google พบข้อผิดพลาดขณะประมวลผลคำขอจับคู่ของคุณ ระบบจะระบุพารามิเตอร์ google_error แทน

ขั้นตอนที่ 3: ผู้เสนอราคาประมวลผลการเปลี่ยนเส้นทางและตอบกลับด้วยพิกเซล

ผู้เสนอราคาจะได้รับการเปลี่ยนเส้นทางไปยัง URL การจับคู่คุกกี้ของตน ซึ่งรวมถึง พารามิเตอร์ที่ระบุไว้ในขั้นตอนแรก และพารามิเตอร์ที่ Google ระบุไว้ใน ขั้นตอนที่ 2 นอกจากนี้ ผู้ใช้ยังจะได้รับคุกกี้ใน HTTP ส่วนหัว หากดำเนินการสำเร็จ ผู้เสนอราคาจะโฮสต์ตารางจับคู่ของตนเอง อาจจับคู่คุกกี้ของตนกับ User ID ของ Google ที่รวมอยู่ในคำตอบ ใช่เลย แนะนำให้ผู้เสนอราคาจัดเก็บสตริงที่ตรงกันซึ่งแสดงผลโดยการจับคู่คุกกี้ บริการ

หากดำเนินการไม่สำเร็จ ผู้เสนอราคาจะได้รับ google_error ในการเปลี่ยนเส้นทาง นี่คือค่าตัวเลขที่เกี่ยวข้องกับ สถานะข้อผิดพลาดที่ระบุข้อผิดพลาดเฉพาะที่เกิดขึ้น คุณสามารถดู ดูข้อมูลเพิ่มเติมเกี่ยวกับค่าข้อผิดพลาดที่เป็นไปได้ที่นี่ หากคุณได้รับข้อผิดพลาด คุณอาจพยายามจับคู่กับผู้ใช้รายดังกล่าวอีกครั้งโดย วางแท็กการจับคู่ใหม่

ผู้เสนอราคาต้องตอบกลับโดยแสดงรูปภาพพิกเซลที่มองไม่เห็นขนาด 1x1 หรือ หรือแสดงผลการตอบกลับ HTTP 204 ไม่มีเนื้อหา

ขั้นตอนการทำงานนี้จะแสดงตามแผนภาพด้านล่าง ซึ่งจะแสดงคำขอและ คำตอบจะแสดงด้วยลูกศรและรายการข้อมูลที่อยู่ข้างคำตอบ แสดงอยู่ในวงเล็บ

จับคู่พารามิเตอร์ URL ของแท็ก

พารามิเตอร์ คำอธิบาย
google_nid รหัสเครือข่าย (NID) สำหรับบัญชีผู้เสนอราคา ดึงข้อมูลรหัสนี้ได้ ผ่านผู้เสนอราคา ทรัพยากร
google_cm ระบุต่อบริการจับคู่คุกกี้ของ Google ว่าเครื่องมือนี้จะทำงาน การจับคู่คุกกี้ ค่าพารามิเตอร์จะถูกละเว้นและอาจ ละเว้น
google_sc พารามิเตอร์นี้เลิกใช้งานแล้ว ตั้งค่าคุกกี้ของ Google สำหรับฟังก์ชัน ผู้ใช้ หากไม่มีอยู่ ค่าพารามิเตอร์จะถูกละเว้นและอาจ ละเว้น การละเว้นพารามิเตอร์จะส่งผลให้เกิดข้อผิดพลาดหากไม่มีคุกกี้ มีอยู่
google_no_sc พารามิเตอร์นี้เลิกใช้งานแล้ว สิ่งนี้แสดงถึง บริการจับคู่คุกกี้ที่ไม่ควรตั้งค่าคุกกี้สำหรับผู้ใช้ในกรณีที่ หนึ่งรูปไม่มีอยู่ ค่าพารามิเตอร์จะถูกละเว้นและอาจ ละเว้น
google_hm

ข้อมูลที่ผู้เสนอราคาต้องการจัดเก็บไว้ในตารางจับคู่ที่โฮสต์โดย Google

ค่านี้เป็นสตริงที่เข้ารหัสแบบ Web-safe base64 (ไม่บังคับระยะห่างจากขอบ) ข้อมูลดิบต้องเป็น 40 ไบต์หรือน้อยกว่า เช่น Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u

google_redir สตริงที่เข้ารหัส URL ซึ่งผู้เสนอราคาสามารถระบุหากต้องการกําหนดโดยตรง Google จะส่งการเปลี่ยนเส้นทาง HTTP 302 ไปยัง URL ที่เข้ารหัสสำหรับ แท็กจับคู่นี้ ซึ่งช่วยให้วาง Google ไว้ที่ด้านหน้าเป็นห่วงโซ่ โทรหาพาร์ทเนอร์ ซึ่งจะทำให้เกิดข้อผิดพลาดหากระบุไว้โดยไม่ระบุ google_hm หรือด้วย google_cm
google_ula สตริงที่ใช้ในการเพิ่มผู้ใช้ลงในรายชื่อผู้ใช้ที่มีอยู่ ค่าของ รูปแบบที่คาดไว้คือ userlistid[,timestamp]
  • userlistid: รหัสรายชื่อผู้ใช้ที่เป็นตัวเลขเดียว
  • timestamp: การประทับเวลาที่ไม่บังคับในรูปแบบ POSIX ระบุเมื่อมีการเพิ่มผู้ใช้ลงในรายชื่อผู้ใช้

อาจมีพารามิเตอร์ของ URL นี้ซ้ำเพื่อเพิ่มผู้ใช้ลงใน รายการ

gdpr ระบุว่าคำขออยู่ภายใต้ข้อจำกัดเกี่ยวกับข้อมูลตาม GDPR ดูรายละเอียดเพิ่มเติมได้ที่ ข้อกําหนดด้านความยินยอมของผู้ใช้ EU ด้านล่าง หรือผลกระทบต่อการจับคู่คุกกี้ ใน เอกสารประกอบเกี่ยวกับ TCF เวอร์ชัน 2.0 ของ Authorized Buyers

เช่น gdpr=1

gdpr_consent สตริง TC ที่แสดงความยินยอมของผู้ใช้ปลายทาง สำหรับรายละเอียดเพิ่มเติม ดูข้อกำหนดความยินยอมของผู้ใช้ EU ด้านล่าง หรือระบบจะส่งสตริง TC อย่างไรใน เอกสารประกอบเกี่ยวกับ TCF เวอร์ชัน 2.0 ของ Authorized Buyers
process_consent ระบุว่าผู้เสนอราคาได้รับความยินยอมจากผู้ใช้ปลายทางสำหรับการใช้ข้อมูลที่ระบุใน นโยบายความยินยอมของผู้ใช้ EU ของ Google

หากคำขอไม่ได้อยู่ภายใต้นโยบายความยินยอมของผู้ใช้ EU หรือหากมี มีพารามิเตอร์ความยินยอมอื่นๆ ที่พร้อมใช้งานในคำขอหรือไม่ (gdpr_consent) ระบบจะไม่สนใจพารามิเตอร์นี้

เช่น process_consent=T

นอกเหนือจากพารามิเตอร์ข้างต้นแล้ว ผู้เสนอราคาสามารถระบุพารามิเตอร์ของตัวเอง จะเพิ่มเป็นพารามิเตอร์ต่อท้าย URL การเปลี่ยนเส้นทาง โปรดทราบว่าผู้เสนอราคาเป็นผู้กำหนด พารามิเตอร์ที่มีชื่อด้วยคำนำหน้า google_ จะถูกละเว้นเนื่องจาก ที่ Google สงวนไว้ให้สำหรับการพัฒนาในอนาคต และการสงวนรักษา แต่ไม่มีการรับประกันการสั่งซื้อ แท็กจับคู่ที่มีผู้เสนอราคากำหนด อาจมีลักษณะดังนี้

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />

พารามิเตอร์ URL เปลี่ยนเส้นทาง

URL การเปลี่ยนเส้นทางสร้างขึ้นจาก URL การจับคู่คุกกี้พื้นฐานที่กำหนดค่าไว้สำหรับ บัญชีของผู้เสนอราคา รวมถึง google_ และพารามิเตอร์ที่ผู้เสนอราคากำหนด ขึ้นอยู่กับค่าที่ระบุไว้ในแท็กจับคู่ google_ต่อไปนี้ ระบบจะกำหนดพารามิเตอร์การตอบสนอง ดังนี้

พารามิเตอร์ คำอธิบาย
google_gid รหัสผู้ใช้ Google กำหนดว่าจะมีการระบุ google_cm ในคำขอและคำขอประสบความสำเร็จหรือไม่
google_cver เวอร์ชันของคุกกี้ กำหนดว่าจะมีการระบุ google_cm ในคำขอและคำขอประสบความสำเร็จหรือไม่
google_error

ค่าจำนวนเต็มที่ระบุข้อผิดพลาดโดยรวมของคำขอ วันและเวลา ที่ได้รับ ระบุว่าไม่มีการดำเนินการใดๆ และไม่มีการดำเนินการอื่นๆ ระบบจะตั้งค่าพารามิเตอร์การตอบสนอง google_ ข้อผิดพลาดที่รองรับ มีดังนี้

  • 1: ผู้ใช้มีคุกกี้ Google แต่เลือกไม่ใช้คุกกี้ การติดตามโดยใช้คุกกี้นี้
  • 2: ไม่ได้ระบุการดำเนินการที่ถูกต้อง ตัวอย่างเช่น ไม่มีการดำเนินการ ได้รับคำขอแล้ว
  • 3: ผู้ใช้ไม่มีคุกกี้ Google Google จะไม่ดำเนินการต่อไปนี้ ตั้งค่าคุกกี้ผ่านบริการจับคู่คุกกี้
  • 4: ระบุการดำเนินการที่ขัดแย้งกัน คุณไม่ใช่ ได้รับอนุญาตให้ระบุทั้ง google_push และ google_cm ที่ระบุในคำขอเดียวกันเนื่องจากมีวัตถุประสงค์ที่ขัดแย้งกัน
  • 5: พารามิเตอร์ google_push ที่ไม่ถูกต้องเดิมคือ ส่งในการเปลี่ยนเส้นทางไปยังเซิร์ฟเวอร์ของ Google โดยเป็นส่วนหนึ่งของแบบ 2 ทาง คำขอจับคู่พิกเซล การเปลี่ยนเส้นทางต้องตั้งค่า google_push ให้กับค่าเดียวกันที่ส่งให้คุณในคำขอพิกเซลเริ่มต้น
  • 6: มีการระบุ NID ที่ไม่ถูกต้องในแท็กการจับคู่
  • 7: ตรวจพบคุกกี้ที่ไม่ถูกต้อง
  • 8: เลิกใช้งานแล้ว ไม่พบคุกกี้
  • 9: ไม่พบคุกกี้ มีการสร้างคุกกี้ทดสอบ
  • 10: ใช้พารามิเตอร์ google_redir แล้ว โดยไม่ระบุ google_hm หรือมีการใช้นอกเหนือจากที่ระบุ ไปยัง google_cm
  • 15: คำขอมาจากภูมิภาคที่ Google ตารางการจับคู่ต้องโฮสต์โดย Google ด้วยเหตุนี้ การตอบกลับไม่มีรหัสผู้ใช้ของ Google ขณะนี้มีการเปิดใช้งานสำหรับ ในการเข้าชมส่วนน้อย แต่มีแผนที่จะเปิดใช้อย่างเต็มรูปแบบใน มิถุนายน 2020
google_hm

แสดงเฉพาะในกรณีที่พยายามเขียนไปยังตารางจับคู่ที่โฮสต์โดย Google ล้มเหลว เมื่อเกิดเหตุการณ์นี้ขึ้น ค่าของรหัสจะเป็นรหัสสถานะอย่างใดอย่างหนึ่งต่อไปนี้

  • 1 - ห้าม: ลูกค้ายังไม่ได้รับอนุญาตพิเศษให้กับ เขียนข้อความที่ตรงกันในตารางที่โฮสต์ไว้
  • 2 - ข้อผิดพลาดในการถอดรหัส: ค่าพารามิเตอร์ไม่สามารถ ถอดรหัสแล้ว
  • 3 - เพย์โหลดยาวเกินไป: ค่าพารามิเตอร์ได้รับการถอดรหัสเป็น มากกว่า 24 ไบต์
  • 4 - ข้อผิดพลาดภายใน: เกิดข้อผิดพลาดภายในขณะจัดเก็บ ข้อมูลดังกล่าว
  • 5 - ถูกควบคุม: การเขียนนี้ไม่ได้ประมวลผลเนื่องจาก การควบคุม
google_ula

สถานะของการดำเนินการเพิ่มรายชื่อผู้ใช้ ทำซ้ำหาก google_ula หลายรายการ ที่ระบุไว้ในคำขอ รูปแบบคือ
userlistid,status code

ตัวอย่าง: google_ula=1234567890,0

การดำเนินการ google_ula สามารถแสดงรหัสสถานะต่อไปนี้

  • 0 - ไม่มีข้อผิดพลาด เพิ่มผู้ใช้ลงในรายชื่อผู้ใช้แล้ว
  • 2 - ปฏิเสธสิทธิ์ คุณไม่มีสิทธิ์เพิ่มผู้ใช้ในรายชื่อผู้ใช้
  • 5 - รหัสรายชื่อผู้ใช้ไม่ถูกต้อง รหัสรายชื่อผู้ใช้ที่ระบุไม่ถูกต้อง
  • 6 - รหัสแอตทริบิวต์ที่ปิด รหัสรายชื่อผู้ใช้ที่ระบุปิดอยู่
  • 10 - ข้อผิดพลาดภายใน บริการจับคู่คุกกี้มี พบข้อผิดพลาดภายใน คุณสามารถลองจับคู่ผู้ใช้อีกครั้ง

สถานการณ์ต่อไปนี้อธิบายลักษณะของการจับคู่คุกกี้ ผู้ใช้ทั่วไปที่เรียกดูหน้าเว็บ

สถานการณ์ที่ 1: ผู้ใช้ล้างคุกกี้และเรียกดูเว็บไซต์

เจนจิราล้างแคชและคุกกี้ทั้งหมด จากนั้นผู้ใช้จึงไปที่หน้าแรกของ ExampleNews.com

ต่อไปนี้คือสิ่งที่เกิดขึ้น:

  1. ExampleNews.com แสดงผลและเรียกโฆษณาจาก Google (Ad Manager)
  2. เนื่องจากหน่วยโฆษณามีสิทธิ์สำหรับการจัดสรรแบบไดนามิก Google จะส่งราคาเสนอ คำขอไปยัง FinestDSP และผู้เสนอราคารายอื่นๆ ผ่านบริการการเสนอราคาแบบเรียลไทม์
  3. แอปพลิเคชันผู้เสนอราคาของ FinestDSP ได้รับและดำเนินการกับคำขอราคาเสนอ แล้วส่งการเสนอราคาตอบของตัวเอง
  4. Google จะได้รับการเสนอราคาตอบจากผู้เสนอราคา รวมถึงการเสนอราคาตอบของ FinestDSP ที่ระบุโฆษณาที่มีแท็กจับคู่ (พิกเซล)
  5. FinestDSP ชนะการประมูล Google แสดงโฆษณาและแท็กจับคู่ของ FinestDSP ชื่อบุคคล
  6. แท็กจับคู่จะเรียกบริการจับคู่คุกกี้ของ Google โดยระบุ พารามิเตอร์ google_nid และ google_cm
  7. บริการจับคู่คุกกี้อ่านคุกกี้ของ Google แล้วส่งคุกกี้ของเจน เปลี่ยนเส้นทางไปยัง URL จับคู่คุกกี้ของ FinestDSP ที่ตั้งค่าเป็น ตั้งค่าพารามิเตอร์ google_user_id และ google_cver แล้ว
  8. เบราว์เซอร์ของเจนโหลดการเปลี่ยนเส้นทางไปยัง URL การจับคู่คุกกี้ของ FinestDSP
  9. ปลายทางการจับคู่คุกกี้ของ FinestDSP จะประมวลผลคำขอเปลี่ยนเส้นทาง ซึ่งมีพารามิเตอร์ของ URL ที่ Google กําหนด และคุกกี้สําหรับเจนใน ส่วนหัว HTTP ตอนนี้ FinestDSP สามารถจัดเก็บการแมปคุกกี้ของพวกเขาไปยังฟังก์ชัน google_user_id ในตารางการจับคู่
  10. FinestDSP ตอบสนองต่อการเปลี่ยนเส้นทางด้วยพิกเซล 1x1 ที่มองไม่เห็น
สถานการณ์ที่ 2: ผู้ใช้ที่มีการแมปอยู่แล้ว

หนึ่งสัปดาห์หลังจากสถานการณ์ 1 เจนไปที่ ExampleNews.com อีกครั้ง ตอนนี้เจนจิรา มีทั้งผู้เสนอราคาและคุกกี้ Ad Manager ในเครื่องของตน นี่คือวิธีการจับคู่

  1. หน้าเว็บแสดงผล ซึ่งทำให้ Google (Ad Manager) ขอโฆษณาที่ จะแสดงผลในหน้าเว็บ
  2. ระหว่างการประมูลเพื่อแสดงโฆษณา Google จะส่งคำขอราคาเสนอไปยังผู้เสนอราคาที่เกี่ยวข้อง รวมทั้ง FinestDSP
  3. FinestDSP จะได้รับคำขอราคาเสนอ ซึ่งรวมถึงสัญญาณต่างๆ เช่น google_user_id
  4. FinestDSP จะค้นหา google_user_id ในตารางการจับคู่ แล้วพบคุกกี้ที่เชื่อมโยงกับเจน ที่สร้างไว้เมื่อ 1 สัปดาห์ก่อนหน้า (ในสถานการณ์ 1)
  5. การเสนอราคาของ FinestDSP ตามข้อมูลที่เชื่อมโยงกับคุกกี้ จะเสนอราคาให้กับการแสดงผลและชนะการประมูล
  6. Jane อาจเห็นโฆษณาที่ปรับแต่งตามความสนใจของตนตามข้อมูล ที่มีใน FinestDSP

การจับคู่คุกกี้แบบทิศทางเดียวนั้นคล้ายคลึงกับขั้นตอนการทำงานแบบสองทิศทาง เว้นแต่ว่าจะมีการปรับเปลี่ยนให้มีเพียงโฮสต์ของ Google เท่านั้นและป้อนข้อมูลที่ตรงกัน ใช้ในกรณีที่ผู้เสนอราคาไม่ได้รับอนุญาตให้โฮสต์ รหัสผู้ใช้ Google ในตารางการจับคู่ของตัวเอง หากต้องการใช้ขั้นตอนนี้ ผู้เสนอราคา ต้องอนุญาตให้ Google โฮสต์ตารางการจับคู่ ไม่สามารถระบุได้อีกต่อไป google_cm ในคำขอไปยังบริการจับคู่คุกกี้ของ Google และ จะไม่ได้รับ google_gid เพื่อป้อนข้อมูลของตัวเอง ตารางที่ตรงกัน เมื่อ Google จับคู่ผู้ใช้แล้ว ผู้เสนอราคาจะเพิ่ม ลงในรายการผู้ใช้โดยใช้ข้อมูลคุกกี้ของตนเอง ในทำนองเดียวกัน คำขอราคาเสนอสำหรับ ผู้ใช้เหล่านี้จะยกเว้นรหัสผู้ใช้ Google แต่จะรวมข้อมูลการจับคู่ที่โฮสต์ไว้ ต ตัวอย่างง่ายๆ ของเวิร์กโฟลว์ที่ปรับปรุงใหม่จะสรุปไว้ในขั้นตอนด้านล่าง

ในการเริ่มต้นขั้นตอนนี้ ผู้เสนอราคาจะต้องวางแท็กที่ตรงกันเพื่อให้ แสดงผลในเบราว์เซอร์ของผู้ใช้ ซึ่งต่างจากเวิร์กโฟลว์สำหรับผู้ใช้ที่ไม่ได้มาจากรัฐในสหรัฐอเมริกาที่มีข้อจำกัดด้านความเป็นส่วนตัว แท็กจับคู่ต้องกำหนดเส้นทางเบราว์เซอร์ของผู้ใช้ไปยังคุกกี้ของคุณ URL ที่ตรงกัน ตัวอย่างเช่น URL จับคู่คุกกี้ที่กำหนดค่าเป็น https://ad.network.com/pixel จะมีหน้าตาดังนี้

<img src="https://ad.network.com/pixel" />

เมื่อโหลดในเบราว์เซอร์ของผู้ใช้ ผู้เสนอราคาจะขอพิกเซลจากการเสนอราคา URL การจับคู่คุกกี้ คำขอนี้จะมีคุกกี้ของผู้ใช้เหล่านั้นในส่วนหัว HTTP ซึ่งควรแยกออกมาสำหรับขั้นตอนถัดไป

ปลายทางการจับคู่คุกกี้ของผู้เสนอราคาต้องเปลี่ยนเส้นทางไปยังคุกกี้ของ Google บริการจับคู่ ซึ่งรวมถึงพารามิเตอร์ google_hm ที่สร้างจาก ข้อมูลคุกกี้ที่เข้ารหัสแบบ Web-safe base64 URL เปลี่ยนเส้นทางอาจมีลักษณะดังนี้ ดังต่อไปนี้:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA

Google จะได้รับการเปลี่ยนเส้นทางที่มีพารามิเตอร์ที่คุณระบุใน เพิ่มคุกกี้ของ Google ในส่วนหัว HTTP

ขั้นตอนที่ 4: Google แสดงพิกเซลเมื่อสำเร็จหรือเปลี่ยนเส้นทางข้อผิดพลาดหากระบุ URL ของรายงานไว้

หากการจับคู่คุกกี้สำเร็จ หรือหากไม่มีคุกกี้ มีการระบุ URL รายงานที่ตรงกันสำหรับบัญชีของผู้เสนอราคา - Google จะแสดงพิกเซลโปร่งใสขนาด 1x1 โดยค่าเริ่มต้น และเวิร์กโฟลว์จะสิ้นสุดที่นี่ การแสดงผลของผู้ใช้รายนี้ในคำขอราคาเสนอครั้งต่อๆ ไปจะรวมข้อมูลของผู้เสนอราคา ข้อมูลการจับคู่ที่โฮสต์ไว้ใน BidRequest.hosted_match_data สำหรับ โปรโตคอล หรือ BidRequest.user.buyeruid สำหรับ OpenRTB ของ Google การใช้งานของคุณ ผู้เสนอราคายังป้อนข้อมูลรายการผู้ใช้โดยใช้ข้อมูลการจับคู่ที่โฮสต์ไว้ได้อีกด้วย ที่ได้ระบุไว้

มิเช่นนั้น หากเกิดข้อผิดพลาด Google จะส่งการเปลี่ยนเส้นทางไปยัง URL ของรายงานการจับคู่คุกกี้ที่มีสาเหตุของข้อผิดพลาดที่ระบุไว้ใน พารามิเตอร์ google_error หาก URL รายงานการจับคู่คุกกี้ของผู้เสนอราคา คือ https://ad.network.com/report URL เปลี่ยนเส้นทางจะมีลักษณะดังนี้ อย่างเช่น:

<img src="https://ad.network.com/report?google_error=ERROR_ID" />

เบราว์เซอร์ของผู้ใช้จะเปลี่ยนเส้นทางไปยัง URL รายงานการจับคู่คุกกี้ของผู้เสนอราคา รวมถึงสาเหตุของข้อผิดพลาด (หากมี) ที่ระบุโดย Google ใน พารามิเตอร์ google_error ดูข้อมูลเพิ่มเติมเกี่ยวกับการตีความข้อผิดพลาด โปรดดูคำอธิบายพารามิเตอร์

ขั้นตอนที่ 6: ผู้เสนอราคาแสดงพิกเซลโปร่งใสขนาด 1x1

ผู้เสนอราคาต้องตอบกลับโดยแสดงพิกเซลโปร่งใสขนาด 1x1 ต่อผู้ใช้ เบราว์เซอร์

แผนภาพแสดงเวิร์กโฟลว์เริ่มต้นสำหรับผู้ใช้ในรัฐในสหรัฐอเมริกาที่มีข้อจำกัดด้านความเป็นส่วนตัว ด้านล่าง โดยที่คำขอและการตอบกลับแสดงด้วยลูกศร และข้อมูล รายการที่ปรากฏพร้อมกันจะอยู่ในวงเล็บ

พารามิเตอร์ คำอธิบาย
google_nid รหัสเครือข่าย (NID) สำหรับบัญชีผู้เสนอราคา ดึงข้อมูลรหัสนี้ได้ ผ่านผู้เสนอราคา ทรัพยากร
google_sc พารามิเตอร์นี้เลิกใช้งานแล้ว ตั้งค่าคุกกี้ของ Google สำหรับฟังก์ชัน ผู้ใช้ หากไม่มีอยู่ ค่าพารามิเตอร์จะถูกละเว้นและอาจ ละเว้น การละเว้นพารามิเตอร์จะส่งผลให้เกิดข้อผิดพลาดหากไม่มีคุกกี้ มีอยู่
google_no_sc พารามิเตอร์นี้เลิกใช้งานแล้ว สิ่งนี้แสดงถึง บริการจับคู่คุกกี้ที่ไม่ควรตั้งค่าคุกกี้สำหรับผู้ใช้ในกรณีที่ หนึ่งรูปไม่มีอยู่ ค่าพารามิเตอร์จะถูกละเว้นและอาจ ละเว้น
google_hm

มีข้อมูลที่ผู้เสนอราคาต้องการจัดเก็บไว้ในการจับคู่ที่โฮสต์โดย Google

google_redir URL ที่เข้ารหัสที่คุณต้องการให้ Google ส่งการเปลี่ยนเส้นทาง HTTP 302 URL ที่ระบุจะได้รับการเปลี่ยนเส้นทางด้วย google_error สำหรับทั้งข้อผิดพลาดและการดำเนินการที่สำเร็จ
google_ula สตริงที่ใช้ในการเพิ่มผู้ใช้ลงในรายชื่อผู้ใช้ที่มีอยู่ ค่าของ รูปแบบที่คาดไว้คือ userlistid[,timestamp]
  • userlistid: รหัสรายชื่อผู้ใช้ที่เป็นตัวเลขเดียว
  • timestamp: การประทับเวลาที่ไม่บังคับในรูปแบบ POSIX ระบุเมื่อมีการเพิ่มผู้ใช้ลงในรายชื่อผู้ใช้

อาจมีพารามิเตอร์ของ URL นี้ซ้ำเพื่อเพิ่มผู้ใช้ลงใน รายการ

gdpr ระบุว่าคำขออยู่ภายใต้ข้อจำกัดเกี่ยวกับข้อมูลตาม GDPR ดูรายละเอียดเพิ่มเติมได้ที่ ข้อกําหนดด้านความยินยอมของผู้ใช้ EU ด้านล่าง หรือผลกระทบต่อการจับคู่คุกกี้ ใน เอกสารประกอบเกี่ยวกับ TCF เวอร์ชัน 2.0 ของ Authorized Buyers

เช่น gdpr=1

gdpr_consent สตริง TC ที่แสดงความยินยอมของผู้ใช้ปลายทาง สำหรับรายละเอียดเพิ่มเติม ดูข้อกำหนดความยินยอมของผู้ใช้ EU ด้านล่าง หรือระบบจะส่งสตริง TC อย่างไรใน เอกสารประกอบเกี่ยวกับ TCF เวอร์ชัน 2.0 ของ Authorized Buyers
process_consent ระบุว่าผู้เสนอราคาได้รับความยินยอมจากผู้ใช้ปลายทางสำหรับการใช้ข้อมูลที่ระบุใน นโยบายความยินยอมของผู้ใช้ EU ของ Google

หากคำขอไม่ได้อยู่ภายใต้นโยบายความยินยอมของผู้ใช้ EU หรือหากมี มีพารามิเตอร์ความยินยอมอื่นๆ ที่พร้อมใช้งานในคำขอหรือไม่ (gdpr_consent) ระบบจะไม่สนใจพารามิเตอร์นี้

เช่น process_consent=T

พารามิเตอร์ คำอธิบาย
google_error

ค่าจำนวนเต็มที่ระบุข้อผิดพลาดโดยรวมของคำขอ วันและเวลา ที่ได้รับ ระบุว่าไม่มีการดำเนินการใดๆ และไม่มีการดำเนินการอื่นๆ ระบบจะตั้งค่าพารามิเตอร์การตอบสนอง google_ ข้อผิดพลาดที่รองรับ มีดังนี้

  • 1: ผู้ใช้มีคุกกี้ Google แต่เลือกไม่ใช้คุกกี้ การติดตามโดยใช้คุกกี้นี้
  • 2: ไม่ได้ระบุการดำเนินการที่ถูกต้อง ตัวอย่างเช่น ไม่มีการดำเนินการ ได้รับคำขอแล้ว
  • 3: ผู้ใช้ไม่มีคุกกี้ Google Google จะไม่ดำเนินการต่อไปนี้ ตั้งค่าคุกกี้ผ่านบริการจับคู่คุกกี้
  • 4: ระบุการดำเนินการที่ขัดแย้งกัน คุณไม่ใช่ ได้รับอนุญาตให้ระบุทั้ง google_push และ google_cm ที่ระบุในคำขอเดียวกันเนื่องจากมีวัตถุประสงค์ที่ขัดแย้งกัน
  • 5: พารามิเตอร์ google_push ที่ไม่ถูกต้องเดิมคือ ส่งในการเปลี่ยนเส้นทางไปยังเซิร์ฟเวอร์ของ Google โดยเป็นส่วนหนึ่งของแบบ 2 ทาง คำขอจับคู่พิกเซล การเปลี่ยนเส้นทางต้องตั้งค่า google_push ให้กับค่าเดียวกันที่ส่งให้คุณในคำขอพิกเซลเริ่มต้น
  • 6: มีการระบุ NID ที่ไม่ถูกต้องในแท็กการจับคู่
  • 7: ตรวจพบคุกกี้ที่ไม่ถูกต้อง
  • 8: เลิกใช้งานแล้ว ไม่พบคุกกี้
  • 9: ไม่พบคุกกี้ มีการสร้างคุกกี้ทดสอบ
  • 10: ใช้พารามิเตอร์ google_redir แล้ว โดยไม่ระบุ google_hm หรือมีการใช้นอกเหนือจากที่ระบุ ไปยัง google_cm
  • 15: คำขอมาจากภูมิภาคที่ Google ตารางการจับคู่ต้องโฮสต์โดย Google ด้วยเหตุนี้ การตอบกลับไม่มีรหัสผู้ใช้ของ Google ขณะนี้มีการเปิดใช้งานสำหรับ ในการเข้าชมส่วนน้อย แต่มีแผนที่จะเปิดใช้อย่างเต็มรูปแบบใน มิถุนายน 2020

ริเริ่มโดย Google: การจับคู่พิกเซลแบบ 2 ทิศทาง

การจับคู่พิกเซลแบบ 2 ทิศทางเป็นเวิร์กโฟลว์สำหรับการจับคู่คุกกี้ของ Google บริการที่ Google พยายามจับคู่รหัสผู้ใช้ Google กับอัลกอริทึม ผู้เสนอราคาที่เลือกไว้ที่ไม่ใช่ผู้เสนอราคาแบบเรียลไทม์เท่านั้น เมื่อโฆษณากำลัง Google จะวางแท็กที่ตรงกันซึ่งนำทางเบราว์เซอร์ของผู้ใช้ให้โหลด พิกเซลโปร่งใสจาก URL การจับคู่คุกกี้ของผู้เสนอราคาที่เลือก วิธีนี้จะทำให้ ทั้ง Google และผู้เสนอราคาเพื่อสร้างตารางการจับคู่กับผู้ใช้ที่กำหนด ด้านล่างคือ ตัวอย่างง่ายๆ ของเวิร์กโฟลว์นี้

ขั้นตอนที่ 1: Google จะวางแท็กจับคู่

เมื่อหน้าเว็บของผู้เผยแพร่โฆษณาที่เข้าร่วมโหลดในเบราว์เซอร์ของผู้ใช้ และ ช่องโฆษณาบนหน้านั้นได้รับการเติมโดย Google อาจมีการวางแท็กที่ตรงกันซึ่ง ขอพิกเซลจากผู้เสนอราคาที่เลือกตามอัลกอริทึม การจับคู่พิกเซล แท็กที่ Google วางจะรวม URL การจับคู่คุกกี้ของผู้เสนอราคากับ พารามิเตอร์เพิ่มเติม สามารถใช้เพื่อสร้างตารางการจับคู่ สำหรับ URL การจับคู่คุกกี้ ระบุเป็น https://ad.network.com/pixel แต่มีโครงสร้างเป็น ดังต่อไปนี้:

<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />

ผู้เสนอราคาที่ได้รับคำขอจับคู่พิกเซลจะต้องตอบกลับ เปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ของ Google ซึ่งมีโครงสร้างดังนี้

https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA

โปรดทราบว่า URL เปลี่ยนเส้นทางข้างต้นนั้นคล้ายกับ URL ที่ใช้ใน แท็กจับคู่สำหรับเวิร์กโฟลว์การจับคู่คุกกี้ที่เริ่มต้นโดยผู้เสนอราคา ในการจับคู่พิกเซล พารามิเตอร์ google_cm จะถูกแทนที่ด้วยพารามิเตอร์ google_push และค่าต้องเท่ากับค่า ที่ให้ไว้โดย Google ในคำขอ การดำเนินการที่คล้ายกับผู้เสนอราคาที่เริ่มต้น เวิร์กโฟลว์ พารามิเตอร์เพิ่มเติม สามารถระบุเพื่อดำเนินการตามกรณีการใช้งานเพิ่มเติม

ขั้นตอนที่ 3: Google ประมวลผลการเปลี่ยนเส้นทางและตอบสนองด้วยพิกเซล

Google จะบันทึกว่ามีการสร้างการจับคู่ที่ตรงกันให้กับผู้ใช้ และจัดการ การดำเนินการเพิ่มเติมที่ขอผ่านทางพารามิเตอร์การค้นหา สุดท้าย Google จะตอบสนอง ที่มีพิกเซลโปร่งใสขนาด 1x1

แผนภาพเวิร์กโฟลว์การจับคู่พิกเซล

ขั้นตอนการทำงานนี้จะแสดงตามแผนภาพด้านล่าง ซึ่งจะแสดงคำขอและ คำตอบจะแสดงด้วยลูกศรและรายการข้อมูลที่อยู่ข้างคำตอบ แสดงอยู่ในวงเล็บ

พารามิเตอร์คำขอแท็กจับคู่ของ Google

พารามิเตอร์ คำอธิบาย
google_gid รหัสผู้ใช้ Google สำหรับผู้ใช้ที่ไม่ได้อยู่ในรัฐในสหรัฐอเมริกาที่มีข้อจำกัดด้านความเป็นส่วนตัว การยืนยันนี้จะเป็น ที่ระบุในแท็กจับคู่ของ Google
google_cver เวอร์ชันของคุกกี้ ชื่อนี้จะระบุเสมอในการจับคู่ของ Google แท็ก
google_push ระบุว่าคำขอนี้กำลังเริ่มต้นเวิร์กโฟลว์การจับคู่พิกเซล ค่านี้ต้องส่งผ่านพารามิเตอร์ที่เกี่ยวข้องในการเสนอราคา การตอบกลับการเปลี่ยนเส้นทาง

พารามิเตอร์การเปลี่ยนเส้นทางการจับคู่พิกเซลของผู้เสนอราคา

พารามิเตอร์ คำอธิบาย
google_nid รหัสเครือข่าย (NID) สำหรับบัญชีผู้เสนอราคา ดึงข้อมูลรหัสนี้ได้ ผ่านผู้เสนอราคา ทรัพยากร
google_push ระบุว่าการเปลี่ยนเส้นทางนี้ทำให้การจับคู่พิกเซลเสร็จสมบูรณ์ ค่าจากแท็กจับคู่ของ Google ที่เกี่ยวข้องต้องเป็น ที่ระบุไว้ที่นี่
google_hm

มีข้อมูลที่ผู้เสนอราคาต้องการจัดเก็บไว้ในการจับคู่ที่โฮสต์โดย Google

google_ula สตริงที่ใช้ในการเพิ่มผู้ใช้ลงในรายชื่อผู้ใช้ที่มีอยู่ ค่าของ รูปแบบที่คาดไว้คือ userlistid[,timestamp]
  • userlistid: รหัสรายชื่อผู้ใช้ที่เป็นตัวเลขเดียว
  • timestamp: การประทับเวลาที่ไม่บังคับในรูปแบบ POSIX ระบุเมื่อมีการเพิ่มผู้ใช้ลงในรายชื่อผู้ใช้

อาจมีพารามิเตอร์ของ URL นี้ซ้ำเพื่อเพิ่มผู้ใช้ลงใน รายการ

เริ่มต้นโดย Google: การจับคู่พิกเซลแบบทิศทางเดียว

การจับคู่พิกเซลแบบทิศทางเดียวแตกต่างจากเวิร์กโฟลว์แบบ 2 ทิศทางใน แท็กจับคู่ของ Google ไม่มีพารามิเตอร์ที่ระบุผู้ใช้ Google แต่จะยังป้อนข้อมูลในตารางการจับคู่ที่โฮสต์โดย Google ต่อไป สามารถใช้ ในกรณีที่ผู้เสนอราคาไม่ได้รับอนุญาตให้โฮสต์รหัสผู้ใช้ Google ใน ตารางจับคู่ของตัวเอง ตัวอย่างง่ายๆ ของเวิร์กโฟลว์ที่มีการปรับปรุงจะสรุปไว้ใน ได้ที่ด้านล่าง

ขั้นตอนที่ 1: Google จะวางแท็กจับคู่

Google จะวางแท็กจับคู่สำหรับผู้เสนอราคาที่เลือกตามอัลกอริทึม แท็กจับคู่ประกอบด้วย พารามิเตอร์ google_push เช่น

<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />

ขั้นตอนที่ 2: เบราว์เซอร์ของผู้ใช้ขอพิกเซลจาก URL การจับคู่อาหารของผู้เสนอราคา

เบราว์เซอร์ของผู้ใช้ขอพิกเซลจาก URL การจับคู่คุกกี้ของผู้เสนอราคา ใส่คุกกี้ของผู้เสนอราคาในส่วนหัว HTTP

ปลายทางการจับคู่คุกกี้ของผู้เสนอราคาต้องเปลี่ยนเส้นทางไปยังคุกกี้ของ Google บริการจับคู่ ซึ่งรวมถึงพารามิเตอร์ google_hm ที่สร้างจาก ข้อมูลคุกกี้ที่เข้ารหัสแบบ Web-safe base64 URL เปลี่ยนเส้นทางอาจมีลักษณะดังนี้ ดังต่อไปนี้:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA

Google จะได้รับการเปลี่ยนเส้นทางที่มีพารามิเตอร์ที่คุณระบุใน เพิ่มคุกกี้ของ Google ในส่วนหัว HTTP หากการดำเนินการคือ การแสดงผลสำหรับผู้ใช้รายนี้ในคำขอราคาเสนอที่ตามมาจะรวม ข้อมูลการจับคู่ที่โฮสต์ไว้ของผู้เสนอราคาใน BidRequest.hosted_match_data สำหรับ โปรโตคอลของ Google หรือ BidRequest.user.buyeruid สำหรับ การใช้งาน OpenRTB ผู้เสนอราคายังสามารถป้อนข้อมูลรายการผู้ใช้โดยใช้ ตรงกับข้อมูลที่ระบุ

สุดท้าย Google จะส่งพิกเซลโปร่งใสขนาด 1x1 ไปยังเบราว์เซอร์ของผู้ใช้

การเสนอราคาแบบเปิดอนุญาตให้ Exchange สามารถใช้ที่เริ่มโดยผู้เสนอราคา และเริ่มโดย Google กระบวนการจับคู่คุกกี้ เพื่อจับคู่รหัสผู้ใช้ Google กับคุกกี้ คุกกี้ Match Assist (CMA) เป็นฟีเจอร์เพิ่มเติมสำหรับการแลกเปลี่ยนที่ช่วยให้ สร้างตารางการจับคู่กับผู้เสนอราคาของตนเอง

  1. เมื่อวางโฆษณา Google จะใช้อัลกอริทึมเลือก Exchange แล้ววางแท็ก Cookie Match Assist ที่มีสิ่งต่อไปนี้ โครงสร้าง:

    <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
  2. แท็กจับคู่ CMA ของ Google จะทำให้ URL การจับคู่คุกกี้ของ Exchange ได้รับคำขอพิกเซล

  3. ปลายทางการจับคู่คุกกี้ของ Exchange ได้รับคำขอ โดยที่ บริการจับคู่คุกกี้ของตัวเองมีหน้าที่จับคู่รหัสผู้ใช้กับ หนึ่งในผู้เสนอราคา ในแผนภาพด้านล่าง การจับคู่คุกกี้ของ Exchange ตอบสนองเบราว์เซอร์ของผู้ใช้ด้วยการเปลี่ยนเส้นทางไปยังผู้เสนอราคา ปลายทาง
  4. ผู้เสนอราคาจะได้รับคำขอพร้อมกับพารามิเตอร์ใดๆ ที่ระบุโดย Exchange เพื่อจับคู่รหัสผู้ใช้กับคุกกี้

ข้อจำกัด

ความถี่สูงสุดของคำขอสำหรับการจับคู่ใหม่

ผู้เสนอราคามีหน้าที่จำกัดจำนวนการเรียกไปยังคุกกี้ บริการจับคู่สำหรับผู้ใช้ที่มีรายการใหม่ในการจับคู่ที่โฮสต์โดย Google รายการในตารางการจับคู่ที่โฮสต์ไว้อาจถือว่าหมดอายุใน 14 วัน ซึ่งสามารถรีเฟรชได้หลังจากนั้น

ตอบกลับคำขอจับคู่พิกเซลทั้งหมด

ผู้เสนอราคาที่ใช้เวิร์กโฟลว์การจับคู่พิกเซลจะต้องตอบกลับ คำขอการจับคู่ Pixel ขาเข้าที่มีการตอบกลับรวมถึง google_push พารามิเตอร์ วิธีนี้ช่วยให้ Google บังคับใช้นโยบายโดยการตรวจสอบการใช้งานได้ หากมี อัตราการตอบกลับของผู้เสนอราคาลดลงต่ำกว่า 90% Google จะจำกัดจำนวน ส่งคำขอจับคู่พิกเซลไปยังบัญชีแล้ว

ใช้ปลายทาง HTTPS

ปลายทางที่ใช้ในเวิร์กโฟลว์การจับคู่คุกกี้ทั้งหมดต้องใช้ HTTPS

เมื่อตอบกลับคำขอจับคู่พิกเซลที่ส่งถึงคุณผ่าน HTTPS คุณจะ จำเป็นต้องเปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ผ่าน HTTPS ในทำนองเดียวกัน ปลายทางตัวช่วยจับคู่คุกกี้ที่เปลี่ยนเส้นทางไปยังผู้เสนอราคาต้องใช้ HTTPS ด้วย หากคุณส่งคำขอไปยัง Google ผ่าน HTTP บ่อยกว่า 1 ครั้งในทุก 2 นาที จำนวนคำขอจับคู่ที่ส่งไปยังบัญชีของคุณจะถูกควบคุม

คำขอจับคู่คุกกี้ที่ขึ้นอยู่กับ ผู้ใช้ EU ของ Google นโยบายความยินยอมควรระบุความยินยอมของผู้ใช้ปลายทาง คำขอดังกล่าวจำเป็นต่อ ระบุว่ามีการรวบรวมความยินยอมโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้

ตัวอย่าง

ตัวอย่างด้านล่างแสดงวิธีใช้บริการจับคู่คุกกี้เพื่อ บรรลุวัตถุประสงค์ที่เจาะจง โปรดทราบว่า เว้นแต่จะระบุไว้เป็นอย่างอื่น สันนิษฐานว่าผู้ใช้ที่ถูกดำเนินการไม่ได้มาจาก รัฐในสหรัฐอเมริกาที่มีข้อจำกัดด้านความเป็นส่วนตัว

สร้างตารางจับคู่ที่โฮสต์โดยผู้เสนอราคา

ผู้เสนอราคาสามารถใช้เวิร์กโฟลว์การจับคู่คุกกี้เพื่อป้อนข้อมูลการจับคู่ของตนเอง โดยระบุเฉพาะ google_nid และ google_cm ไว้ในแท็กจับคู่ ซึ่งอาจมีลักษณะดังนี้

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />

หากตั้งค่า URL การจับคู่คุกกี้ของผู้เสนอราคาเป็น https://ad.network.com/pixel?id=1 และการดำเนินการจับคู่คุกกี้สำเร็จ การเปลี่ยนเส้นทางที่ Google จะส่งไป การตอบกลับแท็กจับคู่ของผู้เสนอราคาอาจมีลักษณะดังนี้

https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

หากการจับคู่คุกกี้ล้มเหลวเนื่องจากผู้ใช้ไม่มี คุกกี้ของ Google คำตอบจะเป็นดังนี้

https://ad.network.com/pixel?id=1&google_error=3

รหัสข้อผิดพลาดจะขึ้นอยู่กับสาเหตุเบื้องหลังของข้อผิดพลาด เพื่อเรียนรู้ ข้อมูลเพิ่มเติมเกี่ยวกับรหัสข้อผิดพลาดที่เป็นไปได้สำหรับเวิร์กโฟลว์การจับคู่คุกกี้ โปรดดู พารามิเตอร์ URL เปลี่ยนเส้นทาง

เพิ่มลงในรายชื่อผู้ใช้รายเดียว

ระบุพารามิเตอร์ google_ula ในการจับคู่ของผู้เสนอราคาได้ เพื่อเพิ่มผู้ใช้ลงในรายชื่อผู้ใช้ด้วยรหัสที่กำหนด หาก Google หรือ ตารางจับคู่ที่โฮสต์โดยผู้เสนอราคามีรายการใหม่สำหรับผู้ใช้ ซึ่งผู้เสนอราคาสามารถวาง แท็กจับคู่ที่มี google_nid และ google_ula เพื่อเพิ่มผู้ใช้ลงในรายการที่ระบุโดยไม่ต้องเริ่มต้น เวิร์กโฟลว์การจับคู่คุกกี้ ดูข้อจำกัด เกี่ยวกับการเรียกใช้บริการจับคู่คุกกี้สำหรับความล่าช้ามากขึ้น ฟิลด์ แท็กจับคู่อาจมีลักษณะดังนี้

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />

สำหรับการตอบกลับที่สำเร็จ โดยที่ URL การจับคู่คุกกี้ของผู้เสนอราคาคือ https://ad.network.com/pixel URL เปลี่ยนเส้นทางของ Google จะเป็น:

https://ad.network.com/pixel?google_ula=12345,0

หากมีข้อผิดพลาดโดยรวม เช่น ไม่มีคุกกี้ของ Google สำหรับผู้ใช้ โดย URL เปลี่ยนเส้นทางจะมี พารามิเตอร์ google_error รายการ:

  • https://ad.network.com/pixel?google_error=3

หากมีข้อผิดพลาดเกี่ยวกับการเพิ่มผู้ใช้ลงในรายการโดยเฉพาะ คุณจะได้รับ google_ula ในการเปลี่ยนเส้นทาง แตกต่างจาก พารามิเตอร์แท็กจับคู่ที่ตรงกัน ซึ่งจะแทนที่การประทับเวลาด้วยสถานะ เพื่อบ่งชี้ความสำเร็จของการดำเนินการ เช่น หากคำขอล้มเหลว เนื่องจากบัญชีผู้เสนอราคาไม่มีสิทธิ์เข้าถึงรายชื่อผู้ใช้ที่ระบุ URL เปลี่ยนเส้นทางจะเป็น

https://ad.network.com/pixel?google_ula=12345,2

เพิ่มลงในรายการผู้ใช้หลายรายการ

ผู้เสนอราคาสามารถระบุได้ว่าควรเพิ่มผู้ใช้ 1 คนลงในรายชื่อผู้ใช้หลายรายการโดยดำเนินการดังนี้ รวมพารามิเตอร์ google_ula หลายรายการในแท็กจับคู่ ใน ในทางปฏิบัติ อาจมีลักษณะดังนี้

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />

สถานะการดำเนินการของรายชื่อผู้ใช้แต่ละรายการจะได้รับการรายงานในลักษณะเดียวกันผ่าน พารามิเตอร์ google_ula ที่แตกต่างกันในการเปลี่ยนเส้นทาง:

https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0

ในการเปลี่ยนเส้นทางด้านบน เราจะเห็นว่าผู้ใช้ดำเนินการสำเร็จ รายการที่มีรหัส 45678 แต่ล้มเหลวสำหรับรหัสรายชื่อผู้ใช้ 12345 เนื่องจากผู้เสนอราคาไม่มีสิทธิ์ในการเข้าถึง

หากต้องการจับคู่คุกกี้และเพิ่มผู้ใช้ลงในรายชื่อผู้ใช้ แท็กจับคู่ของผู้เสนอราคาควรมี google_cm และ google_ula:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />

URL เปลี่ยนเส้นทางที่ระบุโดย Google จะมี google_gid, google_cver และ google_ula ซึ่งอาจมีลักษณะดังนี้ ดังต่อไปนี้:

https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0

การจัดเก็บรายการที่ตรงกันในตารางการจับคู่ที่โฮสต์โดย Google

หากผู้เสนอราคาต้องการจัดเก็บข้อมูลคุกกี้ในตารางจับคู่ที่โฮสต์โดย Google และไม่ต้องการที่จะจัดเก็บการจับคู่กับรหัสผู้ใช้ Google ในการจับคู่ของตนเอง ตาราง แท็กจับคู่ต้องมีพารามิเตอร์ google_hm โดยที่ ค่าต้องเป็นสตริงที่เข้ารหัสแบบ Web-safe base64 สำหรับผู้ใช้ที่ ข้อมูลคุกกี้ที่ไม่ได้เข้ารหัสของผู้เสนอราคาคือ Cookie number 1! ซึ่งเป็นค่าที่เข้ารหัส ค่าจะเป็น Q29va2llIG51bWJlciAxIQ== ซึ่งจะใช้ใน จับคู่แท็กดังตัวอย่างต่อไปนี้

<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />

สำหรับการตอบกลับที่สำเร็จ โดยที่ URL การจับคู่คุกกี้ของผู้เสนอราคาคือ https://cookie-monster.com/pixel, URL เปลี่ยนเส้นทางของ Google จะ เป็น:

https://cookie-monster.com/pixel

พารามิเตอร์ google_gid ไม่อยู่ในการเปลี่ยนเส้นทางเนื่องจาก แท็กจับคู่ไม่มี google_cm และ google_hm มีค่า ไม่รวมอยู่ในคำตอบที่สำเร็จ ในคำขอราคาเสนอสำหรับการแสดงผลในอนาคต สำหรับผู้ใช้รายนี้ ผู้เสนอราคาจะได้รับข้อมูลการจับคู่ที่โฮสต์ไว้ใน BidRequest.hosted_match_dataสำหรับโปรโตคอล RTB ของ Google หรือ BidRequest.user.buyeruid สำหรับการใช้งาน OpenRTB ของ Google

หากผู้เสนอราคาใช้แท็กจับคู่แทนโดยมีค่า google_hm ไม่ได้เข้ารหัส base64 เช่น chocolate_chunk! URL เปลี่ยนเส้นทางอาจมีลักษณะดังนี้ ดังต่อไปนี้:

https://cookie-monster.com/pixel?google_hm=2

URL เปลี่ยนเส้นทางด้านบนมีค่า google_hm เป็น 2 ซึ่งแนะนำว่าการดำเนินการล้มเหลวเนื่องจากค่า ไม่ถูกถอดรหัส

ผู้เสนอราคาและตารางจับคู่ที่โฮสต์โดย Google ที่มีรายชื่อผู้ใช้

ในกรณีที่ผู้เสนอราคาโฮสต์รายการการใช้งานของตนเอง นอกเหนือจากผู้ใช้ที่โฮสต์โดย Google และต้องการให้แท็กที่ตรงกันเพียงแท็กเดียวจับคู่กับทั้ง 2 ตาราง และเพิ่มผู้ใช้ไปยัง รายการผู้ใช้ที่กำหนด แท็กจับคู่ต้องมี google_cm google_hm และพารามิเตอร์ google_ula รายการ หากผู้เสนอราคา ข้อมูลคุกกี้คือ Cookie number 1! ค่าที่เข้ารหัสจะเป็น Q29va2llIG51bWJlciAxIQ== ซึ่งจะสร้างแท็กจับคู่อย่างเช่น ดังต่อไปนี้:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />

สำหรับการตอบกลับที่สำเร็จ โดยที่ URL การจับคู่คุกกี้ของผู้เสนอราคาคือ https://cookie-monster.com/pixel, URL เปลี่ยนเส้นทางของ Google จะ ซึ่งมีลักษณะดังต่อไปนี้

https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0

เมื่อได้รับการเปลี่ยนเส้นทาง ผู้เสนอราคาสามารถจับคู่ User ID ของ Google ที่ระบุได้ ใน google_gid ด้วยข้อมูลคุกกี้ในตารางการจับคู่ ใน นอกจากนี้ยังระบุได้ว่าตารางจับคู่และรายชื่อผู้ใช้ที่โฮสต์โดย Google การดำเนินงานเป็นผลสำเร็จ ดังนั้น การกำหนดเป้าหมายล่วงหน้าใดๆ ให้กับผู้เสนอราคา ซึ่งกำหนดค่าให้กำหนดเป้าหมายรหัสรายชื่อผู้ใช้ที่ระบุ ได้รับคำขอราคาเสนอสำหรับการแสดงผลจากผู้ใช้ ในทำนองเดียวกัน ในราคาเสนอเหล่านี้ ผู้เสนอราคาจะได้รับข้อมูลการจับคู่ที่โฮสต์ไว้ใน BidRequest.hosted_match_dataสำหรับโปรโตคอล RTB ของ Google หรือ BidRequest.user.buyeruid สำหรับการใช้งาน OpenRTB ของ Google