KeywordIdea Data Object - Ad Insight

Article
12/21/2023

Définit un objet qui contient un mot clé suggéré avec des statistiques historiques, telles que le volume de recherche mensuel, la concurrence, l’offre minimale suggérée et le partage d’impression publicitaire.

Syntaxe

<xs:complexType name="KeywordIdea" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdGroupId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="AdGroupName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="AdImpressionShare" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="Competition" nillable="true" type="tns:CompetitionLevel" />
    <xs:element minOccurs="0" name="Keyword" nillable="true" type="xs:string" />
    <xs:element xmlns:q24="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="MonthlySearchCounts" nillable="true" type="q24:ArrayOflong" />
    <xs:element minOccurs="0" name="Relevance" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="Source" nillable="true" type="tns:SourceType" />
    <xs:element minOccurs="0" name="SuggestedBid" nillable="true" type="xs:double" />
  </xs:sequence>
</xs:complexType>

Éléments

L’objet KeywordIdea contient les éléments suivants : AdGroupId, AdGroupName, AdImpressionShare, Competition, Keyword, MonthlySearchCounts, Relevance, Source, SuggestedBid.

Élément	Description	Type de données
AdGroupId	Identificateur de groupe d’annonces négatif qui regroupe mot clé idées dans de nouveaux groupes d’annonces suggérés. Les idées de mots clés pour les identificateurs de groupe d’annonces existants ne sont pas prises en charge. Si l’ID du groupe d’annonces est null, l’élément Source d’idée mot clé est défini sur Seed, et il n’existe aucun groupe d’annonces recommandé spécifique.	Long
AdGroupName	Nom suggéré du groupe d’annonces pour l’idée de mot clé. Si le nom du groupe d’annonces est null, l’élément Source d’idée mot clé est défini sur Seed et il n’existe aucun groupe d’annonces recommandé spécifique.	chaîne
AdImpressionShare	Le partage d’impression publicitaire correspond au nombre d’impressions que vous avez reçues, divisé par le nombre total de recherches pour l’emplacement et le réseau que vous ciblez qui correspondaient exactement aux mot clé exactement au cours du dernier mois calendaire.	Double
Concurrence	Déterminé par le nombre d’annonceurs qui soumissionnent sur cette mot clé, par rapport à tous les autres mots clés dans Microsoft Advertising.	CompetitionLevel
Mot clé	Mot clé suggéré.	chaîne
MonthlySearchCounts	Nombre de fois où cette mot clé a été utilisée comme terme de recherche pour chaque mois dans la plage de dates et les paramètres de ciblage que vous avez sélectionnés. Par défaut, la taille de la liste est de 12 et les 12 derniers mois de données disponibles sont retournés. Les nombres de recherches sont triés dans l’ordre en commençant par les données du mois le plus récent à l’adresse `MonthlySeachCounts[0]`. La disponibilité des données du mois calendaire précédent peut prendre jusqu’à 72 heures. Par exemple, si vous demandez mot clé idées le 1er, 2 ou 3 août et que les données de juillet ne sont pas prêtes, la réponse sera basée sur les données de juin. Si vous n’incluez pas dateRangeSearchParameter dans la requête GetKeywordIdeas , vous ne pourrez pas confirmer si le premier élément de liste est des données du mois précédent ou du mois précédent. Si la plage de dates est spécifiée et que les données du mois le plus récent ne sont pas encore disponibles, GetKeywordIdeas retourne une erreur.	tableau long
Pertinence	Score de pertinence mot clé. Une pertinence plus élevée signifie « plus pertinente ». Il n’existe aucune plage définie, mais, par exemple, vous pouvez voir des valeurs telles que 1,00 ou 87 083,82. Bien que les valeurs ne soient pas affichées, la pertinence est utilisée pour trier les résultats du planificateur de mots clés par pertinence dans l’interface utilisateur Microsoft Advertising.	Double
Source	Source ou valeur initiale de l’mot clé.	SourceType
SuggestedBid	Offre minimale suggérée pour cette mot clé. Nous créons cette suggestion en utilisant le critère de localisation et de réseau que vous avez inclus, ainsi que les annonceurs au coût moyen par clic (CPC) qui paient pour cette mot clé. Ce montant n’est qu’une estimation et votre CPP réelle peut varier.	Double

Configuration requise

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

Utilisé par

GetKeywordIdeas

Partager via