Annonce

Objet de base à partir duquel les annonces, telles que les annonces de texte développées, dérivent.

Cet objet représente également les annonces de texte standard. Vous ne pouvez plus créer d’annonces de texte standard, mais vous pouvez les récupérer, les suspendre, les supprimer et les activer. Les méthodes suivantes ne s’appliquent pas aux objets dérivés et ne doivent pas être appelées.

  • getDestinationUrl()
  • getDisplayUrl()
  • getHeadline()
  • isMobilePreferred()

Remarque

  • Mettez à niveau vos annonces de texte étendu vers des annonces de recherche réactives d’après le 1er février 2023. Après cette date, vous ne pourrez plus créer ou modifier des annonces textuelles développées existantes. Pour plus d’informations, consultez À propos des annonces de recherche réactives.
  • Les annonces textuelles développées existantes continueront de servir et vous pourrez afficher des rapports sur leurs performances.
  • Vous pourrez toujours suspendre, activer ou supprimer vos annonces texte développées. Dans le cas contraire, les tentatives d’ajout ou de mise à jour d’annonces de texte développées se solderont par une CampaignServiceAdTypeInvalid erreur.
  • En savoir plus sur cette modification.

Méthodes

Nom de la méthode Type renvoyé Description
applyLabel(string name) void Applique l’étiquette à cette annonce.
asType AdViewSpace Contient les méthodes utilisées pour convertir cette annonce en un type d’annonce spécifique.
Activer void Active cette annonce.
getAdGroup AdGroup Obtient le groupe d’annonces auquel cette annonce appartient.
getCampaign Campagne Obtient la campagne à laquelle cette annonce appartient.
getDescription string Obtient le texte de copie de cette annonce.
getDestinationUrl string Obtient l’URL de la page Web vers laquelle l’utilisateur est dirigé lorsqu’il clique sur l’annonce.
getDisplayUrl string Obtient l’URL affichée dans l’annonce.
getEntityType string Récupère le type de cette entité.
getHeadline string Obtient le titre de cette annonce.
getId string Obtient l’ID qui identifie de manière unique cette annonce.
getPolicyApprovalStatus string Obtient le status d’approbation éditoriale de cette annonce.
getStats Statistiques Obtient les données de performances de cette annonce.
getType string Obtient le type dérivé de cette annonce.
isEnabled valeur booléenne Obtient une valeur booléenne qui indique si cette annonce est activée.
isMobilePreferred valeur booléenne Obtient une valeur booléenne indiquant si la préférence est l’affichage de cette annonce sur les appareils mobiles ou sur tous les appareils.
isPaused Booléen Obtient une valeur booléenne qui indique si cette annonce est suspendue.
isType Espace AdTypeSpace Contient les méthodes utilisées pour tester si une annonce est du type spécifié.
Étiquettes Sélecteur d’étiquette Obtient un sélecteur utilisé pour filtrer la liste des étiquettes associées à cette annonce.
mettre en pause void Suspend cette annonce.
remove void Supprime cette annonce.
removeLabel(string name) void Supprime l’étiquette de cette annonce.
les URL AdUrls Contient les méthodes utilisées pour obtenir les URL finales, le modèle de suivi et les paramètres personnalisés de cette annonce.

applyLabel(string name)

Applique l’étiquette à l’annonce.

Vous pouvez appliquer un maximum de 50 étiquettes à une annonce. Pour obtenir un exemple qui ajoute une étiquette à une entité, consultez Utilisation d’étiquettes.

Arguments

Nom Type Description
name string Nom de l’étiquette qui respecte la casse. Pour obtenir la liste des étiquettes de ce compte que vous pouvez appliquer, consultez AdsApp.labels.

Retourne

Type Description
void Renvoie la valeur nothing.

asType

Contient les méthodes utilisées pour convertir cette annonce en un type d’annonce spécifique.

Retourne

Type Description
AdViewSpace Contient les méthodes utilisées pour convertir cette annonce en un type d’annonce spécifique.

Activer

Active cette annonce.

Retourne

Type Description
void Renvoie la valeur nothing.

getAdGroup

Obtient le groupe d’annonces auquel cette annonce appartient.

Retourne

Type Description
AdGroup Le groupe d’annonces auquel cette annonce appartient.

getCampaign

Obtient la campagne à laquelle cette annonce appartient.

Retourne

Type Description
Campagne La campagne à laquelle cette annonce appartient.

getDescription

Obtient le texte de copie de cette annonce.

Retourne

Type Description
string Texte du texte de l’annonce.

getDestinationUrl

Obtient l’URL de la page Web vers laquelle l’utilisateur est dirigé lorsqu’il clique sur l’annonce.

Retourne

Type Description
string URL de la page Web vers laquelle l’utilisateur est dirigé lorsqu’il clique sur l’annonce. Renvoie null s’il est appelé à partir d’un objet dérivé.

getDisplayUrl

Obtient l’URL affichée dans l’annonce.

Retourne

Type Description
string URL affichée dans l’annonce. Renvoie null s’il est appelé à partir d’un objet dérivé.

getEntityType

Récupère le type de cette entité.

Retourne

Type Description
string Type de cette entité, qui est Ad.

getHeadline

Obtient le titre de cette annonce.

Retourne

Type Description
string Titre de l’annonce. Renvoie null s’il est appelé à partir d’un objet dérivé.

getId

Obtient l’ID qui identifie de manière unique cette annonce.

Retourne

Type Description
string ID qui identifie de manière unique cette annonce.

getPolicyApprovalStatus

Obtient le status d’approbation éditoriale de cette annonce.

Retourne

Type Description
string Le status d’approbation éditoriale de l’annonce. Voici les valeurs possibles.
  • APPROUVÉ
  • APPROVED_LIMITED
  • UNDER_REVIEW
  • NON APPROUVÉ

getStats

Obtient les données de performances de cette annonce.

Pour appeler cette méthode, vous devez inclure l’une des méthodes dans la chaîne du sélecteur d’annoncesforDateRange.

Retourne

Type Description
Statistiques Les données de performance de l’annonce.

getType

Obtient le type dérivé de cette annonce.

Retourne

Type Description
string Type dérivé de cette annonce. Voici les types possibles.
  • EXPANDED_TEXT_AD
.

isEnabled

Obtient une valeur booléenne qui indique si cette annonce est activée.

Retourne

Type Description
valeur booléenne Est vrai si cette annonce est activée ; sinon, false.

isMobilePreferred

Obtient une valeur booléenne indiquant si la préférence est l’affichage de cette annonce sur les appareils mobiles ou sur tous les appareils.

Retourne

Type Description
valeur booléenne Est vrai si la préférence est que cette annonce s’affiche sur les appareils mobiles. Si la valeur est false, la préférence est que cette annonce s’affiche sur tous les appareils.

isPaused

Obtient une valeur booléenne qui indique si cette annonce est suspendue.

Retourne

Type Description
Booléen est vrai si cette annonce publicitaire est suspendue ; sinon, false.

isType

Contient les méthodes utilisées pour tester si une annonce est du type spécifié.

Retourne

Type Description
Espace AdTypeSpace Contient les méthodes utilisées pour tester si une annonce est du type spécifié.

Étiquettes

Obtient un sélecteur utilisé pour filtrer la liste des étiquettes associées à cette annonce.

Retourne

Type Description
Sélecteur d’étiquette Sélecteur utilisé pour filtrer la liste des étiquettes associées à cette annonce.

mettre en pause

Suspend cette annonce.

Retourne

Type Description
void Renvoie la valeur nothing.

remove

Supprime cette annonce.

Retourne

Type Description
void Renvoie la valeur nothing.

removeLabel(string name)

Supprime l’étiquette de l’annonce.

Arguments

Nom Type Description
name string Nom de l’étiquette qui respecte la casse. Pour obtenir la liste des étiquettes associées à cette annonce, voir Étiquettes.

Retourne

Type Description
void Renvoie la valeur nothing.

urls

Contient les méthodes utilisées pour obtenir les URL finales, le modèle de suivi et les paramètres personnalisés de cette annonce.

Retourne

Type Description
AdUrls Objet utilisé pour obtenir les URL finales, le modèle de suivi et les paramètres personnalisés de cette annonce.

Voir aussi

  • Dernière mise à jour :