CUID позволяет объединять события одного и того же пользователя на различных устройствах, источниках медиа или каналах.
Что такое CUID?
Идентификатор пользователя клиента (CUID) — это уникальный идентификатор пользователя. Обычно владелец приложения генерирует и задаёт его во время регистрации пользователя. CUID позволяет владельцам приложений отслеживать действия пользователей на различных устройствах.
Например
У пользователя с двумя или более устройствами один и тот же CUID во всех приложениях. Каждый раз, когда пользователь выполняет событие на мобильном или настольном устройстве, SDK фиксирует событие вместе с CUID. Это позволяет рекламодателю объединить данные устройств в целостное представление о пользователе.
Несколько примеров использования:
- Покупки в приложении, совершённые одним и тем же пользователем в одном и том же приложении на нескольких устройствах (телефон, планшет, ТВ, настольный компьютер), можно объединить в единое представление.
- Вы можете передавать данные об эффективности пользователей между несколькими платформами (настольными компьютерами, мобильными устройствами, ТВ), чтобы обеспечить целостный пользовательский опыт.
Установка CUID
Рекомендуется задавать CUID как можно раньше в процессе инициализации SDK, чтобы с CUID можно было связать как можно больше событий.
Android iOS
Как только CUID станет доступен, можно установить его, вызвав setCustomerUserID. Вы можете связать CUID только с событиями в приложении, которые происходят после его установки. Поэтому событие установки не будет содержать CUID, если вы вызываете start до setCustomerUserID.
Связь CUID с событием установки
Если вам нужно связать событие установки с CUID, рекомендуем задать его до вызова start.
Важно: Помните, что установка CUID перед start может заблокировать SDK (пакет средств разработки ПО) от отправки события установки и, таким образом, предотвратить атрибуцию. Это может произойти, например, когда пользователь запускает Приложение впервые и выходит из него до того, как SDK сможет установить CUID.
В Android вы можете запускать start и настраивать CUID либо из глобального класса Application , либо из класса Activity в зависимости от реализации приложения. Для получения дополнительной информации см. Выбор класса для запуска SDK.
Если SDK запускается в классе Application
Если вы хотите связать CUID с событием установки при запуске из глобального класса Application class, обязательно отложите отправку события установки с помощью метода waitForCustomerUserId method. Этот метод переводит SDK в режим ожидания, пока CUID не будет установлен.
Примечание. Если по какой-то причине не удастся задать CUID, SDK останется в режиме ожидания и не будет отправлять никаких событий.
Если SDK запускается в классе Activity
Если вы хотите связать CUID с событием установки при запуске из класса Activity class, отправку события установки откладывать не нужно. Достаточно вызвать start перед вызовом start.
Инструкции для разработчиков
Сообщите разработчикам следующее:
- Используйте
waitForCustomerUserId, если SDK запускается в глобальном классеApplication. - Ссылки для разработчиков:
- Если вы хотите связать CUID с событием установки, см. здесь.
Android native iOS native UnityReact Native
Используйте метод customerUserId для установки CUID. Расположение customerUserId по отношению к start определяет, какие события можно связать с CUID.
- Если вы вызываете
customerUserIdдо вызоваstart, SDK связывает CUID с установкой и следующими событиями в приложении - Если вы вызываете его после
start, SDK связывает CUID только с событиями, зарегистрированными после того, как вы его задали.
Инструкции для разработчиков
Обратитесь к вашему разработчику по настройке идентификатора пользователя клиента в Dev Hub.
Unity
Инструкции для разработчиков
Обратитесь к вашему разработчику по настройке идентификатора пользователя клиента в Dev Hub.
iOS nativeUnityReact Native
Инструкции для разработчиков
Порекомендуйте вашему разработчику ознакомиться с справочником API setCustomerUserId в Dev Hub.
Веб
Полное пошаговое руководство по реализации см. в статье Set customer user ID в материале Integrate AppsFlyer Web SDK.
CUID и конфиденциальность
AppsFlyer ценит и уважает конфиденциальность ваших пользователей и не допускает сбор или передачу конфиденциальных персональных данных на платформу AppsFlyer.
Чтобы защитить конфиденциальность ваших пользователей, вы не должны создавать CUID так, чтобы он содержал информацию, которая напрямую идентифицирует пользователя. Это включает в себя номера социального страхования или национальные идентификационные номера.
Если CUID содержит адрес электронной почты пользователя или номер телефона, перед отправкой в AppsFlyer его необходимо хешировать. Никогда не отправляйте в AppsFlyer нехешированные CUID, содержащие персональные данные.
См. также
- Отчёты о пути пользователя (подробнее о CUID в отчетах о необработанных данных)
- Рекомендации Google, чтобы избежать отправки PII