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

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

  • Target di deployment per iOS 12.0 o versioni successive

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

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

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.

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.

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

  • Aggiungi la riga seguente al podfile del progetto:

    pod 'GoogleMobileAdsMediationNend'

  • Dalla riga di comando, esegui:

    pod install --repo-update

Integrazione manuale

Scarica la versione più recente dell'SDK per iOS di Nend e collega nendSDK.framework nel tuo progetto. Scarica l'ultimo adattatore di rete dal link di download nel log delle modifiche e collega NendAdapter.framework nel tuo progetto.

Aggiungi i seguenti framework al tuo progetto:

  • AdSupport.framework
  • Security.framework
  • ImageIO.framework
  • AVFoundation.framework
  • CoreMedia.framework
  • SystemConfiguration.framework
  • WebKit.framework

Inoltre, aggiungendo i seguenti framework, è possibile utilizzare informazioni dettagliate per la pubblicazione degli annunci.

  • CoreLocation.framework
  • CoreMotion.framework
  • CoreTelephony.framework

Passaggio 5: aggiungi il codice richiesto

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

Integrazione di SKAdNetwork

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

Impostazioni progetto

Aggiungi il flag -ObjC ad Altri flag linker in Destinazione applicazione > Impostazioni build.

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

Passaggi facoltativi

Parametri specifici della rete

L'adattatore di rete supporta parametri di richiesta aggiuntivi, che possono essere trasmessi all'adattatore utilizzando la classe GADMAdapterNendExtras. Questa classe include le seguenti proprietà:

  • interstitialType: Nend offre la possibilità di selezionare TypeNormal per gli annunci interstitial normali o TypeVideo per gli annunci video interstitial. Se questo parametro aggiuntivo non viene aggiunto, Nend utilizza per impostazione predefinita TypeNormal come tipo di interstitial.
  • nativeType: Nend offre la possibilità di selezionare TypeNormal per gli annunci nativi normali o TypeVideo per gli annunci video nativi. Se non viene aggiunto questo parametro aggiuntivo, Nend utilizza per impostazione predefinita TypeNormal come tipo di annuncio nativo.

Ecco alcuni esempi di come impostare questi parametri di richiesta di annuncio:

Swift 

let request = GADRequest()
let extras = GADMAdapterNendExtras()
extras.interstitialType = GADMAdapterNendInterstitialType.normal
extras.nativeType = GADMAdapterNendNativeType.normal
request.registerAdNetworkExtras(extras)

Objective-C 

GADRequest *request = [GADRequest request];
GADMAdapterNendExtras *extras = [[GADMAdapterNendExtras alloc] init];
extras.interstitialType = GADMAdapterNendInterstitialTypeNormal;
extras.nativeType = GADMAdapterNendNativeTypeNormal;
[request registerAdNetworkExtras:extras];

Utilizzo degli annunci nativi

Rendering dell'annuncio

L'adattatore Nend restituisce gli annunci nativi come GADNativeAd oggetti. Compila i seguenti campi: Descrizioni dei campi degli annunci nativi di GADNativeAd.

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 di grandi dimensioni orizzontale (5: 3).

2 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 GADResponseInfo.adNetworkInfoArray nei seguenti corsi:

Formato Nome corso
Banner GADMAdapterNend
Interstitial GADMAdapterNend
Con premio GADMAdapterNendRewarded
Nativo GADMediationAdapterNend

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.

Aggiungi log delle modifiche all'adattatore di mediazione iOS

Versione successiva

  • È stato rimosso il metodo delegato willBackgroundApplication obsoleto dal caricatore di annunci nativi.
  • Ora richiede almeno la versione iOS 12.0.
  • Ora richiede l'SDK Google Mobile Ads versione 11.0 o successive.
  • Info.plist incluso nei framework in NendAdapter.xcframework.

Versione 8.2.0.0

  • Compatibilità verificata con nend SDK 8.2.0.

Realizzato e testato con:

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

Versione 8.1.0.0

  • Rimosso il supporto dell'architettura armv7.
  • Ora richiede almeno la versione 11.0 di iOS.
  • Ora richiede l'SDK Google Mobile Ads versione 10.4.0 o successive.

Realizzato e testato con:

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

Versione 8.0.1.0

  • Compatibilità verificata con nend SDK 8.0.1.

Realizzato e testato con:

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

Versione 8.0.0.0

  • Compatibilità verificata con nend SDK 8.0.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 10.2.0.
  • Nend SDK versione 8.0.0.

Versione 7.4.0.1

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

Realizzato e testato con:

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

Versione 7.4.0.0

  • Compatibilità verificata con nend SDK 7.4.0.
  • È stato aggiornato l'adattatore in modo che utilizzi l'API didRewardUser.
  • Ora richiede l'SDK Google Mobile Ads versione 9.8.0 o successive.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 9.10.0.
  • Nend SDK versione 7.4.0.

Versione 7.3.0.0

  • Compatibilità verificata con nend SDK 7.3.0.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 9.3.0.
  • Nend SDK versione 7.3.0.

Versione 7.2.0.0

  • Compatibilità verificata con nend SDK 7.2.0.
  • Aggiunto il supporto per l'architettura del simulatore ARM64.

Realizzato e testato con:

  • SDK Google Mobile Ads versione 9.1.0.
  • Nend SDK versione 7.2.0.

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

Realizzato e testato con:

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

Versione 7.1.0.0

  • Compatibilità verificata con nend SDK 7.1.0.
  • Ora richiede almeno la versione 10.0 di iOS.

Realizzato e testato con

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

Versione 7.0.6.1

  • Risolto il problema per cui il callback adDidRecordClick non viene inoltrato per gli annunci interstitial.

Realizzato e testato con

  • SDK Google Mobile Ads versione 8.9.0.
  • Nend SDK versione 7.0.6.

Versione 7.0.6.0

  • Compatibilità verificata con nend SDK 7.0.6.
  • Sono stati aggiunti messaggi e codici di errore relativi all'adattatore standardizzato.

Realizzato e testato con

  • SDK Google Mobile Ads versione 8.8.0.
  • Nend SDK versione 7.0.6.

Versione 7.0.5.0

  • Compatibilità verificata con nend SDK 7.0.5.

Realizzato e testato con

  • SDK Google Mobile Ads versione 8.5.0.
  • Nend SDK versione 7.0.5.

Versione 7.0.4.0

  • Compatibilità verificata con nend SDK 7.0.4.
  • Dipendenza semplice dall'SDK Google Mobile Ads versione 8.0.0 o successive.
  • È stato aggiornato l'adattatore in modo che utilizzi il formato .xcframework.

Realizzato e testato con

  • SDK Google Mobile Ads versione 8.5.0.
  • Nend SDK versione 7.0.4.

Versione 7.0.2.0

  • Compatibilità verificata con nend SDK 7.0.2.
  • Risolto il problema per cui la visualizzazione multimediale a volte veniva mostrata nella posizione errata.

Realizzato e testato con

  • SDK Google Mobile Ads versione 7.69.0.
  • Nend SDK versione 7.0.2.

Versione 7.0.1.0

  • Compatibilità verificata con nend SDK 7.0.1.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 7.69.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 7.69.0.
  • Nend SDK versione 7.0.1.

Versione 7.0.0.0

  • Compatibilità verificata con nend SDK 7.0.0.

Realizzato e testato con

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

Versione 6.0.3.0

  • Compatibilità verificata con nend SDK 6.0.3.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 7.65.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 7.65.0.
  • Nend SDK versione 6.0.3.

Versione 6.0.2.0

  • Compatibilità verificata con nend SDK 6.0.2.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 7.64.0.

Realizzato e testato con

  • SDK Google Mobile Ads versione 7.64.0.
  • Nend SDK versione 6.0.2.

Versione 6.0.1.0

  • Compatibilità verificata con nend SDK 6.0.1.

Realizzato e testato con

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

Versione 6.0.0.0

  • Compatibilità verificata con nend SDK 6.0.0.
  • Classe GADNendRewardedNetworkExtras rimosso. Se vuoi trasferire ulteriori funzionalità di rete all'adattatore iOS di Nend, utilizza la classe GADMAdapterNendExtras.
  • Le seguenti enum sono state rinominate dalla classe GADMAdapterNendExtras:
    • GADMNendInterstitialType per GADMAdapterNendInterstitialType.
    • GADMNendNativeType per GADMAdapterNendNativeType.
  • La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 7.62.0.

Realizzato e testato con

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

Versione 5.4.1.0

  • Compatibilità verificata con nend SDK 5.4.1.
  • Aggiunto il supporto per gli annunci nativi.
  • Rimosso il supporto per l'architettura i386.

Realizzato e testato con

  • SDK Google Mobile Ads versione 7.58.0.
  • Nend SDK versione 5.4.1.

Versione 5.3.1.0

  • Compatibilità verificata con nend SDK 5.3.1.

Sviluppa e testa con

  • SDK Google Mobile Ads versione 7.52.0.
  • Nend SDK versione 5.3.1.

Versione 5.3.0.0

  • Compatibilità verificata con nend SDK 5.3.0.

Realizzato e testato con:

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

Versione 5.1.1.0

  • Aggiornato l'adattatore in modo che utilizzi la nuova API con premio.
  • Ora richiede l'SDK Google Mobile Ads versione 7.42.2 o successive.
  • Compatibilità verificata con nend SDK 5.1.1.
  • È stata modificata la condizione che controlla le dimensioni del banner. Dimensioni appropriate per SmartBanner.
    • kGADAdSizeSmartBannerPortrait
      • iPhone: 320×50
      • iPad: 728 × 90 o 320 × 50
    • kGADAdSizeSmartBannerLandscape
      • iPad: 728 × 90 o 320 × 50
  • Aggiunto il supporto per le dimensioni flessibili degli annunci banner.

Versione 5.1.0.0

  • Compatibilità verificata con nend SDK 5.1.0.

Versione 5.0.3.0

  • Compatibilità verificata con nend SDK 5.0.3.

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

  • Compatibilità verificata con nend SDK 4.0.6.
  • Rimuovi per impostare la proprietà userFeature.

Versione 4.0.5.0

  • Compatibilità verificata con nend SDK 4.0.5.

Versione 4.0.4.0

  • Compatibilità verificata con nend SDK 4.0.4.

Versione 4.0.3.0

  • Compatibilità verificata con nend SDK 4.0.3.

Versione 4.0.2.0

  • Prima release nel progetto open source di mediazione Google Mobile Ads.
  • Aggiunto il supporto per gli annunci video basati sui premi.

Versioni precedenti

  • Supporta gli annunci banner e interstitial.