Objeto de Dados KeywordIdea - Ad Insight

Artigo
12/21/2023

Define um objeto que contém uma palavra-chave sugerida com estatísticas históricas, como volume de pesquisa mensal, concorrência, oferta mínima sugerida e partilha de impressões de anúncios.

Sintaxe

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

Elementos

O objeto KeywordIdea tem os seguintes elementos: AdGroupId, AdGroupName, AdImpressionShare, Competition, Keyword, MonthlySearchCounts, Relevância, Origem, SuggestedBid.

Elemento	Descrição	Tipo de Dados
AdGroupId	O identificador de grupo de anúncios negativo que agrupa ideias de palavras-chave em novos grupos de anúncios sugeridos. As ideias de palavras-chave para identificadores de grupo de anúncios existentes não são suportadas. Se o ID do grupo de anúncios for nulo, o elemento Origem da ideia de palavra-chave está definido como Seed e não existe nenhum grupo de anúncios recomendado específico.	long
AdGroupName	O nome sugerido do grupo de anúncios para a ideia de palavra-chave. Se o nome do grupo de anúncios for nulo, o elemento de origem da ideia de palavra-chave está definido como Seed e não existe nenhum grupo de anúncios recomendado específico.	cadeia
AdImpressionShare	A partilha de impressões de anúncios é o número de impressões que recebeu divididas pelo número total de pesquisas da localização e da rede que está a filtrar que correspondem exatamente à palavra-chave no último mês do calendário.	duplo
Competição	Determinado pelo número de anunciantes que licitam nesta palavra-chave, relativamente a todas as outras palavras-chave no Microsoft Advertising.	Nívelde Concorrência
Palavra-chave	A palavra-chave sugerida.	cadeia
MonthlySearchCounts	O número de vezes que esta palavra-chave foi utilizada como um termo de pesquisa para cada mês dentro do intervalo de datas e definições de filtragem que selecionou. Por predefinição, o tamanho da lista é 12 e são devolvidos os últimos 12 meses de dados disponíveis. As contagens de pesquisa são ordenadas por ordem, começando pelos dados do mês mais recente em `MonthlySeachCounts[0]`. Pode demorar até 72 horas para que os dados do mês do calendário anterior estejam disponíveis. Por exemplo, se pedir ideias de palavra-chave a 1, 2 ou 3 de agosto e os dados de julho não estiverem prontos, a resposta será baseada nos dados de junho. Se não incluir o DateRangeSearchParameter no pedido GetKeywordIdeas , não poderá confirmar se o primeiro item de lista são dados do mês anterior ou do mês anterior. Se o intervalo de datas for especificado e os dados do mês mais recente ainda não estiverem disponíveis, GetKeywordIdeas devolverá um erro.	matriz longa
Relevância	A pontuação de relevância da palavra-chave. Maior relevância significa "mais relevante". Não existe um intervalo definido, mas, como exemplo, poderá ver valores como 1,00 ou 87 083,82. Embora os valores não sejam apresentados, a relevância é utilizada para ordenar os resultados do Planeador de Palavras-chave por relevância na IU do Microsoft Advertising.	duplo
Origem	A origem ou semente da palavra-chave.	Tipo de Origem
SuggestedBid	A oferta mínima sugerida para esta palavra-chave. Criamos esta sugestão com a localização e o critério de rede que incluiu, juntamente com o custo médio por clique (CPC) que os anunciantes estão a pagar por esta palavra-chave. Este montante é apenas uma estimativa e o seu CPC real pode variar.	duplo

Requisitos

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

Utilizado Por

GetKeywordIdeas

Partilhar via