OAID

Vue d'ensemble

Pour récupérer l'OAID (Open Anonymous Device Identifier) Android afin d'attribuer les installations issues des app stores Android tiers.

L'OAID est un identifiant unique pour appareil Android que l'utilisateur peut réinitialiser. Il a été introduit par la Mobile Security Alliance (MSA), l'Institut chinois de recherche sur l'information et la communication ainsi que les fabricants d'appareils pour offrir une autre solution de protection de la vie privée aux ID d'appareils non réinitialisables, comme l'IMEI.

Intégration

Requiert le SDK AppsFlyer V5.4.0 et +.

L'intégration OAID se fait en 3 étapes :

• 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.

Remarque :

• Pour les apps destinées à être utilisées en Chine, c'est le SDK MSA qui doit être utilisé.
• Pour les apps destinées à être utilisées dans le reste du monde sur des appareils Huawei, c'est la bibliothèque HMS de Huawei qui doit être utilisée.

MSA SDK integration

Pour intégrer le SDK MSA:

1. À récupérer auprès du marketeur : le fichier MSA SDK (aar) ainsi que le certificat qui devra être intégré à l'application.
   1. Copiez le MSA SDK (aar) dans le dossier libs.
   2. Copiez et collez supplierconfig.json dans le dossier assets du projet et effectuez les changements requis, par exemple la mise à jour de l'appid de votre app dans chacun des stores.
   3. Copiez et collez le fichier du certificat (bundle name.cert.pem) dans le dossier assets du projet.
   4. Vous pouvez les instructions complètes sur le site web de la MSA
2. Mettez à jour le fichier build.gradle de votre projet comme suit :

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

Pour intégrer le SDK HMS Huawei :

1. Ajoutez le répertoire maven Huawei comme indiqué ci-dessous :

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

2. Mettez à jour le fichier build.gradle de votre application comme suit :

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.

Add the following code to your 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.** { *; }

Informations supplémentaires

Opting out of OAID collection

Pour refuser la collecte de l'OAID, utilisez l'une des API suivantes :

• setCollectOAID comme suit :

AppsFlyerlib.setCollectOaid(false);

• setDisableAdvertisingIdentifiers comme suit :

AppsFlyerlib.setDisableAdvertisingIdentifiers(true);

Setting OAID manually

Pour définir manuellement l'OAID dans le SDK AppsFlyer :

• Utilisez l'API setOaidData comme suit :

AppsFlyerlib.setOaidData(oaid);