การแมปช่อง

ใช้การแมปในตารางเพื่อแมป conversions.batchinsert ใน Campaign Manager 360 API กับ IngestEventsRequest ที่เทียบเท่าใน 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ระดับคำขอ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 (เดิมเรียกว่ารหัสกิจกรรม 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 ในหน่วยไมโครวินาทีตั้งแต่ Epoch ของ Unix
  • หากใช้ Protocol Buffer ให้ใช้ Timestamp และตั้งค่าช่อง seconds และ (ไม่บังคับ) nanoseconds

ดูรายละเอียดได้ที่รูปแบบการประทับเวลา
value conversionValue
quantity conversionCount
ordinal ไม่มีเวอร์ชันเทียบเท่า ฟิลด์ ordinal จาก Campaign Manager 360 API จะไม่มีอยู่ใน Data Manager API แต่คุณสามารถใช้ transactionId เพื่อควบคุมวิธีที่ระบบกรองข้อมูล Conversion จากผู้ใช้รายเดียวกันและวันเดียวกันออก

ใน Campaign Manager 360 API คุณสามารถตรวจสอบว่าระบบจะขจัดเหตุการณ์ที่ซ้ำกันออกได้โดยการตั้งค่า ordinalเป็นค่าคงที่ เช่น 1 ใน Data Manager API transactionId ต้องตั้งค่าเป็นตัวระบุที่ไม่ซ้ำกันสำหรับแต่ละเหตุการณ์
ไม่มีเวอร์ชันเทียบเท่า transactionId ใน Data Manager API จะใช้ transactionId เพื่อควบคุมวิธีที่ระบบ กรองข้อมูล Conversion จากผู้ใช้รายเดียวกันและวันเดียวกันออก ต้องตั้งค่าฟิลด์นี้เป็นตัวระบุที่ไม่ซ้ำกันสำหรับแต่ละเหตุการณ์

ฟิลด์นี้ไม่บังคับเมื่อส่ง Conversion ออฟไลน์ของ Floodlight ดูรายละเอียดเพิ่มเติมได้ที่ แปลงข้อมูลเป็นออบเจ็กต์ 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 ไม่มีเวอร์ชันเทียบเท่า ไม่รองรับใน Data Manager API เวอร์ชันปัจจุบัน
addressInfo.state ไม่มีเวอร์ชันเทียบเท่า ไม่รองรับใน Data Manager API เวอร์ชันปัจจุบัน
addressInfo.hashedStreetAddress ไม่มีเวอร์ชันเทียบเท่า ไม่รองรับใน Data Manager API เวอร์ชันปัจจุบัน

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

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 ต้องระบุ
ก่อนหน้า
ขั้นตอนในการอัปเกรด