Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare di annunci provenienti dalla linea utilizzando la mediazione, che riguardano integrazioni 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 Unity.
Integrazioni e formati degli annunci supportati
L' Ad Manager adattatore di mediazione per Line dispone di le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Cascata | 1 |
Formati | |
Banner | |
Interstitial | |
Con premio |
1 L'integrazione della struttura a cascata è attiva beta chiusa, contatta il tuo account manager per richiedere l'accesso.
Requisiti
- Unity 4 o superiore
- Versione più recente dell'SDK Google Mobile Ads
- Per il deployment su Android
- Livello API Android 21 o superiore
- Per il deployment su iOS
- Target del deployment di iOS 12.0 o versioni successive
- Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Consulta Inizia per maggiori dettagli.
- Completa la Guida introduttiva di mediazione
Passaggio 1: configura le impostazioni nell'interfaccia utente di Line
Passaggio 2: configura la domanda pubblicitaria nell' Ad Manager UI
Configurare le impostazioni di mediazione per l'unità pubblicitaria
Android
Per le istruzioni, consulta il passaggio 2 della guida per Android.
iOS
Per le istruzioni, consulta il passaggio 2 nella guida per iOS.
Passaggio 3: importa l'SDK e l'adattatore Line
Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per Line
dal link di download nel
Log delle modifiche ed estrazione
GoogleMobileAdsLineMediation.unitypackage
dal file ZIP.
Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto >
Pacchetto personalizzato e trova GoogleMobileAdsLineMediation.unitypackage
che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su
Importa.
Poi seleziona Asset > Risoluzione di Play Services > Resolver Android >
Forza risoluzione. La libreria resolver di Unity Play Services eseguirà
delle dipendenze da zero e copiare le dipendenze dichiarate
Directory Assets/Plugins/Android
della tua app Unity.
Passaggio 4: aggiungi il codice richiesto
Android
Non è necessario alcun codice aggiuntivo per l'integrazione di Line.
iOS
Integrazione di SKAdNetwork
Segui la documentazione di Line
per aggiungere gli identificatori SKAdNetwork al file Info.plist
del progetto.
Passaggio 5: testa l'implementazione
Attiva annunci di prova
Assicurati di registrare il dispositivo di test per Ad Manager
Segui le istruzioni riportate nella Documentazione di Android e iOS di Line su come attivare gli annunci di prova di Line.
Verifica annunci di prova
Per verificare di ricevere annunci di prova daLine, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le Line (Waterfall) origini annuncio.
Passaggi facoltativi
Parametri specifici della rete
Il plug-in di mediazione Line Unity supporta la seguente richiesta aggiuntiva
parametro che può essere passato all'adattatore tramite LineMediationExtras
classe:
SetEnableAdSound(boolean)
: specifica lo stato di inizio dell'audio predefinito di banner, interstitial e annunci con premio.
Di seguito è riportato un esempio di codice che mostra come creare una richiesta di annuncio che imposti 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 riceve un annuncio dalla linea,
i publisher possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando
ResponseInfo
nei seguenti corsi:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Di seguito sono riportati i codici e i relativi messaggi generati dall'adattatore di linea quando l'annuncio non viene caricato:
Android
Codice di errore | Dominio | Motivo |
---|---|---|
1-10 | com.five_corp.ad | Line SDK ha restituito un errore specifico dell'SDK. Consulta Documentazione di Line per ulteriori dettagli. |
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 linea. |
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 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 | Inviato da Line SDK | Line SDK 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 dalla linea. |
103 | com.google.ads.mediation.line | Impossibile caricare un asset immagine per l'icona delle informazioni nell'annuncio nativo. |
Log delle modifiche del plug-in di mediazione Unity di Line
Versione 1.3.1
- Supporta l'adattatore Android linea versione 2.8.20240808.0.
- Supporta l'adattatore iOS automatico versione 2.8.20240612.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.2.0.
Versione 1.3.0
- Supporta l'adattatore Android linea versione 2.8.20240722.0.
- Supporta l'adattatore iOS automatico versione 2.8.20240612.0.
- Creato e testato con la versione 9.2.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.2.0
- Supporta l'adattatore Android linea versione 2.7.20240515.0.
- Supporta l'adattatore iOS automatico versione 2.8.20240612.0.
- Sviluppato e testato con la versione 9.1.1 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.1.2
- Supporta l'adattatore per Android di Line versione 2.7.20240515.0.
- Supporta l'adattatore iOS automatico versione 2.7.20240411.0.
- Creato e testato con la versione 9.1.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.1.1
- Supporta l'adattatore Android linea versione 2.7.20240214.1.
- Supporta l'adattatore iOS automatico versione 2.7.20240411.0.
- Creato e testato con la versione 9.1.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.1.0
- È stata aggiunta la classe
LineMediationExtras
con i seguenti metodi per supportare il passaggio degli extra di mediazione.SetEnabledAdSound(bool)
- Supporta l'adattatore Android linea versione 2.7.20240214.1.
- Supporta l'adattatore iOS automatico versione 2.7.20240318.0.
- Creato e testato con la versione 9.0.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.0.0
- Rilascio iniziale.
- Supporta l'adattatore Android linea versione 2.6.20230607.0.
- Supporta l'adattatore iOS automatico versione 2.6.20230609.0.
- Creato e testato con la versione 8.5.1 del plug-in Unity degli annunci per dispositivi mobili di Google.