광고 파트너에게 맞춤 오디언스를 전송하기 위한 추가 사용자 식별자를 구성합니다.
추가 식별자에 대하여
앱스플라이어 오디언스는 광고 파트너에게 맞춤 오디언스를 전송하기 위해 다음 디바이스 식별자를 자동으로 지원합니다.
- iOS : IDFA
- Android(Google Play): GAID
- Android(타사 앱 스토어): OAID 및 IMEI
일부 광고 파트너는 추가 사용자 식별자를 기반으로 한 커스텀 오디언스 매칭도 지원합니다. 오디언스에서는 앱스플라이어 SDK 또는 S2S-mobile API를 통해 특별히 설정하는 경우 이러한 식별자를 활용할 수 있는 옵션을 제공합니다.
이러한 추가 식별자에는 전화번호와 이메일이 포함될 수 있으며, SHA256 해싱으로 암호화된 경우에만 사용할 수 있습니다. 이러한 추가 식별자를 사용할 때는 추가 식별자 이용약관의 적용을 받습니다.
다음 단계
- 사용 가능한 식별자 표에서 사용하려는 추가 식별자를 선택하세요. 모든 광고 파트너가 모든 식별자를 지원하는 것은 아닙니다.
- 개발자 — 다음을 사용하여 선택한 식별자를 사용하세요.
- 사용 가능한 식별자의 표에 나타난 파라미터 및 형식 요구 사항
- SDK 및 S2S 참조 및 코드 샘플
- 오디언스 대시보드에서:
- 계정 수준의 유저 식별자 정책을 설정하세요.
- 각 파트너 연결에 업로드할 식별자를 선택하세요.
사용 가능한 식별자
아래 표에 표시된 대로, 하나 이상의 식별자를 구성할 수 있습니다.
추가 식별자 — 파라미터 및 형식
| 식별자 | 파라미터 이름 | 형식 | 예시 값(해싱 전) |
| 이메일 주소 | email_sha256 |
SDK v7.0.0 이전
SDK v7.0.1 이후: 일반 텍스트 SDK가 이 데이터를 자동으로 정규화 및 해시 처리합니다. |
name@domain.com |
| 전화번호 (아래 참고사항 참조) |
v7.0.0 이전(또는 S2S): phone_number_sha256 v7.0.1 이후: phone_number_hashed |
v7.0.0 이전(또는 S2S):
SDK v7.0.1 이후: 일반 텍스트 SDK가 국가 코드와 번호를 연결하고, 자동으로 정규화 및 해시 처리합니다. |
442070313000 |
|
전화번호 E164 (아래 참고사항 참조) |
v7.0.0 이전(또는 S2S): phone_number_e164_sha256 v7.0.1 이후: phone_number_e164_hashed |
v7.0.0 이전(또는 S@S):
v7.0.1 이후 일반 텍스트 SDK가 국가 코드와 번호를 연결하고, 자동으로 정규화 및 해시 처리합니다. |
+442070313000 |
참고사항 광고 파트너마다 지원하는 전화번호 형식이 다릅니다. 따라서 전화번호를 사용하기로 선택한 경우 전화번호 및 전화번호 E164 두 식별자를 모두 설정하세요. | |||
SDK 참조 및 코드 샘플
SDK를 통해 오디언스 식별자를 발송할 때:
- 해시 처리된 이메일 주소 또는 전화번호 이외의 식별자에는
setAdditionalData를 사용하세요. - 해시된 이메일 주소:
- SDK v7.0.1 이후:
setUserEmail사용 - SDK v7.0.0 이전:
setUserEmails사용
- SDK v7.0.1 이후:
- 해시된 전화번호:
- SDK v7.0.1 및 이후:
setUserPhone사용(권장) - SDK v7.0.0 및 이전: 사용자 정의 데이터와 함께
setAdditionalData사용
- SDK v7.0.1 및 이후:
참고사항
다음 버전별 변경 사항을 확인해 주세요.
- 이메일: SDK v7.0.1부터 setUserEmails(iOS/Android)가 완전히 제거되었으며 setUserEmail로 대체되었습니다. 이는 기능 제공 중단(Deprecation)이 아닌 단절적 변경 사항(Breaking change)입니다. v7.0.0 및 이전 버전을 사용하는 앱은 setUserEmails를 계속 사용해야 합니다. v7.0.1 및 이후 버전을 사용하는 앱은 setUserEmail로 전환해야 합니다. 참조할 예제 코드를 선택하기 전에 연동된 SDK 버전을 확인하세요.
- 전화: SDK v7.0.1부터 전용 setUserPhone API를 사용할 수 있습니다. 이는 고급 매칭을 위해 전화번호 식별자를 전송하는 권장 방식입니다. 이는 단절적 변경 사항(Breaking change)이 아닙니다. setAdditionalData는 여전히 작동합니다. 신규 연동의 경우 및 v7.0.1 및 이후 버전으로 업그레이드하는 고객의 경우 setUserPhone으로 전환하는 것을 권장합니다. v7.0.0 및 이전 버전을 사용하는 앱은 해당 SDK 버전에 setUserPhone이 존재하지 않으므로 setAdditionalData를 계속 사용해야 합니다.
iOS SDK 설정
추가 유저 식별자로 해시된 전화번호를 설정하려면:
SDK v7.0.0 이전 — setAdditionalData
Objective-C
NSDictionary *customData = @{
@"audiences": @{
@"phone_number_sha256": @"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
@"phone_number_e164_sha256":@"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
}
};
[[AppsFlyerLib shared] setAdditionalData:customData];Swift
let customData: Dictionary = [
"audiences" : [
"phone_number_sha256":"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
"phone_number_e164_sha256":"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
]
]
AppsFlyerLib.shared().customData = customDataJava Kotlin
전달하기 전에 두 값을 모두 미리 해시 처리(SHA-256)해야 합니다.
SDK v7.0.1 및 이후 — setUserPhone(권장)
메소드 시그니처
- (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")참고사항
국가번호와 지역번호를 일반 텍스트로 전달하세요. 지역번호에는 기호와 공백이 허용됩니다. 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")참고사항
일반 텍스트 형태의 이메일을 전달하세요. SDK는 해당 값을 로컬에서 정규화 및 해시 처리(SHA-256)합니다. 사전 해시 처리를 하지 마세요. 호출당 단 하나의 이메일만 허용됩니다. setUserEmail을 다시 호출하면 기존에 설정된 값을 추가하는 대신 덮어씁니다.
안드로이드 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)참고사항
전달하기 전에 두 값을 모두 사전 해시 처리(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 이전
메소드 시그니처
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 이후
메소드 시그니처
public abstract void setUserEmail(String email);사용 예시
AppsFlyerLib.getInstance().setUserEmail("name@domain.com");참고 사항
v7.0.1 및 이후 버전에서는 호출당 단 하나의 이메일만 허용됩니다. 다중 이메일은 지원되지 않습니다. setUserEmail을 다시 호출하면 기존에 설정된 값을 추가하는 대신 덮어씁니다.
S2S 참조 및 코드 샘플
S2S를 통해 오디언스용 식별자를 전송할 때, 해시된 이메일 주소를 포함한 모든 식별자에 custom_data 파라미터를 사용하세요. 하나 이상의 식별자를 발송할 수 있습니다.
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\"
}
}참고 문서
- 오디언스 파트너 연결
- 오디언스 사용자 식별자 정책