फ़ील्ड मैपिंग

Campaign Manager 360 API में मौजूद conversions.batchinsert को Data Manager API में मौजूद इसके बराबर के IngestEventsRequest से मैप करने के लिए, टेबल में दी गई मैपिंग का इस्तेमाल करें.

पुष्टि करना

Data Manager API के लिए, Campaign Manager 360 API से अलग स्कोप वाले क्रेडेंशियल की ज़रूरत होती है. एपीआई ऐक्सेस सेट अप करें में दिया गया तरीका अपनाकर, नए क्रेडेंशियल जनरेट करें. इनमें Data Manager API का स्कोप शामिल होना चाहिए.

अनुरोध के फ़ील्ड

conversions.batchinsert (Campaign Manager 360 API) IngestEventsRequest (Data Manager API) नोट
profileId यूआरएल पाथ पैरामीटर कोई मिलती-जुलती रिपोर्ट नहीं
kind कोई मिलती-जुलती रिपोर्ट नहीं मेटाडेटा फ़ील्ड; Data Manager API इसका इस्तेमाल नहीं करता.
conversions events ज़रूरी है. कन्वर्ज़न या इवेंट की सूची. ज़्यादा जानकारी के लिए, कन्वर्ज़न फ़ील्ड सेक्शन देखें.
encryptionInfo events.adIdentifiers.encryptedUserIds में ले जाया गया इवेंट लेवल पर तय किया गया हो. Campaign Manager 360 में एन्क्रिप्ट (सुरक्षित) करने की जानकारी, अब एन्क्रिप्ट किए गए हर यूज़र आईडी में दी जाती है. कन्वर्ज़न फ़ील्ड सेक्शन देखें.
कोई मिलती-जुलती रिपोर्ट नहीं encryptionInfo अनुरोध-लेवल encryptionInfo, एन्क्रिप्ट (सुरक्षित) किए गए UserData यूज़र आइडेंटिफ़ायर के लिए, एन्क्रिप्शन की जानकारी है. ज़्यादा जानकारी के लिए, एन्क्रिप्ट (सुरक्षित) करना लेख पढ़ें.
कोई मिलती-जुलती रिपोर्ट नहीं destinations ज़रूरी है. Destination ऑब्जेक्ट की सूची, जो इवेंट के लिए टारगेट खाते और Floodlight गतिविधि के बारे में बताती है. ज़्यादा जानकारी के लिए, डेस्टिनेशन गाइड देखें. कन्वर्ज़न फ़ील्ड सेक्शन में दिखाए गए तरीके से, अलग-अलग फ़ील्ड को मैप करें.
कोई मिलती-जुलती रिपोर्ट नहीं consent अनुरोध में मौजूद इवेंट के लिए, सहमति की डिफ़ॉल्ट सेटिंग. हालांकि, इन्हें सेट करना ज़रूरी नहीं है. Event के consent फ़ील्ड को सेट करके, किसी इवेंट के लिए इस वैल्यू को बदला जा सकता है.
कोई मिलती-जुलती रिपोर्ट नहीं encoding यूज़र आइडेंटिफ़ायर भेजने पर ज़रूरी है: इसे UserIdentifier वैल्यू के लिए इस्तेमाल किए गए Encoding पर सेट करें. अगर यूज़र आइडेंटिफ़ायर का इस्तेमाल नहीं किया जा रहा है, तो इस फ़ील्ड को अनदेखा कर दिया जाता है.
कोई मिलती-जुलती रिपोर्ट नहीं validateOnly अगर यह सही है, तो अनुरोध की पुष्टि की जाती है, लेकिन उसे लागू नहीं किया जाता.

कन्वर्ज़न फ़ील्ड

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 से थोड़ा अलग है. इसमें Unix epoch के बाद से, timestampMicros को माइक्रोसेकंड में सेट करना होता है.
  • अगर प्रोटोकॉल बफ़र का इस्तेमाल किया जा रहा है, तो Timestamp का इस्तेमाल करें. साथ ही, seconds और (ज़रूरी नहीं) nanoseconds फ़ील्ड सेट करें.

ज़्यादा जानकारी के लिए, टाइमस्टैंप का फ़ॉर्मैट देखें.
value conversionValue
quantity conversionCount
ordinal कोई मिलती-जुलती रिपोर्ट नहीं Campaign Manager 360 API का ordinal फ़ील्ड, 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 ऑब्जेक्ट की सूची. डेटा मैनेजर एपीआई, enum के बजाय स्ट्रिंग को कुंजियों के तौर पर इस्तेमाल करता है. variable फ़ील्ड के लिए, U1, U2 जैसी कुंजियों का इस्तेमाल करें.
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 में, यूज़र आइडेंटिफ़ायर को Event के userData फ़ील्ड में मौजूद UserData ऑब्जेक्ट में ग्रुप किया जाता है. यह 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 ज़रूरी है.
पीछे जाएं
अपग्रेड करने का तरीका