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

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

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

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

ज़्यादा जानकारी के लिए, टाइमस्टैंप का फ़ॉर्मैट देखें.
value conversionValue
quantity conversionCount
ordinal कोई मिलती-जुलती रिपोर्ट नहीं Campaign Manager 360 API का ordinal फ़ील्ड, Data Manager API में मौजूद नहीं है. इसके बजाय, transactionId का इस्तेमाल यह कंट्रोल करने के लिए किया जा सकता है कि एक ही दिन में, एक ही उपयोगकर्ता से मिले डुप्लीकेट कन्वर्ज़न को कैसे हटाया जाए.

Campaign Manager 360 API में, इवेंट को डुप्लीकेट होने से रोकने के लिए, ordinal को 1 जैसी तय वैल्यू पर सेट किया जा सकता है. Data Manager API में, transactionId को हर इवेंट के लिए यूनीक आइडेंटिफ़ायर पर सेट किया जाना चाहिए.
कोई मिलती-जुलती रिपोर्ट नहीं transactionId Data Manager API में, transactionId का इस्तेमाल यह कंट्रोल करने के लिए किया जाता है कि एक ही दिन में, एक ही उपयोगकर्ता से मिले डुप्लीकेट कन्वर्ज़न को कैसे हटाया जाए. इस फ़ील्ड को हर इवेंट के लिए, यूनीक आइडेंटिफ़ायर पर सेट किया जाना चाहिए.

Floodlight ऑफ़लाइन कन्वर्ज़न भेजते समय, यह फ़ील्ड भरना ज़रूरी नहीं है. ज़्यादा जानकारी के लिए, डेटा को 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 कोई मिलती-जुलती रिपोर्ट नहीं 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 ज़रूरी है.