Integrazione delle conversioni con mediazione

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci da un server web utilizzando la mediazione, che copre le integrazioni con struttura a cascata. Descrive come aggiungere nend alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'adattatore e l'SDK nend in un'app Unity.

L'interfaccia della dashboard per nend utilizza testo in giapponese per etichette, pulsanti e descrizioni e gli screenshot visualizzati di seguito non sono stati tradotti. Nel testo di questa guida, tuttavia, le etichette e i pulsanti sono indicati con i relativi nomi in inglese. ad esempio, "URL ytcーム" è "Schema URL" e così via.

Integrazioni e formati degli annunci supportati

Integrazione
Offerte
Struttura a cascata
Formati
Banner
Interstitial
Con premio

Requisiti

  • Unity 4 o superiore
  • Versione più recente dell'SDK Google Mobile Ads
  • Per eseguire il deployment su Android
    • Livello API Android 19 o superiore
  • Per eseguire il deployment su iOS
    • Target di deployment per iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la guida introduttiva.
  • Completa la mediazione Guida introduttiva

Passaggio 1: imposta le configurazioni nell'interfaccia utente di destinazione

Registrati o accedi al tuo account.

Per aggiungere la tua applicazione alla dashboard di dispositivi, fai clic sulla scheda Gestione dei posizionamenti, quindi seleziona Sito/applicazione. Fai clic sul pulsante Aggiungi un'app per aggiungere l'app da aggiungere.

crea un'applicazione

Inserisci il nome dell'app e scegli la tua piattaforma come tipo di applicazione. Inserisci l'URL e controlla se la tua app è elencata nello store appropriato

Se la tua app non è ancora stata rilasciata, leggi le domande frequenti sulle app non ancora rilasciate. Seleziona una categoria per la tua app e, al termine, fai clic su Crea.

Android

iOS

L'applicazione verrà visualizzata nella dashboard una volta creata.

Android

iOS

Creare un posizionamento

Una volta registrata l'app, puoi passare alla creazione di un posizionamento. Per creare un posizionamento per gli annunci banner, vai alla scheda Gestione dei posizionamenti e fai clic su Posizionamento. Fai clic sul pulsante Crea un nuovo posizionamento.

Seleziona l'app nel menu a discesa. Poi, segui le istruzioni riportate di seguito corrispondenti al formato di annuncio che preferisci.

Scegli Immagine statica per Tipo di annuncio e Banner per Tipo di inventario. Al termine, inserisci un Nome posizionamento, compila la sezione Introduzione all'inventario, scegli un Formato inventario e infine scegli una Dimensione inventario. Al termine, fai clic sul pulsante Crea per creare il posizionamento.

Interstitial

Scegli Immagine statica per Tipo di annuncio e Interstitial per Tipo di inventario. Al termine, inserisci un Nome posizionamento, compila la sezione Introduzione all'inventario e seleziona una Frequenza di visualizzazione dell'annuncio dall'elenco a discesa. Al termine, fai clic sul pulsante Crea per creare il posizionamento.

Per gli annunci video interstitial, scegli Video come Tipo di annuncio e Interstitial per Tipo di inventario. Al termine, inserisci un Nome posizionamento, compila la sezione Introduzione all'inventario e scegli una Categoria appropriata dall'elenco a discesa. Al termine, fai clic sul pulsante Crea per creare il posizionamento.

Con premio

Scegli Video per Tipo di annuncio e Premio per Tipo di inventario. Al termine, inserisci un Nome posizionamento, compila la sezione Introduzione all'inventario e scegli una Categoria appropriata dall'elenco a discesa.

In Impostazioni premio, seleziona un Contenuto del premio utilizzando l'elenco a discesa e inserisci il nome della valuta virtuale che preferisci. Al termine, fai clic sul pulsante Crea per creare il posizionamento.

Nativo

Scegli Immagine statica per Tipo di annuncio e Nativo per Tipo di inventario. Al termine, inserisci un nome posizionamento, compila la sezione Introduzione all'inventario e seleziona una selezione dell'immagine dell'annuncio. Al termine, fai clic sul pulsante Crea per creare il posizionamento.

Per gli annunci video nativi, scegli Video come Tipo di annuncio e Nativo (personalizzato) per Tipo di inventario. Al termine, inserisci un Nome posizionamento, compila la sezione Introduzione all'inventario e scegli una Categoria appropriata dall'elenco a discesa.

In Impostazioni native, seleziona dall'elenco un Orientamento annuncio video e un Tipo di annuncio nativo. Al termine, fai clic sul pulsante Crea per creare il posizionamento.

Per impostare l'unità pubblicitaria AdMob nella sezione successiva, hai bisogno di apiKey e spotID per ogni posizionamento. Per individuarli, vai alla scheda Gestione dei posizionamenti e seleziona il pulsante SDK sotto il nome della tua app.

Prendi nota di apiKey e spotID.

Avrai bisogno della chiave API anche per l'API di reporting di nend, che chiama la chiave API per lo scraping. Puoi trovarlo nella scheda Strumenti.

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

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Android

Per le istruzioni, consulta il passaggio 2 della guida per Android.

iOS

Per le istruzioni, consulta il passaggio 2 nella guida per iOS.

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

Scarica la versione più recente del plug-in di mediazione Google Mobile Ads per l'accesso dal link di download nel log delle modifiche ed estrai il pacchetto GoogleMobileAdsNendMediation.unitypackage dal file zip.

Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto > Pacchetto personalizzato e individua il file GoogleMobileAdsNendMediation.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

Quindi, seleziona Asset > Play Services Resolver > Android Resolver > Forza risoluzione. La libreria di resolver Unity Play Services eseguirà la risoluzione delle dipendenze da zero e copierà le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

Passaggio 4: aggiungi il codice richiesto

Android

Non è necessario alcun codice aggiuntivo per l'integrazione nend.

iOS

Integrazione di SKAdNetwork

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

Passaggio 5: testa l'implementazione

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per AdMob Per ricevere annunci di prova per banner, interstitial e annunci con premio, ti consigliamo di utilizzare le chiavi API e gli ID Spot forniti nella in base alle unità pubblicitarie di test . Questi possono essere inseriti come chiavi API e ID Spot per le unità pubblicitarie AdMob durante il test e poi sostituiti con una chiave API e un ID Spot effettivi quando l'app è pronta per la produzione.

Verifica annunci di prova

Per verificare di ricevere annunci di prova danend, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le nend (Waterfall) origini annuncio.

Codici di errore

Se l'adattatore non riceve un annuncio da nend, i publisher possono controllare l'errore sottostante dalla risposta dell'annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter

iOS

GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore Nend quando non viene caricato un annuncio:

Android

Codice di errore Dominio Motivo
101 com.google.ads.mediation.nend nend richiede un contesto di attività per caricare e mostrare gli annunci.
102 com.google.ads.mediation.nend I parametri del server configurati nell' AdMob UI mancano o non sono validi.
103 com.google.ads.mediation.nend L'annuncio non è ancora pronto per essere pubblicato.
104 com.google.ads.mediation.nend Riproduzione dell'annuncio non riuscita.
105 com.google.ads.mediation.nend La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata.
106 com.google.ads.mediation.nend Il riferimento all'oggetto di contesto è null e/o è stato rilasciato di recente dalla memoria.
200-299 net.nend.android L'SDK nend ha restituito un errore di caricamento dell'annuncio interstitial. Consulta il codice per maggiori dettagli.
300-399 net.nend.android L'SDK nend ha restituito un errore di visualizzazione dell'annuncio interstitial. Consulta il codice per maggiori dettagli.
400-499 net.nend.android L'SDK nend ha restituito un errore dell'annuncio. Consulta il codice per maggiori dettagli.

iOS

Codice di errore Dominio Motivo
101 com.google.mediation.nend L'SDK nend ha restituito un callback di errore di caricamento senza ulteriori informazioni sull'errore.
102 com.google.mediation.nend L'SDK nend ha restituito un callback di visualizzazione non riuscito senza ulteriori informazioni sull'errore.
103 com.google.mediation.nend I parametri del server configurati nell' AdMob UI mancano o non sono validi.
104 com.google.mediation.nend Impossibile caricare gli asset immagine degli annunci nativi.
105 com.google.mediation.nend Impossibile mostrare gli annunci aggiunti perché l'annuncio non è pronto.
106 com.google.mediation.nend Le dimensioni richieste per l'annuncio banner non corrispondono a quelle del banner supportato.
200-699 Inviato dall'SDK Nend. L'SDK nend ha restituito un errore. Per ulteriori dettagli, vedi il documento di nend.

Modifica il log delle modifiche del plug-in di mediazione Unity

Versione 8.0.0

Versione 7.0.0

  • Contenuti dell'adattatore spostati in GoogleMobileAds/Mediation/Nend/.
  • È stato eseguito il refactoring dello spazio dei nomi dell'adattatore per utilizzare GoogleMobileAds.Mediation.Nend.
  • Supporta l'adattatore Android versione 9.0.1.0.
  • Supporta l'adattatore iOS versione 8.0.1.0.
  • Costruito e testato con il plug-in Unity di Google Mobile Ads versione 8.1.0.

Versione 6.0.1

Versione 6.0.0

Versione 5.2.0

Versione 5.1.0

Versione 5.0.0

Versione 4.0.1

Versione 4.0.0

Versione 3.0.0

Versione 2.3.0

Versione 2.2.0

Versione 2.1.0

  • Aggiornato il plug-in in modo che supporti la nuova API Reward.
  • Supporta l'adattatore Android versione 5.1.0.2.
  • Supporta l'adattatore iOS versione 5.1.1.0.

Versione 2.0.3

  • Supporta l'adattatore Android versione 5.0.2.1.
  • Supporta l'adattatore iOS versione 5.0.2.0.

Versione 2.0.2

  • Supporta l'adattatore Android versione 5.0.2.0.
  • Supporta l'adattatore iOS versione 5.0.2.0.

Versione 2.0.1

  • Supporta l'adattatore Android versione 5.0.2.0.
  • Supporta l'adattatore iOS versione 5.0.1.0.

Versione 2.0.0

  • Supporta l'adattatore Android versione 5.0.0.0.
  • Supporta l'adattatore iOS versione 5.0.0.0.

Versione 1.0.2

  • Supporta l'adattatore Android versione 4.0.5.0.
  • Supporta la versione dell'adattatore iOS 4.0.6.0.

Versione 1.0.1

  • Supporta l'SDK Android versione 4.0.4.
  • Supporta l'SDK iOS versione 4.0.4.

Versione 1.0.0

  • Prima uscita.
  • Supporta l'SDK Android versione 4.0.2.
  • Supporta l'SDK iOS versione 4.0.2.