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

Введение

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

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

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

Требования

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

Установите Firebase SDK.
Добавьте приложение в проект Firebase в Firebase Console.
Добавьте в приложение Firebase Analytics.
Создайте аккаунт Google Менеджера тегов.
Настройте контейнер Менеджера тегов.

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

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

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

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

В файл GRADLE на уровне модуля (обычно app/build.gradle) добавьте следующие две зависимости для библиотеки Менеджера тегов:
```
dependencies {
  // ...
  compile 'com.google.android.gms:play-services-tagmanager:11.0.4'
}
```
Войдите в аккаунт Менеджера тегов.
Выберите мобильный контейнер.
Перейдите в раздел Версии (на панели навигации вверху).
Выберите для нужной версии контейнера Действия > Скачать.
Создайте папку app/src/main/assets/containers, если вы не сделали этого ранее. Скопируйте скачанный контейнер в папку.

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

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

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

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

Чтобы регистрировать параметры событий и свойства пользователей 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 для регистрации значения 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 в веб-интерфейсе Менеджера тегов. Для этого выберите интересующую вас версию и нажмите Предварительный просмотр. Сохраните этот URL для последующих этапов.

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

Как просмотреть контейнер (если вы используете Android Studio, начните сразу с этапа 3)

Добавьте в файл AndroidManifest следующую операцию предварительного просмотра:

<!--  Add preview activity. -->
<activity
  android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
  android:noHistory="true">  <!-- optional, removes the previewActivity from the 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>

Замените в этой строке соответствующий фрагмент на название пакета вашего приложения:
```
<data android:scheme="tagmanager.c.com.example.app"/>
```
Создайте в веб-интерфейсе Менеджера тегов ссылку для предварительного просмотра.
1. Войдите в аккаунт Менеджера тегов.
2. Выберите мобильный контейнер.
3. Перейдите в раздел Версии (на панели навигации вверху).
4. Выберите для нужной версии контейнера Действия > Предварительный просмотр.
5. Введите название пакета вашего приложения.
6. Нажмите Создать ссылку для начала просмотра.
Остановите приложение и запустите его с помощью полученной ссылки или QR-кода.
Чтобы выйти из режима предварительного просмотра, воспользуйтесь функцией Создать ссылку для окончания просмотра в Менеджере тегов и перейдите по созданной ссылке.

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

Чтобы устранить проблемы с реализацией контейнера, включите подробное ведение журнала:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

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

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

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

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