Configurer l'accès direct pour Ad Exchange

Sélectionnez une plate-forme : Android (bêta) Nouveau Android iOS

Le SDK Google Mobile Ads vous permet de monétiser vos applications avec une propriété Ad Exchange. Ce guide vous explique comment configurer vos applications pour tous les formats d'annonces compatibles avec Ad Exchange.

Prérequis

Configurer votre application pour accéder à Ad Exchange

Ajoutez votre ID d'application Ad Manager (qui s'affiche dans l'interface utilisateur d'Ad Manager) au fichier AndroidManifest.xml de votre application à l'aide d'un tag <meta-data> avecandroid:name="com.google.android.gms.ads.APPLICATION_ID". Pour android:value, insérez votre propre ID d'application Ad Manager et entourez-le de guillemets.

<manifest>
    <application>
        <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

Notez également que si vous n'ajoutez pas le <meta-data> tag comme indiqué ci-dessus, l'application plantera et le message suivant s'affichera :

Missing application ID.

Vous pouvez ensuite initialiser le SDK Google Mobile Ads et sélectionner un format d'annonce à afficher. Le reste de ce guide implémente le format de bannière pour illustrer comment charger une annonce à partir d'Ad Exchange. Les mêmes étapes peuvent s'appliquer à tous les formats d'annonces compatibles avec le SDK Google Mobile Ads.

Charger une annonce à partir d'Ad Exchange

Vous pouvez utiliser un code de propriété Web Ad Exchange avec une barre oblique à la fin, à la place d'un ID de bloc d'annonces. Par exemple, ca-mb-app-pub-5629679302779023/.

Par exemple, pour charger une bannière en plaçant un AdManagerAdView dans la mise en page de l'Activity comme suit :

# main_activity.xml
...
  <com.google.android.gms.ads.admanager.AdManagerAdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adManagerAdView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="ca-mb-app-pub-5629679302779023/">
  </com.google.android.gms.ads.admanager.AdManagerAdView>

Vous pouvez également créer une hiérarchie de vues par programmation :

Java 

AdManagerAdView adView = new AdManagerAdView(this);

adView.setAdSizes(AdSize.BANNER);
adView.setAdUnitId("ca-mb-app-pub-5629679302779023/");

// TODO: Add adView to your view hierarchy.

Kotlin 

val adView = AdManagerAdView(this)

adView.adSizes = AdSize.BANNER
adView.adUnitId = "ca-mb-app-pub-5629679302779023/"

// TODO: Add adView to your view hierarchy.

Une fois le AdManagerAdView en place, vous pouvez appeler la loadAd() méthode dans la AdManagerAdView classe et personnaliser le comportement de votre annonce à l'aide d'événements d'annonce.

Notez que si vous n'ajoutez pas de barre oblique à la fin du code de propriété Web Ad Exchange, une erreur de demande d'annonce s'affiche avec le message suivant :

Invalid Request. Cannot determine request type. Is your ad unit id correct?

Vous pouvez également convertir un code de propriété Web Ad Exchange en bloc d'annonces. Ensuite, utilisez l'interface utilisateur d'Ad Manager pour générer un tag Ad Exchange et copiez-le dans votre application. Le tag généré doit contenir le code de propriété Web Ad Exchange, suivi des ID de blocs d'annonces descendants sans barre oblique à la fin, par exemple : ca-mb-app-pub-5629679302779023/banner.

Et voilà ! Votre application est désormais prête à charger et à afficher des bannières à partir d'Ad Exchange.

De plus, vous pouvez utiliser une propriété Web Ad Exchange pour charger et afficher d'autres formats d'annonces à partir d'Ad Exchange en suivant les guides respectifs :

Ajouter des prix planchers (éditeurs européens approuvés uniquement)

Vous pouvez envoyer une demande pour la fonctionnalité "Prix planchers".

Une fois votre demande approuvée, vous pouvez inclure un prix plancher public ou privé dans la demande d'annonce à l'aide des paramètres pubf et pvtf, respectivement. Dans l'exemple de code suivant, remplacez "123" par les prix planchers en micro-unités et par la devise par défaut de votre réseau. Exemple d'application des micro-unités : si votre devise par défaut est le dollar USD, la valeur "6000000" équivaut à 6,00 $.

Java

Bundle extras = new Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();

Kotlin

val extras = Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

val request = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class::java, extras)
    .build();