การแมปช่อง

ใช้การแมปในตารางเพื่อแมป UploadClickConversionRequest ใน Google Ads API กับ IngestEventsRequest ที่เทียบเท่าใน 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`	ไม่มีเวอร์ชันเทียบเท่า	API ของ Data Manager ไม่รองรับการทำงานล้มเหลวบางส่วน หากฟิลด์ใดของ `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 ตั้งค่า `account_type` ของ `operating_account` เป็น `GOOGLE_ADS` Data Manager API อาจต้องใช้รหัสลูกค้าที่แตกต่างจากรหัสที่คุณใช้สำหรับ Google Ads API โปรดดูรายละเอียดที่หัวข้อความแตกต่างของข้อกำหนดสำหรับบัญชีปลายทาง
`developer-token` ส่วนหัวของคำขอ	ไม่มีเวอร์ชันเทียบเท่า	ไม่จำเป็นต้องใช้โทเค็นของนักพัฒนาซอฟต์แวร์สำหรับ Data Manager API
`login-customer-id` ส่วนหัวของคำขอ	`login_account`	ตั้งค่า `account_id` เป็นรหัสลูกค้าของบัญชีที่ใช้เข้าสู่ระบบ ตั้งค่าเป็น `account_type` หากบัญชีที่ใช้เข้าสู่ระบบเป็นบัญชี Google Ads หรือ `DATA_PARTNER` หากบัญชีที่ใช้เข้าสู่ระบบเป็นบัญชีพาร์ทเนอร์ข้อมูล`GOOGLE_ADS`
`linked-customer-id` ส่วนหัวของคำขอ	`linked_account`	ตั้งค่า `account_id` เป็นรหัสลูกค้าของบัญชีที่ลิงก์ไว้ ตั้งค่า `account_type` เป็น `DATA_PARTNER`
`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`	หากใช้รูปแบบ JSON ให้ตั้งค่าเป็นค่าในรูปแบบ RFC 3339 ซึ่งแตกต่างจากรูปแบบวันที่และเวลาของ Google Ads API เล็กน้อย หากใช้บัฟเฟอร์โปรโตคอล ให้ใช้ `Timestamp` และตั้งค่าช่อง `seconds` และ (ไม่บังคับ) `nanoseconds` ดูรายละเอียดได้ที่รูปแบบการประทับเวลา
`conversion_environment`	ไม่มีเวอร์ชันเทียบเท่า
`conversion_value`	`conversion_value`	ตั้งค่าเป็นมูลค่าสกุลเงิน ไม่ใช่มูลค่าในหน่วยไมโคร เช่น สำหรับมูลค่า Conversion ที่ $5.23 ให้ใช้ค่า `5.23`
`currency_code`	`currency`
`custom_variables`	`custom_variables`	ดูรายละเอียดได้ที่ฟิลด์ตัวแปรที่กำหนดเอง
`customer_type`
ไม่มีเวอร์ชันเทียบเท่า	`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`

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

ClickConversion

`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`	ไม่มีเวอร์ชันเทียบเท่า	API ของ Data Manager ไม่รองรับการทำงานล้มเหลวบางส่วน หากฟิลด์ใดของ `IngestEventsRequest` ตรวจสอบไม่ผ่าน Data Manager API จะปฏิเสธคำขอทั้งหมด
`request-id` ส่วนหัวของการตอบกลับ	`request_id`	ระบบจะแสดงรหัสคำขอเป็นฟิลด์การตอบกลับใน Data Manager API แทนที่จะเป็นส่วนหัวของการตอบกลับ
`results`	ไม่มีเวอร์ชันเทียบเท่า	Data Manager API จะประมวลผลเหตุการณ์แบบไม่พร้อมกัน ตรวจสอบผลการประมวลผลโดยใช้การวินิจฉัย

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