Partilhar via


Conjunto de Valores AdExtensionByKeywordReportColumn - Relatórios

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

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="AdExtensionByKeywordReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:restriction base="xs:string">
    <xs:enumeration value="AccountName" />
    <xs:enumeration value="TimePeriod" />
    <xs:enumeration value="CampaignName" />
    <xs:enumeration value="CampaignId" />
    <xs:enumeration value="AdGroupName" />
    <xs:enumeration value="AdGroupId" />
    <xs:enumeration value="Keyword" />
    <xs:enumeration value="KeywordId" />
    <xs:enumeration value="AdExtensionType" />
    <xs:enumeration value="DeviceType" />
    <xs:enumeration value="DeviceOS" />
    <xs:enumeration value="ClickType" />
    <xs:enumeration value="Impressions" />
    <xs:enumeration value="Clicks" />
    <xs:enumeration value="TotalClicks" />
    <xs:enumeration value="Conversions" />
    <xs:enumeration value="Ctr" />
    <xs:enumeration value="AverageCpc" />
    <xs:enumeration value="ConversionRate" />
    <xs:enumeration value="Spend" />
    <xs:enumeration value="AdExtensionId" />
    <xs:enumeration value="AdExtensionVersion" />
    <xs:enumeration value="AccountNumber" />
    <xs:enumeration value="AccountId" />
    <xs:enumeration value="BidMatchType" />
    <xs:enumeration value="DeliveredMatchType" />
    <xs:enumeration value="Network" />
    <xs:enumeration value="TopVsOther" />
    <xs:enumeration value="Assists" />
    <xs:enumeration value="Revenue" />
    <xs:enumeration value="ReturnOnAdSpend" />
    <xs:enumeration value="CostPerConversion" />
    <xs:enumeration value="CostPerAssist" />
    <xs:enumeration value="RevenuePerConversion" />
    <xs:enumeration value="RevenuePerAssist" />
    <xs:enumeration value="AccountStatus" />
    <xs:enumeration value="CampaignStatus" />
    <xs:enumeration value="AdGroupStatus" />
    <xs:enumeration value="KeywordStatus" />
    <xs:enumeration value="AllConversions" />
    <xs:enumeration value="AllRevenue" />
    <xs:enumeration value="AllConversionRate" />
    <xs:enumeration value="AllCostPerConversion" />
    <xs:enumeration value="AllReturnOnAdSpend" />
    <xs:enumeration value="AllRevenuePerConversion" />
    <xs:enumeration value="Goal" />
    <xs:enumeration value="GoalType" />
    <xs:enumeration value="AverageCpm" />
    <xs:enumeration value="ConversionsQualified" />
    <xs:enumeration value="AllConversionsQualified" />
  </xs:restriction>
</xs:simpleType>

Valores

O conjunto de valores AdExtensionByKeywordReportColumn tem os seguintes valores: AccountId, AccountName, AccountNumber, AccountStatus, AdExtensionId, AdExtensionType, AdExtensionVersion, AdGroupId, AdGroupName, AdGroupStatus, AllConversionRate, AllConversions, AllConversionsQualified, AllCostPerConversion, AllReturnOnAdSpend, AllRevenue, AllRevenuePerConversion, Assists, AverageCpc, AverageCpm, BidMatchType, CampaignId, CampaignName, CampaignStatus, Clicks, ClickType, ConversionRate, Conversions, ConversionsQualified, CostPerAssist, CostPerConversion, Ctr, DeliveredMatchType, DeviceOS, DeviceType, Goal, GoalType, Impressions, Keyword, KeywordId, KeywordStatus, Network, ReturnOnAdSpend, Revenue, RevenuePerAssist, RevenuePerConversion, Spend, TimePeriod, TopVsOther, TotalClicks.

Valor Descrição
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.
AccountStatus O estado da conta.
AdExtensionId O identificador atribuído ao Microsoft Advertising de uma extensão de anúncio.
AdExtensionType O nome do tipo que corresponde à coluna AdExtensionTypeId .
AdExtensionVersion O atributo de versão de uma extensão de anúncio.
AdGroupId O identificador atribuído ao Microsoft Advertising de um grupo de anúncios.
AdGroupName O nome do grupo de anúncios.
AdGroupStatus O estado do grupo de anúncios.
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 .
AllReturnOnAdSpend A devolução dos gastos com anúncios (ROAS).

A fórmula para calcular o ROAS é (Receita/Gastos).

Os dados serão excluídos da coluna de relatório ReturnOnAdSpend para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllReturnOnAdSpend incluirá dados para todos os objetivos de conversão, independentemente da 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 .
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.
BidMatchType O tipo de correspondência da oferta de palavra-chave. Isto pode ser diferente da coluna DeliveredMatchType , por exemplo, se licitar numa correspondência ampla e o termo de pesquisa for uma correspondência exata. Para obter mais informações, veja Estratégias de Orçamento e Licitação. Os valores possíveis são Largo, Exato, Expressão e Desconhecido.
CampaignId O identificador atribuído ao Microsoft Advertising de uma campanha.
CampaignName O nome da campanha.
CampaignStatus O estado da campanha.
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.
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.
DeliveredMatchType O tipo de correspondência utilizado para entregar um anúncio. Isto pode ser diferente da coluna BidMatchType , por exemplo, se licitar numa correspondência ampla e o termo de pesquisa for uma correspondência exata. Para obter mais informações, veja Estratégias de Orçamento e Licitação. Os valores possíveis são Largo, Exato, Expressão e Desconhecido.
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.
Palavra-chave O texto da palavra-chave.
KeywordId O identificador atribuído pelo Microsoft Advertising de uma palavra-chave.
KeywordStatus O estado da palavra-chave.
Rede Toda a Rede de Publicidade da Microsoft composta por sites da Microsoft e tráfego selecionado 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.
ReturnOnAdSpend A devolução dos gastos com anúncios (ROAS).

A fórmula para calcular o ROAS é (Receita/Gastos).

Os dados serão excluídos da coluna de relatório ReturnOnAdSpend para qualquer objetivo de conversão com a propriedade ExcludeFromBidding definida como true. A coluna AllReturnOnAdSpend incluirá dados para todos os objetivos de conversão, independentemente da 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 .
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 .
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.
TopVsOther Indica se a impressão de anúncios apareceu numa posição superior ou noutro lugar. Os valores possíveis incluem a pesquisa ao AOL - Top, pesquisa AOL - Outro, Rede de audiência, Bing e Yahoo! search - Top, Bing e Yahoo! search - Outros parceiros de pesquisa sindicados - Principais, Parceiros de pesquisa sindicados - Outro, Rede de conteúdos e Desconhecido.
TotalClicks O número de vezes faturáveis e não faturáveis em que a extensão de anúncio foi clicada.

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
AdExtensionType
Palavra-chave
TimePeriod

Requisitos

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

Utilizado Por

AdExtensionByKeywordReportRequest