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 रिकॉर्ड, और encryptionInfo शामिल होना चाहिए. ऐसा तब करें, जब आपने userData को एन्क्रिप्ट (सुरक्षित) किया हो. प्रॉडक्शन डेटा भेजने से पहले, फ़ास्ट-फ़ेल गड़बड़ियों के लिए अपने पेलोड की जांच करने के लिए, validateOnly: true का इस्तेमाल करें. फ़ील्ड की ज़रूरी शर्तों और कोड सैंपल के लिए, इवेंट भेजें देखें.

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

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

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

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

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

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

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

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

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

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

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

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

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

  • यूज़र आईडी: हमारा सुझाव है कि जब भी कोई यूज़र आइडेंटिफ़ायर उपलब्ध हो, तब 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 के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए नियमों जैसा होना चाहिए.

आगे बढ़ें
इवेंट भेजें