इवेंट भेजें

इवेंट डेटा भेजने के बारे में जानने के लिए, इस क्विकस्टार्ट गाइड को पढ़ें.

इनमें से किसी भी स्थिति में, Data Manager API का इस्तेमाल करें:

• अपने टैग कन्वर्ज़न के लिए, Google Ads टैग कन्वर्ज़न या Google Analytics purchase इवेंट को अतिरिक्त डेटा सोर्स के तौर पर भेजें. इससे विज्ञापन इंटरैक्शन के सिग्नल को ज़्यादा से ज़्यादा किया जा सकेगा. साथ ही, आपके डेटा और परफ़ॉर्मेंस को बेहतर बनाया जा सकेगा.

  यह सुविधा सभी Google Ads खातों के लिए उपलब्ध है. हालांकि, यह सिर्फ़ उन Google Analytics प्रॉपर्टी के लिए उपलब्ध है जिन्हें अनुमति मिली है. अगर आपको Google Analytics प्रॉपर्टी को अनुमति वाली सूची में जोड़ना है, तो यह फ़ॉर्म भरें.

• Google Ads के ऑफ़लाइन कन्वर्ज़न या लीड के लिए बेहतर कन्वर्ज़न ट्रैकिंग के लिए इवेंट डेटा भेजें.

आपको गाइड का कौनसा वर्शन देखना है, यह चुनें:

विज्ञापन देने वाला व्यक्ति या कंपनी डेटा पार्टनर

इस क्विकस्टार्ट में, आपको यह तरीका अपनाना होगा:

1. इवेंट का डेटा पाने के लिए, Destination तैयार करें.
2. भेजने के लिए इवेंट डेटा तैयार करें.
3. इवेंट के लिए IngestionService अनुरोध बनाएं.
4. Google APIs Explorer की मदद से अनुरोध भेजें.
5. सफल और असफल जवाबों के बारे में जानें.

डेस्टिनेशन तैयार करना

डेटा भेजने से पहले, आपको डेटा के लिए कम से कम एक Destination तैयार करना होगा. यहां आपके इस्तेमाल के लिए, Destination का एक सैंपल दिया गया है:

    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "PRODUCT_DESTINATION_ID"
    }

यहां Destination के फ़ील्ड दिए गए हैं. ज़्यादा जानकारी और अलग-अलग स्थितियों के लिए डेस्टिनेशन के उदाहरण देखने के लिए, डेस्टिनेशन कॉन्फ़िगर करना लेख पढ़ें.

operatingAccount

वह खाता जिसे इवेंट मिलते हैं.

अतिरिक्त डेटा सोर्स के तौर पर भेजे गए इवेंट के लिए, ऑपरेटिंग खाता Google Ads खाता या Google Analytics प्रॉपर्टी हो सकती है.

अगर accountType GOOGLE_ANALYTICS_PROPERTY है, तो अनुरोध के क्रेडेंशियल, Google Analytics के ऐसे उपयोगकर्ता के लिए होने चाहिए जिसके पास प्रॉपर्टी के लिए एडिटर या एडमिन की भूमिका हो.

ऑफ़लाइन कन्वर्ज़न और लीड के लिए बेहतर कन्वर्ज़न ट्रैकिंग के लिए, ऑपरेटिंग खाता Google Ads खाता होना चाहिए.

loginAccount

वह खाता जिसमें क्रेडेंशियल के लिए Google खाता, उपयोगकर्ता के तौर पर इस्तेमाल किया जाता है.

productDestinationId

operatingAccount में मौजूद उस इकाई का आईडी जिसे इवेंट मिलते हैं.

अतिरिक्त डेटा सोर्स के तौर पर भेजे गए इवेंट के लिए, productDestinationId इनमें से कोई एक होना चाहिए:

1. यह WEBPAGE पर सेट किए गए type वाले Google Ads कन्वर्ज़न का आईडी है. Google Ads के यूज़र इंटरफ़ेस (यूआई) में, WEBPAGE कन्वर्ज़न ऐक्शन के लिए कन्वर्ज़न का सोर्स वेबसाइट होता है.

2. Google Analytics की वेब स्ट्रीम का मेज़रमेंट आईडी. Google Analytics iOS ऐप्लिकेशन या Android ऐप्लिकेशन की डेटा स्ट्रीम में, इवेंट को डेटा के अतिरिक्त सोर्स के तौर पर नहीं भेजा जा सकता.

ऑफ़लाइन कन्वर्ज़न या लीड के लिए बेहतर कन्वर्ज़न ट्रैकिंग के लिए, productDestinationId, Google Ads कन्वर्ज़न ऐक्शन का आईडी होना चाहिए. साथ ही, type को UPLOAD_CLICKS पर सेट किया जाना चाहिए. Google Ads के यूज़र इंटरफ़ेस (यूआई) में, UPLOAD_CLICKS कन्वर्ज़न ऐक्शन के लिए कन्वर्ज़न सोर्स, वेबसाइट (क्लिक से इंपोर्ट किया गया) होता है.

इस गाइड में दिए गए उदाहरण में, ऐसा अनुरोध बनाने का तरीका बताया गया है जो हर इवेंट को एक ही डेस्टिनेशन पर भेजता है. अगर आपको एक ही अनुरोध में कई डेस्टिनेशन के लिए इवेंट भेजने हैं, तो कई डेस्टिनेशन के लिए इवेंट भेजना लेख पढ़ें.

इवेंट का डेटा तैयार करना

यहां दिए गए इवेंट डेटा पर ध्यान दें. हर टेबल, एक कन्वर्ज़न इवेंट से जुड़ी होती है. हर कन्वर्ज़न इवेंट में, इवेंट का टाइमस्टैंप, उसका कन्वर्ज़न ऐक्शन, और कन्वर्ज़न वैल्यू होती है.

हर इवेंट में विज्ञापन आइडेंटिफ़ायर हो सकते हैं, जैसे कि gclid. इसके अलावा, उपयोगकर्ता आइडेंटिफ़ायर भी हो सकते हैं, जैसे कि ईमेल पते, फ़ोन नंबर, और पते की जानकारी. किसी इवेंट में ये भी हो सकते हैं:

• इवेंट के समय उपयोगकर्ता के बारे में आकलन की गई जानकारी. जैसे, ग्राहक की वैल्यू या वह नया, वापस लौटने वाला या फिर से जुड़ने वाला ग्राहक है या नहीं.
• शॉपिंग कार्ट डेटा.
• किसी डेस्टिनेशन के लिए अतिरिक्त इवेंट पैरामीटर या उपयोगकर्ता प्रॉपर्टी, जैसे कि Google Analytics के लिए client_id या user_id.

इवेंट का डेटा यहां दिया गया है:

डेटा को फ़ॉर्मैट करना

फ़ॉर्मैटिंग गाइड में दिए गए निर्देशों के मुताबिक, फ़ील्ड को फ़ॉर्मैट करें. यहां फ़ॉर्मैट करने के बाद इवेंट डेटा दिया गया है:

डेटा को हैश और एन्कोड करना

इसके अलावा, फ़ॉर्मैट किए गए ईमेल पतों, नामों, और उपनामों को SHA-256 एल्गोरिदम का इस्तेमाल करके हैश किया जाना चाहिए. साथ ही, उन्हें हेक्स या Base64 एन्कोडिंग का इस्तेमाल करके कोड में बदला जाना चाहिए. यहां हेक्स कोडिंग का इस्तेमाल करके, फ़ॉर्मैट करने, हैश करने, और कोड में बदलने के बाद इवेंट का डेटा दिया गया है:

डेटा को Event ऑब्जेक्ट में बदलना

हर इवेंट के फ़ॉर्मैट किए गए और हैश किए गए डेटा को Event में बदलें. यहां दिए गए फ़ील्ड में जानकारी भरें:

1. इवेंट के होने का समय eventTimestamp पर सेट करें.

   Google Analytics के इवेंट के लिए, eventTimestamp पिछले 72 घंटों के अंदर का होना चाहिए.

2. अपने इस्तेमाल के उदाहरण के लिए, ज़रूरी फ़ील्ड सेट करें.

   इस्तेमाल का उदाहरण	आइडेंटिफ़ायर	transactionId	eventSource
   ऑफ़लाइन कन्वर्ज़न या लीड के लिए बेहतर कन्वर्ज़न ट्रैकिंग	ज़रूरी है. इनमें से कम से कम एक को सेट करें: adIdentifiers जिसमें gclid, gbraid या wbraid में से कम से कम एक सेट किया गया हो सेशन के एट्रिब्यूट userData	वैकल्पिक	ज़रूरी है. EventSource के लिए, enum वैल्यू में से किसी एक पर सेट किया गया हो.
   Google Ads डेस्टिनेशन को अतिरिक्त डेटा सोर्स के तौर पर भेजे गए इवेंट	ज़रूरी है. इनमें से कम से कम एक को सेट करें: adIdentifiers जिसमें gclid, gbraid या wbraid में से कम से कम एक सेट हो userData	ज़रूरी है	ज़रूरी नहीं. अगर सेट किया गया है, तो WEB होना चाहिए.
   Google Analytics डेस्टिनेशन को अतिरिक्त डेटा सोर्स के तौर पर भेजे गए इवेंट	ज़रूरी है. इनमें से कम से कम एक को सेट करें: clientId adIdentifiers with gclid set userId	ज़रूरी है	ज़रूरी नहीं. अगर सेट किया गया है, तो WEB होना चाहिए.

3. अगर Google Ads डेस्टिनेशन में इवेंट को अतिरिक्त डेटा सोर्स के तौर पर भेजा जा रहा है, तो Google, अतिरिक्त डेटा सोर्स से मिले डेटा को कैसे मैनेज करता है लेख पढ़ें.

4. उन सभी फ़ील्ड में वैल्यू डालें जिनके लिए आपके पास इवेंट की वैल्यू है. उपलब्ध फ़ील्ड की पूरी सूची देखने के लिए, Event रेफ़रंस दस्तावेज़ देखें.

Google, अतिरिक्त डेटा सोर्स के डेटा को कैसे मैनेज करता है

एक ही कन्वर्ज़न ऐक्शन के लिए, Google transactionId का इस्तेमाल करके, अलग-अलग सोर्स (जैसे कि आपकी वेबसाइट का टैग और Data Manager API के डेटा इंटेक के अनुरोध) से भेजे गए कन्वर्ज़न इवेंट को डुप्लीकेट होने से बचाता है. यहां दी गई टेबल में बताया गया है कि डेटा इंटेक के अनुरोधों से मिले डेटा को कैसे प्रोसेस किया जाता है.

सेशन एट्रिब्यूट जोड़ना

अगर ऑफ़लाइन कन्वर्ज़न या लीड के लिए बेहतर कन्वर्ज़न ट्रैकिंग का डेटा भेजा जा रहा है, तो सेशन एट्रिब्यूट जोड़ें. ऐसा तब करें, जब विज्ञापन के अन्य आइडेंटिफ़ायर, जैसे कि GCLID या WBRAID उपलब्ध न हों. विज्ञापन आइडेंटिफ़ायर के अलावा, सेशन एट्रिब्यूट भी शामिल किए जा सकते हैं.

सेशन एट्रिब्यूट से, आपकी वेबसाइट के साथ उपयोगकर्ता के इंटरैक्शन के बारे में ज़्यादा जानकारी और सिग्नल मिलते हैं. इससे कन्वर्ज़न मेज़रमेंट, रिपोर्टिंग, और बिडिंग की सटीकता को बेहतर बनाया जा सकता है.

डेटा मैनेजर एपीआई में, सेशन एट्रिब्यूट भेजने के लिए इन दो तरीकों का इस्तेमाल किया जा सकता है:

1. सुझाया गया: adIdentifiers के sessionAttributes फ़ील्ड को, base64 कोड में बदले गए सेशन के एट्रिब्यूट की स्ट्रिंग के तौर पर सेट करें. कोड में बदली गई स्ट्रिंग को कैप्चर करने के लिए, फ़ॉर्म सबमिट करने वाले पेजों में बदलाव करने के लिए, session_attributes को कैप्चर करने का तरीका में दिए गए निर्देशों का पालन करें.

2. अगर JavaScript का इस्तेमाल नहीं किया जा सकता, तो हर सेशन के एट्रिब्यूट फ़ील्ड कैप्चर करें. इसके बाद, हर फ़ील्ड को experimentalFields सूची में अलग ExperimentalField के तौर पर जोड़ें:

   • gad_campaignid
   • session_start_time_usec
   • gad_source
   • landing_page_url
   • landing_page_referrer

   अगर आपके पास landing_page_user_agent सेशन एट्रिब्यूट की वैल्यू है, तो उसे adIdentifiers.landingPageDeviceInfo के landing_page_user_agent फ़ील्ड में भेजें.userAgent

   अलग-अलग कुंजी-वैल्यू पेयर भेजने के सबसे सही तरीके यहां दिए गए हैं:

   • gad_campaignid और session_start_time_usec को लगातार भेजें. सटीक एट्रिब्यूशन के लिए, ये फ़ील्ड ज़रूरी हैं.
   • landing_page_url एट्रिब्यूट के लिए गलत या अधूरी वैल्यू न दें. जैसे, प्लेसहोल्डर स्ट्रिंग, इंटरनल ऐप्लिकेशन पाथ या अधूरा यूआरएल. अगर आपके पास सटीक और पूरा यूआरएल नहीं है, तो landing_page_url को शामिल न करें.

   यहां एक सैंपल इवेंट का हिस्सा दिया गया है. इसमें gad_campaignid और session_start_time_usec के लिए experimentalFields में एंट्री दी गई हैं. साथ ही, landingPageDeviceInfo फ़ील्ड में उपयोगकर्ता एजेंट की जानकारी दी गई है:

   {
     ...,
     "experimentalFields": [
       {
         "field": "gad_campaignid",
         "value": "21288051566"
       },
       {
         "field": "session_start_time_usec",
         "value": "1767711548052000"
       }
     ],
     "adIdentifiers": {
       "landingPageDeviceInfo": {
         "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36"
       }
     }
   }
   
   

Google Analytics की जानकारी जोड़ना

अगर अतिरिक्त डेटा सोर्स के तौर पर भेजे गए इवेंट के डेस्टिनेशन में कोई Google Analytics प्रॉपर्टी शामिल है, तो यहां दिए गए फ़ील्ड में बताई गई जानकारी भरें:

eventName

ज़रूरी है. Google Analytics इवेंट का नाम.

transactionId

ज़रूरी है . इवेंट के लिए यूनीक आइडेंटिफ़ायर.

कम से कम एक आइडेंटिफ़ायर

इन फ़ील्ड में से कम से कम एक फ़ील्ड सेट होना चाहिए:

• clientId: यह वेब क्लाइंट के उपयोगकर्ता इंस्टेंस के लिए यूनीक आइडेंटिफ़ायर होता है. मेज़रमेंट प्रोटोकॉल को इवेंट भेजना लेख पढ़ें.

• adIdentifiers.gclid: यह Google क्लिक आईडी है.

• userId: यह उपयोगकर्ता के लिए यूनीक आइडेंटिफ़ायर होता है. ज़्यादा जानकारी के लिए, User-ID की मदद से सभी प्लैटफ़ॉर्म पर गतिविधि को मेज़र करना लेख पढ़ें.

destinationReferences

अगर अनुरोध-लेवल की destinations सूची में एक से ज़्यादा Google Analytics Destination शामिल हैं, तो यह ज़रूरी है. destinationReferences में एक एंट्री जोड़कर यह तय करें कि इवेंट का डेटा किस Google Analytics डेस्टिनेशन को भेजा जाना चाहिए. डेस्टिनेशन रेफ़रंस के बारे में ज़्यादा जानने के लिए, एक से ज़्यादा डेस्टिनेशन पर इवेंट भेजना लेख पढ़ें.

अगर destinationReferences सेट नहीं है या इसमें Google Analytics डेस्टिनेशन से जुड़ी एक से ज़्यादा एंट्री हैं, तो Data Manager API, MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT गड़बड़ी के साथ इवेंट को अस्वीकार कर देता है.

userId

ज़रूरी नहीं. उपयोगकर्ता के लिए User-ID.

additionalEventParameters

ज़रूरी नहीं, लेकिन हमारा सुझाव है कि आप इसे इस्तेमाल करें. इस सूची में, Google Analytics के ऐसे इवेंट पैरामीटर शामिल करें जो अन्य Event फ़ील्ड में कैप्चर नहीं किए जाते. पैरामीटर में, purchaseइवेंट के सुझाए गए अतिरिक्त पैरामीटर या कैप्चर किए जाने वाले अन्य पैरामीटर शामिल हो सकते हैं. EventParameter के parameterName के लिए, Google Analytics पैरामीटर के नाम का इस्तेमाल करें.

उदाहरण के लिए, अगर आपके पास किसी लेन-देन से जुड़े टैक्स की जानकारी है, तो additionalEventParameters में एक एंट्री जोड़ें. इसके लिए, parameterName को tax पर सेट करें और value को टैक्स की रकम पर सेट करें.

हमारा सुझाव है कि transactionId, currency या value Google Analytics इवेंट पैरामीटर के लिए एंट्री न जोड़ें. इसके बजाय, Event एट्रिब्यूट के transactionId, currency, और conversionValue एट्रिब्यूट की वैल्यू सबमिट करें. इनकी वैल्यू, additionalEventParameters एट्रिब्यूट की किसी भी एंट्री से ज़्यादा प्राथमिकता रखती है.

परचेज़ इवेंट के लिए कार्ट डेटा जोड़ना

खरीदे गए आइटम की जानकारी के साथ, Event के cartData फ़ील्ड में डेटा भरें. खरीदे गए हर आइटम के लिए, CartData के items कलेक्शन में Item ऑब्जेक्ट जोड़ें. साथ ही, यहां दिए गए फ़ील्ड में बताई गई जानकारी भरें:

itemId

ज़रूरी है. आइटम के लिए यूनीक आइडेंटिफ़ायर.

unitPrice

ज़रूरी है. यूनिट की कीमत. इसमें टैक्स, शिपिंग, और इवेंट के स्कोप वाले (लेन-देन के लेवल पर) छूट शामिल नहीं हैं.

अगर आइटम पर आइटम के स्कोप वाली छूट लागू है, तो छूट वाली इकाई कीमत का इस्तेमाल करें. उदाहरण के लिए, अगर किसी आइटम की इकाई कीमत 27.67 है और इकाई छूट 6.66 है, तो unitPrice को 21.01 पर सेट करें.

quantity

ज़रूरी है. इस आइटम के लिए, खरीदी गई यूनिट की संख्या.

additionalItemParameters

इस सूची में, ऐसे आइटम स्कोप वाले पैरामीटर शामिल करें जो अन्य Item फ़ील्ड में कैप्चर नहीं किए गए हैं. ItemParameter के parameterName के लिए, Google Analytics आइटम पैरामीटर के नाम का इस्तेमाल करें.

उदाहरण के लिए, अगर आपके पास किसी आइटम का ब्रैंड और कैटगरी है, तो आइटम के additionalItemParameters में एक एंट्री जोड़ें. इसमें parameterName को item_brand पर सेट करें और value को ब्रैंड के नाम पर सेट करें. इसके बाद, एक और एंट्री जोड़ें. इसमें parameterName को item_category पर सेट करें और value को आइटम की कैटगरी पर सेट करें.

हमारा सुझाव है कि quantity, price या item_id Google Analytics के आइटम पैरामीटर के लिए एंट्री न जोड़ें. इसके बजाय, Item के itemId, unitPrice, और quantity एट्रिब्यूट की वैल्यू सबमिट करें. इनकी वैल्यू, additionalItemParameters एट्रिब्यूट की किसी भी वैल्यू से ज़्यादा प्राथमिकता रखती है.

यहां फ़ॉर्मैट किए गए, हैश किए गए, और एन्कोड किए गए डेटा का एक सैंपल Event दिया गया है. यह डेटा दूसरे इवेंट से लिया गया है. इसमें Google Analytics के लिए अतिरिक्त डेटा भी शामिल है:

{
  "adIdentifiers": {
     "gclid": "GCLID_2"
  },
  "conversionValue": 42.02,
  "currency": "EUR",
  "eventTimestamp": "2025-06-10T23:42:33-05:00",
  "transactionId": "DEF999911111",
  "eventSource": "WEB",
  "userData": {
    "userIdentifiers": [
      {
        "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
      },
      {
        "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
      },
      {
        "address": {
          "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
          "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
          "regionCode": "PT",
          "postalCode": "1229-076"
        }
      }
    ],
  },
  "userProperties": {
    "customerType": "RETURNING"
  },
  "eventName": "purchase",
  "clientId": "9876543210.1761582117",
  "userId": "user_DEF9876",
  "additionalEventParameters": [
    {
      "parameterName": "ad_unit_name",
      "value": "Banner_02"
    }
  ],
  "cartData": {
    "transactionDiscount": 6.66,
    "items": [
      {
        "itemId": "SKU_12346",
        "quantity": 2,
        "unitPrice": 21.01,
        "additionalItemParameters": [
          {
            "parameterName": "item_name",
            "value": "Google Grey Women's Tee"
          },
          {
            "parameterName": "affiliation",
            "value": "Google Merchandise Store"
          },
          {
            "parameterName": "coupon",
            "value": "SUMMER_FUN"
          },
          {
            "parameterName": "discount",
            "value": "3.33"
          },
          {
            "parameterName": "index",
            "value": "1"
          },
          {
            "parameterName": "item_brand",
            "value": "Google"
          },
          {
            "parameterName": "item_category",
            "value": "Apparel"
          },
          {
            "parameterName": "item_category2",
            "value": "Adult"
          },
          {
            "parameterName": "item_category3",
            "value": "Shirts"
          },
          {
            "parameterName": "item_category4",
            "value": "Crew"
          },
          {
            "parameterName": "item_category5",
            "value": "Short sleeve"
          },
          {
            "parameterName": "item_list_id",
            "value": "related_products"
          },
          {
            "parameterName": "item_list_name",
            "value": "Related Products"
          }
        ]
      }
    ]
  }
}

अनुरोध का मुख्य हिस्सा बनाना

अनुरोध के मुख्य हिस्से के लिए, Destination और Events को एक साथ इस्तेमाल करें:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  ],
  "encoding": "HEX",
  "events": [
     {
       "adIdentifiers": {
         "gclid": "GCLID_1"
       },
       "conversionValue": 30.03,
       "currency": "USD",
       "eventTimestamp": "2025-06-10T20:07:01Z",
       "transactionId": "ABC798654321",
       "eventSource": "WEB",
       "userData": {
         "userIdentifiers": [
           {
             "address": {
               "givenName": "96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A",
               "familyName": "DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081",
               "regionCode": "US",
               "postalCode": "94045"
             }
           }
         ]
       },
       "userProperties": {
         "customerType": "NEW",
         "customerValueBucket": "HIGH"
       },
       "eventName": "purchase",
       "clientId": "1234567890.1761581763",
       "userId": "user_ABC12345",
       "additionalEventParameters": [
         {
           "parameterName": "ad_unit_name",
           "value": "Banner_01"
         }
       ],
       "cartData": {
         "transactionDiscount": 6.66,
         "items": [
           {
             "itemId": "SKU_12345",
             "quantity": 3,
             "unitPrice": 10.01,
             "additionalItemParameters": [
               {
                 "parameterName": "item_name",
                 "value": "Stan and Friends Tee"
               },
               {
                 "parameterName": "affiliation",
                 "value": "Google Merchandise Store"
               },
               {
                 "parameterName": "coupon",
                 "value": "SUMMER_FUN"
               },
               {
                 "parameterName": "discount",
                 "value": "2.22"
               },
               {
                 "parameterName": "index",
                 "value": "0"
               },
               {
                 "parameterName": "item_brand",
                 "value": "Google"
               },
               {
                 "parameterName": "item_category",
                 "value": "Apparel"
               },
               {
                 "parameterName": "item_category2",
                 "value": "Adult"
               },
               {
                 "parameterName": "item_category3",
                 "value": "Shirts"
               },
               {
                 "parameterName": "item_category4",
                 "value": "Crew"
               },
               {
                 "parameterName": "item_category5",
                 "value": "Short sleeve"
               },
               {
                 "parameterName": "item_list_id",
                 "value": "related_products"
               },
               {
                 "parameterName": "item_list_name",
                 "value": "Related Products"
               }
             ]
           }
         ]

       }
     },
     {
       "adIdentifiers": {
         "gclid": "GCLID_2"
       },
       "conversionValue": 42.02,
       "currency": "EUR",
       "eventTimestamp": "2025-06-11T04:42:33Z",
       "transactionId": "DEF999911111",
       "eventSource": "WEB",
       "userData": {
         "userIdentifiers": [
           {
             "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
           },
           {
             "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
           },
           {
             "address": {
               "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
               "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
               "regionCode": "PT",
               "postalCode": "1229-076"
             }
           }
         ]
       },
       "userProperties": {
         "customerType": "RETURNING"
       },
       "eventName": "purchase",
       "clientId": "9876543210.1761582117",
       "userId": "user_DEF9876",
       "additionalEventParameters": [
         {
           "parameterName": "ad_unit_name",
           "value": "Banner_02"
         }
       ],
       "cartData": {
         "transactionDiscount": 6.66,
         "items": [
           {
             "itemId": "SKU_12346",
             "quantity": 2,
             "unitPrice": 21.01,
             "additionalItemParameters": [
               {
                 "parameterName": "item_name",
                 "value": "Google Grey Women's Tee"
               },
               {
                 "parameterName": "affiliation",
                 "value": "Google Merchandise Store"
               },
               {
                 "parameterName": "coupon",
                 "value": "SUMMER_FUN"
               },
               {
                 "parameterName": "discount",
                 "value": "3.33"
               },
               {
                 "parameterName": "index",
                 "value": "1"
               },
               {
                 "parameterName": "item_brand",
                 "value": "Google"
               },
               {
                 "parameterName": "item_category",
                 "value": "Apparel"
               },
               {
                 "parameterName": "item_category2",
                 "value": "Adult"
               },
               {
                 "parameterName": "item_category3",
                 "value": "Shirts"
               },
               {
                 "parameterName": "item_category4",
                 "value": "Crew"
               },
               {
                 "parameterName": "item_category5",
                 "value": "Short sleeve"
               },
               {
                 "parameterName": "item_list_id",
                 "value": "related_products"
               },
               {
                 "parameterName": "item_list_name",
                 "value": "Related Products"
               }
             ]
           }
         ]
       }
     }
  ],
  "validateOnly": true
}

1. बॉडी में मौजूद प्लेसहोल्डर अपडेट करें. जैसे, OPERATING_ACCOUNT_ID और PRODUCT_DESTINATION_ID को अपने खाते और डेस्टिनेशन की वैल्यू के साथ अपडेट करें.
2. बदलावों को लागू किए बिना अनुरोध की पुष्टि करने के लिए, validateOnly को true पर सेट करें. जब आपको बदलाव लागू करने हों, तब validateOnly को false पर सेट करें.
3. ध्यान दें कि इस उदाहरण में एन्क्रिप्शन का इस्तेमाल नहीं किया गया है.

अनुरोध भेजें

1. सैंपल के सबसे ऊपर दाईं ओर मौजूद 'कॉपी करें' बटन का इस्तेमाल करके, अनुरोध के मुख्य हिस्से को कॉपी करें.
2. टूलबार में मौजूद, API बटन पर क्लिक करें.
3. कॉपी किए गए अनुरोध के मुख्य हिस्से को अनुरोध का मुख्य हिस्सा बॉक्स में चिपकाएं.
4. लागू करें बटन पर क्लिक करें. इसके बाद, पुष्टि करने के लिए दिए गए निर्देशों का पालन करें और जवाब की समीक्षा करें.

सक्सेस रिस्पॉन्स

अनुरोध पूरा होने पर, जवाब में एक ऐसा ऑब्जेक्ट मिलता है जिसमें requestId शामिल होता है.

{
  "requestId": "126365e1-16d0-4c81-9de9-f362711e250a"
}

लौटाए गए requestId को रिकॉर्ड करें, ताकि अनुरोध में मौजूद हर डेस्टिनेशन को प्रोसेस करते समय, डाइग्नोस्टिक्स को वापस पाया जा सके.

जवाब नहीं मिलने पर मिलने वाले जवाब

अनुरोध पूरा न होने पर, गड़बड़ी के जवाब का स्टेटस कोड मिलता है. जैसे, 400 Bad Request. साथ ही, गड़बड़ी की जानकारी वाला जवाब मिलता है.

उदाहरण के लिए, अगर emailAddress में हेक्स कोड में बदली गई वैल्यू के बजाय, सामान्य टेक्स्ट वाली स्ट्रिंग शामिल की जाती है, तो यह जवाब मिलता है:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "events.events[0].user_data.user_identifiers",
            "description": "Email is not hex encoded.",
            "reason": "INVALID_HEX_ENCODING"
          }
        ]
      }
    ]
  }
}

हैश नहीं किए गए और सिर्फ़ हेक्स एन्कोड किए गए emailAddress से यह जवाब मिलता है:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "events.events[0]",
            "reason": "INVALID_SHA256_FORMAT"
          }
        ]
      }
    ]
  }
}

एक से ज़्यादा डेस्टिनेशन के लिए इवेंट भेजना

अगर आपके डेटा में अलग-अलग डेस्टिनेशन के लिए इवेंट शामिल हैं, तो डेस्टिनेशन के रेफ़रंस का इस्तेमाल करके, उन्हें एक ही अनुरोध में भेजा जा सकता है.

उदाहरण के लिए, अगर आपके पास कन्वर्ज़न ऐक्शन आईडी 123456789 के लिए एक इवेंट है और कन्वर्ज़न ऐक्शन आईडी 777111122 के लिए दूसरा इवेंट है, तो हर Destination का reference सेट करके, दोनों इवेंट को एक ही अनुरोध में भेजें. reference को उपयोगकर्ता ने तय किया है. सिर्फ़ यह ज़रूरी है कि हर Destination का reference यूनीक हो. अनुरोध के लिए, बदली गई destinations सूची यहां दी गई है:

  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "PRODUCT_DESTINATION_ID",
      "reference": "destination_a"
    },
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_2_TYPE",
        "accountId": "OPERATING_ACCOUNT_2_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_2_TYPE",
        "accountId": "LOGIN_ACCOUNT_2_ID"
      },

      "productDestinationId": "777111122",
      "reference": "destination_b"
    }
  ]

हर Event का destinationReferences सेट करें, ताकि उसे एक या उससे ज़्यादा डेस्टिनेशन पर भेजा जा सके. उदाहरण के लिए, यहां एक Event दिया गया है. यह सिर्फ़ पहले Destination के लिए है. इसलिए, इसकी destinationReferences सूची में सिर्फ़ पहले Destination का reference शामिल है:

{
   "adIdentifiers": {
      "gclid": "GCLID_1"
   },
   "conversionValue": 1.99,
   "currency": "USD",
   "eventTimestamp": "2025-06-10T20:07:01Z",
   "transactionId": "ABC798654321",
   "eventSource": "WEB",
   "destinationReferences": [
      "destination_a"
   ]
}

destinationReferences फ़ील्ड एक सूची है. इसलिए, किसी इवेंट के लिए एक से ज़्यादा डेस्टिनेशन तय किए जा सकते हैं. अगर आपने destinationReferences का destinationReferences सेट नहीं किया है, तो Data Manager API, अनुरोध में शामिल सभी डेस्टिनेशन को इवेंट भेजता है.Event

अगर किसी इवेंट के कई डेस्टिनेशन हैं, तो Data Manager API हर डेस्टिनेशन को काम के फ़ील्ड भेजता है. उदाहरण के लिए, अगर किसी इवेंट का Google Ads और Google Analytics, दोनों डेस्टिनेशन हैं, तो Google Analytics डेस्टिनेशन को इवेंट भेजते समय, API में Google Analytics के फ़ील्ड शामिल होते हैं. जैसे, clientId या eventName. साथ ही, Google Ads डेस्टिनेशन को इवेंट भेजते समय, API में Google Ads के फ़ील्ड शामिल होते हैं. जैसे, customVariables.

अगले चरण

• क्लाइंट लाइब्रेरी की मदद से, पुष्टि करने की सुविधा कॉन्फ़िगर करें और अपना एनवायरमेंट सेट अप करें.
• हर तरह के डेटा के लिए, फ़ॉर्मैटिंग, हैशिंग, और एन्कोडिंग से जुड़ी ज़रूरी शर्तों के बारे में जानें.
• उपयोगकर्ता के डेटा को एन्क्रिप्ट (सुरक्षित) करने का तरीका जानें.
• अपने अनुरोधों के लिए गड़बड़ी की जानकारी पाने का तरीका जानें.
• सबसे सही तरीकों के बारे में जानें.
• सीमाओं और कोटा के बारे में जानें.