In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Line mithilfe der Vermittlung und 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 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 sind Labels und Schaltflächen jedoch übersetzt und die englischen Entsprechungen stehen in Klammern.
Unterstützte Einbindungen und Anzeigenformate
Der Vermittlungsadapter für Line hat folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall | 1 |
Formate | |
Banner | |
Interstitial | |
Verfügbar | |
Nativ |
1 Die abfolgebasierte Integration befindet sich in der geschlossenen Betaphase. Wenden Sie sich an Ihren Account Manager, um Zugriff zu erhalten.
Voraussetzungen
- Android API-Level 21 oder höher
Neueste Version des Google Mobile Ads SDK
Schließen Sie die Vermittlung ab. Startleitfaden
Schritt 1: Konfigurationen in Line UI 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
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ülle das Formular aus und klicke anschließend auf (⩍) Registrieren.
Notieren Sie sich die Slot-ID.
Schritt 2: Werbebuchungsnachfrage in Ad Manager Benutzeroberfläche einrichten
Schritt 3: Line 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 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
Laden Sie die neueste Version der Datei
.aar
des Line SDK herunter und fügen Sie sie Ihrem Projekt hinzu.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 Line-Dokumentation, um Testanzeigen in Line zu aktivieren.
Testanzeigen bestätigen
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();
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
Kotlin
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
.build()
Native Anzeigen verwenden
Anzeigen-Rendering
Der Zeilenadapter füllt die folgenden
für eine
NativeAd
aus.
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 aus der Anzeigenantwort prüfen. Verwenden Sie dazu
ResponseInfo.getAdapterResponses()
in den folgenden Klassen:
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 zu 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 | Das Line 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
- 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 aktivieren.
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
- Die Kompatibilität mit der FiveAd SDK-Version 2.7.20240126.0 wurde 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 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.