OAID

Visão Geral

Colete o Android Open Anonymous Device Identifier (OAID) para atribuir instalações de lojas de aplicativos Android de terceiros.

O OAID é um identificador exclusivo reconfigurável pelo usuário para dispositivos Android. Ele foi apresentado pela Mobile Security Alliance (MSA), pelo China Information and Communication Research Institute e pelos fabricantes de dispositivos, como uma alternativa de preservação da privacidade para identificadores de dispositivos não redefiníveis, como o IMEI.

Integração

Requer o SDK da AppsFlyer V5.4.0+

A integração do OAID consiste em 3 etapas:

• Integrating the AppsFlyer SDK in the build.gradle file of your project
• Integrating the AppsFlyer OAID plugin module in the build.gradle file of your project

dependencies {
  implementation 'com.appsflyer:af-android-sdk:6.9.4'
  implementation 'com.appsflyer:oaid:6.9.0'
}

• Integrating an SDK to generate and provide the OAID (either the MSA SDK or Huawei HMS SDK)
• Add the ProGuard rules to protect the necessary classes and interfaces from the MSA and various device manufacturers.

Observação:

• Para aplicativos que serão usados na China, o MSA SDK deve ser usado.
• Para aplicativos que serão usados globalmente em dispositivos Huawei, a biblioteca Huawei HMS deve ser usada.

MSA SDK integration

Para integrar o MSA SDK:

1. Obtenha do profissional de marketing: o arquivo MSA SDK (aar) e o certificado que precisa ser integrado ao aplicativo.
   1. Copie o MSA SDK (aar) na pasta libs.
   2. Copie e cole supplierconfig.json na pasta de ativos do projeto e faça as alterações necessárias, como atualizar o appid do seu app em cada uma das lojas.
   3. Copie e cole o arquivo do certificado (nome do pacote.cert.pem) na pasta de ativos do projeto.
   4. Veja as instruções completas no site da MSA
2. Atualize o arquivo build.gradle do seu projeto da seguinte forma:

implementation 'com.appsflyer:af-android-sdk:6.9.4'
implementation 'com.appsflyer:oaid:6.9.0'
implementation files('libs/oaid_sdk_2.0.0.aar')

Huawei HMS SDK integration

Para integrar o Hauwei HMS SDK:

1. Adicione o repositório maven da Huawei da seguinte forma:

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

2. Atualize o arquivo build.gradle do seu aplicativo da seguinte forma:

dependencies {
  implementation 'com.appsflyer:af-android-sdk:6.9.4'
  implementation 'com.appsflyer:oaid:6.9.0'
  implementation 'com.huawei.hms:ads-identifier:3.4.56.300'
}

ProGuard rules update (when using ProGuard)

Protect the necessary classes and interfaces from MSA and various device manufacturers.

Adicione o seguinte código ao seu arquivo proguard-rules.pro file:

# sdk
-keep class com.bun.miitmdid.** { *; }
-keep interface com.bun.supplier.** { *; }
# asus
-keep class com.asus.msa.SupplementaryDID.** { *; }
-keep class com.asus.msa.sdid.** { *; }
# freeme
-keep class com.android.creator.** { *; }
-keep class com.android.msasdk.** { *; }
# huawei
-keep class com.huawei.hms.ads.** { *; }
-keep interface com.huawei.hms.ads.** {*; }
# lenovo
-keep class com.zui.deviceidservice.** { *; }
-keep class com.zui.opendeviceidlibrary.** { *; }
# meizu
-keep class com.meizu.flyme.openidsdk.** { *; }
# nubia
-keep class com.bun.miitmdid.provider.nubia.NubiaIdentityImpl
{ *; }
# oppo
-keep class com.heytap.openid.** { *; }
# samsung
-keep class com.samsung.android.deviceidservice.** { *; }
# vivo
-keep class com.vivo.identifier.** { *; }
# xiaomi
-keep class com.bun.miitmdid.provider.xiaomi.IdentifierManager
{ *; }
# zte
-keep class com.bun.lib.** { *; }
# coolpad
-keep class com.coolpad.deviceidsupport.** { *; }

Informações adicionais

Opting out of OAID collection

Para desativar a coleta de OAID, use uma das seguintes APIs:

• setCollectOAID da seguinte forma:

AppsFlyerlib.setCollectOaid(false);

• setDisableAdvertisingIdentifiers da seguinte forma:

AppsFlyerlib.setDisableAdvertisingIdentifiers(true);

Setting OAID manually

Para definir manualmente o OAID no SDK da AppsFlyer:

• Use a API setOaidData da seguinte forma:

AppsFlyerlib.setOaidData(oaid);