इवेंट भेजें

इवेंट डेटा भेजने के बारे में जानने के लिए, यह शुरुआती लेख पढ़ें.

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

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

इस शुरुआती लेख में, आपको यह तरीका अपनाना होगा:

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

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

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

    {
      "operatingAccount": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  • operatingAccount के accountId को उस Google Ads खाते के आईडी पर सेट करें जिसे इवेंट डेटा मिलेगा. operatingAccount का product, GOOGLE_ADS होना चाहिए.
  • इवेंट के लिए, productDestinationId को कन्वर्ज़न ऐक्शन के आईडी पर सेट करें. कन्वर्ज़न ऐक्शन, Google Ads कन्वर्ज़न ऐक्शन होना चाहिए, जिसमें type को WEBPAGE पर सेट किया गया हो.

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

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

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

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

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

इवेंट #1
conversion_time 2025-06-10 15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 1.99
currency USD
gclid GCLID_1
emails
given_name John
last_name Smith-Jones
region_code us
postal_code 94045

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

इवेंट #2
conversion_time June 10, 2025 11:42:33PM America/New_York
conversion_action_id 123456789
transaction_id DEF999911111
conversion_value 3.25
currency eur
gclid GCLID_2
emails

zoe@EXAMPLE.COM

cloudy.sanfrancisco@gmail.com

given_name zoë
last_name pérez
region_code PT
postal_code 1229-076

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

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

इवेंट #1
conversion_time 2025-06-10 15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 1.99
currency USD
gclid GCLID_1
emails
given_name john
last_name smith-jones
region_code US
postal_code 94045

फ़ॉर्मैट करने के बाद, दूसरे इवेंट का डेटा यहां दिया गया है:

इवेंट #2
conversion_time 2025-06-10T23:42:33-05:00
conversion_action_id 123456789
transaction_id DEF999911111
conversion_value 3.25
currency EUR
gclid GCLID_2
emails

zoe@example.com

cloudysanfrancisco@gmail.com

given_name zoë
last_name pérez
region_code PT
postal_code 1229-076

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

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

इवेंट #1
conversion_time 2025-06-10 15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 1.99
currency USD
gclid GCLID_1
emails
given_name 96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A
last_name DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081
region_code US
postal_code 94045

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

इवेंट #2
conversion_time 2025-06-10T23:42:33-05:00
conversion_action_id 123456789
transaction_id DEF999911111
conversion_value 3.25
currency EUR
gclid GCLID_2
emails

3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250

223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4

given_name 2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450
last_name 6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F
region_code PT
postal_code 1229-076

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

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

  • timestamp: इवेंट होने का समय.
  • transaction_id: इवेंट के लिए यूनीक आइडेंटिफ़ायर.
  • event_source: इवेंट का सोर्स. अगर इसकी वैल्यू दी गई है, तो यह वैल्यू EVENT_SOURCE_WEB होनी चाहिए.
  • ad_identifiers या user_data: इवेंट में विज्ञापन आइडेंटिफ़ायर या उपयोगकर्ता डेटा होना चाहिए. अगर आपके पास इवेंट के लिए दोनों हैं, तो दोनों भेजें.

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

यहां दूसरे इवेंट के फ़ॉर्मैट किए गए, हैश किए गए, और कोड में बदले गए डेटा के लिए Event का सैंपल दिया गया है:

{
   "adIdentifiers": {
      "gclid": "GCLID_2"
   },
   "conversionValue": 3.25,
   "currency": "EUR",
   "timestamp": "2025-06-10T23:42:33-05:00",
   "transactionId": "DEF999911111",
   "eventSource": "EVENT_SOURCE_WEB",
   "userData": {
      "userIdentifiers": [
         {
            "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
         },
         {
            "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
         },
         {
            "address": {
              "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
              "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
              "regionCode": "PT",
              "postalCode": "1229-076"
            }
         }
      ]
   }
}

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

अनुरोध के मुख्य हिस्से के लिए, Destination और Events को जोड़ें:

{
  "destinations": [
    {
      "operatingAccount": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  ],
  "encoding": "HEX",
  "events": [
     {
       "adIdentifiers": {
         "gclid": "GCLID_1"
       },
       "conversionValue": 1.99,
       "currency": "USD",
       "timestamp": "2025-06-10T20:07:01Z",
       "transactionId": "ABC798654321",
       "eventSource": "EVENT_SOURCE_WEB",
       "userData": {
         "userIdentifiers": [
           {
             "address": {
               "givenName": "96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A",
               "lastName": "DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081",
               "regionCode": "US",
               "postalCode": "94045"
             }
           }
         ]
       }
     },
     {
       "adIdentifiers": {
         "gclid": "GCLID_2"
       },
       "conversionValue": 3.25,
       "currency": "EUR",
       "timestamp": "2025-06-11T04:42:33Z",
       "transactionId": "DEF999911111",
       "eventSource": "EVENT_SOURCE_WEB",
       "userData": {
         "userIdentifiers": [
           {
             "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
           },
           {
             "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
           },
           {
             "address": {
               "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
               "lastName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
               "regionCode": "PT",
               "postalCode": "1229-076"
             }
           }
         ]
       }
     }
  ],
  "validateOnly": true
}
  1. बॉडी में मौजूद प्लेसहोल्डर, जैसे कि OPERATING_ACCOUNT_ID और CONVERSION_ACTION_1_ID को अपने खाते और डेस्टिनेशन की वैल्यू से अपडेट करें.
  2. बदलावों को लागू किए बिना अनुरोध की पुष्टि करने के लिए, validateOnly को true पर सेट करें. जब आप बदलाव लागू करने के लिए तैयार हों, तो validateOnly को false पर सेट करें.
  3. ध्यान दें कि इस अनुरोध में एन्क्रिप्शन का इस्तेमाल नहीं किया जाता.

अनुरोध भेजना

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

सफलता के जवाब

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

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

गड़बड़ी के जवाब

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

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

{
  "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"
          }
        ]
      }
    ]
  }
}

हैश नहीं किया गया और सिर्फ़ हेक्स कोड में बदला गया email_address, यह रिस्पॉन्स दिखाता है:

{
  "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": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "123456789"
      "reference": "conversion_action_1"
    },
    {
      "operatingAccount": {
        "product": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "777111122"
      "reference": "conversion_action_2"
    }
  ]

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

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

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

अगले चरण