How can we help?

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

  • Обновлено

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

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

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

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

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

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

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

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

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

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

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

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

  • В нижнем регистре
  • Без пробелов
  • Хешировать на стороне клиента (SHA256) перед передачей

SDK v7.0.1 and later: Plain text. SDK автоматически нормализует и хеширует его.

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

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

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

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

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

v7.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 хеширование

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

+442070313000

номер_телефона_e164_sha256

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

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

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

  • Для идентификаторов, помимо хешированного адреса электронной почты, используйте
  • Для хешированного адреса электронной почты используйте
    • SDK v7.0.1 and later: use setUserEmail.
    • SDK v7.0.0 and earlier: use setUserEmails.
  • В дэшборде «Аудитории»:
    • SDK v7.0.1 and later: use setUserPhone (recommended).
    • SDK v7.0.0 and earlier: use setAdditionalData with custom data.

Java Kotlin

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

  • Электронная почта: Начиная с 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 по-прежнему работает. For new integrations, and for customers who upgrade to v7.0.1 and later, we recommend migrating to setUserPhone. Приложения на v7.0.0 и более ранних версиях должны продолжать использовать setAdditionalData, поскольку setUserPhone не существует в этих версиях SDK.

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

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

SDK v7.0.0 and earlier — setAdditionalData

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

Строчные буквы

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

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

SHA256 хеширование

- (void)setUserPhone:(NSString *_Nonnull)countryCode
phoneNumber:(NSString *_Nonnull)phoneNumber;

Пример использования

Objective C
[[AppsFlyerLib shared] setUserPhone:@"1" phoneNumber:@"(650) 555-1212"];
Swift
AppsFlyerLib.shared().setUserPhone(countryCode: "1", phoneNumber: "(650) 555-1212")

номер_телефона_sha256

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

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

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

Сигнатура метода

- (void)setUserEmails:(NSArray<NSString *> *_Nullable)userEmails 
withCryptType:(EmailCryptType)type;

Пример использования

Objective C
NSArray *emails = @[@"name@domain.com"];    
[[AppsFlyerLib shared] setUserEmails:emails withCryptType:EmailCryptTypeSHA256];
Swift
let emails: Array = ["name@domain.com"]
AppsFlyerLib.shared().setUserEmails(emails, with: EmailCryptTypeSHA256)

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

Сигнатура метода

- (void)setUserEmail:(NSString *_Nonnull)email;

Пример использования

Objective C
[[AppsFlyerLib shared] setUserEmail:@"name@domain.com"];
Swift
AppsFlyerLib.shared().setUserEmail("name@domain.com")

JavaKotlin

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

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

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

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

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

Objective-C Swift

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

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

Аудитории — дополнительные идентификаторы

public abstract void setUserPhone(String countryCode, String phoneNumber);

Пример использования

Java
AppsFlyerLib.getInstance().setUserPhone("1", "(650) 555-1212");
Kotlin
AppsFlyerLib.getInstance().setUserPhone("1", "(650) 555-1212")

Примечание

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

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

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

SHA256 хеширование

public abstract void setUserEmails(
  AppsFlyerProperties.EmailsCryptType cryptMethod,
  String... emails
);

Пример использования

Java
AppsFlyerLib.getInstance().setUserEmails(
  AppsFlyerProperties.EmailsCryptType.SHA256,
  "name@domain.com",
  "another_name@another_domain.com"
);
Kotlin
AppsFlyerLib.getInstance().setUserEmails(
  AppsFlyerProperties.EmailsCryptType.SHA256,
  "name@domain.com",
  "another_name@another_domain.com"
);

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

SHA256 хеширование

public abstract void setUserEmail(String email);

Пример использования

AppsFlyerLib.getInstance().setUserEmail("name@domain.com");

Примечание

В v7.0.1 и более поздних версиях за один вызов принимается только один email. Несколько адресов электронной почты не поддерживаются: повторный вызов 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: