Informes incrementales

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=timestamp

Solicita 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=timestamp

Solicita 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.