OAID plugin

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를 사용하는 화웨이 기기에서 읽을 수 있습니다.

앱에 플러그인 추가

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

배포 페이지에서 플러그인을 독립 실행형 바이너리로 추가하는 것도 가능합니다.

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

Unity 앱에서 OAID 플러그인을 Prefab으로 로딩할 수 있습니다. 독립 실행형 바이너리는 이 정보가 포함된 Prefab 폴더를 포함하고 있습니다.

OAID 플러그인을 Prefab으로 로딩하기

1. Prefab을 AdjustOaid/Prefab 폴더에 담습니다.
2. Start Manually 옵션 선택을 해제합니다.
3. Read Oaid 옵션을 선택합니다.

앱에 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.62.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) 메서드를 호출합니다.

1
AdjustOaid.ReadOaid();
2
// ...
3
Adjust.start(config);

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

1
AdjustOaid.DoNotReadOaid();