LY Ads Network in die Vermittlung einbinden

Plattform auswählen: Android iOS Unity Flutter Android (alt)

In dieser Anleitung erfahren Sie, wie Sie mit GMA Next-Gen SDK Anzeigen aus dem LY Ads Werbenetzwerk mithilfe der Vermittlung laden und präsentieren. Dabei werden auch Abfolgeintegrationen 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:

Integration
Gebote
Vermittlungsabfolge
Formate
Banner
Interstitial
Mit Prämie
Nativ

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 einbeziehen möchten, verwenden Sie den LY Ads Werbenetzwerk-Adapter 2.9.20241129.0 oder höher (aktuelle Version empfohlen).

• Die aktuelle Version von GMA Next-Gen SDK.

• Richten Sie die Vermittlung ein.

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

Registrieren Sie sich für ein LY 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.

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

Notieren Sie sich die App-ID.

Anzeigenfläche erstellen

Wählen Sie auf dem Tab App Ihre App aus, um die Details der App 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.

Hinweis :Das Werbeformat und der Gebotstyp können nach der Registrierung des Slots nicht mehr geändert werden. Wenden Sie sich an den Account Manager Ihres LY Ads Network-Kontos, um Zugriff auf die Funktion zum Erstellen von Placements für native Anzeigen in der LY Ads Network-Benutzeroberfläche zu erhalten.

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, erstellen Sie eine app-ads.txt-Datei für Ad Manager.

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 Ad Manager-Benutzeroberfläche einrichten

Melden Sie sich in Ihrem Ad Manager-Konto an.

LY Ads Network unter „Unternehmen“ hinzufügen

Gebote

Dieser Schritt ist für Bidding-Integrationen nicht erforderlich.

Wasserfall

Gehen Sie zu Admin > Unternehmen und klicken Sie dann auf dem Tab Alle Unternehmen auf Neues Unternehmen. Wählen Sie Werbenetzwerk aus.

Wählen Sie LY Ads Network als Werbenetzwerk aus, geben Sie einen eindeutigen Namen ein und aktivieren Sie Vermittlung. Aktivieren Sie Automatische Datenerhebung und geben Sie die API-Schlüssel-ID und den API-Schlüssel ein, die Sie im vorherigen Abschnitt erhalten haben.

Sie müssen keinen Nutzernamen oder kein Passwort eingeben. Klicken Sie zum Schluss auf Speichern.

Freigabe sicherer Signale aktivieren

Gebote

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

Wasserfall

Dieser Schritt ist für Waterfall-Integrationen nicht erforderlich.

Sicheres Signal in Gebotsanfragen freigeben

Gebote

Rufen Sie Inventar > Sichere Signale auf. Suchen Sie unter Sichere Signale nach „LY Werbenetzwerk“ und aktivieren Sie App-Integration aktivieren.

Klicken Sie auf Speichern.

Wasserfall

Dieser Schritt ist für die Einbindung von Vermittlungsabfolgen nicht erforderlich.

Freigabe sicherer Signale für SDK-Gebote zulassen

Gebote

Klicken Sie auf Auslieferung > Einstellungen für Nachfragechannel. Aktivieren Sie auf dem Tab Standardeinstellungen die Option Freigabe sicherer Signale zulassen für SDK-Gebote.

Klicken Sie auf Speichern.

Wasserfall

Dieser Schritt ist für die Einbindung von Vermittlungsabfolgen nicht erforderlich.

Bidding für LY Ads Network konfigurieren

Gebote

Klicken Sie auf Auslieferung > Bieter und dann auf SDK-Gebote aufrufen.

Klicken Sie auf Neuer Bieter.

Wählen Sie LY Ads Network als Bieter aus.

Klicken Sie auf Weiter, um SDK-Gebote für diesen Bieter zu aktivieren.

Klicken Sie auf Fertig.

Wasserfall

Dieser Schritt ist für Waterfall-Integrationen nicht erforderlich.

Anzeigenblockzuordnung konfigurieren

Gebote

Klicken Sie auf Auslieferung > Bieter und dann auf SDK‑Gebote aufrufen.

Wählen Sie das Unternehmen für LY Ads Network aus.

Rufen Sie den Tab Zuordnung von Anzeigenblöcken auf und klicken Sie auf Neue Anzeigenblockzuordnung.

Wählen Sie Spezifischer Anzeigenblock aus. Wählen Sie einen Anzeigenblock und ein Format, 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.

Wichtig: Richten Sie den ausgewählten Anzeigenblock auf mindestens eine Ertragsgruppe aus. Die Anwendungs-ID muss mit der Ziel-App verknüpft sein, wie in der LY Werbenetzwerk-Benutzeroberfläche.

Wasserfall

Klicken Sie auf Auslieferung > Ertragsgruppen und dann auf den Button Neue Ertragsgruppe. Wählen Sie Ihr Inventar und Ihre App aus.

Scrollen Sie zu Ertragspartner und klicken Sie auf Vermittlungspartner hinzufügen.

Wählen Sie das Unternehmen aus, das Sie im vorherigen Abschnitt für LY 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 Anwendungs-ID und die Slot-ID ein, die Sie im vorherigen Abschnitt abgerufen haben, sowie den Standard-CPM-Wert. Klicken Sie auf Speichern.

Wichtig :Die Anwendungs-ID muss mit der Ziel-App verknüpft sein, wie in der Benutzeroberfläche des LY Werbenetzwerks.

Hinweis :Es dauert ein paar Tage, bis über die automatische Datenerfassung ausreichend Daten erhoben wurden, um einen korrekten Wert für den dynamischen CPM eines Vermittlungsnetzwerks zu berechnen. Sobald der eCPM berechnet werden kann, wird er automatisch aktualisiert.

Schritt 3: LY Ads Network SDK und Adapter importieren

Hinweis: Wenn Sie die kompatiblen Versionen des LY Werbenetzwerk SDK und des GMA Next-Gen SDK SDK nicht integrieren, kann es zu Build-Problemen kommen.

Android Studio-Integration (empfohlen)

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: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")
}

Groovy

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

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.

Java

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

Kotlin

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

Wichtig: Deaktivieren Sie den Testmodus für Ad Manager und LY Werbenetzwerk, bevor Sie Ihre App veröffentlichen.

Testanzeigen prüfen

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

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-Startstatus für den Ton von Banner-, Interstitial- und Anzeigen mit Prämie anzugeben.

Hier 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();
LineMediationSnippets.java

Kotlin

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 Werbenetzwerk-Adapter füllt die folgenden Felder für NativeAd aus.

Feld	Assets, die immer vom LY Werbenetzwerk-Adapter enthalten sind
Anzeigentitel
Bild
Text
App-Symbol	^1
Call-to-Action
Bewertung
Shop
Preis

¹ Für native Anzeigen stellt das LY Ads Network SDK kein App-Symbol-Asset bereit. Stattdessen wird das App-Symbol im 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 aus der Anzeigenantwort mit ResponseInfo.getAdSourceResponses() in 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:

Fehlercode	Domain	Grund
1-10	com.five_corp.ad	Das LY Werbenetzwerk SDK hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation von LY Ads Network.
101	com.google.ads.mediation.line	Fehlende oder ungültige Anwendungs-ID.
102	com.google.ads.mediation.line	Slot-ID fehlt oder ist ungültig.
103	com.google.ads.mediation.line	Die angeforderte Anzeigengröße entspricht keiner der vom LY Ads Network unterstützten Banneranzeigengrößen.
104	com.google.ads.mediation.line	Eine Interstitial-Anzeige oder Anzeige mit Prämie konnte aufgrund eines fehlenden Aktivitätskontexts nicht geladen werden.
105	com.google.ads.mediation.line	Das LY Ads Network SDK konnte keine Interstitial-Anzeige oder Anzeige mit Prämie einblenden.
106	com.google.ads.mediation.line	Eine Native-Anzeige konnte aufgrund fehlender Assets nicht geladen werden.
107	com.google.ads.mediation.line	Das FiveAd SDK hat einen Null-Anzeigenlader zurückgegeben.

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

Version 3.1.1.2

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

Entwickelt 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

• Maps AgeRestrictedTreatment an die ChildDirectedTreatment API von Line.

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.

Entwickelt 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.

Entwickelt 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.

Entwickelt 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.

Entwickelt 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.

Entwickelt 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

Entwickelt 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.

Entwickelt 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 Gebote für Banner-, Interstitial-, Anzeigen mit Prämie- und native Anzeigenformate wurde hinzugefügt.
• Kompatibilität mit FiveAd SDK-Version 2.9.20241129 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 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 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.

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 FiveAd SDK-Version 2.7.20240515 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 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.

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 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-, Anzeigen mit Prämie- und native Anzeigenformate.
• 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