การแมปช่อง

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