NativeAd

public abstract class NativeAd


Annonce native Google.

Résumé

Types imbriqués

public abstract class NativeAd.AdChoicesInfo

Informations sur l'attribution.

public abstract class NativeAd.Image

Composant Image d'une annonce native.

Définition de l'interface pour un rappel à invoquer lorsqu'une annonce native a été chargée.

Interface d'écouteur que les applications peuvent utiliser pour recevoir des événements de clic non confirmés lorsqu'elles utilisent la fonctionnalité Clic confirmé.

Constructeurs publics

Méthodes publiques

abstract void

Annule un clic non confirmé qui a été enregistré précédemment pour l'annonce.

abstract void

Détruit l'objet d'annonce.

abstract void

Cette méthode est obsolète.

Utilisez enableCustomClickGestureDirection.

abstract @Nullable NativeAd.AdChoicesInfo

Renvoie les informations sur l'attribution "Choisir sa pub".

abstract @Nullable String

Renvoie le texte qui identifie l'annonceur.

abstract @Nullable String

Renvoie le corps du texte.

abstract @Nullable String

Renvoie l'incitation à l'action de l'annonce (par exemple, "Acheter" ou "Installer").

abstract Bundle

Renvoie un bundle d'éléments supplémentaires associés à l'annonce native.

abstract @Nullable String

Renvoie le titre du texte principal.

abstract @Nullable NativeAd.Image

Renvoie une petite image identifiant l'annonceur.

abstract List<NativeAd.Image>

Renvoie une liste de grandes images.

abstract @Nullable MediaContent

Renvoie le MediaContent associé à cette annonce.

abstract List<MuteThisAdReason>

Renvoie les motifs de la fonctionnalité "Ignorer cette annonce" disponibles pour cette annonce.

abstract long

Renvoie l'ID de l'emplacement pour cet objet NativeAd.

abstract @Nullable String

Pour les annonces sur les applications, renvoie une chaîne représentant le prix de l'application.

abstract @Nullable ResponseInfo

Renvoie l'objet ResponseInfo pour l'annonce chargée.

abstract @Nullable Double

Pour les annonces sur les applications, renvoie une note de 0 à 5 étoiles représentant le nombre d'étoiles attribuées à l'application sur la plate-forme qui la propose.

abstract @Nullable String

Pour les annonces sur les applications, renvoie le nom du magasin proposant l'application à télécharger.

abstract boolean

Cette méthode est obsolète.

Lorsque vous chargez une annonce à l'aide de enableCustomClickGestureDirection, toutes les annonces renvoyées sont compatibles avec le geste de clic personnalisé.

abstract boolean

Renvoie true si cette annonce peut être mise en sourdine de manière programmatique.

abstract void
muteThisAd(MuteThisAdReason muteThisAdReason)

Ignore cette annonce de manière programmatique.

abstract void
performClick(Bundle clickData)

Doit être appelée lorsque l'utilisateur a cliqué sur l'annonce.

abstract void

Cette méthode est obsolète.

Le SDK Google Mobile Ads suit désormais les gestes de clic personnalisés à l'aide de la direction du geste de clic demandée dans enableCustomClickGestureDirection.

abstract boolean
recordImpression(Bundle impressionData)

Doit être appelé lorsque l'annonce est affichée pour la première fois.

abstract void
reportTouchEvent(Bundle touchEventData)

Doit être appelé lorsqu'un événement tactile se produit sur l'annonce.

abstract void

Définit le MuteThisAdListener pour l'annonce.

abstract void

Enregistrez un rappel à invoquer lorsque cette annonce est estimée avoir généré des revenus.

abstract void
setPlacementId(long placementId)

Définit un ID d'emplacement pour l'annonce native.

abstract void

Définit le UnconfirmedClickListener pour l'annonce.

Constructeurs publics

NativeAd

public NativeAd()

Méthodes publiques

cancelUnconfirmedClick

public abstract void cancelUnconfirmedClick()

Annule un clic non confirmé qui a été enregistré précédemment pour l'annonce.

détruire

public abstract void destroy()

Détruit l'objet d'annonce. Aucune autre méthode ne doit être appelée sur l'objet d'annonce après l'appel de destroy.

enableCustomClickGesture

public abstract void enableCustomClickGesture()

Permet aux éditeurs de signaler les clics à l'aide de gestes personnalisés pour ce NativeAd. Le bloc d'annonces doit être ajouté à la liste d'autorisation pour que vous puissiez utiliser cette méthode.

Par défaut, le SDK suit les clics sur les vues de composants. Si cette méthode est appelée, le SDK ne suivra plus les clics pour ce NativeAd. Il doit être appelé avant l'affichage de l'annonce.

getAdChoicesInfo

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

Renvoie les informations sur l'attribution "Choisir sa pub".

getAdvertiser

public abstract @Nullable String getAdvertiser()

Renvoie le texte qui identifie l'annonceur. Les applications ne sont pas tenues d'afficher cet élément, mais c'est recommandé.

getBody

public abstract @Nullable String getBody()

Renvoie le corps du texte. Les applications sont tenues d'afficher cet élément.

getCallToAction

public abstract @Nullable String getCallToAction()

Renvoie l'incitation à l'action de l'annonce (par exemple, "Acheter" ou "Installer"). Les applications ne sont pas tenues d'afficher cet élément, mais c'est recommandé.

getExtras

public abstract Bundle getExtras()

Renvoie un bundle d'éléments supplémentaires associés à l'annonce native. Si l'annonce d'un partenaire de médiation comporte des composants autres que ceux standards (prix, magasin, etc.), ils peuvent être définis en appelant la méthode dans setExtras et récupérés via cette méthode. Pour le flux sans médiation, il renvoie un bundle vide.

getHeadline

public abstract @Nullable String getHeadline()

Renvoie le titre du texte principal. Les applications sont tenues d'afficher cet élément.

getIcon

public abstract @Nullable NativeAd.Image getIcon()

Renvoie une petite image identifiant l'annonceur. Les applications ne sont pas tenues d'afficher cet élément, mais c'est recommandé.

getImages

public abstract List<NativeAd.ImagegetImages()

Renvoie une liste de grandes images. Les applications ne sont pas tenues d'afficher cet élément, mais c'est recommandé.

getMediaContent

public abstract @Nullable MediaContent getMediaContent()

Renvoie le MediaContent associé à cette annonce.

getMuteThisAdReasons

public abstract List<MuteThisAdReasongetMuteThisAdReasons()

Renvoie les motifs de la fonctionnalité "Ignorer cette annonce" disponibles pour cette annonce. Utilisez la description textuelle de la classe pour l'afficher à l'utilisateur.

getPlacementId

public abstract long getPlacementId()

Renvoie l'ID de l'emplacement pour cet objet NativeAd.

getPrice

public abstract @Nullable String getPrice()

Pour les annonces sur les applications, renvoie une chaîne représentant le prix de l'application. Les applications ne sont pas tenues d'afficher cet élément, mais c'est recommandé.

getResponseInfo

public abstract @Nullable ResponseInfo getResponseInfo()

Renvoie l'objet ResponseInfo pour l'annonce chargée. Renvoie null jusqu'à ce que l'annonce soit chargée.

getStarRating

public abstract @Nullable Double getStarRating()

Pour les annonces sur les applications, renvoie une note de 0 à 5 étoiles représentant le nombre d'étoiles attribuées à l'application sur la plate-forme qui la propose. Les applications ne sont pas tenues d'afficher cet élément, mais c'est recommandé.

getStore

public abstract @Nullable String getStore()

Pour les annonces sur les applications, renvoie le nom du magasin proposant l'application à télécharger. (par exemple, "Google Play"). Les applications ne sont pas tenues d'afficher cet élément, mais c'est recommandé.

isCustomClickGestureEnabled

public abstract boolean isCustomClickGestureEnabled()

Indique si les clics peuvent être signalés à l'aide de gestes de clic personnalisés. Contactez votre responsable de compte pour ajouter votre bloc d'annonces à la liste d'autorisation pour cette fonctionnalité.

isCustomMuteThisAdEnabled

public abstract boolean isCustomMuteThisAdEnabled()

Renvoie true si cette annonce peut être mise en sourdine de manière programmatique. Utilisez setRequestCustomMuteThisAd pour demander une implémentation personnalisée de la fonctionnalité "Ignorer cette annonce".

muteThisAd

public abstract void muteThisAd(MuteThisAdReason muteThisAdReason)

Ignore cette annonce de manière programmatique.

Paramètres
MuteThisAdReason muteThisAdReason

Motif de la désactivation du son sélectionné par l'utilisateur. Obtenez les raisons de la mise en sourdine à partir de getMuteThisAdReasons. Utilisez null pour ignorer cette annonce avec le motif par défaut.

performClick

public abstract void performClick(Bundle clickData)

Doit être appelée lorsque l'utilisateur a cliqué sur l'annonce. Pour pouvoir utiliser cette API, le bloc d'annonces doit être ajouté à la liste d'autorisation. Cette méthode ne doit être utilisée que par les éditeurs de plug-ins Unity.

Paramètres
Bundle clickData

bundle de l'environnement de l'application lorsque le clic se produit. Pour savoir comment construire les données de clics Bundle, consultez NativeAdConstants.

recordCustomClickGesture

public abstract void recordCustomClickGesture()

Signale les clics pour ce NativeAd à l'aide d'un geste de clic personnalisé. Le bloc d'annonces doit être ajouté à la liste d'autorisation pour que vous puissiez utiliser cette méthode.

enableCustomClickGesture doit être appelé avant cette méthode.

recordImpression

public abstract boolean recordImpression(Bundle impressionData)

Doit être appelé lorsque l'annonce est affichée pour la première fois. Pour pouvoir utiliser cette API, le bloc d'annonces doit être ajouté à la liste d'autorisation.

Paramètres
Bundle impressionData

bundle de l'environnement de l'application au moment de l'impression. Pour savoir comment construire les données d'impression Bundle, consultez NativeAdConstants.

Renvoie
boolean

"true" si l'impression a bien été enregistrée

reportTouchEvent

public abstract void reportTouchEvent(Bundle touchEventData)

Doit être appelé lorsqu'un événement tactile se produit sur l'annonce. Pour pouvoir utiliser cette API, le bloc d'annonces doit être ajouté à la liste d'autorisation. Si vous souhaitez utiliser cette fonctionnalité, contactez votre responsable de compte.

Paramètres
Bundle touchEventData

Ensemble de coordonnées et de durée d'un événement tactile.

Exemple de représentation JSON du 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)

Définit le MuteThisAdListener pour l'annonce.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Enregistrez un rappel à invoquer lorsque cette annonce est estimée avoir généré des revenus.

setPlacementId

public abstract void setPlacementId(long placementId)

Définit un ID d'emplacement pour l'annonce native.

Pour vous assurer que cet ID d'emplacement est inclus dans les rapports, appelez cette méthode avant d'associer l'annonce à une NativeAdView.

Paramètres
long placementId

Entier long fourni par l'UI AdMob pour l'emplacement configuré.

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

Définit le UnconfirmedClickListener pour l'annonce.