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

การแมปช่อง

ใช้การแมปในตารางเพื่อแมป conversions.batchinsert ใน Campaign Manager 360 API กับ IngestEventsRequest ที่เทียบเท่าใน Data Manager API

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

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

ฟิลด์คำขอ

`conversions.batchinsert` (Campaign Manager 360 API)	`IngestEventsRequest` (Data Manager API)	หมายเหตุ
`profileId` พารามิเตอร์เส้นทาง URL	ไม่มีเวอร์ชันเทียบเท่า
`kind`	ไม่มีเวอร์ชันเทียบเท่า	ฟิลด์ข้อมูลเมตา ซึ่ง Data Manager API ไม่ได้ใช้
`conversions`	`events`	ต้องระบุ รายการ Conversion หรือเหตุการณ์ ดูรายละเอียดได้ที่ส่วนฟิลด์ Conversion
`encryptionInfo`	ย้ายไปยัง `events.adIdentifiers.encryptedUserIds` แล้ว	กําหนดที่ระดับเหตุการณ์ ตอนนี้ข้อมูลการเข้ารหัสของ Campaign Manager 360 จะระบุไว้ในรหัสผู้ใช้ที่เข้ารหัสแต่ละรายการแล้ว ดูส่วนฟิลด์ Conversion
ไม่มีเวอร์ชันเทียบเท่า	`encryptionInfo`	`encryptionInfo`ระดับคำขอคือข้อมูลการเข้ารหัสสำหรับตัวระบุผู้ใช้ `UserData` ที่เข้ารหัส ดูรายละเอียดได้ที่การเข้ารหัส
ไม่มีเวอร์ชันเทียบเท่า	`destinations`	ต้องระบุ รายการออบเจ็กต์ `Destination` ที่กําหนดบัญชีเป้าหมายและกิจกรรม Floodlight สําหรับเหตุการณ์ ดูรายละเอียดได้จากคำแนะนำเกี่ยวกับปลายทาง แมปฟิลด์แต่ละรายการตามที่แสดงในส่วนฟิลด์ Conversion
ไม่มีเวอร์ชันเทียบเท่า	`consent`	การตั้งค่าความยินยอมเริ่มต้นที่ไม่บังคับสําหรับเหตุการณ์ในคําขอ คุณสามารถลบล้างค่านี้สำหรับกิจกรรมแต่ละรายการได้โดยการตั้งค่าฟิลด์ `consent` ของ `Event`
ไม่มีเวอร์ชันเทียบเท่า	`encoding`	ต้องระบุหากส่งตัวระบุผู้ใช้: ตั้งค่าเป็น `Encoding` ที่ใช้สำหรับค่า `UserIdentifier` หากไม่ได้ใช้ตัวระบุผู้ใช้ ระบบจะไม่สนใจช่องนี้
ไม่มีเวอร์ชันเทียบเท่า	`validateOnly`	หากเป็นจริง ระบบจะตรวจสอบคำขอ แต่จะไม่ดำเนินการ

ฟิลด์ Conversion

`Conversion` (Campaign Manager 360 API)	`Event` (Data Manager API)	หมายเหตุ
`floodlightConfigurationId`	`destinations[].operatingAccount.accountId`	กำหนดที่ระดับคำขอ ตั้งค่าเป็นรหัสการกำหนดค่า Floodlight
ไม่มีเวอร์ชันเทียบเท่า	`destinations[].operatingAccount.accountType`	กำหนดที่ระดับคำขอ ตั้งค่าเป็น `FLOODLIGHT_CONFIG`
`floodlightActivityId`	`destinations[].productDestinationId`	กำหนดที่ระดับคำขอ ตั้งค่าเป็นรหัสกิจกรรม Floodlight
`kind`	ไม่มีเวอร์ชันเทียบเท่า	ฟิลด์ข้อมูลเมตา ซึ่ง Data Manager API ไม่ได้ใช้
ไม่มีเวอร์ชันเทียบเท่า	`destinations[].reference`	กำหนดที่ระดับคำขอ ตัวระบุที่ผู้ใช้กำหนดสำหรับปลายทาง ตั้งค่าฟิลด์นี้หากคุณส่งเหตุการณ์ไปยังปลายทางหลายแห่งในคำขอเดียว
`adUserDataConsent`	`consent.adUserData`	ดูรายละเอียดเพิ่มเติมได้ที่ `Consent`
`nonPersonalizedAd`	`consent.adPersonalization`	ดูรายละเอียดเพิ่มเติมได้ที่ `Consent`
ไม่มีเวอร์ชันเทียบเท่า	`destinationReferences`	หากส่งเหตุการณ์ไปยังปลายทางหลายแห่งในคำขอเดียว ให้ตั้งค่าฟิลด์นี้เป็น `reference` ที่เกี่ยวข้องของปลายทาง
`timestampMicros`	`eventTimestamp`	หากใช้รูปแบบ JSON ให้ตั้งค่าเป็นรูปแบบ RFC 3339 ซึ่งแตกต่างจาก Campaign Manager 360 API เล็กน้อย ซึ่งคาดหวัง `timestampMicros` ในหน่วยไมโครวินาทีตั้งแต่ยุค Unix หากใช้บัฟเฟอร์โปรโตคอล ให้ใช้ `Timestamp` และตั้งค่าช่อง `seconds` และ (ไม่บังคับ) `nanoseconds` ดูรายละเอียดได้ที่รูปแบบการประทับเวลา
`value`	`conversionValue`
`quantity`	`conversionCount`
`ordinal`	ไม่มีเวอร์ชันเทียบเท่า	ฟิลด์ `ordinal` จาก Campaign Manager 360 API จะไม่อยู่ใน Data Manager API แต่ Data Manager API จะใช้ `transactionId` เพื่อ ขจัดเหตุการณ์ที่ซ้ำกันซึ่งส่งไปยังรหัสกิจกรรม Floodlight เดียวกัน ใน Campaign Manager 360 API คุณสามารถตรวจสอบว่าระบบจะขจัดเหตุการณ์ที่ซ้ำกันได้โดยการตั้งค่า `ordinal`เป็นค่าคงที่ เช่น `1` ใน Data Manager API `transactionId` ต้องตั้งค่าเป็นตัวระบุที่ไม่ซ้ำกันสำหรับแต่ละเหตุการณ์
ไม่มีเวอร์ชันเทียบเท่า	`transactionId`	Data Manager API ใช้รหัสกิจกรรม Floodlight และ `transactionId`ร่วมกันเพื่อขจัดเหตุการณ์ที่ซ้ำกัน ฟิลด์ `transactionId` ต้องตั้งค่าเป็นตัวระบุที่ไม่ซ้ำกันสำหรับแต่ละเหตุการณ์ ต้องระบุหากส่งเหตุการณ์สําหรับ Conversion จากหลายแหล่งที่มา ดูรายละเอียดเพิ่มเติมได้ที่แปลงข้อมูลเป็นออบเจ็กต์ `Event`
`customVariables`	`customVariables`	รายการออบเจ็กต์ `CustomVariable` Data Manager API ใช้สตริงเป็นคีย์แทน Enum ใช้คีย์ เช่น `U1`, `U2` สำหรับฟิลด์ `variable`
`limitAdTracking`	`consent.adPersonalization`	ดูรายละเอียดเพิ่มเติมได้ที่ `Consent`
`childDirectedTreatment`	`consent.adPersonalization`	ดูรายละเอียดเพิ่มเติมได้ที่ `Consent`
`treatmentForUnderage`	`consent.adPersonalization`	ดูรายละเอียดเพิ่มเติมได้ที่ `Consent`
`gclid`	`adIdentifiers.gclid`	ดูรายละเอียดเพิ่มเติมได้ที่ `AdIdentifiers`
`dclid`	`adIdentifiers.dclid`	ดูรายละเอียดเพิ่มเติมได้ที่ `AdIdentifiers`
`matchId`	`adIdentifiers.matchId`	ดูรายละเอียดเพิ่มเติมได้ที่ `AdIdentifiers`
`mobileDeviceId`	`adIdentifiers.mobileId`	ดูรายละเอียดเพิ่มเติมได้ที่ `AdIdentifiers`
`impressionId`	`adIdentifiers.impressionId`	ดูรายละเอียดเพิ่มเติมได้ที่ `AdIdentifiers`
`encryptedUserId`	`adIdentifiers.encryptedUserIds`	Data Manager API รองรับรหัสผู้ใช้ที่เข้ารหัสหลายรายการ ดูรายละเอียดเพิ่มเติมได้ที่ `AdIdentifiers`
`encryptedUserIdCandidates`	`adIdentifiers.encryptedUserIds`	รหัสผู้สมัครแต่ละรายการจะแมปกับออบเจ็กต์ `EncryptedUserId` ในรายการ
`encryptionInfo.kind`	ไม่มีเวอร์ชันเทียบเท่า	ฟิลด์ข้อมูลเมตา ซึ่ง Data Manager API ไม่ได้ใช้
`encryptionInfo.encryptionEntityType`	`adIdentifiers.encryptedUserIds[].entityType`	แทนที่จะระบุข้อมูลการเข้ารหัส 1 ครั้งต่อคำขอ ให้ระบุต่อ User ID ที่เข้ารหัส
`encryptionInfo.encryptionEntityId`	`adIdentifiers.encryptedUserIds[].entityId`	แทนที่จะระบุข้อมูลการเข้ารหัส 1 ครั้งต่อคำขอ ให้ระบุต่อ User ID ที่เข้ารหัส
`encryptionInfo.encryptionSource`	`adIdentifiers.encryptedUserIds[].source`	แทนที่จะระบุข้อมูลการเข้ารหัส 1 ครั้งต่อคำขอ ให้ระบุต่อ User ID ที่เข้ารหัส
`sessionAttributesEncoded`	`adIdentifiers.sessionAttributes`	ดูรายละเอียดเพิ่มเติมได้ที่ `AdIdentifiers`
`cartData`	`cartData`	ดูรายละเอียดได้ที่ช่องข้อมูลรถเข็นช็อปปิ้ง
`userIdentifiers`	`userData.userIdentifiers`	ดูรายละเอียดได้ที่ฟิลด์ตัวระบุผู้ใช้

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

ใน Data Manager API ตัวระบุผู้ใช้จะจัดกลุ่มไว้ในออบเจ็กต์ UserData ภายในฟิลด์ userData ของ Event ซึ่งแตกต่างจาก Campaign Manager 360 API ที่ตัวระบุจะแนบกับออบเจ็กต์ Conversion โดยตรง

`UserIdentifier` (Campaign Manager 360 API)	`UserIdentifier` (Data Manager API)	หมายเหตุ
`hashedEmail`	`emailAddress`	ตั้งค่าเป็นอีเมลที่จัดรูปแบบและแฮชแล้ว นอกจากนี้ คุณยังเข้ารหัสอีเมลที่แฮชแล้วได้ด้วย
`hashedPhoneNumber`	`phoneNumber`	ตั้งค่าเป็นหมายเลขโทรศัพท์ที่จัดรูปแบบและแฮช คุณยังเข้ารหัสหมายเลขโทรศัพท์ที่แฮชแล้วได้ด้วย
`addressInfo`	`address`	ตั้งค่าเป็นออบเจ็กต์ `AddressInfo` ปฏิบัติตามหลักเกณฑ์การจัดรูปแบบและการแฮช นอกจากนี้ คุณยังเข้ารหัสแอตทริบิวต์ที่แฮชของที่อยู่ได้ด้วย
`addressInfo.hashedFirstName`	`address.givenName`
`addressInfo.hashedLastName`	`address.familyName`
`addressInfo.countryCode`	`address.regionCode`
`addressInfo.postalCode`	`address.postalCode`
`addressInfo.city`	ไม่มีเวอร์ชันเทียบเท่า	ไม่รองรับปลายทาง Campaign Manager 360
`addressInfo.state`	ไม่มีเวอร์ชันเทียบเท่า	ไม่รองรับปลายทาง Campaign Manager 360
`addressInfo.hashedStreetAddress`	ไม่มีเวอร์ชันเทียบเท่า	ไม่รองรับปลายทาง Campaign Manager 360

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

`CartData` (Campaign Manager 360 API)	`CartData` (Data Manager API)	หมายเหตุ
`kind`	ไม่มีเวอร์ชันเทียบเท่า	ฟิลด์ข้อมูลเมตา ซึ่ง Data Manager API ไม่ได้ใช้
`merchantId`	`merchantId`
`merchantFeedLabel`	`merchantFeedLabel`
`merchantFeedLanguage`	`merchantFeedLanguageCode`
`items`	`items`	รายการออบเจ็กต์ `Item` ดูรายละเอียดเพิ่มเติมได้ที่ฟิลด์รายการ

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

`Item` (Campaign Manager 360 API)	`Item` (Data Manager API)	หมายเหตุ
`kind`	ไม่มีเวอร์ชันเทียบเท่า	ฟิลด์ข้อมูลเมตา ซึ่ง Data Manager API ไม่ได้ใช้
ไม่มีเวอร์ชันเทียบเท่า	`itemId`	ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับสินค้า
`itemId`	`merchantProductId`	ต้องระบุ ตั้งค่าเป็นรหัสผลิตภัณฑ์ Merchant Center สำหรับสินค้า
`quantity`	`quantity`	ต้องระบุ
`unitPrice`	`unitPrice`	ต้องระบุ

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