Google Analytics मेज़रमेंट प्रोटोकॉल की मदद से, अपनी वेब या ऐप्लिकेशन स्ट्रीम में ऑफ़लाइन डेटा भेजा जा सकता है. इसके अलावा, टैगिंग या Firebase SDK टूल की मदद से पहले से इकट्ठा किया जा रहा डेटा भी भेजा जा सकता है.
इस गाइड में, Google Analytics मेज़रमेंट प्रोटोकॉल के इस्तेमाल के सामान्य उदाहरणों और उनकी ज़रूरी शर्तों के बारे में बताया गया है.
ज़रूरी शर्तों के बारे में खास जानकारी
इस टेबल में, इस्तेमाल के हर तरीके से जुड़ी ज़रूरी शर्तों के बारे में खास जानकारी दी गई है. इन सबसे सही तरीकों को ध्यान में रखें:
इवेंट और उपयोगकर्ता प्रॉपर्टी का
timestamp_micros, डिफ़ॉल्ट रूप से अनुरोध के समय पर सेट होता है. अगर आपको पिछले समय में हुए किसी इवेंट या उपयोगकर्ता प्रॉपर्टी में हुए बदलाव की जानकारी भेजनी है, तो टाइमस्टैंप को बदलें. इसके बारे में इवेंट भेजने और उपयोगकर्ता प्रॉपर्टी से जुड़ी गाइड में बताया गया है.रीयलटाइम रिपोर्ट और यूज़र ऐक्टिविटी वाली मेट्रिक को सटीक बनाने के लिए,
engagement_time_msecइवेंट पैरामीटर को पिछले इवेंट के बाद से गुज़रे हुए मिलीसेकंड पर सेट करें.
| इस्तेमाल का उदाहरण | सेशन का आईडी | अनुरोध करने की समयसीमा से जुड़ी ज़रूरी शर्तें | timestamp_micros की ज़रूरी शर्त |
|---|---|---|---|
| इवेंट को User-ID असाइन करना | ज़रूरी है | <= सेशन शुरू होने के कामकाजी दिन के खत्म होने तक | >= सेशन शुरू होने की तारीख और <= सेशन खत्म होने की तारीख |
| सेशन एट्रिब्यूशन | ज़रूरी है | <= सेशन शुरू होने का समय + 24 घंटे | >= सेशन शुरू होने की तारीख और <= सेशन खत्म होने की तारीख |
| विज्ञापन प्लैटफ़ॉर्म पर इवेंट एक्सपोर्ट करना | ज़रूरी नहीं | <= आखिरी सेशन का दिन + 63 दिन | >= अनुरोध का समय - 72 घंटे और <= अनुरोध का समय |
| ऑडियंस बनाने के लिए इवेंट या उपयोगकर्ता प्रॉपर्टी भेजना | ज़रूरी नहीं | वेब: <= ऑनलाइन इवेंट का सबसे नया समय + 30 दिन ऐप्लिकेशन: <= ऑनलाइन इवेंट का सबसे नया समय + 42 दिन |
>= अनुरोध का समय - 72 घंटे और <= अनुरोध का समय |
इवेंट को User-ID असाइन करना
मेज़रमेंट प्रोटोकॉल का इस्तेमाल करके, ऑनलाइन या ऑफ़लाइन इवेंट को User-ID दें.
यहां किसी इवेंट में User-ID जोड़ने के कुछ उदाहरण दिए गए हैं:
ऑनलाइन मेज़रमेंट में, ऑनलाइन इवेंट के लिए User-ID ढूंढने से जुड़ी ज़रूरी जानकारी मौजूद नहीं है. हालांकि, आपके पास इवेंट-प्रोसेसिंग पाइपलाइन है, जो ऑनलाइन सेशन और User-ID के बीच संबंध बना सकती है.
इस उदाहरण में, मेज़रमेंट प्रोटोकॉल का इस्तेमाल करके, User-ID के साथ ऑनलाइन इवेंट भेजे जा रहे हैं.
आपको Measurement Protocol की मदद से भेजे जा रहे इवेंट के लिए User-ID नहीं मिला है. हालांकि, आपको उन इवेंट को User-ID से जोड़ना है. ऐसा तब करना है, जब उपयोगकर्ता ने सेशन के दौरान ऑनलाइन लॉग इन किया हो.
इस उदाहरण में, User-ID के साथ मेज़रमेंट प्रोटोकॉल इवेंट उपलब्ध कराने के लिए, ऑनलाइन इवेंट का इस्तेमाल किया जा रहा है.
किसी इवेंट में User-ID जोड़ने के लिए, ये ज़रूरी शर्तें पूरी करनी होंगी:
- इवेंट के पैरामीटर की सूची में
session_idको शामिल करें. - मेज़रमेंट प्रोटोकॉल इवेंट को, ऑनलाइन सेशन के उसी कारोबारी दिन भेजें.
- अगर आपको
timestamp_microsको बदलना है, तो इसे ऑनलाइन सेशन के शुरू और खत्म होने के समय के बीच के टाइमस्टैंप पर सेट करें. - अगर आपका लक्ष्य ऑनलाइन इवेंट के लिए User-ID उपलब्ध कराना है, तो अनुरोध में
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 घंटों के अंदर का टाइमस्टैंप पर सेट करें.