Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

การแมปช่อง

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

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