In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Line mithilfe der AdMob-Vermittlung, der Abfolgeintegrationen laden und anzeigen. Darin wird beschrieben, wie Sie Line der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Line SDK und den Adapter in eine iOS App einbinden.
Die Dashboard-Oberfläche für Line verwendet japanischen Text für Labels, Schaltflächen und Beschreibungen. Die Screenshots in diesem Leitfaden wurden nicht übersetzt. In den Beschreibungen und Anleitungen dieses Leitfadens sind Labels und Schaltflächen jedoch übersetzt und die englischen Entsprechungen stehen in Klammern.
Unterstützte Einbindungen und Anzeigenformate
Der Vermittlungsadapter für Line bietet folgende Funktionen:
Integration | |
---|---|
Gebote | 1 |
Wasserfall | 2 |
Formate | |
Banner | 3 |
Interstitial | 3 |
Verfügbar | |
Nativ |
2 Die abfolgebasierte Integration befindet sich in der offenen Betaphase.
3 Dieses Format wird nur bei der abfolgebasierten Integration unterstützt.
Voraussetzungen
- iOS-Bereitstellungsziel 12.0 oder höher
Neueste Version des Google Mobile Ads SDK
Mediation abschließen Startleitfaden
Schritt 1: Konfigurationen in der Line-Benutzeroberfläche einrichten
Melde dich in deinem Line-Konto an.
Neue Anwendung hinzufügen
Klicken Sie auf 広告枠管理 (Anzeigenflächenverwaltung) > メディア (Medien). Klicken Sie dann auf 新規作成 (Neu erstellen).
Füllen Sie das Formular aus und klicken Sie auf 登録 (Registrieren).
Notieren Sie sich die Anwendungs-ID.
Anzeigen-Placement erstellen
Folgen Sie denselben Schritten, um Anzeigen-Placements sowohl für Gebote als auch für abfolgebasierte Integrationen zu erstellen. Jedes Anzeigen-Placement kann für beides verwendet werden.Klicken Sie auf die ID der Anwendung, der Sie ein Anzeigen-Placement hinzufügen möchten. Wählen Sie dann 詳細 (Detail) aus.
Klicken Sie auf スロット 追加 (Add Slot).
Füllen Sie das Formular aus und klicken Sie dann auf (登録) Registrieren.
Notieren Sie sich die Steckplatz-ID.
Schritt 2: Liniennachfrage in der AdMob -Benutzeroberfläche einrichten
Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren
Sie müssen „Line“ der Vermittlungskonfiguration für Ihren Anzeigenblock hinzufügen.
Melden Sie sich zuerst in Ihrem AdMob-Konto an. Rufen Sie als Nächstes den Tab Vermittlung auf. Wenn Sie eine bestehende Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten. Fahren Sie dann mit Zeile 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 Ihrer Vermittlungsgruppe einen Namen und wählen Sie die Standorte aus, auf die Sie Ihre Anzeigen ausrichten möchten. Legen Sie als Nächstes den Status der Vermittlungsgruppe auf Aktiviert fest und klicken Sie dann auf Anzeigenblöcke hinzufügen.
Weisen Sie diese Vermittlungsgruppe mindestens einem Ihrer vorhandenen AdMob-Anzeigenblöcke zu. Klicken Sie dann auf Fertig.
Die Karte „Anzeigenblöcke“ sollte jetzt die von Ihnen ausgewählten Anzeigenblöcke enthalten:
Google-Suchanzeigen als Anzeigenquelle hinzufügen
Gebote
Wählen Sie unter Bidding im Bereich Anzeigenquellen die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann Linie aus.
Klicken Sie auf Partnervereinbarung unterzeichnen und richten Sie eine Bidding-Partnerschaft mit Line ein.
Klicken Sie auf Bestätigen und zustimmen und dann auf Weiter.
Wenn Sie bereits eine Zuordnung für „Linie“ haben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.
Geben Sie als Nächstes die Anwendungs-ID und die Slot-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.
Wasserfall
Wählen Sie unter der Karte Abfolge im Bereich Anzeigenquellen die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann Linie aus.
Wählen Sie Zeile aus. Geben Sie dann einen eCPM-Wert für „Zeile“ ein und klicken Sie auf Weiter.
Wenn Sie bereits eine Zuordnung für „Linie“ haben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.
Geben Sie als Nächstes die Anwendungs-ID und die Slot-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.
Schritt 3: Line SDK und Adapter importieren
Mit CocoaPods (empfohlen)
Fügen Sie der Podfile Ihres Projekts die folgende Zeile hinzu:
pod 'GoogleMobileAdsMediationLine'
Führen Sie in der Befehlszeile folgenden Befehl aus:
pod install --repo-update
Manuelle Integration
- Laden Sie die neueste Version des Line SDK herunter und verknüpfen Sie
FiveAd.framework
mit Ihrem Projekt. - Lade die neueste Version des Line-Adapters über den Downloadlink im Änderungslog herunter und verknüpfe
LineAdapter.framework
in deinem Projekt.
Schritt 4: Erforderlichen Code hinzufügen
SKAdNetwork-Integration
Folgen Sie der Dokumentation von Line, um die SKAdNetwork-IDs der Datei Info.plist
Ihres Projekts hinzuzufügen.
Schritt 5: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob.
Folgen Sie der Anleitung in der Line-Dokumentation, um Testanzeigen in Line zu aktivieren.
Testanzeigen bestätigen
Wenn Sie prüfen möchten, ob Sie Testanzeigen von Google Line erhalten, aktivieren Sie im Anzeigenprüftool die Option Einzelne Anzeigenquelle testen und verwenden Sie die Anzeigenquellen Google Line (Abfolge).
Optionale Schritte
Netzwerkspezifische Parameter
Der Line-Adapter unterstützt einen zusätzlichen Anfrageparameter, der über die GADMediationAdapterLineExtras
-Klasse an den Adapter übergeben werden kann. Diese Klasse umfasst die folgenden Eigenschaften:
adAudio
- Gibt den Standardstartstatus für den Ton von Banner-, Interstitial- und Anzeigen mit Prämie an.
Hier ein Codebeispiel für die Erstellung einer Anzeigenanfrage, in der diese Parameter festgelegt werden:
Swift
import LineAdapter
// ...
let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)
Objective-C
#import <LineAdapter/LineAdapter.h>
// ...
GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];
Native Anzeigen verwenden
Anzeigen-Rendering
Der Zeilenadapter füllt die folgenden
Felder für erweiterte native Anzeigen
für eine
GADNativeAd
.
Feld | Assets, die immer vom Line-Adapter eingeschlossen werden |
---|---|
Anzeigentitel | |
Bild | |
Text | |
App-Symbol | 1 |
Call-to-Action | |
Bewertung | |
Shop | |
Preis |
1 Für native Anzeigen stellt das Line SDK kein App-Symbol-Asset bereit. Stattdessen wird das App-Symbol vom Line-Adapter mit einem transparenten Bild ausgefüllt.
Fehlercodes
Wenn der Adapter keine Anzeige von Line empfängt, können Sie den zugrunde liegenden Fehler in der Anzeigenantwort mithilfe von
GADResponseInfo.adNetworkInfoArray
unter den folgenden Klassen:
GADMediationAdapterLine
Im Folgenden finden Sie die Codes und zugehörigen Meldungen, die vom Line-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
Fehlercode | Domain | Grund |
---|---|---|
1-10 | Vom Line SDK gesendet | Das Line SDK hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation zu Line. |
101 | com.google.ads.mediation.line | Ungültige Serverparameter (z. B. fehlende Anwendungs- oder Slot-ID) |
102 | com.google.ads.mediation.line | Die angeforderte Anzeigengröße entspricht nicht einer von Google Line unterstützten Banneranzeigengröße. |
103 | com.google.ads.mediation.line | Das Bild-Asset für das Informationssymbol konnte nicht in die native Anzeige geladen werden. |
Änderungsprotokoll für den LINE iOS-Vermittlungsadapter
Version 2.9.20241106.1
- Der Adapter wurde aktualisiert, sodass die neueste API zum Laden von Anzeigen für Gebote für Banneranzeigen verwendet wird.
- Ein Problem wurde behoben, das dazu führte, dass Anzeigenereignisse für Gebote für Interstitial-Anzeigen nicht richtig weitergeleitet wurden.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 11.12.0
- FiveAd SDK-Version 2.9.20241106.
Version 2.9.20241106.0
- Kompatibilität mit der FiveAd SDK-Version 2.9.20241106 bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 11.12.0
- FiveAd SDK-Version 2.9.20241106.
Version 2.8.20240827.1
CFBundleShortVersionString
wurde auf drei statt vier Komponenten aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 11.10.0
- FiveAd SDK-Version 2.8.20240827.
Version 2.8.20240827.0
- Kompatibilität mit der FiveAd SDK-Version 2.8.20240827 bestätigt.
- Unterstützung für Gebote für Banner-, Interstitial-, Anzeigen mit Prämie und native Anzeigenformate hinzugefügt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 11.8.0
- FiveAd SDK-Version 2.8.20240827.
Version 2.8.20240612.0
- Audiosteuerung für native Anzeigen über GADVideoOptions hinzugefügt.
- Kompatibilität mit der FiveAd SDK-Version 2.8.20240612 bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 11.5.0
- FiveAd SDK-Version 2.8.20240612.
Version 2.7.20240411.0
- Kompatibilität mit der FiveAd SDK-Version 2.7.20240411 bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 11.3.0
- FiveAd SDK-Version 2.7.20240411.
Version 2.7.20240318.0
- Kompatibilität mit der FiveAd SDK-Version 2.7.20240318 bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK-Version 11.2.0
- FiveAd SDK-Version 2.7.20240318.
Version 2.7.20240214.1
- Jetzt ist mindestens iOS 12.0 erforderlich.
- Jetzt ist das Google Mobile Ads SDK Version 11.0 oder höher erforderlich.
Info.plist
in die Frameworks inLineAdapter.xcframework
aufgenommen.
Entwickelt und getestet mit:
- Google Mobile Ads SDK-Version 11.0.1
- FiveAd SDK-Version 2.7.20240214.
Version 2.7.20240214.0
- Kompatibilität mit der FiveAd SDK-Version 2.7.20240214 bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK-Version 11.0.1
- FiveAd SDK-Version 2.7.20240214.
Version 2.7.20240126.0
- Kompatibilität mit der FiveAd SDK-Version 2.7.20240126 bestätigt.
- Die Adapterimplementierung wurde mit den neuen delegierten Protokollen des FiveAd SDK aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 10.14.0
- FiveAd SDK-Version 2.7.20240126.
Version 2.7.20231115.0
- Kompatibilität mit der FiveAd SDK-Version 2.7.20231115 bestätigt.
GADMediationAdapterLineExtras
-Header in die modulemap eingefügt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 10.14.0
- FiveAd SDK-Version 2.7.20231115.
Version 2.6.20230609.1
GADMediationAdapterLineAudioState
wurde hinzugefügt, um den anfänglichen Audiostatus von Bannern, Interstitials und Anzeigen mit Prämie zu verwalten, wenn sie zum ersten Mal ausgeliefert werden.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 10.14.0
- FiveAd SDK-Version 2.6.20230609.
Version 2.6.20230609.0
- Erstes Release!
- Unterstützung für die Vermittlungsabfolge für Banner-, Interstitial-, Anzeigen mit Prämie und native Anzeigenformate hinzugefügt.
- Kompatibilität mit der FiveAd SDK-Version 2.6.20230609 bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 10.9.0
- FiveAd SDK-Version 2.6.20230609.