LY Ads Network in die Vermittlung einbinden

Plattform auswählen: Android Android iOS Unity Flutter

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads SDK Anzeigen aus dem LY Ads Network über die AdMob-Vermittlung laden und ausliefern. Dabei werden auch Vermittlungsabfolge-Integrationen behandelt. Hier erfahren Sie, wie Sie LY Ads Network der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das LY Ads Network SDK und den Adapter in eine iOS-App einbinden.

Unterstützte Integrationen und Anzeigenformate

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

Voraussetzungen

• iOS-Bereitstellungsziel von 13.0 oder höher

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

• Neueste Uploads von Google Mobile Ads SDK

• Vermittlung abschließen Startleitfaden

Schritt 1: Konfigurationen in der LY Ads Network-Benutzeroberfläche 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 zu erhalten. Wählen Sie für Gebotstyp Standard aus, um diesen Slot für die abfolgebasierte Vermittlung zu konfigurieren, oder Google SDK Bidding, um diesen Slot für Bidding zu konfigurieren. Klicken Sie auf Erstellen, wenn das Formular ausgefüllt ist.

Notieren Sie sich die Slot-ID.

Nachdem Sie Ihren ersten Slot erstellt haben, klicken Sie auf der Detailseite Ihrer App auf Überprüfen, um die Genehmigung durch das LY Ads Network zu erhalten. Das kann einige Zeit dauern. Bei Fragen wenden Sie sich bitte an Ihren LY Ads Network-Ansprechpartner.

Berichts-API-Schlüssel erstellen

Rufen Sie den Tab Berichts-API-Schlüssel verwalten auf und klicken Sie auf die Schaltfläche API-Schlüssel erstellen.

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

Notieren Sie sich Ihre API-Schlüssel-ID und Ihr API-Schlüssel-Secret.

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. Richten Sie eine app-ads.txt-Datei für Ihre App ein, falls noch nicht geschehen.

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

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

Vermittlungseinstellungen für Ihren 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 Mediation auf. Wenn Sie eine vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten. Fahren Sie dann mit LY 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 einen Namen für die Vermittlungsgruppe ein und wählen Sie die Standorte aus, auf die Sie ausrichten möchten. Legen Sie als Nächstes den Status der Vermittlungsgruppe auf Aktiviert fest und klicken Sie dann auf Anzeigenblöcke hinzufügen.

Weisen Sie dieser Vermittlungsgruppe einen oder mehrere Ihrer vorhandenen AdMob-Anzeigenblöcke zu. Klicken Sie dann auf Fertig.

Die Karte „Anzeigenblöcke“ sollte nun mit den ausgewählten Anzeigenblöcken gefüllt sein:

LY Ads Network als Anzeigenquelle hinzufügen

Gebote

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

Klicken Sie auf Partnervereinbarung unterzeichnen 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 Ads Network 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 Wasserfall 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 LY Ads Network ein und klicken Sie auf Weiter.




Wenn Sie bereits eine Zuordnung für LY Ads Network 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

Swift Package Manager verwenden

Bevor Sie fortfahren, müssen Sie die unterstützte Mindestversion des Adapters (2.9.20251119) installiert haben.

So fügen Sie Ihrem Projekt eine Paketabhängigkeit hinzu:

1. Gehen Sie in Xcode zu File > Add Package Dependencies… (Datei > Paketabhängigkeiten hinzufügen…).

2. Suchen Sie im angezeigten Prompt nach der folgenden Paket-URL:

   https://github.com/googleads/googleads-mobile-ios-mediation-line.git
   

3. Wählen Sie unter Dependency Rule (Regel für Abhängigkeiten) die Option Branch (Branch) aus.

4. Geben Sie in das Textfeld main ein.

Mit CocoaPods

Fügen Sie die folgende Zeile in die Podfile-Datei Ihres Projekts ein:

pod 'GoogleMobileAdsMediationLine'

Führen Sie in der Befehlszeile folgenden Befehl aus:

pod install --repo-update

Manuelle Integration

• Laden Sie die aktuelle Version des LY Ads Network SDK herunter und verknüpfen Sie FiveAd.framework in Ihrem Projekt.
• Laden Sie die aktuelle Version des LY Ads Network-Adapters über den Downloadlink im Changelog herunter und verknüpfen Sie LineAdapter.framework in Ihrem Projekt.

Schritt 4: Erforderlichen Code hinzufügen

SKAdNetwork implementieren

Folgen Sie der Dokumentation von LY Ads Network, um die SKAdNetwork-Kennungen der Datei Info.plist Ihres Projekts hinzuzufügen.

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für AdMob.

Der LY Ads Network-Adapter enthält eine Hilfsmethode, mit der der Testmodus für das LY Ads Network aktiviert werden kann. Sie müssen diese Option festlegen, bevor Sie Google Mobile Ads SDK initialisieren, damit sie richtig an das LY Ads Network SDK weitergeleitet werden.

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

Testanzeigen überprüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von 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 LY Ads-Netzwerkadapter unterstützt einen zusätzlichen Anfrageparameter, der mit der Klasse GADMediationAdapterLineExtras an den Adapter übergeben werden kann. Diese Klasse enthält die folgenden Attribute:

adAudio

Gibt den standardmäßigen Startstatus für den Ton von Banner-, Interstitial- und Anzeigen mit Prämie an.

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

import LineAdapter
// ...

let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

#import <LineAdapter/LineAdapter.h>
// ...

GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

Native Anzeigen verwenden

Anzeigen-Rendering

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

¹ Für native 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 Ads Network empfängt, können Sie den zugrunde liegenden Fehler aus der Anzeigenantwort mit GADResponseInfo.adNetworkInfoArray in den folgenden Klassen prüfen:

GADMediationAdapterLine

Hier sind die Codes und die zugehörigen Meldungen, die vom LY Ads Network-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

LINE iOS Mediation Adapter – Änderungslog

Version 3.0.1.2

• Aktualisieren Sie die Mindestversion von iOS, um die Abhängigkeit des Google Mobile Ads SDK von Nebenversionen zu verringern.
• Ein Problem wurde behoben, bei dem das Datenschutzinfo-Symbol für native Anzeigen zu groß war.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 13.4.0
• FiveAd SDK-Version 3.0.1

Version 3.0.1.1

• Der Adapter leitet das ageRestrictedTreatment-Flag des Google Mobile Ads SDK jetzt an die COPPA API des FiveAd SDK weiter.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 13.3.0
• FiveAd SDK-Version 3.0.1

Version 3.0.1.0

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

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 13.1.0
• FiveAd SDK-Version 3.0.1

Version 3.0.0.1

• Die Google Mobile Ads SDK-Abhängigkeit wurde auf Version 13.0.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 13.0.0
• FiveAd SDK Version 3.0.0

Version 3.0.0.0

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

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.14.0
• FiveAd SDK Version 3.0.0

Version 2.9.20251119.1

• Unterstützung für das Weiterleiten der Google Mobile Ads SDK-Parameter „tagForUnderAgeOfConsent“ an das FiveAd SDK hinzugefügt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.14.0
• FiveAd SDK-Version 2.9.20251119.

Version 2.9.20251119.0

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

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.14.0
• FiveAd SDK-Version 2.9.20251119.

Version 2.9.20250930.0

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

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.12.0
• FiveAd SDK-Version 2.9.20250930.

Version 2.9.20250912.0

• Der Adapter initialisiert das FiveAd SDK jetzt vor jeder Anzeigenanfrage.
• Kompatibilität mit FiveAd SDK-Version 2.9.20250912 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.11.0
• FiveAd SDK-Version 2.9.20250912.

Version 2.9.20250512.0

• Erfordert jetzt mindestens iOS 13.0.
• Kompatibilität mit FiveAd SDK-Version 2.9.20250512 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.4.0
• FiveAd SDK-Version 2.9.20250512.

Version 2.9.20241106.3

• Ein Problem wurde behoben, bei dem GADMediationAdapterLine.h kein öffentlicher Header war.
• Die Flags -fobjc-arc und -fstack-protector-all sind aktiviert.
• Die Überprüfung der Banneranzeigengröße für Gebote nach erfolgreichem Laden wurde entfernt.
  • Bei Wasserfall-Banneranzeigen wird nach dem erfolgreichen Laden weiterhin nach Banneranzeigengrößen gesucht.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.2.0
• FiveAd SDK-Version 2.9.20241106

Version 2.9.20241106.2

• Das Attribut GADMediationAdapterLine.testMode wurde hinzugefügt, um anzugeben, ob das FiveAd SDK im Testmodus initialisiert werden soll. Dieses Flag muss festgelegt werden, bevor das Google Mobile Ads SDK initialisiert wird.
• Die Prüfung des Initialisierungsstatus des FiveAd SDK wurde vor der Initialisierung des FiveAd SDK entfernt.
• Die eingestellte Statusprüfung für native Anzeigen wurde vor dem Herunterladen von Assets für native Anzeigen entfernt.
• Erfordert jetzt das Google Mobile Ads SDK Version 12.0.0 oder höher.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.0.0
• FiveAd SDK-Version 2.9.20241106

Version 2.9.20241106.1

• Der Adapter wurde aktualisiert, um die neueste API zum Laden von Anzeigen für Gebote für Banneranzeigen zu verwenden.
• Ein Problem wurde behoben, das verhinderte, dass Anzeigenereignisse für die Gebotsfunktion für Interstitial-Anzeigen richtig weitergeleitet wurden.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 11.12.0
• FiveAd SDK-Version 2.9.20241106

Version 2.9.20241106.0

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

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 11.12.0
• FiveAd SDK-Version 2.9.20241106

Version 2.8.20240827.1

• CFBundleShortVersionString wurde aktualisiert und besteht jetzt aus drei statt vier Komponenten.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 11.10.0
• FiveAd SDK-Version 2.8.20240827.

Version 2.8.20240827.0

• Kompatibilität mit FiveAd SDK-Version 2.8.20240827 bestätigt.
• Unterstützung von Geboten für Banner-, Interstitial-, Anzeigen mit Prämie- und native Anzeigenformate wurde hinzugefügt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 11.8.0
• FiveAd SDK-Version 2.8.20240827.

Version 2.8.20240612.0

• Die Audiosteuerung für native Anzeigen wurde über GADVideoOptions hinzugefügt.
• Kompatibilität mit FiveAd SDK-Version 2.8.20240612 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 11.5.0
• FiveAd SDK-Version 2.8.20240612

Version 2.7.20240411.0

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

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 11.3.0
• FiveAd SDK-Version 2.7.20240411

Version 2.7.20240318.0

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

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 11.2.0
• FiveAd SDK-Version 2.7.20240318

Version 2.7.20240214.1

• Erfordert jetzt mindestens iOS 12.0.
• Erfordert jetzt das Google Mobile Ads SDK Version 11.0 oder höher.
• Info.plist in die Frameworks in LineAdapter.xcframework aufgenommen.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 11.0.1
• FiveAd SDK-Version 2.7.20240214.

Version 2.7.20240214.0

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

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 11.0.1
• FiveAd SDK-Version 2.7.20240214.

Version 2.7.20240126.0

• Kompatibilität mit FiveAd SDK-Version 2.7.20240126 bestätigt.
• Die Adapterimplementierung wurde mit den neuen Delegatenprotokollen des FiveAd SDK aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 10.14.0
• FiveAd SDK-Version 2.7.20240126

Version 2.7.20231115.0

• Kompatibilität mit FiveAd SDK-Version 2.7.20231115 bestätigt.
• Der GADMediationAdapterLineExtras-Header ist in der Modulzuordnung enthalten.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 10.14.0
• FiveAd SDK-Version 2.7.20231115

Version 2.6.20230609.1

• GADMediationAdapterLineAudioState wurde hinzugefügt, um den anfänglichen Audiostatus des Banners, Interstitials und der Anzeige mit Prämie bei der ersten Anzeige zu verwalten.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 10.14.0
• FiveAd SDK-Version 2.6.20230609

Version 2.6.20230609.0

• Erstes Release!
• Unterstützung von Wasserfall für Banner-, Interstitial-, Anzeigen mit Prämie- und native Anzeigenformate hinzugefügt.
• Kompatibilität mit FiveAd SDK-Version 2.6.20230609 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 10.9.0
• FiveAd SDK-Version 2.6.20230609