Integra maio con la mediazione

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci da maio utilizzando mediazione, che copre le integrazioni 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'iOS app.

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

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

(Solo struttura a cascata) Oltre all'ID multimediale e all'ID zona, ti serviranno ID API e CHIAVE API per impostare l'ID unità pubblicitaria per la mediazione. Nella pagina dell'API di reporting, prendi nota di ID API e Chiave API.

Passaggio 2: configura la domanda di Maio nell' Ad Manager interfaccia utente

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 la versione più recente dell'SDK maio.
  • Scarica la versione più recente 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 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 riceve un annuncio da maio, i publisher possono verificare l'errore sottostante della risposta dell'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. Vedi il 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 Per questa configurazione della rete è già stato caricato un annuncio.

Log delle modifiche dell'adattatore di mediazione iOS maio

Versione 2.1.5.1

  • È stato aggiornato CFBundleShortVersionString per avere tre componenti anziché quattro.

Sviluppata e testata 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.

Sviluppata e testata 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.

Sviluppata e testata 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.

Sviluppata e testata 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 di MaioAdapter.xcframework.

Sviluppata e testata con:

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

Versione 2.1.2.0

  • È stata verificata la compatibilità con la versione 2.1.2 dell'SDK maio.

Sviluppata e testata con:

  • SDK Google Mobile Ads versione 10.14.0.
  • SDK Maio 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.
  • È stato 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.

Sviluppata e testata 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.

Sviluppata e testata 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 è 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.

Sviluppata e testata 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.

Sviluppata e testata 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.

Sviluppata e testata 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

  • Compatibilità verificata con la versione 9.0.0 dell'SDK Google Mobile Ads.
  • 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.
  • 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.

Sviluppata e testata con:

  • SDK Google Mobile Ads versione 8.13.0.
  • Ora è richiesta 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

  • È 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 di annunci interstitial e con premio.
  • Dipendenza allentata all'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.
  • L'adattatore è stato aggiornato per utilizzare il formato .xcframework.
  • È stato corretto 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.

Sviluppata e testata 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 è necessaria la versione 7.68.0 o versioni successive dell'SDK Google Mobile Ads.

Sviluppata e testata 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 è richiesta la versione 7.64.0 o successive dell'SDK Google Mobile Ads.

Sviluppata e testata 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.

Sviluppata e testata 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.
  • Rimosso il supporto per l'architettura i386.

Sviluppata e testata 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 invocava il callback -rewardedAdDidPresent:.

Sviluppata e testata 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.

Sviluppata e testata 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.

Sviluppata e testata 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.

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 la versione 1.4.8 dell'SDK maio.

Versione 1.4.6.0

  • È stata verificata la compatibilità con l'SDK maio versione 1.4.6.
  • 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 maio SDK versione 1.4.2.

Versione 1.4.1.0

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

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

  • È stata verificata la compatibilità con la versione 1.2.19 dell'SDK maio.

Versione 1.2.18.0

  • Prima uscita.
  • È stato aggiunto il supporto per gli annunci interstitial e video con premio.