In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen von Mai mithilfe der Vermittlung zu laden und einzublenden. Dabei werden auch abfolgebasierte Integrationen berücksichtigt. Sie erfahren, wie Sie Mai zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Mai-SDK und den Adapter in eineiOS -App einbinden.
Die Dashboard-Oberfläche für Mai verwendet für die Beschriftungen, Schaltflächen und Beschreibungen japanischer Text. Die Screenshots in diesem Leitfaden wurden nicht übersetzt. In den Beschreibungen und Anleitungen dieses Leitfadens wird jedoch auf die Beschriftungen und Schaltflächen in der entsprechenden englischen Sprache verwiesen. Zum Beispiel ist "URL 名キーム" „URL Scheme“ und so weiter.
Unterstützte Integrationen und Anzeigenformate
Der AdMob -Vermittlungsadapter für maio hat folgende Funktionen:
| Integration | |
|---|---|
| Gebote | |
| Wasserfall | |
| Formate | |
| Banner | |
| Interstitial | |
| Verfügbar | |
| Nativ | |
Voraussetzungen
- iOS-Bereitstellungsziel von 12.0 oder höher
- [Für Gebote]: Mai-Adapter 1.5.8.0 oder höher (neueste Version empfohlen)
Das aktuelle Google Mobile Ads SDK
Arbeiten Sie den Startleitfaden zur Vermittlung ab.
Schritt 1: Konfigurationen in der Mai-Benutzeroberfläche einrichten
Registrieren Sie sich oder melden Sie sich in Ihrem maio-Konto an. Klicken Sie in der linken Seitenleiste auf die Schaltfläche Anwendungsverwaltung und dann auf Neue App.
Wählen Sie den Tab für den gewünschten Anzeigentyp aus.
Interstitial
Geben Sie den Namen der App ein, wählen Sie die Plattform aus und geben Sie die App-URL an. Wählen Sie als Anzeigentyp Video-Interstitial aus und klicken Sie dann auf Aktualisieren.
Verfügbar
Geben Sie den Namen der App ein, wählen Sie die Plattform aus und geben Sie die App-URL an. Wählen Sie als Anzeigentyp Videoprämien aus und klicken Sie dann auf Aktualisieren.
Notieren Sie sich auf der Seite Anwendungsverwaltung die Medien-ID. Sie müssen ihn im nächsten Abschnitt einrichten, um den Anzeigenblock AdMob einzurichten.
Notieren Sie sich auf der Seite Zone Management (Zonenverwaltung) die Zone ID (Zonen-ID). Außerdem müssen Sie ihn im nächsten Abschnitt für die Einrichtung des AdMob Anzeigenblocks konfigurieren.
Schritt 2: Mai-Nachfrage in AdMob der Benutzeroberfläche einrichten
Vermittlungseinstellungen für Anzeigenblöcke konfigurieren
Sie müssen der Vermittlungskonfiguration für Ihren Anzeigenblock maio hinzufügen.
Melden Sie sich in Ihrem AdMob-Konto an. Rufen Sie als Nächstes den Tab Vermittlung auf. Wenn Sie eine bestehende Vermittlungsgruppe ändern möchten, klicken Sie zum Bearbeiten auf ihren Namen und fahren Sie mit maio 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. Klicken Sie dann auf Weiter.
Geben Sie einen Namen für die Vermittlungsgruppe ein und wählen Sie Standorte für die Ausrichtung aus. Legen Sie als Nächstes den Status der Vermittlungsgruppe auf Aktiviert fest und klicken Sie dann auf Anzeigenblöcke hinzufügen.
Verknüpfen Sie diese Vermittlungsgruppe mit einem oder mehreren Ihrer vorhandenenAdMob Anzeigenblöcke. Klicken Sie dann auf Fertig.
Die Karte „Anzeigenblöcke“ sollte jetzt mit den ausgewählten Anzeigenblöcken gefüllt sein:
maio als Anzeigenquelle hinzufügen
Gebote
Wählen Sie auf der Karte Gebote im Abschnitt Anzeigenquellen die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann maio aus.
Klicken Sie auf So unterzeichnen Sie eine Partnervereinbarung und richten Sie eine Bidding-Partnerschaft mitmaioein.
Klicken Sie auf Bestätigen und akzeptieren und dann auf Weiter.
Wenn Sie bereits eine Zuordnung für maiohaben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.
Geben Sie als Nächstes den Publisher IDein, den Sie im vorherigen Abschnitt erhalten haben. Klicken Sie dann auf Fertig.
Wichtig: Media ID muss wie auf dermaio -Benutzeroberfläche mit der Ziel-App verknüpft sein.
Wasserfall
Wählen Sie im Bereich Anzeigenquellen auf der Karte Abfolge die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann maio aus.
Wählen Sie maio aus und aktivieren Sie den Schalter Optimieren. Geben Sie den API ID and API KEYein, den Sie im vorherigen Abschnitt erhalten haben, um die Optimierung der Anzeigenquelle fürmaioeinzurichten. Geben Sie dann einen eCPM-Wert fürmaio ein und klicken Sie auf Weiter.
Wenn Sie bereits eine Zuordnung für maiohaben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.
Geben Sie als Nächstes den Media ID and Zone IDein, den Sie im vorherigen Abschnitt erhalten haben. Klicken Sie dann auf Fertig.
Schritt 3: Mai-SDK und Adapter importieren
CocoaPods verwenden (empfohlen)
Fügen Sie der Podfile-Datei Ihres Projekts die folgende Zeile hinzu:
pod 'GoogleMobileAdsMediationMaio'Führen Sie über die Befehlszeile folgenden Befehl aus:
pod install --repo-update
Manuelle Integration
- Laden Sie die neueste Version des maio SDK herunter.
- Laden Sie die neueste Version des Mai-Adapters über den Download-Link im Änderungsprotokoll herunter und verknüpfen Sie
maioAdapter.frameworkin Ihrem Projekt.
Schritt 4: Erforderlichen Code hinzufügen
SKAdNetwork-Integration
Folgen Sie der Dokumentation von maio, um die SKAdNetwork-IDs in die Datei Info.plist Ihres Projekts einzufügen.
Schritt 5: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob.
Publisher, die das Google Mobile Ads SDK der Version 7.26.0 oder höher verwenden, erhalten bei Anfragen automatisch Testanzeigen von maio auf Smartphones und Tablets, die als Testgeräte registriert sind.
Testanzeigen überprüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen vonmaioerhalten, aktivieren Sie im Anzeigenprüftool mithilfe der maio (Bidding) and maio (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.
Fehlercodes
Erhält der Adapter keine Anzeige von maio, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit
GADResponseInfo.adNetworkInfoArray unter den folgenden Klassen:
| Format | Klassenname |
|---|---|
| Interstitial | GADMMaioInterstitialAdapter |
| Verfügbar | GADMMaioRewardedAdapter |
Hier sehen Sie die Codes und Begleitmeldungen, die vom Maiio-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
| Fehlercode | Grund |
|---|---|
| 0-10 | maio hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie in der Code-Dokumentation und in der Dokumentation von maio. |
| 101 | Maio hat keine Anzeige. |
| 102 | Ungültige Serverparameter (z. B. fehlende Placement-ID) |
| 103 | Der zum Laden einer Anzeige verwendete Kontext war keine „Activity“-Instanz. |
| 0-10 | maio hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie im Code von maio. |
| 101 | Mai hat noch keine Anzeige. |
| 102 | Ungültige Serverparameter (z. B. fehlende Placement-ID) |
| 103 | Das angeforderte Anzeigenformat wird vom Mai-Adapter nicht unterstützt. |
| 104 | Für diese Netzwerkkonfiguration wurde bereits eine Anzeige geladen. |
maio iOS-Vermittlungsadapter Änderungsprotokoll
Version 2.1.3.0
- Bestätigte Kompatibilität mit maio SDK Version 2.1.3.
Erstellt und getestet mit:
- Version 11.1.0 des Google Mobile Ads SDK
- Maio SDK, Version 2.1.3.
Version 2.1.2.1
- Erfordert jetzt Version 11.0 oder höher des Google Mobile Ads SDK.
Info.plistwurde in die Frameworks innerhalb vonMaioAdapter.xcframeworkaufgenommen.
Erstellt und getestet mit:
- Google Mobile Ads SDK, Version 11.0.1.
- Maio SDK, Version 2.1.2.
Version 2.1.2.0
- Bestätigte Kompatibilität mit maio SDK Version 2.1.2.
Erstellt und getestet mit:
- Version 10.14.0 des Google Mobile Ads SDK
- Maio SDK, Version 2.1.2.
Version 2.1.1.0
- Bestätigte Kompatibilität mit maio SDK Version 2.1.1.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 10.12.0.
- Maio SDK-Version 2.1.1.
Version 2.0.0.0
- Bestätigte Kompatibilität mit maio SDK Version 2.0.0.
- Die Abhängigkeit von
MaioOB SDKwurde entfernt. - Die Unterstützung der
armv7-Architektur wurde entfernt. - Mindestens iOS-Version 12.0 erforderlich.
- Erfordert jetzt Version 10.4.0 oder höher des Google Mobile Ads SDK.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 10.10.0.
- Maio SDK Version 2.0.0.
Version 1.6.3.1
- Erfordert jetzt Version 10.0.0 oder höher des Google Mobile Ads SDK.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 10.0.0.
- Maio SDK-Version 1.6.3.
- MaioOB SDK-Version 2.0.0-alpha.
Version 1.6.3.0
- Der Adapter wurde aktualisiert, um die
didRewardUserAPI zu verwenden. - Erfordert jetzt das Google Mobile Ads SDK, Version 9.8.0 oder höher.
- Bestätigte Kompatibilität mit maio SDK Version 1.6.3 und maioOB SDK Version 2.0.0-alpha.
Erstellt und getestet mit:
- Version 9.12.0 des Google Mobile Ads SDK
- Maio SDK-Version 1.6.3.
- MaioOB SDK-Version 2.0.0-alpha.
Version 1.6.2.0
- Bestätigte Kompatibilität mit maio SDK Version 1.6.2 und maioOB SDK Version 2.0.0-alpha.
Erstellt und getestet mit:
- Version 9.5.0 des Google Mobile Ads SDK
- Maio SDK-Version 1.6.2.
- MaioOB SDK-Version 2.0.0-alpha.
Version 1.6.1.0
- Bestätigte Kompatibilität mit maio SDK Version 1.6.1 und maioOB SDK Version 2.0.0-alpha.
Erstellt und getestet mit:
- Version 9.2.0 des Google Mobile Ads SDK.
- Maio SDK-Version 1.6.1.
- MaioOB SDK-Version 2.0.0-alpha.
Version 1.6.0.1
- Bestätigte Kompatibilität mit Version 9.0.0 des Google Mobile Ads SDK.
- Erfordert jetzt Version 9.0.0 oder höher des Google Mobile Ads SDK.
Erstellt und getestet mit:
- Version 9.0.0 des Google Mobile Ads SDK.
- Maio SDK-Version 1.6.0.
- MaioOB SDK-Version 2.0.0-alpha.
Version 1.6.0.0
- Bestätigte Kompatibilität mit maio SDK Version 1.6.0 und maioOB SDK Version 2.0.0-alpha.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 8.13.0.
- Mindestens iOS-Version 10.0 erforderlich.
- Maio SDK-Version 1.6.0.
- MaioOB SDK-Version 2.0.0-alpha.
Version 1.5.8.0
- Bestätigte Kompatibilität mit maio SDK Version 1.5.8 und maioOB SDK Version 2.0.0-alpha.
- Dem Adapter wurde eine Gebotsfunktion für Interstitial-Anzeigen und Anzeigenformate mit Prämie hinzugefügt.
- Einfache Abhängigkeit von Version 8.0.0 oder höher des Google Mobile Ads SDK
Erstellt und getestet mit:
- Version 8.7.0 des Google Mobile Ads SDK
- Maio SDK-Version 1.5.8.
- MaioOB SDK-Version 2.0.0-alpha.
Version 1.5.6.1
- Standardisierte Adapterfehlercodes und -meldungen hinzugefügt.
- Der Adapter wurde aktualisiert, um das Format
.xcframeworkzu verwenden. - Es wurde ein Fehler behoben, bei dem Ereignisse für Anzeigen mit Prämie manchmal nicht weitergeleitet wurden.
- Für das Google Mobile Ads SDK ist jetzt Version 8.3.0 oder höher erforderlich.
Erstellt und getestet mit:
- Version 8.3.0 des Google Mobile Ads SDK.
- Maio SDK-Version 1.5.6.
Version 1.5.6.0
- Bestätigte Kompatibilität mit maio SDK Version 1.5.6.
- Erfordert jetzt Version 7.68.0 oder höher des Google Mobile Ads SDK.
Erstellt und getestet mit:
- Version 7.68.0 des Google Mobile Ads SDK
- Maio SDK-Version 1.5.6.
Version 1.5.5.0
- Bestätigte Kompatibilität mit maio SDK Version 1.5.5.
- Erfordert jetzt das Google Mobile Ads SDK 7.64.0 oder höher.
Erstellt und getestet mit:
- Version 7.64.0 des Google Mobile Ads SDK
- Maio SDK-Version 1.5.5.
Version 1.5.4.0
- Bestätigte Kompatibilität mit maio SDK Version 1.5.4.
- Erfordert jetzt Version 7.60.0 oder höher des Google Mobile Ads SDK.
Erstellt und getestet mit:
- Version 7.60.0 des Google Mobile Ads SDK
- Maio SDK-Version 1.5.4.
Version 1.5.3.1
- Um Zeitüberschreitungen zu begrenzen, schlagen Anzeigenanfragen jetzt sofort fehl, wenn maio keine Anzeige zur Auslieferung bereit hat.
- Die Unterstützung der i386-Architektur wurde entfernt.
Erstellt und getestet mit:
- Version 7.58.0 des Google Mobile Ads SDK
- Maio SDK-Version 1.5.3.
Version 1.5.3.0
- Bestätigte Kompatibilität mit maio SDK Version 1.5.3.
Erstellt und getestet mit:
- Version 7.55.1 des Google Mobile Ads SDK
- Maio SDK-Version 1.5.3.
Version 1.5.2.1
- Der Adapter hat den
-rewardedAdDidPresent:-Callback nicht aufgerufen. Dieses Problem wurde behoben.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 7.53.1.
- Maio SDK-Version 1.5.2.
Version 1.5.2.0
- Bestätigte Kompatibilität mit maio SDK Version 1.5.2.
Erstellt und getestet mit:
- Google Mobile Ads SDK: Version 7.53.1.
- Maio SDK-Version 1.5.2.
Version 1.5.1.0
- Bestätigte Kompatibilität mit maio SDK Version 1.5.1.
Erstellt und getestet mit:
- Version 7.52.0 des Google Mobile Ads SDK
- Maio SDK-Version 1.5.1.
Version 1.5.0.0
- Bestätigte Kompatibilität mit maio SDK Version 1.5.0.
Erstellt und getestet mit
- Version 7.51.0 des Google Mobile Ads SDK
- Maio Ads SDK, Version 1.5.0.
Version 1.4.8.0
- Bestätigte Kompatibilität mit maio SDK Version 1.4.8.
Version 1.4.6.0
- Bestätigte Kompatibilität mit maio SDK Version 1.4.6.
- Der Adapter wurde aktualisiert, um die neue Prämien-API zu verwenden.
- Erfordert jetzt das Google Mobile Ads SDK 7.42.2 oder höher.
Version 1.4.2.0
- Bestätigte Kompatibilität mit maio SDK Version 1.4.2.
Version 1.4.1.0
- Bestätigte Kompatibilität mit maio SDK Version 1.4.1.
- Der Mai-Adapter schlug möglicherweise fehl, wenn mehrere MediaIDs von AdMob bereitgestellt wurden. Dieses Problem wurde behoben.
Version 1.4.0.0
- Bestätigte Kompatibilität mit maio SDK Version 1.4.0.
Version 1.3.2.0
- Bestätigte Kompatibilität mit maio SDK Version 1.3.2.
Version 1.3.1.1
- Dem Adapter wurde ein
adapterDidCompletePlayingRewardBasedVideoAd:-Callback hinzugefügt.
Version 1.3.1.0
- Bestätigte Kompatibilität mit maio SDK Version 1.3.1.
Version 1.3.0.0
- Bestätigte Kompatibilität mit maio SDK Version 1.3.0.
Version 1.2.19.0
- Bestätigte Kompatibilität mit Mai-SDK-Version 1.2.19.
Version 1.2.18.0
- Erste Version!
- Interstitials und Videoanzeigen mit Prämie werden jetzt unterstützt.