Informes incrementales
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La nueva API de informes de Search Ads 360 ya está disponible. La nueva API proporciona una flexibilidad mejorada para crear informes personalizados y, además, integrar los datos en procesos y aplicaciones de informes. Obtén más información para migrar a la
nueva API de informes de Search Ads 360 y usarla.
En lugar de recibir un volcado de todos los datos cada vez que solicitas un informe, puedes solicitar de forma periódica solo los datos que cambiaron desde tu último informe. Es probable que estos
informes incrementales sean significativamente más pequeños que un informe completo.
Si solicitas informes incrementales, debes tener en cuenta lo siguiente:
- Aun así, es una buena idea solicitar un informe completo de vez en cuando, en caso de que se pierdan algunos cambios incrementales. Por ejemplo, si solicitas informes incrementales semanales durante enero, a fines de febrero, debes solicitar un informe completo de enero para asegurarte de obtener todos los datos de enero.
- Dado que no siempre es posible determinar si algunas entidades cambiaron, un informe incremental contendrá una entidad si Search Ads 360 incluso sospecea que la entidad cambió. Esto significa que los informes incrementales pueden contener datos que no cambiaron.
Para solicitar un informe incremental, especifica una de las siguientes propiedades de Reports.request.timeRange
:
changedMetricsSinceTimestamp=timestampSolicita métricas que cambiaron desde la marca de tiempo especificada. Debido a que las métricas se almacenan con un nivel de detalle diario y pueden cambiar durante un día, pero no durante otro, estas solicitudes deben segmentarse por día (la columna date debe estar presente). Por ejemplo, un informe keyword con las columnas clicks, actions y date mostraría una fila para cada palabra clave y fecha en la que la cantidad registrada de clics o acciones cambió desde la marca de tiempo determinada.
La marca de tiempo no debe ser anterior a 8 días antes del momento de la solicitud. Para capturar todas las métricas cambiantes, asegúrate de realizar una solicitud changedMetricsSinceTimestamp al menos una vez cada 7 días y generar un informe completo para cada fecha una vez que las métricas se hayan liquidado (es más seguro esperar al menos 7 días). Un
patrón de ejemplo es crear dos informes todos los días: un informe
incremental para las métricas que cambiaron en las últimas 36 horas y un informe
completo para las métricas que ocurrieron hace 8 días.
changedAttributesSinceTimestamp=timestampSolicita atributos que cambiaron desde la marca de tiempo determinada. Una solicitud changedAttributesSinceTimestamp solo puede incluir columnas de atributos (no columnas de métricas ni de segmentos) y no funciona para informes de eventos sin procesar como los informes conversion. Por ejemplo, un informe campaign con las columnas dailyBudget y campaignStartDate mostraría una fila para cada campaña cuyo presupuesto diario o fecha de inicio haya cambiado desde la marca de tiempo determinada.
Ten en cuenta que los cambios en los atributos superiores no se registran en los informes de
changedAttributesSinceTimestamp. Por ejemplo, una palabra clave puede heredar su estrategia de ofertas del grupo de anuncios superior.
Aunque se asigne una estrategia de oferta nueva al grupo de anuncios, es posible que esta palabra clave no aparezca en el informe. Las columnas de atributos cuyo valor depende de las entidades principales (y, por lo tanto, podrían cambiar sin que los informes changedAttributesSinceTimestamp los recojan) suelen tener el prefijo “vigente”, como effectiveLabelIds o effectiveBidStartegy.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2023-12-14 (UTC)
[null,null,["Última actualización: 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"]]
