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 Unity 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 Unity-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
Verfügbar

Vorbereitung

Prüfen Sie Folgendes, bevor Sie fortfahren:

  • Die aktuelle Version von Google Mobile Ads Unity Plugin.
  • Unity Editor-Version 4 oder höher.
  • [Für Bidding]: Wenn Sie alle unterstützten Anzeigenformate in Bidding einbinden möchten, verwenden Sie das Google Mobile Ads-Vermittlungs-Plug-in für das LY Ads Network in der Version 1.5.0 oder höher (aktuelle Version empfohlen).
  • Bereitstellung auf Android-Geräten
    • Android-API-Level 24 oder höher.
  • Für die Bereitstellung auf iOS-Geräten:
    • iOS-Bereitstellungsziel von 13.0 oder höher.
  • Ein funktionierendes Unity-Projekt, das mit Google Mobile Ads Unity Plugin konfiguriert ist. Weitere Informationen finden Sie unter Google Mobile Ads Unity Plugin einrichten.
  • Richten Sie die Vermittlung ein.

    • Schritt 1: Konfigurationen in der LY Werbenetzwerk-Benutzeroberfläche 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 Registrierung.

    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 der App aufzurufen. Klicken Sie im Bereich Slot auf Hinzufügen.

    Platzhalter hinzufügen

    Füllen Sie das Formular aus, um Details zum Slot zu erhalten. 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, wenn das Formular ausgefüllt ist.

    Formular zum Hinzufügen von Slots

    Notieren Sie sich die Slot-ID.

    Slotdetails

    Nachdem Sie Ihren ersten Slot erstellt haben, klicken Sie auf der Detailseite Ihrer App auf Überprüfen, um die Genehmigung durch das 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 Ihre API-Schlüssel-ID und Ihr 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 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 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

    OpenUPM-CLI

    Wenn Sie die OpenUPM-CLI installiert haben, können Sie das Google Mobile Ads LY Ads Network Mediation Plugin für Unity in Ihrem Projekt installieren, indem Sie den folgenden Befehl im Stammverzeichnis Ihres Projekts ausführen:

    openupm add com.google.ads.mobile.mediation.line

    OpenUPM

    Wählen Sie im Unity-Projekt-Editor Bearbeiten > Projekteinstellungen > Paketmanager aus, um die Einstellungen für den Unity-Paketmanager zu öffnen.

    Fügen Sie auf dem Tab Scoped Registries (Registrierungen mit Bereich) OpenUPM als Registrierung mit Bereich mit den folgenden Details hinzu:

    • Name: OpenUPM
    • URL: https://package.openupm.com
    • Bereich(e): com.google

    OpenUPM-Details

    Gehen Sie dann zu Window > Package Manager, um den Unity Package Manager zu öffnen, und wählen Sie im Drop-down-Menü My Registries aus.

    Unity-Registries

    Wählen Sie das Paket Google Mobile Ads Line Mediation aus und klicken Sie auf Install (Installieren).

    Über OpenUPM installieren

    Unity-Paket

    Laden Sie die aktuelle Version des Google Mobile Ads-Vermittlungs-Plug-ins für LY Werbenetzwerk über den Downloadlink im Changelog herunter und extrahieren Sie die GoogleMobileAdsLineMediation.unitypackage aus der ZIP-Datei.

    Wählen Sie im Unity-Projekteditor Assets > Import Package > Custom Package aus und suchen Sie die heruntergeladene GoogleMobileAdsLineMediation.unitypackage-Datei. Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.

    Aus Unity importieren

    Wählen Sie dann Assets > External Dependency Manager > Android Resolver > Force Resolve aus. Die Bibliothek „External Dependency Manager“ führt die Abhängigkeitsauflösung von Grund auf neu durch und kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android Ihrer Unity-App.

    Auflösung erzwingen

    Schritt 4: Erforderlichen Code hinzufügen

    Android

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

    iOS

    SKAdNetwork-Integration

    Folgen Sie der Dokumentation von LY Ads Network, um die SKAdNetwork-Kennungen 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 Unity-Vermittlungs-Plug-in für das LY Werbenetzwerk unterstützt den folgenden zusätzlichen Anfrageparameter, der über die Klasse LineMediationExtras an den Adapter übergeben werden kann:

    • SetEnableAdSound(boolean) : 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, in der diese Parameter festgelegt werden:

    using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(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 Die Anwendungs-ID fehlt oder ist ungültig.
    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 Banneranzeigengröße, die vom LY Ads Network unterstützt wird.
    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.

    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 Banneranzeigengröße, die vom LY Ads Network unterstützt wird.
    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 das Line Unity Mediation-Plug-in

    Version 2.2.1

    Version 2.2.0

    Version 2.1.1

    Version 2.1.0

    Version 2.0.2

    Version 2.0.1

    Version 2.0.0

    Version 1.5.10

    Version 1.5.9

    Version 1.5.8

    Version 1.5.7

    Version 1.5.6

    Version 1.5.5

    • Es wurde ein Problem behoben, bei dem das Plug-in die Pakete bei der Installation über OpenUPM nicht richtig importiert hat.

    Version 1.5.4

    Version 1.5.3

    Version 1.5.2

    Version 1.5.1

    Version 1.5.0

    Version 1.4.0

    Version 1.3.1

    Version 1.3.0

    Version 1.2.0

    Version 1.1.2

    Version 1.1.1

    Version 1.1.0

    Version 1.0.0