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

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

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

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

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

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

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

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

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

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

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

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

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

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

SDK v7.0.0 and earlier — setAdditionalData

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

Objective-C Swift

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

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

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

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

[[AppsFlyerLib shared] setUserPhone:@"1" phoneNumber:@"(650) 555-1212"];

AppsFlyerLib.shared().setUserPhone(countryCode: "1", phoneNumber: "(650) 555-1212")

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

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

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

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

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

NSArray *emails = @[@"name@domain.com"];    
[[AppsFlyerLib shared] setUserEmails:emails withCryptType:EmailCryptTypeSHA256];

let emails: Array = ["name@domain.com"]
AppsFlyerLib.shared().setUserEmails(emails, with: EmailCryptTypeSHA256)

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

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

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

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

[[AppsFlyerLib shared] setUserEmail:@"name@domain.com"];

AppsFlyerLib.shared().setUserEmail("name@domain.com")

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

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

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

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)

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

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

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

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

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

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

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

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

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

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

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

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

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");

Справочник S2S и образцы кода

При отправке идентификаторов для аудиторий через S2S используйте параметр для всех идентификаторов (включая хешированный адрес электронной почты). Вы можете отправить один или несколько идентификаторов.

"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\"
     }
}

• Additional Identifiers Terms of Use.pdf100 КБ