LY Ads Network in die Vermittlung einbinden

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

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads Flutter Plugin Anzeigen aus dem LY Ads Werbenetzwerk mithilfe der Vermittlung laden und präsentieren. Dabei werden auch abfolgenbasierte 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 Flutter-App einbinden.

Unterstützte Integrationen und Anzeigenformate

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

Integration
Gebote
Vermittlungsabfolge
Formate
Banner
Interstitial
Mit Prämie
Nativ

Vorbereitung

Prüfen Sie vor dem Fortfahren Folgendes:

  • Aktuelle Google Mobile Ads Flutter Plugin-Version.
  • Flutter-Framework-Version 3.7.0 oder höher
  • Bereitstellung auf Android-Geräten
    • Android-API-Level 24 oder höher.
  • Für die Bereitstellung auf iOS
    • iOS-Bereitstellungsziel von 13.0 oder höher.
  • Ein funktionierendes Flutter-Projekt, das mit Google Mobile Ads Flutter Plugin konfiguriert ist. Weitere Informationen finden Sie unter Google Mobile Ads Flutter Plugin einrichten.
  • 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

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

    Neue Registrierung

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

    Neues Registrierungsformular

    Notieren Sie sich die App-ID.

    Android

    Registrierungsdaten

    iOS

    Registrierungsdaten

    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.

    Slot hinzufügen

    Füllen Sie das Formular aus, um Details zum Slot anzugeben. 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 SDK-Gebote zu konfigurieren. Klicken Sie auf Erstellen, wenn das Formular ausgefüllt ist.

    Slot-Formular hinzufügen

    Notieren Sie sich die Slot-ID.

    Slot-Details

    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.

    Überprüfung beantragen

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

    Tab „Reporting API-Schlüssel“

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

    Formular für den Reporting API-Schlüssel

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

    Formular für Reporting API-Schlüssel

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

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

    Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

    Android

    Eine Anleitung finden Sie in Schritt 2 des Leitfadens für Android.

    iOS

    Eine Anleitung finden Sie in Schritt 2 des Leitfadens für iOS.

    Schritt 3: LY Ads Network SDK und Adapter importieren

    Integration über pub.dev

    Fügen Sie der Datei pubspec.yaml Ihres Pakets die folgende Abhängigkeit mit den neuesten Versionen des LY Ads Network SDK und des Adapters hinzu:

    dependencies:
  gma_mediation_line: ^2.2.1

    Manuelle Integration

    Laden Sie die neueste Version des Google Mobile Ads Mediation-Plug-ins für das LY Ads Network herunter, extrahieren Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner (und seinen Inhalt) Ihrem Flutter-Projekt hinzu. Verweisen Sie dann in der Datei pubspec.yaml auf das Plug-in, indem Sie die folgende Abhängigkeit hinzufügen:

    dependencies:
  gma_mediation_line:
    path: path/to/local/package

    Schritt 4: Erforderlichen Code hinzufügen

    Android

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

    iOS

    SKAdNetwork-Integration

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

    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

    Das Flutter-Vermittlungs-Plug-in für das LY Ads Network unterstützt den folgenden zusätzlichen Anfrageparameter, der über die Klasse LineMediationExtras an den Adapter übergeben werden kann:

    • enableAdSound : Gibt den Standard-Startstatus für den Ton von Banner-, Interstitial- und Anzeigen mit Prämie an.

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

    LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [lineExtras],
);

    Fehlercodes

    Wenn der Adapter keine Anzeige vom LY Werbenetzwerk erhält, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo unter den folgenden Klassen prüfen:

    Android

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

    iOS

    GADMediationAdapterLine

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

    Android

    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 Die Slot-ID fehlt oder ist ungültig.
    103 com.google.ads.mediation.line Die angeforderte Anzeigengröße entspricht keiner Banneranzeigengröße, die vom LY Ads Network unterstützt wird.
    104 com.google.ads.mediation.line Das Laden einer Interstitial-Anzeige oder einer Anzeige mit Prämie ist aufgrund eines fehlenden Aktivitätskontexts fehlgeschlagen.
    105 com.google.ads.mediation.line Das LY Ads Network SDK konnte keine Interstitial-Anzeige oder Anzeige mit Prämie ausliefern.
    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.

    iOS

    Fehlercode Domain Grund
    1-10 Gesendet vom LY Werbenetzwerk SDK 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 Ungültige Serverparameter (z.B. fehlende Anwendungs-ID oder Anzeigenflächen-ID).
    102 com.google.ads.mediation.line Die angeforderte Anzeigengröße entspricht keiner der vom LY Ads Network unterstützten Banneranzeigengrößen.
    103 com.google.ads.mediation.line Das Bild-Asset für das Informationssymbol in der nativen Anzeige konnte nicht geladen werden.
    104 com.google.ads.mediation.line Signale für Gebote konnten nicht erfasst werden.
    105 com.google.ads.mediation.line Das Anzeigenladeprogramm des LINE Anzeigen-SDK konnte nicht initialisiert werden.

    Änderungsprotokoll für den Line Flutter-Mediationsadapter

    Version 2.2.2 (in Arbeit)

    • Erfordert jetzt mindestens iOS 15.0.

    Version 2.2.1

    Version 2.2.0

    Version 2.1.3

    Version 2.1.2

    Version 2.1.1

    Version 2.1.0

    Version 2.0.0

    Version 1.0.6

    Version 1.0.5

    Version 1.0.4

    Version 1.0.3

    Version 1.0.2

    Version 1.0.1

    Version 1.0.0