Partager via

Mot clé

  • Article

Contient les méthodes de gestion d’un mot clé. Pour plus d’informations sur les mots clés, consultez Mot clé.

Méthodes

Nom de la méthode Type renvoyé Description
adParams AdParamSelector Obtient un sélecteur utilisé pour obtenir tous les paramètres de substitution utilisés dans l’annonce pour cette mot clé.
applyLabel(string name) void Applique l’étiquette à cette mot clé.
Enchères KeywordBidding Obtient les méthodes utilisées pour gérer le montant de l’offre de cette mot clé.
clearDestinationUrl void Supprime l’URL de destination de ce mot clé.
Activer void Active cette mot clé.
getAdGroup AdGroup Obtient le groupe d’annonces auquel appartient cette mot clé.
getApprovalStatus string Obtient la status d’approbation éditoriale de ce mot clé.
getCampaign Campagne Obtient la campagne à laquelle appartient cette mot clé.
getEntityType string Obtient le type de cette entité.
getFirstPageCpc double Obtient l’enchère estimée qui doit figurer sur la première page des résultats de la recherche.
getId string Obtient l’ID qui identifie de façon unique cette mot clé.
getMatchType string Obtient le type de correspondance de ce mot clé.
getQualityScore entier Obtient le score de qualité de ce mot clé.
getStats Stats Obtient les données de performances de ce mot clé.
Gettext string Obtient le texte du mot clé.
getTopOfPageCpc double Obtient l’enchère estimée nécessaire pour figurer en haut des résultats de la recherche.
isEnabled Valeur booléenne Obtient une valeur booléenne qui indique si cette mot clé est activée.
isPaused Valeur booléenne Obtient une valeur booléenne qui indique si cette mot clé est suspendue.
Étiquettes LabelSelector Obtient un sélecteur utilisé pour filtrer la liste des étiquettes associées à cette mot clé.
suspendre void Suspend cette mot clé.
remove void Supprime cette mot clé.
removeLabel(string name) void Supprime l’étiquette de cette mot clé.
setAdParam(int index, string insertionText) void Ajoute le paramètre de substitution et définit sa valeur sur le texte spécifié.
Url KeywordUrls Obtient les méthodes utilisées pour gérer les URL finales de ce mot clé, le modèle de suivi et les paramètres personnalisés.

adParams

Obtient un sélecteur de tous les paramètres de substitution utilisés dans les publicités pour cette mot clé.

Les valeurs de substitution sont utilisées dans une publicité si le titre, le texte, l’URL d’affichage ou l’URL de destination de l’annonce contient la chaîne de substitution dynamique {Param1}, {Param2} ou {Param3}.

Retourne

Type Description
AdParamSelector Sélecteur qui contient la liste des paramètres de substitution pour cette mot clé.

applyLabel(string name)

Applique l’étiquette au mot clé.

Vous pouvez appliquer un maximum de 50 étiquettes à un mot clé. Pour obtenir un exemple qui ajoute une étiquette à un mot clé, 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.

Enchères

Obtient les méthodes utilisées pour gérer le montant de l’offre de cette mot clé.

Retourne

Type Description
KeywordBidding Contient les méthodes utilisées pour gérer le montant de l’offre de cette mot clé.

clearDestinationUrl

Supprime l’URL de destination de ce mot clé.

Retourne

Type Description
void Renvoie la valeur nothing.

Activer

Active cette mot clé.

Retourne

Type Description
void Renvoie la valeur nothing.

getAdGroup

Obtient le groupe d’annonces auquel appartient cette mot clé.

Retourne

Type Description
AdGroup Groupe d’annonces auquel appartient cette mot clé.

getApprovalStatus

Obtient la status d’approbation éditoriale de ce mot clé.

Retourne

Type Description
string L’approbation éditoriale du mot clé status. Le status indique si l’mot clé est en cours d’examen, est approuvé ou n’est pas autorisé. Les valeurs possibles sont les suivantes :
  • APPROUVÉ
  • APPROVED_LIMITED
  • DÉSAPPROUVÉ
  • UNDER_REVIEW
Pour plus d’informations sur la façon dont ces valeurs status sont mappées à l’API Bing Ads, consultez Mappage des valeurs d’approbation éditoriale status.

getCampaign

Obtient la campagne à laquelle appartient cette mot clé.

Retourne

Type Description
Campagne Campagne à laquelle appartient cette mot clé.

getEntityType

Retourne le type de cette entité.

Retourne

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

getId

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

Retourne

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

getFirstPageCpc

Obtient l’enchère estimée nécessaire pour que l’annonce s’affiche dans la barre latérale.

Retourne

Type Description
double Estimation de l’enchère nécessaire pour que l’annonce s’affiche sur la barre latérale.

getMatchType

Obtient le type de correspondance de ce mot clé.

Retourne

Type Description
string Type de correspondance du mot clé. Les valeurs possibles sont les suivantes :
  • LARGE
  • PHRASE
  • EXACTE
Pour plus d’informations sur ces types, consultez Que sont les types de correspondance mot clé et comment les utiliser ?

getQualityScore

Obtient le score de qualité de ce mot clé.

Retourne

Type Description
entier Score de qualité du mot clé. Le score se situe entre 1 et 10 (le plus élevé). Si le score de qualité du mot clé ne peut pas être calculé, cette méthode retourne NULL.

Le score vous montre à quel point vos annonces sont compétitives sur la place de marché en mesurant la pertinence de vos mots clés et pages d’accueil par rapport aux termes de recherche des clients. Pour plus d’informations, consultez Rapport sur les performances des mots clés.

getStats

Obtient les données de performances de ces mots clés.

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

Retourne

Type Description
Stats Données de performances du mot clé. Par exemple, les clics et les impressions.

Gettext

Obtient le texte du mot clé. Le texte inclut la syntaxe du type de correspondance du mot clé, le cas échéant. Par exemple :

  • Le mot clé est books si le type de correspondance est large, ou +books si le mot clé utilise le modificateur de type large
  • Le mot clé est « books » si le type de correspondance est expression
  • Le mot clé est [livres à couverture rigide] si le type de correspondance est exact

Pour plus d’informations sur ces types, consultez Que sont les types de correspondance mot clé et comment les utiliser ?

Retourne

Type Description
string Texte du mot clé.

getTopOfPageCpc

Obtient l’enchère estimée nécessaire pour que l’annonce s’affiche au-dessus des résultats de recherche organiques.

Retourne

Type Description
double Estimation de l’offre nécessaire pour que l’annonce s’affiche au-dessus des résultats de recherche organiques.

isEnabled

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

Retourne

Type Description
Boolean A la valeur true si cette mot clé est activée ; sinon, false.

isPaused

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

Retourne

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

Étiquettes

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

Retourne

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

suspendre

Suspend cette mot clé.

Retourne

Type Description
void Renvoie la valeur nothing.

supprimez

Supprime cette mot clé.

Retourne

Type Description
void Renvoie la valeur nothing.

removeLabel(string name)

Supprime l’étiquette du mot clé.

Arguments

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

Retourne

Type Description
void Renvoie la valeur nothing.

setAdParam(int index, string insertionText)

Ajoute le paramètre de substitution et définit sa valeur sur le texte spécifié. Si le paramètre de substitution existe, son texte est remplacé.

Les valeurs de substitution sont utilisées dans une annonce si le titre, le texte, l’URL d’affichage ou l’URL finale de l’annonce contient les chaînes de substitution dynamiques {Param1}, {Param2} ou {Param3}. Pour plus d’informations sur l’utilisation de ces paramètres, consultez Param1, Param2 et Param3.

Les valeurs de substitution sont également utilisées dans le modèle de suivi si le modèle spécifie les espaces réservés {param1 :default}, {param2 :default} ou {param3 :default}.

Arguments

Nom Type Description
Index int Index du paramètre de substitution à définir. Les valeurs d’index valides sont comprises entre 1 et 3, inclus. Utilisez 1 pour Param1, 2 pour Param2 et 3 pour Param3.
insertionText string Texte sur lequel définir le paramètre de substitution.

Retourne

Type Description
void Renvoie la valeur nothing.

urls

Obtient les méthodes utilisées pour gérer les URL finales de ce mot clé, le modèle de suivi et les paramètres personnalisés.

Retourne

Type Description
KeywordUrls Contient les méthodes utilisées par les URL finales du mot clé, le modèle de suivi et les paramètres personnalisés.

Voir aussi