การปรับเปลี่ยน Conversion

ใช้เมธอด IngestEvents เพื่อปรับ Conversion โฆษณาของ Google Ads ที่บันทึกไว้ก่อนหน้านี้ ใน Data Manager API การปรับเปลี่ยนสามารถเปลี่ยนมูลค่า Conversion หรือเสริมข้อมูลผู้ใช้ได้

หากคุณย้ายข้อมูลจาก Google Ads API โปรดดูอัปเกรดจาก Google Ads API เพื่อเปรียบเทียบวิธีจัดการการปรับใน API แต่ละรายการ

ประเภท Conversion ที่รองรับ

คุณสามารถปรับประเภท Conversion ของ Google Ads ต่อไปนี้ได้

วิธีการทำงานของการปรับเปลี่ยน

ในการกระทำที่ถือเป็น Conversion เดียวกัน Google Ads จะจับคู่เหตุการณ์โดยใช้ transactionId ดังนี้

  • หาก transactionId ตรงกับ Conversion ที่มีอยู่สําหรับการกระทําที่ถือเป็น Conversion เดียวกัน Data Manager API จะถือว่าคําขอเป็นการปรับ Conversion
  • หาก transactionId ไม่ตรงกับ Conversion ที่มีอยู่ Google Ads จะสร้าง Conversion ใหม่ ดูเหตุการณ์ที่ไม่ตรงกัน

ส่งการปรับเปลี่ยน

หากต้องการปรับ Conversion ที่มีอยู่ ให้ส่งคำขอ IngestEvents ที่มีข้อมูลต่อไปนี้

  • transactionId เดียวกันกับเหตุการณ์เดิม
  • ปลายทางและการกระทำที่ถือเป็น Conversion เดียวกันกับเหตุการณ์เดิม
  • ค่าที่อัปเดตสำหรับช่องที่ต้องการปรับ
  • ช่องทั้งหมดที่จำเป็นสำหรับเหตุการณ์ รวมถึงตัวระบุอย่างน้อย 1 รายการ เช่น adIdentifiers หรือ userData ดูข้อกำหนดด้านเหตุการณ์และตัวระบุสำหรับ Conversion ออฟไลน์หรือ Conversion จากหลายแหล่งที่มา

เราขอแนะนำให้ส่งตัวระบุเดียวกันกับที่คุณส่งหรือบันทึกไว้พร้อมกับเหตุการณ์เดิม หาก transactionId ไม่ตรงกับ Conversion ที่มีอยู่ Google Ads จะใช้ตัวระบุเหล่านี้เพื่อระบุแหล่งที่มาของ Conversion ใหม่

คุณไม่จำเป็นต้องระบุประเภทการปรับ Data Manager API จะอนุมานวิธีประมวลผลคำขอตาม transactionId และฟิลด์ที่คุณระบุ

ดูข้อมูลเพิ่มเติมเกี่ยวกับการส่งคำขอการนำเข้าได้ที่คู่มือการส่งเหตุการณ์สำหรับ Conversion ออฟไลน์หรือ Conversion จากหลายแหล่งที่มา

ฟิลด์ที่รองรับ

ตารางต่อไปนี้แสดงวิธีที่ Google Ads ใช้แต่ละช่องเมื่อเหตุการณ์ตรงกับ Conversion ที่มีอยู่

ช่อง พฤติกรรม
conversionValue, currency เขียนทับ ค่าใหม่จะแทนที่ค่าที่บันทึกไว้
userData เสริมหากเหตุการณ์เดิมไม่มีข้อมูลผู้ใช้ ไม่เช่นนั้นจะละเว้น
ฟิลด์อื่นๆ ทั้งหมด เช่น adIdentifiers.gclid ไม่ได้อัปเดต Google Ads จะเก็บค่าที่บันทึกไว้กับเหตุการณ์เดิม แต่ยังต้องมีช่องที่ต้องกรอกอยู่

มูลค่า Conversion

ส่ง conversionValue และ currency ใหม่เพื่อระบุมูลค่าของ Conversion ที่บันทึกไว้อีกครั้ง มูลค่าใหม่จะลบล้างมูลค่าที่บันทึกไว้ก่อนหน้านี้ในการรายงานและการเสนอราคา โดยไม่เพิ่มจำนวน Conversion

ข้อมูลผู้ใช้

ต่อไปนี้คือวิธีที่ Google Ads จัดการกับuserData เช่น อีเมลหรือหมายเลขโทรศัพท์

  • เสริมหากขาดหายไป: หากระบบบันทึกเหตุการณ์เดิมโดยไม่มีข้อมูลผู้ใช้ การปรับเปลี่ยนจะแนบข้อมูลผู้ใช้เพื่อปรับปรุงการระบุแหล่งที่มา

  • ละเว้นหากมีอยู่: หากแท็ก Google หรือการอัปโหลดก่อนหน้านี้บันทึกข้อมูลผู้ใช้ไว้แล้ว ระบบจะละเว้นข้อมูลผู้ใช้ใหม่ ระบบจะไม่เขียนทับหรือเพิ่มข้อมูลผู้ใช้ที่มีอยู่

ฟิลด์อื่นๆ

ตัวระบุและข้อมูลเมตาอื่นๆ นอกเหนือจากมูลค่า Conversion, สกุลเงิน และข้อมูลผู้ใช้ เช่น adIdentifiers.gclid ไม่สามารถอัปเดตสำหรับเหตุการณ์ที่ตรงกันได้ Google Ads จะเก็บมูลค่าที่บันทึกไว้พร้อมกับเหตุการณ์เดิม

คุณยังคงต้องระบุช่องเหล่านี้ที่จำเป็น เช่น ตัวระบุอย่างน้อย 1 รายการ Data Manager API จะตรวจสอบพารามิเตอร์เหล่านี้สําหรับทุกเหตุการณ์

เหตุการณ์ที่ไม่ตรงกัน

หาก transactionId ไม่ตรงกับเหตุการณ์ที่มีอยู่ ระบบจะถือว่าคำขอเป็นการอัปโหลด Conversion ใหม่แทนการปรับเปลี่ยน

Google Ads จะพยายามระบุแหล่งที่มาของ Conversion ใหม่เป็นการคลิกโฆษณาโดยใช้ตัวระบุที่คุณให้ไว้ เช่น adIdentifiers.gclid หรือ userData