Google Analytics में सुझाए गए और कस्टम इवेंट

Google Analytics के सुझाए गए और कस्टम इवेंट भेजने के लिए, Data Manager API का इस्तेमाल करें.

सुझाए गए और कस्टम इवेंट भेजना

अगर आपको Google Analytics मेज़रमेंट प्रोटोकॉल से अपग्रेड करना है, तो निर्देश पाने के लिए मेज़रमेंट प्रोटोकॉल से Data Manager API पर अपग्रेड करना लेख पढ़ें.

वर्कफ़्लो के बारे में खास जानकारी

Data Manager API की मदद से इवेंट डेटा भेजने के लिए, यह तरीका अपनाएं:

1. डेस्टिनेशन तैयार करें: टारगेट खाते और कन्वर्ज़न या इवेंट डेस्टिनेशन के बारे में बताने के लिए, डेटा ट्रांसफ़र करने के अनुरोध के destinations फ़ील्ड के लिए Destination ऑब्जेक्ट तय करें. ज़्यादा जानकारी के लिए, डेस्टिनेशन तैयार करना लेख पढ़ें.

2. इवेंट डेटा और आइडेंटिफ़ायर तैयार करना: Event फ़ील्ड में इवेंट की जानकारी और ज़रूरी आइडेंटिफ़ायर भरें. जैसे, विज्ञापन पर क्लिक, क्लाइंट या ऐप्लिकेशन इंस्टेंस आइडेंटिफ़ायर. अगर userData में उपयोगकर्ता की संपर्क जानकारी शामिल की जाती है, तो फ़ॉर्मैटिंग के दिशा-निर्देशों के मुताबिक आइडेंटिफ़ायर को नॉर्मलाइज़ और SHA-256 हैश करें. साथ ही, उन्हें एन्क्रिप्ट भी किया जा सकता है. ज़्यादा जानकारी के लिए, इवेंट डेटा तैयार करना लेख पढ़ें.

3. डेटा ट्रांसफ़र करने का अनुरोध बनाएं और भेजें: events.ingest अनुरोध सबमिट करें. इसमें destinations, Event रिकॉर्ड, और userData को एन्क्रिप्ट (सुरक्षित) करने पर encryptionInfo शामिल होना चाहिए. प्रोडक्शन डेटा भेजने से पहले, validateOnly: true का इस्तेमाल करके जल्दी ठीक न होने वाली गड़बड़ियों के लिए अपने पेलोड की जांच करें. फ़ील्ड की ज़रूरी शर्तों और कोड सैंपल के लिए, इवेंट भेजना लेख पढ़ें.

4. डाइग्नोस्टिक्स की जांच करना: एसिंक्रोनस प्रोसेसिंग डाइग्नोस्टिक्स को वापस पाएं और requestStatus.retrieve की मदद से, डेटा डालने की स्थिति की पुष्टि करें.

उपयोग के उदाहरण

अहम जानकारी: Data Manager API का मकसद, gtag, Tag Manager, और Google Analytics for Firebase के ज़रिए डेटा अपने-आप इकट्ठा होने की सुविधा को बेहतर बनाना है, न कि इसे बदलना.

Data Manager API की मदद से, सुझाए गए और कस्टम इवेंट भेजने के कुछ उदाहरण यहां दिए गए हैं:

• ऑनलाइन और ऑफ़लाइन व्यवहार के डेटा को आपस में जोड़ने में मदद मिलती है.

• क्लाइंट-साइड और सर्वर-साइड इंटरैक्शन मेज़र करना.

• ऑफ़लाइन कन्वर्ज़न जैसे स्टैंडर्ड उपयोगकर्ता के इंटरैक्शन से बाहर होने वाले इवेंट भेजने में.

• उन डिवाइसों और ऐप्लिकेशन से इवेंट भेजें जहां अपने-आप डेटा इकट्ठा होने की सुविधा उपलब्ध नहीं है. जैसे, कियॉस्क और स्मार्टवॉच.

उपयोगकर्ता से मिला डेटा

पहले पक्ष के ग्राहक से जुड़े डेटा को Event के userData फ़ील्ड में भेजा जा सकता है. जैसे, हैश किए गए ईमेल पते, फ़ोन नंबर, और घर या ऑफ़िस के पते. इससे Google Analytics में कन्वर्ज़न मेज़रमेंट, एट्रिब्यूशन, और ऑडियंस बनाने की प्रोसेस को बेहतर बनाने में मदद मिलती है.

उपयोगकर्ता से मिला डेटा भेजते समय, इन बातों का ध्यान रखें:

• इवेंट के साथ भेजा गया: Data Manager API में, उपयोगकर्ता से मिला डेटा, Event के हिस्से के तौर पर भेजा जाना चाहिए. इवेंट के बिना, अलग से अपलोड किए गए वीडियो को इस सुविधा के साथ इस्तेमाल नहीं किया जा सकता.

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

• एन्क्रिप्ट (सुरक्षित) करना: आपके पास हैश किए गए उपयोगकर्ता डेटा को एन्क्रिप्ट (सुरक्षित) करने का विकल्प होता है.

• User-ID: हमारा सुझाव है कि जब भी उपयोगकर्ता का एक जैसा आइडेंटिफ़ायर उपलब्ध हो, तब userData के साथ-साथ userId भी दें.

• लागू करना: अनुरोध बनाने के निर्देशों के लिए, उपयोगकर्ता से मिला डेटा जोड़ें लेख पढ़ें.

इंटिग्रेशन से जुड़ी ज़रूरी बातें

Data Manager API का इस्तेमाल करते समय, इन बातों का ध्यान रखें.

रीमार्केटिंग

Google सिग्नल चालू करने पर, Google Analytics में एक ही डिवाइस पर रीमार्केटिंग की सुविधा काम करती है. क्रॉस-डिवाइस रीमार्केटिंग के लिए, userId ज़रूरी है.

इसके अलावा, उपयोगकर्ता से मिला डेटा भेजा जा सकता है, ताकि पहले पक्ष की ऑडियंस मैचिंग की सुविधा चालू की जा सके.

विज्ञापन के लिए आइडेंटिफ़ायर

Google Analytics, ऑनलाइन इंटरैक्शन के दौरान इकट्ठा किए गए विज्ञापन के लिए आइडेंटिफ़ायर (जैसे, GBRAID या WBRAID) को Data Manager API इवेंट के साथ अपने-आप जोड़ देता है. इसके लिए, वह clientId या appInstanceId का इस्तेमाल करता है.

निजता सेटिंग

Google Analytics, Data Manager API के इवेंट को ऑनलाइन इंटरैक्शन के साथ जोड़ता है. इसके लिए, वह clientId या appInstanceId का इस्तेमाल करता है, ताकि उपयोगकर्ता की निजता सेटिंग को अपनाया जा सके. जैसे, "लोगों के हिसाब से न दिखाए जाने वाले विज्ञापन" और "विज्ञापन की ट्रैकिंग को सीमित करना".

consent ऑब्जेक्ट का इस्तेमाल करके, हर इवेंट के लिए उपयोगकर्ता की सहमति की सेटिंग भी सीधे तौर पर तय की जा सकती हैं.

भौगोलिक और डिवाइस की जानकारी

Google Analytics, टैगिंग से मिली जगह और डिवाइस की सबसे हाल की जानकारी को Data Manager API इवेंट के साथ अपने-आप जोड़ देता है. इसके लिए, वह clientId या appInstanceId का इस्तेमाल करता है. इससे यह पक्का होता है कि आपके Data Manager API इवेंट, उन रिपोर्ट में दिखें जिनमें भौगोलिक और डिवाइस डाइमेंशन शामिल हैं.

अगर आपको Data Manager API इवेंट में, clientId या appInstanceId की नई जानकारी के बजाय, किसी खास सेशन की जगह और डिवाइस की जानकारी दिखानी है, तो additionalEventParameters में एक एंट्री शामिल करें. इसमें parameterName को session_id पर और value को उस खास सेशन के आईडी पर सेट करें. साथ ही, सेशन शुरू होने के 24 घंटे के अंदर इवेंट भेजें.

Data Manager API का इस्तेमाल करके, इवेंट के लिए भौगोलिक जानकारी और डिवाइस की जानकारी दी जा सकती है.

सर्वर-टू-सर्वर इंटिग्रेशन

सिर्फ़ Data Manager API का इस्तेमाल करके, Google Analytics को इवेंट भेजे जा सकते हैं. हालांकि, ऐसा करने पर सिर्फ़ कुछ रिपोर्टिंग उपलब्ध हो सकती है. Data Manager API का मकसद, gtag, Tag Manager या Firebase का इस्तेमाल करके इकट्ठा किए गए मौजूदा इवेंट को बेहतर बनाना है. कुछ इवेंट और पैरामीटर के नाम, अपने-आप इकट्ठा होने वाले डेटा के लिए रिज़र्व होते हैं. इन्हें Data Manager API के ज़रिए नहीं भेजा जा सकता.

इवेंट जनरेट करना या उनके नाम बदलना

Data Manager API की मदद से भेजे गए इवेंट, इवेंट जनरेट करने या उनका नाम बदलने के नियमों को ट्रिगर नहीं करते. आपके ऐप्लिकेशन में, Data Manager API के ज़रिए कस्टम इवेंट भेजने का लॉजिक लागू होना चाहिए. यह लॉजिक, Google Analytics के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए नियमों जैसा होना चाहिए.