อัปเกรดจาก Google Ads API

อัปเกรดการอัปโหลด Conversion จาก Google Ads API เป็น Data Manager API เพื่อเข้าถึงการปรับปรุงและฟีเจอร์ต่างๆ

ตารางต่อไปนี้เปรียบเทียบการใช้ Data Manager API กับ Google Ads API เพื่อจัดการ Conversion

Data Manager API Google Ads API
การรองรับการส่ง Conversion ออฟไลน์และ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย รองรับ รองรับ
รองรับการส่ง Conversion ของแท็ก Google Ads เป็นแหล่งข้อมูลเพิ่มเติมสําหรับ Conversion ของแท็ก เพื่อเพิ่มสัญญาณการโต้ตอบกับโฆษณาให้ได้สูงสุด รวมถึงเสริมความแข็งแกร่งให้กับข้อมูลและประสิทธิภาพโดยรวม รองรับ ไม่รองรับ
โมเดลข้อมูล โมเดลข้อมูลแบบรวมใน Use Case ของ Conversion ของ Google Ads ทั้งหมดและผลิตภัณฑ์โฆษณาทั้งหมดของ Google โมเดลข้อมูลมีไว้สําหรับกรณีการใช้งาน Google Ads เท่านั้น และจะแตกต่างกันไปตามกรณีการใช้งานแต่ละกรณี
การเข้ารหัส รองรับการเข้ารหัส ไม่รองรับ
โทเค็นของนักพัฒนา ไม่จำเป็น ต้องระบุ
รองรับการอัปโหลดแอตทริบิวต์เซสชันและที่อยู่ IP สําหรับเหตุการณ์ พร้อมให้บริการแก่ผู้ใช้ API ทุกคน พร้อมให้บริการแก่ผู้ใช้ API บางรายเท่านั้น
การปรับ Conversion รองรับในเมธอด IngestEvents แบบรวม ต้องใช้ ConversionAdjustmentUploadService แยกต่างหาก
โควต้าและขีดจำกัด โควต้าและขีดจำกัดต่อคำขอตามโปรเจ็กต์ โควต้าตามโทเค็นของนักพัฒนาซอฟต์แวร์และขีดจำกัดต่อคำขอ
โมเดลข้อผิดพลาด ใช้โมเดลการทำงานแบบ Fast-Fail ใช้โมเดลการดำเนินการที่ไม่สำเร็จบางส่วน

ความแตกต่างในข้อกำหนดของบัญชีปลายทาง

ใน Data Manager API operating_account ของปลายทางต้องเป็นลูกค้า Conversion โฆษณาของ Google Ads ซึ่งแตกต่างจาก Google Ads API

Google Ads API รองรับการส่ง Conversion สําหรับบัญชี Google Ads โดยใช้ customer_id ของรายการใดรายการหนึ่งต่อไปนี้

  1. ลูกค้า Conversion โฆษณาของ Google Ads

    Data Manager API รองรับแนวทางนี้

  2. บัญชีใดก็ตามที่เป็นบัญชีหลักหรือบัญชีสืบทอดของลูกค้า Conversion ของ Google Ads

    Data Manager API ไม่รองรับแนวทางนี้ หากคุณใช้ลักษณะการทำงานนี้ใน Google Ads API ให้เปลี่ยน operating_account ของปลายทางแต่ละแห่งเป็นเจ้าของการกระทำที่ถือเป็น Conversion ซึ่งอาจแตกต่างจาก customer_id ที่คุณใช้ในคำขอ Google Ads API

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

Data Manager API จะรวมการอัปโหลด Conversion เริ่มต้นและการปรับ Conversion ที่ตามมาไว้ในเมธอดเดียว

ใน Google Ads API ให้ทำดังนี้

  • การปรับ Conversion ต้องใช้เมธอด UploadConversionAdjustments แยกต่างหากใน ConversionAdjustmentUploadService
  • หากคุณพยายามอัปโหลด Conversion หลายรายการโดยใช้วิธี UploadClickConversions มาตรฐานสําหรับการกระทําที่ถือเป็น Conversion เดียวกันซึ่งมีรหัสธุรกรรมเดียวกัน (order_id) คำขอจะไม่สําเร็จ
  • คุณต้องระบุ ConversionAdjustmentType ในคำขอ

ใน Data Manager API ให้ทำดังนี้

  • การอัปโหลดและการปรับ Conversion จะใช้ปลายทาง IngestEvents แบบรวม
  • การอัปโหลดเหตุการณ์ที่มี transaction_id อยู่แล้วสําหรับการกระทําที่ถือเป็น Conversion เดียวกันซึ่งมีมูลค่า Conversion หรือข้อมูลผู้ใช้ที่อัปเดตจะได้รับการจัดการเป็นการปรับโดยอัตโนมัติ API จะไม่แสดงข้อผิดพลาดเกี่ยวกับรหัสธุรกรรมที่ซ้ำกัน
  • ไม่จำเป็นต้องระบุประเภทการปรับในคำขอ Data Manager API จะอนุมานวิธีประมวลผลการปรับเปลี่ยนตามฟิลด์ที่ระบุในเหตุการณ์
  • Data Manager API ไม่รองรับการเพิกถอน Conversion ซึ่งแตกต่างจาก Google Ads API โดยการเพิกถอน Conversion จะนำ Conversion ที่บันทึกไว้ก่อนหน้านี้ออกโดยสมบูรณ์ด้วยการตั้งค่ามูลค่า Conversion และจำนวน Conversion เป็น 0 คุณสามารถเปลี่ยนมูลค่าของ Conversion ได้ แต่จำนวน Conversion จะยังคงเท่าเดิม

ดูรายละเอียดเพิ่มเติมได้ที่การปรับ Conversion

ถัดไป
ขั้นตอนในการอัปเกรด