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 della Rete pubblicitaria LINE utilizzando la mediazione, coprendo le integrazioni con la struttura a cascata. Descrive come aggiungere LINE Ads Network alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di LINE Ads Network in un'app Unity.

Integrazioni e formati degli annunci supportati

L' Ad Manager adattatore di mediazione per la Rete pubblicitaria LINE ha le seguenti funzionalità:

Integrazione
Offerte
Cascata  1
Formati
Banner
Interstitial
Con premio

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

Requisiti

  • Unity 4 o versioni successive
  • SDK Google Mobile Ads più recente
  • Per eseguire il deployment su Android
    • Livello API Android 21 o superiore
  • Per eseguire il deployment su iOS
    • Target di deployment iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la guida introduttiva.
  • Completa la guida introduttiva alla mediazione

Passaggio 1: configura le impostazioni nell'interfaccia utente di 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

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' Ad Manager interfaccia utente

Configura le impostazioni di mediazione per l'unità pubblicitaria

Android

Per istruzioni, vedi il passaggio 2 della guida per Android.

iOS

Per istruzioni, vedi il passaggio 2 della guida per iOS.

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

OpenUPM-CLI

Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione della Rete di annunci LINE di Google Mobile Ads per Unity nel tuo progetto eseguendo il seguente comando dalla directory principale del progetto:

openupm add com.google.ads.mobile.mediation.line

OpenUPM

Nell'editor del progetto Unity, seleziona Modifica > Impostazioni progetto > Gestore pacchetti per aprire le Impostazioni di Gestore pacchetti di Unity.

Nella scheda Registri basati su ambito, aggiungi OpenUPM come registry basato su ambito con i seguenti dettagli:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Ambiti: com.google

Dettagli OpenUPM

Quindi, vai a Finestra > Gestore pacchetti per aprire Gestore pacchetti Unity e selezionare I miei registry dal menu a discesa.

Registri Unity

Seleziona il pacchetto Mediazione della Rete di annunci LINE di Google Mobile Ads e fai clic su Installa.

Installazione da OpenUPM

Pacchetto Unity

Scarica la versione più recente del plug-in di mediazione Google Mobile Ads per la Rete di annunci LINE dal link di download nel log delle modifiche ed estrai il file GoogleMobileAdsLineMediation.unitypackage dal file ZIP.

Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto > Pacchetto personalizzato e trova il GoogleMobileAdsLineMediation.unitypackage file che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

Importa da Unity

Quindi, seleziona Asset > Gestore delle dipendenze esterne > Risolvere Android > Forza risoluzione. La libreria External Dependency Manager effettuerà la risoluzione delle dipendenze da zero e copierà le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

Forza risoluzione

Passaggio 4: aggiungi il codice richiesto

Android

Non è necessario codice aggiuntivo per l'integrazione della Rete di annunci LINE.

iOS

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

Il plug-in di mediazione Unity della Rete pubblicitaria LINE supporta il seguente parametro di richiesta aggiuntivo, che può essere passato all'adattatore tramite la classe LineMediationExtras:

  • SetEnableAdSound(boolean): 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:

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio dalla Rete pubblicitaria LINE, i publisher possono controllare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

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:

Android

Codice di errore Dominio Motivo
1-10 com.five_corp.ad L'SDK della Rete pubblicitaria LINE ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione della Rete di annunci LINE.
101 com.google.ads.mediation.line ID applicazione mancante o non valido.
102 com.google.ads.mediation.line ID slot mancante o non valido.
103 com.google.ads.mediation.line La dimensione dell'annuncio richiesta non corrisponde a una dimensione dell'annuncio banner supportata dalla Rete di annunci LINE.
104 com.google.ads.mediation.line Impossibile caricare un annuncio in-app o con premio a causa del contesto dell'attività mancante.
105 com.google.ads.mediation.line L'SDK LINE Ads Network non è riuscito a mostrare un annuncio interstitial o con premio.
106 com.google.ads.mediation.line Impossibile caricare un annuncio nativo a causa di asset mancanti.

iOS

Codice di errore Dominio Motivo
1-10 Inviata dall'SDK LINE Ads Network L'SDK della Rete pubblicitaria LINE 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 del plug-in di mediazione Unity di Line

Versione 1.4.0

Versione 1.3.1

Versione 1.3.0

Versione 1.2.0

Versione 1.1.2

Versione 1.1.1

Versione 1.1.0

Versione 1.0.0