برچسب گذاری سمت سرور برای برنامه های تلفن همراه

می‌توانید برنامه‌های تلفن همراه خود را با استفاده از Google Analytics برای Firebase SDK پیکربندی کنید تا با برچسب‌گذاری سمت سرور در Google Tag Manager کار کنند.

برچسب‌گذاری سمت سرور به شما امکان می‌دهد داده‌های خود را قبل از ارسال به محصولات مقصد مانند Google Analytics، مرحله‌بندی، ویرایش و تقویت کنید. درباره برچسب‌گذاری سمت سرور بیشتر بیاموزید.

برای تنظیم برچسب‌گذاری سمت سرور برای برنامه‌های تلفن همراه:

1. برنامه خود را برای برچسب گذاری سمت سرور آماده کنید
2. ظرف سرور خود را برای پشتیبانی از ترافیک تلفن همراه پیکربندی کنید
3. برچسب‌گذاری سمت سرور را در ویژگی GA4 خود فعال کنید

پیش نیازها

• باید Google Analytics برای Firebase SDK را در برنامه خود قرار دهید و آن را به ویژگی Google Analytics 4 خود متصل کنید. درباره Google Analytics برای Firebase SDK بیشتر بیاموزید.
• شما به یک حساب Google Tag Manager و یک ظرف سرور نیاز دارید. اگر ندارید، یک حساب مدیر برچسب و ظرف جدید ایجاد کنید .
• شما باید یک سرور برچسب گذاری راه اندازی کنید .

مرحله 1: برنامه خود را برای برچسب گذاری سمت سرور آماده کنید

iOS

1. ویژگی بارگذاری برچسب‌گذاری سمت سرور را فعال کنید و طرح URL سفارشی را برای حالت اشکال‌زدایی برچسب‌گذاری سمت سرور در فایل 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(_:) در یک روش چرخه حیات اضافه کنید تا URL راه اندازی را ارسال کنید.

   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 URL راه اندازی را از ApplicationDidFinishLaunchingNotification دریافت می کند.

اندروید

1. آخرین نسخه Google Analytics برای Firebase 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" />
   

مرحله 2: ظرف سرور خود را برای پشتیبانی از ترافیک تلفن همراه پیکربندی کنید

در بخش زیر فرض می شود که شما یک تگ گذاری سمت سرور موجود دارید و با مفاهیم آن آشنا هستید. اگر با برچسب گذاری سمت سرور تازه کار هستید، می توانید دوره اصول برچسب گذاری سمت سرور را بگذرانید.

سرویس گیرنده Google Analytics: GA4 (برنامه) را تنظیم کنید

کلاینت یک نوع منبع تگ منیجر است که انواع خاصی از درخواست‌های ورودی را رهگیری می‌کند و رویدادهایی ایجاد می‌کند که می‌توانند به مقصد ارسال شوند، مانند Google Analytics 4. در این مورد، درخواست HTTP یک رویداد Google Analytics 4 است، بنابراین باید پیکربندی کنید. سرویس گیرنده Google Analytics داخلی: GA4 (برنامه). شما فقط به یک مشتری GA4 برای هر منبع داده مانند GA SDK و وب سایت نیاز دارید. درباره نحوه کار مشتریان بیشتر بیاموزید.

1. در ظرف سرور خود، به Clients بروید و روی New کلیک کنید.

2. روی Client Configuration کلیک کنید، سپس Google Analytics: GA4 (برنامه) را انتخاب کنید.

   

3. یک نام برای مشتری خود وارد کنید و روی ذخیره کلیک کنید.

Google Analytics خود را پیکربندی کنید: برچسب GA4

برای ارسال داده به Google Analytics، باید یک برچسب Google Analytics: GA4 در ظرف سرور ایجاد کنید. مشتری درخواست HTTP ورودی را در یک شی داده رویداد تجزیه می کند. تگ این شی داده رویداد را می گیرد، آن را به فرمت صحیح نگاشت می کند و سپس آن را به Google Analytics 4 ارسال می کند.

1. در ظرف سرور خود، به Tags بروید و روی New کلیک کنید.

2. روی پیکربندی برچسب کلیک کنید، سپس Google Analytics: GA4 را انتخاب کنید.

   

به طور پیش فرض، تگ تمام فیلدها و پارامترهای مربوطه را از شی داده رویداد ایجاد شده توسط مشتری به ارث می برد:

• اگر درخواست Google Analytics 4 دریافتی از طریق سرویس گیرنده Google Analytics: GA4 (برنامه) ارسال شود، برچسب شناسه برنامه و پارامترهای رویداد را به ارث می برد.
• اگر درخواست های دریافتی Google Analytics 4 از طریق سرویس گیرنده Google Analytics: GA4 (Web) عبور کند، برچسب شناسه اندازه گیری و پارامترهای رویداد را به ارث می برد.

نکته: می‌توانید به صورت اختیاری از تبدیل‌ها برای گنجاندن، حذف یا تغییر خروجی پارامترهای رویداد از مشتری خود قبل از قرار گرفتن در معرض برچسب‌ها استفاده کنید. با تبدیل، می توانید از اطلاعات حساس محافظت کنید و کنترل دقیقی بر روی پارامترهای رویداد برای پردازش بیشتر در دسترس داشته باشید.

راه‌اندازی برای ترافیک تلفن همراه تنظیم کنید

سپس باید مشخص کنید که چه زمانی باید تگ GA4 فعال شود. سرویس گیرنده Google Analytics: GA4 (برنامه) درخواست دریافتی را در یک شی داده رویداد تجزیه می کند و تگ مقادیر آن را به ارث می برد. بنابراین، شما معمولاً می خواهید هر زمان که مشتری GA4 درخواست را درخواست کند، تگ فعال شود.

برای تنظیم محرک ها:

1. در تنظیمات برچسب، روی Triggering کلیک کنید.
2. برای ایجاد یک ماشه جدید، روی نماد + در گوشه سمت راست بالا کلیک کنید.
3. برای انتخاب نوع ماشه روی پیکربندی ماشه کلیک کنید.

4. رویداد سفارشی یا سفارشی را از لیست انتخاب کنید.

   • نوع تریگر سفارشی ، به طور پیش‌فرض، وقتی هر رویدادی توسط یک کلاینت سمت سرور ایجاد می‌شود، تگ را فعال می‌کند.
   • نوع ماشه رویداد سفارشی را می توان برای شلیک برچسب روی نام رویداد خاص یا رویدادی که با الگوی عبارت معمولی مطابقت دارد استفاده کرد.

5. برای فعال کردن لیست شرایط فعال‌سازی برای این راه‌انداز مانند فعال کردن فقط در داده‌های رویدادهای تلفن همراه یا وب، برخی رویدادها را انتخاب کنید.

   1. نام رویداد را از پیش انتخاب شده خواهید دید. روی آن انتخابگر کلیک کرده و Choose Built-In Variable را از لیست انتخاب کنید.
   2. برای بازگرداندن خودکار نام مشتری که رویداد را ایجاد کرده است، نام مشتری را انتخاب کنید.

   3. از نام کلاینتی که قبلاً پیکربندی کرده اید استفاده کنید تا شرایط را مطابق با آن تنظیم کنید. ماشه شما باید به شکل زیر باشد:

      

      توجه: نام کلاینت همان چیزی است که در مرحله قبل مشخص کرده اید. نوع مشتری Google Analytics است: GA4 (برنامه). متغیر Client Name نام مشتری را برمی گرداند و نه نوع مشتری.

6. ماشه را ذخیره کنید و یک نام توصیفی وارد کنید. برای مثال، می‌توانید از «همه رویدادهای برنامه GA4» استفاده کنید.

7. اکنون باید با تریگر جدید به تنظیمات برچسب برگردید. برچسب را ذخیره کنید و یک نام توصیفی، به عنوان مثال "GA4" وارد کنید. برچسب شما باید به شکل زیر باشد:

   

نکته: برای حذف برخی رویدادها از ارسال به بعد، می‌توانید از راه‌اندازهای سفارشی با منطق شرطی بر اساس نام رویداد (یا برخی متغیرهای دیگر) استفاده کنید یا استثناهای راه‌اندازی را اضافه کنید. درباره محرک‌های شلیک و استثناهای راه‌انداز بیشتر بیاموزید.

پیش نمایش ظرف خود را

می‌توانید از Google Tag Manager برای پیش‌نمایش و اشکال‌زدایی محفظه سرور خود قبل از انتشار تغییرات استفاده کنید. توجه داشته باشید که تا زمانی که برچسب‌گذاری سمت سرور را در ویژگی GA4 خود فعال نکنید، پیش‌نمایش کار نخواهد کرد.

برای اینکه درخواست‌های برنامه شما پیکربندی پیش‌نمایش را فعال کنند، باید:

1. زمانی که در ظرف سرور Google Tag Manager خود هستید، پیش‌نمایش را انتخاب کنید.
2. روی نماد More Actions ⋮ در بالا سمت راست کلیک کنید و Send requests from an app را انتخاب کنید.

3. شناسه برنامه خود را وارد کنید و روی Generate QR Code کلیک کنید.

   

4. کد QR را با برنامه دوربین گوشی خود اسکن کنید. همانطور که برای ایجاد رویدادهای پیش نمایش انجام می دهید، به تعامل با برنامه خود ادامه دهید.

5. روی OK کلیک کنید تا گفتگو بسته شود.

ظرف خود را منتشر کنید

پس از اینکه تغییرات خود را تأیید کردید، کانتینر را منتشر کنید تا این تغییرات برای همه ترافیک فعال شود. درباره انتشار، نسخه‌ها و تأییدیه‌ها بیشتر بیاموزید.

مرحله 3: برچسب گذاری سمت سرور را در ویژگی GA4 خود فعال کنید

1. در ویژگی Google Analytics 4 خود، به Admin بروید.
2. جریان های داده را باز کنید.

3. پیکربندی پخش جریانی برنامه خود را از تب iOS یا Android انتخاب کنید.

   

4. روی پیکربندی تنظیمات SDK و سپس پیکربندی مدیر برچسب سمت سرور کلیک کنید.

   

5. برای فعال کردن SDK برای ارسال داده های اندازه گیری به URL ظرف سرور:

   1. ارسال داده به ظرف مدیر برچسب سمت سرور را تغییر دهید.
   2. URL ظرف سرور را کپی کنید. با رفتن به Admin > Container Settings > Server Container URLs می توانید این را در Google Tag Manager خود بیابید.

   3. درصد ترافیکی را که می خواهید به کانتینر سرور هدایت کنید، انتخاب کنید. شما می توانید قبل از استفاده از برچسب گذاری سمت سرور برای تمام ترافیک خود، گزینه ای زیر 100% را برای تأیید تنظیم و پیکربندی سرور خود انتخاب کنید.

      توجه: از گزینه Debug devices only استفاده کنید تا فقط برنامه هایی را فعال کنید که با استفاده از حالت پیش نمایش باز می شوند تا داده ها را به سرور شما ارسال کنند.

   

6. روی ذخیره کلیک کنید. SDK URL ظرف سرور به روز شده را بازیابی می کند و داده های اندازه گیری را به آن هدایت می کند.

محدودیت های شناخته شده

• برای برنامه های اندروید:

  • برای جلوگیری از آسیب‌پذیری‌های امنیتی بالقوه مربوط به کانتینرهای سرور و سرویس‌های Google Play، رویدادها از طریق یک سرور پراکسی بدون حالت بین SDK و ظرف سرور شما انجام می‌شوند. این پراکسی منبع و نقطه پایانی درخواست را تأیید می‌کند، اما هیچ داده‌ای درباره رویدادها بازرسی یا ذخیره نمی‌کند. مطابق با نحوه جمع‌آوری داده‌های GA4 از دستگاه‌های مبتنی بر اتحادیه اروپا ، پروکسی برای ترافیک مبتنی بر اتحادیه اروپا در اتحادیه اروپا خواهد بود.
  • خریدهای درون‌برنامه‌ای که به‌طور خودکار وارد سیستم می‌شوند به یکپارچه‌سازی با Google Play متکی هستند و به ظرف سرور ارسال نمی‌شوند.
  • رویداد app_remove در Android گزارش نخواهد شد.

• برای اطمینان از اینکه داده‌های SDK و تبدیل‌های شما به Google Ads وارد می‌شوند، اتصال جریان‌های داده برنامه در Google Analytics به حساب Google Ads شما همچنان ضروری است. برچسب‌گذاری سمت سرور هیچ ادغام ذاتی را بین SDK و تبلیغات Google ارائه نمی‌کند.

API

می توانید از Tag Manager REST API برای دسترسی به داده های پیکربندی Tag Manager استفاده کنید. برای اطلاعات بیشتر در مورد API:

• برای یادگیری نحوه کار با API، به راهنمای توسعه دهنده مراجعه کنید.
• مرجع Tag Manager API را مرور کنید تا با منابع Tag Manager و عملیات موجود آشنا شوید.