मेज़रमेंट प्रोटोकॉल के इस्तेमाल के उदाहरण

Google Analytics मेज़रमेंट प्रोटोकॉल की मदद से, अपनी वेब या ऐप्लिकेशन स्ट्रीम में ऑफ़लाइन डेटा भेजा जा सकता है. इसके अलावा, टैगिंग या Firebase SDK टूल की मदद से पहले से इकट्ठा किया जा रहा डेटा भी भेजा जा सकता है.

इस गाइड में, Google Analytics मेज़रमेंट प्रोटोकॉल के इस्तेमाल के सामान्य उदाहरणों और उनकी ज़रूरी शर्तों के बारे में बताया गया है.

ज़रूरी शर्तों के बारे में खास जानकारी

इस टेबल में, इस्तेमाल के हर तरीके से जुड़ी ज़रूरी शर्तों के बारे में खास जानकारी दी गई है. इन सबसे सही तरीकों को ध्यान में रखें:

  1. इवेंट और उपयोगकर्ता प्रॉपर्टी का timestamp_micros, डिफ़ॉल्ट रूप से अनुरोध के समय पर सेट होता है. अगर आपको पिछले समय में हुए किसी इवेंट या उपयोगकर्ता प्रॉपर्टी में हुए बदलाव की जानकारी भेजनी है, तो टाइमस्टैंप को बदलें. इसके बारे में इवेंट भेजने और उपयोगकर्ता प्रॉपर्टी से जुड़ी गाइड में बताया गया है.

  2. रीयलटाइम रिपोर्ट और यूज़र ऐक्टिविटी वाली मेट्रिक को सटीक बनाने के लिए, engagement_time_msec इवेंट पैरामीटर को पिछले इवेंट के बाद से गुज़रे हुए मिलीसेकंड पर सेट करें.

इस्तेमाल का उदाहरण सेशन का आईडी अनुरोध करने की समयसीमा से जुड़ी ज़रूरी शर्तें timestamp_micros ज़रूरी शर्त
इवेंट को User-ID असाइन करना ज़रूरी है <= सेशन शुरू होने के कारोबारी दिन के आखिर तक >= सेशन शुरू होने की तारीख और <= सेशन खत्म होने की तारीख
सेशन एट्रिब्यूशन ज़रूरी है <= सेशन शुरू होने का समय + 24 घंटे >= सेशन शुरू होने की तारीख और <= सेशन खत्म होने की तारीख
विज्ञापन प्लैटफ़ॉर्म पर इवेंट एक्सपोर्ट करना ज़रूरी नहीं <= पिछले सेशन का कारोबारी दिन + 63 दिन >= अनुरोध का समय - दो कामकाजी दिन और <= अनुरोध का समय
ऑडियंस बनाने के लिए इवेंट या उपयोगकर्ता प्रॉपर्टी भेजना ज़रूरी नहीं वेब: <= ऑनलाइन इवेंट का सबसे हाल का समय + 30 दिन
ऐप्लिकेशन: <= ऑनलाइन इवेंट का सबसे हाल का समय + 42 दिन		 >= अनुरोध का समय - दो कामकाजी दिन और <= अनुरोध का समय

इवेंट को User-ID असाइन करना

ऑनलाइन या ऑफ़लाइन इवेंट के लिए, मेज़रमेंट प्रोटोकॉल का इस्तेमाल करके User-ID उपलब्ध कराएं.

यहां किसी इवेंट में User-ID जोड़ने के कुछ उदाहरण दिए गए हैं:

  1. ऑनलाइन मेज़रमेंट में, ऑनलाइन इवेंट के लिए User-ID ढूंढने से जुड़ी ज़रूरी जानकारी मौजूद नहीं है. हालांकि, आपके पास इवेंट-प्रोसेसिंग पाइपलाइन है, जो ऑनलाइन सेशन और User-ID के बीच संबंध बना सकती है.

    इस उदाहरण में, मेज़रमेंट प्रोटोकॉल का इस्तेमाल करके, User-ID के साथ ऑनलाइन इवेंट का डेटा भेजा जा रहा है.

  2. आपको Measurement Protocol की मदद से भेजे जा रहे इवेंट के लिए 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 को बदलना है, तो इसे पिछले तीन कामकाजी दिनों के टाइमस्टैंप पर सेट करें.

ऑडियंस बनाने के लिए इवेंट या उपयोगकर्ता प्रॉपर्टी भेजना

अगर कुछ ज़रूरी शर्तों का पालन किया जाता है, तो मेज़रमेंट प्रोटोकॉल का इस्तेमाल करके भेजे गए इवेंट और उपयोगकर्ता प्रॉपर्टी को ऑडियंस की शर्तों के आकलन में शामिल किया जाता है.

ऑडियंस बनाने के लिए इवेंट या उपयोगकर्ता प्रॉपर्टी भेजने की ज़रूरी शर्तें यहां दी गई हैं:

  • अनुरोध को वेब स्ट्रीम पर भेजें. यह अनुरोध, उसी client_id के लिए हुए सबसे हाल के ऑनलाइन इवेंट के 30 दिनों के अंदर, कामकाजी दिन के खत्म होने से पहले भेजा जाना चाहिए.

    उदाहरण के लिए, अगर client_id के लिए आखिरी ऑनलाइन इवेंट 1 मार्च को हुआ था, तो मेज़रमेंट प्रोटोकॉल इवेंट को 31 मार्च के कामकाजी दिन के आखिर तक भेजें.

  • अनुरोध को ऐप्लिकेशन स्ट्रीम पर भेजें. यह अनुरोध, एक ही app_instance_id के लिए हुए आखिरी ऑनलाइन इवेंट के 42 दिनों के अंदर, कामकाजी दिन के खत्म होने से पहले भेजा जाना चाहिए.

    उदाहरण के लिए, अगर app_instance_id के लिए आखिरी ऑनलाइन इवेंट 1 मार्च को हुआ था, तो मेज़रमेंट प्रोटोकॉल इवेंट को 12 अप्रैल के कामकाजी दिन के आखिर तक भेजें.

  • अगर आपको timestamp_micros एट्रिब्यूट की वैल्यू बदलनी है, तो इसे पिछले तीन कामकाजी दिनों के टाइमस्टैंप पर सेट करें.