Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci da Line utilizzando la mediazione, che tratta le integrazioni con struttura a cascata. Spiega come aggiungere Line alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Line in un'app iOS .
L'interfaccia della dashboard per Linea utilizza testo giapponese per etichette, pulsanti e descrizioni. Gli screenshot in questa guida non sono stati tradotti. Tuttavia, nelle descrizioni e nelle istruzioni di questa guida, etichette e pulsanti sono tradotti tra parentesi con l'equivalente in lingua inglese.
Integrazioni e formati degli annunci supportati
L' AdMob adattatore di mediazione per la linea offre le seguenti funzionalità:
| Integrazione | |
|---|---|
| Offerte | |
| Struttura a cascata | 1 |
| Formati | |
| Banner | |
| Interstitial | |
| Con premio | |
| Nativo | |
1 L'integrazione a cascata è in versione beta aperta.
Requisiti
- Target del deployment di iOS 12.0 o versioni successive
Versione più recente dell'SDK Google Mobile Ads
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
Devi aggiungere Line alla configurazione della mediazione per la tua unità pubblicitaria.
Innanzitutto, accedi all'account AdMob. Quindi, vai alla scheda Mediazione. Se vuoi modificare un gruppo di mediazione esistente, fai clic sul nome del gruppo per modificarlo e vai alla sezione Aggiungi Line come origine annuncio.
Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.
Inserisci il formato dell'annuncio e la piattaforma, poi fai clic su Continua.
Assegna un nome al gruppo di mediazione e seleziona le località da scegliere come target. Imposta lo stato del gruppo di mediazione su Attivato e fai clic su Aggiungi unità pubblicitarie.
Associa questo gruppo di mediazione a una o più unità pubblicitarieAdMob esistenti. Poi, fai clic su Fine.
A questo punto, dovresti vedere la scheda delle unità pubblicitarie compilata con quelle selezionate:
Aggiungi Line come origine annuncio
Nella scheda Con struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona Line.
Seleziona Line. Inserisci un valore eCPM perLine e fai clic su Continua.
Se hai già una mappatura per Line, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.
Quindi, inserisci l' Application ID and Slot ID ottenuto nella sezione precedente. Poi, fai clic su Fine.
Passaggio 3: importa l'SDK e l'adattatore Line
Utilizzo di CocoaPods (consigliato)
Aggiungi la seguente riga al podfile del progetto:
pod 'GoogleMobileAdsMediationLine'
Dalla riga di comando, esegui:
pod install --repo-update
Integrazione manuale
- Scarica la versione più recente dell'SDK Line e collega
FiveAd.frameworknel tuo progetto. - Scarica la versione più recente dell'adattatore di linea dal link di download in Changelog e collega
LineAdapter.frameworknel tuo progetto.
Passaggio 4: aggiungi il codice richiesto
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 AdMob
Segui le istruzioni riportate nella Documentazione 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
L'adattatore di linea supporta un parametro di richiesta aggiuntivo che può essere passato
all'adattatore utilizzando la classe GADMediationAdapterLineExtras. Questo corso
include le seguenti proprietà:
adAudio- Specifica lo stato di inizio audio predefinito degli 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:
Swift
import LineAdapter
// ...
let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)
Objective-C
#import <LineAdapter/LineAdapter.h>
// ...
GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];
Utilizzo degli annunci nativi
Rendering degli annunci
L'adattatore di linea compila i seguenti campi
Descrizioni dei campi avanzati degli annunci nativi
per un
GADNativeAd
| Campo | Asset sempre inclusi dall'adattatore di rete |
|---|---|
| Titolo | |
| Immagine | |
| Corpo | |
| Icona dell'app | 1 |
| Call to action | |
| Star rating | |
| Negozio | |
| Prezzo |
1 Per gli annunci nativi, l'SDK Line non fornisce un asset per l'icona dell'app. L'adattatore a linee popola l'icona dell'app con un'immagine trasparente.
Codici di errore
Se l'adattatore non riceve un annuncio dalla riga, puoi controllare l'errore sottostante della risposta dell'annuncio utilizzando
GADResponseInfo.adNetworkInfoArray
nei seguenti corsi:
GADMediationAdapterLine
Di seguito sono riportati i codici e i relativi messaggi generati dall'adattatore di linea quando non viene caricato un annuncio:
| 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. |
| 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 dell'adattatore di mediazione LINE per iOS
Versione successiva
- Aggiunto il controllo audio per l'annuncio nativo tramite GADVideoOptions.
Versione 2.7.20240411.0
- È stata verificata la compatibilità con l'SDK FiveAd versione 2.7.20240411.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.3.0.
- SDK FiveAd versione 2.7.20240411.
Versione 2.7.20240318.0
- È stata verificata la compatibilità con l'SDK FiveAd versione 2.7.20240318.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.2.0.
- SDK FiveAd versione 2.7.20240318.
Versione 2.7.20240214.1
- Ora è necessaria la versione minima di iOS 12.0.
- Ora è necessaria la versione 11.0 o versioni successive dell'SDK Google Mobile Ads.
Info.plistincluso nei framework all'interno diLineAdapter.xcframework.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.0.1.
- SDK FiveAd versione 2.7.20240214.
Versione 2.7.20240214.0
- È stata verificata la compatibilità con l'SDK FiveAd versione 2.7.20240214.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.0.1.
- SDK FiveAd versione 2.7.20240214.
Versione 2.7.20240126.0
- È stata verificata la compatibilità con l'SDK FiveAd versione 2.7.20240126.
- È stata aggiornata l'implementazione dell'adattatore con i nuovi protocolli di delega dell'SDK FiveAd.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.14.0.
- SDK FiveAd versione 2.7.20240126.
Versione 2.7.20231115.0
- È stata verificata la compatibilità con l'SDK FiveAd versione 2.7.20231115.
- Intestazione
GADMediationAdapterLineExtrasinclusa nella modulemap.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.14.0.
- SDK FiveAd versione 2.7.20231115.
Versione 2.6.20230609.1
- È stato aggiunto
GADMediationAdapterLineAudioStateper gestire lo stato audio iniziale dell'annuncio banner, interstitial e con premio quando viene visualizzato per la prima volta.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.14.0.
- SDK FiveAd versione 2.6.20230609.
Versione 2.6.20230609.0
- Versione iniziale
- È stato aggiunto il supporto della struttura a cascata per i formati di annunci banner, interstitial, con premio e nativi.
- È stata verificata la compatibilità con l'SDK FiveAd versione 2.6.20230609.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.9.0.
- SDK FiveAd versione 2.6.20230609.