Direktzugriff für Ad Exchange einrichten

Plattform auswählen:Android iOS

Das Google Mobile Ads SDK unterstützt die Monetarisierung Ihrer Apps mit einer Ad Exchange-Property. 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 die Ad Manager-App-ID (in der Ad Manager-Benutzeroberfläche) über ein <meta-data>-Tag mit android:name="com.google.android.gms.ads.APPLICATION_ID" in die Datei „AndroidManifest.xml“ Ihrer App ein. 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 wie oben gezeigt nicht hinzufügen, stürzt die App mit der folgenden Meldung ab:

Missing application ID.

Als Nächstes können Sie das Google Mobile Ads SDK initialisieren und ein anzuzeigendes Anzeigenformat auswählen. Im weiteren Verlauf 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 einen Ad Exchange-Web-Property-Code mit einem nachgestellten Schrägstrich anstelle einer Anzeigenblock-ID verwenden. Beispiel: ca-mb-app-pub-5629679302779023/.

Wenn Sie beispielsweise eine Banneranzeige laden möchten, indem Sie ein AdManagerAdView im Layout für das Activity platzieren, gehen Sie so vor:

# 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 auch 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 Methode loadAd() in der Klasse AdManagerAdView aufrufen und das Verhalten Ihrer Anzeige mit Anzeigenereignissen anpassen.

Wenn Sie dem Ad Exchange-Webproperty-Code keinen abschließenden Schrägstrich hinzufügen, führt dies zu einem Anzeigenanfragefehler 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. Anschließend können Sie in der Ad Manager-Benutzeroberfläche ein Ad Exchange-Tag generieren und in Ihre App kopieren. Das generierte Tag sollte den Ad Exchange-Web-Property-Code gefolgt von untergeordneten Anzeigenblock-IDs ohne nachgestellten Schrägstrich enthalten, z. B. ca-mb-app-pub-5629679302779023/banner.

Geschafft! In Ihrer App können jetzt Banneranzeigen aus Ad Exchange geladen und ausgeliefert werden.

Außerdem können Sie eine Ad Exchange-Web-Property verwenden, um andere Anzeigenformate aus Ad Exchange zu laden und anzuzeigen. 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 bzw. privaten Mindestpreis in die Anzeigenanfrage einfügen. Ersetzen Sie im folgenden Codebeispiel „123“ durch die Mindestpreise in Mikros und die Standardwährung Ihres Netzwerks. Beispiel für die Anwendung von Mikroeinheiten: Wenn Ihre Standardwährung USD ist, entspricht die Eingabe von „6000000“ 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();