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 के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए नियमों जैसा होना चाहिए.

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