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

टेबल में दिए गए मैपिंग का इस्तेमाल करके, 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 से थोड़ा अलग है. 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, एक ही Floodlight गतिविधि आईडी को भेजे गए इवेंट को डुप्लीकेट होने से रोकने के लिए transactionId का इस्तेमाल करता है. 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	हर अनुरोध के लिए एन्क्रिप्शन की जानकारी एक बार देने के बजाय, एन्क्रिप्ट (सुरक्षित) किए गए हर User-ID के लिए यह जानकारी दी जाती है.
encryptionInfo.encryptionEntityId	adIdentifiers.encryptedUserIds[].entityId	हर अनुरोध के लिए एन्क्रिप्शन की जानकारी एक बार देने के बजाय, एन्क्रिप्ट (सुरक्षित) किए गए हर User-ID के लिए यह जानकारी दी जाती है.
encryptionInfo.encryptionSource	adIdentifiers.encryptedUserIds[].source	हर अनुरोध के लिए एन्क्रिप्शन की जानकारी एक बार देने के बजाय, एन्क्रिप्ट (सुरक्षित) किए गए हर User-ID के लिए यह जानकारी दी जाती है.
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	ज़रूरी है.