מיפוי שדות

אתם יכולים להיעזר במיפויים שבטבלאות כדי למפות conversions.batchinsert ב-Campaign Manager 360 API למקבילה IngestEventsRequest ב-Data Manager API.

אימות

ל-Data Manager API נדרשים פרטי כניסה עם היקף שונה מזה של Campaign Manager 360 API. כדי ליצור פרטי כניסה חדשים שכוללים את היקף ההרשאות של Data Manager API, צריך לפעול לפי השלבים במאמר בנושא הגדרת גישה ל-API.

שדות של בקשות

‫conversions.batchinsert (Campaign Manager 360 API) ‫IngestEventsRequest (Data Manager API) הערות
profileId פרמטר של נתיב כתובת ה-URL אין דוח מקביל
kind אין דוח מקביל שדה מטא-נתונים שלא נמצא בשימוש ב-Data Manager API.
conversions events חובה. רשימת ההמרות או האירועים. פרטים נוספים זמינים בקטע בנושא שדות המרה.
encryptionInfo הועברה אל events.adIdentifiers.encryptedUserIds מוגדר ברמת האירוע. פרטי ההצפנה של Campaign Manager 360 מצוינים עכשיו בכל מזהה משתמש מוצפן. מידע נוסף על שדות ההמרה
אין דוח מקביל encryptionInfo הפרמטר encryptionInfo ברמת הבקשה הוא פרטי ההצפנה של מזהי משתמשים מוצפנים מסוג UserData. פרטים נוספים זמינים במאמר בנושא הצפנה.
אין דוח מקביל destinations חובה. רשימה של אובייקטים מסוג Destination שמגדירים את חשבון היעד ואת הפעילות ב-Floodlight עבור האירועים. פרטים נוספים זמינים במדריך היעדים. ממפים שדות בודדים כמו שמוצג בקטע 'שדות המרה'.
אין דוח מקביל consent הגדרות ברירת מחדל אופציונליות בנוגע להסכמה לשימוש בנתונים של אירועים בבקשה. אפשר לשנות את הערך הזה לאירוע ספציפי על ידי הגדרת השדה consent של Event.
אין דוח מקביל encoding חובה אם שולחים מזהי משתמשים: מגדירים את Encoding שמשמש לערכים של UserIdentifier. אם לא משתמשים במזהי משתמשים, המערכת מתעלמת מהשדה הזה.
אין דוח מקביל validateOnly אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת.

שדות המרה

‫Conversion (Campaign Manager 360 API) ‫Event (Data Manager API) הערות
floodlightConfigurationId destinations[].operatingAccount.accountId מוגדר ברמת הבקשה. הערך שמוגדר הוא מזהה ההגדרה ב-Floodlight.
אין דוח מקביל destinations[].operatingAccount.accountType מוגדר ברמת הבקשה. הוגדר לערך FLOODLIGHT_CONFIG.
floodlightActivityId destinations[].productDestinationId מוגדר ברמת הבקשה. הערך שמוגדר הוא מזהה הפעילות ב-Floodlight.
kind אין דוח מקביל שדה מטא-נתונים; לא נעשה בו שימוש ב-Data Manager API.
אין דוח מקביל destinations[].reference מוגדר ברמת הבקשה. מזהה שהמשתמש מגדיר ליעד. צריך להגדיר את השדה הזה אם שולחים אירועים לכמה יעדים בבקשה אחת.
adUserDataConsent consent.adUserData פרטים נוספים מופיעים במאמר Consent.
nonPersonalizedAd consent.adPersonalization פרטים נוספים מופיעים במאמר Consent.
אין דוח מקביל destinationReferences אם שולחים אירועים לכמה יעדים בבקשה אחת, צריך להגדיר בשדה הזה את הערך התואם reference של היעד.
timestampMicros eventTimestamp
  • אם משתמשים בפורמט JSON, צריך להגדיר ערך בפורמט RFC 3339, ששונה מעט מ-Campaign Manager 360 API, שבו נדרש timestampMicros במיקרו-שניות מאז תקופת הזמן של מערכת Unix.
  • אם משתמשים ב-protocol buffers, צריך להשתמש ב-Timestamp ולהגדיר את השדות seconds ו-(אופציונלית) nanoseconds.

מידע נוסף מופיע בקטע פורמטים של חותמות זמן.
value conversionValue
quantity conversionCount
ordinal אין דוח מקביל השדה ordinal מ-Campaign Manager 360 API לא מופיע ב-Data Manager API. במקום זאת, Data Manager API משתמש ב-transactionId כדי לבטל כפילויות של אירועים שנשלחים לאותו מזהה פעילות ב-Floodlight.

ב-Campaign Manager 360 API, אפשר לוודא שהאירועים לא יוכפלו על ידי הגדרת הערך של ordinal כערך קבוע, כמו 1. ב-Data Manager API, transactionId צריך להגדיר מזהה ייחודי לכל אירוע.
אין דוח מקביל transactionId ב-Data Manager API נעשה שימוש בשילוב של מזהה פעילות ב-Floodlight ושל transactionId כדי לבטל כפילויות של האירוע. בשדה transactionId צריך להגדיר מזהה ייחודי לכל אירוע.

חובה אם שולחים אירועים להמרות מכמה מקורות. פרטים נוספים זמינים במאמר בנושא המרת הנתונים לאובייקטים של Event.
customVariables customVariables רשימה של אובייקטים מסוג CustomVariable. ב-Data Manager API, מחרוזות משמשות כמפתחות במקום ספירות. משתמשים במקשים כמו U1, U2 בשדה variable.
limitAdTracking consent.adPersonalization פרטים נוספים מופיעים במאמר Consent.
childDirectedTreatment consent.adPersonalization פרטים נוספים מופיעים במאמר Consent.
treatmentForUnderage consent.adPersonalization פרטים נוספים מופיעים במאמר Consent.
gclid adIdentifiers.gclid פרטים נוספים מופיעים במאמר AdIdentifiers.
dclid adIdentifiers.dclid פרטים נוספים מופיעים במאמר AdIdentifiers.
matchId adIdentifiers.matchId פרטים נוספים מופיעים במאמר AdIdentifiers.
mobileDeviceId adIdentifiers.mobileId פרטים נוספים מופיעים במאמר AdIdentifiers.
impressionId adIdentifiers.impressionId פרטים נוספים מופיעים במאמר AdIdentifiers.
encryptedUserId adIdentifiers.encryptedUserIds ‫Data Manager API תומך בכמה מזהי משתמשים מוצפנים. פרטים נוספים מופיעים במאמר AdIdentifiers.
encryptedUserIdCandidates adIdentifiers.encryptedUserIds כל מזהה של מועמד ממופה לאובייקט EncryptedUserId ברשימה.
encryptionInfo.kind אין דוח מקביל שדה מטא-נתונים שלא נמצא בשימוש ב-Data Manager API.
encryptionInfo.encryptionEntityType adIdentifiers.encryptedUserIds[].entityType במקום לציין את פרטי ההצפנה פעם אחת לכל בקשה, מציינים אותם לכל מזהה משתמש מוצפן.
encryptionInfo.encryptionEntityId adIdentifiers.encryptedUserIds[].entityId במקום לציין את פרטי ההצפנה פעם אחת לכל בקשה, מציינים אותם לכל מזהה משתמש מוצפן.
encryptionInfo.encryptionSource adIdentifiers.encryptedUserIds[].source במקום לציין את פרטי ההצפנה פעם אחת לכל בקשה, מציינים אותם לכל מזהה משתמש מוצפן.
sessionAttributesEncoded adIdentifiers.sessionAttributes פרטים נוספים מופיעים במאמר AdIdentifiers.
cartData cartData פרטים נוספים זמינים במאמר בנושא השדות של נתוני עגלות הקניות.
userIdentifiers userData.userIdentifiers פרטים נוספים מופיעים במאמר בנושא שדות של מזהי משתמשים.

שדות של מזהי משתמשים

ב-Data Manager API, מזהי משתמשים מקובצים באובייקט UserData בשדה userData של Event. זה שונה מ-Campaign Manager 360 API, שבו המזהים מצורפים ישירות לאובייקט Conversion.

‫UserIdentifier (Campaign Manager 360 API) ‫UserIdentifier (Data Manager API) הערות
hashedEmail emailAddress הגדרה של כתובת האימייל בפורמט מגובב. אפשר גם להצפין את כתובת האימייל שעברה גיבוב.
hashedPhoneNumber phoneNumber מוגדר למספר הטלפון בפורמט מגובב. אפשר גם להצפין את מספר הטלפון המגובב.
addressInfo address מוגדר לאובייקט AddressInfo. פועלים לפי ההנחיות בנושא פורמט וגיבוב. אפשר גם להצפין את המאפיינים המגובבים של כתובת.
addressInfo.hashedFirstName address.givenName
addressInfo.hashedLastName address.familyName
addressInfo.countryCode address.regionCode
addressInfo.postalCode address.postalCode
addressInfo.city אין דוח מקביל אין תמיכה ביעדים של Campaign Manager 360.
addressInfo.state אין דוח מקביל אין תמיכה ביעדים של Campaign Manager 360.
addressInfo.hashedStreetAddress אין דוח מקביל אין תמיכה ביעדים של Campaign Manager 360.

השדות של נתוני עגלות הקניות

‫CartData (Campaign Manager 360 API) ‫CartData (Data Manager API) הערות
kind אין דוח מקביל שדה מטא-נתונים שלא נמצא בשימוש ב-Data Manager API.
merchantId merchantId
merchantFeedLabel merchantFeedLabel
merchantFeedLanguage merchantFeedLanguageCode
items items רשימה של אובייקטים מסוג Item. פרטים נוספים מופיעים במאמר בנושא שדות של פריטים.

שדות פריטים של נתוני עגלות הקניות

‫Item (Campaign Manager 360 API) ‫Item (Data Manager API) הערות
kind אין דוח מקביל שדה מטא-נתונים; לא נעשה בו שימוש ב-Data Manager API.
אין דוח מקביל itemId אופציונלי. מזהה ייחודי של הפריט.
itemId merchantProductId חובה. הערך שמוגדר הוא מזהה המוצר ב-Merchant Center.
quantity quantity חובה.
unitPrice unitPrice חובה.
הקודם
שלבים לשדרוג