Instructions d’intégration du Kit de développement logiciel (SDK) Android

Cette page décrit comment intégrer notre KIT de développement logiciel (SDK) à votre projet.

Pour obtenir des instructions sur l’affichage des différents types d’annonces, consultez :

• Afficher les bannières sur Android
• Afficher les interstitiels sur Android

Suivez les instructions de cette section pour configurer notre Kit de développement logiciel (SDK) afin d’afficher des publicités dans votre application.

Configuration requise

Ce SDK nécessite Android 4 ou version ultérieure, et android SDK version 14 ou ultérieure.

Pour afficher des publicités, vous devez disposer d’un ID de placement Xandr valide. Il s’agit d’un ID numérique qui représente un contexte dans une application où des publicités peuvent être affichées.

Installation

Étape 1. Obtenir le Kit de développement logiciel (SDK)

Installez via Maven à partir de votre build.gradle fichier, comme indiqué ci-dessous. Notez que la [9,10) notation signifie que lorsque votre application est compilée, la dernière version du Kit de développement logiciel (SDK) de la série de versions 9.x est incluse. Lorsque nous publions une nouvelle version du Kit de développement logiciel (SDK), il vous suffit de recompiler votre application pour obtenir la nouvelle version. Si vous souhaitez inclure des adaptateurs de médiation pour d’autres Kits de développement logiciel (SDK) dans votre build.gradle, consultez la section Laissez-nous effectuer la médiation d’autres réseaux de médiation avec Android.

// Android: Gradle config to install the SDK
repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.appnexus.opensdk:appnexus-sdk:[9,10)'
}
   

Étape 2. Modifier les autorisations de l’application (facultatif)

Modifiez votre manifeste Android pour inclure les autorisations suivantes (facultatives mais recommandées) :

<!-- Android: XML to include recommended permissions -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android">

<!-- Add the permissions here... -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

• ACCESS_COARSE_LOCATION (recommandé) : accorde au SDK l’autorisation d’accéder à l’emplacement approximatif en fonction de la tour de cellule.
• ACCESS_FINE_LOCATION (recommandé) : accorde au SDK l’autorisation d’accéder à un emplacement plus précis en fonction du GPS.

Bien qu’elles ne soient pas requises techniquement, les autorisations d’emplacement permettent au SDK d’envoyer des données basées sur l’emplacement aux annonceurs. L’envoi de données d’emplacement plus performantes conduit généralement à une meilleure monétisation.

Étape 3. Modifier les paramètres ProGuard

Si votre application utilise ProGuard, vous devez modifier vos paramètres ProGuard pour éviter de supprimer Google Play de votre application. Le SDK ne nécessite pas google Play pour fonctionner, mais vous perdrez l’accès à l’ID d’annonceur Android (AAID), qui est utilisé pour le ciblage des applications et la limitation de la fréquence. Modifiez le fichier de proguard-project.txt votre projet pour ajouter les éléments suivants :

### Proguard settings to support Android Advertiser ID
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
    com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
    java.lang.String getId();
    boolean isLimitAdTrackingEnabled();
}     

Étape 4. Configurer pour la médiation (facultatif)

Pour obtenir des instructions sur la configuration de la médiation, consultez Médiation avec Android.

Remarque d’implémentation : Rappels de cycle de vie de transfert

Le Kit de développement logiciel (SDK) vous permet de transférer les rappels de cycle de vie pour les sous-classes de AdView: BannerAdView et InterstitialAdView.

Le transfert des rappels de cycle de vie est fortement recommandé pour de meilleures performances. Pour toute personne qui médiatise des bannières AdMob/DFP, il est obligatoire qu’elles soient appelées, car nous devons transférer les rappels de cycle de vie à la bannière AdMob/DFP comme ils l’exigent. Consultez l’exemple de code ci-dessous pour plus d’informations sur les méthodes à appeler et quand.

Pour plus d’informations sur les cycles de vie des activités, consultez Gestion du cycle de vie de l’activité dans la documentation Android.

    /**
     * To be called by the developer when the fragment/activity's onDestroy() function is called.
     */
    abstract public void activityOnDestroy();

    /**
     * To be called by the developer when the fragment/activity's onPause() function is called.
     */
    abstract public void activityOnPause();

    /**
     * To be called by the developer when the fragment/activity's onResume() function is called.
     */
    abstract public void activityOnResume(); 

Voir aussi

• Afficher les bannières
• Afficher les interstitiels