Conjunto de Valores AdDynamicTextPerformanceReportColumn - Relatórios
Define as colunas de atributos e estatísticas de desempenho que pode incluir no Objeto de Dados AdDynamicTextPerformanceReportRequest.
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="AdDynamicTextPerformanceReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:restriction base="xs:string">
<xs:enumeration value="AccountName" />
<xs:enumeration value="AccountId" />
<xs:enumeration value="AccountNumber" />
<xs:enumeration value="TimePeriod" />
<xs:enumeration value="AdGroupName" />
<xs:enumeration value="AdGroupId" />
<xs:enumeration value="Keyword" />
<xs:enumeration value="AdId" />
<xs:enumeration value="AdTitle" />
<xs:enumeration value="AdType" />
<xs:enumeration value="DestinationUrl" />
<xs:enumeration value="Param1" />
<xs:enumeration value="Param2" />
<xs:enumeration value="Param3" />
<xs:enumeration value="CurrencyCode" />
<xs:enumeration value="AdDistribution" />
<xs:enumeration value="Impressions" />
<xs:enumeration value="Clicks" />
<xs:enumeration value="Ctr" />
<xs:enumeration value="AverageCpc" />
<xs:enumeration value="Spend" />
<xs:enumeration value="AveragePosition" />
<xs:enumeration value="Conversions" />
<xs:enumeration value="ConversionRate" />
<xs:enumeration value="CostPerConversion" />
<xs:enumeration value="DeviceType" />
<xs:enumeration value="Language" />
<xs:enumeration value="AccountStatus" />
<xs:enumeration value="AdGroupStatus" />
<xs:enumeration value="AdStatus" />
<xs:enumeration value="KeywordStatus" />
<xs:enumeration value="TitlePart1" />
<xs:enumeration value="TitlePart2" />
<xs:enumeration value="TitlePart3" />
<xs:enumeration value="Path1" />
<xs:enumeration value="Path2" />
<xs:enumeration value="FinalUrl" />
<xs:enumeration value="FinalMobileUrl" />
<xs:enumeration value="FinalAppUrl" />
<xs:enumeration value="AdDescription" />
<xs:enumeration value="AdDescription2" />
<xs:enumeration value="AdLabels" />
<xs:enumeration value="AllConversions" />
<xs:enumeration value="AllConversionRate" />
<xs:enumeration value="AllCostPerConversion" />
<xs:enumeration value="ViewThroughConversions" />
<xs:enumeration value="Goal" />
<xs:enumeration value="GoalType" />
<xs:enumeration value="AbsoluteTopImpressionRatePercent" />
<xs:enumeration value="TopImpressionRatePercent" />
<xs:enumeration value="AverageCpm" />
<xs:enumeration value="ConversionsQualified" />
<xs:enumeration value="AllConversionsQualified" />
<xs:enumeration value="ViewThroughConversionsQualified" />
<xs:enumeration value="ViewThroughRevenue" />
</xs:restriction>
</xs:simpleType>
Valores
O conjunto de valores AdDynamicTextPerformanceReportColumn tem os seguintes valores: AbsoluteTopImpressionRatePercent, AccountId, AccountName, AccountNumber, AccountStatus, AdDescription, AdDescription2, AdDistribution, AdGroupId, AdGroupName, AdGroupStatus, AdId, AdLabels, AdStatus, AdTitle, AdType, AllConversionRate, AllConversions, AllConversionsQualified, AllCostPerConversion, AverageCpc, AverageCpm, AveragePosition, Clicks, ConversionRate, Conversions, ConversionsQualified, CostPerConversion, Ctr, CurrencyCode, DestinationUrl, DeviceType, FinalAppUrl, FinalMobileUrl, FinalUrl, Goal, GoalType, Impressions, Keyword, KeywordStatus, Language, Param1, Param2, Param3, Path1, Path2, Spend, TimePeriod, TitlePart1, TitlePart2, TitlePart3, TopImpressionRatePercent, ViewThroughConversions, ViewThroughConversionsQualified, ViewThroughRevenue.
| 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. |
| AccountStatus | O estado da conta. |
| AdDescription | A primeira descrição de anúncio que aparece abaixo do caminho no seu anúncio. |
| AdDescription2 | A segunda descrição de anúncio que aparece abaixo do caminho no seu anúncio. A descrição do anúncio 2 pode não aparecer no seu anúncio. |
| AdDistribution | A rede onde pretende que os seus anúncios sejam apresentados. Pode ser toda a Rede de Publicidade da Microsoft, sites da Microsoft e tráfego selecionado ou apenas tráfego de parceiros (este tipo de rede é preterido a partir de julho de 2024). |
| 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. |
| AdId | O identificador atribuído ao Microsoft Advertising de um anúncio. |
| AdLabels | As etiquetas aplicadas ao anúncio. As etiquetas são delimitadas por um ponto e vírgula (;) na transferência do relatório. |
| AdStatus | O estado do anúncio. |
| AdTitle | O título do anúncio. |
| AdType | O tipo de 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 . |
| 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. |
| AveragePosition | A posição média do anúncio numa página Web. Esta coluna foi preterida a partir de 31 de março de 2021. No futuro, os relatórios de desempenho devolverão a posição média de "0" (zero). Os dados de posição média histórica para 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 por tipo de relatório. |
| 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. |
| 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. |
| 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. |
| CurrencyCode | O tipo de moeda da conta. Para valores possíveis, veja Moedas. |
| 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. |
| 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. |
| FinalAppUrl | Reservado para utilização futura. |
| FinalMobileUrl | O URL do Dispositivo Móvel Final do anúncio, palavra-chave ou critério. Apenas o primeiro URL na lista é reportado. Se o URL contiver parâmetros de substituição de texto dinâmicos (por exemplo, {param1}), o relatório irá conter o URL antes da substituição. |
| FinalUrl | O URL Final do anúncio, palavra-chave ou critério. Apenas o primeiro URL na lista é reportado. Se o URL contiver parâmetros de substituição de texto dinâmicos (por exemplo, {param1}), o relatório irá conter o URL antes da substituição. |
| 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. |
| KeywordStatus | O estado da palavra-chave. |
| 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. |
| Parâmetro1 | O primeiro parâmetro de substituição dinâmica (Param1) de uma palavra-chave ou critério de grupo de anúncios bidível. |
| Parâmetro2 | O segundo parâmetro de substituição dinâmica (Param2) de uma palavra-chave ou critério de grupo de anúncios bidível. |
| Parâmetro3 | O terceiro parâmetro de substituição dinâmica (Param3) de uma palavra-chave ou critério de grupo de anúncios bidível. |
| Caminho1 | O atributo path 1 de um anúncio. |
| Caminho2 | O atributo path 2 de um anúncio. |
| 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. |
| TitlePart1 | O atributo título parte 1 de um anúncio. |
| TitlePart2 | O atributo título parte 2 de um anúncio. |
| TitlePart3 | O atributo título parte 3 de um anúncio. |
| TopImpressionRatePercent | A percentagem de vezes que o seu anúncio foi apresentado na linha principal, o posicionamento superior onde os anúncios aparecem acima dos resultados da pesquisa, do total de impressões. Isto indica como as alterações na posição do anúncio podem afetar o desempenho. 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. |
| ViewThroughConversions | As conversões view-through são conversões que as pessoas fazem depois de verem o seu anúncio, apesar de não terem clicado no anúncio. As conversões view-through não têm um clique associado, mas têm uma impressão associada na janela de conversão definida pelo anunciante. Se o utilizador também tiver clicado num anúncio que foi entregue através da Rede de Audiências da Microsoft ou pesquisa, não será contabilizada nenhuma conversão de visualização. Apenas a conversão baseada em cliques seria contabilizada. As conversões view-through só são contadas para anúncios na rede audiência da Microsoft. Esta coluna foi preterida a partir de 2022, pelo que deve utilizar a coluna ViewThroughConversionsQualified . 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. |
| ViewThroughConversionsQualified | As conversões view-through são conversões que as pessoas fazem depois de verem o seu anúncio, apesar de não terem clicado no anúncio. As conversões view-through não têm um clique associado, mas têm uma impressão associada na janela de conversão definida pelo anunciante. Se o utilizador também tiver clicado num anúncio que foi entregue através da Rede de Audiências da Microsoft ou pesquisa, não será contabilizada nenhuma conversão de visualização. Apenas a conversão baseada em cliques seria contabilizada. As conversões view-through só são contadas para anúncios na rede audiência da Microsoft. 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. |
| ViewThroughRevenue | Opcionalmente, a receita comunicada pelo anunciante como resultado de conversões view-through. |
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 |
|---|
| AdTitle |
| DestinationUrl |
| Parâmetro1 |
| Parâmetro2 |
| Parâmetro3 |
| TimePeriod |
Requisitos
Serviço: ReportingService.svc v13
Espaço de nomes: https://bingads.microsoft.com/Reporting/v13