מיפוי שדות

אתם יכולים להשתמש במיפויים שבטבלאות כדי למפות 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) הערות
פרמטר של נתיב כתובת ה-URL‏ profileId אין דוח מקביל
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 epoch).
  • אם משתמשים במאגרי אחסון לפרוטוקולים, צריך להשתמש ב-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 משתמש במחרוזות כמפתחות במקום בערכי enum. צריך להשתמש במפתחות כמו 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 מגדירים את כתובת האימייל בפורמט הנכון ועם גיבוב (hash). אפשר גם להצפין את כתובת האימייל המגובבת.
hashedPhoneNumber phoneNumber מגדירים את מספר הטלפון בפורמט הנכון ומגובב. אפשר גם להצפין את מספר הטלפון המגובב.
addressInfo address צריך להגדיר לאובייקט AddressInfo. פועלים לפי ההנחיות בנושא פורמט וגיבוב (hash). אפשר גם להצפין את המאפיינים המגובבים של כתובת.
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 חובה.
הקודם
שלבים לשדרוג