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

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

แนวคิด

การจับคู่คุกกี้คืออะไร

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

ในบริบทของการโฆษณาดิจิทัล 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 นี้เป็น 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%% มาโครที่รองรับและค่าแบบขยายมีดังนี้

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

ผู้เสนอราคามีการผสานรวมการจับคู่คุกกี้กับปลายทางที่โฮสต์ที่ 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" />

คุณใส่พารามิเตอร์เพิ่มเติมในแท็กการทำงานของคีย์เวิร์ดเพื่อใช้กับกรณีการใช้งานต่างๆ ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์เหล่านี้ได้ที่หัวข้อจับคู่พารามิเตอร์ของ 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 แท็กที่ตรงกัน

นอกเหนือจากพารามิเตอร์ข้างต้น ผู้เสนอราคายังระบุพารามิเตอร์ของตนเองได้ด้วย ซึ่งระบบจะเพิ่มต่อท้าย 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_ ต่อไปนี้ได้รับการกําหนด

ตัวอย่างสถานการณ์เวิร์กโฟลว์การจับคู่คุกกี้

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

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

Jane ล้างแคชคุกกี้ทั้งหมด จากนั้นผู้ใช้ก็เข้าชมหน้าแรกของ ExampleNews.com

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

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

สถานการณ์ 2: ผู้ใช้ที่มีการแมปอยู่แล้ว

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

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

หรือหากเกิดข้อผิดพลาด 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

พารามิเตอร์ของ URL สําหรับการเปลี่ยนเส้นทางของ Google ไปยัง URL รายงานการจับคู่คุกกี้ของผู้เสนอราคา

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 เป็นผู้เริ่ม: การจับคู่พิกเซลแบบทิศทางเดียว

การจับคู่พิกเซลแบบทิศทางเดียวแตกต่างจากเวิร์กโฟลว์แบบ 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) เป็นฟีเจอร์เพิ่มเติมสําหรับพาร์ทเนอร์การแลกเปลี่ยน ซึ่งช่วยให้พาร์ทเนอร์เหล่านั้นสร้างตารางการจับคู่กับผู้เสนอราคาของตนเองได้

วิธีการทำงานของตัวช่วยการจับคู่คุกกี้

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

   <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>

2. แท็กการจับคู่ CMA ของ Google ทําให้ URL การจับคู่คุกกี้ของพาร์ทเนอร์การซื้อขายได้รับคําขอพิกเซล

   ซึ่งแตกต่างจากเวิร์กโฟลว์ที่ Google เริ่มต้น
3. ปลายทางการจับคู่คุกกี้ของพาร์ทเนอร์การแลกเปลี่ยนจะรับคําขอ โดยบริการจับคู่คุกกี้ของพาร์ทเนอร์เองจะมีหน้าที่รับผิดชอบในการจับคู่รหัสผู้ใช้กับผู้เสนอราคารายใดรายหนึ่ง ในแผนภาพด้านล่าง บริการจับคู่คุกกี้ของพาร์ทเนอร์การแลกเปลี่ยนจะตอบสนองต่อเบราว์เซอร์ของผู้ใช้ด้วยการเปลี่ยนเส้นทางไปยังปลายทางของผู้เสนอราคารายใดรายหนึ่ง
4. ผู้เสนอราคาจะได้รับคําขอพร้อมกับพารามิเตอร์ที่ 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 ที่เลิกใช้งานแล้วในคําขอราคาเสนอเหล่านี้