Краткий обзор: Настройте дополнительные идентификаторы пользователей для отправки пользовательских аудиторий рекламным Партнерам.
О дополнительных идентификаторах
AppsFlyer Аудитории автоматически поддерживает следующие идентификаторы устройств для отправки пользовательских аудиторий рекламным Партнерам:
- iOS: IDFA
- Android (Google Play): GAID
- Android (сторонние магазины приложений): OAID и IMEI
Некоторые рекламные Партнеры также поддерживают сопоставление пользовательских аудиторий на основе дополнительных идентификаторов пользователей. Аудитории предоставляет вам возможность использовать эти идентификаторы, если вы настроите их через SDK (пакет средств разработки ПО) AppsFlyer или мобильный API S2S.
Такие дополнительные идентификаторы могут включать номера телефонов и адреса электронной почты, но их можно использовать только, если они зашифрованы с использованием хеширования SHA256. Использование таких дополнительных идентификаторов регулируется Условиями использования дополнительных идентификаторов.
Следующие шаги
- Выберите дополнительные идентификаторы, которые вы хотите использовать (если таковые имеются), из таблицы доступных идентификаторов. Заметьте, что не все рекламные Партнеры поддерживают все идентификаторы.
- Разработчики—Настройте выбранные идентификаторы, используя:
- Параметры и требования к форматированию, указанные в таблице доступных идентификаторов
- Справочные материалы и примеры кода для SDK (пакет средств разработки ПО) и S2S
- В дэшборде «Аудитории»:
- Установите политику идентификаторов пользователей на уровне учетной записи
- Выберите идентификаторы, которые будут загружены в каждое из ваших подключений с Партнерами.
Доступные идентификаторы
Вы можете настроить один или несколько идентификаторов, указанных в таблице ниже.
Дополнительные идентификаторы—параметры и форматирование
Идентификатор | Имя параметра | Формат | Пример значения (до хеширования) |
---|---|---|---|
Адрес электронной почты | email_sha256 |
|
имя@домен.com |
Номер телефона (см. примечание ниже) |
номер_телефона_sha256 |
|
442070313000 |
Номер телефона E164 (см. примечание ниже) |
номер_телефона_e164_sha256 |
|
+442070313000 |
ПримечаниеРазные рекламные Партнеры поддерживают разные форматы телефонных номеров. Поэтому, если вы решите использовать номер телефона, настройте оба идентификатора: Номер телефона и Номер телефона E164. |
Справочник SDK (пакет средств разработки ПО) и образцы кода
При отправке идентификаторов для аудиторий через SDK (пакет средств разработки ПО):
- Для идентификаторов, помимо хешированного адреса электронной почты, используйте
- Для хешированного адреса электронной почты используйте
Настройка iOS SDK (пакет средств разработки ПО)
Чтобы задать хешированный номер телефона как дополнительный идентификатор пользователя:
NSDictionary *customData = @{
@"audiences": @{
@"phone_number_sha256": @"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
@"phone_number_e164_sha256":@"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
}
};
[[AppsFlyerLib shared] setAdditionalData:customData];
let customData: Dictionary = [
“audiences” : [
"phone_number_sha256":"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
"phone_number_e164_sha256":"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
]
]
AppsFlyerLib.shared().customData = customData
Чтобы задать хешированный адрес электронной почты как дополнительный идентификатор пользователя:
Сигнатура метода |
|
Пример использования |
|
Настройка Android SDK (пакет средств разработки ПО)
Чтобы задать хешированный номер телефона как дополнительный идентификатор пользователя:
HashMap<String, Object> audiences = new HashMap<>();
audiences.put("phone_number_sha256", "6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37");
audiences.put("phone_number_e164_sha256", "F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E");
HashMap<String, Object> customDataMap = new HashMap<>();
customDataMap.put("audiences", audiences);
AppsFlyerLib.getInstance().setAdditionalData(customDataMap);
val audiences = hashMapOf<String, Any>(
"phone_number_sha256" to "6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
"phone_number_e164_sha256" to "F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
)
val customDataMap = hashMapOf<String, Any>("audiences" to audiences)
AppsFlyerLib.getInstance().setAdditionalData(customDataMap)
Чтобы задать хешированный адрес электронной почты как дополнительный идентификатор пользователя:
Сигнатура метода |
|
Пример использования |
|
Справочник S2S и образцы кода
При отправке идентификаторов для аудиторий через S2S используйте параметр для всех идентификаторов (включая хешированный адрес электронной почты). Вы можете отправить один или несколько идентификаторов.
Отправка идентификаторов через S2S
Формат:
- Вложенный JSON
- Значение ключа должно быть
audiences
- Все значения должны быть в формате строки, как показано в примере кода ниже.
- Названия параметров должны совпадать с указанными в таблице доступных идентификаторов выше.
Общий формат:
"custom_data" : {
\"audiences\" : {
\"parameter_name_a\" : \"hashed_identifer_a\",
\"parameter_name_a\" : \"hashed_identifer_b\",
\"parameter_name_c\" : \"hashed_identifer_c\"
}
}
Пример с заполненными полями для хешированного номера телефона и хешированного адреса электронной почты:
"custom_data" : {
\"audiences\" : {
\"phone_number_sha256\" : \"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37\",
\"phone_number_e164_sha256\" : \"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E\",
\"email_sha256\" : \"34D31BE18022626DE6B311D6A76E791176D2691B6EEF406F524D8F56364C187A\"
}
}