In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus Pangle mithilfe der Vermittlung zu laden und einzublenden. Dabei werden Bidding -Integrationen berücksichtigt. Dort erfahren Sie, wie Sie Pangle der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Pangle SDK und den Adapter in eine App einbinden. Flutter
Unterstützte Einbindungen und Anzeigenformate
Der Vermittlungsadapter Ad Manager für Pangle hat folgende Funktionen:
| Integration | |
|---|---|
| Gebote | |
| Wasserfall | 1 |
| Formate | |
| Banner | |
| Interstitial | |
| Verfügbar | |
| Interstitial mit Prämie | |
Voraussetzungen
- Neuestes Google Mobile Ads SDK
- Flutter 3.7.0 oder höher
- 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
Gehen Sie zum Tab Applications (Anwendungen) und klicken Sie auf die Schaltfläche Add App (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.
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 Ihr Anzeigenformat und den Namen des Anzeigen-Placements aus und legen Sie als Preistyp In-App-Gebote fest. Füllen Sie den Rest des Formulars aus und klicken Sie auf Senden.
Notieren Sie sich nach der Erstellung des Anzeigen-Placements die Anzeigen-Placement-ID.
Android
iOS
Wasserfall
Wählen Sie Ihr Anzeigenformat und den Namen des Anzeigen-Placements sowie Globaler CPM als Preistyp aus. 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 Ad Manager Benutzeroberfläche einrichten
Schritt 3: Pangle SDK und Adapter importieren
Integration ü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 desPangle 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 Datei Info.plist Ihres Projekts hinzuzufügen.
Schritt 5: Implementierung testen
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
Im Folgenden finden Sie 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 stimmt nicht mit einer von Pangle unterstützten Bannergröße überein. |
| -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 Plugin 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.