한눈에 보기: 광고 파트너에게 커스텀 오디언스를 보내기 위해 추가 유저 식별자를 설정합니다.
추가 식별자에 대하여
앱스플라이어 오디언스는 커스텀 오디언스를 광고 파트너에게 전송하기 위해 다음과 같은 디바이스 식별자를 자동으로 지원합니다.
- iOS : IDFA
- 안드로이드 (구글 플레이): GAID
- 안드로이드 (타사 앱 스토어): OAID 및 IMEI
일부 광고 파트너는 추가 유저 식별자를 기반으로 한 커스텀 오디언스 매칭도 지원합니다. 오디언스에서는 앱스플라이어 SDK 또는 S2S 모바일 API를 통해 특별히 구성하는 경우 이러한 식별자를 활용할 수 있는 옵션을 제공합니다.
이러한 추가 식별자에는 전화번호와 이메일이 포함될 수 있으며, SHA256 해싱으로 암호화된 경우에만 사용할 수 있습니다. 이러한 추가 식별자를 사용할 때는 추가 식별자 이용약관의 적용을 받습니다.
다음 단계
- 사용 가능한 식별자 표에서 사용하려는 추가 식별자를 선택하세요 . 모든 광고 파트너가 모든 식별자를 지원하는 것은 아닙니다.
- 개발자 — 선택한 식별자를 구성하세요:
- 사용 가능한 식별자의 표에 나타난 파라미터 및 형식 요구 사항
- SDK 및 >S2S 참조 및 코드 샘플
- 오디언스 대시보드에서:
- 계정 수준의 유저 식별자 정책을 설정하세요.
- 각 파트너 연결에 업로드할 식별자를 선택하세요.
사용 가능한 식별자
아래 표에 표시된 대로, 하나 이상의 식별자를 구성할 수 있습니다.
추가 식별자 — 파라미터 및 형식
| 식별자 | 파라미터 이름 | 형식 | 예시 값 (해싱 전) |
|---|---|---|---|
| 이메일 주소 | 이메일_sha256 |
SDK v7.0.0 및 이전 버전:
SDK v7.0.1 이상: 일반 텍스트. SDK는 자동으로 정규화하고 해시합니다. |
이름@도메인.com |
| 전화번호 (아래 참고사항 참조) |
v7.0.0 및 이전 버전 (또는 S2S): 전화_번호_sha256 v7.0.1 이상: 전화번호_해시됨 |
v7.0.0 및 이전 버전 (또는 S2S):
v7.0.1 이상: 일반 텍스트. SDK는 국가 코드와 번호를 연결하고, 정규화하고, 자동으로 해시합니다. |
442070313000 |
|
전화번호 E164 (아래 참고사항 참조) |
v7.0.0 이하 (또는 S2S): 전화_번호_e164_sha256 v7.0.1 이상: 전화_번호_e164_해시드 |
v7.0.0 및 이전 버전 (또는 S2S):
v7.0.1 이상: 일반 텍스트. SDK는 국가 코드와 번호를 연결하고, 정규화하고, 자동으로 해시합니다. |
+442070313000 |
참고 사항광고 파트너마다 지원하는 전화번호 형식이 다릅니다. 따라서 전화번호를 사용하기로 선택한 경우 두 가지 식별자를 모두 설정하세요. 전화번호 및 전화번호 E164. | |||
SDK 참조 및 코드 샘플
SDK를 통해 오디언스 식별자를 발송할 때:
- 해시된 이메일 주소 또는 전화번호 이외의 식별자에는 을 사용하십시오.
setAdditionalData - 해시된 이메일 주소의 경우 을 사용하세요.
- SDK 버전 7.0.1 이상: 사용하십시오.
setUserEmail - SDK v7.0.0 및 이전 버전: 사용하십시오.
setUserEmails
- SDK 버전 7.0.1 이상: 사용하십시오.
- 해시된 전화번호의 경우:
- SDK v7.0.1 이상: 사용
setUserPhone(권장). - SDK v7.0.0 및 이전 버전: 커스텀 데이터와 함께 사용합니다.
setAdditionalData
- SDK v7.0.1 이상: 사용
참고 사항
다음과 같은 버전에 따른 변경 사항을 유념하라.
-
이메일 : SDK v7.0.1부터
setUserEmails(iOS/안드로이드) 가 완전히 제거되고 로 대체되었습니다.setUserEmail이는 지원 중단이 아니라 주요 변경 사항입니다. v7.0.0 및 이전 버전의 앱은 계속 사용해야 합니다.setUserEmailsv7.0.1 이상의 앱은 로 전환해야 합니다.setUserEmail팔로우할 샘플을 선택하기 전에 통합 SDK 버전을 확인하세요. -
phone SDK v7.0.1부터 전용 API를 사용할
setUserPhone수 있습니다. 어드밴스드 매칭을 위해 전화번호 식별자를 보내는 권장 방법입니다. 이것은 주요 변경 사항이 아닙니다.setAdditionalData여전히 작동합니다. 새로운 통합의 경우 및 v7.0.1 이상으로 업그레이드하는 고객의 경우 로 마이그레이션하는 것이 좋습니다.setUserPhonev7.0.0 및 이전 버전의 앱은 해당 SDKsetAdditionalData버전에setUserPhone존재하지 않으므로 계속 사용해야 합니다.
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];let customData: Dictionary = [
"audiences" : [
"phone_number_sha256":"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
"phone_number_e164_sha256":"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
]
]
AppsFlyerLib.shared().customData = customData참고
두 값 (SHA-256) 을 모두 전달하기 전에 미리 해시해야 합니다.
SDK v7.0.1 이상 — 사용자 폰 설정 (권장)
| 메서드 서명 | |
| 사용 예시 | |
참고
국가 전화 코드 및 지역 번호를 일반 텍스트로 전달합니다. 지역 번호에는 기호와 공백이 허용됩니다. SDK는 두 값을 모두 로컬로 연결, 정규화 및 해시합니다 (SHA-256). 미리 해시하지 마세요.
추가 유저 식별자로 해시된 이메일 주소를 설정하려면:
SDK v7.0.0 및 이전 버전
| 메서드 서명 | |
| 사용 예시 | |
SDK v7.0.1 이상
| 메서드 서명 | |
| 사용 예시 | |
참고
일반 텍스트 이메일을 전달하세요. SDK는 이를 로컬에서 정규화하고 해시합니다 (SHA-256). 미리 해시하지 마세요. 통화당 하나의 이메일만 수락됩니다. setUserEmail 다시 전화를 걸면 이전에 설정한 값에 값을 더하지 않고 무시합니다.
안드로이드 SDK 설정
추가 유저 식별자로 해시된 전화번호를 설정하려면:
SDK v7.0.0 and earlier — 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)참고
두 값 (SHA-256) 을 모두 전달하기 전에 미리 해시해야 합니다.
SDK v7.0.1 이상 — 사용자 폰 설정 (권장)
| 메서드 서명 | |
| 사용 예시 | |
참고
국가 전화 코드 및 지역 번호를 일반 텍스트로 전달합니다. SDK는 두 값을 모두 로컬로 연결, 정규화 및 해시합니다 (SHA-256). 미리 해시하지 마세요.
추가 유저 식별자로 해시된 이메일 주소를 설정하려면:
SDK v7.0.0 및 이전 버전
| 메서드 서명 | |
| 사용 예시 | |
SDK v7.0.1 이상
| 메서드 서명 | |
| 사용 예시 | |
참고
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\"
}
}
참고 항목