Поле Идентификатор клиента (CUID)

Для:
маркетологов разработчиков
Последнее обновление:

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

Что такое CUID?

Идентификатор клиента (CUID) — это уникальный идентификатор пользователя. Обычно генерируется и устанавливается владельцем приложения во время регистрации пользователя. CUID позволяет владельцам приложений отслеживать пути пользователей на разных устройствах.

Примеры

Пользователь с двумя или более устройствами имеет в приложении один и тот же CUID. Каждый раз, когда пользователь выполняет какое-либо событие на мобильном или настольном устройстве, событие фиксируется вместе с CUID. Это позволяет рекламодателю объединить данные от разных устройств в целостное представление о пользователе.

Несколько примеров использования:

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

Настройка идентификатора CUID

Рекомендуется устанавливать CUID как можно раньше в потоке инициализации SDK, чтобы как можно больше событий получали связь с CUID.

Установка CUID в Android

Когда CUID станет доступен, его можно установить, вызвав setCustomerUserID. CUID может быть связан только с событиями в приложении, произошедшими после того, как этот идентификатор был задан. Поэтому событие установки не будет связано с CUID, если start вызывается до setCustomerUserID.

Свяжите CUID с событием установки

Если для вас важно связать событие установки с CUID, то его следует задать перед вызовом start.

Важно: Помните, что если задать CUID перед вызовом start, это может заблокировать отправку события установки из SDK и, таким образом, помешать атрибуции. Это может произойти, например, когда пользователь запускает приложение в первый раз, а затем выходит из него до того, как SDK успеет задать CUID.

В Android метод start и настройка CUID могут быть выполнены либо из глобального класса Application, либо из класса Activity, в зависимости от реализации приложения. Подробнее см. в разделе Выберите, в каком классе запускать SDK.

Если SDK запускается в классе Application

Если вы хотите связать CUID с событием install при запуске из глобального класса Application, убедитесь, что вы отложили отправку события установки с помощью метода waitForCustomerUserId. Этот метод переводит SDK в режим ожидания, пока не будет установлен CUID.

Примечание. Если по какой-то причине установка CUID не удалась, SDK останется в режиме ожидания и не будет посылать никаких событий.

Если SDK запускается в классе Activity

Если вы хотите связать CUID с событием установки при запуске из класса Activity, вам не нужно задерживать отправку события установки. Достаточно вызвать setCustomerUserId перед вызовом start.

Инструкции для разработчика

Проинформируйте разработчика о следующем:

  • Использовать метод waitForCustomerUserId, если SDK запускается в глобальном классе Application.
  • Ссылки для разработчика:
    • Если вы хотите связать CUID с событием установки, смотрите эту статью.

Установка CUID в iOS

Используйте метод customerUserId для установки CUID. Расположение customerUserId по отношению к методу start определяет, какие события могут быть связаны с CUID.

  • Если customerUserId вызывается перед вызовом start, то CUID ассоциируется с установкой и следующими событиями внутри приложения.
  • Если он вызывается после start, то CUID ассоциируется только с событиями, записанными после установки CUID.

Инструкции для разработчика

Направьте разработчика по следующим ссылкам:

CUID и конфиденциальность

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

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

Кроме того, если заданный CUID содержит адрес электронной почты или номер телефона пользователя, то при отправке в AppsFlyer такая информация должна быть обязательно хэширована. Запрещается отправлять в AppsFlyer нехэшированные CUID, содержащие персональные данные.

Материал по теме

См. Отчеты о пути пользователей, чтобы узнать больше о CUID в отчетах по сырым данным.