OAID

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 측정의 경우 개발자 리포지토리 및 추가 디펜던시를 추가해야 합니다.

1. 프로젝트의 build.gradle 파일에 다음을 추가합니다.

allprojects {
    repositories {
        maven {
            url 'https://developer.huawei.com/repo/'
        }
    mavenCentral()
    }

2. 다음을 앱 수준 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로부터 OAID 값을 읽기 위해 OAID 플러그인을 활성화하려면 이를 프로젝트에 추가해야 합니다. 다음을 설정하시기 바랍니다:

1. MSA SDK(AAR 파일)를 프로젝트의 libs 디렉토리에 복사하고 dependency를 설정합니다.
2. supplierconfig.json 파일을 프로젝트의 assets 디렉토리에 복사합니다.
3. MSA SDK에 관한 자세한 내용과 설명은 MSA 웹사이트에서 확인하실 수 있습니다.

HMS Core SDK를 앱에 추가합니다.

HMS Core SDK를 사용하여 Huawei 기기의 OAID에 액세스할 수 있습니다. Adjust OAID 플러그인이 HMS Core SDK에서 값을 읽을 수 있게 하려면 build.gradle을 다음과 같이 업데이트합니다.

1. Huawei maven 리포지토리를 추가합니다.

repositories {
  maven {
      url "https://developer.huawei.com/repo/"
  }
}

2. 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() 메서드를 호출합니다.