इवेंट भेजें

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

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

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

  यह सुविधा सिर्फ़ उन खातों के लिए उपलब्ध है जिन्हें अनुमति दी गई है. अगर आपको अपना Google Ads खाता या 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 या sessionAttributes में से कम से कम एक सेट हो userData	वैकल्पिक	ज़रूरी है. EventSource के लिए, enum वैल्यू में से किसी एक पर सेट किया गया हो.
   Google Ads डेस्टिनेशन को अतिरिक्त डेटा सोर्स के तौर पर भेजे गए इवेंट	ज़रूरी है. इनमें से कम से कम एक को सेट करें: adIdentifiers जिसमें gclid, gbraid या wbraid में से कम से कम एक सेट हो userData	ज़रूरी है	ज़रूरी नहीं. अगर सेट किया गया है, तो WEB होना चाहिए.
   Google Analytics डेस्टिनेशन को अतिरिक्त डेटा सोर्स के तौर पर भेजे गए इवेंट	ज़रूरी है. इनमें से कम से कम एक को सेट करें: clientId adIdentifiers with gclid set userData	ज़रूरी है	ज़रूरी नहीं. अगर सेट किया गया है, तो WEB होना चाहिए.

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

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

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

eventName

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

transactionId

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

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

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

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

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

• userData: उपयोगकर्ता के आइडेंटिफ़ायर, जैसे कि ईमेल पते, फ़ोन नंबर या पते की जानकारी.

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

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

अगले चरण

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