Partilhar via


Conjunto de Valores ProductSearchQueryPerformanceReportColumn - Relatórios

Define as colunas de atributos e estatísticas de desempenho que pode incluir no ProductSearchQueryPerformanceReportRequest.

O relatório incluirá dados apenas para termos de pesquisa que resultaram num número significativo de cliques nos últimos 30 dias.

As colunas de atributos que incluir num relatório podem afetar a forma como as estatísticas são agregadas. Por outras palavras, o número de linhas aumenta por um fator dos atributos exclusivos. Para obter mais informações, consulte Colunas que Agrupam os Dados.

Para obter uma lista das colunas que tem de incluir, consulte a secção Colunas Necessárias abaixo.

Para ver até que ponto os dados agregados de hora a hora, diários, semanais, mensais, anuais e resumidos podem ser obtidos para um relatório, veja Períodos de Tempo de Retenção de Dados do Relatório.

Sintaxe

<xs:simpleType name="ProductSearchQueryPerformanceReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:restriction base="xs:string">
    <xs:enumeration value="TimePeriod" />
    <xs:enumeration value="AccountId" />
    <xs:enumeration value="AccountNumber" />
    <xs:enumeration value="AccountName" />
    <xs:enumeration value="AdId" />
    <xs:enumeration value="AdGroupId" />
    <xs:enumeration value="AdGroupName" />
    <xs:enumeration value="CampaignId" />
    <xs:enumeration value="CampaignName" />
    <xs:enumeration value="DestinationUrl" />
    <xs:enumeration value="DeviceType" />
    <xs:enumeration value="DeviceOS" />
    <xs:enumeration value="Language" />
    <xs:enumeration value="SearchQuery" />
    <xs:enumeration value="Network" />
    <xs:enumeration value="MerchantProductId" />
    <xs:enumeration value="Title" />
    <xs:enumeration value="ClickTypeId" />
    <xs:enumeration value="TotalClicksOnAdElements" />
    <xs:enumeration value="ClickType" />
    <xs:enumeration value="AdGroupCriterionId" />
    <xs:enumeration value="ProductGroup" />
    <xs:enumeration value="PartitionType" />
    <xs:enumeration value="Impressions" />
    <xs:enumeration value="Clicks" />
    <xs:enumeration value="Ctr" />
    <xs:enumeration value="AverageCpc" />
    <xs:enumeration value="Spend" />
    <xs:enumeration value="Conversions" />
    <xs:enumeration value="ConversionRate" />
    <xs:enumeration value="Assists" />
    <xs:enumeration value="CostPerAssist" />
    <xs:enumeration value="Revenue" />
    <xs:enumeration value="CostPerConversion" />
    <xs:enumeration value="RevenuePerConversion" />
    <xs:enumeration value="RevenuePerAssist" />
    <xs:enumeration value="CustomerId" />
    <xs:enumeration value="CustomerName" />
    <xs:enumeration value="AssistedImpressions" />
    <xs:enumeration value="AssistedClicks" />
    <xs:enumeration value="AssistedConversions" />
    <xs:enumeration value="AllConversions" />
    <xs:enumeration value="AllRevenue" />
    <xs:enumeration value="AllConversionRate" />
    <xs:enumeration value="AllCostPerConversion" />
    <xs:enumeration value="AllRevenuePerConversion" />
    <xs:enumeration value="Goal" />
    <xs:enumeration value="GoalType" />
    <xs:enumeration value="AbsoluteTopImpressionRatePercent" />
    <xs:enumeration value="AverageCpm" />
    <xs:enumeration value="ConversionsQualified" />
    <xs:enumeration value="AssistedConversionsQualified" />
    <xs:enumeration value="AllConversionsQualified" />
    <xs:enumeration value="CampaignType" />
    <xs:enumeration value="AssetGroupId" />
    <xs:enumeration value="AssetGroupName" />
  </xs:restriction>
</xs:simpleType>

Valores

O conjunto de valores ProductSearchQueryPerformanceReportColumn tem os seguintes valores: AbsoluteTopImpressionRatePercent, AccountId, AccountName, AccountNumber, AdGroupCriterionId, AdGroupId, AdGroupName, AdId, AllConversionRate, AllConversions, AllConversionsQualified, AllCostPerConversion, AllRevenue, AllRevenuePerConversion, AssetGroupId, AssetGroupName, AssistedClicks, AssistedConversions, AssistedConversionsQualified, AssistedImpressions, Assists, AverageCpc, AverageCpm, CampaignId, CampaignName, CampaignType, Clicks, ClickType, ClickTypeId, ConversionRate, Conversions, ConversionsQualified, CostPerAssist, CostPerConversion, Ctr, CustomerId, CustomerName, DestinationUrl, DeviceOS, DeviceType, Goal, GoalType, Impressions, Language, MerchantProductId, Network, PartitionType, ProductGroup, Revenue, RevenuePerAssist, RevenuePerConversion, SearchQuery, Spend, TimePeriod, Title, TotalClicksOnAdElements.

Valor Descrição
AbsoluteTopImpressionRatePercent Com que frequência o seu anúncio estava na primeira posição de todos os resultados, como uma percentagem do total de impressões.

Um número mais elevado indica que o seu anúncio aparece frequentemente na melhor posição de anúncio.

O valor desta coluna está vazio se os dados não estiverem disponíveis. Nenhuma agregação Hourly ou HourOfDay é suportada. Se incluir esta coluna com a agregação Hourly ou HourOfDay , o serviço não devolverá um erro e deverá ignorar quaisquer dados de desempenho devolvidos para esta coluna.
AccountId O identificador atribuído ao Microsoft Advertising de uma conta.
AccountName O nome da conta.
AccountNumber O número atribuído ao Microsoft Advertising de uma conta.
AdGroupCriterionId O identificador atribuído ao Microsoft Advertising de um critério de grupo de anúncios.

Nota: em Campanhas máximas de desempenho, trata-se de ListingGroupId.
AdGroupId O identificador atribuído ao Microsoft Advertising de um grupo de anúncios.
AdGroupName O nome do grupo de anúncios.
AdId O identificador atribuído ao Microsoft Advertising de um anúncio.
AllConversionRate A taxa de conversão como percentagem.

O número de conversões, dividido pelo número total de cliques. Por exemplo, se os anúncios na sua campanha obtiveram 300 cliques e quatro conversões, a taxa de conversão é de 1,33 (%).

A fórmula para calcular a taxa de conversão é (Conversões/Cliques) x 100.

Os dados serão excluídos da coluna de relatório ConversionRate para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllConversionRate incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .
AllConversions O número de conversões.

Uma conversão é a conclusão de uma ação por parte de um cliente após visualizar o seu anúncio. A ação pode ser comprar o seu produto, registar-se no seu webinar, aderir a uma organização ou o que considerar o seu objetivo e a melhor medida do sucesso do anúncio.

As conversões são medidas ao adicionar um pouco de código às páginas do seu site para que o progresso de um visitante através do seu site possa ser controlado.

Os dados serão excluídos da coluna de relatório Conversões para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllConversions incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .

Esta coluna foi preterida a partir de 2022, pelo que deve utilizar a coluna AllConversionsQualified . No futuro, os relatórios de desempenho devolverão "0" (zero) nesta coluna. Os dados históricos dos períodos de tempo anteriores à data de preterição continuarão disponíveis de acordo com o período de retenção de dados publicado.
AllConversionsQualified O número de conversões.

Uma conversão é a conclusão de uma ação por parte de um cliente após visualizar o seu anúncio. A ação pode ser comprar o seu produto, registar-se no seu webinar, aderir a uma organização ou o que considerar o seu objetivo e a melhor medida do sucesso do anúncio.

As conversões são medidas ao adicionar um pouco de código às páginas do seu site para que o progresso de um visitante através do seu site possa ser controlado.

Os dados serão excluídos da coluna de relatório Conversões para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllConversions incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .

Deverá esperar que o tipo de dados seja o dobro , quer existam ou não conversões offline atribuídas externamente parcialmente.

Nem todos têm esta funcionalidade ainda. Se não o fizer, não se preocupe.
AllCostPerConversion O custo por conversão.

A fórmula para calcular o custo por conversão é (Gastos/Conversões). Apenas os anúncios em campanhas que permitem o controlo de conversão contribuem para o número de conversão, pelo que, a menos que todas as campanhas na conta ativem o controlo de conversão, o número não será exato.

Os dados serão excluídos da coluna do relatório CostPerConversion para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllCostPerConversion incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .
AllRevenue Opcionalmente, a receita comunicada pelo anunciante como resultado de conversões.

Os dados serão excluídos da coluna Relatório de receitas para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllRevenue incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .
AllRevenuePerConversion A receita por conversão.

A fórmula para calcular a receita por conversão é (Receita/Conversões).

Os dados serão excluídos da coluna de relatório RevenuePerConversion para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllRevenuePerConversion incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .
AssetGroupId O identificador atribuído ao Microsoft Advertising de um grupo de recursos.
AssetGroupName O nome do grupo de ativos.
AssistedClicks Clica nos seus anúncios que receberam propostas conjuntas dos seus parceiros fabricantes. Os cliques são aquilo que paga.

Normalmente, os cliques incluem um cliente que clica num anúncio numa página de resultados da pesquisa ou num site na rede de pesquisa. Os cliques também podem ser provenientes de outras origens (por exemplo, aranhas, robôs e servidores de teste).

Esta estatística de desempenho só está disponível para Produtos Patrocinados em Campanhas comerciais da Microsoft.
AssistedConversions O número de conversões.

Uma conversão é a conclusão de uma ação por parte de um cliente após visualizar o seu anúncio. A ação pode ser comprar o seu produto, registar-se no seu webinar, aderir a uma organização ou o que considerar o seu objetivo e a melhor medida do sucesso do anúncio.

As conversões são medidas ao adicionar um pouco de código às páginas do seu site para que o progresso de um visitante através do seu site possa ser controlado.

Os dados serão excluídos da coluna de relatório Conversões para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllConversions incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .
AssistedConversionsQualified Reservado para utilização futura.
AssistedImpressions O número de vezes que um anúncio que está a ser co-licitado pelos seus parceiros fabricantes foi apresentado em páginas de resultados da pesquisa ou noutros sites na Rede de Publicidade da Microsoft.

Esta estatística de desempenho só está disponível para Produtos Patrocinados em Campanhas comerciais da Microsoft.
Assistências O número de conversões de outros anúncios na mesma conta que foram precedidas por um ou mais cliques deste anúncio. Considera-se que um anúncio ajudou na conversão se tiver sido clicado antes do anúncio clicado mais recentemente que foi creditado com a conversão. Além disso, o clique correspondente ao auxiliar tem de ocorrer dentro do período de conversão do objetivo.
AverageCpc O custo médio por clique (CPC). O custo total de todos os cliques num anúncio dividido pelo número de cliques. Este é o montante médio que lhe é cobrado sempre que o seu anúncio é clicado. Por exemplo, se pagou um total de 48,35 por 300 cliques, o CPC médio é de 0,16. A fórmula para calcular o CPC médio é (Gastar /Cliques).
AverageCpm O custo total da publicidade dividido pelo número de impressões (em milhares).<br/
Em latim, mille significa mil. Além disso, por vezes denominado custo médio por mil (CPT).

Esta é uma métrica padrão de desempenho da indústria de publicidade que calculamos com base nos seus gastos e no número de impressões.

O objetivo do orçamento de anúncios baseado em CPM é consciencializar a sua marca para grandes audiências. O CPM indica-lhe quanto custa obter um anúncio para o tipo de utilizadores que está a filtrar.
CampaignId O identificador atribuído ao Microsoft Advertising de uma campanha.
CampaignName O nome da campanha.
CampaignType O tipo de campanha.

Os valores possíveis incluem Audiência, Pesquisa dinâmica, Máximo de desempenho, Pesquisa & conteúdos e Compras.
Cliques Os cliques são aquilo que paga. Normalmente, os cliques incluem um cliente que clica num anúncio numa página de resultados da pesquisa ou num site na rede de pesquisa. Os cliques também podem ser provenientes de outras origens (por exemplo, aranhas, robôs e servidores de teste). Para obter mais informações, veja Microsoft Advertising click measurement: description of methodology (Medição de cliques do Microsoft Advertising): descrição da metodologia.
ClickType O tipo de clique refere-se a cada componente de um anúncio em que um cliente pode clicar. Os tipos de clique possíveis são título do anúncio, imagem, número de telefone, direções de condução, sitelink e revisão.
ClickTypeId O ID do tipo de clique.
Taxa de Conversão A taxa de conversão como percentagem.

O número de conversões, dividido pelo número total de cliques. Por exemplo, se os anúncios na sua campanha obtiveram 300 cliques e quatro conversões, a taxa de conversão é de 1,33 (%).

A fórmula para calcular a taxa de conversão é (Conversões/Cliques) x 100.

Os dados serão excluídos da coluna de relatório ConversionRate para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllConversionRate incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .
Conversões O número de conversões.

Uma conversão é a conclusão de uma ação por parte de um cliente após visualizar o seu anúncio. A ação pode ser comprar o seu produto, registar-se no seu webinar, aderir a uma organização ou o que considerar o seu objetivo e a melhor medida do sucesso do anúncio.

As conversões são medidas ao adicionar um pouco de código às páginas do seu site para que o progresso de um visitante através do seu site possa ser controlado.

Os dados serão excluídos da coluna de relatório Conversões para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllConversions incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .

Esta coluna foi preterida a partir de 2022, pelo que deve utilizar a coluna Conversões Qualificadas . No futuro, os relatórios de desempenho devolverão "0" (zero) nesta coluna. Os dados históricos dos períodos de tempo anteriores à data de preterição continuarão disponíveis de acordo com o período de retenção de dados publicado.
Conversões Qualificadas O número de conversões.

Uma conversão é a conclusão de uma ação por parte de um cliente após visualizar o seu anúncio. A ação pode ser comprar o seu produto, registar-se no seu webinar, aderir a uma organização ou o que considerar o seu objetivo e a melhor medida do sucesso do anúncio.

As conversões são medidas ao adicionar um pouco de código às páginas do seu site para que o progresso de um visitante através do seu site possa ser controlado.

Os dados serão excluídos da coluna de relatório Conversões para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllConversions incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .

Deverá esperar que o tipo de dados seja o dobro , quer existam ou não conversões offline atribuídas externamente parcialmente.

Nem todos têm esta funcionalidade ainda. Se não o fizer, não se preocupe.
CostPerAssist O custo por assistência. A fórmula para calcular o custo por assistência é (Gastos/Assistências).
CostPerConversion O custo por conversão.

A fórmula para calcular o custo por conversão é (Gastos/Conversões). Apenas os anúncios em campanhas que permitem o controlo de conversão contribuem para o número de conversão, pelo que, a menos que todas as campanhas na conta ativem o controlo de conversão, o número não será exato.

Os dados serão excluídos da coluna do relatório CostPerConversion para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllCostPerConversion incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .
Ctr A taxa click-through (CTR) é o número de vezes que um anúncio foi clicado, dividido pelo número de vezes que o anúncio foi mostrado (impressões). Por exemplo, se os seus anúncios obtiverem 50 cliques com 2348 impressões, o CTR será de 2,13 (%). A fórmula para calcular a CTR é (Cliques/Impressões) x 100.
CustomerId O identificador atribuído ao Microsoft Advertising de um cliente.
CustomerName O nome do cliente.
DestinationUrl O atributo URL de destino do critério de grupo de anúncios, palavras-chave ou ad. Se o URL de destino contiver parâmetros de substituição de texto dinâmicos (por exemplo, {param1}), o relatório conterá o URL após a substituição.
DeviceOS O sistema operativo do dispositivo comunicado na coluna DeviceType . Os valores possíveis incluem Android, Blackberry, iOS, Other, Unknown e Windows. Se não for possível determinar o sistema operativo do dispositivo ou não for um dos sistemas operativos de destino, o valor nesta coluna será Desconhecido.
DeviceType O atributo de nome do dispositivo de uma oferta de destino do SO do dispositivo. O tipo de dispositivo que mostrava anúncios. Os valores possíveis incluem Computador, Smartphone, Tablet e Desconhecido.
Objetivo O nome do objetivo que definiu para as conversões que pretende, ou seja, as ações que os clientes efetuam após clicar no seu anúncio.
GoalType O tipo de objetivo de conversão.
Os valores possíveis incluem AppInstall, Duration, Event, InStoreTransaction, OfflineConversion, PagesViewedPerVisit e Url.
Impressões O número de vezes que um anúncio é apresentado nas páginas de resultados da pesquisa. Sem impressões, não existem cliques ou conversões.
Idioma O idioma do publicador onde o anúncio foi apresentado.

Para obter valores possíveis, veja a coluna Idioma dos Idiomas de Anúncios. O nome a apresentar do idioma será fornecido no relatório, por exemplo , inglês.
MerchantProductId O identificador exclusivo fornecido por um comerciante para cada oferta de produto.
Rede Toda a Rede de Publicidade da Microsoft composta por sites da Microsoft e seleciona tráfego, tráfego entre redes e apenas tráfego de parceiros (este tipo de rede é preterido a partir de julho de 2024). Utilize estes dados para tomar a melhor decisão sobre a seleção de rede para os seus grupos de anúncios. Os valores possíveis incluem pesquisa ao AOL, Audiência, sites da Microsoft e selecione tráfego, Conteúdo e Parceiros de pesquisa sindicados.

Nota: nem todas as pessoas podem utilizar o valor sites da Microsoft e selecionar o tráfego ainda. Se não conseguir, não se preocupe.
PartitionType O tipo de partição de produto.
Grupo de Produtos A lista delimitada com barra para trás das condições do produto, comunicada como Operando = Atributo. Os valores dos atributos estão entre "" (aspas duplas). Eis um exemplo: * / Category="Animais & Materiais para Animais de Estimação" / Category="Pet Supplies" / Category="Materiais para Aves". O "*" (asterisco único) refere-se a um grupo de produtos que corresponde a tudo o resto para além dos outros filtros do grupo de produtos.

Nota: em Campanhas máximas de desempenho, trata-se de ListingGroup.
Receita Opcionalmente, a receita comunicada pelo anunciante como resultado de conversões.

Os dados serão excluídos da coluna Relatório de receitas para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllRevenue incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .
RevenuePerAssist A receita por assistência. A fórmula para calcular a receita por assistência é (Receita/Assistências).
RevenuePerConversion A receita por conversão.

A fórmula para calcular a receita por conversão é (Receita/Conversões).

Os dados serão excluídos da coluna de relatório RevenuePerConversion para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllRevenuePerConversion incluirá dados para todos os objetivos de conversão, independentemente da respetiva definição ExcludeFromBidding .

Disponível para contas configuradas para utilizar análises com o Controlo de Eventos Universais do Microsoft Advertising. Para obter mais informações, consulte o tópico de ajuda Controlar vendas e outras conversões .
SearchQuery O termo de pesquisa utilizado pela sua potencial audiência.
Gastar O custo por clique (CPC) somado para cada clique.
TimePeriod O período de tempo de cada linha de relatório. Não pode incluir esta coluna se o elemento Agregação do objeto de pedido estiver definido como Resumo. Para obter mais informações, veja Coluna de Período de Tempo.
Cargo O nome do item de produto. Por exemplo, o título de um livro, DVD ou jogo.
TotalClicksOnAdElements O número de cliques quando este elemento de anúncio estava presente na cópia de anúncios, quer este ou outro elemento de anúncio tenha sido clicado.

Observações

Colunas Necessárias

O relatório tem de incluir, no mínimo, as seguintes colunas. Regra geral, cada relatório tem de incluir, pelo menos, uma coluna de atributos e, pelo menos, uma coluna de estatísticas de desempenho de partilha sem impressão. Para obter mais informações, veja Atributos de Relatório e Estatísticas de Desempenho.

Nota

A coluna TimePeriod é esperada para todos os tipos de agregação, exceto Resumo. É importante ter em atenção que, se não incluir o TimePeriod, a agregação que escolheu será ignorada e a Agregação de resumo será utilizada independentemente.

Coluna
AccountName
CampaignName
SearchQuery
TimePeriod

Requisitos

Serviço: ReportingService.svc v13
Espaço de nomes: https://bingads.microsoft.com/Reporting/v13

Utilizado Por

ProductSearchQueryPerformanceReportRequest