Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci da maio utilizzando la mediazione, che riguarda le integrazioni con struttura a cascata. Descrive come aggiungere maio alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'adattatore e l'SDK maio in un'appiOS .
L'interfaccia della dashboard per maio utilizza testo in giapponese per etichette, pulsanti e descrizioni e gli screenshot in questa guida non sono stati tradotti. Tuttavia, nelle descrizioni e nelle istruzioni di questa guida, a etichette e pulsanti viene fatto riferimento ai rispettivi equivalenti in lingua inglese. ad esempio, "URL mondialeム" è "Schema URL" e così via.
Integrazioni e formati degli annunci supportati
L' AdMob adattatore di mediazione per maio ha le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Struttura a cascata | |
Formati | |
Banner | |
Interstitial | |
Con premio | |
Nativo |
Requisiti
- Target di deployment per iOS 12.0 o versioni successive
- [Per le offerte]: maio Adapter 1.5.8.0 o versioni successive (ultima versione consigliata)
Versione più recente dell'SDK Google Mobile Ads
Completa la mediazione Guida introduttiva
Passaggio 1: imposta le configurazioni nella UI di maio
Innanzitutto, registrati o accedi al tuo account maio. Fai clic sul pulsante Gestione applicazioni nella barra laterale sinistra e poi su Nuova app.
Seleziona la scheda corrispondente al Tipo di annuncio che preferisci.
Interstitial
Inserisci il nome della tua app, seleziona la piattaforma e fornisci il tuo URL dell'app. Seleziona Interstitial video come Tipo di annuncio, poi fai clic su Aggiorna.
Con premio
Inserisci il nome della tua app, seleziona la piattaforma e fornisci il tuo URL dell'app. Seleziona Premi video come Tipo di annuncio, quindi fai clic su Aggiorna.
Nella pagina Gestione applicazione, prendi nota dell'ID media. È necessario configurare l' AdMob unità pubblicitaria nella sezione successiva.
Nella pagina Gestione zona, prendi nota dell'ID zona. Sarà necessario anche configurare l' AdMob unità pubblicitaria nella sezione successiva.
(Solo con struttura a cascata) Oltre all'ID media e all'ID zona, avrai bisogno dell'ID API e della CHIAVE API per configurare l'ID unità pubblicitaria per la mediazione. Nella pagina API di reporting, prendi nota di ID API e CHIAVE API.Passaggio 2: configura la domanda maio nella AdMob UI
Configurare le impostazioni di mediazione per l'unità pubblicitaria
Devi aggiungere maio 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 maio 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 maio come origine annuncio
Offerte
Nella scheda Offerte nella sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona maio.
Fai clic su Come firmare un contratto di partnership e instaura una partnership di asta con maio.
Fai clic su Confermo e accetto e poi su Continua.
Se hai già una mappatura per maio, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.
Quindi, inserisci l' Publisher ID ottenuto nella sezione precedente. Poi, fai clic su Fine.
Importante: Media ID deve essere associato all'app scelta come target come nell'maio UI.Struttura a cascata
Nella scheda Con struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona maio.
Seleziona maio e attiva l'opzione Ottimizza. Inserisci quanto API ID and API KEY ottenuto nella sezione precedente per configurare l'ottimizzazione dell'origine annuncio per maio. Inserisci un valore eCPM permaio e fai clic su Continua.Se hai già una mappatura per maio, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.
Quindi, inserisci l' Media ID and Zone ID ottenuto nella sezione precedente. Poi, fai clic su Fine.
Passaggio 3: importa l'SDK e l'adattatore maio
Utilizzo di CocoaPods (consigliato)
Aggiungi la riga seguente al podfile del progetto:
pod 'GoogleMobileAdsMediationMaio'
Dalla riga di comando, esegui:
pod install --repo-update
Integrazione manuale
- Scarica la versione più recente dell'SDK Maio.
- Scarica la versione più recente dell'adattatore maio dal link di download nel log delle modifiche e collega il link
maioAdapter.framework
nel tuo progetto.
Passaggio 4: aggiungi il codice richiesto
Integrazione di SKAdNetwork
Segui la documentazione di maio per aggiungere gli identificatori SKAdNetwork al file Info.plist
del tuo progetto.
Passaggio 5: testa l'implementazione
Attiva annunci di prova
Assicurati di registrare il dispositivo di test per AdMob
I publisher che utilizzano la versione 7.26.0 o successive dell'SDK Google Mobile Ads riceveranno automaticamente annunci di prova da maio su telefoni e tablet registrati come dispositivi di test quando effettuano le richieste.
Verifica annunci di prova
Per verificare di ricevere annunci di prova damaio, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le maio (Bidding) and maio (Waterfall) origini annuncio.
Codici di errore
Se l'adattatore non riceve un annuncio da maio, i publisher possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando
GADResponseInfo.adNetworkInfoArray
nei seguenti corsi:
Formato | Nome corso |
---|---|
Interstitial | GADMMaioInterstitialAdapter |
Con premio | GADMMaioRewardedAdapter |
Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore maio quando un annuncio non viene caricato:
Codice di errore | Motivo |
---|---|
0-10 | maio ha restituito un errore specifico dell'SDK. Consulta il codice e la documentazione di maio per ulteriori dettagli. |
101 | Maio non dispone di annunci disponibili. |
102 | Parametri server non validi (ad es. ID posizionamento mancante). |
103 | Il contesto utilizzato per caricare un annuncio non era un'istanza di tipo "Attività". |
0-10 | maio ha restituito un errore specifico dell'SDK. Consulta il codice di maio per ulteriori dettagli. |
101 | maio non ha ancora un annuncio disponibile. |
102 | Parametri server non validi (ad es. ID posizionamento mancante). |
103 | L'adattatore maio non supporta il formato dell'annuncio richiesto. |
104 | È già stato caricato un annuncio per questa configurazione di rete. |
Log delle modifiche dell'adattatore di mediazione per iOS
Versione 2.1.3.0
- Compatibilità verificata con l'SDK maio versione 2.1.3.
Realizzato e testato con:
- SDK Google Mobile Ads versione 11.1.0.
- SDK Maio versione 2.1.3.
Versione 2.1.2.1
- Ora richiede l'SDK Google Mobile Ads versione 11.0 o successive.
- Incluso
Info.plist
nei framework all'interno diMaioAdapter.xcframework
.
Realizzato e testato con:
- SDK Google Mobile Ads versione 11.0.1.
- SDK Maio versione 2.1.2.
Versione 2.1.2.0
- Compatibilità verificata con l'SDK maio versione 2.1.2.
Realizzato e testato con:
- SDK Google Mobile Ads versione 10.14.0.
- SDK Maio versione 2.1.2.
Versione 2.1.1.0
- Compatibilità verificata con l'SDK maio versione 2.1.1.
Realizzato e testato con:
- SDK Google Mobile Ads versione 10.12.0.
- SDK Maio versione 2.1.1.
Versione 2.0.0.0
- Compatibilità verificata con l'SDK maio versione 2.0.0.
- È stata rimossa la dipendenza da
MaioOB SDK
. - Rimosso il supporto dell'architettura
armv7
. - Ora richiede almeno la versione iOS 12.0.
- Ora richiede l'SDK Google Mobile Ads versione 10.4.0 o successive.
Realizzato e testato con:
- SDK Google Mobile Ads versione 10.10.0.
- SDK Maio versione 2.0.0.
Versione 1.6.3.1
- Ora richiede l'SDK Google Mobile Ads versione 10.0.0 o successive.
Realizzato e testato con:
- SDK Google Mobile Ads versione 10.0.0.
- SDK Maio versione 1.6.3.
- SDK MaioOB versione 2.0.0-alpha.
Versione 1.6.3.0
- È stato aggiornato l'adattatore in modo che utilizzi l'API
didRewardUser
. - Ora richiede l'SDK Google Mobile Ads versione 9.8.0 o successive.
- Verifica della compatibilità con l'SDK maio versione 1.6.3 e la versione 2.0.0-alpha dell'SDK maioOB.
Realizzato e testato con:
- SDK Google Mobile Ads versione 9.12.0.
- SDK Maio versione 1.6.3.
- SDK MaioOB versione 2.0.0-alpha.
Versione 1.6.2.0
- Verifica della compatibilità con l'SDK maio versione 1.6.2 e la versione 2.0.0-alpha dell'SDK maioOB.
Realizzato e testato con:
- SDK Google Mobile Ads versione 9.5.0.
- SDK Maio versione 1.6.2.
- SDK MaioOB versione 2.0.0-alpha.
Versione 1.6.1.0
- Verificata la compatibilità con l'SDK maio versione 1.6.1 e la versione 2.0.0-alpha dell'SDK maioOB.
Realizzato e testato con:
- SDK Google Mobile Ads versione 9.2.0.
- SDK Maio versione 1.6.1.
- SDK MaioOB versione 2.0.0-alpha.
Versione 1.6.0.1
- Compatibilità verificata con l'SDK Google Mobile Ads versione 9.0.0.
- Ora richiede l'SDK Google Mobile Ads versione 9.0.0 o successive.
Realizzato e testato con:
- SDK Google Mobile Ads versione 9.0.0.
- SDK Maio versione 1.6.0.
- SDK MaioOB versione 2.0.0-alpha.
Versione 1.6.0.0
- Verifica della compatibilità con l'SDK maio versione 1.6.0 e la versione 2.0.0-alpha dell'SDK maioOB.
Realizzato e testato con:
- SDK Google Mobile Ads versione 8.13.0.
- Ora richiede almeno la versione iOS 10.0.
- SDK Maio versione 1.6.0.
- SDK MaioOB versione 2.0.0-alpha.
Versione 1.5.8.0
- Verifica della compatibilità con l'SDK maio versione 1.5.8 e la versione 2.0.0-alpha dell'SDK maioOB.
- È stata aggiunta la funzionalità di offerta all'adattatore per i formati di annunci interstitial e con premio.
- Dipendenza semplice dall'SDK Google Mobile Ads versione 8.0.0 o successive.
Realizzato e testato con:
- SDK Google Mobile Ads versione 8.7.0.
- SDK Maio versione 1.5.8.
- SDK MaioOB versione 2.0.0-alpha.
Versione 1.5.6.1
- Sono stati aggiunti messaggi e codici di errore relativi all'adattatore standardizzato.
- È stato aggiornato l'adattatore in modo che utilizzi il formato
.xcframework
. - Risolto un bug per cui a volte gli eventi relativi agli annunci con premio non venivano inoltrati.
- Ora richiede l'SDK Google Mobile Ads versione 8.3.0 o successive.
Realizzato e testato con:
- SDK Google Mobile Ads versione 8.3.0.
- SDK Maio versione 1.5.6.
Versione 1.5.6.0
- Compatibilità verificata con l'SDK maio versione 1.5.6.
- Ora richiede l'SDK Google Mobile Ads 7.68.0 o versioni successive.
Realizzato e testato con:
- SDK Google Mobile Ads versione 7.68.0.
- SDK Maio versione 1.5.6.
Versione 1.5.5.0
- Compatibilità verificata con l'SDK maio versione 1.5.5.
- Ora richiede l'SDK Google Mobile Ads versione 7.64.0 o successive.
Realizzato e testato con:
- SDK Google Mobile Ads versione 7.64.0.
- SDK Maio versione 1.5.5.
Versione 1.5.4.0
- Compatibilità verificata con l'SDK maio versione 1.5.4.
- Ora richiede l'SDK Google Mobile Ads versione 7.60.0 o successive.
Realizzato e testato con:
- SDK Google Mobile Ads versione 7.60.0.
- SDK Maio versione 1.5.4.
Versione 1.5.3.1
- Per limitare i timeout, ora le richieste di annunci non andranno a buon fine se maio non ha un annuncio pronto per essere mostrato.
- Rimosso il supporto per l'architettura i386.
Realizzato e testato con:
- SDK Google Mobile Ads versione 7.58.0.
- SDK Maio versione 1.5.3.
Versione 1.5.3.0
- Compatibilità verificata con l'SDK maio versione 1.5.3.
Realizzato e testato con:
- SDK Google Mobile Ads versione 7.55.1.
- SDK Maio versione 1.5.3.
Versione 1.5.2.1
- Risolto il problema per cui l'adattatore non richiamava il callback
-rewardedAdDidPresent:
.
Realizzato e testato con:
- SDK Google Mobile Ads versione 7.53.1.
- SDK Maio versione 1.5.2.
Versione 1.5.2.0
- Compatibilità verificata con l'SDK maio versione 1.5.2.
Realizzato e testato con:
- SDK Google Mobile Ads versione 7.53.1.
- SDK Maio versione 1.5.2.
Versione 1.5.1.0
- Compatibilità verificata con l'SDK maio versione 1.5.1.
Realizzato e testato con:
- SDK Google Mobile Ads versione 7.52.0.
- SDK Maio versione 1.5.1.
Versione 1.5.0.0
- Compatibilità verificata con l'SDK maio versione 1.5.0.
Realizzato e testato con
- SDK Google Mobile Ads versione 7.51.0.
- SDK Maio Ads versione 1.5.0.
Versione 1.4.8.0
- Compatibilità verificata con l'SDK maio versione 1.4.8.
Versione 1.4.6.0
- Compatibilità verificata con l'SDK maio versione 1.4.6.
- Aggiornato l'adattatore in modo che utilizzi la nuova API con premio.
- Ora richiede l'SDK Google Mobile Ads versione 7.42.2 o successive.
Versione 1.4.2.0
- Compatibilità verificata con l'SDK maio versione 1.4.2.
Versione 1.4.1.0
- Compatibilità verificata con l'SDK maio versione 1.4.1.
- Risolto il problema per cui l'adattatore maio potrebbe non funzionare se vengono forniti più MediaId da AdMob.
Versione 1.4.0.0
- Compatibilità verificata con l'SDK maio versione 1.4.0.
Versione 1.3.2.0
- Compatibilità verificata con l'SDK maio versione 1.3.2.
Versione 1.3.1.1
- Callback
adapterDidCompletePlayingRewardBasedVideoAd:
aggiunto all'adattatore.
Versione 1.3.1.0
- Compatibilità verificata con l'SDK maio versione 1.3.1.
Versione 1.3.0.0
- Compatibilità verificata con l'SDK maio versione 1.3.0.
Versione 1.2.19.0
- Compatibilità verificata con l'SDK maio versione 1.2.19.
Versione 1.2.18.0
- Prima uscita.
- Aggiunto il supporto per gli annunci interstitial e video con premio.