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

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

Тегирование на стороне сервера позволяет вам обрабатывать, редактировать и дополнять данные перед их отправкой в целевые сервисы, такие как Google Analytics. Подробнее о тегировании на стороне сервера .

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

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

Предпосылки

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

Шаг 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 .

Андроид

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

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

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

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

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

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

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 (App) , тег наследует идентификатор приложения и параметры события.
• Если входящие запросы 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 Менеджер тегов для предварительного просмотра и отладки серверного контейнера перед публикацией изменений. Обратите внимание, что предварительный просмотр не будет работать, пока вы не включите серверные теги в вашем ресурсе GA4 .

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

1. Выберите Предварительный просмотр в контейнере сервера Диспетчера тегов Google.
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. Включите опцию «Отправить данные в контейнер диспетчера тегов на стороне сервера» .
   2. Скопируйте URL-адрес контейнера сервера. Его можно найти в Диспетчере тегов Google, перейдя в раздел «Администрирование» > «Настройки контейнера» > «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 Менеджере тегов.

API

Вы можете использовать REST API Менеджера тегов для доступа к данным конфигурации Менеджера тегов. Подробнее об API:

• Чтобы узнать, как работать с API, обратитесь к Руководству разработчика .
• Ознакомьтесь со справочником API диспетчера тегов , чтобы ознакомиться с ресурсами диспетчера тегов и доступными операциями.