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

การจับคู่คุกกี้เป็นฟีเจอร์ที่ช่วยให้คุณจับคู่คุกกี้ของคุณได้ เช่น รหัสสำหรับผู้ใช้ที่เรียกดูเว็บไซต์ของคุณ กับรหัสผู้ใช้ 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 ทางหมายถึงเวิร์กโฟลว์ที่ผู้เสนอราคาเริ่มต้น โดยผู้เสนอราคาจะวางแท็กการจับคู่ในเบราว์เซอร์ของผู้ใช้ซึ่งจะนำผู้ใช้ไปยัง 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 ไบต์ เช่น Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u
google_redir สตริงที่เข้ารหัส URL ซึ่งผู้เสนอราคาจะระบุได้หากต้องการให้ Google ส่งHTTP 302การเปลี่ยนเส้นทางไปยัง URL ที่เข้ารหัสสำหรับ แท็กการจับคู่นี้ ซึ่งจะช่วยให้ Google อยู่ด้านหน้าในการเรียกที่เชื่อมโยง ไปยังพาร์ทเนอร์ ซึ่งจะทำให้เกิดข้อผิดพลาดหากระบุโดยไม่มี google_hm หรือมี google_cm
google_ula สตริงที่ใช้เพื่อเพิ่มผู้ใช้ลงในกลุ่มเป้าหมายตามข้อมูลผู้ใช้ที่มีอยู่ รูปแบบที่คาดไว้ของค่า คือ userlistid[,timestamp]
  • userlistid: รหัสรายชื่อผู้ใช้ที่เป็นตัวเลขเดียว
  • timestamp: การประทับเวลาที่ไม่บังคับในรูปแบบ POSIX ซึ่งระบุเวลาที่เพิ่มผู้ใช้ลงในรายชื่อผู้ใช้

พารามิเตอร์ URL นี้อาจซ้ำกันเพื่อเพิ่มผู้ใช้ไปยังรายการหลายรายการ ได้
gdpr ระบุว่าคำขออยู่ภายใต้ข้อจำกัดของ GDPR เกี่ยวกับการใช้ข้อมูล ดูรายละเอียดเพิ่มเติมได้ที่ ข้อกำหนดด้านความยินยอมของผู้ใช้ EU หรือผลกระทบต่อการมีสิทธิ์ ในการจับคู่คุกกี้ใน เอกสารประกอบ TCF เวอร์ชัน 2.0 ของ IAB สำหรับ Authorized Buyers

ตัวอย่าง: gdpr=1
gdpr_consent สตริง TC ที่แสดงถึงความยินยอมของผู้ใช้ปลายทาง ดูรายละเอียดเพิ่มเติมได้ที่ ข้อกำหนดด้านความยินยอมของผู้ใช้ใน EU หรือจะมีการส่งสตริง TC อย่างไร ใน เอกสารประกอบ TCF เวอร์ชัน 2.0 ของ IAB สำหรับ Authorized Buyers
process_consent ระบุว่าผู้เสนอราคาได้รับความยินยอมจากผู้ใช้ปลายทางสำหรับการใช้ข้อมูลที่ระบุไว้ใน นโยบายความยินยอมของผู้ใช้ EU ของ Google

หากคำขอไม่อยู่ภายใต้นโยบายความยินยอมของผู้ใช้ EU หรือหากมีพารามิเตอร์ความยินยอมอื่นๆ ในคำขอ (gdpr_consent) ระบบจะไม่สนใจพารามิเตอร์นี้

ตัวอย่าง: process_consent=T

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

  • 1: ผู้ใช้มีคุกกี้ของ Google แต่เลือกไม่ใช้การติดตามใดๆ โดยใช้คุกกี้นี้
  • 2: ไม่ได้ระบุการดำเนินการที่ถูกต้อง เช่น ได้รับคำขอที่ไม่มีการดำเนินการ ใดๆ
  • 3: ผู้ใช้ไม่มีคุกกี้ของ Google Google จะไม่ ตั้งค่าคุกกี้ผ่านบริการการจับคู่คุกกี้
  • 4: มีการระบุการดำเนินการที่ขัดแย้งกัน คุณไม่ได้รับอนุญาตให้ระบุทั้งแฟล็ก google_push และ google_cm ในคำขอเดียวกันเนื่องจากมีวัตถุประสงค์ที่ขัดแย้งกัน
  • 5: มีการส่งพารามิเตอร์ google_push ที่ไม่ถูกต้อง ในการเปลี่ยนเส้นทางไปยังเซิร์ฟเวอร์ของ Google ซึ่งเป็นส่วนหนึ่งของคำขอจับคู่พิกเซลแบบ 2 ทาง การเปลี่ยนเส้นทางต้องตั้งค่า google_push เป็นค่าเดียวกันกับที่ส่งให้คุณในคำขอพิกเซลเริ่มต้น
  • 6: มีการระบุ NID ที่ไม่ถูกต้องในแท็กการจับคู่
  • 7: ตรวจพบคุกกี้ที่ไม่ถูกต้อง
  • 8: เลิกใช้งานแล้ว ไม่พบคุกกี้
  • 9: ไม่พบคุกกี้ ระบบจะพยายามตั้งค่าคุกกี้ทดสอบ
  • 10: มีการใช้พารามิเตอร์ google_redir โดยไม่ได้ระบุ google_hm หรือใช้ร่วมกับ google_cm
  • 15: คำขอมาจากภูมิภาคที่ Google กำหนดให้ Google เป็นผู้โฮสต์ตารางการจับคู่ ด้วยเหตุนี้ การตอบกลับนี้จึงไม่มีรหัสผู้ใช้ Google
google_hm

จะปรากฏก็ต่อเมื่อความพยายามในการเขียนไปยังตารางการจับคู่ที่ Google โฮสต์ไม่สำเร็จ เมื่อเกิดเหตุการณ์ดังกล่าว ค่าจะเป็นรหัสสถานะอย่างใดอย่างหนึ่งต่อไปนี้

  • 1 - Forbidden: ลูกค้าไม่มีสิทธิ์เขียนรายการตารางการจับคู่ที่โฮสต์
  • 2 - ข้อผิดพลาดในการถอดรหัส: ถอดรหัสค่าพารามิเตอร์ไม่ได้
  • 3 - เพย์โหลดยาวเกินไป: ค่าพารามิเตอร์ที่ถอดรหัสเป็นข้อมูลมากกว่า 40 ไบต์
  • 4 - ข้อผิดพลาดภายใน: เกิดข้อผิดพลาดภายในขณะจัดเก็บ ข้อมูล
  • 5 - ถูกควบคุม: ระบบไม่ได้ประมวลผลการเขียนนี้เนื่องจาก การควบคุม
google_ula

สถานะของการดำเนินการเพิ่มกลุ่มเป้าหมายตามข้อมูลผู้ใช้ ซึ่งจะทำซ้ำหากมีการระบุ google_ula หลายรายการในคำขอ รูปแบบคือ
userlistid,status code

ตัวอย่าง: google_ula=1234567890,0

การดำเนินการ google_ula อาจแสดงรหัสสถานะต่อไปนี้

  • 0 - ไม่มีข้อผิดพลาด ระบบได้เพิ่มผู้ใช้ลงในรายชื่อผู้ใช้แล้ว
  • 2 - สิทธิ์ถูกปฏิเสธ คุณไม่มีสิทธิ์เพิ่มผู้ใช้ลงในรายชื่อผู้ใช้ที่ระบุ
  • 5 - รหัสรายชื่อผู้ใช้ไม่ถูกต้อง รหัสรายชื่อผู้ใช้ที่ระบุไม่ถูกต้อง
  • 6 - รหัสแอตทริบิวต์ที่ปิด รหัสรายชื่อผู้ใช้ที่ระบุปิดอยู่
  • 10 - ข้อผิดพลาดภายใน บริการการจับคู่คุกกี้พบข้อผิดพลาดภายใน คุณลองจับคู่ผู้ใช้อีกครั้งได้

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

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

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

ปลายทางการจับคู่คุกกี้ของผู้เสนอราคาต้องเปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ของ Google ซึ่งรวมถึงพารามิเตอร์ google_hm ที่มีข้อมูลคุกกี้ที่เข้ารหัส Base64 แบบ Web-safe URL เปลี่ยนเส้นทางอาจมีลักษณะดังนี้ 

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA

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" />

เบราว์เซอร์ของผู้ใช้จะเปลี่ยนเส้นทางไปยัง URL รายงานการจับคู่คุกกี้ของผู้เสนอราคา รวมถึงเหตุผลของข้อผิดพลาด (หากมี) ที่ Google ระบุใน พารามิเตอร์ google_error ดูข้อมูลเพิ่มเติมเกี่ยวกับการตีความรหัสข้อผิดพลาดได้ที่คำอธิบายพารามิเตอร์

ขั้นตอนที่ 6: ผู้เสนอราคาแสดงพิกเซลโปร่งใสขนาด 1x1

ผู้เสนอราคาต้องตอบกลับโดยแสดงพิกเซล 1x1 แบบโปร่งใสต่อเบราว์เซอร์ของผู้ใช้

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

พารามิเตอร์ คำอธิบาย
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]
  • userlistid: รหัสรายชื่อผู้ใช้ที่เป็นตัวเลขเดียว
  • timestamp: การประทับเวลาที่ไม่บังคับในรูปแบบ POSIX ซึ่งระบุเวลาที่เพิ่มผู้ใช้ลงในรายชื่อผู้ใช้

พารามิเตอร์ URL นี้อาจซ้ำกันเพื่อเพิ่มผู้ใช้ไปยังรายการหลายรายการ ได้
gdpr ระบุว่าคำขออยู่ภายใต้ข้อจำกัดของ GDPR เกี่ยวกับการใช้ข้อมูล ดูรายละเอียดเพิ่มเติมได้ที่ ข้อกำหนดด้านความยินยอมของผู้ใช้ EU หรือผลกระทบต่อการมีสิทธิ์ ในการจับคู่คุกกี้ใน เอกสารประกอบ TCF เวอร์ชัน 2.0 ของ IAB สำหรับ Authorized Buyers

ตัวอย่าง: gdpr=1
gdpr_consent สตริง TC ที่แสดงถึงความยินยอมของผู้ใช้ปลายทาง ดูรายละเอียดเพิ่มเติมได้ที่ ข้อกำหนดด้านความยินยอมของผู้ใช้ใน EU หรือจะมีการส่งสตริง TC อย่างไร ใน เอกสารประกอบ TCF เวอร์ชัน 2.0 ของ IAB สำหรับ Authorized Buyers
process_consent ระบุว่าผู้เสนอราคาได้รับความยินยอมจากผู้ใช้ปลายทางสำหรับการใช้ข้อมูลที่ระบุไว้ใน นโยบายความยินยอมของผู้ใช้ EU ของ Google

หากคำขอไม่อยู่ภายใต้นโยบายความยินยอมของผู้ใช้ EU หรือหากมีพารามิเตอร์ความยินยอมอื่นๆ ในคำขอ (gdpr_consent) ระบบจะไม่สนใจพารามิเตอร์นี้

ตัวอย่าง: process_consent=T
พารามิเตอร์ คำอธิบาย
google_error

ค่าจำนวนเต็มที่ระบุข้อผิดพลาดของคำขอโดยรวม เมื่อได้รับ จะหมายความว่าไม่มีการดำเนินการใดๆ และจะไม่ตั้งค่าพารามิเตอร์การตอบกลับอื่นๆ ของ google_ ค่าข้อผิดพลาดที่รองรับ มีดังนี้

  • 1: ผู้ใช้มีคุกกี้ของ Google แต่เลือกไม่ใช้การติดตามใดๆ โดยใช้คุกกี้นี้
  • 2: ไม่ได้ระบุการดำเนินการที่ถูกต้อง เช่น ได้รับคำขอที่ไม่มีการดำเนินการ ใดๆ
  • 3: ผู้ใช้ไม่มีคุกกี้ของ Google Google จะไม่ ตั้งค่าคุกกี้ผ่านบริการการจับคู่คุกกี้
  • 4: มีการระบุการดำเนินการที่ขัดแย้งกัน คุณไม่ได้รับอนุญาตให้ระบุทั้งแฟล็ก google_push และ google_cm ในคำขอเดียวกันเนื่องจากมีวัตถุประสงค์ที่ขัดแย้งกัน
  • 5: มีการส่งพารามิเตอร์ google_push ที่ไม่ถูกต้อง ในการเปลี่ยนเส้นทางไปยังเซิร์ฟเวอร์ของ Google ซึ่งเป็นส่วนหนึ่งของคำขอจับคู่พิกเซลแบบ 2 ทาง การเปลี่ยนเส้นทางต้องตั้งค่า google_push เป็นค่าเดียวกันกับที่ส่งให้คุณในคำขอพิกเซลเริ่มต้น
  • 6: มีการระบุ NID ที่ไม่ถูกต้องในแท็กการจับคู่
  • 7: ตรวจพบคุกกี้ที่ไม่ถูกต้อง
  • 8: เลิกใช้งานแล้ว ไม่พบคุกกี้
  • 9: ไม่พบคุกกี้ ระบบจะพยายามตั้งค่าคุกกี้ทดสอบ
  • 10: มีการใช้พารามิเตอร์ google_redir โดยไม่ได้ระบุ google_hm หรือใช้ร่วมกับ google_cm
  • 15: คำขอมาจากภูมิภาคที่ Google กำหนดให้ Google เป็นผู้โฮสต์ตารางการจับคู่ ด้วยเหตุนี้ การตอบกลับนี้จึงไม่มีรหัสผู้ใช้ Google

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" />

ผู้เสนอราคาที่ได้รับคำขอการจับคู่พิกเซลจะต้องตอบกลับด้วยการเปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ของ 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 v2.0 ของ IAB สำหรับ Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378)

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

พารามิเตอร์ คำอธิบาย
google_nid รหัสเครือข่าย (NID) สำหรับบัญชีผู้เสนอราคา คุณเรียกข้อมูลรหัสนี้ได้ ผ่านแหล่งข้อมูลผู้เสนอราคา
google_push ระบุว่าการเปลี่ยนเส้นทางนี้ทำให้เวิร์กโฟลว์การจับคู่พิกเซลเสร็จสมบูรณ์ ต้องระบุค่าจากแท็กการจับคู่ของ Google ที่เกี่ยวข้องที่นี่
google_hm

มีข้อมูลที่ผู้เสนอราคาต้องการจัดเก็บไว้ในตารางการจับคู่ที่ Google โฮสต์

google_ula สตริงที่ใช้เพื่อเพิ่มผู้ใช้ลงในกลุ่มเป้าหมายตามข้อมูลผู้ใช้ที่มีอยู่ รูปแบบที่คาดไว้ของค่า คือ userlistid[,timestamp]
  • userlistid: รหัสรายชื่อผู้ใช้ที่เป็นตัวเลขเดียว
  • timestamp: การประทับเวลาที่ไม่บังคับในรูปแบบ POSIX ซึ่งระบุเวลาที่เพิ่มผู้ใช้ลงในรายชื่อผู้ใช้

พารามิเตอร์ URL นี้อาจซ้ำกันเพื่อเพิ่มผู้ใช้ไปยังรายการหลายรายการ ได้
gdpr_consent สตริง TC ที่แสดงถึงความยินยอมของผู้ใช้ปลายทาง ดูรายละเอียดเพิ่มเติมได้ที่ [ข้อกำหนดความยินยอมของผู้ใช้ EU](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) หรือ **ระบบจะส่งสตริง TC อย่างไร** ใน [เอกสารประกอบ TCF v2.0 ของ IAB สำหรับ Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378)

Google เริ่มต้น: การจับคู่พิกเซลแบบทางเดียว

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

ขั้นตอนที่ 1: Google วางแท็กการจับคู่

Google จะวางแท็กการจับคู่สำหรับผู้เสนอราคาที่เลือกโดยอัลกอริทึม แท็กการจับคู่มีพารามิเตอร์ google_push เช่น

<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />

ขั้นตอนที่ 2: เบราว์เซอร์ของผู้ใช้ขอพิกเซลจาก URL การจับคู่คุกกี้ของผู้เสนอราคา

เบราว์เซอร์ของผู้ใช้จะขอพิกเซลจาก URL การจับคู่คุกกี้ของผู้เสนอราคา รวมถึงคุกกี้ของผู้เสนอราคาในส่วนหัว HTTP

ปลายทางการจับคู่คุกกี้ของผู้เสนอราคาต้องเปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ของ Google ซึ่งรวมถึงพารามิเตอร์ google_hm ที่มีข้อมูลคุกกี้ที่เข้ารหัส Base64 แบบ Web-safe URL เปลี่ยนเส้นทางอาจมีลักษณะดังนี้ 

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA

Google จะได้รับการเปลี่ยนเส้นทางที่มีพารามิเตอร์ที่คุณระบุ นอกเหนือจากคุกกี้ของ Google ในส่วนหัว HTTP หากการดำเนินการสำเร็จ การแสดงผลสำหรับผู้ใช้รายนี้ในคำขอเสนอราคาที่ตามมาจะมีข้อมูลการจับคู่ที่ผู้เสนอราคาโฮสต์ใน BidRequest.user.buyeruid ผู้เสนอราคายังสามารถป้อนข้อมูลรายการผู้ใช้โดยใช้ข้อมูลการจับคู่ที่โฮสต์ซึ่งระบุไว้ได้ด้วย

สุดท้าย Google จะแสดงผลพิกเซล 1x1 แบบโปร่งใสไปยังเบราว์เซอร์ของผู้ใช้

การเสนอราคาแบบเปิดช่วยให้ Exchange ใช้เวิร์กโฟลว์การจับคู่คุกกี้ที่ผู้เสนอราคาเริ่มต้น และGoogle เริ่มต้น เพื่อจับคู่รหัสผู้ใช้ Google กับคุกกี้ของผู้ใช้ได้ Cookie Match Assist (CMA) เป็นฟีเจอร์เพิ่มเติมสำหรับ Exchange ที่ช่วยให้ Exchange สร้างตารางการจับคู่กับผู้เสนอราคาของตนเองได้

  1. เมื่อลงโฆษณา อัลกอริทึมของ Google จะเลือกการแลกเปลี่ยนที่เข้าร่วม และวางแท็กความช่วยเหลือในการจับคู่คุกกี้ที่มีโครงสร้างดังนี้ 

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

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

    ซึ่งแตกต่างจากเวิร์กโฟลว์ที่ Google เริ่มต้น
  3. ปลายทางการจับคู่คุกกี้ของ Exchange จะได้รับคำขอ ซึ่งบริการจับคู่คุกกี้ของ Exchange เองมีหน้าที่จับคู่รหัสผู้ใช้กับ ผู้เสนอราคารายใดรายหนึ่ง ในแผนภาพต่อไปนี้ บริการจับคู่คุกกี้ของ Exchange จะตอบกลับเบราว์เซอร์ของผู้ใช้ด้วยการเปลี่ยนเส้นทางไปยังปลายทางของผู้เสนอราคา รายใดรายหนึ่ง
  4. ผู้เสนอราคาจะได้รับคำขอพร้อมกับพารามิเตอร์ที่ Exchange ระบุเพื่อจับคู่รหัสผู้ใช้กับคุกกี้ของผู้เสนอราคา

ข้อจำกัด

กำหนดความถี่สูงสุดของคำขอการจับคู่ใหม่

ผู้เสนอราคามีหน้าที่จำกัดจำนวนการเรียกใช้บริการจับคู่คุกกี้สำหรับผู้ใช้ที่มีรายการใหม่ในตารางการจับคู่ที่ Google โฮสต์ รายการในตารางการแข่งขันที่โฮสต์อาจถือว่าหมดอายุใน 14 วัน หลังจากนั้นจะรีเฟรชได้

ตอบคำขอการจับคู่พิกเซลทั้งหมด

ผู้เสนอราคาที่ใช้เวิร์กโฟลว์การจับคู่พิกเซลจะต้องตอบกลับคำขอการจับคู่พิกเซลขาเข้าทั้งหมดด้วยการตอบกลับที่มีพารามิเตอร์ google_push ซึ่งจะช่วยให้ Google บังคับใช้นโยบายได้โดยการตรวจสอบการใช้งาน หากอัตราการตอบกลับของผู้เสนอราคาต่ำกว่า 90% Google จะจำกัดจำนวนคำขอการจับคู่พิกเซลที่ส่งไปยังบัญชีของผู้เสนอราคา

ใช้ปลายทาง HTTPS

ปลายทางที่ใช้ในเวิร์กโฟลว์การจับคู่คุกกี้ทั้งหมดต้องใช้ HTTPS

เมื่อตอบกลับคำขอพิกเซลที่ตรงกันซึ่งส่งถึงคุณผ่าน HTTPS คุณจะต้องเปลี่ยนเส้นทางไปยังบริการจับคู่คุกกี้ผ่าน HTTPS ในทำนองเดียวกัน ปลายทางความช่วยเหลือในการจับคู่คุกกี้ที่เปลี่ยนเส้นทางไปยังผู้เสนอราคาต้องใช้ HTTPS ด้วย หากคุณส่งคำขอไปยัง Google ผ่าน HTTP บ่อยกว่า 1 ครั้งทุก 2 นาที ระบบจะจำกัดจำนวนคำขอการจับคู่ที่ส่งไปยังบัญชีของคุณ

คำขอการจับคู่คุกกี้ที่อยู่ภายใต้นโยบายความยินยอมของผู้ใช้ EU ของ Google ควรระบุความยินยอมของผู้ใช้ปลายทาง คำขอดังกล่าวต้องระบุว่าได้รับความยินยอมโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้

ตัวอย่าง

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

ป้อนข้อมูลตารางการจับคู่ที่โฮสต์โดยผู้เสนอราคา

ผู้เสนอราคาใช้เวิร์กโฟลว์การจับคู่คุกกี้เพื่อสร้างตารางการจับคู่ของตนเองได้โดยระบุเฉพาะพารามิเตอร์ 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

หากผู้เสนอราคาใช้แท็กการจับคู่แทนโดยที่ค่าของ 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