Direktzugriff für Ad Exchange einrichten

Plattform auswählen: Android (Beta) Neu Android iOS

Mit dem Google Mobile Ads SDK können Sie Ihre Apps mit einer Ad Exchange Property monetarisieren. In dieser Anleitung erfahren Sie, wie Sie Ihre Apps für alle von Ad Exchange unterstützten Anzeigenformate konfigurieren.

Vorbereitung

App für den Zugriff auf Ad Exchange konfigurieren

Fügen Sie der Datei AndroidManifest.xml Ihrer App Ihre Ad Manager-App-ID hinzu (wird in der Ad Manager Benutzeroberfläche angezeigt). Verwenden Sie dazu ein <meta-data>-Tag mit android:name="com.google.android.gms.ads.APPLICATION_ID". Geben Sie neben android:value Ihre eigene Ad Manager-App-ID ein, umgeben von Anführungszeichen.

<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>

Wenn Sie das <meta-data>-Tag nicht wie oben gezeigt hinzufügen, kommt es zu einem Absturz mit der folgenden Meldung:

Missing application ID.

Als Nächstes können Sie das Google Mobile Ads SDK initialisieren und ein Anzeigenformat auswählen, das angezeigt werden soll. Im Rest dieser Anleitung wird das Bannerformat verwendet, um zu veranschaulichen, wie Sie eine Anzeige aus Ad Exchange laden können. Die gleichen Schritte können für alle Anzeigenformate angewendet werden, die vom Google Mobile Ads SDK unterstützt werden.

Anzeige aus Ad Exchange laden

Sie können anstelle einer Anzeigenblock-ID einen Ad Exchange-Web-Property-Code mit einem nachgestellten Schrägstrich verwenden. Beispiel: ca-mb-app-pub-5629679302779023/.

So laden Sie beispielsweise eine Banneranzeige, indem Sie eine AdManagerAdView im Layout für die Activity platzieren:

# 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>

Alternativ können Sie eine Ansichtshierarchie programmatisch erstellen:

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.

Sobald die AdManagerAdView vorhanden ist, können Sie die loadAd() Methode in der AdManagerAdView Klasse aufrufen und das Verhalten Ihrer Anzeige mithilfe von Anzeigen ereignissen anpassen.

Wenn Sie dem Ad Exchange-Web-Property-Code keinen nachgestellten Schrägstrich hinzufügen, kommt es zu einem Fehler bei der Anzeigenanfrage mit der folgenden Meldung:

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

Sie können auch einen Ad Exchange-Web-Property-Code in einen Anzeigenblock umwandeln. Generieren Sie anschließend über die Ad Manager-Benutzeroberfläche ein Ad Exchange-Tag und kopieren Sie es in Ihre App. Das generierte Tag sollte den Ad Exchange-Web-Property-Code gefolgt von den Anzeigenblock-IDs der untergeordneten Anzeigenblöcke ohne nachgestellten Schrägstrich enthalten, z. B. ca-mb-app-pub-5629679302779023/banner.

Jetzt weißt du Bescheid. Ihre App ist jetzt bereit, Banneranzeigen aus Ad Exchange zu laden und anzuzeigen.

Außerdem können Sie mit einer Ad Exchange-Web-Property andere Anzeigenformate aus Ad Exchange laden und anzeigen. Folgen Sie dazu den entsprechenden Anleitungen:

Mindestpreise hinzufügen (nur für genehmigte Publisher in Europa)

Sie können die Verwendung der Funktion „Mindestpreise“ beantragen.

Nach der Genehmigung können Sie mit den Parametern pubf und pvtf einen öffentlichen oder privaten Mindestpreis in die Anzeigenanfrage aufnehmen. Ersetzen Sie im folgenden Code beispiel „123“ durch die Mindestpreise (als Millionstel) und die Standardwährung Ihres Netzwerks. Beispiel für die Angabe als Millionstel: Wenn Sie als Standardwährung Euro nutzen und „6000000“ eingeben, entspricht das 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();