Partager via

Objet de données de mot clé - Gestion des campagnes

  • Article

Définit un mot clé.

Les mots clés sont les mots ou expressions recherchés lors de la recherche d’un produit ou d’un service. Par exemple, les mots clés peuvent être l’un des suivants :

  • Chaussures
  • Bateaux croisières vacances
  • Cours de tennis à New York

Comme indiqué ci-dessus, un mot clé peut être un seul mot, plusieurs mots ou même une phrase. Dans le contexte de la publicité de recherche, tous ces éléments sont simplement appelés mot clé.

Importante

Depuis avril 2021, vous ne pouvez pas définir de stratégies d’enchères pour les groupes d’annonces ou les mots clés. Si vous essayez de définir des stratégies d’enchère pour des groupes d’annonces ou des mots clés, la demande est ignorée sans erreur. Les groupes d’annonces et les mots clés héritent de la stratégie d’enchère de leur campagne.

Syntaxe

<xs:complexType name="Keyword" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Bid" nillable="true" type="tns:Bid" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:KeywordEditorialStatus" />
    <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
    <xs:element xmlns:q32="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q32:ArrayOfstring" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q33="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q33:ArrayOfstring" />
    <xs:element xmlns:q34="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q34:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MatchType" nillable="true" type="tns:MatchType" />
    <xs:element minOccurs="0" name="Param1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param3" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:KeywordStatus" />
    <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
  </xs:sequence>
</xs:complexType>

Éléments

L’objet Keyword contient les éléments suivants : Bid, BiddingScheme, DestinationUrl, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, MatchType, Param1, Param2, Param3, Status, Text, TrackingUrlTemplate, UrlCustomParameters.

Élément Description Type de données
Offre Montant maximal que vous souhaitez payer chaque fois qu’un utilisateur clique sur votre annonce.

Vous enchériez contre d’autres annonceurs en utilisant la même mot clé. Par conséquent, en général, des enchères plus élevées vous aident à faire en sorte que votre annonce s’affiche dans des emplacements plus souhaitables sur la page des résultats de recherche.

Au lieu d’utiliser l’enchère par défaut au niveau du groupe d’annonces, vous pouvez définir des enchères personnalisées pour chaque mot clé. Les enchères personnalisées pour les mots clés remplacent l’enchère par défaut du groupe d’annonces pour ces mots clés spécifiques. Avec les enchères personnalisées, vous pouvez concentrer votre temps et votre argent sur les mots clés les plus rentables, mais vous devrez consacrer plus de temps à la gestion des enchères individuelles.

Si l’enchère de niveau mot clé n’est pas définie, le groupe d’annonces CpcBid est utilisé. Pour plus d’informations, consultez Stratégies de budget et d’enchère.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer l’enchère mot clé et utiliser l’enchère de type de correspondance AdGroup par défaut, définissez l’élément Amount de l’objet Bid sur null.		 Offre
BiddingScheme Type de stratégie d’enchère pour la façon dont vous souhaitez gérer vos enchères.

Pour plus d’informations sur les stratégies d’enchère prises en charge par type de campagne, consultez Stratégies de budget et d’enchère.

NOTE: Depuis avril 2021, vous ne pouvez pas définir de stratégies d’enchères pour les groupes d’annonces ou les mots clés. Si vous essayez de définir des stratégies d’enchère pour des groupes d’annonces ou des mots clés, la demande est ignorée sans erreur. Les groupes d’annonces et les mots clés héritent de la stratégie d’enchère de leur campagne.

Ajouter: Optionnel. Si vous ne définissez pas cet élément, InheritFromParentBiddingScheme est utilisé par défaut.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 BiddingScheme
DestinationUrl URL de la page web vers laquelle l’utilisateur doit être connecté lorsqu’il clique sur la publicité. L’URL de destination de l’mot clé est utilisée si elle est spécifiée ; sinon, l’URL de destination de l’annonce est utilisée.

Important: Depuis novembre 2018, l’URL de destination mot clé ne peut plus être ajoutée ou mise à jour. Vous pouvez utiliser les URL finales à la place. Pour plus d’informations, consultez Migration de vos URL de destination mot clé vers les URL finales.

Ajouter: Non autorisé
Mettre à jour: Non autorisé		 chaîne
EditorialStatus La révision éditoriale status du mot clé, qui indique si la mot clé est en attente d’examen, a été approuvée ou a été désapprouvée.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 KeywordEditorialStatus
FinalAppUrls Pour une utilisation ultérieure. Tableau AppUrl
FinalMobileUrls URL de la page d’accueil mobile. L’URL mobile finale de l’mot clé est utilisée si elle est spécifiée ; sinon, l’URL mobile finale de l’annonce est utilisée.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 tableau de chaînes
FinalUrls URL de la page d’accueil. L’URL finale de l’mot clé est utilisée si elle est spécifiée ; sinon, l’URL finale de l’annonce est utilisée.

Les règles de validation suivantes s’appliquent aux URL finales et aux URL mobiles finales.
- La longueur de l’URL est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères.
- Vous pouvez spécifier jusqu’à 10 éléments pour FinalUrls et FinalMobileUrls ; Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service en autorise jusqu’à 10 pour une compatibilité descendante potentielle.
- L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple {lpurl}.
- Les URL finales doivent chacune être une URL bien formée commençant par http:// ou https://.
- Si vous spécifiez FinalMobileUrls, vous devez également spécifier FinalUrls.
- Vous ne pouvez pas spécifier FinalMobileUrls si la préférence d’appareil est définie sur mobile. Notez également que si les éléments TrackingUrlTemplate ou UrlCustomParameters sont définis, au moins une URL finale est requise. Pour plus d’informations, consultez Suivi des URL avec des URL mises à niveau.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 tableau de chaînes
FinalUrlSuffix Le suffixe d’URL final peut inclure des paramètres de suivi qui seront ajoutés à la fin de l’URL de votre page d’accueil. Nous vous recommandons de placer les paramètres de suivi requis par votre page d’accueil dans un suffixe d’URL final afin que vos clients soient toujours envoyés à votre page d’accueil. Pour plus d’informations et les règles de validation, consultez Suffixe d’URL final dans les guides techniques.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.		 chaîne
ForwardCompatibilityMap Liste des chaînes de clé et de valeur pour la compatibilité avant afin d’éviter les changements cassants lorsque de nouveaux éléments sont ajoutés dans la version actuelle de l’API.

Les modifications de compatibilité avant seront notées ici dans les versions ultérieures. Il n’existe actuellement aucune modification de compatibilité avant pour cet objet.		 Tableau KeyValuePairOfstringstring
ID Identificateur généré par le système de l’mot clé.

Ajouter: En lecture seule
Mettre à jour: Obligatoire		 long
MatchType Type de correspondance pour comparer le mot clé et le terme de recherche de l’utilisateur.

Ajouter: Obligatoire
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 MatchType
Param1 Chaîne à utiliser comme valeur de substitution dans une annonce si le titre, le texte, l’URL d’affichage ou l’URL de destination de la publicité contient la chaîne de substitution dynamique {Param1}.

Bien que vous puissiez utiliser {Param1} pour spécifier l’URL de destination d’une annonce, nous vous encourageons à ne pas le faire. Au lieu de cela, vous devez définir l’élément DestinationUrl du mot clé.

La chaîne peut contenir un maximum de 1 022 caractères. La limite réelle dépend de la longueur de l’élément qui fait référence à la chaîne de substitution. Par exemple, la longueur du titre d’une annonce de texte peut contenir un maximum de 25 caractères.

Lorsque vous implémentez du texte dynamique dans votre copie publicitaire, vous devez fournir une chaîne par défaut, par exemple {Param1 :default} que le système utilisera si Param1 pour une mot clé est null ou vide, ou si l’inclusion de la valeur de substitution Param1 entraîne le dépassement de la limite de l’élément ; sinon, l’annonce ne sera pas utilisée avec cette mot clé. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique.

Notez également que si le groupe d’annonces n’a qu’une seule annonce et que cette annonce utilise {Param1} mais ne fournit pas de chaîne par défaut, par exemple{Param1 :default}, vous devez fournir une valeur Param1 valide pour cette substitution. Sinon, cette mot clé ne peut pas être ajoutée ou mise à jour.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.		 chaîne
Param2 Chaîne à utiliser comme valeur de substitution dans une publicité si le titre, le texte, l’URL d’affichage ou l’URL de destination contient la chaîne de substitution dynamique {Param2}.

En règle générale, vous utilisez la chaîne de substitution {Param2} dans les éléments title ou text (description de copie d’annonce) d’une annonce.

La chaîne peut contenir un maximum de 70 caractères. La limite réelle dépend de la longueur de l’élément qui fait référence à la chaîne de substitution. Par exemple, la longueur du titre d’une annonce de texte peut contenir un maximum de 25 caractères.

Lorsque vous implémentez du texte dynamique dans votre copie publicitaire, vous devez fournir une chaîne par défaut, par exemple{Param2 :default} que le système utilisera si Param2 pour un mot clé est null ou vide, ou si l’inclusion de la valeur de substitution Param2 entraîne le dépassement de la limite de l’élément ; sinon, l’annonce ne sera pas utilisée avec cette mot clé. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique.

Notez également que si le groupe d’annonces n’a qu’une seule annonce et que cette annonce utilise {Param2} mais ne fournit pas de chaîne par défaut, par exemple{Param2 :default}, vous devez fournir une valeur Param2 valide pour cette substitution. Sinon, cette mot clé ne peut pas être ajoutée ou mise à jour.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.		 chaîne
Param3 Chaîne à utiliser comme valeur de substitution dans une annonce si le titre, le texte, l’URL d’affichage ou l’URL de destination contient la chaîne de substitution dynamique {Param3}.

En règle générale, vous utilisez la chaîne de substitution {Param3} dans les éléments title ou text (description de copie d’annonce) d’une annonce.

La chaîne peut contenir un maximum de 70 caractères. La limite réelle dépend de la longueur de l’élément qui fait référence à la chaîne de substitution. Par exemple, la longueur du titre d’une annonce de texte peut contenir un maximum de 25 caractères.

Lorsque vous implémentez du texte dynamique dans votre copie d’annonce, vous devez fournir une chaîne par défaut, par exemple {Param3 :default} que le système utilisera si Param3 pour un mot clé est null ou vide, ou si l’inclusion de la valeur de substitution Param3 entraîne le dépassement de la limite de l’élément ; sinon, l’annonce ne sera pas utilisée avec cette mot clé. Pour plus d’informations, consultez l’article d’aide Microsoft Advertising Personnaliser automatiquement vos annonces avec des paramètres de texte dynamique.

Notez également que si le groupe d’annonces n’a qu’une seule annonce et que cette annonce utilise {Param3} mais ne fournit pas de chaîne par défaut, par exemple{Param3 :default}, vous devez fournir une valeur Param3 valide pour cette substitution. Sinon, cette mot clé ne peut pas être ajoutée ou mise à jour.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.		 chaîne
Statut Le mot clé est status. Par défaut, le status est défini sur Actif.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 KeywordStatus
SMS Texte mot clé. Le texte peut contenir un maximum de 100 caractères. Vous devez spécifier le mot clé dans les paramètres régionaux de la valeur Language que vous avez spécifiée pour le groupe d’annonces auquel appartient le mot clé.

Ajouter: Obligatoire
Mettre à jour: En lecture seule		 chaîne
TrackingUrlTemplate Modèle de suivi à utiliser comme valeur par défaut pour tous les FinalUrls et FinalMobileUrls.

Les règles de validation suivantes s’appliquent aux modèles de suivi. Pour plus d’informations sur les modèles et paramètres pris en charge, consultez l’article d’aide Microsoft Advertising Quels paramètres de suivi ou d’URL puis-je utiliser ?
- Les modèles de suivi définis pour les entités de niveau inférieur, par exemple, les publicités remplacent celles définies pour les entités de niveau supérieur, par exemple la campagne. Pour plus d’informations, consultez Limites d’entité.
- La longueur du modèle de suivi est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères.
- Le modèle de suivi doit être une URL bien formée commençant par l’une des suivantes : http://, https://, {lpurl} ou {unscapedlpurl}.
- Microsoft Advertising ne valide pas l’existence de paramètres personnalisés. Si vous utilisez des paramètres personnalisés dans votre modèle de suivi et qu’ils n’existent pas, l’URL de la page d’accueil inclut les espaces réservés de clé et de valeur de vos paramètres personnalisés sans substitution. Par exemple, si votre modèle de suivi est https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} et que ni {_season} ni {_promocode} ne sont définis au niveau de la campagne, du groupe d’annonces, du critère, du mot clé ou de la publicité, l’URL de la page d’accueil sera la même.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.		 chaîne
UrlCustomParameters Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL.

Microsoft Advertising accepte les 8 premiers objets CustomParameter que vous incluez dans l’objet CustomParameters , et si vous incluez plus de 8 paramètres personnalisés, une erreur est retournée. Chaque CustomParameter comprend des éléments Key et Value .

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Définissez l’élément UrlCustomParameters sur null ou vide pour conserver tous les paramètres personnalisés existants. Pour supprimer tous les paramètres personnalisés, définissez l’élément Parameters de l’objet CustomParameters sur null ou vide. Pour supprimer un sous-ensemble de paramètres personnalisés, spécifiez les paramètres personnalisés que vous souhaitez conserver dans l’élément Parameters de l’objet CustomParameters .		 CustomParameters

Configuration requise

Service : CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Utilisé par

AddKeywords
GetKeywordsByAdGroupId
GetKeywordsByEditorialStatus
GetKeywordsByIds
UpdateKeywords