การจับคู่คุกกี้เป็นฟีเจอร์ที่ทำให้คุณสามารถจับคู่คุกกี้ได้ เช่น รหัสสำหรับผู้ใช้ที่เรียกดูเว็บไซต์ของคุณ กับรหัสผู้ใช้ Google สำหรับผู้เสนอราคาที่เกี่ยวข้องโดยเฉพาะ และสร้างรายชื่อผู้ใช้ที่ช่วยคุณในการตัดสินใจเลือกการเสนอราคาที่มีประสิทธิภาพมากยิ่งขึ้น คู่มือนี้อธิบายแนวคิดที่ใช้ในการจับคู่คุกกี้ รวมถึงเวิร์กโฟลว์การจับคู่คุกกี้แบบต่างๆ และรูปแบบต่างๆ ที่อาจใช้กับบางกรณี
แนวคิด
การจับคู่คุกกี้คืออะไร
โดยปกติแล้ว เจ้าของโดเมนจะตั้งค่าเนื้อหาของคุกกี้สําหรับผู้ใช้ที่เรียกดูเว็บไซต์ของตน ซึ่งจะใช้เพื่อระบุผู้ใช้ภายในโดเมนนั้น แม้ว่าเจ้าของโดเมน 2 รายจะตกลงที่จะแลกเปลี่ยนข้อมูลนี้ แต่รูปแบบการรักษาความปลอดภัยของเบราว์เซอร์อินเทอร์เน็ตจะจํากัดไม่ให้อ่านคุกกี้ที่โดเมนอื่นตั้งไว้
ในบริบทของการโฆษณาดิจิทัล Google จะระบุผู้ใช้ด้วยคุกกี้ที่เป็นของโดเมน doubleclick.net
และผู้เสนอราคาที่เข้าร่วมการเสนอราคาแบบเรียลไทม์อาจมีโดเมนของตนเองเพื่อระบุกลุ่มผู้ใช้ที่ต้องการแสดงโฆษณา การจับคู่คุกกี้ช่วยให้ผู้เสนอราคาจับคู่คุกกี้ของตนเองกับของ Google ได้ เพื่อพิจารณาว่าการแสดงผลที่ส่งในคําขอราคาเสนอเชื่อมโยงกับผู้ใช้รายใดรายหนึ่งที่กำหนดเป้าหมายหรือไม่ ผู้เสนอราคาจะได้รับข้อมูลคุกกี้ของตนเองหรือรหัสผู้ใช้ Google เฉพาะของผู้เสนอราคา ซึ่งเป็นรูปแบบที่เข้ารหัสของคุกกี้ doubleclick.net
ในคําขอราคาเสนอ
บริการการจับคู่คุกกี้ที่อธิบายไว้ในคู่มือนี้ช่วยสร้างและดูแลรักษาการเชื่อมโยงระหว่างคุกกี้ของผู้เสนอราคากับรหัสผู้ใช้ Google รวมถึงช่วยให้สร้างรายการผู้ใช้ได้
ตารางที่ตรงกัน
ตารางการจับคู่สามารถใช้เพื่อจับคู่รหัสหรือข้อมูลอื่นๆ จากโดเมนหนึ่งกับอีกโดเมนหนึ่ง ผู้เสนอราคาสามารถใช้บริการจับคู่คุกกี้เพื่อป้อนข้อมูลตารางการจับคู่ของตนเองโดยการแมปคุกกี้สำหรับผู้ใช้ที่ระบุกับรหัสผู้ใช้ Google ของผู้ใช้ หรือสร้างตารางจับคู่ที่โฮสต์โดย Google ตารางการจับคู่เป็นสิ่งจําเป็นสําหรับแอปพลิเคชันผู้เสนอราคาของผู้เสนอราคาในการเข้าถึงข้อมูลคุกกี้สําหรับผู้ใช้ที่แสดงการแสดงผล
ตารางการจับคู่ที่โฮสต์โดย Google
เราขอแนะนำให้คุณอนุญาตให้ Google โฮสต์ตารางการจับคู่เพื่อให้การบำรุงรักษาง่ายขึ้น ปรับปรุงเวลาในการตอบสนอง และเข้าถึงข้อมูลการจับคู่สำหรับผู้ใช้ในบางภูมิภาค ซึ่งจะช่วยให้คุณระบุสตริงที่เข้ารหัส Base64 ซึ่งใช้กับเว็บได้ (ต่อไปนี้จะเรียกว่าข้อมูลการจับคู่ที่โฮสต์) ที่จะแมปกับรหัสผู้ใช้ Google ของผู้ใช้รายหนึ่งๆ เมื่อสร้างการจับคู่แล้ว คุณจะนำไปใช้ได้ดังนี้
การเสนอราคาแบบเรียลไทม์: ในคําขอราคาเสนอการแสดงผลที่เชื่อมโยงกับผู้ใช้ในภายหลัง Google จะส่งข้อมูลการจับคู่ที่โฮสต์ซึ่งคุณจับคู่กับรหัสผู้ใช้ Google ของผู้ใช้รายนั้น ในการใช้งาน OpenRTB ของ Google
BidRequest.user.buyeruid
จะระบุสตริงนี้เป็นสตริงที่เข้ารหัสแบบ base64 สำหรับใช้งานในเว็บ หากปลายทางการเสนอราคาได้รับการกําหนดค่าให้ใช้โปรโตคอล RTB ของ Google ที่เลิกใช้งานแล้ว คุณจะได้รับข้อมูลนี้ในรูปแบบไบต์ที่ถอดรหัสแล้วผ่านช่องBidRequest.hosted_match_data
รายการผู้ใช้: รายการผู้ใช้จะสร้างได้โดยใช้รหัสผู้ใช้ Google หรือข้อมูลการจับคู่ที่โฮสต์
- การกำหนดเป้าหมายล่วงหน้า: คุณสามารถกําหนดค่าการกําหนดเป้าหมายล่วงหน้าเพื่อให้ได้รับเฉพาะคําขอราคาเสนอที่มีข้อมูลการจับคู่ที่โฮสต์เท่านั้น ซึ่งสามารถใช้เพื่อกรองการแสดงผลที่มีความเกี่ยวข้องน้อยลงสําหรับผู้ใช้ที่อยู่นอกพื้นที่คุกกี้
รายการผู้ใช้
คุณสร้างและจัดการรายการผู้ใช้ได้ด้วย Real-Time Bidding API เมื่อสร้างแล้ว คุณสามารถป้อนข้อมูลรายการเหล่านี้ด้วยเวิร์กโฟลว์การจับคู่คุกกี้ที่อธิบายไว้ด้านล่าง หรือผ่านบริการการอัปโหลดหลายรายการพร้อมกัน
เริ่มต้นใช้งาน
หากต้องการเริ่มต้นใช้งานการจับคู่คุกกี้ คุณต้องติดต่อผู้จัดการลูกค้าด้านเทคนิค ซึ่งจะเปิดใช้เวิร์กโฟลว์ที่เฉพาะเจาะจงและช่วยคุณกําหนดค่าสิ่งต่อไปนี้ได้
- รหัสเครือข่ายการจับคู่คุกกี้ (NID): รหัสสตริงที่ใช้ระบุบัญชีผู้เสนอราคาสำหรับการจับคู่คุกกี้และการดำเนินการอื่นๆ ที่เกี่ยวข้องได้โดยไม่ซ้ำกัน
- URL การจับคู่คุกกี้: URL ฐานสําหรับปลายทางที่จะยอมรับและจัดการคําขอที่เข้ามาโดยเป็นส่วนหนึ่งของเวิร์กโฟลว์การจับคู่คุกกี้ ผู้เสนอราคาสามารถฝังมาโครใน URL นี้เพื่อควบคุมลําดับของพารามิเตอร์ที่ส่งไปยัง URL ดังกล่าวในเวิร์กโฟลว์การจับคู่คุกกี้
- แท็กจับคู่: แท็กที่คุณต้องวางในเบราว์เซอร์ของผู้ใช้สำหรับเวิร์กโฟลว์การจับคู่คุกกี้ที่ผู้เสนอราคาเป็นผู้เริ่ม โดยจะแสดงควบคู่ไปกับโฆษณา หรือวางในผลิตภัณฑ์และบริการบนอินเทอร์เน็ตนอกโฆษณาก็ได้
- URL ของรายงานการจับคู่คุกกี้ (ไม่บังคับ): ในเวิร์กโฟลว์การจับคู่คุกกี้แบบทิศทางเดียว URL นี้เป็น URL ที่ไม่บังคับซึ่งอาจให้ไว้ได้เพื่อระบุปลายทางที่จะรับรายละเอียดข้อผิดพลาดในกรณีที่การจับคู่คุกกี้ผ่านการเปลี่ยนเส้นทาง HTTP 302 ไม่ประสบความสำเร็จ โดยค่าเริ่มต้น ระบบจะส่งการตอบกลับไปยัง URL นี้เฉพาะในกรณีที่เกิดข้อผิดพลาดในการดำเนินการจับคู่คุกกี้ แต่ผู้เสนอราคาอาจขอให้ส่งการเปลี่ยนเส้นทางเสมอ
- URL ของ Cookie Match Assist: สำหรับ Exchange ที่ใช้เวิร์กโฟลว์ Cookie Match Assist นี่จะเป็น URL พื้นฐานของปลายทางมีไว้เพื่อตอบสนองต่อคำขอที่เข้ามาใหม่
- โควต้า Cookie Match Assist: สําหรับพาร์ทเนอร์ Exchange ที่ใช้เวิร์กโฟลว์ Cookie Match Assist โควต้านี้คือจํานวนคําขอสูงสุดที่ URL การจับคู่คุกกี้ของพาร์ทเนอร์จะรับได้ต่อวินาที ทั้งนี้เพื่อป้องกันไม่ให้คำขอ CMA ทำให้เซิร์ฟเวอร์ของ Exchange ทำงานหนักเกินไปเมื่อมีคำขอ
มาโครการจับคู่คุกกี้
ในเวิร์กโฟลว์การจับคู่คุกกี้ที่รองรับ โดยทั่วไป URL การจับคู่คุกกี้ของผู้เสนอราคาจะมีพารามิเตอร์ต่อท้ายในลําดับที่ไม่รับประกัน ผู้เสนอราคาที่มีการผสานรวมซึ่งต้องมีการเรียงลําดับพารามิเตอร์ที่สอดคล้องกันสามารถวางมาโครใน URL การจับคู่คุกกี้เพื่อรับประกันตําแหน่ง
มาโครที่รองรับ
ผู้เสนอราคาสามารถกําหนดค่า URL การจับคู่คุกกี้ให้รวมมาโครอย่างน้อย 1 รายการในรูปแบบ %%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
และการใช้งานต้องใช้พารามิเตอร์ที่กำหนดไว้ล่วงหน้าของผู้เสนอราคานอกเหนือจากพารามิเตอร์การจับคู่พิกเซลตามลําดับต่อไปนี้ 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 รายการสําหรับกรณีการใช้งานที่แตกต่างกันตามที่อธิบายไว้ด้านล่าง
เริ่มต้นโดยผู้เสนอราคา: การจับคู่คุกกี้แบบ 2 ทิศทาง
การจับคู่คุกกี้แบบ 2 ทิศทางหมายถึงเวิร์กโฟลว์ที่ผู้เสนอราคาเริ่มขึ้น โดยผู้เสนอราคาจะวางแท็กการทำงานของคีย์เวิร์ดในเบราว์เซอร์ของผู้ใช้ซึ่งนําไปยัง Google เวิร์กโฟลว์นี้จะช่วยให้ทั้ง Google และผู้เสนอราคาสร้างตารางการจับคู่ได้ ด้านล่างนี้คือตัวอย่างง่ายๆ ของเวิร์กโฟลว์นี้
ขั้นตอนที่ 1: วางแท็กการทำงานของคีย์เวิร์ด
ในการเริ่มขั้นตอนนี้ ผู้เสนอราคาจะต้องวางแท็กจับคู่ให้แสดงผลในเบราว์เซอร์ของผู้ใช้ แท็กการจับคู่แบบง่ายที่แสดงเฉพาะรหัสผู้ใช้ Google ให้แก่ผู้เสนอราคาอาจมีโครงสร้างดังนี้
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />ของ Real-time Bidding API
มีพารามิเตอร์เพิ่มเติมที่คุณใส่ไว้ในแท็กการทำงานของคีย์เวิร์ดเพื่อตอบสนองกรณีการใช้งานที่แตกต่างกันได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์เหล่านี้ได้ที่หัวข้อจับคู่พารามิเตอร์ของ 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
คือสตริงที่เข้ารหัส Base64 ซึ่งใช้กับเว็บได้แบบไม่เติมค่า สำหรับผู้เสนอราคาที่เลือกโฮสต์ตารางการจับคู่ ขอแนะนำให้จัดเก็บสตริงที่ตรงกันซึ่งแสดงผลโดยบริการจับคู่คุกกี้ ในคำขอราคาเสนอที่ตามมา ค่านี้จะสอดคล้องกับค่าที่ระบุผ่าน BidRequest.user.id
ใน OpenRTB หรือ BidRequest.google_user_id
ในโปรโตคอล Google RTB ที่เลิกใช้งานแล้ว
เวอร์ชันที่ระบุใน google_cver
ระบุหมายเลขเวอร์ชันที่เป็นตัวเลขสำหรับรหัสผู้ใช้ Google รหัสผู้ใช้ Google ของผู้ใช้ที่กำหนดจะเปลี่ยนแปลงไม่บ่อยนัก ซึ่งหลังจากนั้นจะเพิ่มขึ้น
หาก Google พบข้อผิดพลาดขณะประมวลผลคําขอการจับคู่ ระบบจะระบุพารามิเตอร์ google_error
แทน
ขั้นตอนที่ 3: ผู้เสนอราคาประมวลผลการเปลี่ยนเส้นทางและตอบกลับด้วยพิกเซล
ผู้เสนอราคาจะได้รับการเปลี่ยนเส้นทางไปยัง URL การจับคู่คุกกี้ ซึ่งรวมถึงพารามิเตอร์ที่ระบุไว้ในขั้นตอนแรก และพารามิเตอร์ที่ Google ระบุไว้ในขั้นตอนที่ 2 นอกจากนี้ ผู้ชมจะได้รับคุกกี้ในส่วนหัว HTTP ด้วย หากการดำเนินการสําเร็จ ผู้เสนอราคาที่โฮสต์ตารางการจับคู่ของตนเองจะจับคู่คุกกี้กับรหัสผู้ใช้ Google ที่รวมอยู่ในการตอบกลับได้ ขอแนะนำให้ผู้เสนอราคาจัดเก็บสตริงที่ส่งคืนโดยบริการจับคู่คุกกี้
หากการดำเนินการไม่สำเร็จ ผู้เสนอราคาจะได้รับพารามิเตอร์ google_error
ในการเปลี่ยนเส้นทาง ค่านี้เป็นค่าตัวเลขที่สอดคล้องกับสถานะข้อผิดพลาดต่างๆ ซึ่งระบุข้อผิดพลาดที่เฉพาะเจาะจงที่เกิดขึ้น ดูข้อมูลเพิ่มเติมเกี่ยวกับค่าข้อผิดพลาดที่เป็นไปได้ได้ที่นี่
หากได้รับข้อผิดพลาด คุณสามารถลองจับคู่ผู้ใช้รายนั้นอีกครั้งโดยวางแท็กการจับคู่ใหม่
ผู้เสนอราคาต้องตอบกลับเสมอด้วยการแสดงรูปภาพพิกเซลที่มองไม่เห็นขนาด 1x1 หรือส่งการตอบกลับHTTP 204
ไม่มีเนื้อหา
แผนภาพเวิร์กโฟลว์การจับคู่คุกกี้
เวิร์กโฟลว์นี้แสดงในแผนภาพด้านล่าง ซึ่งลูกศรแสดงคําขอและการตอบกลับ และรายการข้อมูลที่มาพร้อมกับคําขอและคําตอบจะแสดงอยู่ในวงเล็บ
พารามิเตอร์ของ URL แท็กที่ตรงกัน
พารามิเตอร์ | คำอธิบาย |
---|---|
google_nid |
รหัสเครือข่าย (NID) สําหรับบัญชีผู้เสนอราคา คุณสามารถเรียกดูรหัสนี้ผ่านแหล่งข้อมูลผู้เสนอราคา |
google_cm |
บ่งบอกให้บริการการจับคู่คุกกี้ของ Google ทราบว่าควรทำการจับคู่คุกกี้ ระบบจะไม่สนใจค่าพารามิเตอร์และระบบอาจละเว้นค่าของพารามิเตอร์ |
google_sc |
พารามิเตอร์นี้เลิกใช้งานแล้ว ตั้งค่าคุกกี้ของ Google สําหรับผู้ใช้ หากไม่มี ระบบจะไม่สนใจค่าพารามิเตอร์และอาจละเว้นค่าของพารามิเตอร์ การละเว้นพารามิเตอร์จะทำให้เกิดข้อผิดพลาดหากไม่มีคุกกี้ |
google_no_sc |
พารามิเตอร์นี้เลิกใช้งานแล้ว ซึ่งเป็นการบอกบริการจับคู่คุกกี้ของ Google ว่าไม่ควรตั้งค่าคุกกี้ให้กับผู้ใช้หากไม่มีคุกกี้ ระบบจะละเว้นค่าของพารามิเตอร์และอาจละเว้น |
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 ของ IAB ของ Authorized Buyers
ตัวอย่าง: |
gdpr_consent |
สตริง TC ที่แสดงความยินยอมของผู้ใช้ปลายทาง ดูรายละเอียดเพิ่มเติมได้ที่ข้อกําหนดความยินยอมของผู้ใช้ในสหภาพยุโรปด้านล่าง หรือระบบจะส่งสตริง TC อย่างไรใน เอกสารประกอบ TCF เวอร์ชัน 2.0 ของ IAB สําหรับ 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: ผู้ใช้ล้างคุกกี้และเรียกดูเว็บไซต์
Jane ล้างแคชคุกกี้ทั้งหมด จากนั้นผู้ใช้ก็เข้าชมหน้าแรกของ ExampleNews.com
ต่อไปนี้คือสิ่งที่เกิดขึ้น:
- ExampleNews.com แสดงผลและเรียกโฆษณาจาก Google (Ad Manager)
- เนื่องจากหน่วยโฆษณามีสิทธิ์ได้รับการจัดสรรแบบไดนามิก Google จึงส่งคําขอราคาเสนอไปยัง FinestDSP และผู้เสนอราคารายอื่นๆ ผ่านบริการการเสนอราคาแบบเรียลไทม์
- แอปพลิเคชันผู้เสนอราคาของ FinestDSP จะรับและประมวลผลคําขอราคาเสนอ และส่งการเสนอราคาตอบ
- Google จะได้รับการเสนอราคาตอบจากผู้เสนอราคา รวมถึงการเสนอราคาตอบของ FinestDSP ที่ระบุโฆษณาที่มีแท็กจับคู่ (พิกเซล)
- FinestDSP ชนะการประมูล Google แสดงโฆษณาของ FinestDSP และจับคู่แท็กกับเจน
- แท็กจับคู่จะเรียกใช้บริการจับคู่คุกกี้ของ Google โดยระบุพารามิเตอร์
google_nid
และgoogle_cm
- บริการจับคู่คุกกี้จะอ่านคุกกี้ Google ของ Jane และส่งการเปลี่ยนเส้นทางเบราว์เซอร์ของ Jane ไปยัง URL การจับคู่คุกกี้ของ FinestDSP ที่มีการตั้งค่าพารามิเตอร์
google_gid
และgoogle_cver
- เบราว์เซอร์ของ Jane จะโหลดการเปลี่ยนเส้นทางไปยัง URL การจับคู่คุกกี้ของ FinestDSP
- ปลายทางการจับคู่คุกกี้ของ FinestDSP จะประมวลผลคำขอเปลี่ยนเส้นทาง
ซึ่งรวมถึงพารามิเตอร์ของ URL ที่ Google กำหนด และคุกกี้สำหรับเจนในส่วนหัว HTTP ตอนนี้ FinestDSP จัดเก็บการแมปคุกกี้กับ
google_gid
ในตารางการจับคู่ได้แล้ว - FinestDSP จะตอบสนองต่อการเปลี่ยนเส้นทางด้วยพิกเซลขนาด 1x1 ที่มองไม่เห็น
สถานการณ์ 2: ผู้ใช้ที่มีการแมปอยู่แล้ว
1 สัปดาห์หลังจากสถานการณ์ 1 เจนเข้าชม ExampleNews.com อีกครั้ง เมื่อ Jane มีคุกกี้ผู้เสนอราคาและ Ad Manager ในเครื่องแล้ว การจับคู่จะทํางานดังนี้
- หน้าเว็บแสดงผล ทำให้ Google (Ad Manager) ขอโฆษณาที่จะแสดงผลในหน้าเว็บ
- ในระหว่างการประมูลเพื่อแสดงโฆษณา Google จะส่งคำขอราคาเสนอไปยังผู้เสนอราคาที่เกี่ยวข้อง ซึ่งรวมถึง FinestDSP
- FinestDSP จะได้รับคำขอราคาเสนอ รวมถึงสัญญาณ เช่น
google_gid
- FinestDSP ค้นหา
google_gid
ในตารางการจับคู่ และพบว่าคุกกี้ที่เชื่อมโยงกับเจนที่สร้างขึ้นเมื่อ 1 สัปดาห์ก่อนหน้า (ในสถานการณ์ที่ 1) - ตรรกะการเสนอราคาของ FinestDSP จะเสนอราคาสำหรับการแสดงผลและชนะการประมูลโดยอิงตามข้อมูลที่เชื่อมโยงกับคุกกี้
- เจนอาจเห็นโฆษณาที่ปรับแต่งตามความสนใจของตนโดยอิงตามข้อมูลที่ FinestDSP มีอยู่
เริ่มโดยผู้เสนอราคา: การจับคู่คุกกี้แบบทิศทางเดียว
การจับคู่คุกกี้แบบทิศทางเดียวคล้ายกับเวิร์กโฟลว์แบบ 2 ทิศทาง ยกเว้นว่ามีการแก้ไขเพื่อให้มีเพียง 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
ที่ป้อนข้อมูลคุกกี้ที่เข้ารหัส 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.user.buyeruid
สำหรับ OpenRTB หรือ BidRequest.hosted_match_data
สำหรับโปรโตคอล RTB ของ 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 แบบโปร่งใสในเบราว์เซอร์ของผู้ใช้
แผนภาพเวิร์กโฟลว์การจับคู่คุกกี้สําหรับผู้ใช้จากรัฐในสหรัฐอเมริกาที่มีการจํากัดความเป็นส่วนตัว
ระบบจะแสดงเวิร์กโฟลว์เริ่มต้นสำหรับผู้ใช้ในรัฐในสหรัฐอเมริกาที่มีข้อจำกัดด้านความเป็นส่วนตัวตามแผนภาพด้านล่าง โดยคำขอและคำตอบจะแสดงด้วยลูกศร และรายการข้อมูลที่มาพร้อมผู้ใช้จะแสดงอยู่ในวงเล็บ
พารามิเตอร์ของ URL สำหรับผู้เสนอราคาเปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ของ Google
พารามิเตอร์ | คำอธิบาย |
---|---|
google_nid |
รหัสเครือข่าย (NID) สําหรับบัญชีผู้เสนอราคา คุณสามารถเรียกดูรหัสนี้ผ่านแหล่งข้อมูลผู้เสนอราคา |
google_sc |
พารามิเตอร์นี้เลิกใช้งานแล้ว ตั้งค่าคุกกี้ของ Google สําหรับผู้ใช้ หากไม่มี ระบบจะละเว้นค่าของพารามิเตอร์และอาจละเว้นได้ การละเว้นพารามิเตอร์จะทำให้เกิดข้อผิดพลาดหากไม่มีคุกกี้ |
google_no_sc |
พารามิเตอร์นี้เลิกใช้งานแล้ว ซึ่งเป็นการบอกบริการจับคู่คุกกี้ของ Google ว่าไม่ควรตั้งค่าคุกกี้ให้กับผู้ใช้หากไม่มีคุกกี้ ระบบจะไม่สนใจค่าพารามิเตอร์และระบบอาจละเว้นค่าของพารามิเตอร์ |
google_hm |
มีข้อมูลที่ผู้เสนอราคาต้องการจัดเก็บไว้ในตารางจับคู่ที่โฮสต์โดย Google |
google_redir |
URL ที่เข้ารหัสซึ่งคุณต้องการให้ Google ส่งการเปลี่ยนเส้นทาง HTTP 302 URL ที่ระบุจะได้รับการเปลี่ยนเส้นทางที่มีพารามิเตอร์ google_error สำหรับทั้งข้อผิดพลาดและการดำเนินการที่สำเร็จ |
google_ula |
สตริงที่ใช้เพิ่มผู้ใช้ลงในรายการผู้ใช้ที่มีอยู่ รูปแบบที่คาดไว้ของค่า userlistid[,timestamp] ดังนี้
พารามิเตอร์ URL นี้อาจใช้ซ้ำเพื่อเพิ่มผู้ใช้ไปยังหลายรายการ |
gdpr |
บ่งชี้ว่าคำขออยู่ภายใต้ข้อจำกัดของ GDPR ในการใช้ข้อมูล ดูรายละเอียดเพิ่มเติมได้ที่
ข้อกําหนดเกี่ยวกับความยินยอมของผู้ใช้ EU ด้านล่าง หรือผลกระทบต่อการมีสิทธิ์ใช้การทํางานร่วมกันของคุกกี้ใน
เอกสารประกอบ TCF v2.0 ของ IAB สําหรับ Authorized Buyers
ตัวอย่าง: |
gdpr_consent |
สตริง TC ที่แสดงถึงความยินยอมของผู้ใช้ปลายทาง ดูรายละเอียดเพิ่มเติมได้ที่ข้อกําหนดความยินยอมของผู้ใช้ในสหภาพยุโรปด้านล่าง หรือระบบจะส่งสตริง TC อย่างไรใน เอกสารประกอบ TCF เวอร์ชัน 2.0 ของ IAB สําหรับ 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 ที่ใช้ในแท็ก Match สำหรับเวิร์กโฟลว์การจับคู่คุกกี้ที่เริ่มโดยผู้เสนอราคา
ในการทำงานของพิกเซล พารามิเตอร์ google_cm
จะแทนที่ด้วยพารามิเตอร์ google_push
และค่าของพารามิเตอร์ต้องเท่ากับค่าที่ Google ระบุในคําขอ นอกจากนี้ คุณยังระบุพารามิเตอร์เพิ่มเติมเพื่อใช้กับกรณีการใช้งานเพิ่มเติมได้เช่นเดียวกับเวิร์กโฟลว์ที่เริ่มต้นโดยผู้เสนอราคา
ขั้นตอนที่ 3: Google ประมวลผลการเปลี่ยนเส้นทางและตอบกลับด้วยพิกเซล
Google จะบันทึกการจับคู่ที่สร้างขึ้นสำหรับผู้ใช้ และจัดการการดำเนินการเพิ่มเติมที่ขอผ่านพารามิเตอร์การค้นหา และสุดท้าย Google จะตอบสนองด้วยพิกเซลโปร่งใสขนาด 1x1
แผนภาพเวิร์กโฟลว์การจับคู่พิกเซล
ขั้นตอนการทำงานนี้จะแสดงเป็นแผนภาพด้านล่าง โดยที่คำขอและคำตอบจะแสดงเป็นลูกศร และรายการข้อมูลประกอบจะอยู่ในวงเล็บ
พารามิเตอร์คําขอแท็กการทำงานของคีย์เวิร์ด Google
พารามิเตอร์ | คำอธิบาย |
---|---|
google_gid |
รหัสผู้ใช้ Google สําหรับผู้ใช้ที่ไม่ได้มาจากรัฐในสหรัฐอเมริกาที่มีข้อจํากัดด้านความเป็นส่วนตัว ระบบจะระบุข้อมูลนี้ในแท็กการทำงานของคีย์เวิร์ดของ Google เสมอ |
google_cver |
เวอร์ชันของคุกกี้ ซึ่งจะระบุอยู่ในแท็กจับคู่ของ Google เสมอ |
google_push |
บ่งบอกว่าคําขอนี้กําลังเริ่มเวิร์กโฟลว์การจับคู่พิกเซล ค่าต้องแสดงผ่านพารามิเตอร์ที่เกี่ยวข้องในการตอบกลับการเปลี่ยนเส้นทางของผู้เสนอราคา |
gdpr_consent |
สตริง TC ที่แสดงถึงความยินยอมของผู้ใช้ปลายทาง ดูรายละเอียดเพิ่มเติมได้ที่[ข้อกำหนดเกี่ยวกับความยินยอมของผู้ใช้ EU](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) ด้านล่าง หรือ **ระบบจะส่งสตริง TC อย่างไร** ใน[เอกสารประกอบเกี่ยวกับ TCF เวอร์ชัน 2.0 ของ Authorized Buyers ของ IAB](//support.google.com/authorizedbuyers/answer/9789378) |
พารามิเตอร์การเปลี่ยนเส้นทางการจับคู่พิกเซลของผู้เสนอราคา
พารามิเตอร์ | คำอธิบาย |
---|---|
google_nid |
รหัสเครือข่าย (NID) สําหรับบัญชีผู้เสนอราคา คุณสามารถเรียกดูรหัสนี้ผ่านแหล่งข้อมูลผู้เสนอราคา |
google_push |
บ่งบอกว่าการเปลี่ยนเส้นทางนี้ทําให้เวิร์กโฟลว์การจับคู่พิกเซลเสร็จสมบูรณ์ คุณต้องระบุค่าจากแท็กการทำงานของคีย์เวิร์ด Google ที่เกี่ยวข้องที่นี่ |
google_hm |
มีข้อมูลที่ผู้เสนอราคาต้องการจัดเก็บไว้ในตารางจับคู่ที่โฮสต์โดย Google |
google_ula |
สตริงที่ใช้เพิ่มผู้ใช้ลงในรายการผู้ใช้ที่มีอยู่ รูปแบบที่คาดไว้ของค่า userlistid[,timestamp] ดังนี้
พารามิเตอร์ URL นี้อาจใช้ซ้ำเพื่อเพิ่มผู้ใช้ไปยังหลายรายการ |
gdpr_consent |
สตริง TC ที่แสดงถึงความยินยอมของผู้ใช้ปลายทาง ดูรายละเอียดเพิ่มเติมได้ที่ [ข้อกําหนดความยินยอมของผู้ใช้ EU](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) ด้านล่าง หรือดูที่หัวข้อ **ระบบจะส่งสตริง TC อย่างไร** ใน [เอกสารประกอบ TCF เวอร์ชัน 2.0 ของ IAB สําหรับผู้ซื้อที่ได้รับอนุญาต](//support.google.com/authorizedbuyers/answer/9789378) |
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
ที่ป้อนข้อมูลคุกกี้ที่เข้ารหัส 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.user.buyeruid
สำหรับ OpenRTB หรือ BidRequest.hosted_match_data
สำหรับโปรโตคอล Google RTB ที่เลิกใช้งานแล้ว ผู้เสนอราคายังป้อนข้อมูลรายการผู้ใช้โดยใช้ข้อมูลการจับคู่ที่โฮสต์ไว้ที่ระบุไว้ได้อีกด้วย
สุดท้าย Google จะแสดงผลพิกเซลขนาด 1x1 แบบโปร่งใสในเบราว์เซอร์ของผู้ใช้
ตัวช่วยจับคู่คุกกี้
การเสนอราคาแบบเปิดช่วยให้ Exchange ใช้เวิร์กโฟลว์การจับคู่คุกกี้ที่เริ่มต้นโดยผู้เสนอราคาและที่เริ่มต้นโดย Google เพื่อจับคู่รหัสผู้ใช้ Google กับคุกกี้ Cookie 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 ระบุเพื่อจับคู่รหัสผู้ใช้กับคุกกี้
ข้อจำกัด
จำกัดความถี่ของคำขอการจับคู่ใหม่
ผู้เสนอราคามีหน้าที่รับผิดชอบในการจํากัดจํานวนการเรียกใช้บริการจับคู่คุกกี้สําหรับผู้ใช้ที่มีรายการใหม่ในตารางการจับคู่ที่โฮสต์โดย Google ระบบอาจถือว่ารายการในตารางการจับคู่ที่โฮสต์หมดอายุใน 14 วัน จากนั้นจึงรีเฟรชรายการได้
ตอบกลับคําขอการจับคู่พิกเซลทั้งหมด
ผู้เสนอราคาที่ใช้เวิร์กโฟลว์การจับคู่พิกเซลจะต้องตอบกลับคำขอการจับคู่พิกเซลขาเข้าทั้งหมดด้วยการตอบกลับที่มีพารามิเตอร์ google_push
ซึ่งจะช่วยให้ Google บังคับใช้นโยบายได้โดยการตรวจสอบการใช้งาน หากอัตราการตอบกลับของผู้เสนอราคาลดลงต่ำกว่า 90% Google จะจำกัดจำนวนคำขอการจับคู่พิกเซลที่ส่งไปยังบัญชีของผู้เสนอราคา
ใช้ปลายทาง HTTPS
ปลายทางที่ใช้ในเวิร์กโฟลว์การจับคู่คุกกี้ทั้งหมดต้องใช้ HTTPS
เมื่อตอบกลับคําขอการจับคู่พิกเซลที่ส่งถึงคุณผ่าน HTTPS คุณต้องเปลี่ยนเส้นทางไปยังบริการการจับคู่คุกกี้ผ่าน HTTPS ในทํานองเดียวกัน ปลายทาง Cookie Match Assist ที่เปลี่ยนเส้นทางไปยังผู้เสนอราคาต้องใช้ HTTPS ด้วย หากคุณส่งคําขอไปยัง Google ผ่าน HTTP บ่อยกว่า 1 ครั้งทุก 2 นาที ระบบจะจํากัดจํานวนคําขอการจับคู่ที่ส่งไปยังบัญชีของคุณ
ข้อกําหนดความยินยอมของผู้ใช้ EU
คำขอการจับคู่คุกกี้ที่อยู่ภายใต้นโยบายความยินยอมของผู้ใช้ EU ของ Google ควรระบุความยินยอมของผู้ใช้ปลายทาง คำขอดังกล่าวต้องระบุว่ามีการรวบรวมความยินยอมโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้
- TCFv2: ซึ่งรวมถึงพารามิเตอร์
gdpr
และgdpr_consent
โปรดดูรายละเอียดใน เอกสารประกอบ TCF เวอร์ชัน 2.0 ของ IAB สำหรับ 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
เพิ่มลงในรายชื่อผู้ใช้หลายรายการ
ผู้เสนอราคาสามารถระบุให้เพิ่มผู้ใช้ไปยังรายการผู้ใช้หลายรายการได้โดยใส่พารามิเตอร์ 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
โดยค่าต้องเป็นสตริงที่เข้ารหัส 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.user.buyeruid
สำหรับ OpenRTB หรือ BidRequest.hosted_match_data
สำหรับโปรโตคอล Google RTB ที่เลิกใช้งานแล้ว
หากผู้เสนอราคาใช้แท็กการทำงานของคีย์เวิร์ดแทน โดยที่ค่าของ 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
เมื่อได้รับการเปลี่ยนเส้นทาง ผู้เสนอราคาสามารถจับคู่รหัสผู้ใช้ Google ที่ระบุใน google_gid
กับข้อมูลคุกกี้ในตารางการจับคู่ได้ นอกจากนี้ ทีมตรวจสอบยังระบุได้ว่าตารางจับคู่และรายชื่อผู้ใช้ที่โฮสต์โดย Google สำเร็จหรือไม่ ด้วยเหตุนี้ การกําหนดค่าการกำหนดเป้าหมายล่วงหน้าที่ผู้เสนอราคากําหนดให้กําหนดเป้าหมายรหัสรายการผู้ใช้ที่ระบุไว้จะทำให้ผู้เสนอราคาได้รับคําขอราคาเสนอสําหรับการแสดงผลจากผู้ใช้ ในทํานองเดียวกัน ผู้เสนอราคาจะได้รับข้อมูลการจับคู่ที่โฮสต์ในBidRequest.user.buyeruid
สําหรับ OpenRTB หรือBidRequest.hosted_match_data
สําหรับโปรโตคอล Google RTB ที่เลิกใช้งานแล้วในคําขอราคาเสนอเหล่านี้