การจับคู่คุกกี้เป็นฟีเจอร์ที่ช่วยให้คุณจับคู่คุกกี้ เช่น รหัสของผู้ใช้ที่เรียกดูเว็บไซต์ของคุณ กับรหัสผู้ใช้ Google ของผู้เสนอราคารายหนึ่งๆ โดยเฉพาะที่เกี่ยวข้อง และสร้างรายชื่อผู้ใช้ที่ช่วยให้คุณเลือกการเสนอราคาได้อย่างมีประสิทธิภาพมากขึ้น คู่มือนี้จะอธิบายแนวคิดที่ใช้ในการจับคู่คุกกี้ รวมทั้งเวิร์กโฟลว์การจับคู่คุกกี้ที่แตกต่างกัน และรูปแบบต่างๆ ที่อาจมีสำหรับกรณีการใช้งานบางกรณี
แนวคิด
การจับคู่คุกกี้คืออะไร
โดยปกติแล้ว เจ้าของโดเมนจะตั้งค่าเนื้อหาของคุกกี้สําหรับผู้ใช้ที่เรียกดูเว็บไซต์ของตน ซึ่งจะใช้เพื่อระบุผู้ใช้ภายในโดเมนนั้น แม้ว่าเจ้าของโดเมนสองคนจะยอมแลกเปลี่ยนข้อมูลนี้ แต่โมเดลความปลอดภัยของเบราว์เซอร์อินเทอร์เน็ตจะจำกัดไม่ให้เจ้าของโดเมนอ่านคุกกี้ที่โดเมนอื่นตั้งค่าไว้
ในบริบทของการโฆษณาดิจิทัล Google จะระบุผู้ใช้ด้วยคุกกี้ที่เป็นของโดเมน doubleclick.net
และผู้เสนอราคาที่เข้าร่วมการเสนอราคาแบบเรียลไทม์อาจมีโดเมนของตนเองเพื่อระบุกลุ่มผู้ใช้ที่ต้องการแสดงโฆษณา การจับคู่คุกกี้ช่วยให้ผู้เสนอราคาจับคู่คุกกี้ของตนเองกับของ Google ได้ เพื่อพิจารณาว่าการแสดงผลที่ส่งในคําขอราคาเสนอเชื่อมโยงกับผู้ใช้รายใดรายหนึ่งที่กำหนดเป้าหมายหรือไม่ ผู้เสนอราคาจะได้รับข้อมูลคุกกี้ของตนเองหรือรหัสผู้ใช้ Google เฉพาะของผู้เสนอราคา ซึ่งเป็นรูปแบบที่เข้ารหัสของคุกกี้ doubleclick.net
ในคําขอราคาเสนอ
บริการการจับคู่คุกกี้ที่อธิบายไว้ในคู่มือนี้ช่วยสร้างและดูแลรักษาการเชื่อมโยงระหว่างคุกกี้ของผู้เสนอราคากับรหัสผู้ใช้ Google รวมถึงช่วยให้สร้างรายการผู้ใช้ได้
ตารางที่ตรงกัน
ตารางการจับคู่สามารถใช้เพื่อจับคู่รหัสหรือข้อมูลอื่นๆ จากโดเมนหนึ่งกับอีกโดเมนหนึ่ง ผู้เสนอราคาสามารถใช้บริการจับคู่คุกกี้เพื่อป้อนข้อมูลตารางการจับคู่ของตนเองโดยการแมปคุกกี้ของผู้ใช้รายหนึ่งกับรหัสผู้ใช้ Google ของผู้ใช้ หรือเพื่อป้อนข้อมูลตารางการจับคู่ที่โฮสต์โดย Google ตารางการจับคู่เป็นสิ่งจําเป็นสําหรับแอปพลิเคชันผู้เสนอราคาของผู้เสนอราคาในการเข้าถึงข้อมูลคุกกี้สําหรับผู้ใช้ที่แสดงการแสดงผล
ตารางจับคู่ที่โฮสต์โดย Google
เราขอแนะนำให้คุณอนุญาตให้ Google โฮสต์ตารางการจับคู่เพื่อให้การบำรุงรักษาง่ายขึ้น ปรับปรุงเวลาในการตอบสนอง และเข้าถึงข้อมูลการจับคู่สำหรับผู้ใช้ในบางภูมิภาค ซึ่งจะช่วยให้คุณระบุสตริงที่เข้ารหัส Base64 ซึ่งใช้กับเว็บได้ (ต่อไปนี้จะเรียกว่าข้อมูลการจับคู่ที่โฮสต์) ที่จะแมปกับรหัสผู้ใช้ Google ของผู้ใช้รายหนึ่งๆ เมื่อสร้างการจับคู่แล้ว คุณจะนำไปใช้ได้ดังนี้
การเสนอราคาแบบเรียลไทม์: ในคำขอราคาเสนอที่ตามมาสำหรับการแสดงผลที่เชื่อมโยงกับผู้ใช้ Google จะส่งข้อมูลการจับคู่ที่โฮสต์ไว้ซึ่งคุณตรงกับรหัสผู้ใช้ Google ไปให้ ในการใช้งาน OpenRTB ของ Google
BidRequest.user.buyeruid
จะระบุค่านี้เป็นสตริงที่เข้ารหัสฐาน 64 ที่เข้ากันได้กับเว็บ หากปลายทางการเสนอราคาได้รับการกําหนดค่าให้ใช้โปรโตคอล RTB ของ Google ที่เลิกใช้งานแล้ว คุณจะได้รับข้อมูลนี้ในรูปแบบไบต์ที่ถอดรหัสแล้วผ่านช่องBidRequest.hosted_match_data
รายการผู้ใช้: รายการผู้ใช้จะสร้างได้โดยใช้รหัสผู้ใช้ Google หรือข้อมูลการจับคู่ที่โฮสต์
- การกำหนดเป้าหมายล่วงหน้า: คุณสามารถกําหนดค่าการกําหนดเป้าหมายล่วงหน้าเพื่อให้ได้รับเฉพาะคําขอราคาเสนอที่มีข้อมูลการจับคู่ที่โฮสต์เท่านั้น ซึ่งสามารถใช้เพื่อกรองการแสดงผลที่มีความเกี่ยวข้องน้อยลงสําหรับผู้ใช้ที่อยู่นอกพื้นที่คุกกี้
รายการผู้ใช้
คุณสร้างและจัดการรายการผู้ใช้ได้ด้วย Real-Time Bidding API เมื่อสร้างแล้ว คุณจะป้อนข้อมูลในรายการเหล่านี้ได้โดยใช้เวิร์กโฟลว์การจับคู่คุกกี้ตามที่อธิบายไว้ด้านล่าง หรือผ่านบริการอัปโหลดหลายรายการพร้อมกัน
เริ่มต้นใช้งาน
ในการเริ่มต้นการจับคู่คุกกี้ คุณต้องติดต่อผู้จัดการบัญชีด้านเทคนิคของคุณ ซึ่งจะสามารถเปิดใช้งานเวิร์กโฟลว์ที่เฉพาะเจาะจงและช่วยคุณกำหนดค่าต่อไปนี้:
- รหัสเครือข่ายการจับคู่คุกกี้ (NID): รหัสสตริงที่ใช้ระบุบัญชีผู้เสนอราคาสำหรับการจับคู่คุกกี้และการดำเนินการอื่นๆ ที่เกี่ยวข้องได้โดยไม่ซ้ำกัน
- URL การจับคู่คุกกี้: URL ฐานสำหรับปลายทางที่จะยอมรับและจัดการคำขอที่เข้ามาโดยเป็นส่วนหนึ่งของเวิร์กโฟลว์การจับคู่คุกกี้ ผู้เสนอราคาสามารถฝังมาโครใน URL นี้เพื่อควบคุมลําดับของพารามิเตอร์ที่ส่งไปยัง URL ดังกล่าวในเวิร์กโฟลว์การจับคู่คุกกี้
- แท็กการจับคู่: แท็กที่คุณต้องวางในเบราว์เซอร์ของผู้ใช้สำหรับเวิร์กโฟลว์การจับคู่คุกกี้ที่เริ่มต้นโดยผู้เสนอราคา ชิ้นงานนี้สามารถแสดงควบคู่ไปกับโฆษณา หรือวางไว้ในพร็อพเพอร์ตี้ของเว็บนอกโฆษณา
- URL รายงานการจับคู่คุกกี้ (ไม่บังคับ): ในเวิร์กโฟลว์การจับคู่คุกกี้แบบทิศทางเดียว เป็น URL ที่ไม่บังคับซึ่งสามารถระบุได้เพื่อระบุปลายทางที่จะได้รับรายละเอียดข้อผิดพลาดในกรณีที่การจับคู่คุกกี้ไม่ผ่านการเปลี่ยนเส้นทาง HTTP 302 โดยค่าเริ่มต้น ระบบจะส่งการตอบกลับไปยัง URL นี้เฉพาะในกรณีที่เกิดข้อผิดพลาดในการดำเนินการจับคู่คุกกี้ แต่ผู้เสนอราคาอาจขอให้ส่งการเปลี่ยนเส้นทางเสมอ
- URL การช่วยจับคู่คุกกี้: สําหรับการแลกเปลี่ยนที่ใช้เวิร์กโฟลว์การช่วยจับคู่คุกกี้ URL นี้เป็น 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
และการใช้งานต้องมีพารามิเตอร์ที่ผู้เสนอราคากำหนดล่วงหน้านอกเหนือจากพารามิเตอร์การจับคู่ 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 รายการสําหรับกรณีการใช้งานที่แตกต่างกันตามที่อธิบายไว้ด้านล่าง
เริ่มต้นโดยผู้เสนอราคา: การจับคู่คุกกี้แบบ 2 ทิศทาง
การจับคู่คุกกี้แบบ 2 ทิศทางหมายถึงเวิร์กโฟลว์ที่เริ่มโดยผู้เสนอราคา ซึ่งจะวางแท็กที่ตรงกันในเบราว์เซอร์ของผู้ใช้เพื่อนำทางไปที่ Google เวิร์กโฟลว์นี้จะช่วยให้ทั้ง Google และผู้เสนอราคาสร้างตารางการจับคู่ได้ ด้านล่างนี้คือตัวอย่างเวิร์กโฟลว์ง่ายๆ นี้
ขั้นตอนที่ 1: วางแท็กจับคู่
ในการเริ่มขั้นตอนนี้ ผู้เสนอราคาจะต้องวางแท็กจับคู่ให้แสดงผลในเบราว์เซอร์ของผู้ใช้ แท็กจับคู่แบบง่ายที่แสดงรหัสผู้ใช้ Google ให้กับผู้เสนอราคาเท่านั้นอาจมีโครงสร้างดังนี้
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
มีพารามิเตอร์เพิ่มเติมที่คุณใส่ในแท็กการจับคู่เพื่อดำเนินการตามกรณีการใช้งานต่างๆ ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์เหล่านี้ได้ที่จับคู่พารามิเตอร์ URL ของแท็ก
ขั้นตอนที่ 2: Google ตอบกลับด้วยการเปลี่ยนเส้นทางรวมถึงข้อมูลการจับคู่
แท็กจับคู่จะทำให้บริการจับคู่คุกกี้ของ Google ได้รับคำขอจากเบราว์เซอร์ของผู้ใช้ ซึ่งจะออก HTTP 302
เปลี่ยนเส้นทางไปยัง URL การจับคู่คุกกี้ของผู้เสนอราคา การเปลี่ยนเส้นทางจะรวมพารามิเตอร์การค้นหาที่ระบุรหัสผู้ใช้ Google และหมายเลขเวอร์ชันของ URL ใน URL และผู้เสนอราคาจะได้รับคุกกี้ที่รวมอยู่ในส่วนหัวของคำขอด้วย ในทางปฏิบัติ URL เปลี่ยนเส้นทางสำหรับ URL การจับคู่คุกกี้ที่ระบุเป็น https://ad.network.com/pixel
นั้น URL เปลี่ยนเส้นทางสำหรับแท็กการจับคู่แบบง่ายดังที่แสดงด้านบนอาจมีลักษณะดังนี้
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
รหัสผู้ใช้ Google ที่ส่งผ่านพารามิเตอร์ google_gid
เป็นสตริงที่เข้ารหัสฐาน 64 เพื่อความปลอดภัยบนเว็บ สำหรับผู้เสนอราคาที่เลือกโฮสต์ตารางการจับคู่ ขอแนะนำให้จัดเก็บสตริงที่ตรงกันซึ่งแสดงผลโดยบริการจับคู่คุกกี้ ในคำขอราคาเสนอที่ตามมา ค่านี้จะสอดคล้องกับค่าที่ระบุผ่าน 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 v2.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 ของเจน และส่งการเปลี่ยนเส้นทางเบราว์เซอร์ของเจนไปยัง URL การจับคู่คุกกี้ของ FinestDSP ที่มีการตั้งค่าพารามิเตอร์
google_gid
และgoogle_cver
- เบราว์เซอร์ของ Jane จะโหลดการเปลี่ยนเส้นทางไปยัง URL การจับคู่คุกกี้ของ FinestDSP
- ปลายทางการจับคู่คุกกี้ของ FinestDSP จะประมวลผลคําขอเปลี่ยนเส้นทาง ซึ่งประกอบด้วยพารามิเตอร์ของ URL ที่ Google ตั้งค่าไว้ และคุกกี้ของ Jane ในส่วนหัว 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
ในตารางการจับคู่ และพบคุกกี้ที่เชื่อมโยงกับ Jane ซึ่งสร้างขึ้นเมื่อสัปดาห์ก่อน (ในสถานการณ์ 1) - ตรรกะการเสนอราคาของ FinestDSP จะเสนอราคาสำหรับการแสดงผลและชนะการประมูลโดยอิงตามข้อมูลที่เชื่อมโยงกับคุกกี้
- เจนอาจเห็นโฆษณาที่ปรับแต่งตามความสนใจของตนโดยอิงตามข้อมูลที่ FinestDSP มีอยู่
เริ่มต้นโดยผู้เสนอราคา: การจับคู่คุกกี้แบบทิศทางเดียว
การจับคู่คุกกี้แบบทิศทางเดียวคล้ายกับเวิร์กโฟลว์แบบ 2 ทิศทาง ยกเว้นว่ามีการแก้ไขเพื่อให้มีเพียง Google เท่านั้นที่โฮสต์และป้อนข้อมูลตารางการจับคู่ กรณีนี้ใช้ได้ในกรณีที่ผู้เสนอราคาไม่ได้รับอนุญาตให้โฮสต์รหัสผู้ใช้ Google ในตารางการจับคู่ของตนเอง หากต้องการใช้ขั้นตอนนี้ ผู้เสนอราคาต้องอนุญาตให้ Google โฮสต์ตารางการจับคู่ ระบุ google_cm
ในคําขอไปยังบริการการจับคู่คุกกี้ของ Google ไม่ได้อีกต่อไป และจะไม่ได้รับการระบุ google_gid
เพื่อป้อนข้อมูลตารางการจับคู่ของตนเอง เมื่อ Google จับคู่ผู้ใช้แล้ว ผู้เสนอราคาจะเพิ่มผู้ใช้ลงในรายการผู้ใช้ได้โดยใช้ข้อมูลคุกกี้ของตนเอง ในทํานองเดียวกัน คําขอราคาเสนอของผู้ใช้เหล่านี้จะยกเว้นรหัสผู้ใช้ Google แต่จะรวมข้อมูลการจับคู่ที่โฮสต์ไว้ ตัวอย่างเวิร์กโฟลว์ที่แก้ไขแล้วแบบง่ายจะสรุปไว้ในขั้นตอนด้านล่าง
ขั้นตอนที่ 1: วางแท็กจับคู่ซึ่งนำไปยัง URL การจับคู่คุกกี้ของผู้เสนอราคา
ผู้เสนอราคาต้องวางแท็กการทำงานของคีย์เวิร์ดเพื่อให้แสดงผลในเบราว์เซอร์ของผู้ใช้จึงจะเริ่มต้นขั้นตอนนี้ได้ แท็กจับคู่จะต้องนำเบราว์เซอร์ของผู้ใช้ไปยัง URL การจับคู่คุกกี้ ซึ่งต่างจากเวิร์กโฟลว์สำหรับผู้ใช้ที่ไม่ได้มาจากรัฐในสหรัฐอเมริกาที่มีข้อจำกัดด้านความเป็นส่วนตัว ตัวอย่างเช่น เมื่อกําหนดค่า URL การจับคู่คุกกี้เป็น
https://ad.network.com/pixel
URL ดังกล่าวจะมีลักษณะดังนี้
<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 ที่ใช้ในแท็กจับคู่สำหรับเวิร์กโฟลว์การจับคู่คุกกี้ที่ผู้เสนอราคาเริ่มต้น
ในการทำงานของพิกเซล พารามิเตอร์ 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 ของ 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 ของ Authorized Buyers ของ 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) เป็นฟีเจอร์เพิ่มเติมสําหรับพาร์ทเนอร์การแลกเปลี่ยน ซึ่งช่วยให้พาร์ทเนอร์เหล่านั้นสร้างตารางการจับคู่กับผู้เสนอราคาของตนเองได้
วิธีการทำงานของตัวช่วยการจับคู่คุกกี้
เมื่อแสดงโฆษณา 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 ระบุเพื่อจับคู่รหัสผู้ใช้กับคุกกี้
ข้อจำกัด
จำกัดความถี่ของคำขอการจับคู่ใหม่
ผู้เสนอราคามีหน้าที่จำกัดจำนวนการเรียกบริการการจับคู่คุกกี้สำหรับผู้ใช้ที่มีรายการใหม่ในตารางการจับคู่ที่โฮสต์โดย 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
โดยค่าต้องเป็นสตริงที่เข้ารหัสแบบ 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.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 ที่เลิกใช้งานแล้วในคําขอราคาเสนอเหล่านี้