Partager via

Ad

  • Article

Objet de base dont dérivent les publicités, telles que les publicités de texte développées.

Cet objet représente également des annonces texte standard. Vous ne pouvez plus créer d’annonces 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 textuelles développées en annonces de recherche réactives d’après le 1er février 2023. Après cette date, vous ne serez plus en mesure de créer ou de modifier des annonces textuelles développées existantes. Pour plus d’informations, consultez À propos des annonces de recherche réactive.
  • Les annonces textuelles développées existantes continueront à être diffusées et vous serez en mesure d’afficher des rapports sur leurs performances.
  • Vous pourrez toujours suspendre, activer ou supprimer vos annonces textuelles développées. Dans le cas contraire, les tentatives d’ajout ou de mise à jour d’annonces textuelles développées entraînent 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 publicité.
getAdGroup AdGroup Obtient le groupe d’annonces auquel cette annonce appartient.
getCampaign Campagne Obtient la campagne à laquelle cette publicité 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 redirigé lorsqu’il clique sur la publicité.
getDisplayUrl string Obtient l’URL affichée dans l’annonce.
getEntityType string Obtient le type de cette entité.
getHeadline string Obtient le titre de cette annonce.
getId string Obtient l’ID qui identifie de façon unique cette publicité.
getPolicyApprovalStatus string Obtient le status d’approbation éditoriale de cette publicité.
getStats Stats Obtient les données de performances de cette publicité.
Gettype chaîne Obtient le type dérivé de cette publicité.
Isenabled valeur booléenne Obtient une valeur booléenne qui indique si cette publicité est activée.
isMobilePreferred valeur booléenne Obtient une valeur booléenne qui indique si la préférence est d’afficher cette publicité sur les appareils mobiles ou sur tous les appareils.
isPaused Valeur booléenne Obtient une valeur booléenne qui indique si cette publicité est suspendue.
isType AdTypeSpace Contient les méthodes utilisées pour tester si une annonce est du type spécifié.
Étiquettes LabelSelector Obtient un sélecteur utilisé pour filtrer la liste des étiquettes associées à cette publicité.
suspendre void Met en pause cette annonce.
remove void Supprime cette publicité.
removeLabel(string name) void Supprime l’étiquette de cette annonce.
Url AdUrls Contient les méthodes utilisées pour obtenir les URL finales de cette publicité, le modèle de suivi et les paramètres personnalisés.

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 respectant 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 publicité.

Retourne

Type Description
void Renvoie la valeur nothing.

getAdGroup

Obtient le groupe d’annonces auquel cette annonce appartient.

Retourne

Type Description
AdGroup Groupe d’annonces auquel cette annonce appartient.

getCampaign

Obtient la campagne à laquelle cette publicité appartient.

Retourne

Type Description
Campagne Campagne à laquelle cette publicité appartient.

getDescription

Obtient le texte de copie de cette annonce.

Retourne

Type Description
string Texte de copie de l’annonce.

getDestinationUrl

Obtient l’URL de la page web vers laquelle l’utilisateur est redirigé lorsqu’il clique sur la publicité.

Retourne

Type Description
string URL de la page web vers laquelle l’utilisateur est redirigé lorsqu’il clique sur la publicité. Retourne null si elle est appelée à 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. Retourne null si elle est appelée à partir d’un objet dérivé.

getEntityType

Obtient le type de cette entité.

Retourne

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

getHeadline

Obtient le titre de cette annonce.

Retourne

Type Description
string Titre de l’annonce. Retourne null si elle est appelée à partir d’un objet dérivé.

getId

Obtient l’ID qui identifie de façon unique cette publicité.

Retourne

Type Description
string ID qui identifie de façon unique cette publicité.

getPolicyApprovalStatus

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

Retourne

Type Description
string L’approbation éditoriale de l’annonce status. Voici les valeurs possibles.
  • APPROUVÉ
  • APPROVED_LIMITED
  • UNDER_REVIEW
  • DÉSAPPROUVÉ

getStats

Obtient les données de performances de cette publicité.

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

Retourne

Type Description
Stats Données de performances de l’annonce.

Gettype

Obtient le type dérivé de cette publicité.

Retourne

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

isEnabled

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

Retourne

Type Description
valeur booléenne A la valeur true si cette publicité est activée ; sinon, false.

isMobilePreferred

Obtient une valeur booléenne qui indique si la préférence est d’afficher cette publicité sur les appareils mobiles ou sur tous les appareils.

Retourne

Type Description
valeur booléenne A la valeur true si la préférence est d’afficher cette publicité 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 publicité est suspendue.

Retourne

Type Description
Boolean A la valeur true si cette annonce est suspendue ; sinon, false.

isType

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

Retourne

Type Description
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 publicité.

Retourne

Type Description
LabelSelector Sélecteur utilisé pour filtrer la liste des étiquettes associées à cette publicité.

suspendre

Met en pause cette annonce.

Retourne

Type Description
void Renvoie la valeur nothing.

supprimez

Supprime cette publicité.

Retourne

Type Description
void Renvoie la valeur nothing.

removeLabel(string name)

Supprime l’étiquette de la publicité.

Arguments

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

Retourne

Type Description
void Renvoie la valeur nothing.

urls

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

Retourne

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

Voir aussi