Configurer un accès direct pour Ad Exchange

Le SDK Google Mobile Ads 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.

Conditions préalables

Configurer l'accès à Ad Exchange pour votre application

Ajoutez votre ID d'application Ad Manager (identifié dans l'interface utilisateur d'Ad Manager) au fichier AndroidManifest.xml de votre application via 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, en l'entourant 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 l'échec de l'ajout de la balise <meta-data> comme indiqué ci-dessus entraîne un plantage avec le message:

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 met en œuvre le format de bannière pour illustrer la manière dont vous pouvez charger une annonce depuis Ad Exchange. La même procédure peut s'appliquer à tous les formats d'annonces compatibles avec le SDK Google Mobile Ads.

Charger une annonce depuis Ad Exchange

Vous pouvez utiliser le code de propriété Web Ad Exchange avec une barre oblique finale dans votre application à la place d'un ID de bloc d'annonces.

Par exemple, pour charger une bannière en plaçant un AdManagerAdView dans la mise en page de la Activity, procédez 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>

Notez que si vous n'ajoutez pas de barre oblique finale au code de propriété Web Ad Exchange, comme indiqué ci-dessus, une erreur de demande d'annonce est renvoyée avec le message suivant:

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

Notez également que vous pouvez convertir le code d'un site Web Ad Exchange en bloc d'annonces. Vous pouvez ensuite utiliser l'interface utilisateur d'Ad Manager pour générer un tag Ad Exchange et le copier dans votre application. Le tag généré doit comporter le code de la propriété Web Ad Exchange, suivi des ID de bloc d'annonces descendants sans barre oblique finale. Exemple : ca-mb-app-pub-5629679302779023/banner

Vous pouvez également créer un AdManagerAdView programmatiquement:

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 l'élément AdManagerAdView en place, vous pouvez appeler la méthode loadAd() dans la classe AdManagerAdView et personnaliser le comportement de votre annonce à l'aide d'événements d'annonce.

Et voilà ! Votre application est maintenant prête à charger et à afficher des bannières 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:

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

Vous pouvez envoyer une requête pour la fonctionnalité "Prix planchers".

Une fois la 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 micros et la devise par défaut de votre réseau. Exemple d'application des micros: si votre devise par défaut est le dollar américain, "6000000" équivaut à l'équivalent de 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();