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

L'interfaccia della dashboard di nend utilizza testo in giapponese per etichette, pulsanti e descrizioni e gli screenshot visualizzati di seguito non sono stati tradotti. In questa guida, le etichette e i pulsanti vengono indicati con i 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
Struttura a cascata
Formati
Banner
Interstitial
Con premio
Nativo

Requisiti

• Livello API Android 19 o superiore

• Versione più recente dell'SDK Google Mobile Ads

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

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

Banner

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.

Nota: le dimensioni del banner scelte qui devono corrispondere a quelle richieste dalla tua app.

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.

Nota: consigliamo di utilizzare l'immagine pubblicitaria di grandi dimensioni orizzontale (5: 3) come selezione dell'immagine dell'annuncio, poiché include gli asset degli annunci nativi consigliati per il rendering.

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

Devi aggiungere nend alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi all'account AdMob. Quindi, vai alla scheda Mediazione. Se vuoi modificare un gruppo di mediazione esistente, fai clic sul nome del gruppo per modificarlo e vai alla sezione Aggiungi nend 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. Imposta lo stato del gruppo di mediazione su Attivato e fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione a una o più unità pubblicitarieAdMob esistenti. Poi, fai clic su Fine.

A questo punto, dovresti vedere la scheda delle unità pubblicitarie compilata con quelle selezionate:

Aggiungi nend come origine annuncio

Nella scheda Con struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona nend.

Seleziona nend e attiva l'opzione Ottimizza. Inserisci quanto Reporting API Key from the API Key for Scraping ottenuto nella sezione precedente per configurare l'ottimizzazione dell'origine annuncio per nend. Inserisci un valore eCPM pernend e fai clic su Continua.

Nota: devi configurare l'ottimizzazione dell'origine annuncio solo una volta per ogni rete.

Se hai già una mappatura per nend, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.

Quindi, inserisci l' Slot ID and API Key ottenuto nella sezione precedente. Poi, fai clic su Fine.

Nota: l'ottimizzazione dell'origine annuncio richiede alcuni giorni per raccogliere dati sufficienti a calcolare accuratamente l'eCPM per una rete di mediazione. Nel frattempo, lo stato di ottimizzazione dell'origine annuncio è PENDING, perciò devi impostare manualmente un valore eCPM per la rete. Una volta calcolato l'eCPM, l'origine annuncio inizia automaticamente ad aggiornare l'eCPM per tuo conto.

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

Nota: la mancata integrazione delle versioni compatibili di Nend e dell'SDK Google Mobile Ads potrebbe causare problemi di creazione.

Integrazione con Android Studio (consigliata)

Nel file settings.gradle.kts a livello di progetto, aggiungi i seguenti repository:

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

Poi, nel file build.gradle.kts a livello di app, aggiungi le seguenti dipendenze e configurazioni di implementazione. Utilizza le versioni più recenti dell'SDK e dell'adattatore Nend:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:nend:10.0.0.0")
}

Integrazione manuale

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

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

Passaggio 5: aggiungi il codice richiesto

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

Passaggio 6: 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 unità pubblicitaria 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.

Importante: disattiva la modalità di test per AdMob e nend prima di rilasciare l'app.

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();

Richiesta di annuncio adRequest = new Richiesta di annuncio.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 = Richiesta di annuncio.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 i seguenti campi: Descrizioni dei campi degli annunci nativi di NativeAd.

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

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

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

Codici di errore

Se l'adattatore non riceve un annuncio da Nend, i publisher possono controllare l'errore sottostante nella risposta dell'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 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.
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 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

• L'adattatore è stato 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 il problema di arresto anomalo di NullPointerException quando nend restituisce l'URL di un'immagine o di un logo dell'annuncio 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 il bug per cui alcuni oggetti AdError 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.
• Codici di errore aggiornati per acquisire l'errore Nend 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.
• La versione minima dell'SDK Android è stata 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.
• Risolto il raro arresto anomalo in condizioni di gara che si verificava quando gli annunci banner intelligenti vengono eliminati.
• 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.
• Compatibilità verificata 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.
• 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 l'implementazione per visualizzare una parte del banner Nend 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 le dimensioni flessibili degli annunci banner.

Versione 5.1.0.1

• L'adattatore è stato 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

• È supportato il metodo onRewardedVideoComplete() di RewardedVideoAdListener.

Versione 4.0.4.0

• Compatibilità verificata con nend SDK 4.0.4.

Versione 4.0.2.1

• È stata aggiunta la possibilità di creare Bundle di extra di mediazione utilizzando il corso 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.