어떻게 도와드릴까요?

잠재고객 - 파트너 잠재고객 생성을 위한 추가 식별자를 구성합니다.

  • 업데이트 시간

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

추가 식별자에 대하여

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

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

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

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

다음 단계

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

사용 가능한 식별자

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

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

식별자 파라미터 이름 형식 예시 값 (해싱 전)
이메일 주소 이메일_sha256

SDK v7.0.0 및 이전 버전:

  • 소문자
  • 공백이 없음
  • 전달하기 전에 클라이언트 해시됨 (SHA256)

SDK v7.0.1 이상: 일반 텍스트. SDK는 자동으로 정규화하고 해시합니다.

이름@도메인.com
전화번호
(아래 참고사항 참조)

v7.0.0 및 이전 버전 (또는 S2S): 전화_번호_sha256

v7.0.1 이상: 전화번호_해시됨

v7.0.0 및 이전 버전 (또는 S2S):

  • 기호, 문자 또는 선행 0 없음
  • 국가 코드 포함
  • SHA256 해시됨

v7.0.1 이상: 일반 텍스트. SDK는 국가 코드와 번호를 연결하고, 정규화하고, 자동으로 해시합니다.

442070313000

전화번호 E164

(아래 참고사항 참조)

v7.0.0 이하 (또는 S2S): 전화_번호_e164_sha256

v7.0.1 이상: 전화_번호_e164_해시드

v7.0.0 및 이전 버전 (또는 S2S):

  • E164 전화번호
  • SHA256 해시됨

v7.0.1 이상: 일반 텍스트. SDK는 국가 코드와 번호를 연결하고, 정규화하고, 자동으로 해시합니다.

+442070313000

참고 사항 

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

SDK 참조 및 코드 샘플

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

  • 해시된 이메일 주소 또는 전화번호 이외의 식별자에는 을 사용하십시오. setAdditionalData
  • 해시된 이메일 주소의 경우 을 사용하세요.
    • SDK 버전 7.0.1 이상: 사용하십시오. setUserEmail
    • SDK v7.0.0 및 이전 버전: 사용하십시오. setUserEmails
  • 해시된 전화번호의 경우:
    • SDK v7.0.1 이상: 사용 setUserPhone (권장).
    • SDK v7.0.0 및 이전 버전: 커스텀 데이터와 함께 사용합니다. setAdditionalData

참고 사항

다음과 같은 버전에 따른 변경 사항을 유념하라.

  • 이메일 : SDK v7.0.1부터 setUserEmails (iOS/안드로이드) 가 완전히 제거되고 로 대체되었습니다. setUserEmail 이는 지원 중단이 아니라 주요 변경 사항입니다. v7.0.0 및 이전 버전의 앱은 계속 사용해야 합니다. setUserEmails v7.0.1 이상의 앱은 로 전환해야 합니다. setUserEmail 팔로우할 샘플을 선택하기 전에 통합 SDK 버전을 확인하세요.
  • phone SDK v7.0.1부터 전용 API를 사용할 setUserPhone 수 있습니다. 어드밴스드 매칭을 위해 전화번호 식별자를 보내는 권장 방법입니다. 이것은 주요 변경 사항이 아닙니다. setAdditionalData 여전히 작동합니다. 새로운 통합의 경우 및 v7.0.1 이상으로 업그레이드하는 고객의 경우 로 마이그레이션하는 것이 좋습니다. setUserPhone v7.0.0 및 이전 버전의 앱은 해당 SDK setAdditionalData 버전에 setUserPhone 존재하지 않으므로 계속 사용해야 합니다.

iOS SDK 설정

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

SDK v7.0.0 and earlier — 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 이상 — 사용자 폰 설정 (권장)

메서드 서명
- (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 다시 전화를 걸면 이전에 설정한 값에 값을 더하지 않고 무시합니다.

안드로이드 SDK 설정

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

SDK v7.0.0 and earlier — 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 이상 — 사용자 폰 설정 (권장)

메서드 서명
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");

참고

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