Integra maio con la mediazione

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci di maio utilizzando Mediazione AdMob che copre le integrazioni a cascata. Illustra come aggiungere maio al configurazione della mediazione e come integrare l'SDK e l'adattatore maio in un iOS

L'interfaccia della dashboard di maio utilizza testo giapponese per etichette, pulsanti, e descrizioni. Inoltre, gli screenshot in questa guida non sono stati tradotti. Nelle descrizioni e nelle istruzioni di questa guida, tuttavia, etichette e pulsanti sono a cui si fa riferimento con gli equivalenti in lingua inglese. "URL エーム", ad esempio è "Schema URL".

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per maio ha le seguenti funzionalità:

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

  • Target del deployment di iOS 12.0 o versioni successive

  • Versione più recente dell'SDK Google Mobile Ads

  • Completare 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 nell' 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

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

  • Aggiungi la seguente riga al podfile del progetto:

    pod 'GoogleMobileAdsMediationMaio'

  • Dalla riga di comando, esegui:

    pod install --repo-update

Integrazione manuale

  • Scarica l'ultima versione di maio.
  • Scarica la versione più recente dell'adattatore maio dal link di download nella Log delle modifiche, e collega 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 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 (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 nelle seguenti classi:

Formato Nome corso
Interstitial GADMMaioInterstitialAdapter
Con premio GADMMaioRewardedAdapter

Di seguito sono riportati i codici e i relativi messaggi 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. Vedi il codice e la documentazione di maio per ulteriori dettagli.
101 Maio non ha annunci disponibili.
102 Parametri del server non validi (ad es. ID posizionamento mancante).
103 Il contesto utilizzato per caricare un annuncio non era un'istanza "Attività".
0-10 maio ha restituito un errore specifico dell'SDK. Consulta codice di maio per ulteriori dettagli.
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 È già stato caricato un annuncio per questa configurazione di rete.

Log delle modifiche dell'adattatore di mediazione iOS maio

Versione 2.1.5.0

  • È stata verificata la compatibilità con l'SDK maio versione 2.1.5.

Sviluppato 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 maio SDK versione 2.1.4.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 11.2.0.
  • Maio SDK versione 2.1.4.

Versione 2.1.3.0

  • È stata verificata la compatibilità con l'SDK maio versione 2.1.3.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 11.1.0.
  • Maio SDK versione 2.1.3.

Versione 2.1.2.1

  • Ora è necessaria la versione 11.0 o versioni successive dell'SDK Google Mobile Ads.
  • Info.plist incluso nei framework all'interno di MaioAdapter.xcframework.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 11.0.1.
  • Maio SDK versione 2.1.2.

Versione 2.1.2.0

  • Compatibilità verificata con maio SDK versione 2.1.2.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 10.14.0.
  • Maio SDK versione 2.1.2.

Versione 2.1.1.0

  • Compatibilità verificata con maio SDK versione 2.1.1.

Sviluppato 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 l'SDK maio versione 2.0.0.
  • È stata rimossa la dipendenza da MaioOB SDK.
  • Rimosso il supporto dell'architettura armv7.
  • Ora è necessaria la versione minima di iOS 12.0.
  • Ora è necessaria la versione 10.4.0 o versioni successive dell'SDK Google Mobile Ads.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 10.10.0.
  • SDK Maio versione 2.0.0.

Versione 1.6.3.1

  • Ora è necessaria la versione 10.0.0 o versioni successive dell'SDK Google Mobile Ads.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 10.0.0.
  • SDK Maio versione 1.6.3.
  • MaioOB SDK versione 2.0.0-alpha.

Versione 1.6.3.0

  • È stato aggiornato l'adattatore in modo che utilizzi l'API didRewardUser.
  • Ora è necessaria la versione 9.8.0 o versioni successive dell'SDK Google Mobile Ads.
  • Verificata compatibilità con maio SDK versione 1.6.3 e maioOB SDK versione 2.0.0-alpha.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 9.12.0.
  • SDK Maio versione 1.6.3.
  • MaioOB SDK versione 2.0.0-alpha.

Versione 1.6.2.0

  • Verificata compatibilità con maio SDK versione 1.6.2 e maioOB SDK versione 2.0.0-alpha.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 9.5.0.
  • SDK Maio versione 1.6.2.
  • MaioOB SDK versione 2.0.0-alpha.

Versione 1.6.1.0

  • Verificata compatibilità con maio SDK versione 1.6.1 e maioOB SDK versione 2.0.0-alpha.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 9.2.0.
  • SDK Maio versione 1.6.1.
  • MaioOB SDK versione 2.0.0-alpha.

Versione 1.6.0.1

  • È stata verificata la compatibilità con l'SDK Google Mobile Ads versione 9.0.0.
  • Ora è necessaria la versione 9.0.0 o versioni successive dell'SDK Google Mobile Ads.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 9.0.0.
  • SDK Maio versione 1.6.0.
  • MaioOB SDK versione 2.0.0-alpha.

Versione 1.6.0.0

  • Verificata compatibilità con maio SDK versione 1.6.0 e maioOB SDK versione 2.0.0-alpha.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 8.13.0.
  • Ora richiede la versione minima di iOS 10.0.
  • SDK Maio versione 1.6.0.
  • MaioOB SDK versione 2.0.0-alpha.

Versione 1.5.8.0

  • Verificata compatibilità con maio SDK versione 1.5.8 e maioOB SDK versione 2.0.0-alpha.
  • Aggiunta della funzionalità di offerta all'adattatore per i formati di annunci interstitial e con premio.
  • Dipendenza informale dall'SDK Google Mobile Ads versione 8.0.0 o successive.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 8.7.0.
  • SDK Maio versione 1.5.8.
  • MaioOB SDK versione 2.0.0-alpha.

Versione 1.5.6.1

  • Sono stati aggiunti messaggi e codici di errore dell'adattatore standardizzato.
  • È stato aggiornato l'adattatore per usare il formato .xcframework.
  • È stato corretto un bug per cui a volte gli eventi degli annunci con premio non venivano inoltrati.
  • Ora è necessaria la versione 8.3.0 o versioni successive dell'SDK Google Mobile Ads.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 8.3.0.
  • SDK Maio versione 1.5.6.

Versione 1.5.6.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.5.6.
  • Ora è necessaria la versione 7.68.0 o versioni successive dell'SDK Google Mobile Ads.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 7.68.0.
  • SDK Maio versione 1.5.6.

Versione 1.5.5.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.5.5.
  • Ora è necessaria la versione 7.64.0 o versioni successive dell'SDK Google Mobile Ads.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 7.64.0.
  • SDK Maio versione 1.5.5.

Versione 1.5.4.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.5.4.
  • Ora è necessaria la versione 7.60.0 o versioni successive dell'SDK Google Mobile Ads.

Sviluppato 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 vanno a buon fine se maio non ha un annuncio pronto per essere mostrato.
  • Rimosso il supporto per l'architettura i386.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 7.58.0.
  • SDK Maio versione 1.5.3.

Versione 1.5.3.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.5.3.

Sviluppato 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 richiamava il callback -rewardedAdDidPresent:.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 7.53.1.
  • SDK Maio versione 1.5.2.

Versione 1.5.2.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.5.2.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 7.53.1.
  • SDK Maio versione 1.5.2.

Versione 1.5.1.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.5.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 7.52.0.
  • SDK Maio versione 1.5.1.

Versione 1.5.0.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.5.0.

Sviluppato e testato con

  • SDK Google Mobile Ads versione 7.51.0.
  • SDK Maio Ads versione 1.5.0.

Versione 1.4.8.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.4.8.

Versione 1.4.6.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.4.6.
  • È stato aggiornato l'adattatore in modo che utilizzi la nuova API con premio.
  • Ora è necessaria la versione 7.42.2 o versioni successive dell'SDK Google Mobile Ads.

Versione 1.4.2.0

  • Compatibilità verificata con maio SDK versione 1.4.2.

Versione 1.4.1.0

  • Compatibilità verificata con maio SDK versione 1.4.1.
  • È stato risolto un problema per cui l'adattatore maio poteva non funzionare se vengono forniti più MediaId da AdMob.

Versione 1.4.0.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.4.0.

Versione 1.3.2.0

  • Compatibilità verificata con maio SDK versione 1.3.2.

Versione 1.3.1.1

  • È stato aggiunto il callback adapterDidCompletePlayingRewardBasedVideoAd: all'adattatore.

Versione 1.3.1.0

  • Compatibilità verificata con maio SDK versione 1.3.1.

Versione 1.3.0.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.3.0.

Versione 1.2.19.0

  • Compatibilità verificata con maio SDK versione 1.2.19.

Versione 1.2.18.0

  • Prima uscita
  • Aggiunta del supporto per annunci interstitial e video con premio.