NativeAd

Kotlin |Java

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.
public interface NativeAd.OnNativeAdLoadedListener Définition de l'interface d'un rappel à appeler lorsqu'une annonce native a été chargée.
public interface NativeAd.UnconfirmedClickListener Interface d'écouteur que les applications peuvent utiliser pour recevoir des événements de clic non confirmés lorsqu'elles utilisent la fonctionnalité de clic confirmé.

Constructeurs publics
NativeAd()

Méthodes publiques
abstract void	cancelUnconfirmedClick() Annule un clic non confirmé précédemment enregistré pour l'annonce.
abstract void	destroy() Détruit l'objet de l'annonce.
abstract void	enableCustomClickGesture() Cette méthode est obsolète. Utilisez enableCustomClickGestureDirection.
abstract @Nullable NativeAd.AdChoicesInfo	getAdChoicesInfo() Renvoie les informations sur l'attribution AdChoices.
abstract @Nullable String	getAdvertiser() Renvoie le texte permettant d'identifier l'annonceur.
abstract @Nullable String	getBody() Renvoie le corps du texte.
abstract @Nullable String	getCallToAction() Indique l'incitation à l'action de l'annonce (par exemple, "Acheter" ou "Installer").
abstract Bundle	getExtras() Renvoie un lot d'assets supplémentaires associés à l'annonce native.
abstract @Nullable String	getHeadline() Affiche le titre principal du texte.
abstract @Nullable NativeAd.Image	getIcon() Renvoie une petite image identifiant l'annonceur.
abstract List<NativeAd.Image>	getImages() Renvoie une liste d'images de grande taille.
abstract @Nullable MediaContent	getMediaContent() Renvoie le MediaContent associé à cette annonce.
abstract List<MuteThisAdReason>	getMuteThisAdReasons() Indique les raisons pour lesquelles l'utilisateur peut ignorer cette annonce.
abstract @Nullable String	getPrice() Pour les annonces concernant des applications, renvoie une chaîne représentant le prix de l'application.
abstract @Nullable ResponseInfo	getResponseInfo() Renvoie l'objet ResponseInfo de l'annonce chargée.
abstract @Nullable Double	getStarRating() Pour les annonces concernant des applications, renvoie une note sur cinq qui indique le nombre d'étoiles attribuées à l'application sur la plate-forme de téléchargement qui la propose.
abstract @Nullable String	getStore() Pour les annonces concernant des applications, renvoie le nom de la plate-forme de téléchargement d'applications proposant l'application.
abstract boolean	isCustomClickGestureEnabled() 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	isCustomMuteThisAdEnabled() Renvoie true si cette annonce peut être mise en sourdine de manière programmatique.
abstract void	muteThisAd(MuteThisAdReason muteThisAdReason) Ignore cette annonce de façon programmatique.
abstract void	performClick(Bundle clickData) Doit être appelé lorsque l'utilisateur a cliqué sur l'annonce.
abstract void	recordCustomClickGesture() 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 de geste de clic demandée dans enableCustomClickGestureDirection.
abstract boolean	recordImpression(Bundle impressionData) Doit être appelé lors du premier affichage de l'annonce.
abstract void	reportTouchEvent(Bundle touchEventData) Doit être appelé lorsqu'un événement tactile se produit sur l'annonce.
abstract void	setMuteThisAdListener(MuteThisAdListener listener) Définit le MuteThisAdListener de l'annonce.
abstract void	setOnPaidEventListener(@Nullable OnPaidEventListener listener) Enregistrez un rappel à appeler lorsque cette annonce aura généré des revenus estimés.
abstract void	setUnconfirmedClickListener(     NativeAd.UnconfirmedClickListener listener ) Définit UnconfirmedClickListener pour l'annonce.

Constructeurs publics

NativeAd

public NativeAd()

Méthodes publiques

cancelUnconfirmedClick

public abstract void cancelUnconfirmedClick()

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

détruire

public abstract void destroy()

Détruit l'objet de l'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()

Cette méthode est obsolète.

Utilisez enableCustomClickGestureDirection.

Permet aux éditeurs de générer des rapports sur les clics à l'aide de gestes personnalisés pour cette NativeAd. Pour pouvoir utiliser cette méthode, le bloc d'annonces doit être ajouté à la liste d'autorisation.

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

getAdChoicesInfo

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

Renvoie les informations pour l'attribution AdChoices.

getAdvertiser

public abstract @Nullable String getAdvertiser()

Renvoie le texte permettant d'identifier l'annonceur. Les applications ne sont pas tenues d'afficher cet élément, mais il est recommandé de le faire.

getBody

public abstract @Nullable String getBody()

Renvoie le corps du texte. Les applications doivent afficher cet élément.

getCallToAction

public abstract @Nullable String getCallToAction()

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

getExtras

public abstract Bundle getExtras()

Renvoie un lot d'assets supplémentaires associés à l'annonce native. Si l'annonce d'un partenaire de médiation comporte des composants en plus des composants standards (prix, magasin, etc.), vous pouvez les définir en appelant la méthode dans setExtras et les récupérer via cette méthode. Pour le flux sans médiation, il renvoie un lot vide.

getHeadline

public abstract @Nullable String getHeadline()

Affiche le titre principal du texte. Les applications doivent 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 il est recommandé de le faire.

getImages

public abstract List<NativeAd.Image> getImages()

Renvoie une liste d'images de grande taille. Les applications ne sont pas tenues d'afficher cet élément, mais il est recommandé de le faire.

getMediaContent

public abstract @Nullable MediaContent getMediaContent()

Renvoie le MediaContent associé à cette annonce.

getMuteThisAdReasons

public abstract List<MuteThisAdReason> getMuteThisAdReasons()

Indique les raisons pour lesquelles l'utilisateur peut ignorer cette annonce. Utilisez la description textuelle de la classe pour l'afficher auprès de l'utilisateur.

getPrice

public abstract @Nullable String getPrice()

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

getResponseInfo

public abstract @Nullable ResponseInfo getResponseInfo()

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

getStarRating

public abstract @Nullable Double getStarRating()

Pour les annonces concernant des applications, renvoie une note sur cinq qui indique le nombre d'étoiles attribuées à l'application sur la plate-forme de téléchargement qui la propose. Les applications ne sont pas tenues d'afficher cet élément, mais il est recommandé de le faire.

getStore

public abstract @Nullable String getStore()

Pour les annonces concernant des applications, renvoie le nom de la plate-forme de téléchargement d'applications proposant l'application. (par exemple, "Google Play"). Les applications ne sont pas tenues d'afficher cet élément, mais il est recommandé de le faire.

isCustomClickGestureEnabled

public abstract boolean isCustomClickGestureEnabled()

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é. Si votre compte n'est pas ajouté à la liste d'autorisation pour cette fonctionnalité, la demande d'annonce ne sera pas satisfaite.

Indique si les clics peuvent être enregistrés à l'aide de gestes de clic personnalisés. Contactez votre responsable de compte pour ajouter votre bloc d'annonces à la liste d'autorisation de 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 façon programmatique.

Paramètres
MuteThisAdReason muteThisAdReason	Motif de masquage 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é lorsque l'utilisateur a cliqué sur l'annonce. Le bloc d'annonces doit être ajouté à la liste d'autorisation pour pouvoir utiliser cette API. 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 au moment du clic. Pour savoir comment créer les données de clic Bundle, consultez NativeAdConstants.

recordCustomClickGesture

public abstract void recordCustomClickGesture()

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 de geste de clic demandée dans enableCustomClickGestureDirection.

Indique les clics pour cette NativeAd à l'aide d'un geste de clic personnalisé. Pour pouvoir utiliser cette méthode, le bloc d'annonces doit être ajouté à la liste d'autorisation.

enableCustomClickGesture doit être appelé avant d'appeler cette méthode.

recordImpression

public abstract boolean recordImpression(Bundle impressionData)

Doit être appelé lors du premier affichage de l'annonce. Le bloc d'annonces doit être ajouté à la liste d'autorisation pour pouvoir utiliser cette API.

Paramètres
Bundle impressionData	bundle de l'environnement de l'application au moment de l'impression. Pour savoir comment créer les données de clic Bundle, consultez NativeAdConstants.

Renvoie
boolean	"true" si l'impression est correctement enregistrée

reportTouchEvent

public abstract void reportTouchEvent(Bundle touchEventData)

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

Paramètres
Bundle touchEventData	bundle des coordonnées et de la durée de l'é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 de l'annonce.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Enregistrez un rappel à appeler lorsque cette annonce aura généré des revenus estimés.

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

Définit UnconfirmedClickListener pour l'annonce.