LY Ads Network in die Vermittlung einbinden

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

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads Flutter Plugin Anzeigen aus dem LY Ads Network mithilfe der Vermittlung laden und präsentieren. Dabei werden auch Abfolgeintegrationen 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 Werbenetzwerk bietet die folgenden Funktionen:

Integration
Gebote
Vermittlungsabfolge
Formate
Banner
Interstitial
Mit Prämie
Nativ

Vorbereitung

Prüfen Sie Folgendes, bevor Sie fortfahren:

  • Aktuelle Google Mobile Ads Flutter Plugin-Version.
  • Flutter-Framework-Version 3.7.0 oder höher
  • Für die Bereitstellung auf Android-Geräten
    • Android API-Level 24 oder höher
  • Für die Bereitstellung auf iOS-Geräten:
    • iOS-Bereitstellungsziel 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 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.

    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 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, nachdem Sie das Formular ausgefüllt haben.

    Formular zum Hinzufügen von Slots

    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 Managing reporting API keys (Berichts-API-Schlüssel verwalten) auf und klicken Sie auf den Button Create API key (API-Schlüssel erstellen).

    Tab „Reporting API-Schlüssel“

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

    Formular für 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 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

    Vermittlungseinstellungen für den 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 aktuellen Versionen des LY Werbenetzwerk 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 Standardstatus für den Ton beim Start 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 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-Anzeigen-Loader 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 Der Anzeigen-Ladeprogramm des LINE Anzeigen-SDK konnte nicht initialisiert werden.

    Änderungsprotokoll für den Line Flutter-Vermittlungsadapter

    Version 2.2.2 (in Arbeit)

    • Es ist jetzt mindestens iOS 15.0 erforderlich.

    Version 2.2.1

    Version 2.2.0

    Version 2.1.3

    Version 2.1.2

    Version 2.1.1

    Version 2.1.0

    • Die erforderliche Mindestversion von Flutter wurde auf 3.38.1 aktualisiert.
    • Aktualisiert, um das Google Mobile Ads Flutter-Plug-in in Version 8.0.0 zu unterstützen
    • Unterstützt Line Android-Adapterversion 3.1.0.0.
    • Unterstützt Line iOS-Adapterversion 3.0.1.0
    • Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in, Version 8.0.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