SearchCampaignChangeHistoryReportColumn Value Set - Reporting
Define as colunas de atributo que pode incluir no SearchCampaignChangeHistoryReportRequest.
Para obter uma lista das colunas que tem de incluir, consulte a secção Colunas Necessárias abaixo.
Sintaxe
<xs:simpleType name="SearchCampaignChangeHistoryReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:restriction base="xs:string">
<xs:enumeration value="DateTime" />
<xs:enumeration value="AccountId" />
<xs:enumeration value="AccountName" />
<xs:enumeration value="AccountNumber" />
<xs:enumeration value="ChangedBy" />
<xs:enumeration value="CampaignName" />
<xs:enumeration value="CampaignId" />
<xs:enumeration value="AdGroupName" />
<xs:enumeration value="AdGroupId" />
<xs:enumeration value="AdTitle" />
<xs:enumeration value="AdDescription" />
<xs:enumeration value="DisplayUrl" />
<xs:enumeration value="Keyword" />
<xs:enumeration value="ItemChanged" />
<xs:enumeration value="AttributeChanged" />
<xs:enumeration value="HowChanged" />
<xs:enumeration value="OldValue" />
<xs:enumeration value="NewValue" />
<xs:enumeration value="EntityName" />
<xs:enumeration value="EntityId" />
<xs:enumeration value="Tool" />
</xs:restriction>
</xs:simpleType>
Valores
O conjunto de valores SearchCampaignChangeHistoryReportColumn tem os seguintes valores: AccountId, AccountName, AccountNumber, AdDescription, AdGroupId, AdGroupName, AdTitle, AttributeChanged, CampaignId, CampaignName, ChangedBy, DateTime, DisplayUrl, EntityId, EntityName, HowChanged, ItemChanged, Palavra-chave, NewValue, OldValue, Tool.
| 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. |
| AdDescription | A primeira descrição de anúncio que aparece abaixo do caminho no seu anúncio. Esta coluna estará vazia se ItemChanged não for AD. |
| AdGroupId | O identificador atribuído ao Microsoft Advertising de um grupo de anúncios. Esta coluna estará vazia se ItemChanged não for Ad, grupo AD ou Palavra-chave. |
| AdGroupName | O nome do grupo de anúncios. Esta coluna estará vazia se ItemChanged não for Ad, grupo AD ou Palavra-chave. |
| AdTitle | As partes do título do anúncio. Esta coluna estará vazia se ItemChanged não for AD. |
| AttributeChanged | Identifica o atributo ou propriedade da entidade a partir da coluna ItemChanged que foi alterada. Para obter uma lista de elementos cujo histórico de alterações é reportado, veja a coluna Atributo Alterado em Observações. Esta coluna está vazia se uma campanha, grupo de anúncios ou entidade de anúncios tiver sido adicionada ou eliminada. |
| CampaignId | O identificador atribuído ao Microsoft Advertising de uma campanha. |
| CampaignName | O nome da campanha. |
| Alterado Por | O nome de utilizador do utilizador que efetuou a alteração às definições na conta. Se o sistema tiver feito a alteração, o valor será Administrador. |
| DateTime | A data e hora da alteração. A data e hora estarão no fuso horário da campanha. |
| DisplayUrl | O URL de apresentação de anúncios. Esta coluna estará vazia se ItemChanged não for AD. |
| EntityId | O identificador do sistema microsoft Advertising da entidade que foi atualizada. |
| EntityName | O nome da entidade que foi atualizada. |
| HowChanged | O valor que indica se o elemento foi adicionado, atualizado ou eliminado. Para valores possíveis, veja ChangeTypeReportFilter Value Set( Conjunto de Valores de ChangeTypeReportFilter). Para os suplementos, a coluna NewValue contém a entidade adicionada. Para eliminações, a coluna OldValue contém a entidade eliminada. Para atualizações, a coluna NewValue contém o novo valor e a coluna OldValue contém o valor antigo. Se uma entidade que tem uma propriedade de estado de entrega tiver sido adicionada, por exemplo, uma campanha, o valor de HowChanged é Adicionado. Para comunicar uma entidade eliminada, o campo ItemChanged é Estado, o campo HowChanged é Alterado e o campo NewValue é Eliminado. A associação de um destino a uma campanha ou grupo de anúncios será comunicada como uma alteração de adição. A coluna AttributeChanged identificará os tipos de destino contidos no objeto de destino. Atualizações a um objeto de destino será reportado como uma alteração de eliminação e uma alteração de adição. A remoção da associação de uma campanha ou grupo de anúncios com um objeto de destino será comunicada como uma alteração de eliminação. |
| ItemChanged | O valor que identifica a entidade que foi alterada. Se a alteração for uma atualização para um elemento da entidade ou estiver relacionada com um destino associado a uma campanha ou grupo de anúncios, a coluna AttributeChanged contém o elemento da entidade que foi alterada ou o tipo de destino que foi alterado. |
| Palavra-chave | O texto da palavra-chave. Esta coluna estará vazia se ItemChanged não for Palavra-chave. |
| NewValue | O valor após a alteração. Para obter mais informações, veja a coluna HowChanged . |
| OldValue | O valor antes da alteração. Para obter mais informações, veja a coluna HowChanged . |
| Ferramenta | A ferramenta Microsoft Advertising utilizada para efetuar alterações. Os valores possíveis incluem "API", "Regras automatizadas", "Carregamento em massa", "Importações", "Editor", "Aplicações Móveis", "Outro", "Scripts" e "Cliente Web (manual)". Podem ser adicionados novos valores no futuro, pelo que não deve assumir qualquer dependência num conjunto fixo de valores. |
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.
| Coluna |
|---|
| DateTime |
Detalhes do Histórico de Alterações
Seguem-se os tipos de entidade cujo histórico de alterações é reportado.
Nota
Se o campo AttributeChanged estiver em branco ou estiver vazio e o campo HowChanged for Adicionado ou Eliminado, os conteúdos do campo NewValue ou OldValue representam um elemento da entidade que foi adicionada ou eliminada, respetivamente. Por exemplo, se for adicionada uma palavra-chave, o campo NewValue contém o texto da palavra-chave.
- Conta
- Anúncio
- Grupo de anúncios
- Extensão de chamada
- Campanha
- Palavra-chave
- Extensão de localização
- Lista de Palavras-chave Negativas
- Extensão de ligação de site
- Utilizador
Conta
Quando o valor do campo ItemChanged é Conta, o histórico de alterações dos seguintes atributos está disponível.
| Atributo Alterado | Descrição |
|---|---|
| Nenhum (em branco) | Refere-se ao nome da conta que foi adicionada. O valor do campo HowChanged correspondente é Adicionado. |
| Conta | Refere-se ao nome da conta que foi alterada. |
| Contacto da agência | Refere-se ao nome do contacto da agência. |
| Cliente da casa de vendas | Refere-se ao cliente da casa de vendas. |
| Cliente de faturação | Refere-se ao cliente da faturação |
| Estado financeiro | Refere-se ao estado financeiro |
| Estado do bloqueio | Refere-se ao estado de bloqueio |
| Opção de pagamento | Refere-se à opção de pagamento |
| Método de pagamento preferencial para faturação | Refere-se ao método de pagamento preferencial para faturação |
| Idioma preferido | Refere-se ao idioma preferencial |
| Método de pagamento vendido a | Método de pagamento vendido a |
| Estado | Refere-se ao estado da conta. |
| Utilizador preferencial | Refere-se ao utilizador preferencial |
| Limite de gastos | Refere-se ao limite de gastos |
| Modelo de controlo | Refere-se ao modelo de controlo da conta. |
Anúncio
Quando o valor do campo ItemChanged é Ad, o histórico de alterações dos seguintes atributos está disponível.
| Atributo Alterado | Descrição |
|---|---|
| Nenhum (em branco) | Refere-se ao título do anúncio que foi adicionado. O valor do campo HowChanged correspondente é Adicionado. |
| Texto de anúncio | Refere-se à descrição da cópia de anúncios. |
| Título do anúncio | Refere-se ao título do anúncio que foi alterado. |
| Parâmetros personalizados | Refere-se aos parâmetros personalizados do anúncio. |
| URL de destino | Refere-se ao URL de destino do anúncio. |
| Apresentar URL | Refere-se ao URL de apresentação do anúncio. |
| Estado editorial | Refere-se ao estado editorial do anúncio. Se o anúncio estiver pendente de revisão editorial offline, num relatório do histórico de alterações transferido, o estado editorial é representado como Pendente - Ativo ou Pendente - Inativo. Para obter mais informações, veja Entidades e Estado da Entrega. |
| Final URL | Refere-se ao URL Final do anúncio. |
| URL móvel | Refere-se ao URL Móvel Final do anúncio. |
| Estado | Refere-se ao estado de entrega do anúncio. Se comunicar um anúncio eliminado, o campo ItemChanged é Estado, o campo HowChanged é Alterado e o campo NewValue é Eliminado. |
| Modelo de controlo | Refere-se ao modelo de controlo do anúncio. |
Grupo de anúncios
Quando o valor do campo ItemChanged é grupo Ad, o histórico de alterações dos seguintes atributos está disponível.
| Atributo Alterado | Descrição |
|---|---|
| Nenhum (em branco) | Refere-se ao nome do grupo de anúncios que foi adicionado. O valor do campo HowChanged correspondente é Adicionado. |
| Grupo de anúncios | Refere-se ao nome do grupo de anúncios que foi alterado. |
| Destino de localização avançado | Refere-se à opção de intenção do destino de localização que está associado ao grupo de anúncios. |
| Idade | Refere-se ao destino da idade. |
| Parâmetros personalizados | Refere-se aos parâmetros personalizados do grupo de anúncios. |
| Dia | Refere-se ao destino do dia que foi preterido após a versão 9 da API de Anúncios do Bing. |
| Oferta de correspondência abrangente predefinida | Refere-se à oferta de correspondência abrangente predefinida |
| Oferta de correspondência de conteúdo predefinida | Refere-se à oferta de correspondência de conteúdo predefinida |
| Oferta de correspondência exata predefinida | Refere-se à oferta de correspondência exata predefinida |
| Oferta de correspondência de expressão predefinida | Refere-se à oferta de correspondência de expressão predefinida |
| Dispositivo | Refere-se aos diferimentos para o destino do dispositivo. |
| Distance | Refere-se à distância do destino radius. |
| Data de fim | Refere-se à data de fim agendada para o grupo de anúncios. |
| Hora de fim | Refere-se ao combinado para Hora e Para Minuto do destino DayTime. O ajuste da oferta também está incluído neste campo, delimitado desde o momento por um único caráter de barra vertical. |
| Sexo | Refere-se ao destino de género. |
| Hora | Refere-se ao destino de hora que foi preterido após a versão 9 da API de Anúncios do Bing. |
| Localização | Refere-se ao destino da localização. |
| Exclusão de localização | Refere-se à exclusão de localizações de um destino de localização. |
| Médio | Refere-se à distribuição de Anúncios de Pesquisa ou Conteúdo. |
| Palavra-chave negativa | Refere-se a uma palavra-chave negativa associada ao grupo de anúncios. Atualizações a palavras-chave negativas são reportadas como uma alteração Removida e Adicionada em duas linhas. O registo Removido corresponde ao valor antigo e o registo Adicionado reflete o novo valor. |
| Estado da pausa | Refere-se a qualquer um dos estados em pausa do grupo de anúncios. |
| Grupo de produtos | As condições de produto de um grupo de produtos são delimitadas entre si por uma barra anterior ('') e delimitadas da oferta por um único caráter de espaço. |
| Exclusão de Site | Refere-se aos URLs negativos do site do grupo de anúncios. Um grupo de anúncios pode ter múltiplas exclusões de sites e cada exclusão de site é representada separadamente na sua própria linha de relatório. |
| Hora de início | Refere-se ao combinado De Hora a Hora e A Partir do Minuto do destino DayTime. O ajuste da oferta também está incluído neste campo, delimitado desde o momento por um único caráter de barra vertical. |
| Estado | Refere-se ao estado de entrega do grupo de anúncios. Se reportar um grupo de anúncios eliminado, o campo ItemChanged é Estado, o campo HowChanged é Alterado e o campo NewValue é Eliminado. |
| Dias direcionados | Refere-se ao dia do destino DayTime. O ajuste da oferta também está incluído neste campo, delimitado do dia por um único caráter de barra vertical. |
| Modelo de controlo | Refere-se ao modelo de controlo do grupo de anúncios. |
Extensão de chamada
Quando o valor do campo ItemChanged é Extensão de chamada, o histórico de alterações dos seguintes atributos está disponível.
| Atributo Alterado | Descrição |
|---|---|
| Associação | Refere-se à associação de uma extensão de chamada com uma entidade. Por exemplo, se a extensão estiver associada a uma campanha, o valor do campo CampaignName é o nome da campanha associada, o valor do campo ItemChanged é Extensão de chamada, o valor do campo AttributeChanged é Associação e o valor do campo HowChanged é Adicionado. Como outro exemplo, se a extensão estiver associada ou desassociada a uma campanha, o respetivo NewValue ou OldValue é o nome da campanha e a coluna EntityName contém o nome da extensão de anúncio. |
| País/região | Refere-se ao país/região da extensão de chamada. |
| Número de Telefone | Refere-se ao número de telefone da extensão de chamada. |
| Mostrar site ou telemóvel | Refere-se a se o site deve ser apresentado com o número de telefone da extensão de chamada. Os valores possíveis nas colunas OldValue e NewValue são Telefone e Site e telemóvel. |
| Utilizar o número de reencaminhamento | Refere-se a se o reencaminhamento está configurado para a extensão de chamada. Os valores possíveis nas colunas OldValue e NewValue são Não e Sim. |
Campanha
Quando o valor do campo ItemChanged é Campanha, o histórico de alterações dos seguintes atributos está disponível.
| Atributo Alterado | Descrição |
|---|---|
| Nenhum (em branco) | Refere-se ao nome da campanha que foi adicionada. O valor do campo HowChanged correspondente é Adicionado. |
| Destino de localização avançado | Refere-se à opção de intenção do destino de localização associado à campanha. |
| Idade | Refere-se ao destino da idade. |
| Tipo de orçamento | Refere-se ao tipo de orçamento da campanha. Os valores possíveis nas colunas OldValue e NewValue são os seguintes: - O valor do destino diário (acelerado) corresponde à definição Daily Accelerated da aplicação Web Microsoft Advertising. - O valor do destino diário (padrão) corresponde à definição Microsoft Advertising Web application Daily Standard. |
| Prioridade da campanha | Refere-se à prioridade de uma campanha do Microsoft Shopping. |
| Parâmetros personalizados | Refere-se aos parâmetros personalizados da campanha. |
| Orçamento diário | Refere-se ao montante do orçamento diário da campanha. |
| Dia | Refere-se ao destino do dia que foi preterido após a versão 9 da API de Anúncios do Bing. |
| Dispositivo | Refere-se ao destino do dispositivo. |
| Distance | Refere-se à distância do destino radius. |
| Data de fim | Refere-se à data de fim agendada para o grupo de anúncios. |
| Hora de fim | Refere-se ao combinado para Hora e Para Minuto do destino DayTime. O ajuste da oferta também está incluído neste campo, delimitado desde o momento por um único caráter de barra vertical. |
| Sexo | Refere-se ao destino de género. |
| Hora | Refere-se ao destino de hora que foi preterido após a versão 9 da API de Anúncios do Bing. |
| Exclusão de IP | Refere-se às exclusões de IP criadas através da aplicação Web Microsoft Advertising. |
| Localização | Refere-se ao destino da localização. |
| Exclusão de localização | Refere-se à exclusão de localizações de um destino de localização. |
| Name | Refere-se ao nome da campanha que foi alterada. |
| Palavra-chave negativa | Refere-se a uma palavra-chave negativa associada à campanha. Atualizações a palavras-chave negativas são reportadas como uma alteração Removida e Adicionada em duas linhas. O registo Removido corresponde ao valor antigo e o registo Adicionado reflete o novo valor. |
| Estado da pausa | Refere-se a qualquer um dos estados em pausa da campanha. Os valores possíveis nas colunas OldValue e NewValue são "Budget Paused", "Budget and user Paused", "Not paused" e "Paused". |
| Filtro de produto | Refere-se ao âmbito ou condição do produto de uma campanha do Microsoft Shopping. Uma campanha do Microsoft Shopping pode ter múltiplas condições de produto e cada condição é representada separadamente na sua própria linha de relatório. |
| Orçamento partilhado | Refere-se ao orçamento partilhado por várias campanhas. |
| Exclusão de Site | Refere-se aos URLs negativos do site da campanha. Uma campanha pode ter múltiplas exclusões de sites e cada exclusão de site é representada separadamente na sua própria linha de relatório. |
| Data de início | Para utilização interna. |
| Hora de início | Refere-se ao combinado De Hora a Hora e A Partir do Minuto do destino DayTime. O ajuste da oferta também está incluído neste campo, delimitado desde o momento por um único caráter de barra vertical. |
| Estado | Refere-se ao estado de entrega da campanha. Se comunicar uma campanha eliminada, o campo ItemChanged é Estado, o campo HowChanged é Alterado e o campo NewValue é Eliminado. |
| Dias direcionados | Refere-se ao dia do destino DayTime. O ajuste da oferta também está incluído neste campo, delimitado do dia por um único caráter de barra vertical. |
| Modelo de controlo | Refere-se ao modelo de Controlo da campanha. |
Palavra-chave
Quando o valor do campo ItemChanged é Palavra-chave, o histórico de alterações dos seguintes atributos está disponível.
| Atributo Alterado | Descrição |
|---|---|
| Nenhum (em branco) | Refere-se ao texto da palavra-chave que foi adicionada. O valor do campo HowChanged correspondente é Adicionado. |
| Oferta de jogo abrangente | Refere-se ao valor da oferta de correspondência abrangente para a palavra-chave. |
| Oferta de correspondência de conteúdo | Refere-se ao valor da oferta de correspondência de conteúdo para a palavra-chave. |
| Parâmetros personalizados | Refere-se aos parâmetros personalizados da palavra-chave. |
| Estado editorial | Refere-se ao estado editorial da palavra-chave. Se a palavra-chave estiver pendente da revisão editorial offline, num relatório do histórico de alterações transferido, o estado editorial é representado como Pendente - Ativo ou Pendente - Inativo. Para obter mais informações, veja Entidades e Estado da Entrega. |
| Oferta de correspondência exata | Refere-se ao valor exato da oferta de correspondência para a palavra-chave. |
| Final URL | Refere-se ao URL Final da palavra-chave. |
| URL móvel | Refere-se ao URL Do Telemóvel Final da palavra-chave. |
| Tipo de correspondência | Refere-se ao tipo de correspondência de licitação para a palavra-chave. Não é possível atualizar o tipo de correspondência de licitação com a API de Anúncios do Bing; no entanto, é possível alterar o tipo de correspondência da oferta com a aplicação Web Microsoft Advertising. |
| Oferta de correspondência de expressão | Refere-se ao valor da oferta de correspondência da expressão para a palavra-chave. |
| Estado | Refere-se ao estado de entrega da palavra-chave. Se comunicar uma palavra-chave eliminada, o campo ItemChanged é Estado, o campo HowChanged é Alterado e o campo NewValue é Eliminado. |
| Modelo de controlo | Refere-se ao modelo de controlo da palavra-chave. |
Extensão de localização
Quando o valor do campo ItemChanged é Extensão de localização, o histórico de alterações dos seguintes atributos está disponível.
| Atributo Alterado | Descrição |
|---|---|
| Associação | Refere-se à associação de uma extensão de localização com uma entidade. Por exemplo, se a extensão estiver associada a uma campanha, o valor do campo CampaignName é o nome da campanha associada, o valor do campo ItemChanged é Extensão de localização, o valor do campo AttributeChanged é Associação e o valor do campo HowChanged é Adicionado. |
Lista de Palavras-chave Negativas
Quando o valor do campo ItemChanged é Lista de Palavras-chave Negativas, está disponível o histórico de alterações para os seguintes atributos.
| Atributo Alterado | Descrição |
|---|---|
| Associação | Refere-se à associação de uma Lista de Palavras-chave Negativas com uma campanha. Por exemplo, se a lista de palavras-chave negativas estiver associada a uma campanha, o valor do campo CampaignName é o nome da campanha associada, o valor do campo ItemChanged é Lista de Palavras-chave Negativas, o valor do campo AttributeChanged é Associação e o valor do campo HowChanged é Adicionado. |
| Palavra-chave negativa | Refere-se à palavra-chave negativa que foi adicionada ou removida da lista de palavras-chave negativas. |
| Nome da Lista de Palavras-chave Negativas | Refere-se ao nome da lista de palavras-chave negativas. |
Extensão de ligação de site
Quando o valor do campo ItemChanged é a extensão Sitelink, o histórico de alterações dos seguintes atributos está disponível.
| Atributo Alterado | Descrição |
|---|---|
| Associação | Refere-se à associação de uma extensão de sitelink a uma entidade. Por exemplo, se a extensão estiver associada a uma campanha, o valor do campo CampaignName é o nome da campanha associada, o valor do campo ItemChanged é a extensão Sitelink, o valor do campo AttributeChanged é Associação e o valor do campo HowChanged é Adicionado. |
| Parâmetros personalizados | Refere-se aos parâmetros personalizados de uma ligação de site. |
| URL de destino | Refere-se ao URL de destino da extensão de sitelink. |
| Apresentar Texto | Refere-se ao texto a apresentar da extensão de ligação de site. |
| Final URL | Refere-se ao URL final de uma ligação de site. |
| URL móvel | Refere-se ao URL Móvel Final de uma ligação de site. |
| Modelo de controlo | Refere-se ao modelo de controlo de uma ligação de site. |
Utilizador
Quando o valor do campo ItemChanged é Utilizador, está disponível o histórico de alterações para os seguintes atributos.
| Atributo Alterado | Descrição |
|---|---|
| Nenhum (em branco) | Refere-se ao nome de utilizador do utilizador que foi adicionado. O valor do campo HowChanged correspondente é Adicionado. |
| Código | Para utilização interna. |
| Refere-se ao endereço de e-mail de contacto do utilizador. | |
| First name | Refere-se ao nome próprio do utilizador. |
| Last name | Refere-se ao apelido do utilizador. |
| Estado | Refere-se ao estado do utilizador. |
Requisitos
Serviço: ReportingService.svc v13
Espaço de nomes: https://bingads.microsoft.com/Reporting/v13