การแมปช่อง

ใช้การแมปในตารางเพื่อแมป UploadClickConversionRequest ใน Google Ads API กับ IngestEventsRequest ที่เทียบเท่าใน Data Manager API

การตรวจสอบสิทธิ์

Data Manager API ต้องใช้ข้อมูลเข้าสู่ระบบที่มีขอบเขตแตกต่างจาก Google Ads API ทำตามขั้นตอนในตั้งค่าการเข้าถึง API เพื่อสร้างข้อมูลเข้าสู่ระบบใหม่ที่มีขอบเขต Data Manager API

ช่องคำขอ

UploadClickConversionRequest (Google Ads API) IngestEventsRequest (Data Manager API) หมายเหตุ
  • customer_id
  • ส่วนหัวของคำขอ developer-token
  • ส่วนหัวของคำขอ login-customer_id
  • ส่วนหัวของคำขอ linked-customer-id
  • conversion_action
 destinations ดูช่องลูกค้าและการกระทำที่ถือเป็น Conversion
ไม่มีเวอร์ชันเทียบเท่า consent การตั้งค่าความยินยอมเริ่มต้นที่ไม่บังคับสําหรับเหตุการณ์ในคําขอ คุณสามารถลบล้างค่านี้สำหรับแต่ละเหตุการณ์ได้โดยตั้งค่าช่อง consent ของ Event
ไม่มีเวอร์ชันเทียบเท่า encoding ต้องระบุ: ตั้งค่าเป็น Encoding ที่ใช้สำหรับค่า UserIdentifier
ไม่มีเวอร์ชันเทียบเท่า encryption_info ตั้งค่าหากคำขอมีค่าที่เข้ารหัส ดูรายละเอียดได้ที่การเข้ารหัส
job_id ไม่มีเวอร์ชันเทียบเท่า ใช้ request_id ที่แสดงในการตอบกลับเพื่อเรียกข้อมูลการวินิจฉัย
partial_failure ไม่มีเวอร์ชันเทียบเท่า Data Manager API ใช้โมเดลข้อผิดพลาดแบบ Fast-Fail หากช่องใดช่องหนึ่งของ IngestEventsRequest ไม่ผ่านการตรวจสอบความถูกต้อง Data Manager API จะปฏิเสธคำขอทั้งหมด
validate_only validate_only
conversions events รายการ Conversion หรือเหตุการณ์ ดูรายละเอียดได้ที่ส่วนช่อง Conversion

ช่องลูกค้าและการกระทำที่ถือเป็น Conversion

Google Ads API ต้องใช้ส่วนหัวของคำขอ developer-token และคุณต้องตั้งค่าส่วนหัวของคำขอ login-customer-id และ linked-customer-id สำหรับสถานการณ์การตรวจสอบสิทธิ์ที่แตกต่างกัน

Data Manager API ไม่ต้องใช้โทเค็นของนักพัฒนาซอฟต์แวร์ และคุณระบุข้อมูลการเข้าสู่ระบบและข้อมูลลูกค้าที่ลิงก์โดยใช้ช่องของ Destination แทนส่วนหัวของคำขอ ดูข้อมูลเพิ่มเติมเกี่ยวกับปลายทางได้ที่กำหนดค่าปลายทาง

วิธีแมปช่อง Google Ads API สำหรับ conversion_action รายการกับช่องที่เทียบเท่าใน Destination มีดังนี้

Google Ads API Destination (Data Manager API) หมายเหตุ
customer_idของคำขอ operating_account ตั้งค่า account_id เป็นรหัสลูกค้าของบัญชี Conversion ของ Google Ads ซึ่งอาจแตกต่างจาก customer_id ในคําขอ Google Ads API ตั้งค่า account_type ของ operating_account เป็น GOOGLE_ADS
ส่วนหัวของคำขอ developer-token ไม่มีเวอร์ชันเทียบเท่า Data Manager API ไม่จำเป็นต้องใช้โทเค็นของนักพัฒนาซอฟต์แวร์
ส่วนหัวของคำขอ login-customer-id login_account ตั้งค่า account_id เป็นรหัสลูกค้าของบัญชีที่เข้าสู่ระบบ ตั้งค่า account_type เป็น GOOGLE_ADS หากบัญชีที่เข้าสู่ระบบเป็นบัญชี Google Ads หรือ DATA_PARTNER หากบัญชีที่เข้าสู่ระบบเป็นบัญชีพาร์ทเนอร์ด้านข้อมูล
ส่วนหัวของคำขอ linked-customer-id linked_account หากคุณเข้าถึง operating_account โดยใช้ลิงก์พาร์ทเนอร์ ให้ตั้งค่า account_id เป็นรหัสลูกค้าของบัญชีที่ลิงก์ และตั้งค่า account_type เป็น DATA_PARTNER มิเช่นนั้น อย่าตั้งค่าช่อง linked_account
conversion_action ของ ClickConversion product_destination_id ตั้งค่าเป็นรหัสตัวเลขของการกระทำที่ถือเป็น Conversion อย่าใช้ชื่อทรัพยากรของ ConversionAction
ไม่มีเวอร์ชันเทียบเท่า reference ตัวระบุที่ผู้ใช้กำหนดสำหรับ Destination ตั้งค่าช่องนี้หากคุณส่ง Conversion สําหรับการกระทําที่ถือเป็น Conversion หลายรายการในคําขอเดียว

ช่อง Conversion

ClickConversion (Google Ads API) Event (Data Manager API) หมายเหตุ
cart_data cart_data ดูรายละเอียดได้ที่ฟิลด์ข้อมูลรถเข็นช็อปปิ้ง
consent consent API ทั้ง 2 รายการใช้ออบเจ็กต์ Consent ที่คล้ายกัน (ad_user_data, ad_personalization)
สำหรับ Data Manager API คุณยังตั้งค่าความยินยอมสำหรับเหตุการณ์ทั้งหมดในคำขอได้ด้วยการตั้งค่าช่อง consent ระดับคำขอ
conversion_action destination_references หากส่ง Conversion สําหรับการกระทําที่ถือเป็น Conversion หลายรายการในคําขอเดียว ให้ตั้งค่าช่องนี้เป็น reference ที่สอดคล้องกันของปลายทาง
conversion_date_time event_timestamp
ดูรายละเอียดได้ที่รูปแบบการประทับเวลา
conversion_environment ไม่มีเวอร์ชันเทียบเท่า
conversion_value conversion_value ตั้งค่าเป็นค่าสกุลเงิน ไม่ใช่ค่าในหน่วยไมโคร เช่น สำหรับมูลค่า Conversion 150.23 บาท ให้ใช้ค่า 5.23
currency_code currency
custom_variables custom_variables ดูรายละเอียดได้ที่ช่องตัวแปรที่กำหนดเอง
customer_type user_properties.customer_type ตั้งค่าเป็นค่าใน enum CustomerType
ไม่มีเวอร์ชันเทียบเท่า event_source
ไม่มีเวอร์ชันเทียบเท่า event_device_info
external_attribution_data ไม่มีเวอร์ชันเทียบเท่า
gbraid ad_identifiers.gbraid
gclid ad_identifiers.gclid
ไม่มีเวอร์ชันเทียบเท่า last_updated_timestamp
order_id transaction_id
session_attributes_encoded ad_identifiers.session_attributes โปรดดูรายละเอียดที่หัวข้อเพิ่มแอตทริบิวต์เซสชัน
session_attributes_key_value_pairs experimental_fields โปรดดูรายละเอียดที่หัวข้อเพิ่มแอตทริบิวต์เซสชัน
user_identifiers user_data.user_identifiers ดูรายละเอียดได้ที่ช่องตัวระบุผู้ใช้
user_ip_address landing_page_device_info.ip_address
wbraid ad_identifiers.wbraid

ฟิลด์ข้อมูลรถเข็นช็อปปิ้ง

CartData (Google Ads API) CartData (Data Manager API) หมายเหตุ
feed_country_code merchant_feed_label ตั้งค่าเป็นป้ายกำกับฟีด
feed_language_code merchant_feed_language_code
items items
local_transaction_cost transaction_discount
merchant_id merchant_id

ฟิลด์สินค้าสำหรับข้อมูลรถเข็นช็อปปิ้ง

Item (Google Ads API) Item (Data Manager API) หมายเหตุ
product_id merchant_product_id
quantity quantity
unit_price unit_price
ไม่มีเวอร์ชันเทียบเท่า item_id
ไม่มีเวอร์ชันเทียบเท่า additional_item_parameters

ช่องตัวแปรที่กำหนดเอง

CustomVariable (Google Ads API) CustomVariable (Data Manager API) หมายเหตุ
ไม่มีเวอร์ชันเทียบเท่า destination_references Google Ads API ต้องใช้คําขอแยกต่างหากสําหรับการกระทําที่ถือเป็น Conversion แต่ละรายการ Data Manager API รองรับการส่ง Conversion สําหรับการกระทําที่ถือเป็น Conversion หลายรายการในคําขอเดียว รวมถึงการใช้ช่อง destination_references นี้เพื่อระบุปลายทางที่ควรได้รับตัวแปรที่กําหนดเองที่เฉพาะเจาะจง
conversion_custom_variable variable ตั้งค่าเป็นชื่อของตัวแปรแทนชื่อทรัพยากร
value value

ฟิลด์ตัวระบุผู้ใช้

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API)
address_info address ทำตามหลักเกณฑ์การจัดรูปแบบและการแฮช นอกจากนี้ คุณยังเข้ารหัสแอตทริบิวต์ที่แฮชของที่อยู่ได้ด้วย
hashed_email email_address ตั้งค่าเป็นอีเมลที่จัดรูปแบบและแฮชแล้ว นอกจากนี้ คุณยังเข้ารหัสอีเมลที่แฮชได้ด้วย
hashed_phone_number phone_number ตั้งค่าเป็นหมายเลขโทรศัพท์ที่จัดรูปแบบและแฮชแล้ว นอกจากนี้ คุณยังเข้ารหัสหมายเลขโทรศัพท์ที่แฮชได้ด้วย
ช่องอื่นๆ ดังนี้
  • mobile_id
  • third_party_user_id
  • user_identifier_source
 ไม่เกี่ยวข้อง API ทั้ง 2 รายการไม่รองรับตัวระบุเหล่านี้สําหรับ Conversion ออฟไลน์หรือ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย และ Data Manager API ไม่รองรับตัวระบุเหล่านี้เมื่อส่งเหตุการณ์ Conversion เป็นแหล่งข้อมูลเพิ่มเติม

ช่องคำตอบ

UploadClickConversionResponse (Google Ads API) IngestEventsResponse (Data Manager API) หมายเหตุ
job_id ไม่มีเวอร์ชันเทียบเท่า ใช้ request_id ที่แสดงในการตอบกลับเพื่อเรียกข้อมูลการวินิจฉัย
partial_failure_error ไม่มีเวอร์ชันเทียบเท่า Data Manager API ใช้โมเดลข้อผิดพลาดแบบ Fast-Fail หากช่องใดช่องหนึ่งของ IngestEventsRequest ไม่ผ่านการตรวจสอบความถูกต้อง Data Manager API จะปฏิเสธคำขอทั้งหมด
ส่วนหัวการตอบกลับ request-id request_id ระบบจะแสดงรหัสคำขอเป็นช่องการตอบกลับใน Data Manager API แทนที่จะเป็นส่วนหัวการตอบกลับ
results ไม่มีเวอร์ชันเทียบเท่า Data Manager API จะประมวลผลเหตุการณ์แบบอะซิงโครนัส ตรวจสอบผลการประมวลผลโดยใช้การวินิจฉัย
ก่อนหน้า
ขั้นตอนในการอัปเกรด