Краткий обзор. CUID позволяет группировать события одного и того же пользователя на разных устройствах, в разных медиа-источниках или каналах.
Что такое CUID?
Идентификатор клиента (CUID) — это уникальный идентификатор пользователя. Обычно генерируется и устанавливается владельцем приложения во время регистрации пользователя. CUID позволяет владельцам приложений отслеживать пути пользователей на разных устройствах.
Пример
Пользователь с двумя или более устройствами имеет в приложении один и тот же CUID. Каждый раз, когда пользователь выполняет какое-либо событие на мобильном или настольном устройстве, событие фиксируется вместе с CUID. Это позволяет рекламодателю объединить данные от разных устройств в целостное представление о пользователе.
Несколько примеров использования:
- Покупки в приложении, совершенные одним и тем же пользователем в одном и том же приложении на нескольких устройствах (телефон, планшет, телевизор, настольный компьютер), можно объединить в единое представление.
- Показатели пользователя в игре, установленной на нескольких платформах (настольных ПК, мобильных, ТВ), можно передавать между этими платформами для достижения целостного пользовательского опыта.
Настройка идентификатора CUID
Рекомендуется устанавливать CUID как можно раньше в потоке инициализации SDK, чтобы как можно больше событий получали связь с CUID.
Когда 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 с событием установки, смотрите эту статью.
Используйте метод customerUserId
для установки CUID. Расположение customerUserId
по отношению к методу start
определяет, какие события могут быть связаны с CUID.
- Если
customerUserId
вызывается перед вызовомstart
, то CUID ассоциируется с установкой и следующими событиями внутри приложения. - Если он вызывается после
start
, то CUID ассоциируется только с событиями, записанными после установки CUID.
Инструкции для разработчика
Направьте разработчика в раздел Настройка идентификатора клиента в хабе для разработчиков.
Инструкции для разработчика
Направьте разработчика в раздел Настройка идентификатора клиента в хабе для разработчиков.
CUID и конфиденциальность
AppsFlyer ценит и уважает конфиденциальность ваших пользователей и не разрешает сбор или передачу личной информации на платформе AppsFlyer.
Чтобы обеспечить конфиденциальность ваших пользователей, не указывайте в CUID информацию, которая может непосредственно идентифицировать пользователей. Сюда относятся также номера социального страхования или номера удостоверений личности.
Кроме того, если заданный CUID содержит адрес электронной почты или номер телефона пользователя, то при отправке в AppsFlyer такая информация должна быть обязательно хэширована. Запрещается отправлять в AppsFlyer нехэшированные CUID, содержащие персональные данные.
См. также
- Отчеты о пути пользователей (подробнее о CUID в отчетах по сырым данным)
- Рекомендации Google, как избежать предоставления конфиденциальной информации