Cette page a été traduite par l'API Cloud Translation.

Implémentation native d'APR pour Android

Le SDK Google Mobile Ads accepte également les styles de recherche personnalisés. Si votre application utilise déjà le SDK Google Mobile Ads, nous vous recommandons d'utiliser Version du SDK APRMA à la place.

Si vous effectuez une mise à niveau vers la version 19.0.0 ou une version plus récente à partir de la version 18.1.0 ou antérieure, consultez consultez notre guide de migration.

Prérequis

Dans ce guide d'implémentation, nous partons du principe que vous connaissez bien les éléments suivants:

Annonces AdSense pour les recherches personnalisées avec des styles d'annonces AdSense pour les recherches personnalisées
Développement d'applications Android

Importer le SDK natif AFS

Ajouter le SDK

Pour ajouter le SDK AFS Native à votre application, procédez comme suit :

Ouvrez le fichier build.gradle dans le répertoire de votre module d'application. Ajoutez une règle de compilation sous dependencies pour la dernière version du SDK :

dependencies {
  implementation 'com.google.android.gms:play-services-afs-native:19.1.0'
}

Assurez-vous que votre build.gradle de niveau supérieur contient une référence au dépôt google() ou à maven { url "https://maven.google.com" }.

Suivez ces instructions. pour inclure le plug-in Google Play Standalone Version Matcher dans votre projet. L'application de ce plug-in entraîne une erreur de compilation Gradle lorsque le SDK natif AFS est utilisé avec une version incompatible des services Google Play. Au lieu de permettre la compilation de l'application, il peut entraîner des plantages d'exécution. Vous pouvez également appliquer la failOnVersionConflict() ResolutionStrategy à votre projet pour provoquer une erreur de compilation lorsque des versions incompatibles de Google Play sont compatibles. Les services sont utilisés dans votre projet. Enregistrez les modifications, puis cliquez sur Sync Project with Gradle Files (Synchroniser le projet avec les fichiers Gradle) dans la barre d'outils.

Utiliser AndroidX au lieu des bibliothèques Android Support

À partir de la version 17.0.0 du SDK, votre application doit utiliser Jetpack (AndroidX) au lieu des bibliothèques Android Support. Configuration requise:

Définissez com.android.tools.build:gradle sur la version 3.2.1 ou ultérieure.
Définissez compileSdkVersion sur 28 ou une version ultérieure.
Mettez à jour votre application pour qu'elle utilise Jetpack (AndroidX). Suivez les instructions de la section Migrer vers AndroidX.

Classes

Pour diffuser des annonces natives APR dans votre application, implémentez les classes suivantes:

SearchAdController

Cette classe permet de demander des annonces de manière asynchrone, de mettre en cache et la récupération et l'affichage des annonces.
Chaque contexte d'annonce nécessite un SearchAdController distinct. Par exemple, si vous un écran affichant des annonces à côté d'une liste de résultats de recherche qui affiche des annonces et des informations sur un produit spécifique, créer deux instances distinctes de SearchAdController, une pour chaque cas.
Le constructeur doit fournir le code de votre site Web (référence éditeur), ID de style auquel appliquer les annonces renvoyées, et SearchAdOptions. Le Context fourni dans le constructeur doit être le Activity qui contient le SearchAdController et où vous allez placer l'annonce View.
Appelez loadAds pour indiquer une nouvelle recherche utilisateur et lancer une requête d'annonce asynchrone. Toutes les annonces chargées à partir d'appels précédents à loadAds sont effacées de le cache interne d'annonce lorsqu'un nouvel appel est effectué.
Créez un View avec createAdView pour afficher des créations publicitaires.
Une fois les annonces chargées, appelez populateAdView avec un View généré précédemment avec createAdView pour afficher une annonce mise en cache dans ce View. En plus des View, qui doit être renseigné, fournissez un adKey, une chaîne arbitraire à identifier l'annonce de façon unique. Cela associe la création publicitaire spécifique renvoyée à partir du cache à cette adKey. Ainsi, lorsque la même adKey est transmise à un futur appel à populateAdView, la même annonce est renvoyée. Par exemple, si populateAdView est appelé pour la première fois avec adKey="keyA" et affiche une annonce pour des chaussures de randonnée, chaque appel ultérieur à populateAdView avec adKey="keyA" remplira la même annonce pour des chaussures de randonnée. (Lorsque vous appelez loadAds efface toutes les annonces mises en cache et les clés d'annonce associées.

SearchAdOptions

Transmettez cet objet au constructeur SearchAdController pour personnaliser la façon dont les annonces sont demandées et affichées. Appelez build() sur un SearchAdOptions.Builder pour Créez un objet SearchAdOptions.

View

Créez un objet View pour mettre en attente les annonces en appelant createAdView() au niveau du SearchAdController Affiche au maximum une annonce à la fois, mais le même View peut être réutilisé pour diffuser différentes annonces au fil du temps.

SearchAdRequest

Appelez la méthode loadAds sur SearchAdController avec un SearchAdRequest pour lancer une requête d'annonce asynchrone. Appeler build() sur un SearchAdRequest.Builder pour créer un objet SearchAdRequest.

AdListener

Implémentez cette interface et transmettez-la au constructeur SearchAdController pour enregistrer des rappels pour plusieurs états.
Remarque: Les rappels AdListener ne seront pas appelés sur une requête annulée (un appel à loadAds qui a été préempté par un autre appel à loadAds avant la première appel résolu).

Exemple d'implémentation

L'exemple ci-dessous montre comment créer un SearchAdController dans un exemple de Activity.

//  MainActivity.java implementation
//  (MainActivity is a subclass of Activity)

SearchAdController adController;
// adContainer where we will place our ads in this example.
ViewGroup adContainer;

protected void onCreate(Bundle bundle){
  super.onCreate(bundle);
  adContainer = (ViewGroup) findViewById(...);
  // Specify ad options (not required).
  SearchAdOptions.Builder adOptionsBuilder = new SearchAdOptions.Builder();
  adOptionsBuilder.setAdType(SearchAdOptions.AD_TYPE_TEXT);
  adOptionsBuilder.setPrefetch(true);
  adOptionsBuilder.setNumAdsRequested(3);
  // Provide a callback to trigger when ads are loaded.
  AdListener adListener = new AdListener() {
    public void onAdLoaded() {
      createAndShowAd();
    }
  };
  // Instantiate the SearchAdController.
  adController = new SearchAdController(this, "your-client-id", "your-style-id",
                                        adOptionsBuilder.build(), adListener);
}

Lorsque l'utilisateur lance une requête, créez un SearchAdRequest et appelez loadAds sur le SearchAdController pour lancer une demande d'annonce asynchrone.

// Create the request.
SearchAdRequest.Builder requestBuilder = new SearchAdRequest.Builder();
requestBuilder.setQuery("user query here");
// Load the ads.
adController.loadAds(requestBuilder.build());

Implémentez votre rappel onAdLoaded pour insérer une annonce chargée dans une vue d'annonce.

private void createAndShowAd() {
  // Create a new view that will contain the ad.
  View adView = adController.createAdView();
  // Attach the new view to the view hierarchy.
  adContainer.addView(adView);
  // Display the ad inside the adView. We need to provide an adKey to
  // indicate which ad is to be displayed in the adView. In this example, 
  // since we only have one ad, we can provide any constant string. However, 
  // if you intend to display multiple ads, each ad you wish to display
  // should be given a unique adKey of your choosing.
  adController.populateAdView(adView, "demoAd");
}

Une annonce associée à la requête donnée s'affiche désormais dans adView.

Analyser les erreurs

SearchAdController nécessite un objet AdListener avec le onAdLoaded(). pour avertir votre application que les annonces sont prêtes à être diffusées. Vous devez également implémenter la méthode onAdFailedToLoad() pour pouvoir détecter et corriger les erreurs. Par exemple, vous pouvez utiliser l'AdListener suivante pour déboguer votre implémentation :

AdListener adListener = new AdListener() {
    public void onAdLoaded() {
        // Called when an ad is loaded.
        Toast.makeText(MainActivity.this, "Ad Loaded",
                Toast.LENGTH_SHORT).show();
        Log.d(MainActivity.class.getSimpleName(), "Ad Loaded");
    }

    public void onAdLeftApplication() {
        // Called when an ad leaves the application
        // (to go to the browser for example).
        Toast.makeText(MainActivity.this, "Ad Left Application",
                Toast.LENGTH_SHORT).show();
        Log.d(MainActivity.class.getSimpleName(), "Ad Left Application");
    }

    @Override
    public void onAdFailedToLoad(int errorCode) {
        // Called when an ad request failed.
        Toast.makeText(MainActivity.this, "Ad Failed to Load: " + errorCode,
                Toast.LENGTH_SHORT).show();
        Log.e(MainActivity.class.getSimpleName(), "Ad Failed to Load: " +
                errorCode);
    }
};

Constantes utilisées dans la méthode de rappel onAdFailedToLoad() sont définies dans l'objet AdListener.