Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di maio utilizzando la mediazione AdMob, coprendo le integrazioni con la struttura a cascata. Descrive come aggiungere maio alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore maio in un'app per iOS.
L'interfaccia della dashboard di maio utilizza il testo giapponese per le etichette, i pulsanti e le descrizioni e gli screenshot di questa guida non sono stati tradotti. Tuttavia, nelle descrizioni e nelle istruzioni di questa guida, le etichette e i pulsanti sono indicati con i relativi equivalenti in lingua inglese. Ad esempio, "URL スキーム" è "URL Scheme".
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per maio offre le seguenti funzionalità:
| Integrazione | |
|---|---|
| Offerte | |
| Cascata | |
| Formati | |
| Banner | |
| Interstitial | |
| Con premio | |
| Nativo | |
Requisiti
- Target di deployment iOS 12.0 o versioni successive
SDK Google Mobile Ads più recente
Completare la mediazione Guida introduttiva
Passaggio 1: configura le configurazioni nell'interfaccia utente di maio
Innanzitutto, registrati o accedi al tuo account maio. Fai clic sul pulsante Gestione app nella barra laterale a 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 URL dell'app. Seleziona Interstitial video come Tipo di annuncio e poi fai clic su Aggiorna.
Con premio
Inserisci il nome della tua app, seleziona la piattaforma e fornisci il URL dell'app. Seleziona Premi video come Tipo di annuncio e poi fai clic su Aggiorna.
Nella pagina Gestione applicazioni, prendi nota dell'ID media. È necessario configurare l'unità pubblicitaria AdMob nella sezione successiva.
Nella pagina Gestione zone, prendi nota dell'ID zona. Inoltre, sarà necessario configurare l'unità pubblicitaria AdMob nella sezione successiva.
Passaggio 2: configura la domanda maio nell'interfaccia utente di AdMob
Configura le impostazioni di mediazione per l'unità pubblicitaria
Devi aggiungere maio alla configurazione della mediazione per la tua unità pubblicitaria.
Innanzitutto, accedi al tuo account AdMob. Poi, vai alla scheda Mediazione. Se hai già un gruppo di mediazione che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai a Aggiungere 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à di destinazione. Imposta quindi 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à pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.
Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie selezionate:
Aggiungere maio come origine annuncio
Nella scheda Struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Quindi seleziona maggio.
Seleziona maggio e attiva l'opzione Ottimizza. Inserisci ID API e CHIAVE API ottenuti nella sezione precedente per configurare l'ottimizzazione delle origini annuncio per maio. Poi inserisci un valore eCPM per maio e fai clic su Continua.
Se hai già una mappatura per maio, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.
Inserisci quindi ID media e ID zona ottenuti nella sezione precedente. Poi fai clic su Fine.
Passaggio 3: importa l'SDK e l'adattatore maio
Utilizzo di CocoaPods (opzione consigliata)
Aggiungi la seguente riga 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
Changelog,
e collega
maioAdapter.frameworknel 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 progetto.
Passaggio 5: testa l'implementazione
Attivare gli 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 richieste.
Verificare gli annunci di prova
Per verificare di ricevere annunci di prova da maio, attiva il test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio maio (a cascata).
Codici di errore
Se l'adattatore non riesce a ricevere un annuncio da Maio,
i publisher possono controllare l'errore sottostante dalla risposta all'annuncio utilizzando
GADResponseInfo.adNetworkInfoArray
nelle seguenti classi:
| Formato | Nome del corso |
|---|---|
| Interstitial | GADMMaioInterstitialAdapter |
| Con premio | GADMMaioRewardedAdapter |
Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore maio quando non riesce a caricare un annuncio:
| Codice di errore | Motivo |
|---|---|
| 0-10 | maio ha restituito un errore specifico dell'SDK. Per maggiori dettagli, consulta il codice di Maio. |
| 101 | maio non ha ancora un annuncio disponibile. |
| 102 | Parametri del server non validi (ad es. ID posizionamento mancante). |
| 103 | L'adattatore maio non supporta il formato dell'annuncio richiesto. |
| 104 | Per questa configurazione della rete è già stato caricato un annuncio. |
Log delle modifiche dell'adattatore di mediazione iOS maio
Versione 2.1.5.1
CFBundleShortVersionStringè stato aggiornato in modo da avere tre componenti anziché quattro.
Creato e testato con:
- SDK Google Mobile Ads versione 11.10.0.
- SDK Maio versione 2.1.5.
Versione 2.1.5.0
- Compatibilità verificata con la versione 2.1.5 dell'SDK maio.
Creato e testato con:
- SDK Google Mobile Ads versione 11.6.0.
- SDK Maio versione 2.1.5.
Versione 2.1.4.0
- Compatibilità verificata con la versione 2.1.4 dell'SDK maio.
Creato e testato con:
- SDK Google Mobile Ads versione 11.2.0.
- SDK Maio versione 2.1.4.
Versione 2.1.3.0
- È stata verificata la compatibilità con la versione 2.1.3 dell'SDK maio.
Creato e testato con:
- SDK Google Mobile Ads versione 11.1.0.
- SDK Maio versione 2.1.3.
Versione 2.1.2.1
- Ora è richiesta la versione 11.0 o successive dell'SDK Google Mobile Ads.
Info.plistè stato incluso nei framework diMaioAdapter.xcframework.
Creato e testato con:
- SDK Google Mobile Ads versione 11.0.1.
- SDK Maio versione 2.1.2.
Versione 2.1.2.0
- È stata verificata la compatibilità con la versione 2.1.2 dell'SDK maio.
Creato e testato con:
- SDK Google Mobile Ads versione 10.14.0.
- SDK Maio versione 2.1.2.
Versione 2.1.1.0
- È stata verificata la compatibilità con la versione 2.1.1 dell'SDK maio.
Creato e testato con:
- SDK Google Mobile Ads versione 10.12.0.
- SDK Maio versione 2.1.1.
Versione 2.0.0.0
- È stata verificata la compatibilità con la versione 2.0.0 dell'SDK maio.
- È stata rimossa la dipendenza da
MaioOB SDK. - È stato rimosso il supporto dell'architettura
armv7. - Ora è richiesta la versione minima iOS 12.0.
- Ora è richiesta la versione 10.4.0 o successive dell'SDK Google Mobile Ads.
Creato e testato con:
- SDK Google Mobile Ads versione 10.10.0.
- SDK Maio versione 2.0.0.
Versione 1.6.3.1
- Ora è richiesta la versione 10.0.0 o successive dell'SDK Google Mobile Ads.
Creato 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
- L'adattatore è stato aggiornato in modo da utilizzare l'API
didRewardUser. - Ora è richiesta la versione 9.8.0 o successive dell'SDK Google Mobile Ads.
- Compatibilità verificata con la versione 1.6.3 dell'SDK maio e la versione 2.0.0-alpha dell'SDK maioOB.
Creato 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
- Compatibilità verificata con la versione 1.6.2 dell'SDK maio e la versione 2.0.0-alpha dell'SDK maioOB.
Creato 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
- Compatibilità verificata con la versione 1.6.1 dell'SDK maio e la versione 2.0.0-alpha dell'SDK maioOB.
Creato 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 la versione 9.0.0 dell'SDK Google Mobile Ads.
- Ora è richiesta la versione 9.0.0 o successive dell'SDK Google Mobile Ads.
Creato 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
- Compatibilità verificata con la versione 1.6.0 dell'SDK maio e la versione 2.0.0-alpha dell'SDK maioOB.
Creato e testato con:
- SDK Google Mobile Ads versione 8.13.0.
- Ora è richiesta la versione minima di iOS 10.0.
- SDK Maio versione 1.6.0.
- SDK MaioOB versione 2.0.0-alpha.
Versione 1.5.8.0
- È stata verificata la compatibilità con la versione 1.5.8 dell'SDK maio e con la versione 2.0.0-alpha dell'SDK maioOB.
- È stata aggiunta la funzionalità di offerta all'adattatore per i formati degli annunci interstitial e con premio.
- Dipendenza allentata all'SDK Google Mobile Ads versione 8.0.0 o successive.
Creato 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 codici e messaggi di errore standardizzati per gli adattatori.
- L'adattatore è stato aggiornato in modo da utilizzare il formato
.xcframework. - È stato risolto un bug per cui a volte gli eventi degli annunci con premio non venivano inoltrati.
- Ora è richiesta la versione 8.3.0 o successive dell'SDK Google Mobile Ads.
Creato 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 la versione 1.5.6 dell'SDK maio.
- Ora è richiesta la versione 7.68.0 o successive dell'SDK Google Mobile Ads.
Creato 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 la versione 1.5.5 dell'SDK maio.
- Ora è richiesta la versione 7.64.0 o successive dell'SDK Google Mobile Ads.
Creato 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 la versione 1.5.4 dell'SDK maio.
- Ora è richiesta la versione 7.60.0 o successive dell'SDK Google Mobile Ads.
Creato 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, le richieste di annunci ora non andranno a buon fine immediatamente se Maio non ha un annuncio pronto per la pubblicazione.
- È stato rimosso il supporto per l'architettura i386.
Creato 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 la versione 1.5.3 dell'SDK maio.
Creato e testato con:
- SDK Google Mobile Ads versione 7.55.1.
- SDK Maio versione 1.5.3.
Versione 1.5.2.1
- È stato risolto un problema per cui l'adattatore non invocava il callback
-rewardedAdDidPresent:.
Creato 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 la versione 1.5.2 dell'SDK maio.
Creato 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 la versione 1.5.1 dell'SDK maio.
Creato 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 la versione 1.5.0 dell'SDK maio.
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 la versione 1.4.8 dell'SDK maio.
Versione 1.4.6.0
- Compatibilità verificata con la versione 1.4.6 dell'SDK maio.
- L'adattatore è stato aggiornato per utilizzare la nuova API con premio.
- Ora è richiesta la versione 7.42.2 o successive dell'SDK Google Mobile Ads.
Versione 1.4.2.0
- Compatibilità verificata con la versione 1.4.2 dell'SDK maio.
Versione 1.4.1.0
- Compatibilità verificata con la versione 1.4.1 dell'SDK maio.
- Risolto un problema per cui l'adattatore maio potrebbe non riuscire se AdMob fornisce più MediaId.
Versione 1.4.0.0
- Compatibilità verificata con la versione 1.4.0 dell'SDK maio.
Versione 1.3.2.0
- Compatibilità verificata con la versione 1.3.2 dell'SDK maio.
Versione 1.3.1.1
- È stato aggiunto il callback
adapterDidCompletePlayingRewardBasedVideoAd:all'adattatore.
Versione 1.3.1.0
- Compatibilità verificata con la versione 1.3.1 dell'SDK maio.
Versione 1.3.0.0
- Compatibilità verificata con la versione 1.3.0 dell'SDK maio.
Versione 1.2.19.0
- Compatibilità verificata con la versione 1.2.19 dell'SDK maio.
Versione 1.2.18.0
- Prima release!
- È stato aggiunto il supporto per gli annunci interstitial e video con premio.