오디언스 - 추가 식별자

대상:
마케터 개발자
마지막 업데이트:

한눈에 보기: 광고 파트너에게 커스텀 오디언스를 보내기 위해 추가 유저 식별자를 설정합니다.

추가 식별자에 대하여

앱스플라이어 오디언스는 커스텀 오디언스를 광고 파트너에게 전송하기 위해 다음과 같은 디바이스 식별자를 자동으로 지원합니다.

  • iOS : IDFA
  • 안드로이드 (구글 플레이): GAID
  • 안드로이드 (타사 앱 스토어): OAID 및 IMEI

일부 광고 파트너는 추가 유저 식별자를 기반으로 한 커스텀 오디언스 매칭도 지원합니다. 오디언스에서는 앱스플라이어 SDK 또는 S2S 모바일 API를 통해 특별히 구성하는 경우 이러한 식별자를 활용할 수 있는 옵션을 제공합니다.

이러한 추가 식별자에는 전화번호와 이메일이 포함될 수 있으며, SHA256 해싱으로 암호화된 경우에만 사용할 수 있습니다.  이러한 추가 식별자를 사용할 때는 추가 식별자 이용약관의 적용을 받습니다.

다음 단계

  1. 사용 가능한 식별자 표에서 사용하려는 추가 식별자를 선택하세요 . 모든 광고 파트너가 모든 식별자를 지원하는 것은 아닙니다.
  2. 개발자 — 선택한 식별자를 구성하세요:
  3. 오디언스 대시보드에서:

사용 가능한 식별자

아래 표에 표시된 대로, 하나 이상의 식별자를 구성할 수 있습니다.

추가 식별자 — 파라미터 및 형식

식별자 파라미터 이름 형식 예시 값 (해싱 전)
이메일 주소 이메일_sha256
  • 소문자
  • 공백이 없음
  • SHA256 해시됨
 이름@도메인.com
전화번호
(아래 참고사항 참조)		 전화번호_sha256
  • 기호, 문자 또는 선행 0 없음
  • 국가 코드 포함
  • SHA256 해시됨
 442070313000

전화번호 E164

(아래 참고사항 참조)

 전화번호_e164_sha256
  • E164 전화번호
  • SHA256 해시됨
 +442070313000

참고 사항 

광고 파트너마다 지원하는 전화번호 형식이 다릅니다. 따라서 전화번호를 사용하기로 선택한 경우 두 가지 식별자를 모두 설정하세요. 전화번호 및 전화번호 E164.

SDK 참조 및 코드 샘플

SDK를 통해 오디언스 식별자를 발송할 때:

  • 해시되지 않은 이메일 주소를 제외한 식별자의 경우 을 사용하세요.
  • 해시된 이메일 주소의 경우 을 사용하세요.

iOS SDK 설정

추가 유저 식별자로 해시된 전화번호를 설정하려면:

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

추가 유저 식별자로 해시된 이메일 주소를 설정하려면:

메서드 서명

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

사용 예시
Objective-C Swift 
NSArray *emails = @[@"name@domain.com"];    
[[AppsFlyerLib shared] setUserEmails:emails withCryptType:EmailCryptTypeSHA256];

안드로이드 SDK 설정

추가 유저 식별자로 해시된 전화번호를 설정하려면:

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

추가 유저 식별자로 해시된 이메일 주소를 설정하려면:

메서드 서명

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

사용 예시
JavaKotlin 
AppsFlyerLib.getInstance().setUserEmails(
  AppsFlyerProperties.EmailsCryptType.SHA256,
  "name@domain.com",
  "another_name@another_domain.com"
);

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