How can we help?

Аудитории — Настройка дополнительных идентификаторов для создания партнерских аудиторий

  • Обновлено

Краткий обзор: Настройте дополнительные идентификаторы пользователей для отправки пользовательских аудиторий рекламным Партнерам.

О дополнительных идентификаторах

AppsFlyer Аудитории автоматически поддерживает следующие идентификаторы устройств для отправки пользовательских аудиторий рекламным Партнерам:

  • iOS: IDFA
  • Android (Google Play): GAID
  • Android (сторонние магазины приложений): OAID и IMEI

Некоторые рекламные партнеры также поддерживают сопоставление пользовательских аудиторий на основе дополнительных идентификаторов пользователей. Раздел «Аудитории» позволяет использовать эти идентификаторы, если вы специально настроили их передачу через AppsFlyer SDK или S2S API для мобильных приложений.

Такие дополнительные идентификаторы могут включать номера телефонов и адреса электронной почты, но их можно использовать только, если они зашифрованы с использованием хеширования SHA256.  Использование таких дополнительных идентификаторов регулируется Условиями использования дополнительных идентификаторов.

Следующие шаги

  1. Выберите дополнительные идентификаторы, которые вы хотите использовать (если таковые имеются), из таблицы доступных идентификаторов. Заметьте, что не все рекламные Партнеры поддерживают все идентификаторы.
  2. РазработчикиНастройте выбранные идентификаторы, используя:
  3. В дэшборде «Аудитории»:

Доступные идентификаторы

Вы можете настроить один или несколько идентификаторов, указанных в таблице ниже.

Дополнительные идентификаторыпараметры и форматирование

Идентификатор Имя параметра Формат Пример значения (до хеширования)
Адрес электронной почты email_sha256

SDK версии 7.0.0 и ранее:

  • Строчные буквы
  • Без пробелов
  • Хешируется на стороне клиента (SHA256) перед передачей в

SDK версии 7.0.1 и новее: Обычный текст. SDK автоматически нормализует и хеширует его.

имя@домен.com
Номер телефона
(см. примечание ниже)

v7.0.0 и ранее (или S2S): phone_number_sha256

v7.0.1 и более поздние версии: phone_number_hashed

v7.0.0 и ранее (или S2S):

  • Без символов, букв или ведущих нулей
  • Включить код страны
  • SHA256 хеширование

SDK версии 7.0.1 и новее: Обычный текст. SDK автоматически объединяет код страны и номер, нормализует и хеширует их.

442070313000

Номер телефона E164

(см. примечание ниже)

v7.0.0 и ранее (или S2S): phone_number_e164_sha256

v7.0.1 и новее: phone_number_e164_hashed

v7.0.0 и ранее (или S2S):

  • E164 номер телефона
  • SHA256 хеширование

SDK версии 7.0.1 и новее: Обычный текст. SDK автоматически объединяет код страны и номер, нормализует и хеширует их.

+442070313000

Примечание 

Разные рекламные Партнеры поддерживают разные форматы телефонных номеров. Поэтому, если вы решите использовать номер телефона, настройте оба идентификатора: Номер телефона и Номер телефона E164.

Справочник SDK (пакет средств разработки ПО) и образцы кода

При отправке идентификаторов для аудиторий через SDK (пакет средств разработки ПО):

  • Для идентификаторов, отличных от хешированного адреса электронной почты или номера телефона, используйте setAdditionalData.
  • Для хешированного адреса электронной почты:
    • SDK версии 7.0.1 и новее: используйте setUserEmail.
    • SDK версии 7.0.0 и ранее: используйте setUserEmails.
  • Для хешированного номера телефона:
    • SDK версии 7.0.1 и новее: используйте setUserPhone (рекомендуется).
    • SDK версии 7.0.0 и ранее: используйте setAdditionalData с пользовательскими данными.

Примечание

Учитывайте следующие изменения, зависящие от версии:

  • Электронная почта: Начиная с SDK v7.0.1, setUserEmails (iOS/Android) был полностью удален и заменен на setUserEmail. Это критическое изменение, а не прекращение поддержки. Приложения, работающие на v7.0.0 и более ранних версиях, должны продолжать использовать setUserEmails. Приложения на v7.0.1 и более поздних версиях должны переключиться на setUserEmail. Проверьте версию интегрированного SDK перед тем, как выбрать, какому примеру следовать.
  • Телефон: Начиная с SDK v7.0.1, доступен специальный API setUserPhone. Это рекомендуемый способ отправки идентификаторов телефонных номеров для расширенного сопоставления (Advanced Matching). Это не критическое изменение: setAdditionalData по-прежнему работает. Для новых интеграций, а также для клиентов, которые обновляются до v7.0.1 и более поздних версий, мы рекомендуем выполнить миграцию на setUserPhone. Приложения на v7.0.0 и более ранних версиях должны продолжать использовать setAdditionalData, поскольку setUserPhone отсутствует в этих версиях SDK.

Настройка iOS SDK (пакет средств разработки ПО)

Чтобы задать хешированный номер телефона как дополнительный идентификатор пользователя:

SDK v7.0.0 и более ранние версии — setAdditionalData

Objective-C Swift
NSDictionary *customData = @{
  @"audiences": @{
    @"phone_number_sha256": @"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
    @"phone_number_e164_sha256":@"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
  }
};
[[AppsFlyerLib shared] setAdditionalData:customData];

Примечание

Вы должны предварительно хешировать оба значения (SHA-256) перед их передачей.

SDK v7.0.1 и более поздние версии — setUserPhone (рекомендуется)

Сигнатура метода
- (void)setUserPhone:(NSString *_Nonnull)countryCode
phoneNumber:(NSString *_Nonnull)phoneNumber;
Пример использования
Objective-C Swift
[[AppsFlyerLib shared] setUserPhone:@"1" phoneNumber:@"(650) 555-1212"];

Примечание

Передавайте код страны и местный номер в виде обычного текста. В местном номере допускаются символы и пробелы. SDK локально объединяет, нормализует и хеширует оба значения с помощью SHA-256. Не выполняйте предварительное хеширование.

Чтобы задать хешированный адрес электронной почты как дополнительный идентификатор пользователя:

SDK v7.0.0 и более ранние версии

Сигнатура метода
- (void)setUserEmails:(NSArray<NSString *> *_Nullable)userEmails 
withCryptType:(EmailCryptType)type;
Пример использования
Objective-C Swift
NSArray *emails = @[@"name@domain.com"];    
[[AppsFlyerLib shared] setUserEmails:emails withCryptType:EmailCryptTypeSHA256];

SDK v7.0.1 и более поздние версии

Сигнатура метода
- (void)setUserEmail:(NSString *_Nonnull)email;
Пример использования
Objective-C Swift
[[AppsFlyerLib shared] setUserEmail:@"name@domain.com"];

Примечание

Передайте адрес электронной почты в виде обычного текста. SDK нормализует и хеширует его локально (SHA-256). Не выполняйте предварительное хеширование. При каждом вызове принимается только один адрес электронной почты: повторный вызов setUserEmail перезаписывает ранее заданное значение, а не добавляет к нему новый адрес.

Настройка Android SDK (пакет средств разработки ПО)

Чтобы задать хешированный номер телефона как дополнительный идентификатор пользователя:

SDK v7.0.0 и более ранние версии — setAdditionalData

Java Kotlin
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);

Примечание

Вы должны предварительно хешировать оба значения (SHA-256) перед их передачей.

SDK v7.0.1 и более поздние версии — setUserPhone (рекомендуется)

Сигнатура метода
public abstract void setUserPhone(String countryCode, String phoneNumber);
Пример использования
JavaKotlin
AppsFlyerLib.getInstance().setUserPhone("1", "(650) 555-1212");

Примечание

Передавайте код страны и местный номер в виде обычного текста. SDK локально объединяет, нормализует и хеширует оба значения с помощью SHA-256. Не выполняйте предварительное хеширование.

Чтобы задать хешированный адрес электронной почты как дополнительный идентификатор пользователя:

SDK v7.0.0 и более ранние версии

Сигнатура метода
public abstract void setUserEmails(
  AppsFlyerProperties.EmailsCryptType cryptMethod,
  String... emails
);
Пример использования
JavaKotlin
AppsFlyerLib.getInstance().setUserEmails(
  AppsFlyerProperties.EmailsCryptType.SHA256,
  "name@domain.com",
  "another_name@another_domain.com"
);

SDK v7.0.1 и более поздние версии

Сигнатура метода
public abstract void setUserEmail(String email);
Пример использования
AppsFlyerLib.getInstance().setUserEmail("name@domain.com");

Примечание

В версии 7.0.1 и более поздних за один вызов принимается только один адрес электронной почты. Несколько адресов электронной почты не поддерживаются: повторный вызов setUserEmail перезаписывает ранее установленное значение, а не добавляет к нему.

Справочник 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\"
     }
}

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: