Relatórios incrementais

A nova API Search Ads 360 Reporting já está disponível. Ela oferece mais flexibilidade para criar relatórios personalizados e integrar os dados aos seus aplicativos e processos relacionados à geração de relatórios. Saiba mais sobre como migrar e usar a nova API Search Ads 360 Reporting.

Em vez de receber um despejo de todos os dados sempre que solicita um relatório, você pode solicitar periodicamente apenas os dados que foram alterados desde o último relatório. Esses relatórios incrementais provavelmente serão significativamente menores do que um relatório completo.

Se você solicitar relatórios incrementais, esteja ciente do seguinte:

• Ainda é recomendável solicitar um relatório completo de vez em quando, caso algumas alterações incrementais sejam perdidas. Por exemplo, se você solicitar relatórios incrementais semanais em janeiro, no final de fevereiro, precisará pedir um relatório completo de janeiro para ter certeza de que recebeu todos os dados de janeiro.
• Como nem sempre é possível determinar se algumas entidades mudaram, um relatório incremental conterá uma entidade caso o Search Ads 360 mesmo suspeite que a entidade mudou. Isso significa que os relatórios incrementais podem conter dados que não foram alterados.

Para solicitar um relatório incremental, especifique uma destas propriedades Reports.request.timeRange :

changedMetricsSinceTimestamp=timestamp

Solicita métricas que foram alteradas desde o carimbo de data/hora especificado. Como as métricas são armazenadas em uma granularidade diária e podem mudar durante um dia, mas não em outro, essas solicitações precisam ser segmentadas por dia (a coluna date precisa estar presente). Por exemplo, um relatório keyword com as colunas clicks, actions e date retornaria uma linha para cada palavra-chave e data em que o número registrado de cliques ou ações mudou desde o carimbo de data/hora especificado.

O carimbo de data/hora não pode ser anterior a oito dias antes do horário da solicitação. Para capturar todas as métricas alteradas, faça uma solicitação changedMetricsSinceTimestamp pelo menos uma vez a cada sete dias e gere um relatório completo para cada data quando as métricas forem resolvidas. É mais seguro esperar pelo menos sete dias. Um exemplo de padrão é criar dois relatórios todos os dias: um incremental para métricas que foram alteradas nas últimas 36 horas e um relatório completo para métricas que ocorreram há 8 dias.

changedAttributesSinceTimestamp=timestamp

Solicita atributos que foram alterados desde o carimbo de data/hora fornecido. Uma solicitação changedAttributesSinceTimestamp só pode incluir colunas de atributos (nenhuma coluna de métrica ou segmento) e não funciona com relatórios de eventos brutos, como relatórios conversion. Por exemplo, um relatório campaign com as colunas dailyBudget e campaignStartDate retornaria uma linha para cada campanha cujo orçamento diário ou data de início tenha sido alterado desde o carimbo de data/hora especificado.

As mudanças nos atributos pai não são capturadas nos relatórios changedAttributesSinceTimestamp. Por exemplo, uma palavra-chave pode herdar a própria estratégia de lances do grupo de anúncios principal. Mesmo que o grupo de anúncios receba uma nova estratégia de lances, é possível que a palavra-chave não apareça no relatório. As colunas de atributos cujo valor depende de entidades pai (e, portanto, podem mudar sem serem selecionados por relatórios changedAttributesSinceTimestamp) geralmente têm o prefixo "efetivo", como effectiveLabelIds ou effectiveBidStartegy.