Integrare Line con la mediazione (beta)

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Line utilizzando la mediazione, nonché le integrazioni con la struttura a cascata. Descrive come aggiungere Line alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di Line in un'app per iOS.

L'interfaccia della dashboard di Line utilizza il testo giapponese per le etichette, i pulsanti e le descrizioni. Gli screenshot di questa guida non sono stati tradotti. Tuttavia, nelle descrizioni e nelle istruzioni di questa guida, le etichette e i pulsanti sono tradotti con i relativi equivalenti in inglese tra parentesi.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per Line offre le seguenti funzionalità:

Integrazione
Offerte
Cascata	^1
Formati
Banner
Interstitial
Con premio
Nativo

¹ L'integrazione con struttura a cascata è in versione beta chiusa. Contatta il tuo account manager per richiedere l'accesso.

Requisiti

• Target di deployment iOS 12.0 o versioni successive

• SDK Google Mobile Ads più recente

• Completare la mediazione Guida introduttiva

Passaggio 1: configura le impostazioni nell'interfaccia utente di Line

Accedi al tuo account Line.

Aggiungere una nuova applicazione

Fai clic su 広告枠管理 (Gestione area annuncio) > メディア (Media). Poi, fai clic su 新規作成 (Crea nuova).

Compila il modulo e fai clic su 登録 (Registrati).

Prendi nota dell'ID applicazione.

Creare un posizionamento dell'annuncio

Fai clic sull'ID dell'applicazione a cui vuoi aggiungere un posizionamento dell'annuncio. Quindi, seleziona 詳細 (Dettagli).

Fai clic su スロット 追加 (Aggiungi area).

Compila il modulo e, al termine, fai clic su (登録) Registrati.

Nota: contatta il tuo account manager della Rete di annunci Line per ottenere l'accesso per creare posizionamenti degli annunci nativi nell'interfaccia utente di Line.

Prendi nota dell'ID slot.

Passaggio 2: configura la domanda per riga nell'interfaccia utente di Ad Manager

Accedi al tuo account Ad Manager.

Aggiungere una riga in Aziende

Offerte

Questo passaggio non è obbligatorio per le integrazioni delle offerte.

Cascata

Vai ad Amministrazione > Aziende, quindi fai clic sul pulsante Nuova azienda nella scheda Tutte le aziende. Seleziona Rete pubblicitaria.

Seleziona Line come Rete pubblicitaria, inserisci un Nome univoco e attiva Mediazione.

Non è necessario inserire Nome utente o Password. Al termine, fai clic su Salva.

Attivare la condivisione di indicatori sicuri

Offerte

Vai ad Amministrazione > Impostazioni globali. Vai alla scheda Impostazioni account Ad Exchange, controlla e attiva Condivisione di indicatori sicuri. Fai clic su Salva.

Cascata

Questo passaggio non è necessario per le integrazioni con struttura a cascata.

Configurare le offerte per linee

Offerte

Vai a Pubblicazione > Offerenti e fai clic su Nuovo offerente nella scheda SDK Bidding.

Seleziona Line come offerente.

Attiva Aggiungi la libreria di indicatori di questo offerente all'elenco di indicatori consentiti e Consenti la condivisione di indicatori con questo offerente. Poi fai clic su Continua.

Fai clic su Continua.

Fai clic su Fine.

Cascata

Questo passaggio non è necessario per le integrazioni con struttura a cascata.

Configurare la mappatura delle unità pubblicitarie

Offerte

Vai a Pubblicazione > Offerenti e seleziona la società per la riga nella scheda SDK Bidding.

Vai alla scheda Mappatura delle unità pubblicitarie e fai clic su Nuova mappatura delle unità pubblicitarie.

Scegli Unità pubblicitaria specifica. Seleziona un'unità pubblicitaria e un formato, App mobile come Tipo di inventario e la tua applicazione mobile. Quindi, inserisci ID applicazione e ID slot ottenuti nella sezione precedente. Infine, fai clic su Salva.

Importante: scegli come target l'unità pubblicitaria selezionata per almeno un gruppo di rendimento e l'ID applicazione deve essere associato all'app scelta come target come nell'UI di Line.

Cascata

Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento. Seleziona l'applicazione mobile.

Scorri verso il basso e fai clic su Aggiungi partner di rendimento.

Seleziona l'azienda che hai creato per Line nella sezione precedente. Scegli Mediazione SDK per dispositivi mobili come Tipo di integrazione, iOS come Piattaforma e Attivo come Stato.

Inserisci ID applicazione e ID slot ottenuti nella sezione precedente e il valore CPM predefinito. Fai clic su Salva.

Importante: l'ID applicazione deve essere associato all'app di destinazione come nell'UI di Line.

Passaggio 3: importa l'SDK e l'adattatore Line

Nota: l'integrazione di versioni dell'SDK Google Mobile Ads e di Line compatibili potrebbe causare problemi di compilazione.

Utilizzo di CocoaPods (opzione consigliata)

Aggiungi la seguente riga al Podfile del progetto:

pod 'GoogleMobileAdsMediationLine'

Dalla riga di comando, esegui:

pod install --repo-update

Integrazione manuale

• Scarica la versione più recente dell'SDK Line e collegaFiveAd.framework nel tuo progetto.
• Scarica la versione più recente dell'adattatore Line dal link di download nel changelog e collegalo a LineAdapter.framework nel tuo progetto.

Passaggio 4: aggiungi il codice richiesto

Integrazione di SKAdNetwork

Segui la documentazione di Line per aggiungere gli identificatori SKAdNetwork al file Info.plist del progetto.

Passaggio 5: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager.

Segui le istruzioni riportate nella documentazione di Line su come attivare gli annunci di prova di Line.

Importante: disattiva la modalità di test per Ad Manager e Line prima di rilasciare l'app.

Verificare gli annunci di prova

Per verificare di ricevere annunci di prova da Line, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Line (a cascata).

Passaggi facoltativi

Parametri specifici della rete

L'adattatore Line supporta un parametro di richiesta aggiuntivo che può essere passato all'adattatore utilizzando la classe GADMediationAdapterLineExtras. Questa classe include le seguenti proprietà:

adAudio

Specifica lo stato di inizio dell'audio predefinito per gli annunci banner, interstitial e con premio.

Di seguito è riportato un esempio di codice per creare una richiesta di annuncio che imposta questi parametri:

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];

Utilizzare gli annunci nativi

Rendering dell'annuncio

L'adattatore Line compila i seguenti campi per un GADNativeAd.

Campo	Asset sempre inclusi dall'adattatore di riga
Titolo
Immagine
Corpo
Icona dell'app	^1
Call to action
Valutazione a stelle
Negozio
Prezzo

¹ Per gli annunci nativi, l'SDK Line non fornisce un asset icona dell'app. L'adattatore Line compila l'icona dell'app con un'immagine trasparente.

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da Line, puoi controllare l'errore di fondo della risposta all'annuncio utilizzando GADResponseInfo.adNetworkInfoArray nelle seguenti classi:

GADMediationAdapterLine

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore Line quando non riesce a caricare un annuncio:

Codice di errore	Dominio	Motivo
1-10	Inviata dall'SDK di Line	L'SDK Line ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione di Line.
101	com.google.ads.mediation.line	Parametri del server non validi (ad es. ID applicazione o ID slot mancante).
102	com.google.ads.mediation.line	La dimensione dell'annuncio richiesta non corrisponde a una dimensione dell'annuncio banner supportata da Line.
103	com.google.ads.mediation.line	Impossibile caricare un asset immagine icona informativa nell'annuncio nativo.

Log delle modifiche dell'adattatore di mediazione LINE per iOS

Versione 2.9.20241106.1

• L'adattatore è stato aggiornato in modo da utilizzare l'API di caricamento degli annunci più recente per le offerte di annunci banner.
• È stato risolto un problema che impediva l'inoltro corretto degli eventi correlati agli annunci per le offerte degli annunci interstitial.

Creato e testato con:

• SDK Google Mobile Ads versione 11.12.0.
• FiveAd SDK versione 2.9.20241106.

Versione 2.9.20241106.0

• Compatibilità verificata con la versione 2.9.20241106 dell'SDK FiveAd.

Creato e testato con:

• SDK Google Mobile Ads versione 11.12.0.
• FiveAd SDK versione 2.9.20241106.

Versione 2.8.20240827.1

• CFBundleShortVersionString è stato aggiornato in modo da avere tre componenti anziché quattro.

Creato e testato con:

• SDK Google Mobile Ads versione 11.10.0.
• FiveAd SDK versione 2.8.20240827.

Versione 2.8.20240827.0

• Compatibilità verificata con la versione 2.8.20240827 dell'SDK FiveAd.
• È stato aggiunto il supporto per le offerte per i formati degli annunci banner, interstitial, con premio e nativi.

Creato e testato con:

• SDK Google Mobile Ads versione 11.8.0.
• FiveAd SDK versione 2.8.20240827.

Versione 2.8.20240612.0

• È stato aggiunto il controllo audio per l'annuncio nativo tramite GADVideoOptions.
• Compatibilità verificata con la versione 2.8.20240612 dell'SDK FiveAd.

Creato e testato con:

• SDK Google Mobile Ads versione 11.5.0.
• FiveAd SDK versione 2.8.20240612.

Versione 2.7.20240411.0

• Compatibilità verificata con la versione 2.7.20240411 dell'SDK FiveAd.

Creato e testato con:

• SDK Google Mobile Ads versione 11.3.0.
• FiveAd SDK versione 2.7.20240411.

Versione 2.7.20240318.0

• Compatibilità verificata con la versione 2.7.20240318 dell'SDK FiveAd.

Creato e testato con:

• SDK Google Mobile Ads versione 11.2.0.
• FiveAd SDK versione 2.7.20240318.

Versione 2.7.20240214.1

• Ora è richiesta la versione minima iOS 12.0.
• Ora è richiesta la versione 11.0 o successive dell'SDK Google Mobile Ads.
• Info.plist è stato incluso nei framework di LineAdapter.xcframework.

Creato e testato con:

• SDK Google Mobile Ads versione 11.0.1.
• FiveAd SDK versione 2.7.20240214.

Versione 2.7.20240214.0

• Compatibilità verificata con la versione 2.7.20240214 dell'SDK FiveAd.

Creato e testato con:

• SDK Google Mobile Ads versione 11.0.1.
• FiveAd SDK versione 2.7.20240214.

Versione 2.7.20240126.0

• Compatibilità verificata con la versione 2.7.20240126 dell'SDK FiveAd.
• Aggiornamento dell'implementazione dell'adattatore con i nuovi protocolli del delegato dell'SDK FiveAd.

Creato e testato con:

• SDK Google Mobile Ads versione 10.14.0.
• FiveAd SDK versione 2.7.20240126.

Versione 2.7.20231115.0

• Compatibilità verificata con la versione 2.7.20231115 dell'SDK FiveAd.
• È stata inclusa l'intestazione GADMediationAdapterLineExtras in modulemap.

Creato e testato con:

• SDK Google Mobile Ads versione 10.14.0.
• SDK FiveAd versione 2.7.20231115.

Versione 2.6.20230609.1

• È stato aggiunto GADMediationAdapterLineAudioState per gestire lo stato audio iniziale degli annunci banner, interstitial e con premio alla prima visualizzazione.

Creato e testato con:

• SDK Google Mobile Ads versione 10.14.0.
• FiveAd SDK versione 2.6.20230609.

Versione 2.6.20230609.0

• Versione iniziale
• È stato aggiunto il supporto della struttura a cascata per i formati degli annunci banner, interstitial, con premio e nativi.
• Compatibilità verificata con la versione 2.6.20230609 dell'SDK FiveAd.

Creato e testato con:

• SDK Google Mobile Ads versione 10.9.0.
• FiveAd SDK versione 2.6.20230609.