NativeAd

public abstract class NativeAd


Un annuncio nativo Google.

Riepilogo

Tipi nidificati

public abstract class NativeAd.AdChoicesInfo

Informazioni sull'attribuzione.

public 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

Metodi pubblici

abstract void

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

abstract void

Elimina l'oggetto annuncio.

abstract void

Questo metodo è obsoleto.

Utilizza enableCustomClickGestureDirection.

abstract @Nullable NativeAd.AdChoicesInfo

Restituisce le informazioni per l'attribuzione Scegli Tu!.

abstract @Nullable String

Restituisce il testo che identifica l'inserzionista.

abstract @Nullable String

Restituisce il corpo del testo.

abstract @Nullable 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 @Nullable String

Restituisce il titolo del testo principale.

abstract @Nullable NativeAd.Image

Restituisce una piccola immagine che identifica l'inserzionista.

abstract List<NativeAd.Image>

Restituisce un elenco di immagini di grandi dimensioni.

abstract @Nullable MediaContent

Restituisce il MediaContent associato a questo annuncio.

abstract List<MuteThisAdReason>

Restituisce i motivi per cui è possibile disattivare questo annuncio.

abstract long

Restituisce l'ID posizionamento per questo NativeAd.

abstract @Nullable String

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

abstract @Nullable ResponseInfo

Restituisce l'oggetto ResponseInfo per l'annuncio caricato.

abstract @Nullable 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 @Nullable String

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

abstract boolean

Questo metodo è obsoleto.

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 void
muteThisAd(MuteThisAdReason muteThisAdReason)

Disattiva questo annuncio in modo programmatico.

abstract void
performClick(Bundle clickData)

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

abstract void

Questo metodo è obsoleto.

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(Bundle impressionData)

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

abstract void
reportTouchEvent(Bundle touchEventData)

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

abstract void

Imposta MuteThisAdListener per l'annuncio.

abstract void

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

abstract void
setPlacementId(long placementId)

Imposta un ID posizionamento per l'annuncio nativo.

abstract void

Imposta l'UnconfirmedClickListener per l'annuncio.

Costruttori pubblici

NativeAd

public NativeAd()

Metodi pubblici

cancelUnconfirmedClick

public abstract void cancelUnconfirmedClick()

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

eliminare

public abstract void destroy()

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

enableCustomClickGesture

public abstract void enableCustomClickGesture()

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

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

Restituisce le informazioni per l'attribuzione Scegli Tu!.

getAdvertiser

public abstract @Nullable String getAdvertiser()

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

getBody

public abstract @Nullable String getBody()

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

getCallToAction

public abstract @Nullable String getCallToAction()

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

public abstract Bundle getExtras()

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

public abstract @Nullable String getHeadline()

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

getIcon

public abstract @Nullable NativeAd.Image getIcon()

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

getImages

public abstract List<NativeAd.ImagegetImages()

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

getMediaContent

public abstract @Nullable MediaContent getMediaContent()

Restituisce il MediaContent associato a questo annuncio.

getMuteThisAdReasons

public abstract List<MuteThisAdReasongetMuteThisAdReasons()

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

getPlacementId

public abstract long getPlacementId()

Restituisce l'ID posizionamento per questo NativeAd.

getPrice

public abstract @Nullable String getPrice()

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

public abstract @Nullable ResponseInfo getResponseInfo()

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

getStarRating

public abstract @Nullable Double getStarRating()

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

public abstract @Nullable String getStore()

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

public abstract boolean isCustomClickGestureEnabled()

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

public abstract boolean isCustomMuteThisAdEnabled()

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

muteThisAd

public abstract void muteThisAd(MuteThisAdReason muteThisAdReason)

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

public abstract void performClick(Bundle clickData)

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
Bundle clickData

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

recordCustomClickGesture

public abstract void recordCustomClickGesture()

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

public abstract boolean recordImpression(Bundle impressionData)

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
Bundle impressionData

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

public abstract void reportTouchEvent(Bundle touchEventData)

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
Bundle touchEventData

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

public abstract void setMuteThisAdListener(MuteThisAdListener listener)

Imposta MuteThisAdListener per l'annuncio.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setPlacementId

public abstract void setPlacementId(long placementId)

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
long placementId

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

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

Imposta l'UnconfirmedClickListener per l'annuncio.