SearchCampaignChangeHistoryReportRequest Data Object - Reporting

Artigo
12/21/2023

Define um pedido de relatório do histórico de alterações. Utilize este relatório para detetar quando foram efetuadas alterações a uma conta, bem como que utilizador efetuou as alterações.

Pode pedir um registo das alterações efetuadas pelo utilizador e pela data. Por exemplo, pode pedir um registo de alterações ao nome da campanha, à associação de destino de localização e à oferta de palavras-chave. Pode pedir o valor antigo e o novo valor no relatório.

Nota

Pode demorar aproximadamente uma hora a partir do momento em que uma entidade é adicionada, atualizada ou eliminada para que o histórico de alterações esteja disponível para relatórios.

Para pedir um relatório deste tipo, transmita este objeto para a operação SubmitGenerateReport .

Sintaxe

<xs:complexType name="SearchCampaignChangeHistoryReportRequest" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ReportRequest">
      <xs:sequence>
        <xs:element name="Columns" nillable="true" type="tns:ArrayOfSearchCampaignChangeHistoryReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:SearchCampaignChangeHistoryReportFilter" />
        <xs:element name="Scope" nillable="true" type="tns:AccountThroughAdGroupReportScope" />
        <xs:element name="Time" nillable="true" type="tns:ReportTime" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto SearchCampaignChangeHistoryReportRequest tem os seguintes elementos: Colunas, Filtro, Âmbito, Hora.

Elemento	Descrição	Tipo de Dados
Colunas	A lista de atributos e estatísticas de desempenho a incluir no relatório. O relatório incluirá as colunas pela ordem em que as especificar.	SearchCampaignChangeHistoryReportColumn array (Matriz SearchCampaignChangeHistoryReportColumn )
Filtro	As informações de filtro a utilizar para filtrar os dados do relatório.	SearchCampaignChangeHistoryReportFilter
Âmbito	O âmbito da entidade do relatório. Utilize este elemento para limitar os dados do relatório a contas, grupos de anúncios ou campanhas específicas. Para este relatório, só pode especificar um identificador de conta no elemento AccountIds do objeto AccountThroughAdGroupReportScope .	AccountThroughAdGroupReportScope
Hora	O período de tempo a utilizar para o relatório. Pode especificar um intervalo de datas personalizado ou selecionar um dos seguintes intervalos de datas predefinidos: LastSevenDays Último Mês LastThreeMonths Pode definir o fuso horário no objeto ReportTime , o que o ajuda a definir com precisão os dados para o período de tempo pedido. Se não escolher um fuso horário, o serviço de Relatórios utiliza PacificTimeUSCanadaT cache por predefinição.	ReportTime

O objeto SearchCampaignChangeHistoryReportRequest tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do ReportRequest

O objeto SearchCampaignChangeHistoryReportRequest deriva do objeto ReportRequest e herda os seguintes elementos: ExcludeColumnHeaders, ExcludeReportFooter, ExcludeReportHeader, Format, FormatVersion, ReportName, ReturnOnlyCompleteData. As descrições abaixo são específicas de SearchCampaignChangeHistoryReportRequest e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto ReportRequest .

Elemento	Descrição	Tipo de Dados
ExcludeColumnHeaders	Determina se o relatório transferido deve ou não conter descrições de cabeçalho para cada coluna. O cabeçalho da coluna do relatório corresponde ao nome da coluna pedido, por exemplo , Impressões e Cliques. Defina esta propriedade como true se pretender que os cabeçalhos das colunas do relatório sejam excluídos do relatório transferido. O valor predefinido é falso.	booleano
ExcludeReportFooter	Determina se o relatório transferido deve ou não conter metadados de rodapé, como direitos de autor da Microsoft (@2020 Microsoft Corporation. Todos os direitos reservados.). Defina esta propriedade como verdadeira se pretender que os metadados do rodapé do relatório sejam excluídos do relatório transferido. O valor predefinido é falso.	booleano
ExcludeReportHeader	Determina se o relatório transferido deve ou não conter metadados de cabeçalho, como o nome do relatório, o intervalo de datas e a agregação. Defina esta propriedade como verdadeira se pretender que os metadados do cabeçalho do relatório sejam excluídos do relatório transferido. O valor predefinido é falso.	booleano
Formatar	O formato dos dados do relatório. Por exemplo, pode pedir os dados no formato de valores separados por vírgulas (Csv) ou no formato de valores separados por tabulações (Tsv). O valor predefinido é Csv. Todos os ficheiros transferidos são comprimidos por ZIP.	Formatar Relatório
FormatVersion	Determina o formato de determinados campos no ficheiro de relatório transferido. O formato de dados para determinados campos pode ser atualizado na versão atual da API sem interromper as aplicações cliente existentes. Pode obter o formato de dados mais recente ao definir este campo de pedido opcional como 2.0. Se não definir este campo, o serviço é predefinido para a versão 1.0. Para obter detalhes sobre as alterações entre versões de formato, veja Versão do Formato do Relatório.	cadeia
ReportName	O nome do relatório. O nome está incluído no cabeçalho do relatório. Se não especificar um nome de relatório, o sistema gera um nome no formulário ReportType-ReportDateTime. O comprimento máximo do nome do relatório é 200.	cadeia
ReturnOnlyCompleteData	Determina se o serviço tem ou não de garantir que todos os dados foram processados e estão disponíveis. Se estiver definido como verdadeiro e se o sistema não tiver concluído o processamento de todos os dados com base no Âmbito e Hora pedidos, o serviço devolve o código de erro NoCompleteDataAvaliable (2004). Caso contrário, por predefinição, o pedido pode ser bem-sucedido, não existe nenhuma indicação sobre se os dados estão concluídos e o relatório conterá apenas os dados que o sistema concluiu o processamento no momento do pedido. Tenha em atenção que, uma vez que hoje ainda está em curso e os dados não estão concluídos, não pode definir este elemento como verdadeiro se o Período de tempo (quer seja uma data personalizada ou predefinida) incluir a data atual. Para obter mais informações, veja Fusos Horários em Relatórios.	booleano

Requisitos

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

Partilhar via