Direktzugriff für Ad Exchange einrichten

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 nicht wie oben gezeigt 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/.

Im folgenden Beispiel wird der Ad Exchange-Web-Property-Code einer Banneranzeigenanfrage hinzugefügt:

Kotlin 

val adRequest = BannerAdRequest.Builder("ca-mb-app-pub-5629679302779023/", AdSize.BANNER).build()

BannerAd.load(
  adRequest,
  object : AdLoadCallback<BannerAd> {
    override fun onAdLoaded(ad: BannerAd) {
      bannerAd = ad
      activity?.runOnUiThread {
        binding.bannerViewContainer.addView(ad.getView(requireActivity()))
      }
    }
  }
)

Java 

BannerAdRequest adRequest = new BannerAdRequest.Builder("ca-mb-app-pub-5629679302779023/",
    AdSize.BANNER).build();

BannerAd.load(
    adRequest,
    new AdLoadCallback<BannerAd>() {
      @Override
      public void onAdLoaded(@NonNull BannerAd ad) {
        bannerAd = ad;
        runOnUiThread(
            () -> binding.bannerViewContainer.addView(ad.getView(MainActivity.this)));
      }
    });

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 US-Dollar ist, entspricht die Eingabe von „6000000“ 6,00 $.

Kotlin

val extras = Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

val request = AdRequest.Builder("ca-mb-app-pub-5629679302779023/")
    .setGoogleExtrasBundle(extras)
    .build();

Java 

Bundle extras = new Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

AdRequest request = new AdRequest.Builder("ca-mb-app-pub-5629679302779023/")
    .setGoogleExtrasBundle(extras)
    .build();