LY Ads Network in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads 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 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 Werbenetzwerk bietet die folgenden Funktionen:

Vorbereitung

Bevor Sie fortfahren, prüfen Sie Folgendes:

• iOS-Bereitstellungsziel von 13.0 oder höher

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

• Aktuelle Google Mobile Ads 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 Slot für die abfolgebasierte Vermittlung zu konfigurieren, oder Google SDK-Gebote, 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 vom LY Werbenetzwerk zu erhalten. Das kann einige Zeit dauern. Bei Fragen wenden Sie sich bitte an Ihren LY Ads Network-Ansprechpartner.

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 Anzeigenquelle 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 Werbenetzwerk 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 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

Empfohlen: Swift Package Manager verwenden

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

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

1. Gehen Sie in Xcode zu File > Add Package Dependencies….

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 Abhängigkeitsregel die Option Zweig aus.

4. Geben Sie im Textfeld main ein.

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 Änderungsprotokoll herunter und verknüpfen Sie LineAdapter.framework in Ihrem Projekt.

Mit CocoaPods

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

pod 'GoogleMobileAdsMediationLine'

Führen Sie über die Befehlszeile folgenden Befehl aus:

pod install --repo-update

Schritt 4: Erforderlichen Code hinzufügen

SKAdNetwork implementieren

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

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 Google Mobile Ads SDK initialisieren, damit sie ordnungsgemäß an das LY Werbenetzwerk SDK weitergeleitet werden.

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

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

GADMediationAdapterLine.testMode = YES;

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

Optionale Schritte

Netzwerkspezifische Parameter

Der Adapter für das LY Werbenetzwerk unterstützt einen zusätzlichen Anfrageparameter, der mithilfe der Klasse GADMediationAdapterLineExtras an den Adapter übergeben werden kann. Diese Klasse enthält die folgenden Attribute:

adAudio

Gibt den Standard-Tonstartstatus von Banner-, Interstitial- und Anzeigen mit Prämie an.

Hier ein Codebeispiel für das Erstellen einer Anzeigenanfrage, mit 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 Werbenetzwerk-Adapter füllt die folgenden Feldbeschreibungen für erweiterte native Anzeigen für GADNativeAd 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 GADResponseInfo.adNetworkInfoArray unter den folgenden Klassen prüfen:

GADMediationAdapterLine

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 iOS-Vermittlungsadapter

Version 3.1.1.0

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

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.9.0
• FiveAd SDK-Version 3.1.1.

Version 3.1.0.0

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

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.8.0
• FiveAd SDK Version 3.1.0

Version 3.0.1.2

• Die iOS-Mindestversion wurde aktualisiert, um die Abhängigkeit vom Google Mobile Ads SDK zu lockern und Nebenversionen zuzulassen.
• Ein Problem wurde behoben, bei dem das Datenschutzinfo-Symbol für native Anzeigen zu groß war.

Erstellt 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 jetzt das Google Mobile Ads SDK-Flag ageRestrictedTreatment an die COPPA API des FiveAd SDK weiter.

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

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

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

Erstellt 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 die Weiterleitung der Google Mobile Ads SDK-Parameter „tagForUnderAgeOfConsent“ an das FiveAd SDK hinzugefügt.

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

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

Erstellt 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 jetzt das FiveAd SDK vor jeder Anzeigenanfrage.
• Kompatibilität mit FiveAd SDK-Version 2.9.20250912 bestätigt.

Erstellt und getestet mit:

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

Version 2.9.20250512.0

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

Erstellt 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 Größe von Banneranzeigen für Bidding nach erfolgreichem Laden wurde entfernt.
  • Bei Banneranzeigen in einer abfolgebasierten Vermittlung wird nach dem erfolgreichen Laden weiterhin nach Banneranzeigengrößen gesucht.

Erstellt 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 vor der Initialisierung des Google Mobile Ads SDK festgelegt werden.
• Die Prüfung des Initialisierungsstatus des FiveAd SDK vor der Initialisierung des FiveAd SDK wurde entfernt.
• Die veraltete Prüfung des Status nativer Anzeigen vor dem Herunterladen nativer Anzeigen-Assets wurde entfernt.
• Jetzt ist das Google Mobile Ads SDK ab Version 12.0.0 erforderlich.

Erstellt 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 Bidding-Banneranzeigen zu verwenden.
• Ein Problem wurde behoben, das dazu führte, dass Anzeigenereignisse für Bidding-Interstitial-Anzeigen nicht korrekt weitergeleitet wurden.

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

Erstellt 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 hat jetzt drei statt vier Komponenten.

Erstellt 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 für Bidding für Banner-, Interstitial-, native Anzeigenformate und Anzeigenformate mit Prämie hinzugefügt.

Erstellt und getestet mit:

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

Version 2.8.20240612.0

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

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

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

Erstellt und getestet mit:

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

Version 2.7.20240214.1

• Es ist jetzt mindestens iOS-Version 12.0 erforderlich.
• Jetzt ist das Google Mobile Ads SDK ab Version 11.0 erforderlich.
• Info.plist wurde in die Frameworks in LineAdapter.xcframework aufgenommen.

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

Erstellt 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 Delegatprotokollen des FiveAd SDK aktualisiert.

Erstellt 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 Header GADMediationAdapterLineExtras wurde in die Modulzuordnung aufgenommen.

Erstellt 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 von Bannern, Interstitials und Anzeigen mit Prämie zu verwalten, wenn sie zum ersten Mal angezeigt werden.

Erstellt 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 für abfolgebasierte Vermittlung für Banner-, Interstitial-, native und Anzeigenformate mit Prämie hinzugefügt.
• Kompatibilität mit FiveAd SDK-Version 2.6.20230609 bestätigt.

Erstellt und getestet mit:

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