मोबाइल ऐप्लिकेशन के लिए सर्वर साइड टैगिंग

Google Tag Manager में सर्वर-साइड टैगिंग के साथ काम करने के लिए, 'Firebase के लिए Google Analytics' SDK टूल का इस्तेमाल करके, अपने मोबाइल ऐप्लिकेशन कॉन्फ़िगर किए जा सकते हैं.

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

मोबाइल ऐप्लिकेशन के लिए सर्वर-साइड टैगिंग सेट अप करने के लिए:

1. अपने ऐप्लिकेशन को सर्वर साइड टैगिंग के लिए तैयार करना
2. मोबाइल ट्रैफ़िक के साथ काम करने के लिए, अपने सर्वर कंटेनर को कॉन्फ़िगर करना
3. अपनी GA4 प्रॉपर्टी में सर्वर-साइड टैगिंग की सुविधा चालू करना

ज़रूरी शर्तें

• आपको अपने ऐप्लिकेशन में 'Firebase के लिए Google Analytics' SDK टूल शामिल करना होगा और इसे अपनी Google Analytics 4 प्रॉपर्टी से कनेक्ट करना होगा. Firebase के लिए Google Analytics SDK टूल के बारे में ज़्यादा जानें.
• इसके लिए, आपके पास Google Tag Manager खाता और सर्वर कंटेनर होना चाहिए. अगर आपके पास ऐसा खाता नहीं है, तो नया Tag Manager खाता और कंटेनर बनाएं.
• आपको टैग करने वाला सर्वर सेट अप करना होगा.

पहला चरण: अपने ऐप्लिकेशन को सर्वर साइड टैगिंग के लिए तैयार करना

iOS

1. सर्वर साइड टैगिंग अपलोड करने की सुविधा चालू करें. साथ ही, Info.plist फ़ाइल में सर्वर साइड टैगिंग डीबग मोड के लिए, कस्टम यूआरएल स्कीम सेट अप करें. यहां दिए गए BUNDLE_ID को ऐप्लिकेशन के बंडल आइडेंटिफ़ायर से बदलें.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. डीबग या झलक मोड चालू करने के लिए, लॉन्च यूआरएल पास करने के लिए, लाइफ़साइकल के तरीके में Analytics.handleOpen(_:) पर कॉल जोड़ें.

   SwiftUI

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   SwiftUI या UIScene का इस्तेमाल न करने वाले ऐप्लिकेशन के लिए, कुछ करने की ज़रूरत नहीं है. SDK टूल को लॉन्च यूआरएल, ApplicationDidFinishLaunchingNotification से मिलता है.

Android

1. 'Firebase के लिए Google Analytics' SDK टूल की नई रिलीज़ इंस्टॉल करें.

2. ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में ये चीज़ें जोड़कर, sGTM को चालू करें.

   <!-- Preview Activity to enable preview mode –->
     <activity
         android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
         android:exported="true"
         android:noHistory="true" >
       <intent-filter>
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
       </intent-filter>
     </activity>
   
   <!-- Meta-data that enables uploads to sGTM –->
     <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

दूसरा चरण: मोबाइल ट्रैफ़िक के साथ काम करने के लिए, अपने सर्वर कंटेनर को कॉन्फ़िगर करना

इस सेक्शन में यह माना गया है कि आपके पास सर्वर साइड टैगिंग की मौजूदा डिप्लॉयमेंट है और आपको इसके कॉन्सेप्ट के बारे में पता है. अगर आपको सर्वर साइड टैगिंग के बारे में जानकारी नहीं है, तो सर्वर साइड टैगिंग की बुनियादी बातें कोर्स लें.

Google Analytics: GA4 (ऐप्लिकेशन) क्लाइंट सेट अप करना

क्लाइंट, Tag Manager का एक रिसॉर्स टाइप है. यह कुछ खास तरह के आ रहे अनुरोधों को इंटरसेप्ट करता है और ऐसे इवेंट जनरेट करता है जिन्हें Google Analytics 4 जैसे डेस्टिनेशन पर भेजा जा सकता है. इस मामले में, एचटीटीपी अनुरोध एक Google Analytics 4 इवेंट है. इसलिए, आपको पहले से मौजूद Google Analytics: GA4 (ऐप्लिकेशन) क्लाइंट को कॉन्फ़िगर करना होगा. आपको हर डेटा सोर्स के लिए सिर्फ़ एक GA4 क्लाइंट की ज़रूरत होती है. जैसे, GA SDK टूल और वेबसाइट. क्लाइंट के काम करने के तरीके के बारे में ज़्यादा जानें.

1. अपने सर्वर कंटेनर में, क्लाइंट पर जाएं और नया पर क्लिक करें.

2. क्लाइंट कॉन्फ़िगरेशन पर क्लिक करें. इसके बाद, Google Analytics: GA4 (ऐप्लिकेशन) चुनें.

   

3. अपने क्लाइंट के लिए कोई नाम डालें और सेव करें पर क्लिक करें.

अपना Google Analytics: GA4 टैग कॉन्फ़िगर करना

Google Analytics को डेटा भेजने के लिए, आपको सर्वर कंटेनर में Google Analytics: GA4 टैग बनाना होगा. क्लाइंट, आने वाले एचटीटीपी अनुरोध को इवेंट डेटा ऑब्जेक्ट में पार्स करता है. टैग इस इवेंट डेटा ऑब्जेक्ट को लेगा, उसे सही फ़ॉर्मैट में मैप करेगा, और फिर उसे Google Analytics 4 को भेजेगा.

1. अपने सर्वर कंटेनर में, टैग पर जाएं और नया पर क्लिक करें.

2. टैग कॉन्फ़िगरेशन पर क्लिक करें. इसके बाद, Google Analytics: GA4 चुनें.

   

डिफ़ॉल्ट रूप से, टैग को क्लाइंट से बनाए गए इवेंट डेटा ऑब्जेक्ट से सभी ज़रूरी फ़ील्ड और पैरामीटर इनहेरिट मिलेंगे:

• अगर Google Analytics 4 का इनकमिंग अनुरोध, Google Analytics: GA4 (ऐप्लिकेशन) क्लाइंट से गुज़रता है, तो टैग को ऐप्लिकेशन आईडी और इवेंट पैरामीटर इनहेरिट मिलते हैं.
• अगर आने वाले Google Analytics 4 अनुरोध, Google Analytics: GA4 (वेब) क्लाइंट से गुज़रते हैं, तो टैग को मेज़रमेंट आईडी और इवेंट पैरामीटर इनहेरिट मिलते हैं.

सलाह: टैग के सामने पेश किए जाने से पहले, अपने क्लाइंट से मिले इवेंट पैरामीटर आउटपुट को शामिल करने, बाहर रखने या उनमें बदलाव करने के लिए, ट्रांसफ़ॉर्मेशन का इस्तेमाल किया जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है. ट्रांसफ़ॉर्मेशन की मदद से, संवेदनशील जानकारी को सुरक्षित रखा जा सकता है. साथ ही, यह भी तय किया जा सकता है कि आगे की प्रोसेसिंग के लिए कौनसे इवेंट पैरामीटर उपलब्ध होंगे.

मोबाइल ट्रैफ़िक के लिए ट्रिगर सेट अप करना

इसके बाद, आपको यह तय करना होगा कि GA4 टैग कब ट्रिगर होना चाहिए. Google Analytics: GA4 (ऐप्लिकेशन) क्लाइंट, आने वाले अनुरोध को इवेंट डेटा ऑब्जेक्ट में पार्स करता है. साथ ही, टैग को इसकी वैल्यू इनहेरिट करनी होंगी. इसलिए, आम तौर पर आप चाहेंगे कि जब भी GA4 क्लाइंट अनुरोध का दावा करे, तब टैग ट्रिगर हो जाए.

ट्रिगर सेट अप करने के लिए:

1. टैग सेटिंग में, ट्रिगर करना पर क्लिक करें.
2. नया ट्रिगर बनाने के लिए, सबसे ऊपर दाएं कोने में मौजूद + आइकॉन पर क्लिक करें.
3. ट्रिगर टाइप चुनने के लिए, ट्रिगर कॉन्फ़िगरेशन पर क्लिक करें.

4. सूची से कस्टम या कस्टम इवेंट चुनें.

   • कस्टम ट्रिगर टाइप, डिफ़ॉल्ट रूप से टैग को ट्रिगर करता है. ऐसा तब होता है, जब सर्वर-साइड क्लाइंट से कोई इवेंट जनरेट होता है.
   • कस्टम इवेंट ट्रिगर टाइप का इस्तेमाल, किसी खास इवेंट के नाम या रेगुलर एक्सप्रेशन पैटर्न से मैच करने वाले इवेंट पर टैग को ट्रिगर करने के लिए किया जा सकता है.

5. इस ट्रिगर के लिए, ट्रिगर होने की शर्तों की सूची चालू करने के लिए, कुछ इवेंट चुनें. जैसे, सिर्फ़ मोबाइल या वेब इवेंट डेटा पर ट्रिगर होना.

   1. आपको इवेंट का नाम पहले से चुना हुआ दिखेगा. उस सिलेक्टर पर क्लिक करें और सूची से बिल्ट-इन वैरिएबल चुनें चुनें.
   2. इवेंट जनरेट करने वाले क्लाइंट का नाम अपने-आप दिखाने के लिए, क्लाइंट का नाम चुनें.

   3. शर्त को तदनुसार सेट करने के लिए, उस क्लाइंट के नाम का इस्तेमाल करें जिसे आपने पहले कॉन्फ़िगर किया था. आपका ट्रिगर कुछ ऐसा दिखना चाहिए:

      

      ध्यान दें: क्लाइंट का नाम वही है जो आपने पिछले चरण में बताया था. क्लाइंट का टाइप Google Analytics: GA4 (ऐप्लिकेशन) है. क्लाइंट का नाम वैरिएबल, क्लाइंट का नाम दिखाता है, न कि उसका टाइप.

6. ट्रिगर को सेव करें और कोई ऐसा नाम डालें जिससे उसके बारे में जानकारी मिलती हो. उदाहरण के लिए, "सभी GA4 ऐप्लिकेशन इवेंट" का इस्तेमाल किया जा सकता है.

7. अब आपको टैग सेटिंग में वापस जाना होगा. यहां आपको नया ट्रिगर दिखेगा. टैग सेव करें और जानकारी देने वाला कोई नाम डालें. जैसे, "GA4." आपका टैग ऐसा दिखना चाहिए:

   

सलाह: कुछ इवेंट को आगे भेजने से रोकने के लिए, इवेंट के नाम (या किसी अन्य वैरिएबल) के आधार पर, शर्तों के लॉजिक के साथ कस्टम ट्रिगर का इस्तेमाल किया जा सकता है. इसके अलावा, ट्रिगर के अपवाद भी जोड़े जा सकते हैं. ट्रिगर ट्रिगर करने और ट्रिगर के अपवादों के बारे में ज़्यादा जानें.

अपने कंटेनर की झलक देखना

बदलावों को पब्लिश करने से पहले, Google Tag Manager का इस्तेमाल करके अपने सर्वर कंटेनर की झलक देखी जा सकती है और उसे डीबग किया जा सकता है. ध्यान दें कि झलक तब तक नहीं दिखेगी, जब तक आपने अपनी GA4 प्रॉपर्टी में सर्वर-साइड टैगिंग की सुविधा चालू नहीं कर दी है.

अपने ऐप्लिकेशन के अनुरोधों से झलक दिखाने की सुविधा को ट्रिगर करने के लिए, आपको ये काम करने होंगे:

1. Google Tag Manager सर्वर कंटेनर में, झलक देखें को चुनें.
2. सबसे ऊपर दाईं ओर, ज़्यादा कार्रवाइयां आइकॉन ⋮ पर क्लिक करें. इसके बाद, किसी ऐप्लिकेशन से अनुरोध भेजें को चुनें.

3. अपना ऐप्लिकेशन आईडी डालें और क्यूआर कोड जनरेट करें पर क्लिक करें.

   

4. अपने फ़ोन के कैमरा ऐप्लिकेशन से क्यूआर कोड को स्कैन करें. अपने ऐप्लिकेशन से उसी तरह इंटरैक्ट करें, जैसे आम तौर पर इवेंट की झलक जनरेट करने के लिए किया जाता है.

5. डायलॉग बॉक्स बंद करने के लिए, ठीक है पर क्लिक करें.

अपना कंटेनर पब्लिश करना

बदलावों की पुष्टि करने के बाद, कंटेनर को पब्लिश करें, ताकि वे सभी ट्रैफ़िक के लिए लागू हो सकें. पब्लिश करने, वर्शन, और अनुमतियों के बारे में ज़्यादा जानें.

तीसरा चरण: अपनी GA4 प्रॉपर्टी में सर्वर-साइड टैगिंग की सुविधा चालू करना

1. Google Analytics 4 प्रॉपर्टी में, एडमिन पर जाएं.
2. डेटा स्ट्रीम खोलें.

3. iOS या Android टैब से, अपने ऐप्लिकेशन का स्ट्रीम कॉन्फ़िगरेशन चुनें.

   

4. SDK टूल की सेटिंग कॉन्फ़िगर करें पर क्लिक करें. इसके बाद, सर्वर साइड Tag Manager कॉन्फ़िगर करें पर क्लिक करें.

   

5. एसडीके को सर्वर कंटेनर यूआरएल पर मेज़रमेंट डेटा भेजने की अनुमति देने के लिए:

   1. सर्वर साइड Tag Manager कंटेनर में डेटा भेजें को टॉगल करें.
   2. सर्वर कंटेनर का यूआरएल कॉपी करें. इसे Google Tag Manager में एडमिन > कंटेनर सेटिंग > सर्वर कंटेनर यूआरएल पर जाकर देखा जा सकता है.

   3. वह ट्रैफ़िक प्रतिशत चुनें जिसे आपको सर्वर कंटेनर पर भेजना है. अपने सभी ट्रैफ़िक के लिए, सर्वर साइड टैगिंग का इस्तेमाल करने से पहले, अपने सर्वर सेटअप और कॉन्फ़िगरेशन की पुष्टि करने के लिए, 100% से कम का विकल्प चुना जा सकता है.

      ध्यान दें: सिर्फ़ डिवाइसों को डीबग करें विकल्प का इस्तेमाल करके, सिर्फ़ उन ऐप्लिकेशन को चालू करें जिन्हें झलक मोड का इस्तेमाल करके खोला गया है. इससे, आपके सर्वर पर डेटा भेजा जा सकेगा.

   

6. सेव करें पर क्लिक करें. SDK टूल, अपडेट किया गया सर्वर कंटेनर यूआरएल वापस लाएगा और उस पर मेज़रमेंट डेटा भेजेगा.

सीमाएं

• Android ऐप्लिकेशन के लिए:

  • सर्वर कंटेनर और Google Play services से जुड़ी सुरक्षा से जुड़ी संभावित समस्याओं से बचने के लिए, इवेंट को SDK टूल और आपके सर्वर कंटेनर के बीच, स्टेटलेस प्रॉक्सी सर्वर से भेजा जाएगा. यह प्रॉक्सी, अनुरोध के सोर्स और एंडपॉइंट की पुष्टि करेगी. हालांकि, यह इवेंट के बारे में कोई डेटा जांच या सेव नहीं करेगी. GA4, ईयू में मौजूद डिवाइसों से डेटा कैसे इकट्ठा करता है के मुताबिक, ईयू में मौजूद ट्रैफ़िक के लिए, प्रॉक्सी ईयू में होगी.
  • अपने-आप रिकॉर्ड की गई इन-ऐप्लिकेशन खरीदारी, Google Play के बैकएंड के साथ इंटिग्रेशन पर निर्भर करती हैं. इन्हें सर्वर कंटेनर में नहीं भेजा जाएगा.
  • app_remove इवेंट की रिपोर्ट, Android पर नहीं की जाएगी.

• Google Analytics में मौजूद अपने ऐप्लिकेशन की डेटा स्ट्रीम को Google Ads खाते से कनेक्ट करना अब भी ज़रूरी है. इससे यह पक्का किया जा सकेगा कि आपका SDK डेटा और कन्वर्ज़न, Google Ads में इंपोर्ट हो जाएं. सर्वर-साइड टैगिंग, आपके SDK और Google Ads के बीच कोई भी इंटिग्रेशन नहीं देती.

एपीआई

Tag Manager कॉन्फ़िगरेशन डेटा को ऐक्सेस करने के लिए, Tag Manager REST API का इस्तेमाल किया जा सकता है. एपीआई के बारे में ज़्यादा जानकारी के लिए:

• एपीआई के साथ काम करने का तरीका जानने के लिए, डेवलपर गाइड पढ़ें.
• Tag Manager के संसाधनों और उपलब्ध ऑपरेशन के बारे में जानने के लिए, Tag Manager API रेफ़रंस देखें.