LINE Ads Network in die Vermittlung einbinden (Beta)

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Line mithilfe von Vermittlung laden und anzeigen. 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
1 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 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 Ad Manager-Benutzeroberfläche einrichten

Melden Sie sich in Ihrem Ad Manager-Konto an.

LINE Ads Network zu Unternehmen hinzufügen

Gebote

Dieser Schritt ist für Geboteinbindungen nicht erforderlich.

Wasserfall

Klicken Sie auf Verwaltung > Unternehmen und dann auf dem Tab Alle Unternehmen auf die Schaltfläche Neues Unternehmen. Wählen Sie Werbenetzwerk aus.

Wählen Sie LINE Ads Network als Werbenetzwerk aus, geben Sie einen eindeutigen Namen ein und aktivieren Sie Vermittlung.

Sie müssen keinen Nutzernamen oder ein Passwort eingeben. Klicken Sie abschließend auf Speichern.

Freigabe sicherer Signale aktivieren

Gebote

Klicken Sie auf Verwaltung > Globale Einstellungen. Rufen Sie den Tab Ad Exchange-Kontoeinstellungen auf und aktivieren Sie die Option Freigabe sicherer Signale. Klicken Sie auf Speichern.

Wasserfall

Dieser Schritt ist für abfolgebasierte Integrationen nicht erforderlich.

Gebote für das LINE Ads Network konfigurieren

Gebote

Klicken Sie auf Auslieferung > Bieter und dann auf dem Tab SDK-Gebote auf Neuer Bieter.

Wählen Sie als Bieter LINE Ads Network aus.

Aktivieren Sie die Optionen Signalbibliothek dieses Bieters der Liste der zulässigen Signale hinzufügen und Zulassen, dass Signale für diesen Bieter freigegeben werden. Klicken Sie dann auf Weiter.

Klicken Sie auf Weiter.

Klicken Sie auf Fertig.

Wasserfall

Dieser Schritt ist für abfolgebasierte Integrationen nicht erforderlich.

Anzeigenblockzuordnung konfigurieren

Gebote

Gehen Sie zu Auslieferung > Bieter und wählen Sie auf dem Tab SDK-Gebote das Unternehmen für das LINE Ads Network aus.

Klicken Sie auf den Tab Anzeigenblockzuordnung und dann auf Neue Anzeigenblockzuordnung.

Wählen Sie Bestimmter Anzeigenblock aus. Wählen Sie einen Anzeigenblock und ein Format sowie Mobile App als Inventartyp und Ihre mobile App aus. Geben Sie dann die Anwendungs-ID und die Slot-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie abschließend auf Speichern.

Wasserfall

Klicken Sie auf Auslieferung > Ertragsgruppen und dann auf die Schaltfläche Neue Ertragsgruppe. Wählen Sie Ihre Mobile App aus.

Scrollen Sie nach unten und klicken Sie auf Ertragspartner hinzufügen.

Wählen Sie das Unternehmen aus, das Sie im vorherigen Abschnitt für das LINE Ads Network erstellt haben. Wählen Sie als Integrationstyp SDK-Vermittlung für Mobilgeräte, als Plattform Android und als Status Aktiv aus.

Geben Sie die App-ID und die Slot-ID ein, die Sie im vorherigen Abschnitt erhalten haben, sowie den Wert für den Standard-CPM. Klicken Sie auf Speichern.

Schritt 3: LINE Ads Network SDK und Adapter importieren

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

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

  2. 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 Ad Manager.

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();

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 LINE Ads Network-Adapter füllt die folgenden Felder 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 von FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener und FiveAdNativeEventListener.
  • 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.