מיפוי שדות

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

מיפוי בקשות

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