מיפוי שדות

אפשר להשתמש במיפויים שבטבלאות כדי למפות conversions.batchinsert ב-Campaign Manager 360 API למקבילה שלו IngestEventsRequest ב-Data Manager 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 (שנקרא בעבר מזהה הפעילות ב-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. במקום זאת, אפשר להשתמש בtransactionId כדי לקבוע איך לבטל כפילויות של המרות שהגיעו מאותו משתמש באותו יום.

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

השדה הזה הוא אופציונלי כששולחים המרות אופליין ב-Floodlight. פרטים נוספים זמינים במאמר בנושא המרת הנתונים לאובייקטים של 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 אין דוח מקביל אין תמיכה בגרסה הנוכחית של Data Manager API.
addressInfo.state אין דוח מקביל אין תמיכה בגרסה הנוכחית של Data Manager API.
addressInfo.hashedStreetAddress אין דוח מקביל אין תמיכה בגרסה הנוכחית של Data Manager API.

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

‫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 חובה.
הקודם
שלבים לשדרוג