इवेंट डेटा भेजने के बारे में जानने के लिए, यह शुरुआती लेख पढ़ें.
इवेंट डेटा, आपके टैग कन्वर्ज़न के लिए एक अतिरिक्त डेटा सोर्स है. इससे विज्ञापन इंटरैक्शन के सिग्नल को बढ़ाने के साथ-साथ, डेटा और पूरी परफ़ॉर्मेंस को बेहतर बनाने में मदद मिलती है.
गाइड का वह वर्शन चुनें जिसे आपको देखना है:
इस शुरुआती लेख में, आपको यह तरीका अपनाना होगा:
- इवेंट डेटा पाने के लिए,
Destination
तैयार करें. - भेजने के लिए इवेंट डेटा तैयार करना.
- इवेंट के लिए
IngestionService
अनुरोध बनाएं. - Google APIs Explorer की मदद से अनुरोध भेजें.
- सफलता और गड़बड़ी के जवाबों को समझना.
डेस्टिनेशन तैयार करना
डेटा भेजने से पहले, आपको डेटा भेजने के लिए डेस्टिनेशन तैयार करना होगा. यहां 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 |
|
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 |
|
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 |
|
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
}
- बॉडी में मौजूद प्लेसहोल्डर, जैसे कि
OPERATING_ACCOUNT_ID
औरCONVERSION_ACTION_1_ID
को अपने खाते और डेस्टिनेशन की वैल्यू से अपडेट करें. - बदलावों को लागू किए बिना अनुरोध की पुष्टि करने के लिए,
validateOnly
कोtrue
पर सेट करें. जब आप बदलाव लागू करने के लिए तैयार हों, तोvalidateOnly
कोfalse
पर सेट करें. - ध्यान दें कि इस अनुरोध में एन्क्रिप्शन का इस्तेमाल नहीं किया जाता.
अनुरोध भेजना
- सैंपल के सबसे ऊपर दाईं ओर मौजूद, 'कॉपी करें' बटन का इस्तेमाल करके, अनुरोध का मुख्य हिस्सा कॉपी करें.
events.ingest
पेज पर जाएं.- दाईं ओर मौजूद एपीआई बटन पर क्लिक करें. इसके बाद, बड़े किए गए सेक्शन में मौजूद इसे आज़माएं! बटन पर क्लिक करें.
- अनुरोध का कॉपी किया गया मुख्य हिस्सा, अनुरोध का मुख्य हिस्सा बॉक्स में चिपकाएं.
- कार्रवाई करें बटन पर क्लिक करें. इसके बाद, अनुमति के लिए पूछे गए सवालों के जवाब दें और जवाब की समीक्षा करें.
सफलता के जवाब
अनुरोध पूरा होने पर, जवाब के तौर पर एक ऑब्जेक्ट मिलता है, जिसमें 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, अनुरोध में मौजूद सभी डेस्टिनेशन पर इवेंट भेजता है.
अगले चरण
- पुष्टि करने की सुविधा कॉन्फ़िगर करें और क्लाइंट लाइब्रेरी की मदद से अपना एनवायरमेंट सेट अप करें.
- हर तरह के डेटा के लिए, फ़ॉर्मैटिंग, हैशिंग, और कोड में बदलने से जुड़ी ज़रूरी शर्तों के बारे में जानें.
- उपयोगकर्ता के डेटा को एन्क्रिप्ट (सुरक्षित) करने का तरीका जानें.