Вкратце: CUID позволяет объединять события одного и того же пользователя на различных устройствах, источниках медиа или каналах.
Что такое CUID?
Идентификатор пользователя клиента (CUID) — это уникальный идентификатор пользователя. Обычно он создается и устанавливается владельцем приложения во время регистрации пользователя. CUID позволяет владельцам приложений отслеживать действия пользователей на различных устройствах.
Пример
Пользователь, имеющий два или более устройства, имеет одинаковый CUID в приложении. Каждый раз, когда пользователь выполняет событие на мобильном или настольном устройстве, оно фиксируется вместе с CUID. Это позволяет рекламодателю объединить данные устройств в целостное представление о пользователе.
Несколько примеров использования:
- Покупки в приложении, совершенные одним пользователем на разных устройствах (телефон, планшет, ТВ, настольный компьютер), можно объединить в одном представлении.
- Эффективность пользователя в игре, установленной на нескольких платформах (настольный компьютер, мобильное устройство, ТВ), может быть интегрирована для достижения целостного пользовательского опыта.
Установка CUID
Рекомендуется устанавливать CUID как можно раньше в процессе инициализации SDK (пакет средств разработки ПО), чтобы как можно большее количество событий было связано с CUID.
Как только CUID станет доступен, можно установить его, вызвав setCustomerUserID
. CUID может быть связан только с внутренними событиями, происходящими после его установки. Поэтому событие установки не будет связано с CUID, если setCustomerUserID
вызывается до setCustomerUserID
.
Связь CUID с событием установки
Если для вас важно связать событие установки с CUID, задайте его до вызова start
.
Важно: Помните, что установка CUID перед start
может заблокировать SDK (пакет средств разработки ПО) от отправки события установки и, таким образом, предотвратить атрибуцию. Это может произойти, например, когда пользователь запускает Приложение впервые и выходит из него до того, как SDK сможет установить CUID.
В Android метод start
и настройка CUID могут быть выполнены либо из глобального класса Application
, либо из класса Activity
, в зависимости от реализации Приложения. Для получения дополнительной информации см. Выбор класса для запуска SDK.
Если SDK запускается в классе Application
Если вы хотите связать CUID с событием установки при запуске из глобального класса Application
, обязательно отложите отправку события установки с помощью метода waitForCustomerUserId
. Этот метод переводит SDK в режим ожидания, пока CUID не будет установлен.
Примечание: Если по какой-то причине установка CUID не удалась, SDK останется в режиме ожидания и не будет отправлять никаких событий.
Если SDK запускается в классе Activity
Если вы хотите связать CUID с событием установки при запуске из класса Activity
, отправку события установки откладывать не нужно. Достаточно вызвать start
перед вызовом start
.
ИНСТРУКЦИИ ДЛЯ РАЗРАБОТЧИКА
Сообщите разработчику следующее:
- Используйте
waitForCustomerUserId
, если SDK запускается в глобальном классеApplication
. - Ссылки для разработчиков:
- Если вы хотите связать CUID с событием установки, см. здесь.
Используйте метод customerUserId
для установки CUID. Расположение start
относительно метода start
определяет, какие события могут быть связаны с CUID.
- Если
customerUserId
вызывается перед вызовомstart
, CUID связывается с установкой и последующими событиями в приложении. - Если вызов осуществляется после
start
, CUID будет ассоциироваться только с событиями, зафиксированными после его установки.
ИНСТРУКЦИИ ДЛЯ РАЗРАБОТЧИКА
Обратитесь к вашему разработчику по настройке идентификатора пользователя клиента в Dev Hub.
ИНСТРУКЦИИ ДЛЯ РАЗРАБОТЧИКА
Обратитесь к вашему разработчику по настройке идентификатора пользователя клиента в Dev Hub.
ИНСТРУКЦИИ ДЛЯ РАЗРАБОТЧИКА
Порекомендуйте вашему разработчику ознакомиться с справочником API setCustomerUserId в Dev Hub.
CUID и конфиденциальность
AppsFlyer ценит и уважает конфиденциальность ваших пользователей и не допускает сбор или передачу конфиденциальных персональных данных на платформу AppsFlyer.
Для защиты конфиденциальности ваших пользователей, в CUID не допускается использование информации, напрямую идентифицирующей пользователя. Это включает в себя номера социального страхования или национальные идентификационные номера.
Кроме того, если CUID содержит адрес электронной почты или номер телефона пользователя, такая информация должна всегда хэшироваться при отправке в AppsFlyer. Запрещается отправлять необработанные CUID, содержащие личные данные, в AppsFlyer.
См. также
- Отчёты о пути пользователя (подробнее о CUID в отчетах о необработанных данных)
- Рекомендации Google, чтобы избежать отправки PII