Google Analytics मेज़रमेंट प्रोटोकॉल की मदद से, अपनी वेबसाइट या ऐप्लिकेशन स्ट्रीम में ऑफ़लाइन डेटा भेजा जा सकता है. इसके अलावा, टैगिंग या Firebase SDK टूल की मदद से पहले से इकट्ठा किए जा रहे डेटा को भी भेजा जा सकता है.
इस गाइड में, Google Analytics मेज़रमेंट प्रोटोकॉल के इस्तेमाल के सामान्य उदाहरण और उनकी ज़रूरी शर्तों के बारे में बताया गया है.
ज़रूरी शर्तों के बारे में खास जानकारी
इस टेबल में, हर इस्तेमाल के उदाहरण के लिए ज़रूरी शर्तों के बारे में बताया गया है. इन सबसे सही तरीकों को ध्यान में रखें:
इवेंट और उपयोगकर्ता प्रॉपर्टी का
timestamp_micros, डिफ़ॉल्ट रूप से अनुरोध के समय पर सेट होता है. पहले हुए किसी इवेंट या उपयोगकर्ता प्रॉपर्टी में हुए बदलाव को भेजते समय, टाइमस्टैंप को बदलें. इसके बारे में इवेंट भेजने की गाइड और उपयोगकर्ता प्रॉपर्टी की गाइड में बताया गया है.सटीक रीयलटाइम रिपोर्ट और यूज़र ऐक्टिविटी मेट्रिक के लिए,
engagement_time_msecइवेंट पैरामीटर को पिछले इवेंट के बाद से बीते मिलीसेकंड पर सेट करें.
| इस्तेमाल का उदाहरण | सेशन आईडी | अनुरोध करने के समय से जुड़ी ज़रूरी शर्त | timestamp_micros की ज़रूरी शर्त |
|---|---|---|---|
| इवेंट को यूज़र आईडी असाइन करना | ज़रूरी है | <= सेशन शुरू होने के कामकाजी दिन के खत्म होने तक | >= सेशन शुरू होने का समय और <= सेशन खत्म होने का समय |
| सेशन एट्रिब्यूशन | ज़रूरी है | <= सेशन शुरू होने के 24 घंटे के अंदर | >= सेशन शुरू होने का समय और <= सेशन खत्म होने का समय |
| विज्ञापन प्लैटफ़ॉर्म पर इवेंट एक्सपोर्ट करना | ज़रूरी नहीं | <= आखिरी सेशन का दिन + 63 दिन | >= अनुरोध के समय से 72 घंटे पहले और <= अनुरोध का समय |
| ऑडियंस बनाने के लिए इवेंट या उपयोगकर्ता प्रॉपर्टी भेजें | ज़रूरी नहीं | वेब: <= सबसे हाल के ऑनलाइन इवेंट का समय + 30 दिन ऐप्लिकेशन: <= सबसे हाल के ऑनलाइन इवेंट का समय + 42 दिन |
>= अनुरोध के समय से 72 घंटे पहले और <= अनुरोध का समय |
इवेंट को यूज़र आईडी असाइन करना
यूज़र आईडी की मदद से, ऑनलाइन या ऑफ़लाइन इवेंट उपलब्ध कराने के लिए, मेज़रमेंट प्रोटोकॉल का इस्तेमाल करें.
यहां किसी इवेंट में यूज़र आईडी जोड़ने के कुछ उदाहरण दिए गए हैं:
आपके ऑनलाइन मेज़रमेंट में, ऑनलाइन इवेंट के लिए यूज़र आईडी देखने के लिए ज़रूरी जानकारी मौजूद नहीं है. हालांकि, आपके पास इवेंट-प्रोसेसिंग पाइपलाइन है, जो ऑनलाइन सेशन और यूज़र आईडी के बीच असोसिएशन बना सकती है.
इस मामले में, मेज़रमेंट प्रोटोकॉल का इस्तेमाल करके, User-ID के साथ ऑनलाइन इवेंट उपलब्ध कराए जा रहे हैं.
आपके पास उन इवेंट के लिए User-ID नहीं है जिन्हें मेज़रमेंट प्रोटोकॉल की मदद से भेजा जा रहा है. हालांकि, आपको उन इवेंट को User-ID से जोड़ना है, क्योंकि उपयोगकर्ता ने सेशन के दौरान ऑनलाइन लॉग इन किया था.
इस मामले में, यूज़र आईडी के साथ मेज़रमेंट प्रोटोकॉल इवेंट उपलब्ध कराने के लिए, ऑनलाइन इवेंट का इस्तेमाल किया जा रहा है.
किसी इवेंट में यूज़र आईडी जोड़ने के लिए, ये ज़रूरी शर्तें पूरी करनी होंगी:
- इवेंट के पैरामीटर की सूची में
session_idको शामिल करें. - मेज़रमेंट प्रोटोकॉल इवेंट को ऑनलाइन सेशन वाले कामकाजी दिन ही भेजें.
- अगर आपको
timestamp_microsको बदलना है, तो इसे ऑनलाइन सेशन के शुरू और खत्म होने के समय के बीच के टाइमस्टैंप पर सेट करें. - अगर आपका लक्ष्य ऑनलाइन इवेंट के लिए यूज़र आईडी उपलब्ध कराना है, तो अनुरोध में
user_idसेट करें. - अगर आपका लक्ष्य यह है कि मेज़रमेंट प्रोटोकॉल के हर इवेंट में, उससे जुड़े ऑनलाइन सेशन का यूज़र आईडी शामिल हो, तो आपको
user_idसेट करने की ज़रूरत नहीं है.
सेशन एट्रिब्यूशन
तय की गई ज़रूरी शर्तों को पूरा करने वाले मेज़रमेंट प्रोटोकॉल इवेंट, रिपोर्ट में उसी सेशन के ऑनलाइन इवेंट के सेशन एट्रिब्यूट के साथ दिखते हैं. जैसे, भौगोलिक जानकारी, सोर्स, मीडियम, और कैंपेन.
सेशन एट्रिब्यूशन के लिए ये ज़रूरी शर्तें हैं:
- इवेंट के पैरामीटर की सूची में
session_idको शामिल करें. ऑनलाइन सेशन शुरू होने के 24 घंटे के अंदर अनुरोध भेजें.
उदाहरण के लिए, अगर आपकी प्रॉपर्टी के टाइम ज़ोन के हिसाब से सोमवार को सुबह 11:15 बजे सेशन शुरू हुआ, तो मंगलवार को सुबह 11:15 बजे से पहले अनुरोध भेजें.
अगर
timestamp_microsको बदला जाता है, तो इसे ऑनलाइन सेशन के शुरू और खत्म होने के समय के बीच के टाइमस्टैंप पर सेट करें.
विज्ञापन प्लैटफ़ॉर्म पर इवेंट एक्सपोर्ट करना
Google Analytics, मेज़रमेंट प्रोटोकॉल का इस्तेमाल करके भेजे गए इवेंट को, लिंक किए गए विज्ञापन प्रॉडक्ट में एक्सपोर्ट करता है. जैसे, Google Ads या Campaign Manager 360.
यहां कुछ ऐसी सामान्य स्थितियां दी गई हैं जिनमें यह सुविधा काम आती है:
- आपके कारोबार में ऑफ़लाइन इवेंट होते हैं और आपको उन्हें विज्ञापन एट्रिब्यूशन और रिपोर्टिंग में शामिल करना है.
- आपके पास किसी ऐसे सिस्टम में अतिरिक्त इवेंट हैं जो टैगिंग या Firebase SDK टूल के लिए उपलब्ध नहीं है. हालांकि, आपको उन इवेंट को लिंक किए गए प्रॉडक्ट में शामिल करना है.
विज्ञापन प्लैटफ़ॉर्म पर इवेंट एक्सपोर्ट करने के लिए, ये ज़रूरी शर्तें हैं:
अनुरोध को सबसे नए ऑनलाइन इवेंट के 63 दिनों के अंदर भेजें. भले ही, मुख्य इवेंट की एट्रिब्यूशन विंडो 63 दिनों से ज़्यादा की हो. इवेंट, मुख्य इवेंट की एट्रिब्यूशन विंडो के अंदर भी आना चाहिए. एट्रिब्यूशन विंडो की सेटिंग को कॉन्फ़िगर करने का तरीका जानें.
उदाहरण के लिए, अगर
client_idयाapp_instance_idके लिए सबसे हाल का ऑनलाइन इवेंट 1 मार्च को हुआ, तो मेज़रमेंट प्रोटोकॉल इवेंट को 3 मई से पहले भेजें.अगर
timestamp_microsको बदला जाता है, तो इसे पिछले 72 घंटों के अंदर के टाइमस्टैंप पर सेट करें.
ऑडियंस बनाने के लिए इवेंट या उपयोगकर्ता प्रॉपर्टी भेजना
मेज़रमेंट प्रोटोकॉल का इस्तेमाल करके भेजे गए इवेंट और उपयोगकर्ता प्रॉपर्टी, ऑडियंस की शर्तों के आकलन में शामिल की जाती हैं. हालांकि, इसके लिए आपको कुछ ज़रूरी शर्तें पूरी करनी होंगी.
ऑडियंस बनाने के लिए, इवेंट या उपयोगकर्ता प्रॉपर्टी भेजने की ज़रूरी शर्तें यहां दी गई हैं:
उसी
client_idके लिए, सबसे नए ऑनलाइन इवेंट के 30 दिनों के अंदर, वेब स्ट्रीम को अनुरोध भेजें.उदाहरण के लिए, अगर
client_idके लिए सबसे हाल ही का ऑनलाइन इवेंट 1 मार्च को हुआ, तो मेज़रमेंट प्रोटोकॉल इवेंट को 31 मार्च से पहले भेजें.उसी
app_instance_idके लिए, हाल ही के ऑनलाइन इवेंट के 42 दिनों के अंदर, ऐप्लिकेशन स्ट्रीम को अनुरोध भेजें.उदाहरण के लिए, अगर
app_instance_idके लिए सबसे हाल का ऑनलाइन इवेंट 1 मार्च को हुआ, तो मेज़रमेंट प्रोटोकॉल इवेंट को 12 अप्रैल तक भेजें.अगर आपको
timestamp_microsको बदलना है, तो इसे पिछले 72 घंटों के अंदर के टाइमस्टैंप पर सेट करें.