การแมปช่อง

ใช้การแมปในตารางเพื่อแมป 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) หมายเหตุ
พารามิเตอร์เส้นทาง URL profileId ไม่มีเวอร์ชันเทียบเท่า
kind ไม่มีเวอร์ชันเทียบเท่า ฟิลด์ข้อมูลเมตา ซึ่ง Data Manager API ไม่ได้ใช้
conversions events ต้องระบุ รายการ Conversion หรือเหตุการณ์ ดูรายละเอียดได้ในส่วนฟิลด์ Conversion
encryptionInfo ย้ายไปยัง events.adIdentifiers.encryptedUserIds กำหนดไว้ที่ระดับเหตุการณ์ ตอนนี้ข้อมูลการเข้ารหัสของ Campaign Manager 360 จะระบุไว้ในรหัสผู้ใช้ที่เข้ารหัสแต่ละรายการ ดูส่วนฟิลด์ Conversion
ไม่มีเวอร์ชันเทียบเท่า encryptionInfo `encryptionInfo` ระดับคำขอคือข้อมูลการเข้ารหัสสำหรับตัวระบุผู้ใช้ UserData ที่เข้ารหัสencryptionInfo ดูรายละเอียดได้ที่การเข้ารหัส
ไม่มีเวอร์ชันเทียบเท่า 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 epoch
  • หากใช้บัฟเฟอร์โปรโตคอล ให้ใช้ 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 ครั้งต่อคำขอ คุณจะระบุข้อมูลการเข้ารหัสต่อรหัสผู้ใช้ที่เข้ารหัส
encryptionInfo.encryptionEntityId adIdentifiers.encryptedUserIds[].entityId แทนที่จะระบุข้อมูลการเข้ารหัส 1 ครั้งต่อคำขอ คุณจะระบุข้อมูลการเข้ารหัสต่อรหัสผู้ใช้ที่เข้ารหัส
encryptionInfo.encryptionSource adIdentifiers.encryptedUserIds[].source แทนที่จะระบุข้อมูลการเข้ารหัส 1 ครั้งต่อคำขอ คุณจะระบุข้อมูลการเข้ารหัสต่อรหัสผู้ใช้ที่เข้ารหัส
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 ต้องระบุ
ก่อนหน้า
ขั้นตอนในการอัปเกรด