Pangle in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit GMA Next-Gen SDK Anzeigen von Pangle über die AdMob-Vermittlung laden und ausliefern. Dabei werden sowohl Vermittlungsabfolge- als auch Gebotsintegrationen behandelt. Hier erfahren Sie, wie Sie Pangle der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Pangle SDK und den Adapter in eine Android-App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter für Pangle bietet die folgenden Funktionen:

Integration
Gebote
Vermittlungsabfolge
Formate
App-Start-Anzeige
Banner
Interstitial
Verfügbar
Interstitial mit Prämie
Nativ

Voraussetzungen

  • Android API‑Level 24 oder höher
  • [Für Gebote] Wenn Sie alle unterstützten Anzeigenformate in Geboten einbinden möchten, verwenden Sie den Pangle Adapter 5.5.0.4.0 oder höher (die neueste Version wird empfohlen)
  • Neueste Version GMA Next-Gen SDK

  • Vermittlung abschließen Startleitfaden

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

Registrieren Sie sich oder melden Sie sich an für Ihr Pangle-Konto.

Neue Anwendung hinzufügen

Rufen Sie den Tab Anwendungen auf und klicken Sie auf die Schaltfläche App hinzufügen.

Wählen Sie das Betriebssystem aus, für das Sie eine Anwendung erstellen möchten, und füllen Sie den Rest des Formulars aus. Klicken Sie dann auf Senden.

Notieren Sie sich die App-ID Ihrer Anwendung.

Anzeigen-Placement erstellen

Nachdem Sie Ihre Anwendung erstellt haben, klicken Sie auf die Schaltfläche Hinzufügen , um Ihr Anzeigen-Placement zu erstellen.

Gebote

Wählen Sie das Anzeigenformat und den Namen des Anzeigen-Placements aus und wählen Sie In-App-Bidding als den Preistyp aus. Füllen Sie den Rest des Formulars aus und klicken Sie auf Senden.

Notieren Sie sich nach dem Erstellen des Anzeigen-Placements die ID des Anzeigen-Placements.

Vermittlungsabfolge

Wählen Sie das Anzeigenformat und den Namen des Anzeigen-Placements aus und wählen Sie Globaler CPM als Preistyp aus. Füllen Sie den Rest des Formulars aus und klicken Sie auf Senden.

Notieren Sie sich nach dem Erstellen des Anzeigen-Placements die ID des Anzeigen-Placements.

Pangle Reporting API-Schlüssel finden

Gebote

Dieser Schritt ist für Gebotsintegrationen nicht erforderlich.

Vermittlungsabfolge

Notieren Sie sich die Nutzer-ID unten links auf der Seite.

Klicken Sie auf Integrationen > SDK und API > Pangle Reporting API 2.0. Notieren Sie sich die Rollen-ID und den Sicherheitsschlüssel.

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. Wenn Sie das noch nicht getan haben, richten Sie eine app-ads.txt-Datei für Ihre App ein.

Informationen zur Implementierung von app-ads.txt für Pangle finden Sie unter Pangle der app-ads.txt-Datei hinzufügen.

Testmodus aktivieren

Folgen Sie der Anleitung unter Pangle's Testanzeige hinzufügen von Pangle, um Testanzeigen von Pangle zu aktivieren.

Schritt 2: Pangle-Nachfrage in der AdMob-Benutzeroberfläche einrichten

Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

Sie müssen Pangle 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 Pangle 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 einen Namen für die Vermittlungsgruppe ein und wählen Sie die Zielstandorte aus. Setzen Sie den Status der Vermittlungsgruppe auf Aktiviert und klicken Sie dann 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:

Pangle 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 Pangle aus.

Klicken Sie auf Partnervereinbarung unterzeichnen und richten Sie eine Gebotspartnerschaft ein mit Pangle.



Klicken Sie auf Bestätigen und zustimmen und dann auf Weiter.



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



Geben Sie als Nächstes die App-ID und ID des Anzeigen-Placements 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 Pangle aus. Geben Sie dann einen eCPM-Wert für Pangle ein und klicken Sie auf Weiter.



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

Geben Sie als Nächstes die App-ID und die ID des Anzeigen-Placements ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.


Pangle DSP der Liste der Werbepartner für die DSGVO und die 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 Pangle DSP der Liste der Werbepartner für EU-Verordnungen und Verordnungen von US-Bundesstaaten in der AdMob-Benutzeroberfläche hinzuzufügen.

Schritt 3: Pangle SDK und Adapter importieren

Fügen Sie in der Datei settings.gradle.kts auf Projektebene die folgenden Repositories hinzu:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifact.bytedance.com/repository/pangle/")
    }
  }
}

Fügen Sie in der Gradle-Datei auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:pangle:7.9.1.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:pangle:7.9.1.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Manuelle Integration

  1. Laden Sie die neueste Version des Pangle SDK für Android herunter, extrahieren Sie open_ad_sdk.aar aus dem heruntergeladenen Archivordner und fügen Sie sie Ihrem Projekt hinzu.

  2. Rufen Sie die Pangle-Adapter-Artefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die .aar-Datei des Pangle-Adapters herunter und fügen Sie sie Ihrem Projekt hinzu.

Schritt 4: Datenschutzeinstellungen im Pangle SDK 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. Google kann die Einwilligung des Nutzers nicht automatisch an diese Netzwerke weitergeben.

Ab der Pangle SDK-Version 7.9.0.9, liest Pangle automatisch die DSGVO-Einwilligung, die von Consent Management-Plattformen festgelegt wurde, die die Spezifikation für zusätzliche Einwilligungen von Googleunterstützen, einschließlich des UMP SDK.

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 können Sie die eingeschränkte Datenverarbeitung für die Google-Anzeigenauslieferung aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbe netzwerk 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.

Der Pangle-Adapter bietet die PangleMediationAdapter.setPAConsent() Methode, mit der die Einwilligungsinformationen an den Pangle-Adapter und dann an das Pangle SDK weitergeleitet werden. Im folgenden Beispielcode wird gezeigt, wie Sie Einwilligungsinformationen an das Pangle SDK weitergeben. Legen Sie die Einwilligungsinformationen fest, bevor Sie initialisieren GMA Next-Gen SDK , damit sie ordnungsgemäß an das Pangle SDK weitergeleitet werden.

Java

import com.google.ads.mediation.pangle.PangleMediationAdapter;
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT);

Kotlin

import com.google.ads.mediation.pangle.PangleMediationAdapter
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT)

Weitere Informationen und die Werte, die in den einzelnen Methoden angegeben werden können, finden Sie in der Android-Integrations anleitung von Pangle.

Schritt 5: Erforderlichen Code hinzufügen

ProGuard-Verschleierung

Wenn Sie ProGuard verwenden, um Android-Code zu verschleiern, folgen Sie der Anleitung in der Dokumentation von Pangle , um sicherzustellen, dass der Pangle SDK-Code nicht verschleiert wird.

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Stellen Sie sicher, dass Sie Ihr Testgerät für AdMob registrieren und den Testmodusin der Pangle-Benutzeroberflächeaktivieren.

Testanzeigen prüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von Pangle erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquellen Pangle (Gebote) und Pangle (Vermittlungsabfolge).

Optionale Schritte

Native Anzeigen

Anzeigen-Rendering

Der Pangle-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 Pangle-Adapter eingeschlossen werden
Anzeigentitel
Bild 1
Text
Symbol
Call-to-Action
Bewertung
Shop
Preis
Advertiser

1 Der Pangle-Adapter bietet keinen direkten Zugriff auf das Haupt-Bild-Asset für seine nativen Anzeigen. Stattdessen wird der Adapter mit einem Video oder einem Bild gefüllt.MediaView

Fehlercodes

Wenn der Adapter keine Anzeige von Pangle empfangen kann, können Sie den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo.getAdSourceResponses() unter den folgenden Klassen prüfen:

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

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

Fehlercode Domain Grund
101 com.google.ads.mediation.pangle Ungültige Serverparameter (z.B. fehlende App-ID oder Placement-ID).
102 com.google.ads.mediation.pangle Die angeforderte Anzeigengröße entspricht keiner von Pangle unterstützten Bannergröße.
103 com.google.ads.mediation.pangle Fehlende oder ungültige Gebotsantwort.
-1-60000 com.pangle.ads Das Pangle SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation von Pangle.