Integra maio con la mediazione

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di maio utilizzando la mediazione AdMob, che copre le integrazioni a cascata. Spiega come aggiungere maio alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore maio in un'app per iOS.

L'interfaccia della dashboard per maio utilizza il testo giapponese per etichette, pulsanti e descrizioni e gli screenshot in questa guida non sono stati tradotti. Nelle descrizioni e nelle istruzioni di questa guida, tuttavia, i riferimenti a etichette e pulsanti sono in lingua inglese. "URL スキーム", ad esempio, è "URL Scheme".

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 di distribuzione iOS 12.0 o versioni successive

  • L'ultima versione dell'SDK Google Mobile Ads.

  • Completa la Guida introduttiva alla mediazione.

Passaggio 1: configura le configurazioni nell'interfaccia utente di maio

Innanzitutto, registrati o accedi al tuo account maio. Fai clic sul pulsante Gestione applicazioni 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 l'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 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 media. È necessario per configurare l'unità pubblicitaria AdMob nella sezione successiva.

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

(Solo 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 dell'API di reporting, prendi nota dell'ID API e della CHIAVE API.

Passaggio 2: configura la domanda di maio nella UI di AdMob

Configurare 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 un gruppo di mediazione esistente che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai direttamente 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à 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ù delle tue unità pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie che hai selezionato:

Aggiungere maio come origine annuncio


Nella scheda 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 l'ID media e l'ID zona ottenuti nella sezione precedente. Poi fai clic su Fine.


Passaggio 3: importa l'SDK e l'adattatore di 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 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

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

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 test da maio su smartphone e tablet registrati come dispositivi di test quando effettuano richieste.

Verificare gli annunci di prova

Per verificare di ricevere annunci di test da maio, attiva il test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio maio (cascata).

Codici di errore

Se l'adattatore non riceve un annuncio da maio, gli editori possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando GADResponseInfo.adNetworkInfoArray nelle seguenti classi:

Formato Nome del corso
Interstitial GADMMaioInterstitialAdapter
Con premio GADMMaioRewardedAdapter

Ecco i codici e i messaggi associati restituiti dall'adattatore maio quando un annuncio non viene caricato:

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 È già stato caricato un annuncio per questa configurazione di rete.

Log delle modifiche dell'adattatore di mediazione iOS di maio

Versione successiva

  • Attiva -fobjc-arc e -fstack-protector-all.

Versione 2.1.6.1

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

Creata e testata con:

  • SDK Google Mobile Ads versione 12.0.0.
  • Versione 2.1.6 dell'SDK Maio.

Versione 2.1.6.0

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

Creata e testata con:

  • SDK Google Mobile Ads versione 11.13.0.
  • Versione 2.1.6 dell'SDK Maio.

Versione 2.1.5.1

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

Creata e testata con:

  • SDK Google Mobile Ads versione 11.10.0.
  • Versione 2.1.5 dell'SDK Maio.

Versione 2.1.5.0

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

Creata e testata con:

  • SDK Google Mobile Ads versione 11.6.0.
  • Versione 2.1.5 dell'SDK Maio.

Versione 2.1.4.0

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

Creata e testata con:

  • SDK Google Mobile Ads versione 11.2.0.
  • Versione 2.1.4 dell'SDK Maio.

Versione 2.1.3.0

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

Creata e testata con:

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

Versione 2.1.2.1

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

Creata e testata con:

  • SDK Google Mobile Ads versione 11.0.1.
  • Versione 2.1.2 dell'SDK Maio.

Versione 2.1.2.0

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

Creata e testata con:

  • SDK Google Mobile Ads versione 10.14.0.
  • Versione 2.1.2 dell'SDK Maio.

Versione 2.1.1.0

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

Creata e testata con:

  • SDK Google Mobile Ads versione 10.12.0.
  • Versione 2.1.1 dell'SDK Maio.

Versione 2.0.0.0

  • Compatibilità verificata con la versione 2.0.0 dell'SDK maio.
  • È stata rimossa la dipendenza da MaioOB SDK.
  • È stato rimosso il supporto dell'architettura armv7.
  • Ora richiede la versione minima di iOS 12.0.
  • Ora richiede l'SDK Google Mobile Ads versione 10.4.0 o successive.

Creata e testata con:

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

Versione 1.6.3.1

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

Creata e testata con:

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

Versione 1.6.3.0

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

Creata e testata con:

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

Versione 1.6.2.0

  • Compatibilità verificata con l'SDK maio versione 1.6.2 e l'SDK maioOB versione 2.0.0-alpha.

Creata e testata con:

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

Versione 1.6.1.0

  • Compatibilità verificata con l'SDK maio versione 1.6.1 e l'SDK maioOB versione 2.0.0-alpha.

Creata e testata con:

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

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.

Creata e testata con:

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

Versione 1.6.0.0

  • Compatibilità verificata con l'SDK maio versione 1.6.0 e l'SDK maioOB versione 2.0.0-alpha.

Creata e testata con:

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

Versione 1.5.8.0

  • Compatibilità verificata con la versione 1.5.8 dell'SDK maio e 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 meno rigida dalla versione 8.0.0 o successive dell'SDK Google Mobile Ads.

Creata e testata con:

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

Versione 1.5.6.1

  • Sono stati aggiunti codici e messaggi di errore dell'adattatore standardizzati.
  • È stato aggiornato l'adattatore per utilizzare il formato .xcframework.
  • È stato corretto 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.

Creata e testata con:

  • SDK Google Mobile Ads versione 8.3.0.
  • Versione 1.5.6 dell'SDK Maio.

Versione 1.5.6.0

  • Compatibilità verificata con la versione 1.5.6 dell'SDK maio.
  • Ora richiede l'SDK Google Mobile Ads versione 7.68.0 o successive.

Creata e testata con:

  • SDK Google Mobile Ads versione 7.68.0.
  • Versione 1.5.6 dell'SDK Maio.

Versione 1.5.5.0

  • Compatibilità verificata con la versione 1.5.5 dell'SDK maio.
  • Ora richiede l'SDK Google Mobile Ads versione 7.64.0 o successive.

Creata e testata con:

  • SDK Google Mobile Ads versione 7.64.0.
  • Versione 1.5.5 dell'SDK Maio.

Versione 1.5.4.0

  • Compatibilità verificata con la versione 1.5.4 dell'SDK maio.
  • Ora richiede l'SDK Google Mobile Ads versione 7.60.0 o successive.

Creata e testata con:

  • SDK Google Mobile Ads versione 7.60.0.
  • Versione 1.5.4 dell'SDK Maio.

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.
  • È stato rimosso il supporto per l'architettura i386.

Creata e testata con:

  • SDK Google Mobile Ads versione 7.58.0.
  • Versione 1.5.3 dell'SDK Maio.

Versione 1.5.3.0

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

Creata e testata con:

  • SDK Google Mobile Ads versione 7.55.1.
  • Versione 1.5.3 dell'SDK Maio.

Versione 1.5.2.1

  • Risolto un problema per cui l'adattatore non richiamava il callback -rewardedAdDidPresent:.

Creata e testata con:

  • SDK Google Mobile Ads versione 7.53.1.
  • Versione 1.5.2 dell'SDK Maio.

Versione 1.5.2.0

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

Creata e testata con:

  • SDK Google Mobile Ads versione 7.53.1.
  • Versione 1.5.2 dell'SDK Maio.

Versione 1.5.1.0

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

Creata e testata con:

  • SDK Google Mobile Ads versione 7.52.0.
  • Versione 1.5.1 dell'SDK Maio.

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.
  • Versione 1.5.0 dell'SDK Maio Ads.

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 premi.
  • Ora richiede l'SDK Google Mobile Ads versione 7.42.2 o successive.

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 vengono forniti più ID media da AdMob.

Versione 1.4.0.0

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

Versione 1.3.2.0

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

Versione 1.3.1.1

  • Aggiunta del 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.