In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Pangle mithilfe von Vermittlung laden und präsentieren. Dabei werden sowohl Vermittlungsabfolgen als auch Gebotsintegrationen behandelt. Dort erfahren Sie, wie Sie Pangle der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Pangle SDK und den Adapter in eine Flutter-App einbinden.
Unterstützte Einbindungen und Anzeigenformate
Der AdMob Mediation-Adapter für Pangle bietet folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
Banner | |
Interstitial | |
Verfügbar | |
Interstitial mit Prämie | |
Nativ |
Voraussetzungen
- Neueste Version des Google Mobile Ads SDK
- Flutter 3.7.0 oder höher
- [Für Gebote]: Wenn Sie alle unterstützten Anzeigenformate in Gebote einbinden möchten, verwenden Sie das Google Mobile Ads-Vermittlungs-Plug-in für Pangle 2.4.0 oder höher (die neueste Version wird empfohlen).
- Bereitstellung auf Android-Geräten
- Android API-Level 21 oder höher
- Bereitstellung auf iOS-Geräten
- iOS-Bereitstellungsziel 12.0 oder höher
- Ein funktionierendes Flutter-Projekt, das mit dem Google Mobile Ads SDK konfiguriert ist. Weitere Informationen finden Sie unter Erste Schritte.
- Mediation abschließen Startleitfaden
Schritt 1: Konfigurationen in der Pangle-Benutzeroberfläche einrichten
Registrieren oder melden Sie sich in Ihrem Pangle-Konto an.
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 das restliche Formular aus. Klicken Sie dann auf Senden.
Android
iOS
Notieren Sie sich die App-ID Ihrer Anwendung.
Android
iOS
Anzeigen-Placement erstellen
Klicken Sie nach dem Erstellen der Anwendung auf die Schaltfläche Hinzufügen, um das Anzeigen-Placement zu erstellen.
Android
iOS
Gebote
Wählen Sie das Anzeigenformat und den Namen des Anzeigen-Placements aus und legen Sie In-App-Gebote als Preistyp fest. Füllen Sie den Rest des Formulars aus und klicken Sie auf Senden.
Notieren Sie sich die Placement-ID des Anzeigen-Placements.
Android
iOS
Wasserfall
Wählen Sie das Anzeigenformat und den Namen des Anzeigen-Placements aus und Globaler CPM als Preistyp. Füllen Sie den Rest des Formulars aus und klicken Sie auf Senden.
Notieren Sie sich die Placement-ID des Anzeigen-Placements.
Android
iOS
Pangle Reporting API-Schlüssel finden
Gebote
Dieser Schritt ist für Geboteinbindungen nicht erforderlich.
Wasserfall
Notieren Sie sich die Nutzer-ID links unten auf der Seite.
Klicken Sie auf Integrationen > SDK und API > Pangle Reporting API 2.0. Notieren Sie sich die Role ID (Rollen-ID) und den Security Key (Sicherheitsschlüssel).
Testmodus aktivieren
Folgen Sie der Anleitung im Pangle-Leitfaden Testanzeige hinzufügen, um Pangle-Testanzeigen zu aktivieren.
Schritt 2: Pangle-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.
Schritt 3: Pangle SDK und Adapter importieren
Einbindung über pub.dev
(Nur Android) Fügen Sie der Datei build.gradle
im Verzeichnis android
Ihres Projekts die folgenden Repositories hinzu:
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
Fügen Sie der Datei pubspec.yaml
Ihres Pakets die folgende Abhängigkeit mit den neuesten Versionen des Pangle SDK und des Adapters hinzu:
dependencies:
gma_mediation_pangle: ^1.0.0
Manuelle Integration
Laden Sie die neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für Pangle herunter, extrahieren Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner (und seinen Inhalt) Ihrem Flutter-Projekt hinzu. Verweisen Sie dann in Ihrer pubspec.yaml
-Datei auf das Plug-in, indem Sie die folgende Abhängigkeit hinzufügen:
dependencies:
gma_mediation_pangle:
path: path/to/local/package
Schritt 4: Erforderlichen Code hinzufügen
Android
Für die Pangle-Integration ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Folgen Sie der Dokumentation von Pangle, um die SKAdNetwork-IDs der Info.plist
-Datei Ihres Projekts hinzuzufügen.
Schritt 5: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob und aktivieren Sie den Testmodus in der Pangle-Benutzeroberfläche.
Testanzeigen bestätigen
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 (Bidding) und Pangle (Abfolge).
Fehlercodes
Wenn der Adapter keine Anzeige von Pangle empfängt, können Publisher den zugrunde liegenden Fehler in der Anzeigenantwort mithilfe von ResponseInfo
in den folgenden Klassen prüfen:
Android
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
Hier sind die Codes und die zugehörigen Meldungen, die vom Pangle-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
Android
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 nicht einer 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. |
iOS
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 nicht einer von Pangle unterstützten Bannergröße. |
-1-60000 | Vom Pangle SDK gesendet | Das Pangle SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation von Pangle. |
Änderungsprotokoll für den Pangle Flutter Mediation Adapter
Nächste Version
- Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in, Version 5.2.0.
2.0.0
- Kompatibilität mit der Pangle-Android-Adapterversion 6.1.0.9.0 bestätigt.
- Kompatibilität mit der Pangle iOS-Adapterversion 6.2.0.5.0 bestätigt.
- Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in der Version 5.1.0.
1.1.0
- Kompatibilität mit der Pangle-Android-Adapterversion 5.9.0.4.0 bestätigt.
- Kompatibilität mit der Pangle iOS-Adapterversion 5.9.0.7.0 bestätigt.
- Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in der Version 5.1.0.
1.0.0
- Erste Version
- Kompatibilität mit der Pangle-Android-Adapterversion 5.8.0.9.0 bestätigt
- Kompatibilität mit der Pangle iOS-Adapterversion 5.8.0.8.0 bestätigt
- Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 5.0.0.