OAID 플러그인 연동
OAID는 Android 기기의 고유 식별자입니다. MSA는 중국에서 제조되는 모든 기기가 OAID를 제공할 것을 권고하고 있습니다. Google Play Services를 이용할 수 없는 지역에서는 OAID를 사용하여 기기를 어트리뷰션하고 트래킹할 수 있습니다.
OAID 플러그인은 기기의 OAID를 제공합니다. SDK는 OAID와 기타 ID를 계속 사용합니다. OAID는 MSA SDK를 사용하는 모든 기기 또는 Huawei Mobile Service (HMS) Core SDK 를 사용하는 화웨이 기기에서 읽을 수 있습니다.
본 플러그인을 사용하기 전, 플랫폼에 해당하는 시작하기 가이드의 내용을 참조하시기 바랍니다.
앱에 OAID 플러그인 추가하기
앱에 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
디렉토리에 복사하고 디펜던시를 설정합니다. 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.62.300' }
Proguard 설정
앱이 Google Play Store를 타겟팅하지 않는 경우, 시작 가이드에 나온 규칙을 모두 추가하지 않아도 됩니다. Google Play Services와 설치 리퍼러 라이브러리에 관련된 규칙은 삭제할 수 있습니다. 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()
메서드를 호출합니다.