מיפוי שדות

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

שמות המשאבים

הפורמט של שם המשאב ב-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

‫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