OAID(Open Anonymous Device Identifier)는 Android 기기의 고유 식별자입니다. MSA(Mobile Security Alliance)는 중국에서 제조되는 모든 기기가 OAID를 제공할 것을 권고하고 있습니다. Google 플레이 서비스를 이용할 수 없는 지역에서는 OAID를 사용하여 기기를 어트리뷰션 및 측정할 수 있습니다.
OAID 플러그인은 기기의 OAID를 제공합니다. SDK는 OAID와 기타 ID를 계속 사용합니다. OAID는 MSA SDK를 사용하는 모든 기기 또는 HMS(Huawei Mobile Service) Core SDK를 사용하는 Huawei 기기에서 읽을 수 있습니다.
앱에 플러그인 추가
Maven
Maven을 사용하는 경우, build.gradle
파일에 다음의 디펜던시를 추가하시기 바랍니다.
dependencies { implementation 'com.adjust.sdk:adjust-android:4.38.5' implementation 'com.adjust.sdk:adjust-android-oaid:4.38.5'}
Huawei OAID 측정의 경우 개발자 리포지토리 및 추가 디펜던시를 추가해야 합니다.
- 프로젝트의
build.gradle
파일에 다음을 추가합니다.
allprojects { repositories { maven { url 'https://developer.huawei.com/repo/' } mavenCentral() }
- 다음을 앱 수준
build.gradle
파일에 추가합니다.
dependencies { implementation 'com.adjust.sdk:adjust-android:4.33.4' implementation 'com.adjust.sdk:adjust-android-oaid:4.33.4' implementation 'com.huawei.hms:ads-identifier:3.4.62.300'}
독립 실행형 바이너리(standalone binary) 설치
릴리스 페이지에서 플러그인을 독립 실행형 바이너리로 추가하는 것도 가능합니다.
앱에 MSA SDK 추가하기
요구 사항
MSA SDK 버전 | Adjust OAID 플러그인 버전 |
---|---|
v1.0.10+ | v4.19.0+ |
v1.0.12+ | v4.22.0+ |
v1.0.13+ | v4.23.0+ |
v1.0.23+ | v4.24.1+ |
v1.0.25+ | v4.27.0+ |
v1.0.26+ | v4.28.4+ |
v1.1.0+ | v4.28.9+ |
v2.0.0+ | v4.33.0+ |
MSA SDK로부터 OAID 값을 읽기 위해 OAID 플러그인을 활성화하려면 이를 프로젝트에 추가해야 합니다. 다음을 설정하시기 바랍니다:
- MSA SDK(AAR 파일)를 프로젝트의
libs
디렉토리에 복사하고 dependency를 설정합니다. supplierconfig.json
파일을 프로젝트의assets
디렉토리에 복사합니다.- MSA SDK에 관한 자세한 내용과 설명은 MSA 웹사이트에서 확인하실 수 있습니다.
HMS Core SDK를 앱에 추가합니다.
HMS Core SDK를 사용하여 Huawei 기기의 OAID에 액세스할 수 있습니다. Adjust OAID 플러그인이 HMS Core SDK에서 값을 읽을 수 있게 하려면 build.gradle
을 다음과 같이 업데이트합니다.
- Huawei maven 리포지토리를 추가합니다.
repositories { maven { url "https://developer.huawei.com/repo/" }}
- HMS Core SDK를 추가합니다.
dependencies { implementation 'com.huawei.hms:ads-identifier:3.4.56.300'}
Proguard 설정
앱이 Google 플레이 스토어를 타겟으로 하지 않는 경우 Android 시작 가이드에 나온 규칙을 모두 추가하지 않아도 됩니다. Google 플레이 서비스와 설치 리퍼러 라이브러리에 관련된 규칙은 삭제할 수 있습니다. Adjust SDK에 적용되는 규칙만 유지하면 됩니다.
-keep public class com.adjust.sdk.** { *; }
MSA SDK AAR을 디펜던시로 추가하는 경우 다음 규칙을 추가하시기 바랍니다.
-keep class com.bun.miitmdid.core.** { *; }
플러그인 사용하기
플러그인 설정이 완료되면 기기의 OAID를 수집할 수 있습니다. Adjust SDK를 시작하기 전에 AdjustOaid.readOaid(applicationContext)
메서드를 호출합니다.
SDK가 OAID를 읽는 것을 방지하려면 AdjustOaid.doNotReadOaid()
메서드를 호출합니다.