Zeile in die Vermittlung einbinden (Beta)

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus Line mithilfe von AdMob Mediation, abfolgebasierte Integrationen zu laden und einzublenden. Darin wird beschrieben, wie Sie Line der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Line SDK und den Adapter in eine Android 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 werden Labels und Schaltflächen jedoch mit ihren englischsprachigen Entsprechungen in Klammern übersetzt.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für Line bietet folgende Funktionen:

Integration
Gebote
Wasserfall	^1
Formate
Banner
Interstitial
Verfügbar
Nativ

¹ Die abfolgebasierte Integration befindet sich in der offenen Betaphase.

Voraussetzungen

• Android API-Level 21 oder höher

• Neueste Version des Google Mobile Ads SDK

• Mediation abschließen Startleitfaden

Schritt 1: Konfigurationen in Line UI einrichten

Melden Sie sich in Ihrem 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

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.

Hinweis :Wenden Sie sich an Ihren Account Manager für das Line Ads Network, um Zugriff zum Erstellen nativer Anzeigen-Placements in der Line-UI zu erhalten.

Notieren Sie sich die Slot-ID.

Schritt 2: Liniennachfrage in der AdMob -Benutzeroberfläche einrichten

Vermittlungseinstellungen für Anzeigenblöcke konfigurieren

Sie müssen der Vermittlungskonfiguration für Ihren Anzeigenblock Line 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 Line 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:

Line als Anzeigenquelle hinzufügen

Wählen Sie im Bereich Anzeigenquellen auf der Karte Abfolge die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann Line aus.

Wählen Sie Line aus. Geben Sie dann einen eCPM-Wert fürLine ein und klicken Sie auf Weiter.

Hinweis :Die Optimierung der Anzeigenquelle muss pro Netzwerk nur einmal eingerichtet werden.

Wenn Sie bereits eine Zuordnung für Linehaben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.

Geben Sie als Nächstes den Application ID and Slot IDein, den Sie im vorherigen Abschnitt erhalten haben. Klicken Sie dann auf Fertig.

Wichtig : Application ID muss wie in der BenutzeroberflächeLine mit der Ziel-App verknüpft sein.

Schritt 3: Line SDK und Adapter importieren

Hinweis: Wenn Sie die kompatiblen Versionen von Line und Google Mobile Ads SDK nicht integrieren, kann das zu Build-Problemen führen.

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 SDK und des Adapters:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:line:2.8.20240827.0")
}

Manuelle Integration

1. Laden Sie die neueste Version der Datei .aar des Line SDK herunter und fügen Sie sie Ihrem Projekt hinzu.

2. Rufen Sie die Artefakte für den Line Adapter im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die .aar-Datei des Linienadapters herunter und fügen Sie sie Ihrem Projekt hinzu.

Schritt 4: Erforderlichen Code hinzufügen

Für die Line-Integration ist kein zusätzlicher Code erforderlich.

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für AdMob.

Folgen Sie der Anleitung in der Dokumentation zu Line, um Line-Testanzeigen zu aktivieren.

Wichtig: Deaktivieren Sie den Testmodus für AdMob und Line, bevor Sie Ihre App veröffentlichen.

Testanzeigen überprüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von Line erhalten, aktivieren Sie im Anzeigenprüftool Tests für einzelne Anzeigenquellen mit den Anzeigenquellen Linie (Wasserfall).

Optionale Schritte

Netzwerkspezifische Parameter

Der Line-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

Über den Line Adapter werden die folgenden Feldbeschreibungen für erweiterte native Anzeigen für eine NativeAd ausgefüllt.

Feld	Assets, die immer vom Line-Adapter eingeschlossen werden
Anzeigentitel
Bild
Text
App-Symbol	^1
Call-to-Action
Bewertung
Shop
Preis

¹ 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 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-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Fehlercode	Domain	Grund
1-10	com.five_corp.ad	Das Line SDK hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation von Line.
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 stimmt nicht mit einer Banneranzeigegröße überein, die von Zeilen unterstützt wird.
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	Im Line SDK konnte keine Interstitial-Anzeige oder Anzeige mit Prämie ausgeliefert werden.
106	com.google.ads.mediation.line	Eine native Anzeige konnte aufgrund fehlender Assets nicht geladen werden.

Änderungslog für den LINE Android-Vermittlungsadapter

Nächste Version

• AdLoader wurde implementiert, um RTB für Banneranzeigen zu aktivieren.
• AdLoader wurde implementiert, um RTB für Interstitial-Anzeigen zu ermöglichen.
• AdLoader wurde implementiert, um RTB für Anzeigen mit Prämie zu aktivieren.
• AdLoader wurde implementiert, um RTB für native Anzeigen zu ermöglichen.

Version 2.8.20240827.0

• Die Kompatibilität mit FiveAd SDK-Version 2.8.20240827.0 wurde 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

• Die Kompatibilität mit FiveAd SDK-Version 2.8.20240722.0 wurde 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 verworfenen FiveAdViewEventListener-Elemente wurden zugunsten von FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener und FiveAdNativeEventListener entfernt.
• 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 mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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.