การจับคู่คุกกี้เป็นฟีเจอร์ที่ช่วยให้คุณจับคู่คุกกี้ของคุณได้ เช่น รหัสสำหรับผู้ใช้ที่เรียกดูเว็บไซต์ของคุณ กับรหัสผู้ใช้ Google ของผู้เสนอราคารายหนึ่งๆ โดยเฉพาะที่เกี่ยวข้อง และสร้างรายชื่อผู้ใช้ที่ช่วยให้คุณเลือกการเสนอราคาได้อย่างมีประสิทธิภาพมากขึ้น คู่มือนี้อธิบายแนวคิดที่ใช้ในการจับคู่คุกกี้ รวมถึงเวิร์กโฟลว์การจับคู่คุกกี้ต่างๆ และรูปแบบที่อาจมีสำหรับ Use Case บางอย่าง
แนวคิด
การจับคู่คุกกี้คืออะไร
โดยปกติแล้ว เจ้าของโดเมนจะตั้งค่าเนื้อหาของคุกกี้สำหรับผู้ใช้ที่เรียกดูเว็บไซต์ของตน ซึ่งใช้เพื่อระบุผู้ใช้ภายในโดเมนนั้น แม้ว่าเจ้าของโดเมน 2 รายจะตกลงแลกเปลี่ยนข้อมูลนี้ แต่โมเดลความปลอดภัยของอินเทอร์เน็ตเบราว์เซอร์จะจำกัดไม่ให้โดเมนหนึ่งอ่านคุกกี้ที่โดเมนอื่นตั้งค่าไว้
ในบริบทของการโฆษณาดิจิทัล Google จะระบุผู้ใช้ด้วยคุกกี้
ที่เป็นของโดเมน doubleclick.net และผู้เสนอราคา
ที่เข้าร่วมการเสนอราคาแบบเรียลไทม์อาจมีโดเมนของตนเองซึ่งใช้ระบุ
ชุดผู้ใช้บางกลุ่มที่ต้องการแสดงโฆษณา การจับคู่คุกกี้
ช่วยให้ผู้เสนอราคาสามารถจับคู่คุกกี้ของตนกับคุกกี้ของ Google เพื่อให้สามารถ
พิจารณาว่าการแสดงผลที่ส่งในคำขอราคาเสนอเชื่อมโยงกับผู้ใช้รายใดรายหนึ่ง
ที่กำหนดเป้าหมายไว้หรือไม่ โดยผู้เสนอราคาจะได้รับข้อมูลคุกกี้ของตนเองหรือ
รหัสผู้ใช้ Google ที่เฉพาะเจาะจงสำหรับผู้เสนอราคาซึ่งเป็นรูปแบบที่เข้ารหัสของ
doubleclick.net คุกกี้ในคำขอราคาเสนอ
บริการจับคู่คุกกี้ที่อธิบายไว้ในคู่มือนี้ช่วยให้สร้าง และรักษาการเชื่อมโยงระหว่างคุกกี้ของผู้เสนอราคาและรหัสผู้ใช้ของ Google รวมถึงช่วยให้สร้างรายการผู้ใช้ได้
ตารางที่ตรงกัน
คุณใช้ตารางการจับคู่เพื่อแมปรหัสหรือข้อมูลอื่นๆ จากโดเมนหนึ่งไปยังอีกโดเมนหนึ่งได้ ผู้เสนอราคาใช้บริการจับคู่คุกกี้เพื่อสร้างตารางการจับคู่ของตนเองได้โดยการแมปคุกกี้สำหรับผู้ใช้ที่เฉพาะเจาะจงกับรหัสผู้ใช้ Google ของผู้ใช้ หรือเพื่อสร้างตารางการจับคู่ที่ Google โฮสต์ ตารางการจับคู่เป็นสิ่งจำเป็นเพื่อให้แอปพลิเคชันของผู้เสนอราคาเข้าถึงข้อมูลคุกกี้ของผู้ใช้ที่เห็นการแสดงผลได้
ตารางการจับคู่ที่โฮสต์โดย Google
เราขอแนะนำให้คุณอนุญาตให้ Google โฮสต์ตารางการแข่งขันเพื่อการบำรุงรักษาที่ง่ายขึ้น การปรับปรุงเวลาในการตอบสนอง และการเข้าถึงข้อมูลการแข่งขันสำหรับ ผู้ใช้ในบางภูมิภาค ซึ่งจะช่วยให้คุณระบุสตริงที่เข้ารหัส Base64 ซึ่งใช้กับเว็บได้ - ต่อไปนี้จะเรียกว่าข้อมูลการจับคู่ที่โฮสต์ - ซึ่งจะได้รับการแมปกับ รหัสผู้ใช้ Google สำหรับผู้ใช้ที่ระบุ เมื่อจับคู่แล้ว คุณจะใช้ข้อมูลดังกล่าวได้ในลักษณะต่อไปนี้
การเสนอราคาแบบเรียลไทม์: ในคำขอราคาเสนอที่ตามมาสำหรับจำนวนการแสดงผล ที่เชื่อมโยงกับผู้ใช้ Google จะส่งข้อมูลการจับคู่ที่โฮสต์ซึ่งคุณ จับคู่กับรหัสผู้ใช้ Google ของผู้ใช้รายนั้นให้คุณ Google จะระบุ
BidRequest.user.buyeruidเป็นสตริงที่เข้ารหัส Web-safe base64กลุ่มเป้าหมายตามผู้ใช้: คุณสามารถสร้างกลุ่มเป้าหมายตามผู้ใช้ได้ โดยใช้รหัสผู้ใช้ Google หรือข้อมูลการจับคู่ที่โฮสต์
- การกำหนดเป้าหมายล่วงหน้า: คุณสามารถกำหนดค่าการกำหนดเป้าหมายล่วงหน้าเพื่อให้ได้รับเฉพาะคำขอราคาเสนอ ที่มีข้อมูลการจับคู่ที่โฮสต์ ซึ่งใช้เพื่อกำจัด การแสดงผลที่ไม่เกี่ยวข้องสำหรับผู้ใช้ภายนอกพื้นที่คุกกี้ได้
รายการผู้ใช้
คุณสร้างและจัดการรายชื่อผู้ใช้ได้ด้วย Real-Time Bidding API เมื่อสร้างแล้ว คุณจะสร้างรายการเหล่านี้ได้โดยใช้เวิร์กโฟลว์การจับคู่คุกกี้ต่อไปนี้ หรือผ่านบริการอัปโหลดหลายรายการพร้อมกัน
เริ่มต้นใช้งาน
หากต้องการเริ่มต้นใช้งานการจับคู่คุกกี้ คุณต้องติดต่อผู้จัดการลูกค้าด้านเทคนิค ซึ่งจะเปิดใช้เวิร์กโฟลว์ที่เฉพาะเจาะจงและช่วยคุณกำหนดค่าสิ่งต่อไปนี้ได้
- รหัสเครือข่ายการจับคู่คุกกี้ (NID): รหัสสตริงที่ใช้ระบุบัญชีผู้เสนอราคาสำหรับการจับคู่คุกกี้และการดำเนินการอื่นๆ ที่เกี่ยวข้องได้โดยไม่ซ้ำกัน
- URL การจับคู่คุกกี้: URL ฐานสำหรับปลายทางที่จะยอมรับ และจัดการคำขอที่เข้ามาโดยเป็นส่วนหนึ่งของเวิร์กโฟลว์การจับคู่คุกกี้ ผู้เสนอราคาฝังมาโครใน URL นี้เพื่อ ควบคุมลำดับของพารามิเตอร์ที่ส่งไปยัง URL ในเวิร์กโฟลว์การจับคู่คุกกี้ได้
- แท็กการจับคู่: แท็กที่คุณต้องวางในเบราว์เซอร์ของผู้ใช้สำหรับ เวิร์กโฟลว์การจับคู่คุกกี้ที่ผู้เสนอราคาเริ่มต้น ซึ่งอาจแสดงควบคู่ไปกับโฆษณา หรือวางในพร็อพเพอร์ตี้เว็บนอกโฆษณาก็ได้
- URL ของรายงานการจับคู่คุกกี้ (ไม่บังคับ): ในเวิร์กโฟลว์การจับคู่คุกกี้แบบทิศทางเดียว นี่คือ URL ที่ไม่บังคับซึ่งอาจให้ไว้ได้เพื่อระบุปลายทางที่จะรับรายละเอียดข้อผิดพลาดในกรณีที่การจับคู่คุกกี้ผ่านการเปลี่ยนเส้นทาง HTTP 302 ไม่สำเร็จ โดยค่าเริ่มต้น ระบบจะส่งการตอบกลับไปยัง URL นี้ก็ต่อเมื่อเกิดข้อผิดพลาดในการดำเนินการจับคู่คุกกี้ แต่ผู้เสนอราคาอาจขอให้ส่งการเปลี่ยนเส้นทางเสมอ
- URL ที่ช่วยในการจับคู่คุกกี้: สําหรับการแลกเปลี่ยนที่ใช้ เวิร์กโฟลว์ที่ช่วยในการจับคู่คุกกี้ นี่คือ URL ฐานของปลายทางที่ตั้งใจจะตอบสนองต่อคําขอที่เข้ามา
- โควต้าการช่วยจับคู่คุกกี้: สําหรับการแลกเปลี่ยนที่ใช้เวิร์กโฟลว์การช่วยจับคู่คุกกี้ นี่คือจํานวนคําขอสูงสุดที่ 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" />
คุณสามารถรวมพารามิเตอร์เพิ่มเติมไว้ในแท็กการจับคู่เพื่อตอบสนอง กรณีการใช้งานที่แตกต่างกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์เหล่านี้ได้ที่ พารามิเตอร์ 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 ซึ่งใช้กับเว็บได้และไม่มีการเพิ่ม Padding
สำหรับผู้เสนอราคาที่เลือกโฮสต์ตารางการจับคู่ เราขอแนะนำให้ผู้เสนอราคา
จัดเก็บสตริงที่แน่นอนซึ่งบริการจับคู่คุกกี้ส่งคืน ในคำขอราคาเสนอครั้งต่อๆ ไป
ค่านี้จะสอดคล้องกับค่าที่ระบุผ่าน
BidRequest.user.id
เวอร์ชันที่ระบุใน google_cver แสดงหมายเลขเวอร์ชันที่เป็นตัวเลข
สำหรับรหัสผู้ใช้ Google รหัสผู้ใช้ Google สำหรับผู้ใช้ที่ระบุจะมีการเปลี่ยนแปลงไม่บ่อยนัก
หลังจากนั้นระบบจะเพิ่มรหัสนี้
หาก Google พบข้อผิดพลาดขณะประมวลผลคำขอการจับคู่ ระบบจะระบุพารามิเตอร์
google_error แทน
ขั้นตอนที่ 3: ผู้เสนอราคาประมวลผลการเปลี่ยนเส้นทางและตอบกลับด้วยพิกเซล
ผู้เสนอราคาจะได้รับการเปลี่ยนเส้นทางไปยัง URL การจับคู่คุกกี้ของตนเอง ซึ่งรวมถึง พารามิเตอร์ที่ระบุไว้ในขั้นตอนแรก และพารามิเตอร์ที่ Google ระบุไว้ใน ขั้นตอนที่ 2 นอกจากนี้ ผู้ใช้จะได้รับคุกกี้ในส่วนหัว HTTP ด้วย หากการดำเนินการสำเร็จ ผู้เสนอราคาที่โฮสต์ตารางการจับคู่ของตนเอง จะจับคู่คุกกี้กับรหัสผู้ใช้ Google ที่รวมอยู่ในการตอบกลับได้ เราขอแนะนำให้ผู้เสนอราคาจัดเก็บสตริงที่แน่นอนซึ่งบริการจับคู่คุกกี้ส่งคืน
หากการดำเนินการไม่สำเร็จ ผู้เสนอราคาจะได้รับพารามิเตอร์
google_error ในการเปลี่ยนเส้นทาง ค่านี้เป็นค่าตัวเลข
ที่สอดคล้องกับสถานะข้อผิดพลาดต่างๆ ซึ่งระบุข้อผิดพลาดที่เฉพาะเจาะจงซึ่งเกิดขึ้น
ดูข้อมูลเพิ่มเติมเกี่ยวกับค่าข้อผิดพลาดที่อาจเกิดขึ้นได้ในคำอธิบายของพารามิเตอร์ URL 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 ที่แสดงถึงความยินยอมของผู้ใช้ปลายทาง ดูรายละเอียดเพิ่มเติมได้ที่ ข้อกำหนดด้านความยินยอมของผู้ใช้ใน EU หรือจะมีการส่งสตริง 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: ผู้ใช้ล้างคุกกี้และท่องเว็บไซต์
เจนล้างแคชของคุกกี้ทั้งหมด จากนั้นผู้ใช้จะไปที่หน้าแรกของ 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 ตั้งค่าไว้ และคุกกี้ของ 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ในตารางการจับคู่ และพบคุกกี้ที่เชื่อมโยงกับเจนซึ่งสร้างขึ้นเมื่อสัปดาห์ก่อน (ในสถานการณ์ที่ 1) - ตามข้อมูลที่เชื่อมโยงกับคุกกี้ ตรรกะการเสนอราคาของ FinestDSP จะเสนอราคาสำหรับการแสดงผลและชนะการประมูล
- เจนอาจเห็นโฆษณาที่ปรับให้เหมาะกับความสนใจของตนเอง โดยอิงตามข้อมูล ที่ FinestDSP มี
การจับคู่คุกกี้แบบทิศทางเดียวที่ผู้เสนอราคาเริ่มต้น
การจับคู่คุกกี้แบบทางเดียวคล้ายกับเวิร์กโฟลว์แบบสองทาง
ยกเว้นว่ามีการปรับเปลี่ยนเพื่อให้เฉพาะ 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 แบบ Web-safe 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 นอกจากนี้ ผู้เสนอราคายัง
ป้อนข้อมูลรายการผู้ใช้โดยใช้ข้อมูลการจับคู่ที่โฮสต์ซึ่งระบุไว้ได้ด้วย
ไม่เช่นนั้น หากเกิดข้อผิดพลาด 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 เวอร์ชัน 2.0 ของ IAB สำหรับ Authorized Buyers
ตัวอย่าง: |
gdpr_consent |
สตริง TC ที่แสดงถึงความยินยอมของผู้ใช้ปลายทาง ดูรายละเอียดเพิ่มเติมได้ที่ ข้อกำหนดด้านความยินยอมของผู้ใช้ใน EU หรือจะมีการส่งสตริง 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 ระบุในคำขอ นอกจากนี้ คุณยังระบุพารามิเตอร์เพิ่มเติม
เพื่อรองรับกรณีการใช้งานเพิ่มเติมได้เช่นเดียวกับเวิร์กโฟลว์ที่ผู้เสนอราคาเริ่มต้น