Маркировка на стороне сервера для мобильных приложений

Вы можете настроить свои мобильные приложения с помощью SDK Google Analytics for Firebase для работы с серверной разметкой в ​​Google Tag Manager.

Серверная разметка позволяет подготавливать, редактировать и дополнять данные перед отправкой в ​​целевые продукты, такие как Google Analytics. Узнайте больше о серверной разметке .

Для настройки серверной разметки для мобильных приложений:

1. Подготовьте ваше приложение к серверной разметке тегов.
2. Настройте контейнер сервера для поддержки мобильного трафика.
3. Включите серверную разметку тегов в вашем свойстве GA4.

Предварительные требования

• Вам необходимо добавить SDK Google Analytics для Firebase в ваше приложение и связать его с вашим ресурсом Google Analytics 4. Подробнее о SDK Google Analytics для Firebase можно узнать здесь.
• Вам потребуется учетная запись Google Tag Manager и серверный контейнер. Если у вас их нет, создайте новую учетную запись Tag Manager и контейнер .
• Вам необходимо настроить сервер тегирования .

Шаг 1: Подготовьте ваше приложение к серверной разметке тегов.

iOS

1. Включите функцию загрузки тегов на стороне сервера и настройте пользовательскую схему URL-адресов для режима отладки тегирования на стороне сервера в файле Info.plist . Замените BUNDLE_ID в следующем коде на идентификатор пакета приложения.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. Чтобы включить режим отладки или предварительного просмотра, добавьте вызов метода Analytics.handleOpen(_:) в метод жизненного цикла, чтобы передать URL-адрес запуска.

   SwiftUI

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   Для приложений, не использующих SwiftUI или UIScene, никаких действий не требуется. SDK получает URL-адрес запуска из ApplicationDidFinishLaunchingNotification .

Android

1. Установите последнюю версию SDK Google Analytics для Firebase.

2. Чтобы включить sGTM, добавьте следующее в файл AndroidManifest.xml вашего приложения.

   <!-- Preview Activity to enable preview mode –->
     <activity
         android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
         android:exported="true"
         android:noHistory="true" >
       <intent-filter>
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
       </intent-filter>
     </activity>
   
   <!-- Meta-data that enables uploads to sGTM –->
     <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

   Примечание: <APP_PACKAGE_ID> должен состоять из строчных букв. В отличие от RFC, сопоставление схем в фреймворке Android чувствительно к регистру.

Шаг 2: Настройте контейнер сервера для поддержки мобильного трафика.

В следующем разделе предполагается, что у вас уже развернута система серверной тегировки и вы знакомы с ее концепциями. Если вы новичок в серверной тегировке, вы можете пройти курс «Основы серверной тегировки» .

Настройте клиент Google Analytics: GA4 (приложение).

Клиент — это тип ресурса Tag Manager, который перехватывает определенные типы входящих запросов и генерирует события, которые могут быть переданы в целевую систему, например, Google Analytics 4. В данном случае HTTP-запрос является событием Google Analytics 4, поэтому вам необходимо настроить встроенный клиент Google Analytics: GA4 (приложение). Для каждого источника данных, такого как GA SDK и веб-сайт, достаточно одного клиента GA4. Подробнее о том, как работают клиенты , можно узнать здесь.

1. В контейнере вашего сервера перейдите в раздел «Клиенты» и нажмите «Создать» .

2. Нажмите «Конфигурация клиента» , затем выберите Google Analytics: GA4 (приложение) .

   

3. Введите имя для вашего клиента и нажмите «Сохранить» .

Настройте тег Google Analytics: GA4

Для отправки данных в Google Analytics необходимо создать тег Google Analytics: GA4 в контейнере сервера. Клиент анализирует входящий HTTP-запрос и преобразует его в объект данных события. Тег берет этот объект данных события, сопоставляет его с правильным форматом, а затем отправляет в Google Analytics 4.

1. В контейнере вашего сервера перейдите в раздел «Теги» и нажмите «Создать» .

2. Нажмите «Настройка тегов» , затем выберите Google Analytics: GA4 .

   

По умолчанию тег наследует все соответствующие поля и параметры из объекта данных события, созданного клиентом:

• Если входящий запрос Google Analytics 4 проходит через клиент Google Analytics: GA4 (приложение) , тег наследует идентификатор приложения и параметры события.
• Если входящие запросы Google Analytics 4 проходят через клиент Google Analytics: GA4 (Web) , тег наследует идентификатор измерения и параметры события.

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

Настройте триггеры для мобильного трафика.

Затем следует определить, когда должен срабатывать тег GA4. Клиент Google Analytics: GA4 (приложение) преобразует входящий запрос в объект данных события, и тег наследует его значения. Поэтому обычно требуется, чтобы тег срабатывал всякий раз, когда клиент GA4 обрабатывает запрос.

Для настройки триггеров:

1. В настройках тега нажмите «Запуск» .
2. Чтобы создать новый триггер, нажмите значок «+» в правом верхнем углу.
3. Нажмите «Конфигурация триггера» , чтобы выбрать тип триггера.

4. Выберите «Пользовательский» или «Пользовательское событие» из списка.

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

5. Чтобы включить список условий активации для этого триггера, например, чтобы он срабатывал только при событиях на мобильных устройствах или в веб-браузере, выберите «Некоторые события» .

   1. Вы увидите предварительно выбранное «Имя события» . Щелкните по этому селектору и выберите «Выбрать встроенную переменную» из списка.
   2. Чтобы автоматически отобразить имя клиента, создавшего событие, выберите «Имя клиента» .

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

      

      Примечание: Имя клиента — это то, что вы указали на предыдущем шаге. Тип клиента — Google Analytics: GA4 (приложение). Переменная «Имя клиента» возвращает имя, а не тип клиента.

6. Сохраните триггер и введите описательное имя. Например, можно использовать "Все события приложения GA4".

7. Теперь вы должны вернуться к настройкам тега, и новый триггер будет на своем месте. Сохраните тег и введите описательное имя, например, "GA4". Ваш тег должен выглядеть так:

   

Совет: Чтобы исключить отправку определенных событий, вы можете использовать пользовательские триггеры с условной логикой, основанной на имени события (или другой переменной), или добавить исключения для триггеров. Подробнее о запуске триггеров и исключениях для триггеров см . здесь.

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

Вы можете использовать Google Tag Manager для предварительного просмотра и отладки контейнера сервера перед публикацией изменений. Обратите внимание, что предварительный просмотр не будет работать, пока вы не включите серверную разметку тегов в своем ресурсе GA4 .

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

1. В контейнере сервера Google Tag Manager выберите пункт «Предварительный просмотр» .
2. Нажмите на значок «Дополнительные действия» ⋮ в правом верхнем углу и выберите «Отправлять запросы из приложения» .

3. Введите идентификатор вашего приложения и нажмите «Сгенерировать QR-код» .

   Примечание: Идентификатор приложения должен начинаться с буквы. В качестве альтернативы вы можете использовать любой уникальный идентификатор, начинающийся с буквы, при условии, что он совпадает с идентификатором, указанным в файле Info.plist или AndroidManifest.xml .

   

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

5. Нажмите ОК , чтобы закрыть диалоговое окно.

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

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

Шаг 3: Включите серверную разметку тегов в вашем свойстве GA4.

1. В настройках вашего ресурса Google Analytics 4 перейдите в раздел «Администрирование» .
2. Потоки открытых данных .

3. Выберите конфигурацию потоковой передачи вашего приложения на вкладке iOS или Android.

   

4. Нажмите «Настроить параметры SDK» , затем «Настроить менеджер тегов на стороне сервера» .

   

5. Чтобы разрешить SDK отправлять данные измерений на URL-адрес контейнера сервера:

   1. Включите опцию «Отправлять данные в контейнер Tag Manager на стороне сервера» .
   2. Скопируйте URL-адрес контейнера сервера. Вы можете найти его в Google Tag Manager, перейдя в раздел Администрирование > Настройки контейнеров > URL-адреса контейнеров сервера .

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

      Примечание: Используйте параметр «Только устройства отладки», чтобы разрешить отправку данных на ваш сервер только приложениям, открытым в режиме предварительного просмотра .

   

6. Нажмите «Сохранить» . SDK получит обновленный URL-адрес контейнера сервера и направит на него данные измерений.

Известные ограничения

• Для приложений Android:

  • Автоматически регистрируемые внутриигровые покупки основаны на интеграции с бэкэндом Google Play и не будут отправляться на серверный контейнер.
  • Событие app_remove не будет отображаться на Android.

• Подключение потоков данных вашего приложения в Google Analytics к вашему аккаунту Google Ads по-прежнему необходимо для обеспечения импорта данных SDK и конверсий в Google Ads. Серверная разметка тегов не обеспечивает никакой встроенной интеграции между вашим SDK и Google Ads.

Примечание: SDK Google Analytics для Firebase разработан и оптимизирован для отправки данных в Google Analytics 4. Затем Google Analytics 4 можно связать с Google Ads для составления отчетов о конверсиях, создания аудиторий, оптимизации кампаний и моделирования. Это включает в себя серверную разметку для приложений, и мы рекомендуем клиентам воспользоваться интеграцией между Google Analytics и серверной разметкой в ​​Google Tag Manager.

API

Для доступа к данным конфигурации Tag Manager можно использовать REST API. Более подробную информацию об API можно найти здесь:

• Для получения информации о работе с API обратитесь к Руководству разработчика .
• Ознакомьтесь со справочником API Tag Manager , чтобы изучить ресурсы Tag Manager и доступные операции.