Менеджер тегов и Firebase: начало работы

Введение

Разработчики могут использовать Google Менеджер тегов, чтобы реализовать в своих мобильных приложениях теги и пиксели отслеживания, а также управлять ими без необходимости переделывать или повторно отправлять в магазины исполняемые файлы. Если вы работаете с Firebase Analytics, с помощью Менеджера вам будет удобнее управлять тегами до и после скачивания приложения конечным пользователем.

Разработчики могут заносить в журналы важные события, чтобы позже решить, какие теги или пиксели отслеживания должны активироваться. В настоящее время Менеджер поддерживает теги для следующих продуктов:

  • Firebase Analytics;
  • Google Аналитика;
  • Floodlight;
  • Google Реклама;
  • adjust;
  • AppsFlyer;
  • Apsalar;
  • Kochava;
  • Tune;
  • вызовы собственных функций (для других продуктов).

Требования

Перед началом работы выполните следующие действия:

В следующем разделе приводится пошаговая инструкция по настройке и использованию Google Менеджера тегов с приложением для iOS.

Начало работы

  1. Добавление Менеджера тегов в проект
  2. Регистрация событий и переменных
  3. Активация тегов
  4. Предварительный просмотр, отладка и публикация контейнера

1. Добавление Менеджера тегов в проект

  1. Добавьте интеграцию CocoaPods Менеджера тегов в свой проект:
    1. Чтобы установить CocoaPods, выполните в терминале указанную ниже команду.
      $ sudo gem install cocoapods
      
    2. Перейдите в каталог проекта.
    3. Чтобы создать файл с названием Podfile, выполните следующую команду:
      $ pod init
      
    4. Добавьте в Podfile следующую строку:
      pod 'GoogleTagManager', '~> 6.0'
      
    5. Чтобы скачать и добавить в проект зависимости Менеджера тегов, выполните следующую команду:
      $ pod install
      
  2. Если в вашем аккаунте Google Менеджера тегов нет контейнера iOS, создайте его:
    1. Войдите в аккаунт Google Менеджера тегов.
    2. Выберите АДМИНИСТРИРОВАНИЕ в верхней части панели навигации.
    3. В столбце Контейнер нажмите на раскрывающееся меню и выберите Создать контейнер.
    4. Введите название контейнера.
    5. Выберите контейнер iOS.
    6. Выберите версию SDK Firebase (iOS).
    7. Нажмите СОЗДАТЬ.
  3. Скачайте контейнер:
    1. Войдите в аккаунт Google Менеджера тегов.
    2. Выберите контейнер iOS.
    3. Нажмите Версии в верхней части панели навигации.
    4. Выберите для нужной версии контейнера Действия > Скачать.
      Будет скачан файл с идентификатором контейнера в качестве названия и расширением .json.
  4. Добавьте скачанный контейнер в проект:
    1. Скопируйте файл в папку container в корне проекта Xcode (обычно это PROJECT_ROOT/container/GTM-XXXXXX.json).
    2. Откройте Xcode.
    3. В меню File (Файл) выберите Add files to (Добавить файлы в).
    4. Выберите папку container.
    5. Нажмите Options (Настройки) и убедитесь, что выбрана настройка Create folder references (Создавать ссылки на папки).
    6. Нажмите Finish (Готово).

2. Регистрация событий и переменных

Для формирования и активации тегов, которые вы настроили в Менеджере, используются события, параметры и свойства пользователей из Firebase Analytics. Таким образом, Firebase Analytics выступает в качестве уровня данных.

Инструкции по ведению журналов событий и настройке свойств пользователей приведены в документации для разработчиков Firebase Analytics.

Настройка переменных в Менеджере тегов

Чтобы регистрировать параметры событий и свойства пользователей Firebase для применения в Менеджере тегов, в нем можно настроить переменные.

Допустим, вы регистрируете в своем приложении следующее пользовательское событие:

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

В этом случае вы можете настроить в Менеджере тегов новые переменные параметра события для регистрации значений image_name и full_text parameter:

  • Имя переменной: название изображения.
  • Тип переменной: параметр события.
  • Название ключа параметра события: image_name.

и:

  • Имя переменной: полный текст.
  • Тип переменной: параметр события.
  • Название ключа параметра события: full_text.

Теперь рассмотрим настройку в приложении следующего свойства пользователя:

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

В этом случае можно задать в Менеджере тегов новую переменную свойства пользователя Firebase для регистрации значений favorite_food:

  • Имя переменной: Favorite Food (любимая еда).
  • Тип переменной: Firebase User Property (свойство пользователя Firebase).
  • Название ключа параметра события: favorite_food.

Изменение и блокировка событий Firebase Analytics

Менеджер тегов позволяет изменять и блокировать события до их регистрации в Firebase Analytics. Благодаря этому вы можете добавлять, удалять и редактировать значения параметров событий или корректировать названия событий, не внося изменения в приложение. Незаблокированные события будут учитываться в Firebase Analytics.

Firebase Analytics также автоматически регистрирует некоторые события и свойства пользователей – вам не нужно добавлять для них код. Их можно использовать в Менеджере тегов, но нельзя заблокировать.

3. Активация тегов

Переменные названий и параметров событий Firebase, а также другие переменные используются при настройке триггеров. Условия их активации проверяются каждый раз, когда вы регистрируете событие Firebase. По умолчанию события Firebase Analytics активируются автоматически. В Менеджере тегов можно добавить тег Firebase Analytics, чтобы блокировать отправку событий в Firebase Analytics.

4. Предварительный просмотр, отладка и публикация контейнера

Перед публикацией версии контейнера выполните ее предварительный просмотр и убедитесь, что она работает корректно. В Менеджере тегов есть возможность просматривать версии вашего контейнера, создавая в веб-интерфейсе ссылки и QR-коды для перехода в приложение.

Предварительный просмотр контейнера

Чтобы просмотреть контейнер, создайте URL предварительного просмотра в веб-интерфейсе Google Менеджера тегов:

  1. Войдите в аккаунт Менеджера тегов.
  2. Выберите мобильный контейнер.
  3. Нажмите Версии в верхней части панели навигации.
  4. Выберите для нужной версии контейнера Действия > Предварительный просмотр.
  5. Введите название пакета приложения.
  6. Нажмите Создать ссылку для начала просмотра.

    URL предварительного просмотра доступны в соответствующем окне в веб-интерфейсе Менеджера тегов.

    Рисунок 1. Как получить URL предварительного просмотра в веб-интерфейсе Менеджера тегов

    Сохраните этот URL для последующих этапов.

Чтобы включить предварительный просмотр контейнеров, необходимо задать схему URL предварительного просмотра в списке ресурсов проекта. Для этого в файле со списком ресурсов приложения в разделе Типы URL зарегистрируйте указанные ниже идентификатор и схему URL:

URL identifier: your.package.name
URL scheme: tagmanager.c.your.package.name
Зарегистрируйте схему URL предварительного просмотра в списке ресурсов приложения
Рисунок 2. Добавление схемы URL предварительного просмотра в список ресурсов приложения

Остановите приложение и откройте URL предварительного просмотра на отдельном устройстве или в эмуляторе, чтобы увидеть проект контейнера в приложении.

Отладка контейнера

После запуска приложения в эмуляторе или режиме предварительного просмотра в Менеджере тегов будет включено ведение подробного журнала.

Публикация контейнера

Просмотрев контейнер и убедившись, что он работает правильно, опубликуйте его. После этого ваши конфигурации тегов станут доступными для пользователей мобильного приложения.

Статьи по теме

Расширенная конфигурация