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

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