Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Line utilizzando la mediazione, coprendo 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 Unity.
Integrazioni e formati degli annunci supportati
L' Ad Manager adattatore di mediazione per Line offre 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 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 linea 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 Line
Scarica la versione più recente del plug-in di mediazione Google Mobile Ads per Line
dal link di download nel
Changelog ed estrai
GoogleMobileAdsLineMediation.unitypackage
dal file ZIP.
Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto > Pacchetto personalizzato e trova il file GoogleMobileAdsLineMediation.unitypackage
che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su
Importa.
Quindi, seleziona Asset > Risolvere Play Services > Risolvere Android >
Forza risoluzione. La libreria Unity Play Services Resolver eseguirà la risoluzione delle dipendenze da zero e copierà le dipendenze dichiarate nella 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
Attivare gli annunci di prova
Assicurati di registrare il dispositivo di test per AdMob.
Segui le istruzioni riportate nella documentazione di Line per Android e iOS su come attivare gli annunci di prova di Line.
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
Il plug-in di mediazione Line Unity supporta il seguente parametro di richiesta aggiuntivo che può essere passato all'adattatore tramite la classe LineMediationExtras
:
SetEnableAdSound(boolean)
: specifica lo stato di inizio predefinito dell'audio degli 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 da 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 Line quando non riesce a caricare un annuncio:
Android
Codice di errore | Dominio | Motivo |
---|---|---|
1-10 | com.five_corp.ad | L'SDK Line ha restituito un errore specifico dell'SDK. Per ulteriori dettagli, consulta la documentazione di 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 da 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 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 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 del plug-in di mediazione Unity di Line
Versione 1.3.1
- Supporta l'adattatore per Android di Line versione 2.8.20240808.0.
- Supporta la versione 2.8.20240612.0 dell'adattatore Line per iOS.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.2.0.
Versione 1.3.0
- Supporta la versione 2.8.20240722.0 dell'adattatore per Android di Line.
- Supporta la versione 2.8.20240612.0 dell'adattatore Line per iOS.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.2.0.
Versione 1.2.0
- Supporta l'adattatore per Android di Line versione 2.7.20240515.0.
- Supporta la versione 2.8.20240612.0 dell'adattatore Line per iOS.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.1.
Versione 1.1.2
- Supporta l'adattatore per Android di Line versione 2.7.20240515.0.
- Supporta la versione 2.7.20240411.0 dell'adattatore Line per iOS.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
Versione 1.1.1
- Supporta l'adattatore per Android di Line versione 2.7.20240214.1.
- Supporta la versione 2.7.20240411.0 dell'adattatore Line per iOS.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
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 per Android di Line versione 2.7.20240214.1.
- Supporta l'adattatore Line per iOS versione 2.7.20240318.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.0.0.
Versione 1.0.0
- Uscita iniziale.
- Supporta l'adattatore per Android di Line versione 2.6.20230607.0.
- Supporta l'adattatore Line per iOS versione 2.6.20230609.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 8.5.1.