Mot clé

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

Méthodes

Nom de la méthode Type renvoyé Description
paramètres adParams AdParamSelector Obtient un sélecteur utilisé pour obtenir tous les paramètres de substitution utilisés dans l’annonce pour ce mot clé.
applyLabel(string name) void Applique l’étiquette à ce mot clé.
enchère KeywordBidding Obtient les méthodes utilisées pour gérer le montant de l’enchère de ce mot clé.
clearDestinationUrl void Supprime l’URL de destination de ce mot clé.
Activer void Active ce mot clé.
getAdGroup AdGroup Obtient le groupe d’annonces auquel ce mot clé appartient.
getApprovalStatus string Obtient le status d’approbation éditoriale de ce mot clé.
getCampaign Campagne Obtient la campagne à laquelle ce mot clé appartient.
getEntityType string Récupère le type de cette entité.
getFirstPageCpc double Récupère l’enchère estimée nécessaire pour figurer sur la première page des résultats de recherche.
getId string Obtient l’ID qui identifie de manière unique ce 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 Statistiques 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 tête des résultats de recherche.
isEnabled Booléen Obtient une valeur booléenne indiquant si ce mot clé est activé.
isPaused Booléen Obtient une valeur booléenne qui indique si ce mot clé est en pause.
Étiquettes Sélecteur d’étiquette Obtient un sélecteur utilisé pour filtrer la liste des étiquettes associées à ce mot clé.
mettre en pause void Met en pause ce mot clé.
remove void Supprime ce mot clé.
removeLabel(string name) void Supprime l’étiquette de ce mot clé.
setAdParam(int index, string insertionText) void Ajoute le paramètre de substitution et définit sa valeur sur le texte spécifié.
les URL KeywordUrls Obtient les méthodes utilisées pour gérer les URL finales, le modèle de suivi et les paramètres personnalisés de ces mots clés.

paramètres adParams

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

Les valeurs de substitution sont utilisées dans une annonce 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 ce mot clé.

applyLabel(string name)

Applique l’étiquette au mot clé.

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

enchère

Obtient les méthodes utilisées pour gérer le montant de l’enchère de ce mot clé.

Retourne

Type Description
KeywordBidding Contient les méthodes utilisées pour gérer le montant de l’enchère de ce mot clé.

clearDestinationUrl

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

Retourne

Type Description
void Renvoie la valeur nothing.

Activer

Active ce mot clé.

Retourne

Type Description
void Renvoie la valeur nothing.

getAdGroup

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

Retourne

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

getApprovalStatus

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

Retourne

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

getCampaign

Obtient la campagne à laquelle ce mot clé appartient.

Retourne

Type Description
Campagne La campagne à laquelle ce mot clé appartient.

getEntityType

Retourne le type de cette entité.

Retourne

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

getId

Obtient l’ID qui identifie de manière unique ce mot clé.

Retourne

Type Description
string ID qui identifie de manière unique ce 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 Enchère estimée nécessaire pour que l’annonce s’affiche dans 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 :
  • REQUÊTE LARGE
  • PHRASE
  • EXACTE
Pour plus d’informations sur ces types, voir Que sont les types de correspondance de mots clés et comment les utiliser ?

getQualityScore

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

Retourne

Type Description
entier Niveau de qualité du mot clé. Le score est compris entre 1 et 10 (le plus élevé). Si le niveau de qualité du mot clé ne peut pas être calculé, cette méthode renvoie la valeur NULL.

Le score vous permet d’évaluer le potentiel concurrentiel de vos annonces sur le marché en mesurant les performances de vos mots clés et pages de destination par rapport aux termes de recherche de vos clients. Pour plus d’informations, consultez Rapport de 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 méthodes dans la chaîne du sélecteur de forDateRangemot clé.

Retourne

Type Description
Statistiques 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 de type de correspondance du mot clé, le cas échéant. Par exemple :

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

Pour plus d’informations sur ces types, voir Que sont les types de correspondance de mots clés 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 organique.

Retourne

Type Description
double Enchère estimée nécessaire pour que l’annonce s’affiche au-dessus des résultats de recherche organique.

isEnabled

Obtient une valeur booléenne indiquant si ce mot clé est activé.

Retourne

Type Description
Booléen Est vrai si ce mot clé est activé ; sinon, faux.

isPaused

Obtient une valeur booléenne qui indique si ce mot clé est en pause.

Retourne

Type Description
Booléen Est vrai si ce mot clé est en pause ; sinon, faux.

Étiquettes

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

Retourne

Type Description
Sélecteur d’étiquette Sélecteur utilisé pour filtrer la liste des étiquettes associées à ce mot clé.

mettre en pause

Met en pause ce mot clé.

Retourne

Type Description
void Renvoie la valeur nothing.

remove

Supprime ce 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 qui respecte la casse. Pour obtenir la liste des étiquettes associées à ce mot clé, voir É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 dynamique {Param1}, {Param2} ou {Param3}. Pour connaître les restrictions et les informations relatives à l’utilisation de ces paramètres, voir Param1, Param2 et Param3.

Les valeurs de substitution sont également utilisées dans le modèle de suivi si celui-ci 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. Utilisez 1 pour le paramètre 1, 2 pour le paramètre 2 et 3 pour le paramètre 3.
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, le modèle de suivi et les paramètres personnalisés de ces mots clés.

Retourne

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

Voir aussi

  • Dernière mise à jour :