Partager via


Objet de données KeywordRecommendation - Ad Insight

Définit un objet de données KeywordRecommendation.

Syntaxe

<xs:complexType name="KeywordRecommendation" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:RecommendationBase">
      <xs:sequence>
        <xs:element minOccurs="0" name="Competition" type="xs:double" />
        <xs:element minOccurs="0" name="MatchType" type="xs:int" />
        <xs:element minOccurs="0" name="MonthlySearches" type="xs:long" />
        <xs:element minOccurs="0" name="SuggestedBid" type="xs:double" />
        <xs:element minOccurs="0" name="SuggestedKeyword" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet KeywordRecommendation contient les éléments suivants : Competition, MatchType, MonthlySearches, SuggestedBid, SuggestedKeyword.

Élément Description Type de données
Compétition Un indicateur d’enchères concurrentielles pour cette mot clé par rapport à tous les mots clés de recherche. Le score de la concurrence va de 0 à 1,00, où 0 indique une faible concurrence et 1,00 indique qu’il y a un grand nombre d’annonceurs en concurrence pour cette mot clé. Sortie uniquement. double
MatchType Type de correspondance auquel s’applique l’enchère suggérée. Sortie uniquement.

Voici les valeurs de type de correspondance possibles :
  • 1 - Correspondance exacte
  • 2 - Correspondance d’expression
  • 3 - Correspondance large
int
MonthlySearches Volume mensuel estimé de requêtes de recherche utilisateur qui peuvent correspondre à la mot clé suggérée pour l’élément MatchType correspondant. Sortie uniquement. long
SuggestedBid Offre suggérée qui peut entraîner la diffusion de vos annonces sur la première page des résultats de la requête de recherche. Sortie uniquement. double
SuggestedKeyword Le texte du mot clé (au maximum 80 caractères et 10 mots). Sortie uniquement. chaîne

L’objet KeywordRecommendation contient des éléments hérités.

Éléments hérités

Éléments hérités de RecommendationBase

L’objet KeywordRecommendation dérive de l’objet RecommendationBase et hérite des éléments suivants : AccountId, AccountName, AdGroupId, AdGroupName, CampaignId, CampaignName, CurrentClicks, CurrentConversions, CurrentCost, CurrentImpressions, Dismissed, EstimatedIncreaseInclicks, EstimatedIncreaseInConversions, EstimatedIncreaseInCost, EstimatedIncreaseInImpressions, RecommendationHash, RecommendationId, RecommendationType, Type. Les descriptions ci-dessous sont spécifiques à KeywordRecommendation et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet RecommendationBase .

Élément Description Type de données
AccountId Identificateur du compte. Sortie uniquement. long
AccountName Nom du compte. Sortie uniquement. chaîne
AdGroupId ID de groupe d’annonces ciblé par cette recommandation. Ce paramètre est défini uniquement lorsque la recommandation affecte un seul groupe d’annonces. Sortie uniquement.

Ce champ sera défini pour les types de recommandation suivants : MOT CLÉ, RESPONSIVE_SEARCH_AD.
long
AdGroupName Nom du groupe d’annonces. Sortie uniquement. chaîne
CampaignId ID de campagne ciblé par cette recommandation. Sortie uniquement.

Ce champ sera défini pour les types de recommandation suivants : MOT CLÉ, RESPONSIVE_SEARCH_AD
long
CampaignName Nom de la campagne. Sortie uniquement. chaîne
CurrentClicks Clics réels du groupe d’annonces au cours des 7 derniers jours. Sortie uniquement. long
CurrentConversions Conversions réelles du groupe d’annonces au cours des 7 derniers jours. Sortie uniquement. long
CurrentCost Dépenses réelles du groupe d’annonces au cours des 7 derniers jours, dans la devise de ce compte. double
CurrentImpressions Impressions réelles du groupe d’annonces au cours des 7 derniers jours. long
Fermé Si la recommandation est ignorée ou non. Sortie uniquement. boolean
EstimatedIncreaseInClicks Opportunités de clic estimées correspondant à l’annonce suggérée. long
EstimatedIncreaseInConversions Opportunités d’impression estimées correspondant à l’annonce suggérée. long
EstimatedIncreaseInCost Augmentation estimée des dépenses correspondant à l’annonce suggérée. double
EstimatedIncreaseInImpressions Les opportunités d’impressions estimées correspondant à l’annonce suggérée. long
RecommendationHash Hachage de la recommandation. chaîne
RecommendationId Identificateur de la recommandation. chaîne
RecommendationType Type de recommandation.

Remarque : Nous prenons actuellement en charge CAMPAIGN_BUDGET, MOT CLÉ et RESPONSIVE_SEARCH_AD. RecommendationType est une sortie uniquement.
chaîne
Type La valeur RecommendationType définie a les valeurs suivantes : CampaignBudgetRecommendation, KeywordRecommendation, ResponsiveSearchAdRecommendation. RecommendationType

Configuration requise

Service : AdInsightService.svc v13
Namespace: https://bingads.microsoft.com/AdInsight/v13