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 elementi pubblicitari al riquadro configurazione della mediazione e come integrare Line SDK e l'adattatore in un'app Unity.
Integrazioni e formati degli annunci supportati
L' AdMob 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 è in versione beta aperta.
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 configurazioni nella UI a linee
Accedi al tuo account Line.
Aggiungi una nuova applicazione
Fai clic su 広告枠管理 (Gestione aree annuncio) > デア (Media). Quindi, fai clic su Authenticator規作成 (Crea nuovo).
Compila il modulo e fai clic su Ұ (Registra).
Prendi nota dell'ID applicazione.
Crea un posizionamento dell'annuncio
Fai clic sull'ID dell'applicazione a cui vuoi aggiungere un posizionamento dell'annuncio. Poi, seleziona 詳細 (Dettaglio).
Fai clic su ytcット 追加 (Add Slot) (Aggiungi slot).
Compila il modulo e, una volta terminato, fai clic su (⤷Ұ) Registrati.
Prendi nota dell'ID area annuncio.
Passaggio 2: configura la domanda pubblicitaria nell' AdMob 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 AdMob
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 informazioni. |
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 interstitial o con premio a causa di un 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. Consulta Documentazione di Line per ulteriori informazioni. |
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 Line Unity
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 Android linea 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.