[GA4] Как импортировать пользовательские данные

Не загружайте файл с одинаковыми ключами (например, с двумя полями user_id).

Импорт метаданных о пользователях (это может быть коэффициент лояльности, дата последней покупки, общая ценность клиента и так далее) из CRM и других систем дает дополнительные возможности по сегментации пользователей и созданию аудиторий ремаркетинга.

Как работает импорт пользовательских данных

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

Идентификатор потока плюс идентификаторы клиентов (сайт) или экземпляров приложений (приложение), создаваемые Аналитикой.
Ваш уникальный идентификатор пользователя. Это может быть, например, идентификатор из сервиса аутентификации сайта/приложения или из CRM-системы. Эти уникальные идентификаторы необходимо добавлять в код отслеживания и передавать в Аналитику вместе с событиями. В целях защиты конфиденциальности пользователей они хешируются.

В качестве ключа для сопоставления пользователя с загруженными данными Аналитика использует: 1) идентификаторы потока и клиента или экземпляра приложения; или 2) уникальные идентификаторы.

Вы выбираете один из этих методов при импорте данных.

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

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

Как сохранять идентификаторы пользователей в Аналитике

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

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

Создание специальных параметров

Перед загрузкой данных нужно создать специальные параметры.

Создайте специальные параметры на уровне пользователя для значений, которые необходимо импортировать. Например, можно создать специальный параметр "Уровень лояльности пользователя" со свойством пользователя "loyalty_tier".

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

Создание CSV-файла

Создайте CSV-файл с идентификаторами пользователей и значениями свойств пользователей. Например:

user_id	loyalty_tier
A1234	золотой
J1234	бронзовый
K1234	серебряный
R1234	серебряный

Загрузка данных

Стандартная процедура загрузки описана в статье Импорт данных.

При создании источника данных выберите Пользовательские данные по идентификатору User-ID или Пользовательские данные по идентификатору Client-ID, в зависимости от метода идентификации пользователей (User-ID или Client-ID/идентификатор экземпляра приложения + идентификатор потока).

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

В первом столбце:

Поле Аналитики (в данном случае User-ID), с которым вы объединяете данные. Его также называют ключом схемы.
Свойства пользователей для специальных параметров, созданных вами в Аналитике, соответствующие полям в вашем CSV-файле. В предыдущем примере специальный параметр – это "Уровень лояльности пользователя" со свойством пользователя "loyalty_tier".

Во втором столбце нужно указать, какие столбцы в CSV-файле соответствуют этим параметрам и показателям:

Данные появятся в отчетах, аудиториях и исследованиях в течение 24 часов с момента загрузки.

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

Примечание. В отчеты GA4 включаются только активные пользователи. Однако в Google Рекламу будут экспортированы данные всех пользователей, в том числе неактивных.

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

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

Сведения об источнике данных

Термины

Область действия. Определяет, какие события будут связаны со значениями параметров импорта. Специальные параметры могут иметь одну из трех областей действия:
- Событие. Описание события (например, название события).
- Пользователь. Описание пользователя, инициировавшего событие (например, уровень лояльности).
- Позиция. Описание информации, собираемой в массив позиций в рамках события электронной торговли.
Ключ схемы. Содержит перечень основных параметров или показателей. Ключ используется для того, чтобы объединять загруженные данные с собранной информацией о событиях для определенного типа источника данных.
Импортированные данные. Содержат параметры и показатели, доступные для данных, загруженных в Аналитику.

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

Область действия	Пользователь
Ключ схемы	Один из следующих вариантов: идентификатор клиента + идентификатор потока; User-ID.
Импортированные данные	Свойства пользователя
Примечания	При импорте пользовательских данных запрещается загружать или добавлять любую информацию, которая позволяет установить личность пользователя. Подробнее…

Шаблоны

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

Client-ID

client_id	stream_id	user_property1	user_property2	user_property3
1234567890.1234567890	1234567	значение пользователя 1	значение пользователя 2	значение пользователя 3
2345678901.2345678901	1234567	значение пользователя 1	значение пользователя 2	значение пользователя 3
3456789012.3456789012	1234567	значение пользователя 1	значение пользователя 2	значение пользователя 3

Убедитесь, что идентификаторы клиентов хранятся в виде строк, а не чисел. Иначе система может сокращать количество символов, отображаемых после десятичной точки.

User-ID

user_id	user_property1	user_property2	user_property3
123abc	значение пользователя 1	значение пользователя 2	значение пользователя 3
456def	значение пользователя 1	значение пользователя 2	значение пользователя 3
789ghi	значение пользователя 1	значение пользователя 2	значение пользователя 3

Скачайте шаблон импорта CSV для пользовательских данных.

Как найти идентификатор потока (stream_id)

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

Идентификатор потока находится слева от описания статуса.

Лимит на импорт пользовательских данных

Всего можно создать не более 10 источников для пользовательских данных.

Эта информация оказалась полезной?

Как можно улучшить эту статью?