‫Google Tag Manager ویژه Android

به‌عنوان توسعه‌دهنده، می‌توانید از «مدیر برچسب Google» برای پیاده‌سازی و مدیریت برچسب‌های سنجش و پیکسل‌ها در برنامه‌های تلفن همراهتان استفاده کنید، بدون اینکه لازم باشد دودویی‌های برنامه را بازسازی کنید و دوباره به بازارهای برنامه ارسال کنید. توسعه‌دهندگانی که با Google Analytics برای کیت توسعه نرم‌افزار Firebase کار می‌کنند، می‌توانند به‌راحتی Tag Manager را اضافه کنند تا به مدیریت و ایجاد تغییرات در پیاده‌سازی کمک کنند، حتی پس‌از اینکه برنامه ارسال شده باشد.

توسعه‌دهندگان می‌توانند رویدادهای مهم را ثبت کنند و بعداً تصمیم بگیرند که کدام برچسب‌ها یا پیکسل‌ها باید فعال شوند.

پیش‌نیازها

قبل‌از شروع:

بخش‌های زیر شما را در مراحل پیکربندی و استفاده از Google Tag Manager در برنامه Android راهنمایی می‌کند.

۱. افزودن Google Tag Manager به پروژه

  1. در فایل Gradle واحدتان (معمولاً app/build.gradle)، وابستگی زیر را به کتابخانه Tag Manager اضافه کنید:

    dependencies {
  // ...
  compile 'com.google.android.gms:play-services-tagmanager:18.3.0'
}

  2. به سیستم حساب مدیر برچسب خود وارد شوید.

  3. محفظه تلفن همراه را انتخاب کنید.

  4. روی نسخه‌ها در نوار پیمایش بالا کلیک کنید.

  5. روی نسخه محفظه‌ای که می‌خواهید استفاده کنید کلیک کنید.

  6. روی بارگیری کلیک کنید.

  7. اگر پوشه app/src/main/assets/containers وجود ندارد، آن را ایجاد کنید. محفظه بارگیری‌شده را در پوشه کپی کنید.

۲. ثبت رویدادها و متغیرها

Tag Manager از رویدادها، پارامترها، و ویژگی‌های کاربر ثبت‌شده توسط Google Analytics برای Firebase SDK برای راه‌اندازی و ساخت برچسب‌هایی که در Google Tag Manager پیکربندی کرده‌اید استفاده می‌کند.

برای دریافت دستورالعمل‌های مربوط به نحوه ثبت رویدادها و تنظیم ویژگی‌های کاربر، اسناد توسعه‌دهنده Firebase را بخوانید.

پیکربندی متغیرها در Tag Manager

برای ضبط مقدار پارامترهای رویداد و ویژگی‌های کاربر برای استفاده در Google Tag Manager، می‌توانید متغیرها را در واسط Tag Manager پیکربندی کنید.

برای مثال، می‌توانید رویداد سفارشی زیر را در برنامه‌تان ثبت کنید:

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

سپس می‌توانید متغیرهای جدید «پارامتر رویداد» را در «مدیر برچسب» به‌صورت زیر پیکربندی کنید تا مقادیر image_name و full_text parameter را ضبط کنید:

  • نام متغیر: نام تصویر
  • نوع متغیر: پارامتر رویداد
  • نام کلید پارامتر رویداد: image_name

و:

  • نام متغیر: نوشتار کامل
  • نوع متغیر: پارامتر رویداد
  • نام کلید پارامتر رویداد: full_text

به‌طور مشابه، می‌توانید مشخصه کاربر زیر را در برنامه‌تان تنظیم کنید:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

سپس، می‌توانید متغیر جدید «دارایی کاربر Firebase» را در Google Tag Manager پیکربندی کنید تا مقدار favorite_food را ضبط کنید:

  • نام متغیر: غذای موردعلاقه
  • نوع متغیر: ویژگی کاربر Firebase
  • نام کلید پارامتر رویداد: favorite_food

تغییر و مسدود کردن رویدادها

«مدیر برچسب» به شما امکان می‌دهد رویدادها را قبل‌از اینکه توسط Google Analytics برای کیت توسعه نرم‌افزار Firebase ثبت شوند، اصلاح و مسدود کنید. اصلاح رویدادها می‌تواند به شما کمک کند تا مقادیر پارامترهای رویداد را اضافه، حذف، یا تغییر دهید یا نام رویدادها را بدون به‌روزرسانی برنامه تنظیم کنید. رویدادهایی که مسدود نشده‌اند توسط Google Analytics برای Firebase SDK ثبت خواهند شد.

‫Google Analytics برای کیت توسعه نرم‌افزار Firebase همچنین به‌طور خودکار برخی رویدادها و ویژگی‌های کاربر را ثبت می‌کند. می‌توانید از رویدادها و ویژگی‌های خودکار ثبت‌شده در «مدیر برچسب» بدون نیاز به افزودن کد استفاده کنید. اما نمی‌توانید او را مسدود کنید.

۳. ارسال رویدادها

متغیرهای نام رویداد Firebase، متغیرهای پارامتر رویداد Firebase، و دیگر متغیرها برای راه‌اندازی راه‌اندازها استفاده می‌شوند. شرایط راه‌انداز هر زمان که رویداد Firebase را ثبت کنید ارزیابی می‌شود. به‌طور پیش‌فرض، رویدادهای «Google Analytics برای Firebase» به‌طور خودکار فعال می‌شوند. می‌توانید برچسب «Google Analytics برای Firebase» را در «مدیر برچسب» اضافه کنید تا از ارسال رویدادها به Google Analytics جلوگیری کنید.

۴. پیش‌دید، اشکال‌زدایی، و انتشار محتوا

قبل‌از انتشار نسخه‌ای از محفظه، بهتر است آن را پیش‌نمایش کنید تا مطمئن شوید همان‌طور که می‌خواهید کار می‌کند. Google Tag Manager به شما امکان می‌دهد با تولید پیوند و رمزینه پاسخ‌سریع در میانای وب و استفاده از آن‌ها برای باز کردن برنامه، نسخه‌های محتوی را پیش‌نمایش کنید. همچنین می‌توانید حالت گزارش‌گیری مفصل را فعال کنید تا هرگونه رفتار غیرمنتظره را اشکال‌زدایی کنید.

محتوی پیش‌نمایش

قبل‌از پیش‌دیدن محتوی، با انتخاب نسخه محتوی‌ای که می‌خواهید پیش‌دید کنید و سپس انتخاب پیش‌دید، نشانی وب پیش‌دید را در میانای وب Google Tag Manager تولید کنید. این نشانی وب پیش‌نمایش را برای مراحل بعدی ذخیره کنید.

نشانی‌های وب پیش‌نمایش در پنجره پیش‌نمایش میانای وب Tag Manager دردسترس است
شکل ۱: دریافت نشانی وب پیش‌نمایش از میانای وب «مدیر برچسب».

برای پیش‌دید محفظه (اگر از «استودیو Android» استفاده می‌کنید، به مرحله ۳ بروید):

  1. این فعالیت پیش‌نمایش را به فایل AndroidManifest خود اضافه کنید:

    <!--  Add preview activity. -->
<activity
  android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
  android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. -->
  <intent-filter>
    <data android:scheme="tagmanager.c.com.example.app" />
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE"/>
  </intent-filter>
</activity>

  2. این خط را تغییر دهید تا نام بسته برنامه‌تان را دربرگیرد:

    <data android:scheme="tagmanager.c.com.example.app"/>

  3. در میانای وب Google Tag Manager، پیوند پیش‌نمایش ایجاد کنید:

    1. به سیستم حساب مدیر برچسب خود وارد شوید.
    2. محفظه تلفن همراه را انتخاب کنید.
    3. روی نسخه‌ها در نوار پیمایش بالا کلیک کنید.
    4. روی کنش‌ها > پیش‌نمایش در نسخه محفظه‌ای که می‌خواهید پیش‌نمایش کنید کلیک کنید.
    5. نام بسته برنامه‌تان را وارد کنید.
    6. روی تولید پیوند شروع پیش‌نمایش کلیک کنید.

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

  5. می‌توانید با کلیک کردن روی پیوند ایجادشده توسط گزینه ایجاد پیوند پایان پیش‌نمایش در میانای وب، از حالت پیش‌نمایش خارج شوید.

اشکال‌زدایی محتوی

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

انتشار محتوا

پس‌از پیش‌دید کردن محفظه و تأیید اینکه کار می‌کند، می‌توانید آن را منتشر کنید. پس‌از انتشار محفظه، پیکربندی‌های برچسب شما برای کاربران برنامه تلفن همراه دردسترس قرار می‌گیرد.

مراحل بعدی

پیکربندی پیشرفته را بخوانید.