टेबल में दिए गए मैपिंग का इस्तेमाल करके, 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 |
ज़्यादा जानकारी के लिए, टाइमस्टैंप का फ़ॉर्मैट देखें. |
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 |
हर अनुरोध के लिए एन्क्रिप्शन की जानकारी एक बार देने के बजाय, एन्क्रिप्ट (सुरक्षित) किए गए हर यूज़र आईडी के लिए यह जानकारी दी जाती है. |
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 |
कोई मिलती-जुलती रिपोर्ट नहीं | डेटा मैनेजर एपीआई के मौजूदा वर्शन में, इस सुविधा का इस्तेमाल नहीं किया जा सकता. |
addressInfo.state |
कोई मिलती-जुलती रिपोर्ट नहीं | डेटा मैनेजर एपीआई के मौजूदा वर्शन में, इस सुविधा का इस्तेमाल नहीं किया जा सकता. |
addressInfo.hashedStreetAddress |
कोई मिलती-जुलती रिपोर्ट नहीं | डेटा मैनेजर एपीआई के मौजूदा वर्शन में, इस सुविधा का इस्तेमाल नहीं किया जा सकता. |
कार्ट डेटा फ़ील्ड
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 |
ज़रूरी है. |