Configurer l'accès direct pour Ad Exchange

Le SDK Google Mobile Ads permet de monétiser vos applications avec une propriété place de marché publicitaire. 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 (identifié dans l'interface utilisateur d'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, un plantage se produit avec le message suivant:

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 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 un code de propriété Web Ad Exchange avec une barre oblique à la fin 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 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>

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

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

Notez également que vous pouvez convertir un code de propriété 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 des blocs d'annonces descendants sans barre oblique finale, par exemple :ca-mb-app-pub-5629679302779023/banner

Vous pouvez également créer un AdManagerAdView de manière programmatique:

JavaKotlin
AdManagerAdView adView = new AdManagerAdView(this);

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

// TODO: Add adView to your view hierarchy.

val adView = AdManagerAdView(this)

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

// TODO: Add adView to your view hierarchy.

Une fois 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 désormais prête à charger et à afficher des bannières publicitaires provenant d'Ad Exchange.

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

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

Vous pouvez demander à bénéficier de la fonctionnalité "Prix planchers".

Une fois approuvé, vous pouvez inclure un étage public ou privé dans la requête 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 l'USD, saisir "6000000" équivaut à 6 $.

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

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