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. Darin wird beschrieben, 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 vor dem Fortfahren Folgendes:

  • Die aktuelle Version von Google Mobile Ads Unity Plugin.
  • Unity Editor-Version 4 oder höher.
  • [Für Gebote]: Wenn Sie alle unterstützten Anzeigenformate in Gebote einbinden möchten, verwenden Sie das Google Mobile Ads-Vermittlungs-Plug-in für LY Ads Network 1.5.0 oder höher (neueste Version empfohlen).
  • Für die Bereitstellung auf Android-Geräten
    • Android-API-Level 24 oder höher.
  • Für die Bereitstellung auf iOS-Geräten:
    • Das iOS-Bereitstellungsziel muss 13.0 oder höher sein.
  • 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 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 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 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 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 LY Ads Network-Ansprechpartner.

    Überprüfung beantragen

    API-Schlüssel für Berichte 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 den 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

    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 das LY Werbenetzwerk über den Downloadlink im Änderungsprotokoll herunter und extrahieren Sie die GoogleMobileAdsLineMediation.unitypackage aus der ZIP-Datei.

    Wählen Sie im Unity-Projekt-Editor Assets > Import Package > Custom Package aus und suchen Sie nach der heruntergeladenen Datei GoogleMobileAdsLineMediation.unitypackage. 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 durch und kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android Ihrer Unity-Anwendung.

    Lösung erzwingen

    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 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 Ads Network empfängt, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo in 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 Die 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 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-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 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 Der Anzeigen-Ladeprogramm des LINE Anzeigen-SDK konnte nicht initialisiert werden.

    Änderungsprotokoll für das Unity-Plug-in für die Line-Vermittlung

    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