Zeile in die Vermittlung einbinden (Beta)

In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Line mithilfe der Vermittlung und der Abfolgeintegrationen laden und anzeigen. Darin wird beschrieben, wie Sie Line der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Line SDK und den Adapter in eine iOS App einbinden.

Die Dashboard-Oberfläche für Line verwendet japanischen Text für Labels, Schaltflächen und Beschreibungen. 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 Line bietet folgende Funktionen:

Integration
Gebote
Wasserfall	^1
Formate
Banner
Interstitial
Verfügbar
Nativ

¹ Die abfolgebasierte Integration befindet sich in der geschlossenen Betaphase. Wenden Sie sich an Ihren Account Manager, um Zugriff zu erhalten.

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

Melde dich in deinem Line-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

Folgen Sie denselben Schritten, 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.

Hinweis :Wenden Sie sich an Ihren Account Manager für das Line Ads Network, um Zugriff auf die Erstellung von nativen Anzeigen-Placements in der Line-Benutzeroberfläche zu erhalten.

Notieren Sie sich die Steckplatz-ID.

Schritt 2: Liniennachfrage in der Ad Manager -Benutzeroberfläche einrichten

Melden Sie sich in Ihrem Ad Manager-Konto an.

Line in „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 als Werbenetzwerk aus, geben Sie einen eindeutigen Namen ein und aktivieren Sie Vermittlung.

Sie müssen keinen Nutzernamen oder ein Passwort eingeben. Klicken Sie auf Speichern, wenn Sie fertig sind.

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.

Gebotsstrategie konfigurieren Line

Gebote

Klicken Sie auf Auslieferung > Bieter und dann auf dem Tab SDK-Gebote auf Neuer Bieter.

Wählen Sie Line als Bieter aus.

Aktivieren Sie die Optionen Signalbibliothek dieses Bieters der Liste der zulässigen Signale hinzufügen und Zulassen, dass Signale für diesen Bieter freigegeben werden. Klicken Sie dann auf Weiter.

Klicken Sie auf Weiter.

Klicken Sie auf Fertig.

Wasserfall

Dieser Schritt ist für abfolgebasierte Integrationen nicht erforderlich.

Anzeigenblockzuordnung konfigurieren

Gebote

Gehen Sie zu Auslieferung > Bieter und wählen Sie auf dem Tab SDK-Gebote das Unternehmen fürLine 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 im vorherigen Abschnitt abgerufeneApplication ID and Slot ID ein. Klicken Sie abschließend auf Speichern.

Wichtig :Richten Sie für den ausgewählten Anzeigenblock mindestens eine Yield-Gruppe ein. DieApplication ID muss der App zugeordnet sein, auf die Sie die Anzeigen ausrichten möchten, wie in derLine Benutzeroberfläche

dargestellt.

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 Lineerstellt haben. Wählen Sie SDK-Vermittlung für Mobilgeräte als Integrationstyp, iOS als Plattform und Aktiv als Status aus.

Geben Sie den Application ID and Slot IDim vorherigen Abschnitt ermittelten Wert und den Wert für Standard-CPM ein. Klicken Sie auf Speichern.

Wichtig : Application ID muss mit der Ziel-App verknüpft sein, wie in derLine Benutzeroberfläche

dargestellt.

Schritt 3: Line SDK und Adapter importieren

Hinweis :Wenn Sie die kompatiblen Versionen von Line und Google Mobile Ads SDK nicht integrieren, kann das zu Build-Problemen führen.

Mit CocoaPods (empfohlen)

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 SDK herunter und verknüpfen Sie FiveAd.framework mit Ihrem Projekt.
• Lade die neueste Version des Line-Adapters über den Downloadlink im Änderungslog herunter und verknüpfe LineAdapter.framework in deinem Projekt.

Schritt 4: Erforderlichen Code hinzufügen

SKAdNetwork-Integration

Folgen Sie der Dokumentation von Line, um die SKAdNetwork-IDs der Datei Info.plist Ihres Projekts hinzuzufügen.

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für Ad Manager.

Folgen Sie der Anleitung in der Line-Dokumentation, um Testanzeigen in Line zu aktivieren.

Wichtig: Deaktivieren Sie den Testmodus für Ad Manager und Line, bevor Sie Ihre App veröffentlichen.

Testanzeigen bestätigen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von Google Line erhalten, aktivieren Sie im Anzeigenprüftool die Option Einzelne Anzeigenquelle testen und verwenden Sie die Anzeigenquellen Google Line (Abfolge).

Optionale Schritte

Netzwerkspezifische Parameter

Der Line-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 Zeilenadapter füllt die folgenden für eine GADNativeAd.

Feld	Assets, die immer vom Line-Adapter eingeschlossen werden
Anzeigentitel
Bild
Text
App-Symbol	^1
Call-to-Action
Bewertung
Shop
Preis

¹ Für native Anzeigen stellt das Line SDK kein App-Symbol-Asset bereit. Stattdessen wird das App-Symbol vom Line-Adapter mit einem transparenten Bild ausgefüllt.

Fehlercodes

Wenn der Adapter keine Anzeige von Line empfängt, können Sie den zugrunde liegenden Fehler in der Anzeigenantwort mithilfe von GADResponseInfo.adNetworkInfoArray unter den folgenden Klassen:

GADMediationAdapterLine

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

Fehlercode	Domain	Grund
1-10	Vom Line SDK gesendet	Das Line SDK hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation zu Line.
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 von Google Line 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

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.
• Gebotsunterstützung 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 zu verwalten, wenn sie zum ersten Mal angezeigt wird.

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.