Integrare la Rete di annunci 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 AdMob, che copre 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 per la Rete di annunci 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 la Rete pubblicitaria LINE offre le seguenti funzionalità:

Integrazione
Offerte  1
Cascata  2
Formati
Banner  3
Interstitial  3
Con premio
Nativo
1 L'integrazione delle offerte è in versione beta chiusa. Contatta il tuo account manager per richiedere l'accesso.

2 L'integrazione con struttura a cascata è in versione beta aperta.

3 Questo formato è supportato solo nell'integrazione con struttura a cascata.

Requisiti

  • Target di deployment iOS 12.0 o versioni successive

  • [Per le offerte]: per integrare tutti i formati di annunci supportati nelle offerte, utilizza l'adattatore della Rete di annunci LINE 2.8.20240827.0 o versioni successive (è consigliata la versione più recente)

Passaggio 1: configura le impostazioni nell'interfaccia utente della Rete di annunci LINE

Accedi al tuo account Rete di annunci 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

Segui gli stessi passaggi per creare posizionamenti degli annunci sia per le offerte sia per le integrazioni con la struttura a cascata. Ogni posizionamento dell'annuncio può essere utilizzato per entrambi.

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.

Prendi nota dell'ID slot.

Passaggio 2: configura la domanda della Rete di annunci LINE nell'interfaccia utente di AdMob

Configura le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere la Rete di annunci LINE alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi al tuo account AdMob. Poi, vai alla scheda Mediazione. Se hai già un gruppo di mediazione che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai a Aggiungere la Rete di annunci LINE come origine annuncio.

Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.

Inserisci il formato dell'annuncio e la piattaforma, poi fai clic su Continua.

Assegna un nome al gruppo di mediazione e seleziona le località di destinazione. Imposta quindi lo stato del gruppo di mediazione su Attivato e fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione a una o più unità pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie selezionate:

Aggiungere la Rete di annunci LINE come origine annuncio

Offerte

Nella scheda Offerte della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Poi seleziona Rete pubblicitaria LINE.

Fai clic su Come firmare un contratto di partnership e configura una partnership per l'asta con la Rete pubblicitaria LINE.



Fai clic su Acconsento e poi su Continua.



Se hai già una mappatura per la Rete di annunci LINE, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.



Inserisci quindi Application ID e Slot ID ottenuti nella sezione precedente. Poi fai clic su Fine.



Cascata


Nella scheda Struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Poi seleziona Rete di annunci LINE.

Seleziona LINE Ads Network. Poi inserisci un valore eCPM per la Rete di annunci LINE e fai clic su Continua.



Se hai già una mappatura per la Rete di annunci LINE, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.

Inserisci quindi Application ID e Slot ID ottenuti nella sezione precedente. Poi fai clic su Fine.


Passaggio 3: importa l'SDK e l'adattatore della Rete pubblicitaria LINE

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 della Rete di annunci LINE e collegaFiveAd.framework nel tuo progetto.
  • Scarica la versione più recente dell'adattatore della Rete di annunci LINE dal link di download nel log delle modifiche e collega LineAdapter.framework nel tuo progetto.

Passaggio 4: aggiungi il codice richiesto

Integrazione di SKAdNetwork

Segui la documentazione della Rete di annunci LINE per aggiungere gli identificatori SKAdNetwork al file Info.plist del tuo progetto.

Passaggio 5: testa l'implementazione

Attivare gli annunci di prova

Assicurati di registrare il dispositivo di test per AdMob.

Verificare gli annunci di prova

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

Passaggi facoltativi

Parametri specifici della rete

L'adattatore della Rete pubblicitaria 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 = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

Objective-C

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

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

Utilizzare gli annunci nativi

Rendering dell'annuncio

L'adattatore della Rete pubblicitaria LINE compila le seguenti descrizioni dei campi avanzati degli annunci nativi per un GADNativeAd.

Campo Asset sempre inclusi dall'adattatore LINE Ads Network
Titolo
Immagine
Corpo
Icona dell'app 1
Call to action
Valutazione a stelle
Negozio
Prezzo

1 Per gli annunci nativi, l'SDK della Rete pubblicitaria LINE non fornisce un asset icona dell'app. L'adattatore della Rete di annunci LINE compila l'icona dell'app con un'immagine trasparente.

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio dalla Rete pubblicitaria 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 della Rete pubblicitaria LINE quando non riesce a caricare un annuncio:

Codice di errore Dominio Motivo
1-10 Inviata dall'SDK LINE Ads Network L'SDK LINE Ads Network ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione della Rete di annunci 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 dalla Rete di annunci 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 successiva

  • È stata rimossa la logica che verificava se l'SDK FAD era registrato nella configurazione dell'adattatore.
  • È stata aggiornata l'API "show" degli annunci interstitial e con premio con la nuova API "showWithViewController:".
  • È stato rimosso il controllo dello stato degli annunci nativi prima del download degli asset annunci nativi perché è deprecato e non è disponibile un'alternativa.

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.