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

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

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

پیش نیازها

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

1. Tag Manager را به پروژه خود اضافه کنید

  1. بسته تگ منیجر را اضافه کنید:

    CocoaPods

    برای اضافه کردن Tag Manager از طریق CocoaPods :

    1. در ترمینال دستور زیر را اجرا کنید:

      $ sudo gem install cocoapods
      
    2. به دایرکتوری پروژه خود تغییر دهید.

    3. برای ایجاد فایلی به نام Podfile دستور زیر را اجرا کنید:

      $ pod init
      
    4. در Podfile موارد زیر را اضافه کنید:

      pod 'GoogleTagManager', '~> 6.0'
      
    5. دستور زیر را برای دانلود و نصب وابستگی های Tag Manager در پروژه خود اجرا کنید:

      $ pod install
      

    مدیر بسته سوئیفت

    برای افزودن Tag Manager از طریق مدیریت بسته Swift :

    1. اگر از یک پروژه مبتنی بر CocoaPods مهاجرت می کنید، pod deintegrate اجرا کنید تا CocoaPods را از پروژه Xcode خود حذف کنید. فایل .xcworkspace ایجاد شده توسط CocoaPods را می توان با خیال راحت حذف کرد. اگر برای اولین بار است که Firebase را به پروژه ای اضافه می کنید، این مرحله می تواند نادیده گرفته شود.
    2. در Xcode 12، با رفتن به File > Tag Manager Packages > Add Package Dependency، کتابخانه Tag Manager را نصب کنید.
    3. در اعلانی که ظاهر می شود، مخزن Tag Manager GitHub را وارد کنید:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      
    4. نسخه ای از Tag Manager را که می خواهید استفاده کنید انتخاب کنید. برای پروژه های جدید، توصیه می کنیم از آخرین نسخه Tag Manager استفاده کنید.

    5. -ObjC به سایر پرچم‌های لینکر در تنظیمات ساخت پروژه خود اضافه کنید.

  2. اگر اکانت Tag Manager شما فاقد آن است، یک محفظه iOS ایجاد کنید:

    1. وارد حساب Tag Manager خود شوید.
    2. در تب Accounts ، ظرف iOS خود را انتخاب کنید.
    3. روی Admin در نوار پیمایش بالا کلیک کنید.
    4. در ستون CONTAINER ، روی نماد '+' کلیک کنید تا یک ظرف ایجاد کنید.
    5. نام ظرف را وارد کنید.
    6. ظرف iOS را انتخاب کنید.
    7. روی ایجاد کلیک کنید.
  3. ظرف خود را دانلود کنید:

    1. وارد حساب Tag Manager خود شوید.
    2. در تب Accounts ، ظرف iOS خود را انتخاب کنید.
    3. روی Versions در نوار پیمایش بالا کلیک کنید.
    4. نسخه کانتینری را که می خواهید دانلود کنید انتخاب کنید.
    5. روی دانلود کلیک کنید.

  4. کانتینر دانلود شده را به پروژه خود اضافه کنید:

    1. فایل دانلود شده را در پوشه ای به نام container در ریشه پروژه XCode (معمولا PROJECT_ROOT/container/GTM-XXXXXX.json ) کپی کنید.
    2. Xcode را باز کنید.
    3. از منوی File گزینه Add files to...
    4. پوشه container را انتخاب کنید.
    5. روی گزینه ها کلیک کنید و مطمئن شوید که Create folder references انتخاب شده است.
    6. روی Finish کلیک کنید.

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

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

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

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

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

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

Analytics.logEvent("share_image", parameters: [
  "image_name": name,
  "full_text": text
])

سپس، می توانید متغیرهای پارامتر رویداد جدید را در Tag Manager به صورت زیر پیکربندی کنید تا مقادیر پارامتر image_name و full_text parameter را ثبت کنید:

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

و:

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

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

Analytics.setUserProperty(food, forName: "favorite_food")

سپس، می‌توانید یک متغیر Firebase User Property را در Google Tag Manager پیکربندی کنید تا مقدار favorite_food را بگیرد:

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

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

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

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

3. رویدادها را ارسال کنید

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

4. کانتینر خود را پیش نمایش، اشکال زدایی و منتشر کنید

قبل از انتشار نسخه‌ای از کانتینر خود، می‌خواهید پیش‌نمایش آن را مشاهده کنید تا مطمئن شوید که طبق برنامه کار می‌کند. Tag Manager به شما امکان می‌دهد با ایجاد پیوندها و کدهای QR در رابط وب Tag Manager و استفاده از آنها برای باز کردن برنامه خود، نسخه‌های ظرف خود را پیش‌نمایش کنید.

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

برای پیش نمایش یک کانتینر، یک URL پیش نمایش در رابط وب Tag Manager ایجاد کنید:

  1. وارد حساب Tag Manager خود شوید.
  2. یک ظرف سیار انتخاب کنید.
  3. روی Versions در نوار پیمایش بالا کلیک کنید.
  4. روی Actions > Preview در نسخه کانتینری که می‌خواهید پیش‌نمایش کنید، کلیک کنید.
  5. نام بسته برنامه خود را وارد کنید.
  6. روی ایجاد پیوند پیش‌نمایش شروع شروع کنید .

    URL های پیش نمایش در پنجره پیش نمایش رابط وب Tag Manager در دسترس هستند

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

    این URL پیش نمایش را برای مراحل بعدی ذخیره کنید.

برای فعال کردن پیش‌نمایش کانتینر، باید طرح URL پیش‌نمایش Tag Manager را در لیست دارایی پروژه خود تعریف کنید. در زیر انواع URL فایل لیست دارایی برنامه خود، شناسه URL و طرح URL زیر را ثبت کنید:

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
طرح URL پیش نمایش مدیر برچسب را در فایل لیست دارایی برنامه خود ثبت کنید.
شکل 2: طرح URL پیش نمایش Tag Manager را به فایل لیست دارایی برنامه خود اضافه کنید.

برنامه خود را متوقف کنید و URL پیش نمایش را در یک شبیه ساز یا دستگاه فیزیکی باز کنید تا پیش نویس محفظه را در برنامه خود مشاهده کنید.

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

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

کانتینر را منتشر کنید

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

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