इवेंट भेजें

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

इनमें से किसी भी स्थिति में, 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_ADS या GOOGLE_ANALYTICS_PROPERTY पर सेट करें. साथ ही, accountId को Google Ads ग्राहक आईडी या Google Analytics प्रॉपर्टी आईडी पर सेट करें. अगर accountType GOOGLE_ANALYTICS_PROPERTY है, तो अनुरोध के क्रेडेंशियल, Google Analytics के ऐसे उपयोगकर्ता के लिए होने चाहिए जिसके पास प्रॉपर्टी के लिए एडिटर या एडमिन की भूमिका हो.

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

loginAccount

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

अगर आपके OAuth क्रेडेंशियल, Google Ads मैनेजर खाते को ऐक्सेस करने वाले किसी उपयोगकर्ता के लिए हैं और उस खाते में operatingAccount को उप-खाते के तौर पर इस्तेमाल किया जाता है, तो loginAccount ज़रूरी है. loginAccount के accountId को मैनेजर खाते के आईडी पर सेट करें. साथ ही, loginAccount के accountType को GOOGLE_ADS पर सेट करें.

अगर आपके OAuth क्रेडेंशियल, operatingAccount को सीधे तौर पर ऐक्सेस करने वाले उपयोगकर्ता के लिए हैं, तो आपको loginAccount सेट करने की ज़रूरत नहीं है. यह डिफ़ॉल्ट रूप से operatingAccount पर सेट होता है. हालांकि, हमारा सुझाव है कि loginAccount को operatingAccount के accountId और accountType के बराबर सेट करें. इससे, अगर उपयोगकर्ता के पास मौजूद खातों के सेट में बदलाव होता है, तो समस्याएं नहीं आतीं.

productDestinationId

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

अतिरिक्त डेटा सोर्स के तौर पर भेजे गए इवेंट के लिए, productDestinationId Google Ads कन्वर्ज़न का आईडी होना चाहिए. साथ ही, type को WEBPAGE पर सेट किया जाना चाहिए. इसके अलावा, Google Analytics की वेब स्ट्रीम का मेज़रमेंट आईडी भी इस्तेमाल किया जा सकता है. Google Analytics के iOS ऐप्लिकेशन या Android ऐप्लिकेशन की स्ट्रीम में, इवेंट को अतिरिक्त डेटा सोर्स के तौर पर नहीं भेजा जा सकता.

ऑफ़लाइन कन्वर्ज़न या लीड के लिए बेहतर कन्वर्ज़न ट्रैकिंग के लिए, productDestinationId, Google Ads कन्वर्ज़न ऐक्शन का आईडी होना चाहिए. साथ ही, type को 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.

अगले चरण

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