Relatórios incrementais
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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=timestampSolicita 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=timestampSolicita 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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2023-12-14 UTC.
[null,null,["Última atualização 2023-12-14 UTC."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data into your workflows.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports allow you to retrieve only the data that has changed since your last request, making reports smaller and more efficient.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to periodically request full reports in addition to incremental reports to ensure all data is captured.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports can be requested based on either changed metrics or changed attributes using specific time range properties.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003echangedAttributesSinceTimestamp\u003c/code\u003e requests provide efficient updates for attributes, changes to parent attributes might not be reflected, necessitating awareness of potential data discrepancies.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows users to build custom reports and integrate data into their applications. It offers incremental reports, which retrieve only data that has changed since the last request, reducing report size. Users can request changes in metrics (`changedMetricsSinceTimestamp`) or attributes (`changedAttributesSinceTimestamp`). Full reports are still recommended periodically to ensure no data is missed. For `changedMetricsSinceTimestamp`, data must be segmented by day and should be requested every seven days. Changed attributes only report changes to the attribute itself, not inherited changes from parent.\n"],null,["# Incremental Reports\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\nInstead of receiving a dump of all data every time you request a report, you can\nperiodically request only the data that has changed since your last report. These\nincremental reports will likely be significantly smaller than a full report.\n\nIf you request incremental reports, you should be aware of the following:\n\n- It's still a good idea to request a full report every once in a while, just in case some incremental changes are lost. For example, if you request weekly incremental reports during January, at the end of February you should request a full report for January to make sure you get all of the January data.\n- Since it isn't always possible to determine if some entities have changed, an incremental report will contain an entity if Search Ads 360 even *suspects* that the entity has changed. This means that incremental reports might contain data that hasn't changed.\n\n\nTo request an incremental report, specify one of the following ` `[Reports.request.timeRange](/search-ads/v2/reference/reports#request.timeRange)`\n` properties:\n\n`changedMetricsSinceTimestamp=`*timestamp*\n\n: Requests metrics that have changed since the specified timestamp. Because metrics are\n stored at a daily granularity and might change for one day but not another, such\n requests must be segmented by day (the `date` column must be present). For\n example, a `keyword` report with the columns\n `clicks`, `actions`, and `date`, would\n return a row for each keyword and date in which the recorded number of\n clicks or actions has changed since the given timestamp.\n\n\n The timestamp must be no earlier than 8 days before the time of request. To capture\n all of the changing metrics, be sure to make a `changedMetricsSinceTimestamp`\n request at least once every 7 days, and make a full report for each date\n once the metrics have settled (it is safer to wait at least 7 days). An\n example pattern is to create two reports every day: an incremental\n report for metrics that have changed in the last 36 hours, and a full\n report for metrics that occurred 8 days ago.\n\n`changedAttributesSinceTimestamp=`*timestamp*\n\n: Requests attributes that have changed since the given timestamp. A\n `changedAttributesSinceTimestamp` request can only include\n attribute columns (no metric or segment columns), and does not work for\n raw event reports such as\n [`conversion`](/search-ads/v2/report-types/conversion) reports. For example, a\n `campaign` report with the columns `dailyBudget`\n and `campaignStartDate` would return a row for each campaign\n whose daily budget or start date has changed since the given timestamp.\n\n\n Note that changes to parent attributes are not captured in `changedAttributesSinceTimestamp` reports. For example a keyword may inherit its bid strategy from the parent ad group. Even if the ad group is assigned a new bid strategy, this keyword might not appear in the report. Attribute columns whose value depends on parent entities (and therefore could change without getting picked up by `changedAttributesSinceTimestamp` reports) usually have the prefix \"effective\", such as `effectiveLabelIds` or `effectiveBidStartegy`.\n\n \u003cbr /\u003e"]]
