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

Введение

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

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

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

Требования

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

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

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

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

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

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

    скачать контейнер

  6. Создайте папку app/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)

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

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

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

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

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

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

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