Démarrer avec Android

Audience Network sert désormais uniquement aux enchères

Désormais, Audience Network utilise uniquement les enchères pour placer les publicités dans les applications iOS et Android. Afin de bénéficier de la monétisation pour vos applications avec Audience Network, vous devrez abandonner le système de cascade au profit des enchères.

Pour en savoir plus, consultez notre publication de blog d’Audience Network.

Meta Audience Network vous permet de monétiser vos applications Android avec des publicités Facebook. Ce guide vous explique en détail comment intégrer le SDK.

Conditions requises

Assurez-vous d’avoir installé Android Studio.

Consultez la section correspondant à la version minimale du système d’exploitation prise en charge par le SDK Audience Network de la rubrique Questions/réponses.

Étape 1 : Création d’un projet

Étape 2 : Intégration du SDK

Étape 3 : Mode d’erreur d’intégration (facultatif)

Étape 1 : Création d’un projet

Si vous disposez déjà d’un projet auquel intégrer Audience Network, vous pouvez ignorer cette étape.

Démarrez Android Studio et sélectionnez Start a new Android Studio Project (Démarrer un projet Android Studio)



Attribuez un nom à votre projet et indiquez le domaine de votre entreprise.
Le nom du package correspondra à votre identifiant si vous décidez d’importer votre application dans Google Play Store.



Indiquez la version minimale de votre Android SDK. Audience Network requiert l’API 15 ou ultérieure, mais dans le cadre de
ces exemples, nous allons utiliser l’API 21.



Ajoutez une activité vide (Empty Activity) à votre projet



Attribuez-lui un nom et cliquez sur Finish (Terminer).

Étape 2 : Intégration du SDK

Le SDK Audience Network est inclus dans le SDK Facebook. Suivez les étapes ci-dessous pour le télécharger et l’intégrer à votre projet :

Avec Gradle



Ajoutez l’instruction compile suivante au fichier build.gradle au niveau de l’application (et non du projet !) afin d’utiliser la dernière version du SDK Audience Network :

dependencies {
compile 'com.facebook.android:audience-network-sdk:6.+'
}

En cas de difficultés pour résoudre le SDK Audience Network, assurez-vous d’avoir synchronisé le fichier Gradle, puis redémarrez Android Studio.

Installation manuelle (non recommandée)

Si vous utilisez Intellij IDEA ou Eclipse, téléchargez le SDK Audience Network pour Android et décompressez-le. Dans le dossier AudienceNetwork/bin, copiez le fichier AudienceNetwork.aar et placez-le dans le dossier /libs de votre projet. Vous devrez peut-être créer le répertoire s’il n’existe pas déjà. Ajoutez ensuite les lignes suivantes dans le fichier build.gradle de votre application :

repositories {
flatDir {
dirs 'libs'
}
}

dependencies {
...
compile(name: 'AudienceNetwork', ext: 'aar')
}

Si vous utilisez AudienceNetwork.jar pour votre projet, dans le dossier AudienceNetwork/bin, renommez AudienceNetwork.aar en AudienceNetwork.zip, extrayez le fichier classes.jar et renommez-le en AudienceNetwork.jar, placez le fichier AudienceNetwork.jar dans le dossier /libs de votre projet. Vous devrez peut-être créer le répertoire s’il n’existe pas déjà. Assurez-vous que l’UI de votre IDE reflète cette modification. Si vous utilisez Intellij IDEA ou Eclipse, faites un clic droit sur le fichier libs/AudienceNetwork.jar et choisissez Add as Library (Ajouter en tant que bibliothèque).

Bien que cela ne soit pas obligatoire, nous vous recommandons de configurer votre projet de manière qu’il fonctionne avec les services Google Play comme indiqué sur cette page. Le SDK Audience Network pourra alors récupérer plus efficacement l’ID de publicités.

Étape 3 : Mode d’erreur d’intégration (facultatif)

Lorsque vous intégrez le SDK Audience Network, vous pouvez utiliser le paramètre du mode d’erreur d’intégration pour vous assurer que votre intégration fonctionne comme prévu. Plus spécifiquement, cette méthode vous permet de contrôler le comportement du SDK en cas d’utilisation incorrecte.

  • INTEGRATION_ERROR_CRASH_DEBUG_MODE : l’application plante si votre version comporte Android FLAG_DEBUGGABLE, sinon INTEGRATION_ERROR_CALLBACK_MODE est utilisé (recommandé lors des tests).
  • INTEGRATION_ERROR_CALLBACK_MODE : l’application procède au rappel AdListener.onError(Ad, AdError) en cas de détection d’une erreur d’intégration.
// Example for setting the SDK to crash when in debug mode
AdSettings.setIntegrationErrorMode(INTEGRATION_ERROR_CRASH_DEBUG_MODE);

Étapes suivantes