इवेंट भेजें

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

इनमें से किसी भी स्थिति के लिए, 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. इसके अलावा, उपयोगकर्ता आइडेंटिफ़ायर भी हो सकते हैं, जैसे कि ईमेल पते, फ़ोन नंबर, और पते की जानकारी. किसी इवेंट में ये भी हो सकते हैं:

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

इवेंट 1

इवेंट #1
conversion_time 2025-06-10 15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 30.03
currency USD
gclid GCLID_1
emails
given_name John
family_name Smith-Jones
region_code us
postal_code 94045
customer_type NEW
customer_value_bucket HIGH
client_id 1234567890.1761581763
user_id user_ABC12345
ad_unit_name Banner_01
event_name purchase
कार्ट में मौजूद आइटम
item_id SKU_12345
item_name Stan and Friends Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 2.22
item_index 0
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 10.01
item_quantity 3

इवेंट 2

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

zoe@EXAMPLE.COM

cloudy.sanfrancisco@gmail.com
given_name zoë
family_name pérez
region_code PT
postal_code 1229-076
customer_type RETURNING
client_id 9876543210.1761582117
user_id user_DEF9876
ad_unit_name Banner_02
event_name purchase
कार्ट में मौजूद आइटम
item_id SKU_12346
item_name Google Grey Women's Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 3.33
item_index 1
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 21.01
item_quantity 2

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

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

इवेंट 1

इवेंट #1
conversion_time 2025-06-10T15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 30.03
currency USD
gclid GCLID_1
emails
given_name john
family_name smith-jones
region_code US
postal_code 94045
customer_type NEW
customer_value_bucket HIGH
client_id 1234567890.1761581763
user_id user_ABC12345
ad_unit_name Banner_01
event_name purchase
कार्ट में मौजूद आइटम
item_id SKU_12345
item_name Stan and Friends Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 2.22
item_index 0
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 10.01
item_quantity 3

इवेंट 2

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

zoe@example.com

cloudysanfrancisco@gmail.com
given_name zoë
family_name pérez
region_code PT
postal_code 1229-076
customer_type RETURNING
client_id 9876543210.1761582117
user_id user_DEF9876
ad_unit_name Banner_02
event_name purchase
कार्ट में मौजूद आइटम
item_id SKU_12346
item_name Google Grey Women's Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 3.33
item_index 1
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 21.01
item_quantity 2

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

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

इवेंट 1

इवेंट #1
conversion_time 2025-06-10T15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 30.03
currency USD
gclid GCLID_1
emails
given_name 96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A
family_name DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081
region_code US
postal_code 94045
customer_type NEW
customer_value_bucket HIGH
client_id 1234567890.1761581763
user_id user_ABC12345
ad_unit_name Banner_01
event_name purchase
कार्ट में मौजूद आइटम
item_id SKU_12345
item_name Stan and Friends Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 2.22
item_index 0
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 10.01
item_quantity 3

इवेंट 2

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

3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250

223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4
given_name 2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450
family_name 6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F
region_code PT
postal_code 1229-076
customer_type RETURNING
client_id 9876543210.1761582117
user_id user_DEF9876
ad_unit_name Banner_02
event_name purchase
कार्ट में मौजूद आइटम
item_id SKU_12346
item_name Google Grey Women's Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 3.33
item_index 1
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 21.01
item_quantity 2

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

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

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

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

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

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

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

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

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

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

स्थिति डेटा फ़ील्ड इसे कैसे मैनेज किया जाता है
transactionId, मौजूदा टैग इवेंट से मैच करती है conversionValue (currencyCode के साथ)

अपडेट किया गया. Event से मिली conversionValue (currencyCode के साथ), टैग से रिकॉर्ड की गई ओरिजनल वैल्यू को बदल देती है.

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

transactionId, मौजूदा टैग इवेंट से मैच करती है conversionValue या currencyCode के अलावा अन्य फ़ील्ड (उदाहरण के लिए, adIdentifiers.gclid) अनदेखा किया गया. आपके अतिरिक्त डेटा सोर्स से मिली अन्य फ़ील्ड वैल्यू, मैच किए गए लेन-देन के लिए Google टैग से रिकॉर्ड की गई फ़ील्ड वैल्यू को नहीं बदलेंगी.
transactionId, किसी भी मौजूदा इवेंट से मैच नहीं करता उपलब्ध कराया गया पूरा डेटा (उदाहरण के लिए, userData, conversionValue, currencyCode)

इसका इस्तेमाल, नया कन्वर्ज़न इवेंट बनाने के लिए किया जाता है. इसके बाद, Google आपके दिए गए आइडेंटिफ़ायर (जैसे कि adIdentifiers.gclid या userData) का इस्तेमाल करके, इस नए कन्वर्ज़न को विज्ञापन पर क्लिक को एट्रिब्यूट करने की कोशिश करेगा.

ध्यान दें: 14 दिनों के शुरुआती ट्रायल पीरियड के दौरान, ये नए कन्वर्ज़न आपकी रिपोर्टिंग में दिखेंगे. हालांकि, इनका इस्तेमाल बिडिंग के लिए नहीं किया जाएगा. ट्रायल पीरियड की अवधि खत्म होने के बाद, इनके लिए अपने-आप बिडिंग शुरू हो जाएगी.

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

अगर ऑफ़लाइन कन्वर्ज़न या लीड के लिए बेहतर कन्वर्ज़न ट्रैकिंग का डेटा भेजा जा रहा है, तो सेशन एट्रिब्यूट जोड़ें. ऐसा तब करें, जब 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

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

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

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

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

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

अनुरोध का मुख्य हिस्सा बनाने के लिए, destinations और events को मिलाएं. इसके बाद, encoding फ़ील्ड सेट करें. साथ ही, अनुरोध के वे सभी फ़ील्ड जोड़ें जिन्हें आपको शामिल करना है. जैसे, validateOnly और consent.

इस गाइड में दिए गए उदाहरणों में एन्क्रिप्शन का इस्तेमाल नहीं किया गया है. हालांकि, अपनी प्रोसेस में एन्क्रिप्शन जोड़ने के लिए, उपयोगकर्ता के डेटा को एन्क्रिप्ट (सुरक्षित) करना में दिए गए निर्देशों का पालन किया जा सकता है.

अनुरोध भेजें

  1. API Explorer को नए टैब या विंडो में खोलने के लिए, API Explorer में खोलें पर क्लिक करें.
  2. API Explorer में अनुरोध के मुख्य भाग में, REPLACE_WITH से शुरू होने वाली हर स्ट्रिंग को बदलें. जैसे, REPLACE_WITH_OPERATING_ACCOUNT_TYPE को काम की वैल्यू से बदलें.
  3. अनुरोध भेजने के लिए, API एक्सप्लोरर पेज पर सबसे नीचे मौजूद Execute पर क्लिक करें. इसके बाद, अनुमति से जुड़े प्रॉम्प्ट पूरे करें.
  4. बदलावों को लागू किए बिना अनुरोध की पुष्टि करने के लिए, validateOnly को true पर सेट करें. जब आपको बदलाव लागू करने हों, तब validateOnly को false पर सेट करें.

डेटा डालने का अनुरोध

एपीआई एक्सप्लोरर में खोलें 
{
    "destinations": [
        {
            "operatingAccount": {
                "accountType": "OPERATING_ACCOUNT_TYPE",
                "accountId": "OPERATING_ACCOUNT_ID"
            },
            "loginAccount": {
                "accountType": "LOGIN_ACCOUNT_TYPE",
                "accountId": "LOGIN_ACCOUNT_ID"
            },
            "productDestinationId": "CONVERSION_ACTION_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
}

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

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

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

अगले चरण

पीछे जाएं
इवेंट की खास जानकारी