Google Менеджер тегов для iOS

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

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

Требования

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

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

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

    CocoaPods

    Чтобы добавить Менеджер тегов с помощью CocoaPods, выполните следующие действия:

    1. В терминале выполните следующую команду:

      $ sudo gem install cocoapods
      
    2. Перейдите в каталог проекта.

    3. Чтобы создать файл с названием Podfile, выполните следующую команду:

      $ pod init
      
    4. В Podfile добавьте следующую строку:

      pod 'GoogleTagManager', '~> 6.0'
      
    5. Чтобы скачать и добавить в проект зависимости Менеджера тегов, выполните следующую команду:

      $ pod install
      

    Swift Package Manager

    Чтобы добавить Менеджер тегов с помощью Swift Package Manager, выполните следующие действия:

    1. Если вы переходите с проекта на основе CocoaPods, запустите pod deintegrate, чтобы удалить CocoaPods из проекта Xcode. После этого вы можете удалить файл .xcworkspace, созданный CocoaPods. Если вы впервые добавляете Firebase в свой проект, пропустите этот шаг.
    2. В Xcode 12 установите библиотеку Менеджера тегов. Для этого выберите File (Файл) > Tag Manager Packages (Пакеты Менеджера тегов) > Add Package Dependency (Добавить зависимость пакетов).
    3. В появившемся окне укажите хранилище Менеджера тегов на GitHub:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      
    4. Выберите нужную версию Менеджера тегов. Для новых проектов рекомендуется использовать последнюю.

    5. В разделе Other Linker Flags (Другие флаги компоновщика) в Build Settings (Настройки сборки) проекта добавьте флаг -ObjC.

  2. Если в вашем аккаунте Менеджера тегов нет контейнера iOS, создайте его:

    1. Войдите в аккаунт Менеджера тегов.
    2. Нажмите Администрирование на панели навигации вверху страницы.
    3. В столбце Контейнер нажмите на раскрывающееся меню и выберите Создать контейнер.
    4. Укажите название контейнера.
    5. Выберите контейнер iOS.
    6. Выберите версию SDK Firebase (iOS).
    7. Нажмите СОЗДАТЬ.
  3. Скачайте контейнер:

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

  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. Нажмите Готово.

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

Для сборки и активации тегов, которые вы настроили в Менеджере тегов, используются события, параметры и свойства пользователей из SDK Google Аналитики для Firebase.

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

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

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

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

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

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

  • Имя переменной: Image Name (название изображения).
  • Тип переменной: Event Parameter (параметр события).
  • Имя ключа параметра события: image_name.

и

  • Имя переменной: Full Text (полный текст).
  • Тип переменной: Event Parameter (параметр события).
  • Имя ключа параметра события: full_text.

Аналогичным образом можно настроить в приложении следующее свойство пользователя:

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

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

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

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

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

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

3. Отправка событий

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

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

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

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

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

  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 предварительного просмотра на отдельном устройстве или в эмуляторе, чтобы увидеть проект контейнера в приложении.

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

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

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

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

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