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

टेबल में दिए गए मैपिंग का इस्तेमाल करके, 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 उपयोगकर्ता आइडेंटिफ़ायर भेजने पर, यह फ़ील्ड ज़रूरी है: इसे Encoding वैल्यू के लिए इस्तेमाल किए गए UserIdentifier पर सेट करें. उपयोगकर्ता आइडेंटिफ़ायर का इस्तेमाल न करने पर, इस फ़ील्ड को अनदेखा किया जाता है.
कोई मिलती-जुलती रिपोर्ट नहीं 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 फ़ील्ड को, हर इवेंट के लिए यूनीक आइडेंटिफ़ायर पर सेट करना ज़रूरी है.

Floodlight ऑफ़लाइन कन्वर्ज़न भेजते समय, यह फ़ील्ड ज़रूरी नहीं है. ज़्यादा जानकारी के लिए, डेटा को ऑब्जेक्ट में बदलना देखें .Event
customVariables customVariables CustomVariable ऑब्जेक्ट की सूची. Data Manager API, enums के बजाय स्ट्रिंग को कुंजियों के तौर पर इस्तेमाल करता है. 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 में, उपयोगकर्ता आइडेंटिफ़ायर को 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 ज़रूरी है.