In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Line mithilfe von AdMob Mediation laden und präsentieren. Dabei werden auch Abfolgeintegrationen behandelt. Dort erfahren Sie, wie Sie Line der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Line SDK und den Adapter in eine Android-App einbinden.
Die Benutzeroberfläche des Dashboards für das LINE Ads Network ist auf Japanisch. 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 das LINE Ads Network bietet folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall | 1 |
Formate | |
Banner | |
Interstitial | |
Verfügbar | |
Nativ |
Voraussetzungen
- Android API-Level 21 oder höher
Neueste Version des Google Mobile Ads SDK
Mediation abschließen Startleitfaden
Schritt 1: Konfigurationen in der LINE Ads Network-Benutzeroberfläche einrichten
Melden Sie sich in Ihrem LINE Ads Network-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
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: Nachfrage des LINE Ads-Werbenetzwerks in der AdMob-Benutzeroberfläche einrichten
Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren
Sie müssen LINE Ads Network 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 vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten. Fahren Sie dann mit LINE Ads Network 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:
LINE Ads Network als Anzeigenquelle hinzufügen
Gebote
Wählen Sie unter Bidding im Bereich Anzeigenquellen die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann LINE Ads Network aus.
Klicken Sie auf Partnervereinbarung unterzeichnen und richten Sie eine Bidding-Partnerschaft mit dem LINE Ads Network ein.
Klicken Sie auf Bestätigen und zustimmen und dann auf Weiter.
Wenn Sie bereits eine Zuordnung für das LINE Ads Network 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 Abfolge im Bereich Anzeigenquellen die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann LINE Ads Network aus.
Wählen Sie LINE Ads Network aus. Geben Sie dann einen eCPM-Wert für das LINE Ads-Werbenetzwerk ein und klicken Sie auf Weiter.
Wenn Sie bereits eine Zuordnung für das LINE Ads-Netzwerk 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 Ads Network SDK und Adapter importieren
Android Studio-Integration (empfohlen)
Fügen Sie in der build.gradle.kts
-Datei auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu. Verwenden Sie die neuesten Versionen des LINE Ads Network SDK und des Adapters:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.google.ads.mediation:line:2.9.20241129.0")
}
Manuelle Integration
Laden Sie die neueste Version der
.aar
-Datei des LINE Ads Network SDK herunter und fügen Sie sie Ihrem Projekt hinzu.Rufe die LINE Ads Network-Adapter-Artefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die
.aar
-Datei des LINE Ads-Netzwerkadapters herunter und fügen Sie sie Ihrem Projekt hinzu.
Schritt 4: Erforderlichen Code hinzufügen
Für die Integration in das LINE Ads Network ist kein zusätzlicher Code erforderlich.
Schritt 5: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob.
Testanzeigen prüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen vom LINE Ads-Werbenetzwerk erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquellen LINE Ads-Werbenetzwerk (Vermittlungsabfolge).
Optionale Schritte
Netzwerkspezifische Parameter
Der LINE Ads Network-Adapter unterstützt einen zusätzlichen Anfrageparameter, der über die LineExtras
-Klasse an den Adapter übergeben werden kann. Dieser Klassenkonstruktor umfasst die folgenden Parameter:
enableAdSound
- A
boolean
, um den Standardstartstatus für den Ton von Banner-, Interstitial- und Anzeigen mit Prämie anzugeben.
Hier ein Codebeispiel für die Erstellung einer Anzeigenanfrage, in der diese Parameter festgelegt werden:
Java
LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
Kotlin
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
.build()
Native Anzeigen verwenden
Anzeigen-Rendering
Der LINE Ads Network-Adapter füllt die folgenden erweiterten Feldbeschreibungen für native Anzeigen für eine NativeAd
aus.
Feld | Assets, die vom LINE Ads Network-Adapter immer berücksichtigt werden |
---|---|
Anzeigentitel | |
Bild | |
Text | |
App-Symbol | 1 |
Call-to-Action | |
Bewertung | |
Shop | |
Preis |
1 Für native Anzeigen stellt das LINE Ads Network SDK kein App-Symbol-Asset bereit. Stattdessen wird das App-Symbol vom LINE Ads Network-Adapter mit einem transparenten Bild gefüllt.
Fehlercodes
Wenn der Adapter keine Anzeige vom LINE Ads Network empfängt, kannst du den zugrunde liegenden Fehler in der Anzeigenantwort mithilfe von ResponseInfo.getAdapterResponses()
unter den folgenden Klassen prüfen:
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
Im Folgenden finden Sie die Codes und die zugehörigen Meldungen, die vom LINE Ads Network-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
Fehlercode | Domain | Grund |
---|---|---|
1-10 | com.five_corp.ad | Das LINE Ads Network SDK hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation zum LINE Ads-Werbenetzwerk. |
101 | com.google.ads.mediation.line | Fehlende oder ungültige App-ID. |
102 | com.google.ads.mediation.line | Die Steckplatz-ID fehlt oder ist ungültig. |
103 | com.google.ads.mediation.line | Die angeforderte Anzeigengröße entspricht nicht einer vom LINE Ads Network unterstützten Banneranzeigengröße. |
104 | com.google.ads.mediation.line | Das Laden eines Interstitials oder einer Anzeige mit Prämie ist aufgrund eines fehlenden Aktivitätskontexts fehlgeschlagen. |
105 | com.google.ads.mediation.line | Das LINE Ads Network SDK konnte keine Interstitial- oder Anzeigen mit Prämie ausliefern. |
106 | com.google.ads.mediation.line | Das Laden einer nativen Anzeige ist aufgrund fehlender Assets fehlgeschlagen. |
Änderungslog für den LINE Android-Vermittlungsadapter
Nächste Version
- Der Prozess zur Erfassung von Signalen wurde optimiert.
Version 2.9.20241129.0
- Unterstützung für Gebote für Banner-, Interstitial-, Anzeigen mit Prämie und native Anzeigenformate hinzugefügt.
- Kompatibilität mit der FiveAd SDK-Version 2.9.20241129.0 bestätigt
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 23.5.0
- FiveAd SDK-Version 2.9.20241129.0
Version 2.8.20240827.0
- Kompatibilität mit FiveAd SDK-Version 2.8.20240827.0 bestätigt
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 23.3.0
- FiveAd SDK-Version 2.8.20240827.0
Version 2.8.20240808.0
- Kompatibilität mit FiveAd SDK-Version 2.8.20240808.0 bestätigt
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 23.2.0
- FiveAd SDK-Version 2.8.20240808.0
Version 2.8.20240722.0
- Kompatibilität mit der FiveAd SDK-Version 2.8.20240722.0 bestätigt
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 23.2.0
- FiveAd SDK-Version 2.8.20240722.0
Version 2.7.20240515.0
- Kompatibilität mit der FiveAd SDK-Version 2.7.20240515.0 bestätigt
Entwickelt und getestet mit:
- Google Mobile Ads SDK-Version 23.1.0
- FiveAd SDK-Version 2.7.20240515.0
Version 2.7.20240214.1
- Die Mindestversion des Google Mobile Ads SDK wurde auf 23.0.0 aktualisiert.
- Kompatibilität mit der FiveAd SDK-Version 2.7.20240214.0 bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 23.0.0
- FiveAd SDK-Version 2.7.20240214.0.
Version 2.7.20240214.0
- Kompatibilität mit der FiveAd SDK-Version 2.7.20240214.0 bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 22.6.0
- FiveAd SDK-Version 2.7.20240214.0.
Version 2.7.20240126.0
- Kompatibilität mit der FiveAd SDK-Version 2.7.20240126.0 bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 22.6.0
- FiveAd SDK-Version 2.7.20240126.0.
Version 2.7.20240112.0
- Die Einstellung von
FiveAdViewEventListener
zugunsten vonFiveAdCustomLayoutEventListener
,FiveAdVideoRewardEventListener
,FiveAdInterstitialEventListener
undFiveAdNativeEventListener
. - Kompatibilität mit der FiveAd SDK-Version 2.7.20240112 bestätigt.
- Die Mindestversion des Google Mobile Ads SDK wurde auf 22.6.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 22.6.0
- FiveAd SDK-Version 2.7.20240112.
Version 2.6.20230607.1
- Die Klasse
LineExtras
wurde hinzugefügt, damit Publisher Standardeinstellungen für die Audiowiedergabe für Banner-, Interstitial- und Anzeigenformate mit Prämie festlegen können. - Die Mindestversion des Google Mobile Ads SDK wurde auf 22.4.0 aktualisiert.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 22.4.0
- FiveAd SDK-Version 2.6.20230607.
Version 2.6.20230607.0
- Erste Version
- Unterstützung für Banner-, Interstitial-, Anzeigen mit Prämie und native Anzeigenformate.
- Kompatibilität mit der FiveAd SDK-Version 2.6.20230607 bestätigt.
Entwickelt und getestet mit:
- Google Mobile Ads SDK Version 22.1.0
- FiveAd SDK-Version 2.6.20230607.