Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci da Line tramite la mediazione, trattando le integrazioni con struttura a cascata. Descrive come aggiungere Line alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Line in un'app Unity.
Integrazioni e formati degli annunci supportati
L' Ad Manager adattatore di mediazione per la linea offre le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Struttura a cascata | 1 |
Formati | |
Banner | |
Interstitial | |
Con premio |
1 L'integrazione con struttura a cascata è in versione 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. Per maggiori dettagli, consulta la Guida introduttiva.
- 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' 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 di Google Mobile Ads per Line
dal link di download nel
Changelog ed estrai GoogleMobileAdsLineMediation.unitypackage
dal file ZIP.
Nell'editor del progetto Unity, seleziona Assets > Import Package >
Custom Package (Asset > Importa pacchetto > Pacchetto personalizzato) e individua il file GoogleMobileAdsLineMediation.unitypackage
che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.
Dopodiché seleziona Assets > Play Services Resolver > Android Resolver >
Force Resolver. La libreria resolver Unity Play Services 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 di 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 Unity delle linee supporta il seguente parametro di richiesta
aggiuntivo che può essere trasmesso all'adattatore tramite la classe
LineMediationExtras
:
SetEnableAdSound(boolean)
: specifica lo stato predefinito dell'inizio dell'audio per gli annunci banner, interstitial e 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 da Line,
i publisher possono verificare l'errore sottostante della risposta dell'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 relativi messaggi generati dall'adattatore di linea quando non è possibile caricare un annuncio:
Android
Codice di errore | Dominio | Motivo |
---|---|---|
1-10 | com.five_corp.ad | Line SDK 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 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. 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 Line Unity
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.