การแมปช่อง

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

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

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

การแมปเมธอด

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

เมธอด 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 แยกต่างหากเพื่อเพิ่มและนำสมาชิกออกจากกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้า
ไม่มีเทียบเท่า audienceMembers.removeAll 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 และ removeAll ของ audienceMembers
mobileDeviceIdList audienceMembers วิธี ใน Data Manager API ให้เพิ่มและนำสมาชิกออกโดยใช้เมธอด ingest, remove และ removeAll ของ audienceMembers

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

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

Display & Video 360 API

ใน Display & Video 360 API ชื่อทรัพยากร 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
ก่อนหน้า
ขั้นตอนในการอัปเกรด