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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Термины

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

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

Область действия	Пользователь
Ключ схемы	Один из следующих вариантов: идентификатор клиента + идентификатор потока; 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)

1. На странице Администратор в разделе Сбор и редактирование данных нажмите Потоки данных.
2. Откройте нужный поток данных.

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