Line in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit GMA Next-Gen SDK Anzeigen von LINE Ads Network mithilfe der AdMob-Vermittlung laden und präsentieren. Dabei werden auch Vermittlungsabfolge-Integrationen behandelt. Außerdem wird beschrieben, wie Sie LINE Ads Network der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das LINE Ads Network SDK und den Adapter in eine Android-App einbinden.

Die Dashboard-Benutzeroberfläche für LINE Ads Network verwendet japanischen Text für Labels, Schaltflächen und Beschreibungen. Die Screenshots in diesem Leitfaden wurden nicht übersetzt. In den Beschreibungen und Anleitungen in diesem Leitfaden werden Labels und Buttons jedoch mit ihren deutschen Entsprechungen in Klammern übersetzt.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter für LINE Ads Network bietet die folgenden Funktionen:

Integration
Gebote
Vermittlungsabfolge
Formate
Banner
Interstitial
Mit Prämie
Nativ

Voraussetzungen

  • Android API‑Level 24 oder höher

  • [Für Gebote] Wenn Sie alle unterstützten Anzeigenformate in Geboten einbinden möchten, verwenden Sie den LINE Ads Network-Adapter 2.9.20241129.0 oder höher (die neueste Version wird empfohlen)

Schritt 1: Konfigurationen in der LINE Ads Network-Benutzeroberfläche einrichten

Registrieren Sie sich für ein LINE Ads Network-Konto und melden Sie sich an.

Neue Anwendung hinzufügen

Rufen Sie den Tab アプリ (App) auf und klicken Sie auf die Schaltfläche 新規登録 (Neue Registrierung).

Neue Registrierung

Füllen Sie das Formular aus und klicken Sie auf 登録 (Registrieren).

Neues Registrierungsformular

Notieren Sie sich die アプリID (App-ID).

Registrierungsdaten

Anzeigenfläche erstellen

Wählen Sie auf dem Tab アプリ (App) Ihre App aus, um die Details der App aufzurufen. Klicken Sie im Bereich スロット (Anzeigenfläche) auf 追加 (Hinzufügen).

Platzhalter hinzufügen

Füllen Sie das Formular mit Details zur Anzeigenfläche aus. Wählen Sie für Bidding Type (Gebotstyp) die Option Standard aus, um diese Anzeigenfläche für die Vermittlung in der Vermittlungsabfolge zu konfigurieren, oder Google SDK Bidding (Google SDK-Gebote) , um diese Anzeigenfläche für Gebote zu konfigurieren. Klicken Sie auf 作成 (Erstellen) , wenn das Formular ausgefüllt ist.

Slot-Formular hinzufügen

Notieren Sie sich die スロットID (Anzeigenflächen-ID).

Slot-Details

app-ads.txt-Datei aktualisieren

Authorized Sellers for Apps (app-ads.txt) ist eine IAB Tech Lab-Initiative, die dafür sorgt, dass Ihr App-Anzeigeninventar nur über Kanäle verkauft wird, die Sie autorisiert haben. Um einen erheblichen Rückgang des Anzeigenumsatzes zu vermeiden, müssen Sie eine app-ads.txt-Datei implementieren. Wenn Sie das noch nicht getan haben, richten Sie eine app-ads.txt-Datei für Ihre App ein.

Informationen zur Implementierung von app-ads.txt für LINE Ads Network finden Sie unter Informationen zu app-ads.txt.

Schritt 2: LINE Ads Network-Nachfrage 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 dann den Tab Vermittlung auf. Wenn Sie eine vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten, und fahren Sie 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 Zielstandorte aus. Setzen Sie den Status der Vermittlungsgruppe auf Aktiviert und klicken Sie dann auf Anzeigenblöcke hinzufügen.

Verknüpfen Sie diese Vermittlungsgruppe mit mindestens einem Ihrer vorhandenen AdMob-Anzeigenblöcke. Klicken Sie dann auf Fertig.

Auf der Karte „Anzeigenblöcke“ sollten jetzt die von Ihnen ausgewählten Anzeigenblöcke angezeigt werden:

LINE Ads Network als Anzeigenquelle hinzufügen

Gebote


Wählen Sie auf der Karte Gebote im Bereich Anzeigenquellen die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann LINE Ads Network aus.

Klicken Sie auf So unterzeichnen Sie eine Partnervereinbarung und richten Sie eine Gebots-Partnerschaft ein mit LINE Ads Network.



Klicken Sie auf Bestätigen und zustimmen und dann auf Weiter.



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



Geben Sie als Nächstes die Application ID (Anwendungs-ID) und Slot ID (Anzeigenflächen-ID) ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.



Vermittlungsabfolge


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

Wählen Sie LINE Ads Network aus und aktivieren Sie die Option Optimieren. Geben Sie den Login name (Anmeldename) und das Password (Passwort) ein, die Sie im vorherigen Abschnitt abgerufen haben, um die Optimierung der Anzeigenquelle für LINE Ads Network einzurichten. Geben Sie dann einen eCPM-Wert für LINE Ads Network ein und klicken Sie auf Weiter.



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

Geben Sie als Nächstes die Application ID (Anwendungs-ID) und die Slot ID (Anzeigenflächen-ID) ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.


Schritt 3: LINE Ads Network SDK und Adapter importieren

Fügen Sie in der Gradle-Datei auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:line:3.0.1.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:line:3.0.1.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Manuelle Integration

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

  2. Rufen Sie 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 Network-Adapters herunter und fügen Sie sie Ihrem Projekt hinzu.

Schritt 4: Erforderlichen Code hinzufügen

Für die LINE Ads Network-Integration ist kein zusätzlicher Code erforderlich.

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Stellen Sie sicher, dass Sie Ihr Testgerät für AdMob registrieren.

Der LINE Ads Network-Adapter enthält eine Hilfsmethode, mit der Sie den Testmodus für LINE Ads Network aktivieren können. Sie müssen diese Option festlegen, bevor Sie das initialisieren GMA Next-Gen SDK damit die Daten ordnungsgemäß an das LINE Ads Network SDK weitergeleitet werden.

Java

LineMediationAdapter.Companion.setTestMode(true);

Kotlin

LineMediationAdapter.setTestMode(true)

Testanzeigen prüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von LINE Ads Network erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die LINE Ads Network (Vermittlungsabfolge) Anzeigenquelle(n).

Optionale Schritte

Netzwerkspezifische Parameter

Der LINE Ads Network-Adapter unterstützt einen zusätzlichen Anfrageparameter, der mit der Klasse LineExtras an den Adapter übergeben werden kann. Der Konstruktor dieser Klasse enthält die folgenden Parameter:

enableAdSound
Ein boolean-Wert, der den Standard-Soundstartstatus von Banner-, Interstitial- und Anzeigen mit Prämie angibt.

Hier ist ein Codebeispiel für das Erstellen einer Anzeigenanfrage, in der diese Parameter festgelegt werden:

Java

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();

Kotlin

val lineExtras = LineExtras(enableAdSound = 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 immer vom LINE Ads Network-Adapter eingefügt 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 füllt der LINE Ads Network-Adapter das App-Symbol mit einem transparenten Bild aus.

Fehlercodes

Wenn der Adapter keine Anzeige von LINE Ads Network empfangen kann, können Sie den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo.getAdSourceResponses() unter den folgenden Klassen prüfen:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

Hier sind 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 von LINE Ads Network.
101 com.google.ads.mediation.line Die Anwendungs-ID fehlt oder ist ungültig.
102 com.google.ads.mediation.line Die Anzeigenflächen-ID fehlt oder ist ungültig.
103 com.google.ads.mediation.line Die angeforderte Anzeigengröße entspricht nicht einer von LINE Ads Network unterstützten Banneranzeigengröße.
104 com.google.ads.mediation.line Interstitial-Anzeige oder Anzeige mit Prämie konnte aufgrund eines fehlenden Aktivitätskontexts nicht geladen werden.
105 com.google.ads.mediation.line Das LINE Ads Network SDK konnte keine Interstitial-Anzeige oder Anzeige mit Prämie präsentieren.
106 com.google.ads.mediation.line Native Anzeige konnte aufgrund fehlender Assets nicht geladen werden.