Google Analytics के सुझाए गए और कस्टम इवेंट भेजने के लिए, Data Manager API का इस्तेमाल करें.
ज़्यादा जानकारी के लिए, इवेंट भेजना लेख पढ़ें.
अगर आपको Google Analytics मेज़रमेंट प्रोटोकॉल से अपग्रेड करना है, तो निर्देशों के लिए मेज़रमेंट प्रोटोकॉल से Data Manager API पर अपग्रेड करना लेख पढ़ें.
उपयोग के उदाहरण
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, Data Manager API इवेंट के साथ ऑनलाइन इंटरैक्शन के दौरान इकट्ठा किए गए विज्ञापन आइडेंटिफ़ायर (जैसे, GBRAID या WBRAID) को अपने-आप जोड़ता है. इसके लिए, वह 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 के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए नियमों जैसा होना चाहिए.