מיפוי שדות

אפשר להשתמש במיפויים שבטבלאות כדי למפות שיטות ופידים לניהול קהלים מסוג "התאמה ללקוחות" ב-Display & Video 360 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.

בקשת מיפוי

בטבלאות הבאות ממופים שדות הבקשה של שיטות 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

ב-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