LY in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit GMA Next-Gen SDK Anzeigen aus dem LY Ads Werbenetzwerk über die AdMob Mediation laden und präsentieren. Dabei werden auch abfolgebasierten Integrationen behandelt. Hier erfahren Sie, wie Sie das LY Ads Werbenetzwerk der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das LY Ads Werbenetzwerk SDK und den Adapter in eine Android-App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter für das LY Werbenetzwerk bietet die folgenden Funktionen:

Vorbereitung

Prüfen Sie Folgendes, bevor Sie fortfahren:

• Android API-Level 24 oder höher

• [Für Bidding]: Wenn Sie alle unterstützten Anzeigenformate in Bidding einbinden möchten, verwenden Sie den LY Ads Network-Adapter 2.9.20241129.0 oder höher (neueste Version empfohlen).

• Aktuelle GMA Next-Gen SDK-Version.

• Richten Sie AdMob Mediation ein.

Schritt 1: Konfigurationen in der Benutzeroberfläche des LY Ads Network einrichten

Registrieren Sie sich und melden Sie sich in Ihrem LY Ads Network-Konto an.

Neue Anwendung hinzufügen

Gehen Sie zum Tab App und klicken Sie auf den Button Neue Registrierung.

Füllen Sie das Formular aus und klicken Sie auf Registrieren.

Notieren Sie sich die App-ID.

Anzeigenfläche erstellen

Wählen Sie auf dem Tab App Ihre App aus, um die Details aufzurufen. Klicken Sie im Bereich Slot auf Hinzufügen.

Füllen Sie das Formular aus, um Details zum Slot anzugeben. Wählen Sie als Gebotstyp die Option Standard aus, um diesen Anzeigenblock für die abfolgebasierte Vermittlung zu konfigurieren, oder Google SDK-Gebote, um ihn für Bidding zu konfigurieren. Klicken Sie auf Erstellen, nachdem Sie das Formular ausgefüllt haben.

Notieren Sie sich die Slot-ID.

Nachdem du deinen ersten Anzeigenplatz erstellt hast, klicke auf der Detailseite deiner App auf Überprüfen, um die Genehmigung von LY Werbenetzwerk zu erhalten. Das kann einige Zeit dauern. Bei Fragen wenden Sie sich bitte an Ihren Ansprechpartner beim LY Werbenetzwerk.

Reporting API-Schlüssel erstellen

Rufen Sie den Tab Managing reporting API keys (Berichts-API-Schlüssel verwalten) auf und klicken Sie auf den Button Create API key (API-Schlüssel erstellen).

Füllen Sie das Formular aus und klicken Sie auf Speichern.

Notieren Sie sich die API-Schlüssel-ID und das API-Schlüssel-Secret.

app-ads.txt-Datei aktualisieren

Authorized Sellers for Apps (app-ads.txt) ist eine Initiative des IAB Tech Lab, 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. Falls noch nicht geschehen, richten Sie eine app-ads.txt-Datei für Ihre App ein.

Informationen zum Implementieren von app-ads.txt für das LY Werbenetzwerk finden Sie unter app-ads.txt.

Schritt 2: LY Ads Network-Nachfrage in der AdMob-Benutzeroberfläche einrichten

Vermittlungseinstellungen für den Anzeigenblock konfigurieren

Sie müssen LY 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, und fahren Sie mit LY Ads Werbenetzwerk 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 einen Namen für die Vermittlungsgruppe ein und wählen Sie die Zielregionen 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 vorhandenen AdMob-Anzeigenblöcke. Klicken Sie dann auf Fertig.

Auf der Karte „Anzeigenblöcke“ sollten jetzt die ausgewählten Anzeigenblöcke zu sehen sein:

LY Ads Network als Werbenetzwerk hinzufügen

Gebote

Suchen Sie im Bereich Anzeigenquellen die Karte Bidding und wählen Sie Anzeigenquelle hinzufügen aus. Wählen Sie dann LY Ads Network aus.

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



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



Wenn Sie bereits eine Zuordnung für das LY Werbenetzwerk 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 im Bereich Anzeigenquellen auf der Karte Abfolge die Option Anzeigenquelle hinzufügen aus.

Wählen Sie LY Ads Network aus und aktivieren Sie den Schalter Optimieren. Geben Sie die API-Schlüssel-ID und das API-Schlüssel-Secret ein, die Sie im vorherigen Abschnitt erhalten haben, um die Optimierung der Anzeigenquelle für LY Ads Network einzurichten. Geben Sie dann einen eCPM-Wert für das LY Ads Werbenetzwerk ein und klicken Sie auf Weiter.




Wenn Sie bereits eine Zuordnung für LY Werbenetzwerk 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: LY Ads Network SDK und Adapter importieren

Android Studio-Integration (empfohlen)

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

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

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

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 aktuelle Version der .aar-Datei des LY Ads Network SDK herunter und fügen Sie sie Ihrem Projekt hinzu.

2. Rufen Sie die LY Werbenetzwerk-Adapter-Artefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die .aar-Datei des LY Ads Network-Adapters herunter und fügen Sie sie Ihrem Projekt hinzu.

Schritt 4: Erforderlichen Code hinzufügen

Für die Integration des LY Ads Network ist kein zusätzlicher Code erforderlich.

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für AdMob.

Der LY Werbenetzwerk-Adapter enthält eine Hilfsmethode, mit der der Testmodus für das LY Werbenetzwerk aktiviert werden kann. Sie müssen diese Option festlegen, bevor Sie GMA Next-Gen SDK initialisieren, damit sie ordnungsgemäß an das LY Werbenetzwerk SDK weitergeleitet werden.

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

Testanzeigen prüfen

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

Optionale Schritte

Netzwerkspezifische Parameter

Der Adapter für das LY Werbenetzwerk unterstützt einen zusätzlichen Anfrageparameter, der mit der Klasse LineExtras an den Adapter übergeben werden kann. Dieser Klassenkonstruktor enthält die folgenden Parameter:

enableAdSound

Ein boolean, um den Standard-Tonstartstatus von Banner-, Interstitial- und Anzeigen mit Prämie anzugeben.

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

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

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

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

Native Anzeigen verwenden

Anzeigen-Rendering

Der LY Ads Werbenetzwerk-Adapter füllt die folgenden Feldbeschreibungen für erweiterte native Anzeigen für NativeAd aus.

¹ Bei nativen Anzeigen stellt das LY Ads Network SDK kein App-Symbol-Asset bereit. Stattdessen wird das App-Symbol vom LY Ads Network-Adapter mit einem transparenten Bild gefüllt.

Fehlercodes

Wenn der Adapter keine Anzeige vom LY Werbenetzwerk empfängt, können Sie den zugrunde liegenden Fehler in 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 LY Werbenetzwerk-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Änderungsprotokoll für den LINE-Vermittlungsadapter für Android

Version 3.1.1.2

• Legen Sie die Kotlin-Abhängigkeit des Adapters auf 1.9.0 fest (die vom GMA NextGen SDK unterstützte Mindestversion von Kotlin).

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 25.4.0
• Google Mobile Ads Next-Gen SDK Version 1.4.0
• FiveAd SDK-Version 3.1.1.1.

Version 3.1.1.1

• Wird der ChildDirectedTreatment API von Line zugeordnet (AgeRestrictedTreatment).

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 25.4.0
• Google Mobile Ads Next-Gen SDK Version 1.2.1
• FiveAd SDK-Version 3.1.1.1.

Version 3.1.1.0

• Kompatibilität mit FiveAd SDK-Version 3.1.1.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 25.2.0
• Google Mobile Ads Next-Gen SDK Version 1.2.1
• FiveAd SDK Version 3.1.1.0

Version 3.1.0.0

• Es wurde eine Property hinzugefügt, um den Adapter mit der GMA Next-Gen SDK-Abhängigkeit zu erstellen.
• Kompatibilität mit FiveAd SDK-Version 3.1.0.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 25.1.0
• Google Mobile Ads Next-Gen SDK, Version 0.25.0-beta01
• FiveAd SDK Version 3.1.0.0

Version 3.0.1.2

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 25.1.0
• FiveAd SDK-Version 3.0.1.2.

Version 3.0.1.1

• Impressionen nativer Anzeigen werden jetzt vom FiveAd SDK überschrieben, wenn das Google Mobile Ads SDK ab Version 24.4.0 verwendet wird.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.9.0
• FiveAd SDK-Version 3.0.1.1

Version 3.0.1.0

• Unterstützung für die Weiterleitung des Google Mobile Ads SDK-Parameters „tagForUnderAgeOfConsent“ an das FiveAd SDK hinzugefügt.
• Kompatibilität mit FiveAd SDK-Version 3.0.1.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.9.0
• FiveAd SDK Version 3.0.1.0

Version 3.0.0.0

• Kompatibilität mit FiveAd SDK-Version 3.0.0.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.9.0
• FiveAd SDK Version 3.0.0.0

Version 2.9.20251028.0

• Kompatibilität mit FiveAd SDK-Version 2.9.20251028 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.7.0
• FiveAd SDK, Version 2.9.20251028.0

Version 2.9.20250924.1

• Verweise auf Klassenebene auf Context entfernt. Kann helfen, Probleme mit Speicherlecks zu reduzieren.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.7.0
• FiveAd SDK-Version 2.9.20250924.1

Version 2.9.20250924.0

• Kompatibilität mit FiveAd SDK-Version 2.9.20250924 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.6.0
• FiveAd SDK, Version 2.9.20250924.0

Version 2.9.20250718.0

• Kompatibilität mit FiveAd SDK-Version 2.9.20250718 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.3.0
• FiveAd SDK, Version 2.9.20250718.0.

Version 2.9.20250519.0

• Kompatibilität mit FiveAd SDK-Version 2.9.20250519 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.3.0
• FiveAd SDK-Version 2.9.20250519.0

Version 2.9.20250317.1

• Behebung eines Fehlers bei den Bannerladeabmessungen für Bidding-Anzeigen mit der neuen FiveAd API

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.1.0
• FiveAd SDK, Version 2.9.20250317.0

Version 2.9.20250317.0

• Kompatibilität mit FiveAd SDK-Version 2.9.20250317 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.1.0
• FiveAd SDK, Version 2.9.20250317.0

Version 2.9.20250110.1

• Das erforderliche Android-API-Mindestlevel wurde auf 23 aktualisiert.
• Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 24.0.0 aktualisiert.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.0.0
• FiveAd SDK, Version 2.9.20250110.0

Version 2.9.20250110.0

• Die veraltete Klasse UnifiedNativeAdMapper wurde zugunsten von NativeAdMapper entfernt.
• Der Prozess zur Erfassung von Signalen wurde korrigiert.
• Der Initialisierungsprozess für abfolgebasierte Interstitial-Anzeigen und Anzeigen mit Prämie wurde korrigiert.
• Kompatibilität mit FiveAd SDK-Version 2.9.20250110 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 23.6.0
• FiveAd SDK, Version 2.9.20250110.0

Version 2.9.20241129.0

• Unterstützung für Bidding für Banner-, Interstitial-, native und Anzeigenformate mit Prämie hinzugefügt.
• Kompatibilität mit FiveAd SDK-Version 2.9.20241129 bestätigt.

Erstellt 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 bestätigt.

Erstellt 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 bestätigt.

Erstellt 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 FiveAd SDK-Version 2.8.20240722 bestätigt.

Erstellt 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 FiveAd SDK-Version 2.7.20240515 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 23.1.0
• FiveAd SDK Version 2.7.20240515.0

Version 2.7.20240214.1

• Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 23.0.0 aktualisiert.
• Kompatibilität mit FiveAd SDK-Version 2.7.20240214 bestätigt.

Erstellt 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 FiveAd SDK-Version 2.7.20240214 bestätigt.

Erstellt 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 FiveAd SDK-Version 2.7.20240126 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 22.6.0
• FiveAd SDK Version 2.7.20240126.0

Version 2.7.20240112.0

• Das verworfene FiveAdViewEventListener wurde zugunsten von FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener und FiveAdNativeEventListener entfernt.
• Kompatibilität mit FiveAd SDK-Version 2.7.20240112 bestätigt.
• Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 22.6.0 aktualisiert.

Erstellt 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 den Ton für Banner-, Interstitial- und Anzeigenformate mit Prämie festlegen können.
• Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 22.4.0 aktualisiert.

Erstellt 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-, native und Anzeigenformate mit Prämie hinzugefügt.
• Kompatibilität mit FiveAd SDK-Version 2.6.20230607 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 22.1.0
• FiveAd SDK-Version 2.6.20230607