คำถามที่พบบ่อย

มีข้อจำกัดเกี่ยวกับสิ่งที่ฉันอัปโหลดได้ไหม

ข้อจำกัดที่ควรทราบมีดังนี้

  • คำขอ batchinsert และ batchupdate แต่ละรายการจำกัดไว้ที่ 1,000 Conversion
  • การประทับเวลาการเกิด Conversion ต้องมีอายุไม่เกิน 28 วันนับจากเวลาที่ส่ง
  • คุณสามารถส่ง Conversion ไปยังการกำหนดค่า Floodlight ที่โปรไฟล์ผู้ใช้ Campaign Manager 360 ของคุณมีสิทธิ์เข้าถึงเท่านั้น
ฉันควรใช้ Campaign Manager 360 หรือ Search Ads 360 เพื่ออัปโหลด Conversion

ดูการเปรียบเทียบฟีเจอร์ที่ผลิตภัณฑ์ทั้ง 2 รายการมีให้โดยละเอียดได้ที่ศูนย์ช่วยเหลือของ Search Ads 360

จะเกิดอะไรขึ้นหากฉันแทรก Conversion เดียวกันลงในทั้ง Campaign Manager 360 และ Search Ads 360

หากคุณแทรก Conversion เดียวกันลงในทั้ง Campaign Manager 360 และ Search Ads 360 ระบบจะไม่กรองรายการที่ซ้ำกันออก ในกรณีนี้ ให้ใช้กิจกรรม Floodlight แยกกัน

ฉันควรใช้ API ใดเพื่ออัปโหลด Conversion ออฟไลน์

เราขอแนะนำให้ใช้ Data Manager API เพื่อประสบการณ์ในการใช้งานที่ดีขึ้นสำหรับนักพัฒนาซอฟต์แวร์และสิทธิ์เข้าถึงฟีเจอร์เพิ่มเติม

ค่าลำดับคืออะไรและนำไปใช้อย่างไร

ค่าลำดับจะควบคุมวิธีประมวลผล Conversion ที่ซ้ำกัน หากมีการแทรก Conversion หลายรายการที่มีกิจกรรม Floodlight, รหัสการกำหนดค่า Floodlight, ตัวระบุผู้ใช้ และการประทับเวลา Conversion เดียวกัน ระบบจะใช้เลขลำดับเพื่อพิจารณาสิ่งต่อไปนี้

  • ระบบจะกรอง Conversion ที่ซ้ำกันออกและเก็บไว้เพียงรายการเดียว กรณีนี้จะเกิดขึ้นหาก Conversion ทั้งหมดมีค่าลำดับเหมือนกัน
  • ระบบจะประมวลผล Conversion ทีละรายการและเก็บไว้ทั้งหมด กรณีนี้จะเกิดขึ้นหาก Conversion ทั้งหมดมีค่าลำดับแตกต่างกัน

ค่าเหล่านี้ไม่จำเป็นต้องมีความหมาย โดยทั่วไปแล้ว การใช้มูลค่าคงที่ (เช่น 1) สำหรับ Conversion ทั้งหมดจะเปิดใช้การกรองข้อมูลที่ซ้ำกันออก การใช้มูลค่าแบบสุ่มหรือไม่ซ้ำกันสำหรับ Conversion แต่ละรายการจะปิดใช้การนับนี้

ฉันควรจัดการข้อผิดพลาดในการตอบกลับจาก API อย่างไร และควรลองอีกครั้งเมื่อพบข้อผิดพลาดใด

batchinsert และ batchupdate จะประมวลผล Conversion ตามความสามารถสูงสุด: คำขอแบบกลุ่มสามารถแสดงผลการตอบกลับ HTTP 200 OK ขณะที่ Conversion แต่ละรายการภายในกลุ่มล้มเหลว ตรวจสอบ hasFailures ในการตอบกลับและตรวจสอบรายการ errors[] ในออบเจ็กต์ ConversionStatus แต่ละรายการเสมอ

  • INTERNAL (ลองอีกครั้ง): เกิดข้อผิดพลาดชั่วคราวภายในระบบของ Google ขณะประมวลผล Conversion ระบบไม่ได้แทรกหรืออัปเดต Conversion ลองอัปโหลด Conversion ที่ไม่สําเร็จอีกครั้งโดยใช้ Exponential Backoff (เช่น เริ่มหลังจากผ่านไป 2-3 นาที แล้วลองอีกครั้งในช่วงหลายชั่วโมง) โดยใช้ ordinal, timestampMicros, floodlightActivityId และตัวระบุผู้ใช้หรือการคลิกเดิม
  • NOT_FOUND (ลองอีกครั้งโดยหน่วงเวลา): ไม่พบตัวระบุ (gclid, dclid, matchId หรือ mobileDeviceId) หรือ Conversion ที่มีอยู่ซึ่งกำลังแก้ไข เนื่องจากการคลิกออนไลน์ แท็ก Floodlight และ Conversion อาจใช้เวลา 1-2 ชั่วโมงในการประมวลผลและจัดทำดัชนี ให้ลองส่ง Conversion NOT_FOUND อีกครั้งเป็นระยะๆ (เช่น ทุก 1-3 ชั่วโมง เป็นเวลาสูงสุด 6 ชั่วโมง) หาก NOT_FOUND ยังคงอยู่หลังจากผ่านไป 6 ชั่วโมง โปรดดูสาเหตุที่พบบ่อยตามประเภทตัวระบุในส่วนต่อไปนี้
  • INVALID_ARGUMENT และ PERMISSION_DENIED (ไม่ต้องลองอีกครั้ง): ข้อมูล Conversion ไม่ถูกต้อง (เช่น การประทับเวลา Conversion เก่ากว่า 28 วันหรือฟิลด์มีรูปแบบไม่ถูกต้อง) หรือโปรไฟล์ผู้ใช้ไม่มีสิทธิ์สำหรับการกำหนดค่า Floodlight เป้าหมาย อย่าลองทำ Conversion เหล่านี้ซ้ำโดยไม่แก้ไขปัญหาที่เกี่ยวข้อง

หากคำขอ HTTP ทั้งหมดล้มเหลวเนื่องจากข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ 5xx หรือข้อผิดพลาดเกี่ยวกับโควต้า/ขีดจำกัดอัตรา 429 ให้ลองส่งคำขออีกครั้งโดยใช้ Exponential Backoff

การลองใหม่และการกรองข้อมูลที่ซ้ำกันออกอย่างปลอดภัย: เมื่อลองส่ง Conversion ที่ล้มเหลว อีกครั้งด้วย INTERNAL หรือ NOT_FOUND (หรือหลังจากหมดเวลา HTTP 5xx โดยไม่ทราบ ผลลัพธ์) ให้ส่ง ordinal และ timestampMicros เดิมทุกประการเสมอ หากมีการบันทึก Conversion ไว้แล้ว Campaign Manager 360 จะกรองข้อมูลที่ซ้ำกันออกโดยอัตโนมัติตามordinal, ตัวระบุผู้ใช้, กิจกรรม Floodlight และวันที่เกิด Conversion

การอัปโหลด mobileDeviceId ไม่สำเร็จเนื่องจากข้อผิดพลาด NOT_FOUND หมายความว่าอย่างไร

สาเหตุที่พบบ่อยที่สุดของข้อผิดพลาดนี้คือ

  • mobileDeviceId ไม่ถูกต้อง
  • Search Ads 360 ไม่รู้จัก mobileDeviceId ซึ่งหมายความว่าอุปกรณ์ยังไม่ได้รับโฆษณาจาก Campaign Manager 360
การอัปโหลด gclid ไม่สำเร็จเนื่องจากข้อผิดพลาด NOT_FOUND หมายความว่าอย่างไร

สาเหตุที่พบบ่อยที่สุดของข้อผิดพลาดนี้คือ

  • gclid ไม่ถูกต้อง
  • gclid ไม่ได้เชื่อมโยงกับแคมเปญ Search Ads 360 หรือรายการโฆษณา YouTube ของ Display & Video 360 กรณีนี้อาจเกิดขึ้นหากรวบรวม gclid จากการเปลี่ยนเส้นทางการคลิก Google Ads ซึ่งไม่ได้ผ่าน Search Ads 360 (เช่น การคลิกส่วนขยายสถานที่ตั้ง) หรือรวบรวมจากการเปลี่ยนเส้นทางการคลิกโฆษณา YouTube ที่ไม่เชื่อมโยงกับรายการโฆษณา YouTube ของ Display & Video 360
  • การคลิกที่เชื่อมโยงกับ gclid เกิดขึ้นนานเกินไปแล้ว คุณจะแทรก Conversion ได้เฉพาะสําหรับคลิกที่มีอายุไม่เกิน 60 วันเท่านั้น
  • การคลิกที่เชื่อมโยงกับ gclid เกิดขึ้นเร็วเกินไป เราขอแนะนําให้เลื่อนการอัปโหลด Conversion ที่อิงตาม gclid ออกไป 1 ชั่วโมงเพื่อให้แน่ใจว่าระบบประมวลผล gclid และพร้อมสําหรับการจับคู่แล้ว
การอัปโหลด dclid ไม่สำเร็จเนื่องจากข้อผิดพลาด NOT_FOUND หมายความว่าอย่างไร

สาเหตุที่พบบ่อยที่สุดของข้อผิดพลาดนี้คือ

  • dclid ไม่ถูกต้อง
  • การคลิกที่เชื่อมโยงกับ dclid เกิดขึ้นนานเกินไป คุณจะแทรก Conversion ได้เฉพาะสําหรับคลิกที่มีอายุไม่เกิน 60 วันเท่านั้น
  • การคลิกที่เชื่อมโยงกับ dclid เกิดขึ้นเร็วเกินไป เราขอแนะนําให้เลื่อนการอัปโหลด Conversion ที่อิงตาม dclid ออกไป 1 ชั่วโมงเพื่อให้แน่ใจว่าระบบประมวลผล dclid และพร้อมสําหรับการจับคู่
การอัปโหลด matchId ไม่สำเร็จเนื่องจากข้อผิดพลาด NOT_FOUND หมายความว่าอย่างไร

สาเหตุที่พบบ่อยที่สุดของข้อผิดพลาดนี้คือ

  • Campaign Manager 360 ไม่รู้จัก matchId กรณีนี้อาจเกิดขึ้นหากมีการรวบรวม matchId จากการเรียก Floodlight ซึ่งไม่ได้ผ่าน Campaign Manager 360 อย่างถูกต้อง (ตรวจสอบว่าการเรียก Floodlight ทำงานอย่างถูกต้อง รวมถึงพารามิเตอร์แท็ก matchId)
  • การเรียกใช้ Floodlight ที่เชื่อมโยงกับ matchId ไม่มีคุกกี้ การเรียกใช้ Floodlight ต้องมีคุกกี้ / ตัวระบุเพื่อให้ Campaign Manager 360 จัดเก็บ matchId ได้อย่างถูกต้อง (เช่น ผู้ใช้อาจบล็อกคุกกี้หรือเลือกไม่ใช้)
  • การเรียก Floodlight ที่เชื่อมโยงกับ matchId เกิดขึ้นนานเกินไปแล้ว การอัปโหลด Conversion ออฟไลน์ต้องดำเนินการภายใน 60 วันนับจากการเรียก Floodlight ที่มี matchId
  • การเรียก Floodlight ที่เชื่อมโยงกับ matchId เกิดขึ้นเร็วเกินไป เราขอแนะนําให้เลื่อนการอัปโหลด Conversion ที่อิงตาม matchId ออกไป 2 ชั่วโมงเพื่อให้แน่ใจว่าระบบประมวลผล matchId และพร้อมสําหรับการจับคู่
Conversion ออฟไลน์ที่มีการประทับเวลาก่อนการสร้างกิจกรรม Floodlight จะรวมอยู่ในรายงานหรือไม่

การอัปโหลด Conversion ออฟไลน์ที่มีการประทับเวลาก่อนการสร้างกิจกรรม Floodlight อาจได้รับการรายงานเป็นการแสดงผล Floodlight และเป็น Conversion ที่ไม่มีการระบุแหล่งที่มา/มีการระบุแหล่งที่มา โดยย้อนหลังได้สูงสุด 28 วันนับจากเวลาที่ส่ง อย่างไรก็ตาม เราไม่รับประกันลักษณะการทำงานนี้และคุณไม่ควรพึ่งพาลักษณะการทำงานดังกล่าว แนวทางปฏิบัติแนะนำคือการสร้างกิจกรรม Floodlight ก่อนการประทับเวลาที่เร็วที่สุดของ Conversion ออฟไลน์

ต้องได้รับความยินยอมใดบ้างจึงจะใช้การแทรก Conversion ออฟไลน์สําหรับการสร้างรายการกลุ่มเป้าหมายได้

นอกเหนือจากความยินยอมให้ใช้ข้อมูลผู้ใช้โฆษณาแล้ว คุณต้องตั้งค่าช่อง nonPersonalizedAd เป็น false อย่างชัดแจ้งเพื่อเปิดใช้การสร้างรายการกลุ่มเป้าหมาย