گوگل تگ منیجر برای اندروید

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

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

پیش‌نیازها

قبل از شروع:

• در کنسول Firebase ، برنامه خود را به پروژه Firebase خود اضافه کنید.
• گوگل آنالیتیکس را برای برنامه خود تنظیم کنید ، از جمله فعال کردن گوگل آنالیتیکس در پروژه Firebase و اضافه کردن Google Analytics for Firebase SDK به برنامه خود.
• یک حساب کاربری مدیریت تگ ایجاد کنید .
• یک کانتینر گوگل تگ منیجر پیکربندی کنید .

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

۱. گوگل تگ منیجر را به پروژه خود اضافه کنید

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 وجود ندارد، آن را ایجاد کنید. فایل کانتینر دانلود شده را در آن کپی کنید.

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

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

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

پیکربندی متغیرها در تگ منیجر

برای ثبت مقدار پارامترهای رویداد و ویژگی‌های کاربر جهت استفاده در گوگل تگ منیجر، می‌توانید متغیرها را در رابط تگ منیجر پیکربندی کنید .

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

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 User Property در Google Tag Manager پیکربندی کنید تا مقدار favorite_food را ثبت کند:

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

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

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

کیت توسعه نرم‌افزار گوگل آنالیتیکس برای فایربیس (Google Analytics for Firebase SDK) همچنین به طور خودکار برخی از رویدادها و ویژگی‌های کاربر را ثبت می‌کند. می‌توانید بدون نیاز به اضافه کردن هیچ کدی، از رویدادها و ویژگی‌های جمع‌آوری‌شده خودکار در تگ منیجر استفاده کنید. با این حال، نمی‌توانید آنها را مسدود کنید.

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

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

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

قبل از انتشار نسخه‌ای از کانتینر خود، باید پیش‌نمایشی از آن را مشاهده کنید تا مطمئن شوید که طبق انتظار کار می‌کند. گوگل تگ منیجر با ایجاد لینک‌ها و کدهای QR در رابط وب و استفاده از آنها برای باز کردن برنامه، امکان پیش‌نمایش نسخه‌های کانتینر شما را فراهم می‌کند. همچنین می‌توانید حالت ثبت وقایع (logging) را برای اشکال‌زدایی هرگونه رفتار غیرمنتظره فعال کنید .

پیش‌نمایش کانتینر

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

شکل ۱: دریافت پیش‌نمایش URL از رابط وب Tag Manager.

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

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. در رابط وب گوگل تگ منیجر، یک لینک پیش‌نمایش ایجاد کنید:

   1. وارد حساب کاربری تگ منیجر خود شوید.
   2. یک کانتینر سیار انتخاب کنید.
   3. در نوار ناوبری بالا روی نسخه‌ها کلیک کنید.
   4. روی نسخه کانتینری که می‌خواهید پیش‌نمایش آن را ببینید، روی اقدامات > پیش‌نمایش کلیک کنید.
   5. نام بسته برنامه خود را وارد کنید.
   6. برای شروع پیش‌نمایش، روی ایجاد لینک کلیک کنید.

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

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

ظرف اشکال‌زدایی

برای عیب‌یابی پیاده‌سازی کانتینر، قابلیت Verbose logging را فعال کنید:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

انتشار کانتینر

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

نکته: برای کانتینرهای موبایل، از یک کانتینر پیش‌فرض برای تنظیم پیکربندی‌های اولیه تگ تا اولین باری که یک کانتینر دانلود می‌شود، استفاده می‌شود. پس از اتصال برنامه به اینترنت و دانلود یک کانتینر، دیگر هرگز از کانتینر پیش‌فرض استفاده نخواهد کرد. برنامه‌ها به صورت دوره‌ای، معمولاً هر ۱۲ ساعت یکبار، به‌روزرسانی‌های کانتینر را بررسی می‌کنند.

مراحل بعدی

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