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
datedebe estar presente). Por ejemplo, un informekeywordcon las columnasclicks,actionsydatemostrarí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
changedMetricsSinceTimestampal 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
changedAttributesSinceTimestampsolo puede incluir columnas de atributos (no columnas de métricas ni de segmentos) y no funciona para informes de eventos sin procesar como los informesconversion. Por ejemplo, un informecampaigncon las columnasdailyBudgetycampaignStartDatemostrarí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 dechangedAttributesSinceTimestamp. 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 informeschangedAttributesSinceTimestamplos recojan) suelen tener el prefijo “vigente”, comoeffectiveLabelIdsoeffectiveBidStartegy.