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

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

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

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

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

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

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

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

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

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

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

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

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

  2. आपको मेज़रमेंट प्रोटोकॉल की मदद से भेजे जा रहे इवेंट के लिए 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 घंटों के अंदर का टाइमस्टैंप पर सेट करें.