Диспетчер тегов Google для Android

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

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

Предпосылки

Прежде чем начать:

• В консоли Firebase добавьте свое приложение в проект Firebase.
• Настройте Google Analytics для своего приложения, в том числе включите Google Analytics в своем проекте Firebase и добавьте Google Analytics для Firebase SDK в свое приложение.
• Создайте учетную запись диспетчера тегов .
• Настройте контейнер Диспетчера тегов Google .

В следующих разделах описаны шаги по настройке и использованию Диспетчера тегов Google в приложении для Android.

1. Добавьте Диспетчер тегов Google в свой проект

1. В файл Gradle вашего модуля (обычно app/build.gradle ) добавьте следующую зависимость от библиотеки диспетчера тегов:

   dependencies {
     // ...
     compile 'com.google.android.gms:play-services-tagmanager:18.0.2'
   }
   

2. Войдите в свою учетную запись Диспетчера тегов .

3. Выберите мобильный контейнер.

4. Нажмите «Версии» на верхней панели навигации.

5. Щелкните Действия > Загрузить в выбранной версии контейнера.

   

6. Создайте папку app/src/main/assets/containers если она не существует. Скопируйте загруженный контейнер в папку.

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

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

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

Настройте переменные в Диспетчере тегов

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

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

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 в Диспетчере тегов Google для захвата значения favorite_food :

• Имя переменной : Любимая еда
• Тип переменной : свойство пользователя Firebase
• Имя ключа параметра события : favorite_food

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

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

Google Analytics для Firebase SDK также автоматически регистрирует некоторые события и свойства пользователей . Вы можете использовать автоматически собираемые события и свойства в Диспетчере тегов без необходимости добавлять какой-либо код. Однако вы не можете заблокировать их.

3. Отправляйте события

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

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

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

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

Перед предварительным просмотром контейнера сгенерируйте URL-адрес предварительного просмотра в веб-интерфейсе Диспетчера тегов Google, выбрав версию контейнера, которую вы хотите просмотреть, а затем выбрав Предварительный просмотр . Сохраните этот 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 previewActivity from 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. В веб-интерфейсе Диспетчера тегов Google создайте ссылку для предварительного просмотра:

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

4. Остановите приложение и используйте сгенерированную ссылку для предварительного просмотра или QR-код, чтобы запустить приложение.

5. Вы можете выйти из режима предварительного просмотра, щелкнув ссылку, сгенерированную опцией «Создать конечную ссылку предварительного просмотра» в веб-интерфейсе.

Контейнер отладки

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Опубликовать контейнер

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

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

Следующие шаги

Читать Расширенная конфигурация .