# Интеграция с Google Analytics

<Aside type="caution" icon="setting" title="Требуется помощь разработчика">
 Вам потребуется помощь команды разработчиков для настройки интеграции. Пожалуйста, поделитесь с ними этим руководством.
</Aside>

Функция [User ID](https://support.google.com/analytics/answer/3123662?authuser=1) в Google Analytics позволяет собирать и применять полные данные о пользователях, связывая несколько источников данных с одними и теми же пользователями.
Подключите Pushwoosh к Google Analytics и используйте данные GA для сегментации аудитории и таргетинга ваших кампаний с push-уведомлениями. Давайте посмотрим, как это работает.

## Включите User ID

Чтобы включить функцию User ID в вашем [аккаунте Google Analytics](https://analytics.google.com/analytics/web/provision/#/provision), следуйте руководству Google: [https://support.google.com/analytics/answer/3123666](https://support.google.com/analytics/answer/3123666)

<Aside type="note">
Не забудьте создать представление отчетов User ID (как описано в _Шаге 3_ руководства GA по включению User ID).
</Aside>

## Настройте User ID в вашем коде отслеживания

<Aside type="note">
 Мы поддерживаем Google Tag Manager

Мы рекомендуем использовать Google Tag Manager (GTM) для интеграции Pushwoosh SDK. Следующий код основан на GTM, но его легко изменить для запуска в виде простого Javascript на странице.
</Aside>

## Интегрируйте Pushwoosh Web SDK

Чтобы интегрировать Pushwoosh SDK в ваш Google Tag Manager, следуйте [руководству по Web Push SDK](/ru/developer/pushwoosh-sdk/web-push-notifications/web-push-sdk-30#installing-from-google-tag-manager).

## Создайте тег User ID в GTM

Создайте **Пользовательский тег HTML** (Custom HTML Tag), срабатывающий по триггеру **Все страницы** (All Pages).\
Используйте следующий код для настройки User ID, который будет сопоставлять данные пользователей между Pushwoosh и Google Analytics.

В приведенном ниже примере мы используем Pushwoosh Hardware ID (HWID) для настройки User ID. Вы можете использовать другой идентификатор, но имейте в виду, что нельзя указывать адреса электронной почты или любую другую личную информацию (PII) в User ID, так как это не соответствует [Политике конфиденциальности Google Analytics](https://policies.google.com/privacy).

```javascript title="JavaScript"
<script>
  var registrationStatus = localStorage.deviceRegistrationStatus;
  var registrationId = localStorage.deviceRegistrationId;
  var gaRegistered = registrationStatus === 'registered' ? registrationId : false;

  if (!gaRegistered) {
    var Pushwoosh = Pushwoosh || [];
    Pushwoosh.push(['onPermissionGranted', function(api) {
      api.getParams()
        .then(function(params) {
          var hwid = params.hwid;
          ga('set', 'userId', hwid);
          ga('send', 'pageview');
          localStorage.setItem('deviceRegistrationId', hwid);
          api.registerUser(hwid);
        })
    }])
};
</script>
```

<img src="/integrations-google-analytics-integration-1.webp" alt="Пользовательский тег HTML в Google Tag Manager для настройки User ID"/>

## Добавьте User ID в тег Page View

Измените ваш **тег Page View**, чтобы он включал User ID, если он известен для пользователя:

```javascript title="JavaScript"
<script>
  var hwid = localStorage.deviceRegistrationId;
  var registrationStatus = localStorage.deviceRegistrationStatus;
  var isNeedToTrackUser = hwid && registrationStatus === "registered";

  if (isNeedToTrackUser) {
    ga('set', 'userId', hwid);
  };
  ga('send', 'pageview');
</script>
```

<img src="/integrations-google-analytics-integration-2.webp" alt="Конфигурация тега Page View с User ID"/>

## Протестируйте с помощью отчета о покрытии User ID

Чтобы протестировать интеграцию, используйте "Отчет о покрытии User ID":\
[https://support.google.com/analytics/answer/3123670](https://support.google.com/analytics/answer/3123670)

<Aside type="note">
Обратите внимание, что обработка данных в GA занимает около суток.
</Aside>

## Статистика по пользователям

Выберите представление отчетов User ID в Google Analytics. Добавьте любые сегменты, чтобы анализировать вашу аудиторию.

<img src="/integrations-google-analytics-integration-3.webp" alt="Кнопка 'Новый сегмент' для разделения аудитории на сегменты"/>

Вы увидите ваши User ID в столбце "User ID". Нажмите кнопку **Экспорт** и выберите опцию CSV, чтобы загрузить список User ID.

<img src="/integrations-google-analytics-integration-4.webp" alt="Столбец User ID, отображающий идентификаторы пользователей"/>

## Отправка push-уведомлений по User ID из GA

Чтобы отправить push-уведомление пользователям из вашей аудитории GA, используйте [разовую отправку push-уведомлений](/ru/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/) и на шаге **Аудитория** выберите **Импортировать сегмент**. Загрузите CSV-файл, который вы экспортировали из Google Analytics, и сопоставьте столбец, содержащий User ID, с полем User ID. [Узнать больше](/ru/product/audience-data-and-segmentation/segmentation/create-segments/by-import/#how-to-import-a-segment)