OAID 플러그인 연동

OAID는 Android 기기의 고유 식별자입니다. MSA는 중국에서 제조되는 모든 기기가 OAID를 제공할 것을 권고하고 있습니다. Google Play Services를 이용할 수 없는 지역에서는 OAID를 사용하여 기기를 어트리뷰션하고 트래킹할 수 있습니다.

OAID 플러그인은 기기의 OAID를 제공합니다. SDK는 OAID와 기타 ID를 계속 사용합니다. OAID는 MSA SDK를 사용하는 모든 기기 또는 Huawei Mobile Service (HMS) Core SDK 를 사용하는 화웨이 기기에서 읽을 수 있습니다.

본 플러그인을 사용하기 전, 플랫폼에 해당하는 시작하기 가이드의 내용을 참조하시기 바랍니다.

앱에 OAID 플러그인 추가하기

Maven

Android

독립 실행형 바이너리(standalone binary) 설치

멀티플 플랫폼

플러그인을 Prefab으로 사용하기

Unity

앱에 MSA SDK 추가하기

참고:
Huawei 기기에서 OAID 값을 읽는 경우 MSA SDK를 추가할 필요가 없습니다. 이 경우 OAID 플러그인은 HMS Core 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 플러그인을 활성화하려면 이를 프로젝트에 추가해야 합니다. 다음을 설정하시기 바랍니다:

  1. MSA SDK(AAR 파일)를 프로젝트의 libs 디렉토리에 복사하고 디펜던시를 설정합니다.
  2. supplierconfig.json 파일을 프로젝트의 assets 디렉토리에 복사합니다.

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.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) 메서드를 호출하시기 바랍니다.

JavaAndroid
C#Unity
AdjustOaid.readOaid(applicationContext);

// ...

Adjust.onCreate(config);

SDK가 OAID를 읽는 것을 차단하려면 AdjustOaid.doNotReadOaid() 메서드를 호출합니다.

JavaAndroid
C#Unity
AdjustOaid.doNotReadOaid();