PubMatic in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von PubMatic mithilfe der AdMob-Vermittlung laden und präsentieren. Dabei werden auch Gebotsintegrationen behandelt. Darin wird beschrieben, wie Sie PubMatic der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das PubMatic SDK und den Adapter in eine Unity-App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der AdMob-Mediationsadapter für PubMatic bietet die folgenden Funktionen:

Integration
Gebote
Vermittlungsabfolge
Formate
App öffnen
Banner
Interstitial
Verfügbar
Interstitial mit Prämie

Voraussetzungen

• Neuestes Google Mobile Ads SDK
• Unity 2019.4 oder höher
• So stellen Sie die App auf Android-Geräten bereit:
  • Android-API-Level 23 oder höher
• So stellen Sie die App auf iOS-Geräten bereit:
  • iOS-Bereitstellungsziel von 12.0 oder höher
• Ein funktionierendes Unity-Projekt, das mit dem Google Mobile Ads SDK konfiguriert ist. Weitere Informationen
• Vermittlung abschließen Startleitfaden

Schritt 1: Konfigurationen in der PubMatic-Benutzeroberfläche einrichten

Melden Sie sich in Ihrem PubMatic-Konto an 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.

Android

Wählen Sie unter Integrationspfad die Option Unity und als Subintegrationspfad AdMob – SDK Bidding aus. Klicken Sie dann auf die Schaltfläche App hinzufügen.

iOS

Wählen Sie unter Integrationspfad die Option Unity und als Subintegrationspfad AdMob – SDK Bidding 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. Richten Sie eine app-ads.txt-Datei für Ihre App ein, falls noch nicht geschehen.

Bevor Ihre App fertiggestellt wird, werden Ihnen die entsprechenden Einträge angezeigt, die Sie Ihrer app-ads.txt hinzufügen müssen.

Weitere Informationen zur Implementierung von app-ads.txt für PubMatic finden Sie unter app-ads.txt-Datei implementieren.

Profil-ID

Nachdem Sie Ihre App erstellt haben, rufen Sie den Tab Apps auf und notieren Sie sich die Profil-ID Ihrer 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

Android

Eine Anleitung finden Sie in Schritt 2 der Anleitung für Android.

iOS

Eine Anleitung finden Sie in Schritt 2 der Anleitung für iOS.

PubMatic der Liste der Werbepartner gemäß DSGVO und Verordnungen von US-Bundesstaaten hinzufügen

Wichtig: Sie benötigen die Berechtigung Kontoverwaltung, um die Konfiguration für die Einwilligung der Nutzer in der EU und die DSGVO, die Verordnungen von US-Bundesstaaten und die User Messaging Platform abzuschließen. Weitere Informationen finden Sie unter Nutzerzugriff auf Ihr Konto verwalten.

Führen Sie die Schritte unter Einstellungen für europäische Verordnungen und Einstellungen für Bestimmungen von US-Bundesstaaten aus, um PubMatic in der AdMob-Benutzeroberfläche der Liste der Werbepartner für europäische Verordnungen und Bestimmungen von US-Bundesstaaten hinzuzufügen.

Schritt 3: PubMatic SDK und Adapter importieren

Hinweis :Wenn Sie die kompatiblen Versionen des PubMatic SDK und des Google Mobile Ads SDK nicht integrieren, kann es zu Build-Problemen kommen.

OpenUPM-CLI

Wichtig :Wenn Sie von der Verwendung von .unitypackage zur Verwendung von OpenUPM-CLI migrieren, müssen Sie die Assets manuell vom alten Speicherort deinstallieren, indem Sie alle Dateien aus dem Ordner Assets/GoogleMobileAds/Mediation/PubMatic löschen.

Wenn Sie die OpenUPM-CLI installiert haben, können Sie das Google Mobile Ads PubMatic OpenWrap SDK Mediation Plugin für Unity in Ihrem Projekt installieren, indem Sie den folgenden Befehl im Stammverzeichnis Ihres Projekts ausführen:

openupm add com.google.ads.mobile.mediation.pubmatic

OpenUPM

Wichtig :Wenn Sie von der Verwendung von .unitypackage zu OpenUPM migrieren, müssen Sie die Assets manuell vom alten Speicherort deinstallieren, indem Sie alle Dateien aus dem Ordner Assets/GoogleMobileAds/Mediation/PubMatic löschen.

Wählen Sie im Unity-Projekt-Editor Edit > Project Settings > Package Manager aus, um die Unity Package Manager Settings (Unity-Paketmanager-Einstellungen) zu öffnen.

Fügen Sie auf dem Tab Scoped Registries (Registrierungen mit Bereich) OpenUPM als Registrierung mit Bereich mit den folgenden Details hinzu:

• Name: OpenUPM
• URL: https://package.openupm.com
• Bereiche: com.google

Rufen Sie dann Window > Package Manager auf, um den Unity Package Manager zu öffnen, und wählen Sie im Drop-down-Menü My Registries aus.

Wählen Sie das Paket Google Mobile Ads PubMatic Mediation aus und klicken Sie auf Installieren.

Unity-Paket

Laden Sie die aktuelle Version des Google Mobile Ads-Mediations-Plug-ins für das PubMatic OpenWrap SDK über den Downloadlink im Changelog herunter und extrahieren Sie die GoogleMobileAdsPubMaticMediation.unitypackage aus der ZIP-Datei.

Wählen Sie im Editor Ihres Unity-Projekts Assets > Import Package > Custom Package aus und suchen Sie nach der heruntergeladenen Datei GoogleMobileAdsPubMaticMediation.unitypackage. Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.

Wählen Sie dann Assets > External Dependency Manager > Android Resolver > Force Resolve aus. Die Bibliothek „External Dependency Manager“ führt die Abhängigkeitsauflösung von Grund auf durch und kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android Ihrer Unity-App.

Schritt 4: Datenschutzeinstellungen im PubMatic SDK implementieren

Einwilligung der Nutzer in der EU und DSGVO

Damit Sie die Google-Richtlinie zur Einwilligung der Nutzer in der EU einhalten, müssen Sie Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz bestimmte Informationen offenlegen und ihre Einwilligung zur Verwendung von Cookies oder anderen lokalen Speichern einholen, sofern dies gesetzlich vorgeschrieben ist, sowie zur Erhebung, Weitergabe und Verwendung personenbezogener Daten zur Personalisierung von Anzeigen. 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. Google kann die Einwilligung des Nutzers nicht automatisch an diese Netzwerke weitergeben.

PubMatic liest automatisch die von Consent-Management-Plattformen festgelegte Einwilligung gemäß DSGVO, 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 für Karten/Tickets.

Datenschutzgesetze von US-Bundesstaaten

Datenschutzgesetze von US-Bundesstaaten schreiben vor, dass Nutzern das Recht eingeräumt werden muss, 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 können Sie die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung von Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Anzeigennetzwerk in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das am Verkauf personenbezogener Daten beteiligt sein kann, und die Richtlinien der einzelnen Netzwerke befolgen, um die Einhaltung der Bestimmungen zu gewährleisten.

PubMatic liest automatisch die von Consent-Management-Plattformen festgelegte CCPA-Einwilligung, die die Spezifikation für zusätzliche Einwilligung von Google unterstützen, einschließlich des UMP SDK. Weitere Informationen finden Sie unter CCPA-String festlegen.

Schritt 5: Erforderlichen Code hinzufügen

Android

Für die PubMatic-Integration ist kein zusätzlicher Code erforderlich.

iOS

SKAdNetwork-Integration

Folgen Sie der Dokumentation von PubMatic, um die SKAdNetwork-Kennungen in die Datei Info.plist Ihres Projekts einzufügen.

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für AdMob.

Wichtig: Deaktivieren Sie den Testmodus für AdMob und das PubMatic OpenWrap SDK, bevor Sie Ihre App veröffentlichen.

Testanzeigen bestätigen

Wenn Sie prüfen möchten, ob Sie Testanzeigen vom PubMatic OpenWrap SDK erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquellen PubMatic (Bidding).

Fehlercodes

Wenn der Adapter keine Anzeige von PubMatic empfängt, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo in den folgenden Klassen prüfen:

Android

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

iOS

GADMediationAdapterPubMatic

Hier sind die Codes und die zugehörigen Meldungen, die vom PubMatic-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Android

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, weil sie nicht bereit war.
1001-5002	Gesendet vom PubMatic SDK	Das PubMatic SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation von PubMatic.

iOS

Fehlercode	Domain	Grund
101	com.google.ads.mediation.pubmatic	In der Serverkonfiguration fehlt eine erforderliche Publisher-ID.
102	com.google.ads.mediation.pubmatic	Die Anfrage zum Erfassen von Gebotssignalen ist fehlgeschlagen, weil in den Anfrageparametern mehrere Formate, kein Format oder ein nicht unterstütztes Format angegeben wurde.
103	com.google.ads.mediation.pubmatic	Ungültige Anzeigenkonfiguration zum Laden einer Anzeige.
104	com.google.ads.mediation.pubmatic	Die Interstitial-Anzeige konnte nicht präsentiert werden, da sie nicht bereit war.
105	com.google.ads.mediation.pubmatic	Die Anzeige mit Prämie konnte nicht präsentiert werden, da sie nicht bereit war.
106	com.google.ads.mediation.pubmatic	Eine der Bildquellen für die native Anzeige konnte nicht geladen werden.
1001-5002	Gesendet vom PubMatic SDK	Das PubMatic SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation von PubMatic.

Änderungslog für das PubMatic Unity-Mediations-Plug-in

Version 1.1.0 (in Arbeit)

Version 1.0.0

• Erste Veröffentlichung!
• Unterstützt PubMatic Android-Adapterversion 4.8.0.0.
• Unterstützt PubMatic iOS-Adapterversion 4.8.1.0.
• Entwickelt und getestet mit dem Google Mobile Ads Unity-Plug-in Version 10.4.2.