การจับคู่คุกกี้ คือคุณลักษณะที่ช่วยให้คุณสามารถจับคู่คุกกี้ของคุณ ตัวอย่างเช่น รหัสสำหรับผู้ใช้ที่เรียกดูเว็บไซต์ของคุณโดยมีรหัส รหัสผู้ใช้ 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 | &google_gid=GOOGLE_USER_ID |
GOOGLE_CVER | COOKIE_VERSION_NUMBER |
GOOGLE_CVER_PAIR | &cver=COOKIE_VERSION_NUMBER |
GOOGLE_ERROR | ERROR_ID |
GOOGLE_ERROR_PAIR | &google_error=ERROR_ID |
GOOGLE_PUSH | PIXEL_MATCH_DATA |
GOOGLE_PUSH_PAIR | &google_push=PIXEL_MATCH_DATA |
GOOGLE_ALL_PARAMS | google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&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 ทาง
การจับคู่คุกกี้แบบ 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
ไม่มีเนื้อหา
แผนภาพเวิร์กโฟลว์การจับคู่คุกกี้
ขั้นตอนการทำงานนี้จะแสดงตามแผนภาพด้านล่าง ซึ่งจะแสดงคำขอและ คำตอบจะแสดงด้วยลูกศรและรายการข้อมูลที่อยู่ข้างคำตอบ แสดงอยู่ในวงเล็บ
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=19&hl=th)
จับคู่พารามิเตอร์ URL ของแท็ก
พารามิเตอร์ | คำอธิบาย |
---|---|
google_nid |
รหัสเครือข่าย (NID) สำหรับบัญชีผู้เสนอราคา ดึงข้อมูลรหัสนี้ได้ ผ่านผู้เสนอราคา ทรัพยากร |
google_cm |
ระบุต่อบริการจับคู่คุกกี้ของ Google ว่าเครื่องมือนี้จะทำงาน การจับคู่คุกกี้ ค่าพารามิเตอร์จะถูกละเว้นและอาจ ละเว้น |
google_sc |
พารามิเตอร์นี้เลิกใช้งานแล้ว ตั้งค่าคุกกี้ของ Google สำหรับฟังก์ชัน ผู้ใช้ หากไม่มีอยู่ ค่าพารามิเตอร์จะถูกละเว้นและอาจ ละเว้น การละเว้นพารามิเตอร์จะส่งผลให้เกิดข้อผิดพลาดหากไม่มีคุกกี้ มีอยู่ |
google_no_sc |
พารามิเตอร์นี้เลิกใช้งานแล้ว สิ่งนี้แสดงถึง บริการจับคู่คุกกี้ที่ไม่ควรตั้งค่าคุกกี้สำหรับผู้ใช้ในกรณีที่ หนึ่งรูปไม่มีอยู่ ค่าพารามิเตอร์จะถูกละเว้นและอาจ ละเว้น |
google_hm |
ข้อมูลที่ผู้เสนอราคาต้องการจัดเก็บไว้ในตารางจับคู่ที่โฮสต์โดย Google
ค่านี้เป็นสตริงที่เข้ารหัสแบบ Web-safe base64 (ไม่บังคับระยะห่างจากขอบ) ข้อมูลดิบต้องเป็น 40
ไบต์หรือน้อยกว่า เช่น |
google_redir |
สตริงที่เข้ารหัส URL ซึ่งผู้เสนอราคาสามารถระบุหากต้องการกําหนดโดยตรง
Google จะส่งการเปลี่ยนเส้นทาง HTTP 302 ไปยัง URL ที่เข้ารหัสสำหรับ
แท็กจับคู่นี้ ซึ่งช่วยให้วาง Google ไว้ที่ด้านหน้าเป็นห่วงโซ่
โทรหาพาร์ทเนอร์ ซึ่งจะทำให้เกิดข้อผิดพลาดหากระบุไว้โดยไม่ระบุ
google_hm หรือด้วย google_cm |
google_ula |
สตริงที่ใช้ในการเพิ่มผู้ใช้ลงในรายชื่อผู้ใช้ที่มีอยู่ ค่าของ
รูปแบบที่คาดไว้คือ userlistid[,timestamp]
อาจมีพารามิเตอร์ของ URL นี้ซ้ำเพื่อเพิ่มผู้ใช้ลงใน รายการ |
gdpr |
ระบุว่าคำขออยู่ภายใต้ข้อจำกัดเกี่ยวกับข้อมูลตาม GDPR
ดูรายละเอียดเพิ่มเติมได้ที่
ข้อกําหนดด้านความยินยอมของผู้ใช้ EU ด้านล่าง หรือผลกระทบต่อการจับคู่คุกกี้
ใน
เอกสารประกอบเกี่ยวกับ TCF เวอร์ชัน 2.0 ของ Authorized Buyers
เช่น |
gdpr_consent |
สตริง TC ที่แสดงความยินยอมของผู้ใช้ปลายทาง สำหรับรายละเอียดเพิ่มเติม ดูข้อกำหนดความยินยอมของผู้ใช้ EU ด้านล่าง หรือระบบจะส่งสตริง TC อย่างไรใน เอกสารประกอบเกี่ยวกับ TCF เวอร์ชัน 2.0 ของ Authorized Buyers |
process_consent |
ระบุว่าผู้เสนอราคาได้รับความยินยอมจากผู้ใช้ปลายทางสำหรับการใช้ข้อมูลที่ระบุใน
นโยบายความยินยอมของผู้ใช้ EU ของ Google
หากคำขอไม่ได้อยู่ภายใต้นโยบายความยินยอมของผู้ใช้ EU หรือหากมี
มีพารามิเตอร์ความยินยอมอื่นๆ ที่พร้อมใช้งานในคำขอหรือไม่
( เช่น |
นอกเหนือจากพารามิเตอร์ข้างต้นแล้ว ผู้เสนอราคาสามารถระบุพารามิเตอร์ของตัวเอง
จะเพิ่มเป็นพารามิเตอร์ต่อท้าย 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_hm |
แสดงเฉพาะในกรณีที่พยายามเขียนไปยังตารางจับคู่ที่โฮสต์โดย Google ล้มเหลว เมื่อเกิดเหตุการณ์นี้ขึ้น ค่าของรหัสจะเป็นรหัสสถานะอย่างใดอย่างหนึ่งต่อไปนี้
|
google_ula |
สถานะของการดำเนินการเพิ่มรายชื่อผู้ใช้ ทำซ้ำหาก ตัวอย่าง: การดำเนินการ
|
สถานการณ์ตัวอย่างเวิร์กโฟลว์การจับคู่คุกกี้
สถานการณ์ต่อไปนี้อธิบายลักษณะของการจับคู่คุกกี้ ผู้ใช้ทั่วไปที่เรียกดูหน้าเว็บ
สถานการณ์ที่ 1: ผู้ใช้ล้างคุกกี้และเรียกดูเว็บไซต์
เจนจิราล้างแคชและคุกกี้ทั้งหมด จากนั้นผู้ใช้จึงไปที่หน้าแรกของ ExampleNews.com
ต่อไปนี้คือสิ่งที่เกิดขึ้น:
- ExampleNews.com แสดงผลและเรียกโฆษณาจาก Google (Ad Manager)
- เนื่องจากหน่วยโฆษณามีสิทธิ์สำหรับการจัดสรรแบบไดนามิก Google จะส่งราคาเสนอ คำขอไปยัง FinestDSP และผู้เสนอราคารายอื่นๆ ผ่านบริการการเสนอราคาแบบเรียลไทม์
- แอปพลิเคชันผู้เสนอราคาของ FinestDSP ได้รับและดำเนินการกับคำขอราคาเสนอ แล้วส่งการเสนอราคาตอบของตัวเอง
- Google จะได้รับการเสนอราคาตอบจากผู้เสนอราคา รวมถึงการเสนอราคาตอบของ FinestDSP ที่ระบุโฆษณาที่มีแท็กจับคู่ (พิกเซล)
- FinestDSP ชนะการประมูล Google แสดงโฆษณาและแท็กจับคู่ของ FinestDSP ชื่อบุคคล
- แท็กจับคู่จะเรียกบริการจับคู่คุกกี้ของ Google โดยระบุ
พารามิเตอร์
google_nid
และgoogle_cm
- บริการจับคู่คุกกี้อ่านคุกกี้ของ Google แล้วส่งคุกกี้ของเจน
เปลี่ยนเส้นทางไปยัง URL จับคู่คุกกี้ของ FinestDSP ที่ตั้งค่าเป็น
ตั้งค่าพารามิเตอร์
google_user_id
และgoogle_cver
แล้ว - เบราว์เซอร์ของเจนโหลดการเปลี่ยนเส้นทางไปยัง URL การจับคู่คุกกี้ของ FinestDSP
- ปลายทางการจับคู่คุกกี้ของ FinestDSP จะประมวลผลคำขอเปลี่ยนเส้นทาง
ซึ่งมีพารามิเตอร์ของ URL ที่ Google กําหนด และคุกกี้สําหรับเจนใน
ส่วนหัว HTTP ตอนนี้ FinestDSP สามารถจัดเก็บการแมปคุกกี้ของพวกเขาไปยังฟังก์ชัน
google_user_id
ในตารางการจับคู่ - FinestDSP ตอบสนองต่อการเปลี่ยนเส้นทางด้วยพิกเซล 1x1 ที่มองไม่เห็น
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=19&hl=th)
สถานการณ์ที่ 2: ผู้ใช้ที่มีการแมปอยู่แล้ว
หนึ่งสัปดาห์หลังจากสถานการณ์ 1 เจนไปที่ ExampleNews.com อีกครั้ง ตอนนี้เจนจิรา มีทั้งผู้เสนอราคาและคุกกี้ Ad Manager ในเครื่องของตน นี่คือวิธีการจับคู่
- หน้าเว็บแสดงผล ซึ่งทำให้ Google (Ad Manager) ขอโฆษณาที่ จะแสดงผลในหน้าเว็บ
- ระหว่างการประมูลเพื่อแสดงโฆษณา Google จะส่งคำขอราคาเสนอไปยังผู้เสนอราคาที่เกี่ยวข้อง รวมทั้ง FinestDSP
- FinestDSP จะได้รับคำขอราคาเสนอ ซึ่งรวมถึงสัญญาณต่างๆ เช่น
google_user_id
- FinestDSP จะค้นหา
google_user_id
ในตารางการจับคู่ แล้วพบคุกกี้ที่เชื่อมโยงกับเจน ที่สร้างไว้เมื่อ 1 สัปดาห์ก่อนหน้า (ในสถานการณ์ 1) - การเสนอราคาของ FinestDSP ตามข้อมูลที่เชื่อมโยงกับคุกกี้ จะเสนอราคาให้กับการแสดงผลและชนะการประมูล
- Jane อาจเห็นโฆษณาที่ปรับแต่งตามความสนใจของตนตามข้อมูล ที่มีใน FinestDSP
เริ่มโดยผู้เสนอราคา: การจับคู่คุกกี้แบบทิศทางเดียว
การจับคู่คุกกี้แบบทิศทางเดียวนั้นคล้ายคลึงกับขั้นตอนการทำงานแบบสองทิศทาง
เว้นแต่ว่าจะมีการปรับเปลี่ยนให้มีเพียงโฮสต์ของ Google เท่านั้นและป้อนข้อมูลที่ตรงกัน
ใช้ในกรณีที่ผู้เสนอราคาไม่ได้รับอนุญาตให้โฮสต์
รหัสผู้ใช้ Google ในตารางการจับคู่ของตัวเอง หากต้องการใช้ขั้นตอนนี้ ผู้เสนอราคา
ต้องอนุญาตให้ Google โฮสต์ตารางการจับคู่ ไม่สามารถระบุได้อีกต่อไป
google_cm
ในคำขอไปยังบริการจับคู่คุกกี้ของ Google และ
จะไม่ได้รับ google_gid
เพื่อป้อนข้อมูลของตัวเอง
ตารางที่ตรงกัน เมื่อ Google จับคู่ผู้ใช้แล้ว ผู้เสนอราคาจะเพิ่ม
ลงในรายการผู้ใช้โดยใช้ข้อมูลคุกกี้ของตนเอง ในทำนองเดียวกัน คำขอราคาเสนอสำหรับ
ผู้ใช้เหล่านี้จะยกเว้นรหัสผู้ใช้ Google แต่จะรวมข้อมูลการจับคู่ที่โฮสต์ไว้ ต
ตัวอย่างง่ายๆ ของเวิร์กโฟลว์ที่ปรับปรุงใหม่จะสรุปไว้ในขั้นตอนด้านล่าง
ขั้นตอนที่ 1: วางแท็กจับคู่ซึ่งนำไปยัง URL การจับคู่คุกกี้ของผู้เสนอราคา
ในการเริ่มต้นขั้นตอนนี้ ผู้เสนอราคาจะต้องวางแท็กที่ตรงกันเพื่อให้
แสดงผลในเบราว์เซอร์ของผู้ใช้ ซึ่งต่างจากเวิร์กโฟลว์สำหรับผู้ใช้ที่ไม่ได้มาจากรัฐในสหรัฐอเมริกาที่มีข้อจำกัดด้านความเป็นส่วนตัว
แท็กจับคู่ต้องกำหนดเส้นทางเบราว์เซอร์ของผู้ใช้ไปยังคุกกี้ของคุณ
URL ที่ตรงกัน ตัวอย่างเช่น URL จับคู่คุกกี้ที่กำหนดค่าเป็น
https://ad.network.com/pixel
จะมีหน้าตาดังนี้
<img src="https://ad.network.com/pixel" />
เมื่อโหลดในเบราว์เซอร์ของผู้ใช้ ผู้เสนอราคาจะขอพิกเซลจากการเสนอราคา URL การจับคู่คุกกี้ คำขอนี้จะมีคุกกี้ของผู้ใช้เหล่านั้นในส่วนหัว HTTP ซึ่งควรแยกออกมาสำหรับขั้นตอนถัดไป
ขั้นตอนที่ 2: เปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ของ Google
ปลายทางการจับคู่คุกกี้ของผู้เสนอราคาต้องเปลี่ยนเส้นทางไปยังคุกกี้ของ Google
บริการจับคู่ ซึ่งรวมถึงพารามิเตอร์ google_hm
ที่สร้างจาก
ข้อมูลคุกกี้ที่เข้ารหัสแบบ Web-safe base64 URL เปลี่ยนเส้นทางอาจมีลักษณะดังนี้
ดังต่อไปนี้:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
ขั้นตอนที่ 3: เบราว์เซอร์ของผู้ใช้จะถูกเปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ของ Google
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" />
ขั้นตอนที่ 5: เบราว์เซอร์ของผู้ใช้เปลี่ยนเส้นทางไปยัง URL รายงานการจับคู่คุกกี้ของผู้เสนอราคา
เบราว์เซอร์ของผู้ใช้จะเปลี่ยนเส้นทางไปยัง URL รายงานการจับคู่คุกกี้ของผู้เสนอราคา
รวมถึงสาเหตุของข้อผิดพลาด (หากมี) ที่ระบุโดย Google ใน
พารามิเตอร์ google_error
ดูข้อมูลเพิ่มเติมเกี่ยวกับการตีความข้อผิดพลาด
โปรดดูคำอธิบายพารามิเตอร์
ขั้นตอนที่ 6: ผู้เสนอราคาแสดงพิกเซลโปร่งใสขนาด 1x1
ผู้เสนอราคาต้องตอบกลับโดยแสดงพิกเซลโปร่งใสขนาด 1x1 ต่อผู้ใช้ เบราว์เซอร์
แผนภาพเวิร์กโฟลว์การจับคู่คุกกี้สําหรับผู้ใช้จากรัฐในสหรัฐอเมริกาที่มีข้อจํากัดด้านความเป็นส่วนตัว
แผนภาพแสดงเวิร์กโฟลว์เริ่มต้นสำหรับผู้ใช้ในรัฐในสหรัฐอเมริกาที่มีข้อจำกัดด้านความเป็นส่วนตัว ด้านล่าง โดยที่คำขอและการตอบกลับแสดงด้วยลูกศร และข้อมูล รายการที่ปรากฏพร้อมกันจะอยู่ในวงเล็บ
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=19&hl=th)
พารามิเตอร์ของ URL สำหรับผู้เสนอราคาเปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ของ Google
พารามิเตอร์ | คำอธิบาย |
---|---|
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]
อาจมีพารามิเตอร์ของ URL นี้ซ้ำเพื่อเพิ่มผู้ใช้ลงใน รายการ |
gdpr |
ระบุว่าคำขออยู่ภายใต้ข้อจำกัดเกี่ยวกับข้อมูลตาม GDPR
ดูรายละเอียดเพิ่มเติมได้ที่
ข้อกําหนดด้านความยินยอมของผู้ใช้ EU ด้านล่าง หรือผลกระทบต่อการจับคู่คุกกี้
ใน
เอกสารประกอบเกี่ยวกับ TCF เวอร์ชัน 2.0 ของ Authorized Buyers
เช่น |
gdpr_consent |
สตริง TC ที่แสดงความยินยอมของผู้ใช้ปลายทาง สำหรับรายละเอียดเพิ่มเติม ดูข้อกำหนดความยินยอมของผู้ใช้ EU ด้านล่าง หรือระบบจะส่งสตริง TC อย่างไรใน เอกสารประกอบเกี่ยวกับ TCF เวอร์ชัน 2.0 ของ Authorized Buyers |
process_consent |
ระบุว่าผู้เสนอราคาได้รับความยินยอมจากผู้ใช้ปลายทางสำหรับการใช้ข้อมูลที่ระบุใน
นโยบายความยินยอมของผู้ใช้ EU ของ Google
หากคำขอไม่ได้อยู่ภายใต้นโยบายความยินยอมของผู้ใช้ EU หรือหากมี
มีพารามิเตอร์ความยินยอมอื่นๆ ที่พร้อมใช้งานในคำขอหรือไม่
( เช่น |
พารามิเตอร์ URL สำหรับ Google เปลี่ยนเส้นทางไปยัง URL รายงานการจับคู่คุกกี้ของผู้เสนอราคา
พารามิเตอร์ | คำอธิบาย |
---|---|
google_error |
ค่าจำนวนเต็มที่ระบุข้อผิดพลาดโดยรวมของคำขอ วันและเวลา
ที่ได้รับ ระบุว่าไม่มีการดำเนินการใดๆ และไม่มีการดำเนินการอื่นๆ
ระบบจะตั้งค่าพารามิเตอร์การตอบสนอง
|
ริเริ่มโดย 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" />
ขั้นตอนที่ 2: ผู้เสนอราคาต้องตอบกลับด้วยการเปลี่ยนเส้นทางไปยัง URL บริการจับคู่คุกกี้ของ Google
ผู้เสนอราคาที่ได้รับคำขอจับคู่พิกเซลจะต้องตอบกลับ เปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ของ 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
แผนภาพเวิร์กโฟลว์การจับคู่พิกเซล
ขั้นตอนการทำงานนี้จะแสดงตามแผนภาพด้านล่าง ซึ่งจะแสดงคำขอและ คำตอบจะแสดงด้วยลูกศรและรายการข้อมูลที่อยู่ข้างคำตอบ แสดงอยู่ในวงเล็บ
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=19&hl=th)
พารามิเตอร์คำขอแท็กจับคู่ของ Google
พารามิเตอร์ | คำอธิบาย |
---|---|
google_gid |
รหัสผู้ใช้ Google สำหรับผู้ใช้ที่ไม่ได้อยู่ในรัฐในสหรัฐอเมริกาที่มีข้อจำกัดด้านความเป็นส่วนตัว การยืนยันนี้จะเป็น ที่ระบุในแท็กจับคู่ของ Google |
google_cver |
เวอร์ชันของคุกกี้ ชื่อนี้จะระบุเสมอในการจับคู่ของ Google แท็ก |
google_push |
ระบุว่าคำขอนี้กำลังเริ่มต้นเวิร์กโฟลว์การจับคู่พิกเซล ค่านี้ต้องส่งผ่านพารามิเตอร์ที่เกี่ยวข้องในการเสนอราคา การตอบกลับการเปลี่ยนเส้นทาง |
พารามิเตอร์การเปลี่ยนเส้นทางการจับคู่พิกเซลของผู้เสนอราคา
พารามิเตอร์ | คำอธิบาย |
---|---|
google_nid |
รหัสเครือข่าย (NID) สำหรับบัญชีผู้เสนอราคา ดึงข้อมูลรหัสนี้ได้ ผ่านผู้เสนอราคา ทรัพยากร |
google_push |
ระบุว่าการเปลี่ยนเส้นทางนี้ทำให้การจับคู่พิกเซลเสร็จสมบูรณ์ ค่าจากแท็กจับคู่ของ Google ที่เกี่ยวข้องต้องเป็น ที่ระบุไว้ที่นี่ |
google_hm |
มีข้อมูลที่ผู้เสนอราคาต้องการจัดเก็บไว้ในการจับคู่ที่โฮสต์โดย Google |
google_ula |
สตริงที่ใช้ในการเพิ่มผู้ใช้ลงในรายชื่อผู้ใช้ที่มีอยู่ ค่าของ
รูปแบบที่คาดไว้คือ userlistid[,timestamp]
อาจมีพารามิเตอร์ของ 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
ขั้นตอนที่ 3: เปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ของ Google
ปลายทางการจับคู่คุกกี้ของผู้เสนอราคาต้องเปลี่ยนเส้นทางไปยังคุกกี้ของ 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
ขั้นตอนที่ 4: เบราว์เซอร์ของผู้ใช้จะถูกเปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ของ Google
Google จะได้รับการเปลี่ยนเส้นทางที่มีพารามิเตอร์ที่คุณระบุใน
เพิ่มคุกกี้ของ Google ในส่วนหัว HTTP หากการดำเนินการคือ
การแสดงผลสำหรับผู้ใช้รายนี้ในคำขอราคาเสนอที่ตามมาจะรวม
ข้อมูลการจับคู่ที่โฮสต์ไว้ของผู้เสนอราคาใน BidRequest.hosted_match_data
สำหรับ
โปรโตคอลของ Google หรือ BidRequest.user.buyeruid
สำหรับ
การใช้งาน OpenRTB ผู้เสนอราคายังสามารถป้อนข้อมูลรายการผู้ใช้โดยใช้
ตรงกับข้อมูลที่ระบุ
สุดท้าย Google จะส่งพิกเซลโปร่งใสขนาด 1x1 ไปยังเบราว์เซอร์ของผู้ใช้
ตัวช่วยจับคู่คุกกี้
การเสนอราคาแบบเปิดอนุญาตให้ Exchange สามารถใช้ที่เริ่มโดยผู้เสนอราคา และเริ่มโดย Google กระบวนการจับคู่คุกกี้ เพื่อจับคู่รหัสผู้ใช้ Google กับคุกกี้ คุกกี้ Match Assist (CMA) เป็นฟีเจอร์เพิ่มเติมสำหรับการแลกเปลี่ยนที่ช่วยให้ สร้างตารางการจับคู่กับผู้เสนอราคาของตนเอง
วิธีการทำงานของ Cookie Match Assist
เมื่อวางโฆษณา Google จะใช้อัลกอริทึมเลือก Exchange แล้ววางแท็ก Cookie Match Assist ที่มีสิ่งต่อไปนี้ โครงสร้าง:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
แท็กจับคู่ CMA ของ Google จะทำให้ URL การจับคู่คุกกี้ของ Exchange ได้รับคำขอพิกเซล
- ปลายทางการจับคู่คุกกี้ของ Exchange ได้รับคำขอ โดยที่ บริการจับคู่คุกกี้ของตัวเองมีหน้าที่จับคู่รหัสผู้ใช้กับ หนึ่งในผู้เสนอราคา ในแผนภาพด้านล่าง การจับคู่คุกกี้ของ Exchange ตอบสนองเบราว์เซอร์ของผู้ใช้ด้วยการเปลี่ยนเส้นทางไปยังผู้เสนอราคา ปลายทาง
- ผู้เสนอราคาจะได้รับคำขอพร้อมกับพารามิเตอร์ใดๆ ที่ระบุโดย Exchange เพื่อจับคู่รหัสผู้ใช้กับคุกกี้
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=19&hl=th)
ข้อจำกัด
ความถี่สูงสุดของคำขอสำหรับการจับคู่ใหม่
ผู้เสนอราคามีหน้าที่จำกัดจำนวนการเรียกไปยังคุกกี้ บริการจับคู่สำหรับผู้ใช้ที่มีรายการใหม่ในการจับคู่ที่โฮสต์โดย Google รายการในตารางการจับคู่ที่โฮสต์ไว้อาจถือว่าหมดอายุใน 14 วัน ซึ่งสามารถรีเฟรชได้หลังจากนั้น
ตอบกลับคำขอจับคู่พิกเซลทั้งหมด
ผู้เสนอราคาที่ใช้เวิร์กโฟลว์การจับคู่พิกเซลจะต้องตอบกลับ
คำขอการจับคู่ Pixel ขาเข้าที่มีการตอบกลับรวมถึง google_push
พารามิเตอร์ วิธีนี้ช่วยให้ Google บังคับใช้นโยบายโดยการตรวจสอบการใช้งานได้ หากมี
อัตราการตอบกลับของผู้เสนอราคาลดลงต่ำกว่า 90% Google จะจำกัดจำนวน
ส่งคำขอจับคู่พิกเซลไปยังบัญชีแล้ว
ใช้ปลายทาง HTTPS
ปลายทางที่ใช้ในเวิร์กโฟลว์การจับคู่คุกกี้ทั้งหมดต้องใช้ HTTPS
เมื่อตอบกลับคำขอจับคู่พิกเซลที่ส่งถึงคุณผ่าน HTTPS คุณจะ จำเป็นต้องเปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ผ่าน HTTPS ในทำนองเดียวกัน ปลายทางตัวช่วยจับคู่คุกกี้ที่เปลี่ยนเส้นทางไปยังผู้เสนอราคาต้องใช้ HTTPS ด้วย หากคุณส่งคำขอไปยัง Google ผ่าน HTTP บ่อยกว่า 1 ครั้งในทุก 2 นาที จำนวนคำขอจับคู่ที่ส่งไปยังบัญชีของคุณจะถูกควบคุม
ข้อกำหนดความยินยอมของผู้ใช้ EU
คำขอจับคู่คุกกี้ที่ขึ้นอยู่กับ ผู้ใช้ EU ของ Google นโยบายความยินยอมควรระบุความยินยอมของผู้ใช้ปลายทาง คำขอดังกล่าวจำเป็นต่อ ระบุว่ามีการรวบรวมความยินยอมโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้
- TCFv2: รวมถึง
gdpr
และgdpr_consent
พารามิเตอร์ ดูรายละเอียดได้ที่ เอกสารประกอบเกี่ยวกับ TCF เวอร์ชัน 2.0 ของ Authorized Buyers process_consent
: การประกาศว่าผู้เสนอราคาได้รับแล้ว คำยินยอมที่จำเป็นจากผู้ใช้
ตัวอย่าง
ตัวอย่างด้านล่างแสดงวิธีใช้บริการจับคู่คุกกี้เพื่อ บรรลุวัตถุประสงค์ที่เจาะจง โปรดทราบว่า เว้นแต่จะระบุไว้เป็นอย่างอื่น สันนิษฐานว่าผู้ใช้ที่ถูกดำเนินการไม่ได้มาจาก รัฐในสหรัฐอเมริกาที่มีข้อจำกัดด้านความเป็นส่วนตัว
สร้างตารางจับคู่ที่โฮสต์โดยผู้เสนอราคา
ผู้เสนอราคาสามารถใช้เวิร์กโฟลว์การจับคู่คุกกี้เพื่อป้อนข้อมูลการจับคู่ของตนเอง
โดยระบุเฉพาะ 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