In dieser Anleitung erfahren Sie, wie Sie mit GMA Next-Gen SDK Anzeigen von PubMatic über die AdMob-Vermittlung laden und ausliefern. Dabei werden sowohl Vermittlungsabfolge- als auch Gebotsintegrationen behandelt. Hier erfahren Sie, wie Sie das PubMatic OpenWrap SDK der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das PubMatic OpenWrap SDK und den Adapter in eine Android-App einbinden.
Unterstützte Integrationen und Anzeigenformate
Der Vermittlungsadapter für PubMatic bietet die folgenden Funktionen:
| Integration | |
|---|---|
| Gebote | |
| Vermittlungsabfolge | 1 |
| Formate | |
| App-Start-Anzeige | |
| Banner | |
| Interstitial | 2 |
| Verfügbar | 2 |
| Interstitial mit Prämie | |
| Nativ | 2 |
1 Die Vermittlungsabfolge-Integration befindet sich in der Alpha-Phase.
2 Alle anderen unterstützten Anzeigenformate außer Bannern befinden sich in der Alpha-Phase.
Voraussetzungen
- Android API-Level 24 oder höher
Neuestes GMA Next-Gen SDK.
Anleitung „Erste Schritte mit der Vermittlung“ abgeschlossen
Schritt 1: Konfigurationen in der PubMatic-Benutzeroberfläche einrichten
Registrieren Sie sich oder melden Sie sich an für ein PubMatic-Konto und wählen Sie die Karte OpenWrap SDK aus.
Neue Anwendung hinzufügen
Rufen Sie den Tab Apps auf und klicken Sie auf die Schaltfläche App hinzufügen.
Wählen Sie die Plattform sowie die App-Store-URL und den App-Namen für Ihre App aus.
Wählen Sie unter Integrationspfad die Option Android (Java / Kotlin) und unter Unterintegrationspfad die Option AdMob – SDK-Gebote aus. Klicken Sie dann auf die Schaltfläche App hinzufügen.
app-ads.txt-Datei aktualisieren
Authorized Sellers for Apps (app-ads.txt) ist eine IAB Tech Lab-Initiative, die dafür sorgt, dass Ihr
App-Anzeigeninventar nur über Kanäle verkauft wird, die Sie autorisiert haben. Um einen erheblichen Rückgang des Anzeigenumsatzes zu vermeiden, müssen Sie eine app-ads.txt-Datei implementieren.
Falls noch nicht geschehen,
richten Sie eine app-ads.txt-Datei für Ihre App ein.
Bevor Ihre App fertig ist, werden Ihnen die entsprechenden Einträge angezeigt, die Sie Ihrer app-ads.txt-Datei hinzufügen müssen.
Weitere Informationen zur Implementierung von app-ads.txt für PubMatic,
siehe app-ads.txt-Datei für Ihre App einrichten.
Profil-ID
Nachdem Sie Ihre App erstellt haben, rufen Sie den Tab Apps auf und notieren Sie sich die Profil-ID der neu erstellten Anwendung.
Anzeigenblock erstellen
Wählen Sie auf dem Tab Anzeigenblöcke die App aus, die Sie im vorherigen Abschnitt erstellt haben, und klicken Sie auf die Schaltfläche Anzeigenblock erstellen.
Füllen Sie das Formular mit den Details Ihres Anzeigenblocks aus und klicken Sie auf Speichern.
Notieren Sie sich die neu erstellte OpenWrap-Anzeigenblock-ID.
Publisher-ID abrufen
Rufen Sie das Analytics-Dashboard auf. Bewegen Sie den Mauszeiger auf das Profilsymbol und notieren Sie sich Ihre ID.
Schritt 2: PubMatic-Nachfrage in der AdMob-Benutzeroberfläche einrichten
Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren
Sie müssen das PubMatic OpenWrap SDK der Vermittlungskonfiguration für Ihren Anzeigenblock hinzufügen.
Melden Sie sich zuerst in Ihrem AdMob-Konto an. Rufen Sie dann den Tab Vermittlung auf. Wenn Sie eine vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten, und fahren Sie mit PubMatic OpenWrap SDK als Anzeigenquelle hinzufügen fort.
Wenn Sie eine neue Vermittlungsgruppe erstellen möchten, wählen Sie Vermittlungsgruppe erstellen aus.

Geben Sie das Anzeigenformat und die Plattform ein und klicken Sie auf Weiter.

Geben Sie Ihrer Vermittlungsgruppe einen Namen und wählen Sie die Zielstandorte aus. Setzen Sie dann den Status der Vermittlungsgruppe auf Aktiviert und klicken Sie auf Anzeigenblöcke hinzufügen.

Verknüpfen Sie diese Vermittlungsgruppe mit einem oder mehreren Ihrer vorhandenen AdMob-Anzeigenblöcke. Klicken Sie dann auf Fertig.

Auf der Karte „Anzeigenblöcke“ sollten jetzt die von Ihnen ausgewählten Anzeigenblöcke angezeigt werden:

PubMatic OpenWrap SDK als Anzeigenquelle hinzufügen
Gebote
Wählen Sie im Bereich Anzeigenquellen auf der Karte Gebote die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann PubMatic OpenWrap SDK aus.
Klicken Sie auf Bestätigen und zustimmen und dann auf Speichern.
Wenn Sie bereits eine Zuordnung für das PubMatic OpenWrap SDK haben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.
Geben Sie als Nächstes die OpenWrap-Anzeigenblock-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.

Vermittlungsabfolge
Wählen Sie im Bereich Anzeigenquellen auf der Karte Vermittlungsabfolge die Option Anzeigenquelle hinzufügen aus.
Wählen Sie PubMatic OpenWrap SDK aus. Geben Sie dann einen eCPM-Wert für das PubMatic OpenWrap SDK ein und klicken Sie auf Weiter.

Wenn Sie bereits eine Zuordnung für das PubMatic OpenWrap SDK haben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.

Geben Sie als Nächstes die OpenWrap-Anzeigenblock-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.

PubMatic der Liste der Werbepartner gemäß DSGVO und Verordnungen von US-Bundesstaaten hinzufügen
Folgen Sie der Anleitung unter Einstellungen für EU-Verordnungen und Einstellungen für Verordnungen von US-Bundesstaaten , um PubMatic der Liste der Werbepartner gemäß EU-Verordnungen und Verordnungen von US-Bundesstaaten in der AdMob-Benutzeroberfläche hinzuzufügen.
Schritt 3: PubMatic OpenWrap SDK und Adapter importieren
Android Studio-Integration (empfohlen)
Fügen Sie in der Datei settings.gradle.kts auf Projektebene die folgenden Repositories hinzu:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://repo.pubmatic.com/artifactory/public-repos")
}
}
}
Fügen Sie dann in der Datei build.gradle.kts auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu. Verwenden Sie die neuesten Versionen des PubMatic OpenWrap SDK und des Adapters:
dependencies {
implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
implementation("com.google.ads.mediation:pubmatic:5.0.0.0")
}
configurations {
all {
exclude(group = "com.google.android.gms", module = "play-services-ads")
exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}
}
Schritt 4: Datenschutzeinstellungen auf PubMatic implementieren
Gemäß der Richtlinie zur Einwilligung der Nutzer in der EU von Google müssen Sie Ihren Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz bestimmte Informationen offenlegen und ihre Einwilligung zu folgenden Aktivitäten einholen: Einsatz von Cookies oder anderen Formen der lokalen Speicherung, falls die Einholung der Einwilligung dafür gesetzlich vorgeschrieben ist, sowie Erhebung, Weiterleitung und Nutzung personenbezogener Daten für personalisierte Werbung. Die Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO). Sie sind dafür verantwortlich, dass die Einwilligung an jede Anzeigenquelle in Ihrer Vermittlungskette weitergegeben wird.
PubMatic liest automatisch die DSGVO-Einwilligung, die von Consent-Management Plattformen festgelegt wurde, die die Spezifikation für zusätzliche Einwilligung von Google unterstützen, einschließlich des UMP SDK. Weitere Informationen finden Sie unter DSGVO- und DSGVO-Einwilligung weitergeben.
Datenschutzgesetze von US-Bundesstaaten
Gemäß den Datenschutzgesetzen von US-Bundesstaaten muss Nutzern das Recht eingeräumt werden, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition der Begriffe „sale“ und „personal information“). Dazu muss auf der Website des „Verkäufers“ (selling party) ein gut sichtbarer Link mit dem Text „Do Not Sell My Personal Information“ (Meine personenbezogenen Daten dürfen nicht verkauft werden) vorhanden sein. Im Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten wird die Möglichkeit geboten, die eingeschränkte Datenverarbeitung für die Google-Anzeigenauslieferung zu aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbenetzwerk in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das am Verkauf personenbezogener Daten beteiligt sein kann, und die Anleitung der einzelnen Netzwerke befolgen, um die Einhaltung der Datenschutzgesetze zu gewährleisten.
PubMatic liest automatisch die GPP-Einwilligung, die von Consent-Management Plattformen festgelegt wurde, die die Spezifikation für zusätzliche Einwilligung von Google unterstützen, einschließlich des UMP SDK. Weitere Informationen finden Sie unter GPP-Einwilligung weitergeben.
Schritt 5: Erforderlichen Code hinzufügen
Für die Integration des PubMatic OpenWrap SDK ist kein zusätzlicher Code erforderlich.
Schritt 6: Implementierung testen
Testanzeigen aktivieren
Stellen Sie sicher, dass Sie Ihr Testgerät für AdMob registrieren.
Testanzeigen prüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen von PubMatic OpenWrap SDK erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquelle(n) PubMatic OpenWrap.
Optionale Schritte
Native Anzeigen
Anzeigen-Rendering
Der PubMatic-Adapter gibt seine nativen Anzeigen als
NativeAd
Objekte zurück. Er füllt die folgenden
Felder
für ein
NativeAd aus.
| Feld | Assets, die immer vom PubMatic-Adapter eingeschlossen werden |
|---|---|
| Anzeigentitel | |
| Bild | |
| Text | |
| Symbol | |
| Call-to-Action | |
| Bewertung | |
| Shop | |
| Preis | |
| Advertiser |
Fehlercodes
Wenn der Adapter keine Anzeige von PubMatic empfangen kann, können Sie den
zugrunde liegenden Fehler aus der Anzeigenantwort mit
ResponseInfo.getAdSourceResponses()
unter den folgenden Klassen prüfen:
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
Hier sind die Codes und die zugehörigen Meldungen, die vom PubMatic-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
| Fehlercode | Domain | Grund |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | In der Serverkonfiguration fehlt eine erforderliche Publisher-ID. |
| 102 | com.google.ads.mediation.pubmatic | Ungültige Anzeigenkonfiguration zum Laden einer Anzeige. |
| 103 | com.google.ads.mediation.pubmatic | Die Anzeige konnte nicht präsentiert werden, da sie nicht bereit war. |
| 1001–5002 | Vom PubMatic SDK gesendet | Das PubMatic SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation von PubMatic. |