การแมปช่อง

ใช้การแมปในตารางเพื่อแมปวิธีการจัดการกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า และฟิลด์ใน API ของ Display & Video 360 กับรายการที่เทียบเท่าใน 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 แยกกันเพื่อเพิ่มและนำสมาชิกออกจากกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้า

การแมปคำขอ

ตารางต่อไปนี้จะแมปฟิลด์คำขอของเมธอด API ของ Display & Video 360 กับฟิลด์ที่เทียบเท่าใน 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	ระบบจะตั้งค่าข้อมูลผู้ใช้แต่ละรายในช่อง 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	ระบบจะตั้งค่าข้อมูลผู้ใช้แต่ละรายในช่อง userData ภายในออบเจ็กต์ AudienceMember ดูรายละเอียดได้ที่ UserData
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

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

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

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

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