Integra maio con la mediazione

Questa guida mostra come utilizzare Google Mobile Ads SDK per caricare e visualizzare gli annunci di maio utilizzando la Mediazione AdMob, che copre le integrazioni con la struttura a cascata. Viene spiegato 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 loro 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

Prerequisiti

Prima di continuare, verifica quanto segue:

  • Target di deployment iOS 15.0 o versioni successive.

Passaggio 1: configura le impostazioni nell'interfaccia utente 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 dell'app, seleziona la piattaforma e fornisci l'URL dell'app. Seleziona Interstitial video come Tipo di annuncio, poi fai clic su Aggiorna.

Con premio

Inserisci il nome dell'app, seleziona la piattaforma e fornisci l'URL dell'app. Seleziona Video con premio come Tipo di annuncio e poi fai clic su Aggiorna.

Nella pagina Gestione applicazioni, prendi nota dell'ID elemento multimediale. È necessario per configurare l'unità pubblicitaria AdMob nella sezione successiva.

Nella pagina Gestione zone, prendi nota dell'ID zona. Sarà necessario anche per configurare l'unità pubblicitaria AdMob nella sezione successiva.

(Solo con struttura a cascata) Oltre all'ID elemento multimediale 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 Reporting, prendi nota dell'ID API e della CHIAVE API.

Passaggio 2: configura la domanda di maio nell'interfaccia utente di AdMob

Configura le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere maio alla configurazione della mediazione per l'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 direttamente ad 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. Successivamente, imposta lo stato del gruppo di mediazione su Attivato e poi 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:

Aggiungi maio come origine annuncio


Nella scheda A cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio.

Seleziona maio e attiva l'opzione Ottimizza. Inserisci l'ID API e la CHIAVE API ottenuti nella sezione precedente per configurare l'ottimizzazione dell'origine 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.



Poi, inserisci ID elemento multimediale e ID zona ottenuti nella sezione precedente. Dopodiché, fai clic su Fine.


Passaggio 3: importa l'SDK e l'adattatore maio

Utilizza Swift Package Manager

Prima di continuare, devi disporre della versione minima supportata dell'adattatore, ovvero 2.2.0.0.

Per aggiungere una dipendenza del pacchetto al tuo progetto, segui questi passaggi:

  1. In Xcode, vai a File > Add Package Dependencies… (File > Aggiungi dipendenze pacchetto…).

  2. Nel prompt visualizzato, cerca il seguente URL del pacchetto:

    https://github.com/googleads/googleads-mobile-ios-mediation-maio.git

  3. In Regola di dipendenza, seleziona Branch.

  4. Nel campo di testo, inserisci main.

Utilizza CocoaPods

  • 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 dell'SDK maio.
  • Scarica l'ultima versione dell'adattatore maio dal link di download nel changelog e collega maioAdapter.framework nel tuo progetto.

Passaggio 4: aggiungi il codice richiesto

Implementa SKAdNetwork

Segui la documentazione di maio per aggiungere gli identificatori SKAdNetwork al file Info.plist del progetto.

Passaggio 5: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il tuo dispositivo di test per AdMob.

I publisher che utilizzano la versione 7.26.0 o successive di Google Mobile Ads SDK riceveranno automaticamente annunci di prova da maio su smartphone e tablet registrati come dispositivi di prova quando effettuano richieste.

Verifica gli annunci di prova

Per verificare di ricevere annunci di prova da maio, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio maio (con struttura 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 classe
Interstitial GADMMaioInterstitialAdapter
Con premio GADMMaioRewardedAdapter

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore maio quando non è possibile 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 luogo mancante).
103 L'adattatore maio non supporta il formato dell'annuncio richiesto.
104 Un annuncio è già caricato per questa configurazione di rete.
105 Filtra le richieste con limiti di età per l'SDK maio perché non può ricevere indicatori con limiti di età.

Log delle modifiche dell'adattatore di mediazione maio per iOS

Versione 2.2.3.0

  • Compatibilità verificata con l'SDK maio versione 2.2.3.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.9.0.
  • SDK Maio versione 2.2.3.

Versione 2.2.2.0

  • Compatibilità verificata con l'SDK maio versione 2.2.2.
  • Ora è richiesta la versione minima di iOS 15.0.
  • Aggiornata la versione minima di iOS per allentare la dipendenza dall'SDK Google Mobile Ads e consentire le versioni secondarie.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.7.0.
  • SDK Maio versione 2.2.2.

Versione 2.2.1.2

  • Filtra le richieste con limiti di età per l'SDK maio quando il nuovo ageRestrictedTreatment è impostato su GADAgeRestrictedTreatmentChild.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.3.0.
  • SDK Maio versione 2.2.1.

Versione 2.2.1.1

  • Filtra le richieste con limiti di età per l'SDK maio perché non può ricevere indicatori con limiti di età.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.2.0.
  • SDK Maio versione 2.2.1.

Versione 2.2.1.0

  • Compatibilità verificata con l'SDK maio versione 2.2.1.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.1.0.
  • SDK Maio versione 2.2.1.

Versione 2.2.0.3

  • È stato aggiunto il supporto per gli annunci banner con struttura a cascata.
  • Aggiornamento della dipendenza dell'SDK Google Mobile Ads alla versione 13.0.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.0.0.
  • Versione SDK Maio 2.2.0.

Versione 2.2.0.2

  • Aggiornata la versione minima di iOS per CocoaPods a 13.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 13.0.0.
  • Versione SDK Maio 2.2.0.

Versione 2.2.0.1

  • È stata rimossa l'implementazione dell'asta, poiché Maio non supporta più l'asta.
  • Aggiorna l'adattatore per utilizzare il protocollo GADMediationAdapter.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 12.11.0.
  • Versione SDK Maio 2.2.0.

Versione 2.2.0.0

  • Compatibilità verificata con l'SDK maio versione 2.2.0.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 12.11.0.
  • Versione SDK Maio 2.2.0.

Versione 2.1.6.1

  • Ora richiede l'SDK Google Mobile Ads versione 12.0.0 o successive.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 12.0.0.
  • SDK Maio versione 2.1.6.

Versione 2.1.6.0

  • Compatibilità verificata con l'SDK maio versione 2.1.6.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 11.13.0.
  • SDK Maio versione 2.1.6.

Versione 2.1.5.1

  • CFBundleShortVersionString è stato aggiornato in modo da avere tre componenti anziché quattro.

Sviluppato 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 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

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

Sviluppato e testato con:

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

Versione 2.1.3.0

  • Compatibilità verificata con l'SDK maio versione 2.1.3.

Sviluppato e testato con:

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

Versione 2.1.2.1

  • Ora richiede l'SDK Google Mobile Ads versione 11.0 o successive.
  • Info.plist è stato incluso nei framework all'interno di MaioAdapter.xcframework.

Sviluppato 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.

Sviluppato 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.

Sviluppato 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 è richiesta la versione minima di iOS 12.0.
  • Ora richiede l'SDK Google Mobile Ads versione 10.4.0 o successive.

Sviluppato e testato con:

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

Versione 1.6.3.1

  • Ora richiede l'SDK Google Mobile Ads versione 10.0.0 o successive.

Sviluppato 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

  • Aggiornato l'adattatore per utilizzare l'API didRewardUser.
  • Ora richiede l'SDK Google Mobile Ads versione 9.8.0 o successive.
  • È stata verificata la compatibilità con l'SDK maio versione 1.6.3 e l'SDK maioOB versione 2.0.0-alpha.

Sviluppato 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 l'SDK maio versione 1.6.2 e l'SDK maioOB versione 2.0.0-alpha.

Sviluppato 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

  • È stata verificata la compatibilità con l'SDK maio versione 1.6.1 e l'SDK maioOB versione 2.0.0-alpha.

Sviluppato 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.

Sviluppato 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

  • È stata verificata la compatibilità con l'SDK maio versione 1.6.0 e l'SDK maioOB versione 2.0.0-alpha.

Sviluppato 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

  • Compatibilità verificata con l'SDK maio versione 1.5.8 e l'SDK maioOB versione 2.0.0-alpha.
  • È stata aggiunta la funzionalità di asta all'adattatore per i formati degli annunci interstitial e con premio.
  • Dipendenza meno rigida 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.
  • SDK MaioOB versione 2.0.0-alpha.

Versione 1.5.6.1

  • Sono stati aggiunti codici e messaggi di errore standardizzati per gli adattatori.
  • Aggiornato l'adattatore per utilizzare il formato .xcframework.
  • Risolto un bug per cui a volte gli eventi degli annunci con premio non venivano inoltrati.
  • Ora richiede l'SDK Google Mobile Ads versione 8.3.0 o successive.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 8.3.0.
  • Versione SDK Maio 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 versione 7.68.0 o successive.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 7.68.0.
  • Versione SDK Maio 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.

Sviluppato e testato con:

  • SDK Google Mobile Ads versione 7.64.0.
  • Versione SDK Maio 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.

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, le richieste di annunci ora non andranno a buon fine immediatamente 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

  • Compatibilità verificata 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

  • 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

  • Compatibilità verificata con la versione 1.5.2 dell'SDK maio.

Sviluppato 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.

Sviluppato 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.

Sviluppato 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.
  • L'adattatore è stato aggiornato per utilizzare la nuova API per gli annunci 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

  • È stata verificata la compatibilità con l'SDK maio versione 1.4.1.
  • Risolto un problema per cui l'adattatore maio poteva non funzionare se AdMob forniva più MediaId.

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

  • È stato aggiunto il callback adapterDidCompletePlayingRewardBasedVideoAd: 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 release.
  • Aggiunto il supporto per gli annunci interstitial e video con premio.