Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

การแมปช่อง

ใช้การแมปในตารางเพื่อแมป 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`	ไม่มีเวอร์ชันเทียบเท่า	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 ตั้งค่า `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`	หากใช้รูปแบบ 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`

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

`UserIdentifier` (Google Ads API)	`UserIdentifier` (Data Manager API)
`address_info`	`address`	ทำตามหลักเกณฑ์การจัดรูปแบบและการแฮชformatting and hashing guidelines นอกจากนี้ คุณยังเข้ารหัสแอตทริบิวต์ที่แฮชของที่อยู่ได้ด้วย
`hashed_email`	`email_address`	ตั้งค่าเป็นอีเมลที่จัดรูปแบบและแฮชแล้ว นอกจากนี้ คุณยังเข้ารหัสอีเมลที่แฮชแล้วได้ด้วย
`hashed_phone_number`	`phone_number`	ตั้งค่าเป็นหมายเลขโทรศัพท์ที่จัดรูปแบบและแฮชแล้ว นอกจากนี้ คุณยังเข้ารหัสหมายเลขโทรศัพท์ที่แฮชแล้วได้ด้วย
ฟิลด์อื่นๆ: `mobile_id` `third_party_user_id` `user_identifier_source`	ไม่เกี่ยวข้อง	ไม่มี 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` ส่วนหัวการตอบกลับ response header	`request_id`	ระบบจะแสดงรหัสคำขอเป็นฟิลด์คำตอบใน Data Manager API แทนที่จะเป็นส่วนหัวการตอบกลับ
`results`	ไม่มีเวอร์ชันเทียบเท่า	Data Manager API จะประมวลผลเหตุการณ์แบบไม่พร้อมกัน ตรวจสอบผลการประมวลผลโดยใช้การวินิจฉัย

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