Configurer l'accès direct pour Ad Exchange

Sélectionnez une plate-forme : 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 acceptés par 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 Ad Manager) au fichier AndroidManifest.xml de votre application à l'aide d'une balise <meta-data> avec android: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 la balise <meta-data> comme indiqué ci-dessus, l'application plantera et affichera le message suivant :

Missing application ID.

Ensuite, vous pouvez 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 depuis 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 pour le 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 méthode loadAd() dans la classe AdManagerAdView et personnaliser le comportement de votre annonce à l'aide des é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'affichera 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'UI 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 des 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 publicitaires provenant d'Ad Exchange.

Vous pouvez également utiliser une propriété Web Ad Exchange pour charger et afficher d'autres formats d'annonces Ad Exchange en suivant les guides correspondants :

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

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

Une fois approuvé, 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 plancher en micros et la devise par défaut de votre réseau. Exemple d'application des micros : si votre devise par défaut est l'USD, saisir "6000000" équivaut à 6 $.

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();