KeywordRecommendation Data Object - Ad Insight

Define um objeto de dados KeywordRecommendation.

Sintaxe

XML

<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>

JSON

{
  "AccountId": "LongValueHere",
  "AccountName": "ValueHere",
  "AdGroupId": "LongValueHere",
  "AdGroupName": "ValueHere",
  "CampaignId": "LongValueHere",
  "CampaignName": "ValueHere",
  "CurrentClicks": "LongValueHere",
  "CurrentConversions": "LongValueHere",
  "CurrentCost": DoubleValueHere,
  "CurrentImpressions": "LongValueHere",
  "Dismissed": "ValueHere",
  "EstimatedIncreaseInClicks": "LongValueHere",
  "EstimatedIncreaseInConversions": "LongValueHere",
  "EstimatedIncreaseInCost": DoubleValueHere,
  "EstimatedIncreaseInImpressions": "LongValueHere",
  "RecommendationHash": "ValueHere",
  "RecommendationId": "ValueHere",
  "RecommendationType": "ValueHere",
  "Type": "KeywordRecommendation",
  "Competition": DoubleValueHere,
  "MatchType": IntValueHere,
  "MonthlySearches": "LongValueHere",
  "SuggestedBid": DoubleValueHere,
  "SuggestedKeyword": "ValueHere"
}

Elementos

O objeto KeywordRecommendation tem os seguintes elementos: Competition, MatchType, MonthlySearches, SuggestedBid, SuggestedKeyword.

Elemento	Descrição	Tipo de Dados
Competição	Um indicador de ofertas competitivas para esta palavra-chave relativamente a todas as palavras-chave de pesquisa. A pontuação da competição varia entre 0 e 1,00, em que 0 indica baixa concorrência e 1,00 indica que há um elevado número de anunciantes a competir por esta palavra-chave. Apenas saída.	duplo
Tipo de Correspondência	O tipo de correspondência a que a oferta sugerida se aplica. Apenas saída. Seguem-se os possíveis valores de tipo de correspondência: 1 - Correspondência exata 2 - Correspondência de expressões 3 - Jogo amplo	int
Pesquisa Mensal	O volume mensal estimado de consultas de pesquisa de utilizadores que podem corresponder à palavra-chave sugerida para o elemento MatchType correspondente. Apenas saída.	Longo
SuggestedBid	A oferta sugerida que pode resultar na apresentação de anúncios na primeira página dos resultados da consulta de pesquisa. Apenas saída.	duplo
Palavra-chave sugerida	O texto da palavra-chave (no máximo, 80 carateres e 10 palavras). Apenas saída.	cadeia

O objeto KeywordRecommendation tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do RecommendationBase

O objeto KeywordRecommendation deriva do objeto RecommendationBase e herda os seguintes elementos: AccountId, AccountName, AdGroupId, AdGroupName, CampaignId, CampaignName, CurrentClicks, CurrentConversions, CurrentCost, CurrentImpressions, Dismissed, EstimatedIncreaseInClicks, EstimatedIncreaseInConversions, EstimatedIncreaseInCost, EstimatedIncreaseInImpressions, RecommendationHash, RecommendationId, RecommendationType, Type. As descrições abaixo são específicas de KeywordRecommendation e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto RecommendationBase .

Elemento	Descrição	Tipo de Dados
AccountId	O identificador da conta. Apenas saída.	Longo
AccountName	O nome da conta. Apenas saída.	cadeia
AdGroupId	O ID do grupo de anúncios visado por esta recomendação. Esta definição só será definida quando a recomendação afetar um único grupo de anúncios. Apenas saída. Este campo será definido para os seguintes tipos de recomendação: KEYWORD, RESPONSIVE_SEARCH_AD.	Longo
AdGroupName	O nome do grupo de anúncios. Apenas saída.	cadeia
CampaignId	O ID da campanha visado por esta recomendação. Apenas saída. Este campo será definido para os seguintes tipos de recomendação: KEYWORD, RESPONSIVE_SEARCH_AD	Longo
CampaignName	O nome da campanha. Apenas saída.	cadeia
CurrentClicks	Cliques reais do grupo de anúncios nos últimos 7 dias. Apenas saída.	Longo
CurrentConversions	Conversões reais do grupo de anúncios nos últimos 7 dias. Apenas saída.	Longo
CurrentCost	Gastos reais do grupo de anúncios nos últimos 7 dias, na moeda desta conta.	duplo
CurrentImpressions	Impressões reais do grupo de anúncios nos últimos 7 dias.	Longo
Dispensado	Se a recomendação é dispensada ou não. Apenas saída.	booleano
EstimatedIncreaseInClicks	As oportunidades de clique estimadas correspondentes ao anúncio sugerido.	Longo
EstimatedIncreaseInConversions	As oportunidades de impressão estimadas correspondentes ao anúncio sugerido.	Longo
EstimatedIncreaseInCost	O aumento estimado dos gastos correspondente ao anúncio sugerido.	duplo
EstimatedIncreaseInImpressions	As oportunidades de impressões estimadas correspondentes ao anúncio sugerido.	Longo
RecommendationHash	O hash da recomendação.	cadeia
ID da Recomendação	O identificador da recomendação.	cadeia
Tipo de Recomendação	O tipo de recomendação. Nota: atualmente, suportamos CAMPAIGN_BUDGET, PALAVRA-CHAVE e RESPONSIVE_SEARCH_AD. RecommendationType é apenas saída.	cadeia
Tipo	O conjunto de valores RecommendationType tem os seguintes valores: CampaignBudgetRecommendation, KeywordRecommendation, ResponsiveSearchAdRecommendation.	Tipo de Recomendação

Requisitos

Serviço: AdInsightService.svc v13
Espaço de nomes: https://bingads.microsoft.com/AdInsight/v13