การแมปช่อง

ใช้การแมปในตารางเพื่อแมป 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 ใช้รูปแบบข้อผิดพลาดแบบล้มเหลวอย่างรวดเร็ว หากฟิลด์ใดของ 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 ทั้ง 2 API ใช้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 ที่ $5.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
ไม่เกี่ยวข้อง ทั้ง 2 API ไม่รองรับตัวระบุเหล่านี้สําหรับ Conversion ออฟไลน์หรือ Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขาย และ Data Manager API ไม่รองรับตัวระบุเหล่านี้เมื่อส่งเหตุการณ์ Conversion เป็นแหล่งข้อมูลเพิ่มเติม

ฟิลด์การตอบกลับ

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