Integrazione delle reti di mediazione

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di rete utilizzando la mediazione, coprendo 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'appAndroid .

L'interfaccia della dashboard di Nend utilizza testo giapponese per etichette, pulsanti e descrizioni e gli screenshot visualizzati di seguito non sono stati tradotti. In questa guida, a etichette e pulsanti si fa riferimento ai rispettivi equivalenti in inglese. ad esempio, "URL ytcーム" è "Schema URL" e così via.

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

  • Livello API Android 19 o superiore

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

Registrati o accedi al tuo account di fatturazione.

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

crea un'applicazione

Inserisci il nome della tua app e scegli Android applicazione come tipo di applicazione. Inserisci l'URL e controlla se la tua app è presente Google Play (consulta le Domande frequenti sulle app non ancora rilasciate se la tua app non è ancora stata rilasciata). Seleziona una categoria per la tua app e, al termine, fai clic su Crea.

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

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 del posizionamento 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 dell'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 la Dimensione inventario che preferisci. 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 la Frequenza di visualizzazione degli annunci dall'elenco a discesa. Al termine, fai clic sul pulsante Crea per creare il posizionamento.

Per gli annunci video interstitial, scegli Video per 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 i Contenuti del premio desiderati 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 per il posizionamento, compila la sezione Introduzione all'inventario e seleziona la Selezione dell'immagine dell'annuncio che preferisci. 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 l'orientamento dell'annuncio video e il tipo di annuncio nativo che preferisci. Al termine, fai clic sul pulsante Crea per creare il posizionamento.

Per impostare l' AdMob unità pubblicitaria 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 anche della tua chiave API per l'API di reporting di nend, chiamata chiave API per lo scraping. Puoi trovarlo nella scheda Strumenti.

Passaggio 2: configura la domanda di rete nell' AdMob UI

Successivamente, devi aggiungere nend alla configurazione della mediazione per l'unità pubblicitaria. Innanzitutto, accedi all'account AdMob.

Vai alla scheda Mediazione. Se vuoi modificare un gruppo di mediazione esistente, fai clic sul nome del gruppo per modificarlo e vai alla sezione Aggiungere un annuncio 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. quindi fai clic su Aggiungi unità pubblicitarie.

Gruppo di mediazione 2

Associa questo gruppo di mediazione a una o più unità pubblicitarie AdMob esistenti. Dopodiché, fai clic su Fine.

Seleziona unità pubblicitaria

A questo punto, la scheda delle unità pubblicitarie dovrebbe essere completata con quelle selezionate, come mostrato di seguito:

Raggruppa unità pubblicitarie

Aggiungi nend come origine annuncio

Nella scheda Origini annuncio, seleziona Aggiungi rete pubblicitaria.

Seleziona nend e attiva l'opzione nend. Inserisci la chiave API per lo scraping ottenuta in precedenza come Chiave API di reporting per configurare l'ottimizzazione dell'origine annuncio per il server. Inserisci quindi un valore eCPM per l'opzione nend e fai clic su Continua.

Se hai già una mappatura per il dominio, puoi semplicemente selezionarla. In alternativa, fai clic su Aggiungi mappatura.

Quindi, inserisci l'ID spot e la chiave API ottenuta nella sezione precedente. Poi, fai clic su Fine.

Passaggio 3: importa l'SDK e l'adattatore di rete

Aggiungi i seguenti Repository Maven e le dipendenze di implementazione con la versione più recente dell'SDK e dell'adattatore Nend nel file build.gradle a livello di app:

repositories {
    google()
    mavenCentral()
    maven {
        url 'https://fan-adn.github.io/nendSDK-Android-lib/library'
    }
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:22.5.0'
    implementation 'com.google.ads.mediation:nend:10.0.0.0'
}
...

Integrazione manuale

  1. Scarica la versione più recente dell'SDK Android di nend e aggiungila al tuo progetto.

  2. Vai agli elementi di Nend dell'adattatore sul Repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore di rete e aggiungilo al progetto.

Passaggio 5: aggiungi il codice richiesto

Non è necessario alcun codice aggiuntivo per l'integrazione di Nend.

Passaggio 6: testa l'implementazione

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per AdMob. Per ottenere annunci di prova per banner, interstitial e annunci con premio, ti consigliamo di utilizzare le chiavi API e gli ID Spot forniti nella pagina di test di unità pubblicitarie . 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.

Passaggi facoltativi

Parametri specifici della rete

L'adattatore di rete supporta parametri di richiesta aggiuntivi, che possono essere trasmessi all'adattatore utilizzando la classe NendExtrasBundleBuilder. Questa classe include i seguenti metodi:

  • setInterstitialType(InterstitialType): Nend offre la possibilità di selezionare TYPE_NORMAL per gli annunci interstitial normali o TYPE_VIDEO per gli annunci video interstitial. Per impostazione predefinita, Nend utilizza TYPE_NORMAL come tipo di interstitial se questo parametro aggiuntivo non viene aggiunto.

  • setNativeAdsType(nativeAdsType): Nend offre la possibilità di selezionare TYPE_NORMAL per gli annunci nativi normali o TYPE_VIDEO per gli annunci video nativi. Per impostazione predefinita, Nend utilizza TYPE_NORMAL come tipo di annuncio nativo se non viene aggiunto questo parametro aggiuntivo.

Java 

Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
                        .setInterstitialType(InterstitialType.TYPE_NORMAL)
                        .setNativeAdsType(FormatType.TYPE_NORMAL)
                        .build();

AdRequest adRequest = new AdRequest.Builder().addNetworkExtrasBundle(
  NendAdapter.class, bundle).build();

adLoader.loadAd(adRequest);

Kotlin 

val bundle = NendAdapter.NendExtrasBundleBuilder()
                     .setInterstitialType(InterstitialType.TYPE_NORMAL)
                     .setNativeAdsType(FormatType.TYPE_NORMAL)
                     .build()

val adRequest = AdRequest.Builder().addNetworkExtrasBundle(
  NendAdapter.class, bundle).build()

adLoader.loadAd(adRequest)

Utilizzo degli annunci nativi

Rendering dell'annuncio

L'adattatore Nend restituisce gli annunci nativi come NativeAd oggetti. Compila le seguenti descrizioni dei campi degli annunci nativi per un NativeAd.

Campo Compilato dall'adattatore Nend
Titolo
Immagine 1
Body
Icona dell'app 2
Call to action
Nome inserzionista
Star rating
Archiviazione
Prezzo

1 Nend solo fornisce un asset immagine per posizionamenti nativi configurati con una selezione di immagini dell'annuncio impostata su immagine pubblicitaria grande orizzontale (5: 3).

2 Nend non fornisce un asset icona per i posizionamenti nativi configurati con Selezione dell'immagine dell'annuncio impostata su Nessuna immagine (solo testo).

Codici di errore

Se l'adattatore non riceve un annuncio da parte dei publisher, i publisher possono controllare l'errore sottostante nella risposta di annuncio utilizzando ResponseInfo.getAdapterResponse() nelle seguenti classi:

Formato Nome corso
Banner com.google.ads.mediation.nend.NendAdapter
Interstitial com.google.ads.mediation.nend.NendAdapter
Con premio com.google.ads.mediation.nend.NendRewardedAdapter
Nativo com.google.ads.mediation.nend.NendMediationAdapter

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

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 server configurati nell'UI AdMob non sono presenti o non sono validi.
103 com.google.ads.mediation.nend l'annuncio non è ancora pronto per essere pubblicato.
104 com.google.ads.mediation.nend Impossibile riprodurre l'annuncio durante l'operazione.
105 com.google.ads.mediation.nend Le dimensioni dell'annuncio richieste non corrispondono alle dimensioni dei banner supportate.
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 di nend ha restituito un errore di caricamento degli annunci interstitial. Consulta il codice per ulteriori dettagli.
300-399 net.nend.android L'SDK di nend ha restituito un errore di visualizzazione dell'annuncio interstitial. Consulta il codice per ulteriori dettagli.
400-499 net.nend.android L'SDK nend ha restituito un errore nell'annuncio. Consulta il codice per ulteriori dettagli.
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 errore del programma senza ulteriori informazioni sull'errore.
103 com.google.mediation.nend I parametri server configurati nell'UI AdMob non sono presenti 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 di ricerca a causa di un annuncio non pronto.
106 com.google.mediation.nend Le dimensioni dell'annuncio banner richieste non corrispondono alle dimensioni dei banner supportate.
200-699 Inviato da Nend SDK. L'SDK nend ha restituito un errore. Per ulteriori dettagli, vedi il documento di nend.

Vai al log delle modifiche dell'adattatore per la mediazione Android

Versione 10.0.0.0

  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.3.0.
  • Compatibilità verificata con Nend SDK 10.0.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 22.3.0.
  • Nend SDK versione 10.0.0.

Versione 9.0.1.0

  • Adattatore aggiornato per utilizzare la nuova classe VersionInfo.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.0.0.
  • Compatibilità verificata con Nend SDK 9.0.1.

Realizzato e testato con

  • SDK Google Mobile Ads versione 22.0.0.
  • Nend SDK versione 9.0.1.

Versione 9.0.0.0

  • Compatibilità verificata con Nend SDK 9.0.0.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.2.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 21.2.0.
  • Nend SDK versione 9.0.0.

Versione 8.2.0.0

  • Compatibilità verificata con Nend SDK 8.2.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 21.0.0.
  • Nend SDK versione 8.2.0.

Versione 8.1.0.1

  • Aggiornamento di compileSdkVersion e targetSdkVersion all'API 31.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.0.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 21.0.0.
  • Nend SDK versione 8.1.0.

Versione 8.1.0.0

  • Compatibilità verificata con Nend SDK 8.1.0.
  • Risolto l'arresto anomalo di NullPointerException quando nend restituisce l'URL di un'immagine o di un logo null.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.5.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 20.5.0.
  • Nend SDK versione 8.1.0.

Versione 8.0.1.0

  • Compatibilità verificata con Nend SDK 8.0.1.
  • Risolto un bug per cui alcuni AdError oggetti venivano restituiti utilizzando il dominio errato.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.4.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 20.4.0.
  • Nend SDK versione 8.0.1.

Versione 7.1.0.0

  • Compatibilità verificata con Nend SDK 7.1.0.
  • Sono stati aggiornati i codici di errore per acquisire l'errore di destinazione UNSUPPORTED_DEVICE.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.2.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 20.2.0.
  • Nend SDK versione 7.1.0.

Versione 7.0.3.0

  • Compatibilità verificata con Nend SDK 7.0.3.
  • Sono stati aggiunti codici di errore descrittivi e i motivi degli errori di caricamento/programma dell'adattatore.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 20.0.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 20.0.0.
  • Nend SDK versione 7.0.3.

Versione 7.0.0.0

  • Compatibilità verificata con Nend SDK 7.0.0.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.4.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 19.4.0.
  • Nend SDK versione 7.0.0.

Versione 6.0.1.0

  • Compatibilità verificata con Nend SDK 6.0.1.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.3.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 19.3.0.
  • Nend SDK versione 6.0.1.

Versione 6.0.0.0

  • Compatibilità verificata con Nend SDK 6.0.0.
  • Versione minima dell'SDK Android aggiornata all'API 19.

Realizzato e testato con

  • SDK Google Mobile Ads versione 19.2.0.
  • Nend SDK versione 6.0.0.

Versione 5.4.2.1

  • L'adattatore è stato aggiornato in modo da supportare le richieste di banner adattivi incorporati.
  • È stato risolto un raro arresto anomalo racecondition che si verificava quando gli annunci banner intelligenti vengono distrutti.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.2.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 19.2.0.
  • Nend SDK versione 5.4.2.

Versione 5.4.2.0

  • Aggiunto il supporto per gli annunci nativi.
  • Verifica della compatibilità con Nend SDK 5.4.2.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 19.0.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 19.0.0.
  • Nend SDK versione 5.4.2.

Versione 5.3.0.0

  • Compatibilità verificata con Nend SDK 5.3.0.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 18.2.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 18.2.0.
  • Nend SDK versione 5.3.0.

Versione 5.2.0.0

  • Compatibilità verificata con Nend SDK 5.2.0.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 18.1.1.

Versione 5.1.0.4

  • Risolto il problema per cui gli annunci banner e interstitial non inoltravano l'evento onAdClicked().
  • Risolto il problema per cui veniva generato un NullPointerException quando veniva eliminato un annuncio banner di vendita.
  • È stata eseguita la migrazione dell'adattatore ad AndroidX.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 18.0.0.

Versione 5.1.0.3

  • Aggiunta un'implementazione per visualizzare una parte del banner di rete in SmartBanner. Dimensioni appropriate per SmartBanner
    • Verticale e orizzontale
      • Telefoni: 320 × 50
      • Tablet: 728 × 90 o 320 × 50

Versione 5.1.0.2

  • Aggiunto il supporto per dimensioni flessibili degli annunci banner.

Versione 5.1.0.1

  • Adattatore aggiornato per supportare la nuova API con premio in versione beta aperta.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 17.2.0.

Versione 5.1.0.0

  • Compatibilità verificata con Nend SDK 5.1.0.

Versione 5.0.2.1

  • È stata rimossa la funzione che inoltra le funzionalità utente perché i seguenti metodi sono deprecati il giorno AdRequest.Builder.
    • setGender()
    • setBirthday()
    • setIsDesignedForFamiles()

Versione 5.0.2.0

  • Compatibilità verificata con Nend SDK 5.0.2.

Versione 5.0.1.0

  • Compatibilità verificata con Nend SDK 5.0.1.

Versione 5.0.0.0

  • Compatibilità verificata con Nend SDK 5.0.0.

Versione 4.0.5.0

  • Compatibilità verificata con Nend SDK 4.0.5.

Versione 4.0.4.1

  • Metodo onRewardVideoCompletato() di RewardedVideoAdListener supportato.

Versione 4.0.4.0

  • Compatibilità verificata con Nend SDK 4.0.4.

Versione 4.0.2.1

  • È stata aggiunta la possibilità di creare un Bundle di extra di mediazione utilizzando la classe NendExtrasBundleBuilder.

Versione 4.0.2.0

  • Prima release nel progetto open source di Mediazione Google Mobile Ads.
  • Aggiunto il supporto per annunci banner, interstitial e video con premio.