การแมปช่อง

ใช้การแมปในตารางเพื่อแมปวิธีการจัดการกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า และฟิลด์ใน Display & Video 360 API กับรายการที่เทียบเท่าใน Data Manager API

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

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

การแมปวิธีการ

ตารางต่อไปนี้จะจับคู่เมธอด API ของ Display & Video 360 กับเมธอด API ของ Data Manager ที่เทียบเท่า

เมธอด Display & Video 360 API เมธอด Data Manager API หมายเหตุ
firstPartyAndPartnerAudiences.get userLists.get Data Manager API จะดึงข้อมูลได้เฉพาะกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า
firstPartyAndPartnerAudiences.list userLists.list Data Manager API จะแสดงเฉพาะกลุ่มเป้าหมายการจับคู่ข้อมูลลูกค้า
firstPartyAndPartnerAudiences.create userLists.create ต้องอัปโหลดข้อมูลผู้ใช้ในคำขอที่ตามมาใน Data Manager API
ไม่มีเวอร์ชันเทียบเท่า userLists.delete ไม่มีใน Display & Video 360 API
firstPartyAndPartnerAudiences.patch userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.ingest ระบบจะใช้วิธีการ Data Manager API แยกกันเพื่อเพิ่มและนำสมาชิกออกจากกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้า
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.remove ระบบจะใช้วิธีการ Data Manager API แยกกันเพื่อเพิ่มและนำสมาชิกออกจากกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้า

การแมปคำขอ

ตารางต่อไปนี้จะแมปฟิลด์คำขอของเมธอด Display & Video 360 API กับฟิลด์ที่เทียบเท่าใน Data Manager API

userLists.get

firstPartyAndPartnerAudiences.get (Display & Video 360 API) userLists.get (Data Manager API) หมายเหตุ
  • advertiserId
  • partnerId
  • firstPartyAndPartnerAudienceId
 name UserListชื่อประกอบด้วยทั้งรหัสของผู้ลงโฆษณาหลักหรือพาร์ทเนอร์ รวมถึงรหัสกลุ่มเป้าหมาย ดูรายละเอียดได้ที่ชื่อทรัพยากร

userLists.list

firstPartyAndPartnerAudiences.list (Display & Video 360 API) userLists.list (Data Manager API) หมายเหตุ
  • advertiserId
  • partnerId
 parent parent มีรหัสของผู้ลงโฆษณาหรือพาร์ทเนอร์หลัก
pageSize pageSize ขนาดหน้าเว็บสูงสุดใน Data Manager API คือ 1000
pageToken pageToken
filter filter
orderBy ไม่มีเวอร์ชันเทียบเท่า

userLists.create

firstPartyAndPartnerAudiences.create (Display & Video 360 API) userLists.create (Data Manager API) หมายเหตุ
  • advertiserId
  • partnerId
 parent parent มีรหัสของผู้ลงโฆษณาหลักหรือพาร์ทเนอร์ของกลุ่มเป้าหมายใหม่
ไม่มีเวอร์ชันเทียบเท่า validateOnly
FirstPartyAndPartnerAudience เนื้อหาคำขอ UserList เนื้อหาคำขอ ดูการแมปเนื้อหาคำขอได้ที่ UserList

userLists.update

firstPartyAndPartnerAudiences.patch (Display & Video 360 API) userLists.patch (Data Manager API) หมายเหตุ
  • advertiserId
  • firstPartyAndPartnerAudienceId
 พารามิเตอร์ userList.name ชื่อทรัพยากรของ UserList ที่จะอัปเดต
updateMask updateMask เราขอแนะนําให้ใช้ช่องนี้ใน Data Manager API แต่ไม่บังคับ และหากปล่อยว่างไว้ ระบบจะแทนที่ช่องทั้งหมดที่รวมไว้
ไม่มีเวอร์ชันเทียบเท่า validateOnly
FirstPartyAndPartnerAudience เนื้อหาคำขอ UserList เนื้อหาคำขอ ดูการแมปเนื้อหาคำขอได้ที่ UserList

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) audienceMembers.ingest (Data Manager API) หมายเหตุ
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations ดูรายละเอียดได้ที่หัวข้อกำหนดค่าปลายทาง
addedContactInfoList.contactInfos audienceMembers คุณตั้งค่าตัวระบุผู้ใช้แต่ละรายได้ในฟิลด์ compositeData.userData ภายในออบเจ็กต์ AudienceMember ดูรายละเอียดได้ที่ตัวระบุผู้ใช้
addedContactInfoList.consent consent นอกจากนี้ ยังตั้งค่าความยินยอมในออบเจ็กต์ AudienceMemberแต่ละรายการได้ด้วย
addedMobileDeviceIdList.mobileDeviceIds audienceMembers ระบบจะตั้งค่ารหัสอุปกรณ์เคลื่อนที่แต่ละรายการในช่อง mobileData ภายในออบเจ็กต์ AudienceMember
addedMobileDeviceIdList.consent consent นอกจากนี้ ยังตั้งค่าความยินยอมในออบเจ็กต์ AudienceMemberแต่ละรายการได้ด้วย
ไม่มีเวอร์ชันเทียบเท่า validateOnly
ไม่มีเวอร์ชันเทียบเท่า encoding ต้องระบุ ตั้งค่าเป็น Encoding ที่ใช้สำหรับค่า UserIdentifier
ไม่มีเวอร์ชันเทียบเท่า encryptionInfo ตั้งค่าหากคำขอมีค่าที่เข้ารหัส ดูรายละเอียดได้ที่การเข้ารหัส
ไม่มีเวอร์ชันเทียบเท่า termsOfService ต้องระบุ ตั้งค่าเพื่อระบุว่าผู้ใช้ยอมรับหรือปฏิเสธข้อกำหนดในการให้บริการสำหรับการจับคู่ข้อมูลลูกค้า

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) audienceMembers.remove (Data Manager API) หมายเหตุ
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations
removedContactInfoList.contactInfos audienceMembers คุณตั้งค่าตัวระบุผู้ใช้แต่ละรายได้ในฟิลด์ compositeData.userData ภายในออบเจ็กต์ AudienceMember ดูรายละเอียดได้ที่ตัวระบุผู้ใช้
removedMobileDeviceIdList.mobileDeviceIds audienceMembers ระบบจะตั้งค่ารหัสอุปกรณ์เคลื่อนที่แต่ละรายการในช่อง mobileData ภายในออบเจ็กต์ AudienceMember
ไม่มีเวอร์ชันเทียบเท่า validateOnly
ไม่มีเวอร์ชันเทียบเท่า encoding ต้องระบุ ตั้งค่าเป็น Encoding ที่ใช้สำหรับค่า UserIdentifier
ไม่มีเวอร์ชันเทียบเท่า encryptionInfo ตั้งค่าหากคำขอมีค่าที่เข้ารหัส ดูรายละเอียดได้ที่การเข้ารหัส

การแมปฟิลด์ออบเจ็กต์

ต่อไปนี้คือการแมประหว่างออบเจ็กต์ Display & Video 360 API กับออบเจ็กต์ที่เทียบเท่าใน Data Manager API

UserList

FirstPartyAndPartnerAudience (Display & Video 360 API) UserList (Data Manager API) หมายเหตุ
name name ใช้รูปแบบชื่อทรัพยากรอื่น ดูรายละเอียดได้ที่ชื่อทรัพยากร
firstPartyAndPartnerAudienceId id
ไม่มีเวอร์ชันเทียบเท่า readOnly
displayName displayName
description description
ไม่มีเวอร์ชันเทียบเท่า membershipStatus
ไม่มีเวอร์ชันเทียบเท่า integrationCode
membershipDurationDays membershipDuration
ไม่มีเวอร์ชันเทียบเท่า closingReason
ไม่มีเวอร์ชันเทียบเท่า accessReason
ไม่มีเวอร์ชันเทียบเท่า accountAccessStatus
displayAudienceSize sizeInfo.displayNetworkMembersCount
ไม่มีเวอร์ชันเทียบเท่า sizeInfo.searchNetworkMembersCount
ไม่มีเวอร์ชันเทียบเท่า targetNetworkInfo
ไม่มีเวอร์ชันเทียบเท่า ingestedUserListInfo
firstPartyAndPartnerAudienceType ไม่มีเวอร์ชันเทียบเท่า
audienceType ไม่มีเวอร์ชันเทียบเท่า
audienceSource ไม่มีเวอร์ชันเทียบเท่า
activeDisplayAudienceSize ไม่มีเวอร์ชันเทียบเท่า
youtubeAudienceSize ไม่มีเวอร์ชันเทียบเท่า
gmailAudienceSize ไม่มีเวอร์ชันเทียบเท่า
displayMobileAppAudienceSize ไม่มีเวอร์ชันเทียบเท่า
displayMobileWebAudienceSize ไม่มีเวอร์ชันเทียบเท่า
displayDesktopAudienceSize ไม่มีเวอร์ชันเทียบเท่า
appId ingestedUserListInfo.mobileIdInfo.appId
contactInfoList audienceMembers วิธี ใน Data Manager API ให้เพิ่มและนำสมาชิกออกโดยใช้เมธอด ingest และ remove ของ audienceMembers
mobileDeviceIdList audienceMembers วิธี ใน Data Manager API ให้เพิ่มและนำสมาชิกออกโดยใช้เมธอด ingest และ remove ของ audienceMembers

ชื่อทรัพยากร

Data Manager API ใช้รูปแบบชื่อทรัพยากรที่แตกต่างจาก Display & Video 360 API

Display & Video 360 API

ใน API ของ Display & Video 360 UserListชื่อทรัพยากรจะใช้รูปแบบที่มีเฉพาะรหัสกลุ่มเป้าหมาย

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

Data Manager API

ใน Data Manager API UserList ชื่อทรัพยากรจะใช้รูปแบบที่มี รหัสกลุ่มเป้าหมาย รวมถึง AccountType และรหัสบัญชีของพาร์ทเนอร์หรือ ผู้ลงโฆษณาที่เป็นเจ้าของกลุ่มเป้าหมาย

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

ตัวระบุผู้ใช้

แม้ว่าระบบจะยังรองรับ userData อยู่ แต่เราขอแนะนำให้ใช้ compositeData เพื่อให้แน่ใจว่าการผสานรวมของคุณพร้อมสำหรับการปรับปรุงในอนาคต ดูรายละเอียดได้ที่ข้อมูล แบบผสม

ContactInfo (Display & Video 360 API) CompositeData (Data Manager API) หมายเหตุ
hashedEmails userData.userIdentifiers.emailAddress ตั้งค่าเป็นอีเมลที่จัดรูปแบบและแฮชแล้ว นอกจากนี้ คุณยังเข้ารหัสอีเมลที่แฮชแล้วได้ด้วย คุณใช้อีเมลหลายรายการเพื่อจับคู่ผู้ใช้รายเดียวได้โดยใช้ออบเจ็กต์ UserIdentifier หลายรายการ
hashedPhoneNumbers userData.userIdentifiers.phoneNumber ตั้งค่าเป็นหมายเลขโทรศัพท์ที่จัดรูปแบบและแฮช คุณยังเข้ารหัสหมายเลขโทรศัพท์ที่แฮชแล้วได้ด้วย คุณใช้หมายเลขโทรศัพท์หลายหมายเลขเพื่อจับคู่ผู้ใช้รายเดียวได้โดยใช้UserIdentifierหลายออบเจ็กต์
hashedFirstName userData.userIdentifiers.address.givenName ตั้งค่าเป็นชื่อที่กำหนดที่จัดรูปแบบและแฮช นอกจากนี้ คุณยังเข้ารหัสชื่อที่แฮชแล้วได้ด้วย
hashedLastName userData.userIdentifiers.address.familyName ตั้งค่าเป็นนามสกุลที่จัดรูปแบบและแฮช นอกจากนี้ คุณยังเข้ารหัสชื่อครอบครัวที่แฮชได้ด้วย
countryCode userData.userIdentifiers.address.regionCode
zipCodes userData.userIdentifiers.address.postalCode คุณใช้รหัสไปรษณีย์หลายรหัสเพื่อจับคู่ผู้ใช้รายเดียวได้โดยใช้UserIdentifierหลายออบเจ็กต์

ปลายทาง

Display & Video 360 API Destination (Data Manager API) หมายเหตุ
รหัสของผู้ลงโฆษณาหรือพาร์ทเนอร์ที่ผู้ใช้ Display & Video 360 ได้รับสิทธิ์เข้าถึง loginAccount การตั้งค่านี้จำเป็นเฉพาะในสถานการณ์การเข้าถึงพาร์ทเนอร์ Display & Video 360 ซึ่งกลุ่มเป้าหมายอยู่ภายใต้ผู้ลงโฆษณา แต่ผู้ใช้ Display & Video 360 ที่เข้าถึงได้รับสิทธิ์เข้าถึงพาร์ทเนอร์หลักของผู้ลงโฆษณา หรือจะปล่อยให้ไม่ได้ตั้งค่าก็ได้
รหัสของผู้ลงโฆษณาหลักหรือพาร์ทเนอร์ของกลุ่มเป้าหมาย operatingAccount
firstPartyAndPartnerAudienceId productDestinationId
ไม่มีเวอร์ชันเทียบเท่า reference
ก่อนหน้า
ขั้นตอนในการอัปเกรด