NativeAd

abstract class NativeAd


Un annuncio nativo Google.

Riepilogo

Tipi nidificati

abstract class NativeAd.AdChoicesInfo

Informazioni sull'attribuzione.

abstract class NativeAd.Image

Un asset immagine annuncio nativo.

Definizione dell'interfaccia per un callback da richiamare quando un annuncio nativo è stato caricato correttamente.

Un'interfaccia di listener che le app possono utilizzare per ricevere eventi di clic non confermati quando utilizzano la funzionalità Clic confermato.

Costruttori pubblici

Funzioni pubbliche

abstract Unit

Annulla un clic non confermato registrato in precedenza per l'annuncio.

abstract Unit

Elimina l'oggetto annuncio.

abstract Unit

Questa funzione è deprecata.

Utilizza enableCustomClickGestureDirection.

abstract NativeAd.AdChoicesInfo?

Restituisce le informazioni per l'attribuzione Scegli Tu!.

abstract String?

Restituisce il testo che identifica l'inserzionista.

abstract String?

Restituisce il corpo del testo.

abstract String?

Restituisce l'invito all'azione dell'annuncio (ad esempio "Acquista" o "Installa").

abstract Bundle!

Restituisce un bundle di asset aggiuntivi associati all'annuncio nativo.

abstract String?

Restituisce il titolo del testo principale.

abstract NativeAd.Image?

Restituisce una piccola immagine che identifica l'inserzionista.

abstract (Mutable)List<NativeAd.Image!>!

Restituisce un elenco di immagini di grandi dimensioni.

abstract MediaContent?

Restituisce il MediaContent associato a questo annuncio.

abstract (Mutable)List<MuteThisAdReason!>!

Restituisce i motivi per cui è possibile disattivare questo annuncio.

abstract Long

Restituisce l'ID posizionamento per questo NativeAd.

abstract String?

Per gli annunci relativi alle app, restituisce una stringa che rappresenta il costo dell'app.

abstract ResponseInfo?

Restituisce l'oggetto ResponseInfo per l'annuncio caricato.

abstract Double?

Per gli annunci relativi alle app, restituisce una valutazione a stelle da 0 a 5 che indica il numero di stelle che l'app ha nello store che la offre.

abstract String?

Per gli annunci relativi alle app, restituisce il nome dello store che offre l'app per il download.

abstract Boolean

Questa funzione è deprecata.

Quando carichi un annuncio utilizzando enableCustomClickGestureDirection, tutti gli annunci restituiti supportano il gesto di clic personalizzato.

abstract Boolean

Restituisce true se questo annuncio può essere disattivato a livello di programmazione.

abstract Unit
muteThisAd(muteThisAdReason: MuteThisAdReason!)

Disattiva questo annuncio in modo programmatico.

abstract Unit
performClick(clickData: Bundle!)

Deve essere chiamato quando l'utente ha fatto clic sull'annuncio.

abstract Unit

Questa funzione è deprecata.

L'SDK Google Mobile Ads ora monitora i gesti di clic personalizzati utilizzando la direzione del gesto di clic richiesta in enableCustomClickGestureDirection.

abstract Boolean
recordImpression(impressionData: Bundle!)

Deve essere chiamato quando l'annuncio viene visualizzato per la prima volta.

abstract Unit
reportTouchEvent(touchEventData: Bundle!)

Deve essere chiamato quando si verifica un evento tocco sull'annuncio.

abstract Unit

Imposta MuteThisAdListener per l'annuncio.

abstract Unit

Registra un callback da richiamare quando si stima che questo annuncio abbia generato entrate.

abstract Unit
setPlacementId(placementId: Long)

Imposta un ID posizionamento per l'annuncio nativo.

abstract Unit

Imposta l'UnconfirmedClickListener per l'annuncio.

Costruttori pubblici

NativeAd

NativeAd()

Funzioni pubbliche

cancelUnconfirmedClick

abstract fun cancelUnconfirmedClick(): Unit

Annulla un clic non confermato registrato in precedenza per l'annuncio.

eliminare

abstract fun destroy(): Unit

Elimina l'oggetto annuncio. Non devono essere chiamati altri metodi sull'oggetto annuncio dopo la chiamata di destroy.

enableCustomClickGesture

abstract fun enableCustomClickGesture(): Unit

Consente ai publisher di segnalare i clic utilizzando gesti personalizzati per questo NativeAd. L'unità pubblicitaria deve essere inclusa nella lista consentita per poter utilizzare questo metodo.

Per impostazione predefinita, l'SDK monitora i clic sulle visualizzazioni degli asset. Se viene chiamato questo metodo, l'SDK non monitorerà più i clic per questo NativeAd. Deve essere chiamato prima di mostrare l'annuncio.

getAdChoicesInfo

abstract fun getAdChoicesInfo(): NativeAd.AdChoicesInfo?

Restituisce le informazioni per l'attribuzione Scegli Tu!.

getAdvertiser

abstract fun getAdvertiser(): String?

Restituisce il testo che identifica l'inserzionista. Le app non sono tenute a mostrare questa risorsa, anche se è consigliata.

getBody

abstract fun getBody(): String?

Restituisce il corpo del testo. Le app sono tenute a mostrare questo asset.

getCallToAction

abstract fun getCallToAction(): String?

Restituisce l'invito all'azione dell'annuncio (ad esempio "Acquista" o "Installa"). Le app non sono tenute a mostrare questa risorsa, anche se è consigliata.

getExtras

abstract fun getExtras(): Bundle!

Restituisce un bundle di asset aggiuntivi associati all'annuncio nativo. Se l'annuncio di un partner di mediazione ha asset diversi da quelli standard (prezzo, negozio e così via), possono essere impostati chiamando il metodo in setExtras e possono essere recuperati tramite questo metodo. Per il flusso non di mediazione, restituisce un bundle vuoto.

getHeadline

abstract fun getHeadline(): String?

Restituisce il titolo del testo principale. Le app sono tenute a mostrare questo asset.

getIcon

abstract fun getIcon(): NativeAd.Image?

Restituisce una piccola immagine che identifica l'inserzionista. Le app non sono tenute a mostrare questa risorsa, anche se è consigliata.

getImages

abstract fun getImages(): (Mutable)List<NativeAd.Image!>!

Restituisce un elenco di immagini di grandi dimensioni. Le app non sono tenute a mostrare questa risorsa, anche se è consigliata.

getMediaContent

abstract fun getMediaContent(): MediaContent?

Restituisce il MediaContent associato a questo annuncio.

getMuteThisAdReasons

abstract fun getMuteThisAdReasons(): (Mutable)List<MuteThisAdReason!>!

Restituisce i motivi per cui è possibile disattivare questo annuncio. Utilizza la descrizione del testo della classe da mostrare all'utente.

getPlacementId

abstract fun getPlacementId(): Long

Restituisce l'ID posizionamento per questo NativeAd.

getPrice

abstract fun getPrice(): String?

Per gli annunci relativi alle app, restituisce una stringa che rappresenta il costo dell'app. Le app non sono tenute a mostrare questa risorsa, anche se è consigliata.

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo?

Restituisce l'oggetto ResponseInfo per l'annuncio caricato. Restituisce null finché l'annuncio non viene caricato correttamente.

getStarRating

abstract fun getStarRating(): Double?

Per gli annunci relativi alle app, restituisce una valutazione a stelle da 0 a 5 che indica il numero di stelle che l'app ha nello store che la offre. Le app non sono tenute a mostrare questa risorsa, anche se è consigliata.

getStore

abstract fun getStore(): String?

Per gli annunci relativi alle app, restituisce il nome dello store che offre l'app per il download. Ad esempio, "Google Play". Le app non sono tenute a mostrare questa risorsa, anche se è consigliata.

isCustomClickGestureEnabled

abstract fun isCustomClickGestureEnabled(): Boolean

Indica se è possibile generare report sui clic utilizzando i gesti di clic personalizzati. Contatta il tuo account manager per inserire la tua unità pubblicitaria nella lista consentita per questa funzionalità.

isCustomMuteThisAdEnabled

abstract fun isCustomMuteThisAdEnabled(): Boolean

Restituisce true se questo annuncio può essere disattivato a livello di programmazione. Utilizza setRequestCustomMuteThisAd per richiedere l'implementazione personalizzata di Disattiva questo annuncio.

muteThisAd

abstract fun muteThisAd(muteThisAdReason: MuteThisAdReason!): Unit

Disattiva questo annuncio in modo programmatico.

Parametri
muteThisAdReason: MuteThisAdReason!

Il motivo del silenziamento selezionato dall'utente. Visualizza i motivi della disattivazione dell'audio da getMuteThisAdReasons. Utilizza null per disattivare questo annuncio con il motivo predefinito.

performClick

abstract fun performClick(clickData: Bundle!): Unit

Deve essere chiamato quando l'utente ha fatto clic sull'annuncio. Per poter utilizzare questa API, l'unità pubblicitaria deve essere inclusa nella lista consentita. Questo metodo deve essere utilizzato solo dagli editori di plug-in Unity.

Parametri
clickData: Bundle!

bundle dell'ambiente dell'app quando si verifica il clic. Per i dettagli sulla creazione dei dati sui clic Bundle, vedi NativeAdConstants.

recordCustomClickGesture

abstract fun recordCustomClickGesture(): Unit

Registra i clic per questo NativeAd utilizzando il gesto di clic personalizzato. L'unità pubblicitaria deve essere inclusa nella lista consentita per poter utilizzare questo metodo.

enableCustomClickGesture deve essere chiamato prima di chiamare questo metodo.

recordImpression

abstract fun recordImpression(impressionData: Bundle!): Boolean

Deve essere chiamato quando l'annuncio viene visualizzato per la prima volta. Per poter utilizzare questa API, l'unità pubblicitaria deve essere inclusa nella lista consentita.

Parametri
impressionData: Bundle!

bundle dell'ambiente dell'app quando si verifica l'impressione. Per i dettagli sulla creazione dei dati sui clic Bundle, vedi NativeAdConstants.

Resi
Boolean

true se l'impressione viene registrata correttamente

reportTouchEvent

abstract fun reportTouchEvent(touchEventData: Bundle!): Unit

Deve essere chiamato quando si verifica un evento tocco sull'annuncio. Per poter utilizzare questa API, l'unità pubblicitaria deve essere inclusa nella lista consentita. Se ti interessa utilizzare questa funzionalità, contatta il tuo account manager.

Parametri
touchEventData: Bundle!

pacchetto di coordinate e durata dell'evento tocco.

Esempio di rappresentazione JSON del bundle touchEventData:

  {    "x": "100",  // The x-coordinate of the touch event relative to the window.    "y": "50",  // The y-coordinate of the touch event relative to the window.    "duration_millis": "500",  // The amount of milliseconds the user pressed on the asset.  }

setMuteThisAdListener

abstract fun setMuteThisAdListener(listener: MuteThisAdListener!): Unit

Imposta MuteThisAdListener per l'annuncio.

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

Registra un callback da richiamare quando si stima che questo annuncio abbia generato entrate.

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

Imposta un ID posizionamento per l'annuncio nativo.

Per assicurarti che questo ID posizionamento sia incluso nei report, chiama questo metodo prima di associare l'annuncio a un oggetto NativeAdView.

Parametri
placementId: Long

Un numero intero lungo fornito dall'interfaccia utente di AdMob per il posizionamento configurato.

setUnconfirmedClickListener

abstract fun setUnconfirmedClickListener(
    listener: NativeAd.UnconfirmedClickListener!
): Unit

Imposta l'UnconfirmedClickListener per l'annuncio.