LINE Ads Network in die Vermittlung einbinden (Beta)

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Line mithilfe von Vermittlung laden und anzeigen. Dabei werden auch Abfolgeintegrationen behandelt. Darin erfahren Sie, wie Sie Line der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Line SDK und den Adapter in eine iOS-App einbinden.

Die Benutzeroberfläche des Dashboards für das LINE Ads Network ist auf Japanisch. Die Screenshots in diesem Leitfaden wurden nicht übersetzt. In den Beschreibungen und Anleitungen dieses Leitfadens sind Labels und Schaltflächen jedoch übersetzt und die englischen Entsprechungen stehen in Klammern.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für das LINE Ads Network bietet folgende Funktionen:

Integration
Gebote  1
Wasserfall  2
Formate
Banner  3
Interstitial  3
Verfügbar
Nativ
1 Die Gebotsintegration befindet sich in der geschlossenen Betaphase. Wenden Sie sich an Ihren Account Manager, um Zugriff zu erhalten.

2 Die abfolgebasierte Integration befindet sich in der offenen Betaphase.

3 Dieses Format wird nur bei der abfolgebasierten Integration unterstützt.

Voraussetzungen

  • iOS-Bereitstellungsziel 12.0 oder höher

  • Neueste Version des Google Mobile Ads SDK

  • Mediation abschließen Startleitfaden

Schritt 1: Konfigurationen in der LINE Ads Network-Benutzeroberfläche einrichten

Melden Sie sich in Ihrem LINE Ads Network-Konto an.

Neue Anwendung hinzufügen

Klicken Sie auf 広告枠管理 (Anzeigenflächenverwaltung) > メディア (Medien). Klicken Sie dann auf 新規作成 (Neu erstellen).

Füllen Sie das Formular aus und klicken Sie auf 登録 (Registrieren).

Notieren Sie sich die Anwendungs-ID.

Anzeigen-Placement erstellen

Führen Sie dieselben Schritte aus, um Anzeigen-Placements sowohl für Gebote als auch für abfolgebasierte Integrationen zu erstellen. Jedes Anzeigen-Placement kann für beides verwendet werden.

Klicken Sie auf die ID der Anwendung, der Sie ein Anzeigen-Placement hinzufügen möchten. Wählen Sie dann 詳細 (Detail) aus.

Klicken Sie auf スロット 追加 (Add Slot).

Füllen Sie das Formular aus und klicken Sie dann auf (登録) Registrieren.

Notieren Sie sich die Steckplatz-ID.

Schritt 2: Nachfrage des LINE Ads-Werbenetzwerks in der Ad Manager-Benutzeroberfläche einrichten

Melden Sie sich in Ihrem Ad Manager-Konto an.

LINE Ads Network zu Unternehmen hinzufügen

Gebote

Dieser Schritt ist für Geboteinbindungen nicht erforderlich.

Wasserfall

Klicken Sie auf Verwaltung > Unternehmen und dann auf dem Tab Alle Unternehmen auf die Schaltfläche Neues Unternehmen. Wählen Sie Werbenetzwerk aus.

Wählen Sie LINE Ads Network als Werbenetzwerk aus, geben Sie einen eindeutigen Namen ein und aktivieren Sie Vermittlung.

Sie müssen keinen Nutzernamen oder ein Passwort eingeben. Klicken Sie abschließend auf Speichern.

Freigabe sicherer Signale aktivieren

Gebote

Klicken Sie auf Verwaltung > Globale Einstellungen. Rufen Sie den Tab Ad Exchange-Kontoeinstellungen auf und aktivieren Sie die Option Freigabe sicherer Signale. Klicken Sie auf Speichern.

Wasserfall

Dieser Schritt ist für abfolgebasierte Integrationen nicht erforderlich.

Sicheres Signal in Gebotsanfragen freigeben

Gebote

Klicken Sie auf Inventar > Sichere Signale. Suchen Sie unter Sichere Signale nach LINE und aktivieren Sie die Option App-Integration aktivieren.

Klicken Sie auf Speichern.

Wasserfall

Dieser Schritt ist für abfolgebasierte Integrationen nicht erforderlich.

Freigabe sicherer Signale für SDK-Gebote zulassen

Gebote

Gehen Sie zu Auslieferung > Einstellungen für Nachfragechannel. Aktivieren Sie auf dem Tab Standardeinstellungen die Option Freigabe sicherer Signale zulassen für SDK-Gebote.

Klicken Sie auf Speichern.

Wasserfall

Dieser Schritt ist für abfolgebasierte Integrationen nicht erforderlich.

Gebote für das LINE Ads Network konfigurieren

Gebote

Klicken Sie auf Auslieferung > Bieter und dann auf SDK-Gebote aufrufen.

Klicken Sie auf Neuer Bieter.

Wählen Sie als Bieter LINE Ads Network aus.

Klicken Sie auf Weiter, um SDK-Gebote für diesen Bieter zu aktivieren.

Klicken Sie auf Fertig.

Wasserfall

Dieser Schritt ist für abfolgebasierte Integrationen nicht erforderlich.

Anzeigenblockzuordnung konfigurieren

Gebote

Klicken Sie auf Auslieferung > Bieter und dann auf SDK-Gebote aufrufen.

Wählen Sie das Unternehmen für das LINE Ads Network aus.

Klicken Sie auf den Tab Anzeigenblockzuordnung und dann auf Neue Anzeigenblockzuordnung.

Wählen Sie Bestimmter Anzeigenblock aus. Wählen Sie einen Anzeigenblock und ein Format aus, Mobile App als Inventartyp und Ihre mobile App. Geben Sie dann die Anwendungs-ID und die Slot-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie abschließend auf Speichern.

Wasserfall

Klicken Sie auf Auslieferung > Ertragsgruppen und dann auf die Schaltfläche Neue Ertragsgruppe. Wählen Sie Ihre Mobile App aus.

Scrollen Sie nach unten und klicken Sie auf Ertragspartner hinzufügen.

Wählen Sie das Unternehmen aus, das Sie im vorherigen Abschnitt für das LINE Ads Network erstellt haben. Wählen Sie als Integrationstyp SDK-Vermittlung für Mobilgeräte, als Plattform iOS und als Status Aktiv aus.

Geben Sie die App-ID und die Slot-ID ein, die Sie im vorherigen Abschnitt erhalten haben, sowie den Wert für den Standard-CPM. Klicken Sie auf Speichern.

Schritt 3: LINE Ads Network SDK und Adapter importieren

Fügen Sie der Podfile Ihres Projekts die folgende Zeile hinzu:

pod 'GoogleMobileAdsMediationLine'

Führen Sie in der Befehlszeile folgenden Befehl aus:

pod install --repo-update

Manuelle Integration

  • Laden Sie die neueste Version des LINE Ads Network SDK herunter und verknüpfen Sie FiveAd.framework mit Ihrem Projekt.
  • Laden Sie die aktuelle Version des LINE Ads Network-Adapters über den Downloadlink im Änderungslog und über den Link LineAdapter.framework in Ihrem Projekt herunter.

Schritt 4: Erforderlichen Code hinzufügen

SKAdNetwork-Integration

Folgen Sie der Dokumentation zum LINE Ads Network, um der Datei Info.plist Ihres Projekts die SKAdNetwork-IDs hinzuzufü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 LINE Ads Network erhalten, aktivieren Sie im Anzeigenprüftool die Tests einzelner Anzeigenquellen und verwenden Sie die Anzeigenquellen LINE Ads Network (Abfolge).

Optionale Schritte

Netzwerkspezifische Parameter

Der LINE Ads Network-Adapter unterstützt einen zusätzlichen Anfrageparameter, der über die GADMediationAdapterLineExtras-Klasse an den Adapter übergeben werden kann. Diese Klasse umfasst die folgenden Eigenschaften:

adAudio
Gibt den Standardstartstatus für den Ton von Banner-, Interstitial- und Anzeigen mit Prämie an.

Hier ein Codebeispiel für die Erstellung einer Anzeigenanfrage, in der diese Parameter festgelegt werden:

Swift

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

Objective-C

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

GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

Native Anzeigen verwenden

Anzeigen-Rendering

Der LINE Ads Network-Adapter füllt die folgenden Felder für eine GADNativeAd aus.

Feld Assets, die vom LINE Ads Network-Adapter immer berücksichtigt werden
Anzeigentitel
Bild
Text
App-Symbol 1
Call-to-Action
Bewertung
Shop
Preis

1 Für native Anzeigen stellt das LINE Ads Network SDK kein App-Symbol-Asset bereit. Stattdessen wird das App-Symbol vom LINE Ads Network-Adapter mit einem transparenten Bild gefüllt.

Fehlercodes

Wenn der Adapter keine Anzeige vom LINE Ads Network empfängt, können Sie den zugrunde liegenden Fehler in der Anzeigenantwort mithilfe von GADResponseInfo.adNetworkInfoArray unter den folgenden Klassen prüfen:

GADMediationAdapterLine

Im Folgenden finden Sie die Codes und die zugehörigen Meldungen, die vom LINE Ads Network-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Fehlercode Domain Grund
1-10 Vom LINE Ads Network SDK gesendet Das LINE Ads Network SDK hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation zum LINE Ads-Werbenetzwerk.
101 com.google.ads.mediation.line Ungültige Serverparameter (z. B. fehlende Anwendungs- oder Slot-ID)
102 com.google.ads.mediation.line Die angeforderte Anzeigengröße entspricht nicht einer vom LINE Ads Network unterstützten Banneranzeigengröße.
103 com.google.ads.mediation.line Das Bild-Asset für das Informationssymbol konnte nicht in die native Anzeige geladen werden.

Änderungsprotokoll für den LINE iOS-Vermittlungsadapter

Nächste Version

  • Logik entfernt, die überprüfte, ob das FAD-SDK in der Adaptereinrichtung registriert wurde.
  • Die „show“-API für Interstitial- und Anzeigen mit Prämie wurde durch die neue „showWithViewController:“-API ersetzt.
  • Die Prüfung des Status von nativen Anzeigen vor dem Herunterladen von Assets für native Anzeigen wurde entfernt, da sie eingestellt wurde und es keinen Ersatz dafür gibt.

Version 2.9.20241106.1

  • Der Adapter wurde aktualisiert, sodass die neueste API zum Laden von Anzeigen für Gebote für Banneranzeigen verwendet wird.
  • Ein Problem wurde behoben, das dazu führte, dass Anzeigenereignisse für Gebote für Interstitial-Anzeigen nicht richtig weitergeleitet wurden.

Entwickelt 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 der FiveAd SDK-Version 2.9.20241106 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.12.0
  • FiveAd SDK-Version 2.9.20241106.

Version 2.8.20240827.1

  • CFBundleShortVersionString wurde auf drei statt vier Komponenten aktualisiert.

Entwickelt 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 der FiveAd SDK-Version 2.8.20240827 bestätigt.
  • Unterstützung für Gebote für Banner-, Interstitial-, Anzeigen mit Prämie und native Anzeigenformate hinzugefügt.

Entwickelt 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 der FiveAd SDK-Version 2.8.20240612 bestätigt.

Entwickelt 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 der FiveAd SDK-Version 2.7.20240411 bestätigt.

Entwickelt 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 der FiveAd SDK-Version 2.7.20240318 bestätigt.

Entwickelt und getestet mit:

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

Version 2.7.20240214.1

  • Jetzt ist mindestens iOS 12.0 erforderlich.
  • Jetzt ist das Google Mobile Ads SDK Version 11.0 oder höher erforderlich.
  • Info.plist in die Frameworks in LineAdapter.xcframework aufgenommen.

Entwickelt 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 der FiveAd SDK-Version 2.7.20240214 bestätigt.

Entwickelt 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 der FiveAd SDK-Version 2.7.20240126 bestätigt.
  • Die Adapterimplementierung wurde mit den neuen delegierten Protokollen des FiveAd SDK aktualisiert.

Entwickelt 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 der FiveAd SDK-Version 2.7.20231115 bestätigt.
  • GADMediationAdapterLineExtras-Header in die modulemap eingefügt.

Entwickelt 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 des Banners, Interstitials und der Anzeige mit Prämie bei der ersten Auslieferung zu verwalten.

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

Entwickelt und getestet mit:

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