Modelo de servicio de informes

El servicio de informes contiene las operaciones que se utilizan para enviar solicitudes de informe y sondear su estado. Los informes proporcionan estadísticas detalladas sobre cuentas, campañas y grupos de anuncios de Microsoft Advertising. La información puede ayudarte a realizar un seguimiento de las finanzas, medir el rendimiento de los anuncios y ajustar la configuración para optimizar el presupuesto o la campaña. Por ejemplo, puedes usar el informe de rendimiento de palabras clave para ver qué palabras clave tienen un buen rendimiento y cuáles no.

Introducción a Reporting Services

Al enviar una solicitud de informe, elija los atributos del informe y las estadísticas de rendimiento para determinar el contenido del informe. Por ejemplo, puede que quieras incluir las impresiones, los clics y la tasa click-through. El informe usa los nombres de columna como encabezados de columna. El informe incluye las columnas en el mismo orden en que se incluyen en el elemento Columnas de la solicitud de informe. Para obtener información acerca de cómo afectan las columnas a la salida de datos, vea Columnas que agrupan los datos a continuación. Para obtener información sobre las restricciones en las combinaciones de columnas en la misma solicitud de informe, consulte Restricciones de columna a continuación.

También especificará los parámetros del informe que restringen o limitan el conjunto de datos devuelto. Por ejemplo, puede establecer el nivel de agregación para agrupar los datos por día o mes; especifica el período de tiempo de los datos que se incluirán en el informe mediante fechas específicas o intervalos de fechas predefinidos, como hoy o los últimos siete días; especifica el ámbito de los datos identificando las cuentas, campañas y grupos de anuncios que quieres incluir en el informe; y establezca criterios de filtro para filtrar los datos del informe. Para obtener información sobre los períodos de tiempo que puede especificar para cada valor de agregación, consulte Agregación y tiempo a continuación.

Para obtener una lista de informes que puede solicitar, consulte Tipos de informes. Para obtener una lista completa de los parámetros de informe que puede establecer, vea cada objeto de solicitud de informe y el objeto base ReportRequest .

Para obtener información sobre cómo solicitar y descargar un informe, consulte Solicitar y descargar un informeCuando el informe se complete correctamente, puede descargarlo desde la dirección URL que devuelve el servicio. El archivo de informe está comprimido, por lo que debe descomprimir el archivo para leer el informe. No hay límite en el número de informes que el sistema puede almacenar; Sin embargo, el período de tiempo que se almacenan los informes no está definido. El servicio no comprueba si hay solicitudes de informes duplicadas.

Para obtener información acerca de cómo afecta la zona horaria a la disponibilidad de los informes, consulte Zonas horarias en Informes a continuación.

Esquema de archivo de informe

Puede solicitar datos de informes Csv, Tsv o Xml. De forma predeterminada, si no elige otro formato , los datos descargados se separan por comas (CSV).

"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 10:15:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 10:15:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 5"

"AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","Computer","35"
"YourAccountId","YourCampaignId","red shoes","123","Smartphone","50"
"YourAccountId","YourCampaignId","shoes delivered","234","Computer","1"
"YourAccountId","YourCampaignId","shoe sale","345","Computer","80"
"YourAccountId","YourCampaignId","shoe sale","345","Smartphone","5"

"@2020 Microsoft Corporation. All rights reserved. "

Los siguientes metadatos del encabezado del informe se incluyen de forma predeterminada. Si no desea que los metadatos del encabezado se establezcan en "true".

Metadatos de encabezado Description
Nombre del informe NombreDeInforme que eligió cuando se envió el informe.
Hora del informe La hora del informe que elegiste cuando se envió el informe. Si se solicitaron varios días, las fechas de inicio y finalización se separarán con una coma, por ejemplo, "Hora del informe: 1/2/2020, 7/2/2020".
Zona horaria Indica la zona horaria que se usó para determinar el final del último día de la hora del informe solicitado. Para obtener información acerca de cómo afecta la zona horaria a la disponibilidad de los informes, consulte Zonas horarias en Informes a continuación.
Último día disponible completado La fecha y hora más recientes en que Microsoft Advertising terminó de procesar los datos para este tipo de informe. La hora siempre se notifica en relación con la hora UTC, por lo que ignore el sufijo (GMT) que está escrito en el informe.
Última hora disponible completada La fecha y hora más recientes en que Microsoft Advertising terminó de procesar los datos para este tipo de informe. La hora siempre se notifica en relación con la hora UTC, por lo que ignore el sufijo (GMT) que está escrito en el informe.
Agregación de informes Refleja el tipo de agregación que se estableció en la solicitud de informe. Para obtener información, consulte Agregación y tiempo a continuación.
Filtro de informe Reservado para uso futuro.
Posibles datos incompletos Si se establece en true , es posible que los datos del informe no se procesen por completo durante el último día de la hora del informe solicitado.

El elemento de solicitud ReturnOnlyCompleteData determina si el servicio debe asegurarse o no de que todos los datos se han procesado y están disponibles. Para obtener información acerca de cómo afecta la zona horaria a la disponibilidad de los informes, consulte Zonas horarias en Informes a continuación.
Rows Recuento de datos de registro del informe, salvo las líneas en blanco, los nombres de encabezado y columna y los metadatos de pie de página. Estos metadatos no están disponibles en los informes Xml.

Los nombres de columna del informe, por ejemplo, "AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks" se incluyen de forma predeterminada. Si no desea que las columnas del informe, establezca ExcludeColumnHeaders en true.

Los metadatos del pie de página, por ejemplo, @2020 Microsoft Corporation. Todos los derechos reservados. se incluye de forma predeterminada. Si no desea que los metadatos del pie de página se establezcan en "true".

Versión de formato de informe

El formato de datos de determinados campos se puede actualizar dentro de la versión actual de la API sin interrumpir las aplicaciones cliente existentes. Puede obtener el formato de datos más reciente estableciendo el campo de solicitud opcional FormatVersion . En la siguiente tabla se resume la diferencia entre la versión de formato 1.0 y la 2.0.

Description Columnas del informe Ejemplo de FormatVersion 1.0 Ejemplo de FormatVersion 2.0
Se quita el delimitador de grupo de miles (coma). Todos los ingresos

Asistencias

Costo extendido

Ingresos
1,000.00 1000.00
La precisión se actualiza de 4 dígitos a 2 dígitos. LowQualityClicksPercent

LowQualityImpressionsPercent

Ptr
12.3400 12.34
La precisión se actualiza de 0 a 2 dígitos. AbsoluteTopImpressionShareLostToBudgetPercent

AbsoluteTopImpressionShareLostToRankPercent

ExactMatchImpressionSharePercent

ImpressionLostToBudgetPercent

ImpressionLostToRankAggPercent

ImpressionSharePercent

TopImpressionShareLostToBudgetPercent

TopImpressionShareLostToRankPercent
12 12.34
Se ha actualizado el formato del informe por hora de "dd/mm/aaaa 12:00:00 AM|hora" a "aaaa-mm-dd|hora". Este formato solo se aplica a la columna TimePeriod si la agregación de informes se establece en Hourly. Período de tiempo "3/15/2020 12:00:00 AM|7" "2020-03-15|7|7"

Columnas que agrupan los datos

Las columnas de atributo que se incluyen en un informe afectan a los valores de las columnas de estadísticas, así como al número o filas. Por ejemplo, si solicita un informe de resumen que incluya solo AccountId, CampaignId, Keyword, KeywordId y Clicks, la columna clics contendrá el número de clics de la palabra clave, independientemente de los atributos excluidos, como el dispositivo, el tipo de coincidencia y la red.

"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 2:55:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 2:55:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 3"

"AccountId","CampaignId","Keyword","KeywordId","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","95"
"YourAccountId","YourCampaignId","shoes delivered","234","1"
"YourAccountId","YourCampaignId","shoe sale","345","98"

"@2020 Microsoft Corporation. All rights reserved. "

Si incluyes la columna DeviceType , el informe contendrá una fila por cada combinación única de valores de palabra clave y tipo de dispositivo, y el valor de la columna clics para cada fila se desglosará en consecuencia.

"Report Name: My Keyword Performance Report"
"Report Time: 2/7/2020"
"Time Zone: (GMT-08:00) Pacific Time (US & Canada); Tijuana"
"Last Completed Available Day: 2/8/2020 2:55:00 PM (GMT)"
"Last Completed Available Hour: 2/8/2020 2:55:00 PM (GMT)"
"Report Aggregation: Summary"
"Report Filter: "
"Potential Incomplete Data: true"
"Rows: 7"

"AccountId","CampaignId","Keyword","KeywordId","DeviceType","Clicks"
"YourAccountId","YourCampaignId","red shoes","123","Computer","35"
"YourAccountId","YourCampaignId","red shoes","123","Smartphone","50"
"YourAccountId","YourCampaignId","red shoes","123","Tablet","10"
"YourAccountId","YourCampaignId","shoes delivered","234","Computer","1"
"YourAccountId","YourCampaignId","shoe sale","345","Computer","80"
"YourAccountId","YourCampaignId","shoe sale","345","Smartphone","5"
"YourAccountId","YourCampaignId","shoe sale","345","Tablet","13"

"@2020 Microsoft Corporation. All rights reserved. "

Para obtener más información sobre cada tipo de columnas disponibles, vea Atributos del informe y Estadísticas de rendimiento.

El atributo TimePeriod es necesario para la mayoría de los informes, por lo que también debe considerar que especificar un período de agregación más granular, por ejemplo, mensualmente en el elemento de agregación de la solicitud de informe, desglosaría aún más los datos de clics por mes. Por ejemplo, el informe contendría una fila para cada combinación única de palabra clave, dispositivo y mes. La fila se incluye solo para los meses que contienen clics.

Restricciones de columna

En el caso de los informes que incluyen columnas de estadísticas de rendimiento de participación de impresiones, no se pueden incluir atributos restringidos en la misma solicitud de informe. Si incluyes cualquiera de las columnas de estadísticas de rendimiento de la participación de impresiones, debes excluir todas las columnas de atributo siguientes. Del mismo modo, si incluyes cualquiera de las siguientes columnas de atributos, debes excluir todas las columnas de estadísticas de rendimiento de la participación de impresiones.

Las siguientes columnas de estadísticas de rendimiento de atributos y de participación de impresiones son mutuamente excluyentes al enviar AccountPerformanceReportRequest y AdGroupPerformanceReportRequest.

Nota:

Además, si incluye cualquiera de las columnas de atributo AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent o RelativeCtr, debe excluir las columnas de atributo CustomerId, CustomerName y DeliveredMatchType y viceversa.

Atributos Estadísticas de rendimiento de la participación de impresiones
BidMatchType

DeviceOS

Meta

Tipo de gol

TopVsOther
AbsoluteTopImpressionRatePercent

AbsoluteTopImpressionShareLostToBudgetPercent

AbsoluteTopImpressionShareLostToRankPercent

AbsoluteTopImpressionSharePercent

AudienceImpressionLostToBudgetPercent

AudienceImpressionLostToRankPercent

AudienceImpressionSharePercent

ClickSharePercent

ExactMatchImpressionSharePercent

ImpressionLostToBudgetPercent

ImpressionLostToRankAggPercent

ImpressionSharePercent

RelativeCtr

Las siguientes columnas de estadísticas de rendimiento de atributos y de participación de impresiones son mutuamente excluyentes al enviar CampaignPerformanceReportRequest.

Nota:

Además, si incluye cualquiera de las columnas de atributo AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent o RelativeCtr, debe excluir las columnas de atributo CustomerId, CustomerName y DeliveredMatchType y viceversa.

Atributos Estadísticas de rendimiento de la participación de impresiones
BidMatchType

BudgetAssociationStatus

Nombre del presupuesto

BudgetStatus

DeviceOS

Meta

Tipo de gol

TopVsOther
AbsoluteTopImpressionRatePercent

AbsoluteTopImpressionShareLostToBudgetPercent

AbsoluteTopImpressionShareLostToRankPercent

AbsoluteTopImpressionSharePercent

AudienceImpressionLostToBudgetPercent

AudienceImpressionLostToRankPercent

AudienceImpressionSharePercent

ClickSharePercent

ExactMatchImpressionSharePercent

ImpressionLostToBudgetPercent

ImpressionLostToRankAggPercent

ImpressionSharePercent

RelativeCtr

TopImpressionRatePercent

TopImpressionShareLostToBudgetPercent

TopImpressionShareLostToRankPercent

TopImpressionSharePercent

Los siguientes atributos están restringidos al enviar HotelDimensionPerformanceReportRequest.

Atributos
AdId

Los siguientes atributos están restringidos al enviar la solicitud HotelGroupPerformanceReportRequest.

Atributos
AdId

Las siguientes columnas de estadísticas de rendimiento de atributos y de participación de impresiones son mutuamente excluyentes al enviar ProductDimensionPerformanceReportRequest.

Atributos Estadísticas de rendimiento de la participación de impresiones
Distribución de anuncios

AdId

Estado del anuncio

ClickType

ClickTypeId

Meta

Tipo de gol

Idioma

LocalStoreCode

Red

TopVsOther
AbsoluteTopImpressionShareLostToBudgetPercent

AbsoluteTopImpressionShareLostToRankPercent

AbsoluteTopImpressionSharePercent

Oferta de banco de pruebas

BenchmarkCtr

ClickSharePercent

ImpressionLostToBudgetPercent

ImpressionLostToRankPercent

ImpressionSharePercent

TopImpressionShareLostToBudgetPercent

TopImpressionShareLostToRankPercent

TopImpressionSharePercent

Las siguientes columnas de estadísticas de rendimiento de atributos y de participación de impresiones son mutuamente excluyentes al enviar ProductPartitionPerformanceReportRequest.

Atributos Estadísticas de rendimiento de la participación de impresiones
Distribución de anuncios

AdId

Estado del anuncio

BidMatchType

ClickType

ClickTypeId

DeliveredMatchType

Meta

Tipo de gol

Idioma

LocalStoreCode

Red

TopVsOther
AbsoluteTopImpressionSharePercent

Oferta de banco de pruebas

BenchmarkCtr

ClickSharePercent

ImpressionLostToBudgetPercent

ImpressionLostToRankPercent

ImpressionSharePercent

Columna de período de tiempo

Si incluyes la columna TimePeriod , el formato de los valores en el informe descargado variará en función del nivel de agregación de informes que especifiques en la solicitud de informe. Por ejemplo, si el nivel de agregación es Diario, cada campo de la columna PeríodoDeTiempo contendrá el día con formato aaaa-mm-dd.

Nota:

No se admite la agregación parcial de datos para las columnas de período de tiempo semanal, mensual y anual. Si las fechas seleccionadas no son semanas/meses/años completos y se solicita la columna de período de tiempo semanal/mensual/anual correspondiente, las fechas seleccionadas se convertirán en semanas/meses/años completos.

Agregación Description
Diario Cada fila del informe identifica el mes, el día y el año en que se produjo la transacción. Los datos del informe se agregarán por cada día. El período de tiempo tendrá el formato aaaa-mm-dd.
DayOfWeek Cada fila del informe identifica el día de la semana en que se produjo la transacción. Los datos del informe se agregarán por cada uno de los siete días de una semana. Los valores de datos posibles son 1 - a 7 , donde 1 representa el domingo y 7 representa el sábado. Si el tiempo del informe abarca varias semanas, los datos de rendimiento de todas las semanas para un día concreto de la semana se agregarán en una fila. Por ejemplo, si la campaña A tiene 5 impresiones cada lunes (día 2) a lo largo de cada una de las 3 semanas incluidas en el intervalo de tiempo del informe, el informe incluirá una fila con un 2 en la columna Período de tiempo y un total de 15 impresiones en esa fila.
Cada hora Cada fila del informe identifica la hora en que se produjo la transacción. Los datos del informe se agregarán por cada hora del día.

De forma predeterminada, el período de tiempo se formateará con la fecha y la hora (valor int) delimitadas por una sola canalización, es decir, "mm/dd/aaaa 12:00:00 AM|hora", donde se puede omitir 12:00:00 AM. Por ejemplo, si el clic se produjo el 15 de marzo de 2020 entre las 07:00 y las 08:00, el campo del informe descargado sería "15/3/2020 12:00:00 a. m|7". Si estableces el informe FormatVersion en "2.0", el período de tiempo tendrá el formato "aaaa-mm-dd|hora". Por ejemplo, si el clic se produjo el 15 de marzo de 2020 entre las 07:00 y las 08:00, el campo del informe descargado sería "15-03-2020|7".

Los valores posibles para el componente de hora son 0 - 23. Si el tiempo del informe abarca varios días, los datos de rendimiento de una hora determinada se proporcionarán por separado en varias filas; es decir, el informe incluirá una fila para cada día y hora únicos. Por ejemplo, si la campaña A tiene 5 impresiones durante la hora 7 en cada uno de los 3 días incluidos en el intervalo de tiempo del informe, el informe incluirá tres filas cada una con 5 impresiones para la hora 7.
HourOfDay Cada fila del informe identifica la hora del día en que se produjo la transacción. Los datos del informe se agregarán por cada una de las 24 horas a lo largo de todos los días. Los valores posibles son 0 - a 23. Si el tiempo del informe abarca varios días, los datos de rendimiento de todos los días de una hora determinada se agregarán en una fila. Por ejemplo, si la campaña A tiene 5 impresiones durante la hora 7 en cada uno de los 3 días incluidos en el intervalo de tiempo del informe, el informe incluirá una fila con un total de 15 impresiones para HourOfDay .
Mensualmente Cada fila del informe identifica el mes en que se produjo la transacción. Los datos del informe se agregarán por cada mes. El período de tiempo que contiene el primer día del mes tendrá el formato aaaa-mm-dd.
Semanal Cada fila del informe identifica la semana en que se produjo la transacción. Los datos del informe se agregarán por cada semana. El período de tiempo que contiene la fecha del domingo para cada semana tendrá el formato aaaa-mm-dd.
Anual Cada fila del informe identifica el año en que se produjo la transacción. Los datos del informe se agregarán por cada año. El período de tiempo que contiene el año tendrá el formato aaaa.

Agregación y tiempo

Para la mayoría de las solicitudes de informes, debe establecer los elementos de agregación y tiempo . A continuación se indican los períodos de tiempo que puede especificar para cada valor de agregación.

Valor de agregación Períodos de tiempo
Diario Today

Ayer

ÚltimasSevenDays

Este mes

Último mes

Intervalo de fechas personalizado
DayOfWeek Today

Ayer

ÚltimasSevenDays

Este mes

Último mes

ÚltimTresMeses

LastSixMonths
Cada hora Today

Ayer

Intervalo de fechas personalizado
HourOfDay Today

Ayer

ÚltimasSevenDays

Este mes

Último mes

ÚltimTresMeses

LastSixMonths
Mensualmente Este mes

Último mes

ÚltimTresMeses

LastSixMonths

ThisYear

Año pasado

Intervalo de fechas personalizado
Resumen Today

Ayer

ÚltimasSevenDays

Este mes

Último mes

Intervalo de fechas personalizado
Semanal Esta semana

Última semana

ÚltimasCuatro semanas

Este mes

Último mes

ThisYear

Año pasado

Intervalo de fechas personalizado
Anual ThisYear

Año pasado

Intervalo de fechas personalizado

Cero impresiones

Los datos del informe pueden incluir filas con cero impresiones si la impresión se produjo antes del período de tiempo solicitado y, luego, se produce una acción posterior, como un clic, una conversión o una llamada telefónica, durante el período de tiempo solicitado. Del mismo modo, incluso dentro del período de tiempo solicitado, si descarga un informe diario de rendimiento la semana pasada, es posible que todas las impresiones ocurrieran el domingo y luego se produjeran clics u otro rendimiento, por ejemplo, el lunes o el martes. Los datos del informe del lunes o martes pueden tener clics con cero impresiones. Puedes usar el servicio masivo o el servicio de administración de campañas para obtener todas las entidades de tu cuenta, independientemente de si tienen o no datos de rendimiento asociados.

Zonas horarias en los informes

Los datos del informe descargados siempre tienen relación con la hora UTC. Por ejemplo, un informe por hora podría atribuir 5 clics a la hora 7. En ese caso, los 5 clics se produjeron entre las 07:00 y las 08:00 UTC.

El elemento de solicitud ReportTimeZone determina la zona horaria que se usa para establecer la fecha actual. Al enviar la solicitud de informe, la fecha de hoy puede variar en todo el mundo, en función de la zona horaria. El período de tiempo del informe que elija, por ejemplo, "Ayer", será relativo a la fecha de hoy. Si no elige una zona horaria, el servicio de informes utiliza PacificTimeUSCanadaTijuana de forma predeterminada. Por ejemplo, un informe solicitado sin una zona horaria especificada a las 2 AM EasternTimeUSCanada el 2/2/2020 para "Ayer" se interpretará como una solicitud para el 31/1/2020. Un informe solicitado al mismo tiempo para 'Ayer' con la zona horaria establecida como EasternTimeUSCanada se interpretará como una solicitud para el 1/2/2020.

El elemento de solicitud ReturnOnlyCompleteData determina si el servicio debe asegurarse o no de que todos los datos se han procesado y están disponibles. Si se establece en true y si el sistema no ha terminado de procesar todos los datos en función de la agregación, el ámbito y la hora solicitados, el servicio devuelve el código de error NoCompleteDataAvaliable (2004). De lo contrario, de forma predeterminada, la solicitud puede prosperar, no hay ninguna indicación sobre si los datos están completos y el informe contendrá solo los datos que el sistema haya terminado de procesar en el momento de la solicitud. Aunque el día de hoy todavía está en curso, puede obtener los datos más recientes si no solicita los datos completados. Luego, después de que se cierren los libros del día, es posible que desee establecer esta bandera como verdadera y mirar hacia atrás a lo que ahora es 'Ayer' y obtener los datos del informe final.

Nota:

Si solicitas un informe para las campañas que tienen zonas horarias diferentes, los datos se considerarán completos solo después de que haya finalizado el día y se hayan procesado los datos de clics en todas las zonas horarias de la campaña. Por ejemplo, supongamos que solicita un informe que incluya la campaña A (que especifica la zona horaria PST) y la campaña B (que especifica la zona horaria EST), los datos no estarán completos hasta que se hayan procesado todos los datos de clics de la campaña A durante el período de tiempo especificado.

Cuando un usuario hace clic en un anuncio, el sistema puede tardar hasta dos horas en procesar el clic (3 horas para las conversiones) y hacer que esté disponible para los informes. Los datos generalmente se consideran completos con libros cerrados después de 3 horas. En algunos casos excepcionales debidos a tráfico no válido, podría haber ajustes inesperados que pudieran tardar una semana o más en resolverse. Por ejemplo, si una queja de anunciante identifica actividad de clic no válida que escapó del sistema de filtración automatizada, los equipos de soporte técnico y de calidad del tráfico procesarán un crédito en la cuenta del anunciante y se asociarán con los equipos internos para determinar si pueden actualizar los sistemas automatizados con el fin de mejorar la detección en el futuro. Para obtener más información, consulte el Centro de calidad del tráfico.

Métricas acreditadas por MRC

La métrica de clics de anuncios de búsqueda está acreditada por el Media Rating Council (MRC); Esta acreditación no se aplica a ninguna otra métrica. Consulta la descripción de la medición de clics de la metodología para obtener más información.

Consulta también

Atributos del informe y estadísticas de rendimiento
Tipos de informes
Solicitar y descargar un informe
Direcciones de servicios web de la API de Microsoft Advertising