El servicio de informes contiene las operaciones que se usan 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 ayudarle 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, puede usar el informe de rendimiento de palabras clave para ver qué palabras clave tienen un buen rendimiento y las que no.
Información general sobre Reporting Service
Al enviar una solicitud de informe, elija atributos de informe y estadísticas de rendimiento para determinar el contenido del informe. Por ejemplo, puede incluir impresiones, clics y tasa de clics. 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 Columns de la solicitud de informe. Para obtener información sobre 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, vea 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; especifique el período de tiempo de los datos que se van a incluir en el informe mediante fechas específicas o intervalos de fechas predefinidos, como hoy o los últimos siete días; especifique el ámbito de los datos mediante la identificación de las cuentas, las campañas y los grupos de anuncios que se incluirán en el informe; y establecer 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 los informes que puede solicitar, consulte Tipos de informe. 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 Solicitud y descarga de un informeCuando el informe se complete correctamente, puede descargar el informe de 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 ningún 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 informe duplicadas.
Para obtener información sobre cómo afecta la zona horaria a la disponibilidad del informe, consulte Zonas horarias en Informes a continuación.
Esquema de archivo de informe
Puede solicitar datos de informe Csv, Tsv o Xml. De forma predeterminada, si no elige otro formato , los datos descargados están separados 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 de encabezado de informe se incluyen de forma predeterminada. Si no desea que el conjunto de metadatos de encabezado ExcludeReportHeader sea true.
La hora del informe que eligió cuando se envió el informe. Si se solicitaron varios días, la fecha de inicio y finalización se separará por una coma, por ejemplo, "Hora del informe: 2/1/2020, 2/7/2020".
Zona horaria
Indica qué zona horaria se usó para determinar el final del último día de la hora del informe solicitada. Para obtener información sobre cómo afecta la zona horaria a la disponibilidad del informe, consulte Zonas horarias en Informes a continuación.
Último día disponible completado
Fecha y hora más recientes en que Microsoft Advertising terminó de procesar datos para este tipo de informe. La hora siempre se notifica en relación con utc, por lo que debe omitir el sufijo (GMT) escrito en el informe.
Última hora disponible completada
Fecha y hora más recientes en que Microsoft Advertising terminó de procesar datos para este tipo de informe. La hora siempre se notifica en relación con utc, por lo que debe omitir el sufijo (GMT) 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, vea 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 solicitada.
El elemento de solicitud ReturnOnlyCompleteData determina si el servicio debe asegurarse de que todos los datos se han procesado y están disponibles. Para obtener información sobre cómo afecta la zona horaria a la disponibilidad del informe, consulte Zonas horarias en Informes a continuación.
Rows
Recuento de datos de registros de informe que excluyen el encabezado de líneas en blanco, los nombres de columna y los metadatos del 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 establezcan ExcludeColumnHeaders en true.
Metadatos del pie de página del informe, 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 establezca ExcludeReportFooter en true.
Versión del 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. Para obtener el formato de datos más reciente, establezca el campo de solicitud FormatVersion opcional. En la tabla siguiente se resume la diferencia entre el formato 1.0 y 2.0.
Descripción
Columnas de informe
Ejemplo de FormatVersion 1.0
Ejemplo de FormatVersion 2.0
Se quita el delimitador de grupo de miles (coma).
AllRevenue
Ayuda
ExtendedCost
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 dígitos a 2 dígitos.
AbsoluteTopImpressionShareLostToBudgetPercent
AbsoluteTopImpressionShareLostToRankPercent
ExactMatchImpressionSharePercent
ImpressionLostToBudgetPercent
ImpressionLostToRankAggPercent
ImpressionSharePercent
TopImpressionShareLostToBudgetPercent
TopImpressionShareLostToRankPercent
12
12.34
Formato de informe por hora actualizado de "mm/dd/aaaa 12:00:00 AM|hora" a "aaaa-mm-dd|hora". Este formato solo es aplicable a la columna TimePeriod si la agregación del informe está establecida en Hourly.
TimePeriod
"15/3/2020 12:00:00 AM|7"
"2020-03-15|7"
Columnas que agrupan los datos
Las columnas de atributos 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 clicks 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 luego incluye la columna DeviceType , el informe contendrá una fila para cada combinación única de valores de palabras clave y tipo de dispositivo, y el valor de la columna clics de cada fila se desglosa 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. "
El atributo TimePeriod es necesario para la mayoría de los informes, por lo que también debe tener en cuenta que especificar un período de agregación más pormenorizado, por ejemplo, mensualmente en el elemento Aggregation de la solicitud de informe, desglosaría aún más los datos de clic por mes. Por ejemplo, el informe contendrá una fila para cada combinación única de palabra clave, dispositivo y mes. La fila solo se incluye durante meses que contienen clics.
Restricciones de columna
En el caso de los informes que incluyen columnas de estadísticas de rendimiento del recurso compartido de impresiones, no se pueden incluir atributos restringidos en la misma solicitud de informe. Si incluye cualquiera de las columnas de estadísticas de rendimiento del recurso compartido de impresiones, debe excluir todas las columnas de atributo siguientes. Del mismo modo, si incluye cualquiera de las columnas de atributo siguientes, debe excluir todas las columnas de estadísticas de rendimiento del recurso compartido de impresiones.
Además, si incluye cualquiera de las columnas AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent o RelativeCtr, debe excluir las columnas de atributo CustomerId, CustomerName y DeliveredMatchType, y viceversa.
Atributos
Estadísticas de rendimiento del recurso compartido de impresiones
BidMatchType
DeviceOS
Meta
GoalType
TopVsOther
AbsoluteTopImpressionRatePercent
AbsoluteTopImpressionShareLostToBudgetPercent
AbsoluteTopImpressionShareLostToRankPercent
AbsoluteTopImpressionSharePercent
AudienceImpressionLostToBudgetPercent
AudienceImpressionLostToRankPercent
AudienceImpressionSharePercent
Haga clic enSharePercent
ExactMatchImpressionSharePercent
ImpressionLostToBudgetPercent
ImpressionLostToRankAggPercent
ImpressionSharePercent
RelativeCtr
Las siguientes columnas de estadísticas de rendimiento del recurso compartido de impresiones y atributos se excluyen mutuamente al enviar CampaignPerformanceReportRequest.
Nota
Además, si incluye cualquiera de las columnas AudienceImpressionLostToBudgetPercent, AudienceImpressionLostToRankPercent, AudienceImpressionSharePercent o RelativeCtr, debe excluir las columnas de atributo CustomerId, CustomerName y DeliveredMatchType, y viceversa.
Atributos
Estadísticas de rendimiento del recurso compartido de impresiones
Las siguientes columnas de estadísticas de rendimiento del recurso compartido de impresiones y atributos se excluyen mutuamente al enviar ProductDimensionPerformanceReportRequest.
Atributos
Estadísticas de rendimiento del recurso compartido de impresiones
AdDistribution
AdId
AdStatus
ClickType
ClickTypeId
Meta
GoalType
Idioma
LocalStoreCode
Red
TopVsOther
AbsoluteTopImpressionShareLostToBudgetPercent
AbsoluteTopImpressionShareLostToRankPercent
AbsoluteTopImpressionSharePercent
BenchmarkBid
BenchmarkCtr
Haga clic enSharePercent
ImpressionLostToBudgetPercent
ImpressionLostToRankPercent
ImpressionSharePercent
TopImpressionShareLostToBudgetPercent
TopImpressionShareLostToRankPercent
TopImpressionSharePercent
Las siguientes columnas de estadísticas de rendimiento del recurso compartido de impresiones y atributos se excluyen mutuamente al enviar ProductPartitionPerformanceReportRequest.
Atributos
Estadísticas de rendimiento del recurso compartido de impresiones
AdDistribution
AdId
AdStatus
BidMatchType
ClickType
ClickTypeId
DeliveredMatchType
Meta
GoalType
Idioma
LocalStoreCode
Red
TopVsOther
AbsoluteTopImpressionSharePercent
BenchmarkBid
BenchmarkCtr
Haga clic enSharePercent
ImpressionLostToBudgetPercent
ImpressionLostToRankPercent
ImpressionSharePercent
Columna Período de tiempo
Si incluye la columna TimePeriod , el formato de los valores del informe descargado variará en función del nivel de agregación del informe que especifique en la solicitud de informe. Por ejemplo, si el nivel de agregación es Diario, cada campo de la columna TimePeriod 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 completas/meses/años y se solicita la correspondiente columna de período de tiempo semanal, mensual o anual, las fechas seleccionadas se convertirán en semanas completas/meses/años.
Agregación
Descripción
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 cada día. El período de tiempo se formateará como 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 en cada uno de los siete días de una semana. Los valores de datos posibles son 1 - 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 de un día determinado 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 2 en la columna TimePeriod y las impresiones de esa fila con un total de 15.
Cada hora
Cada fila del informe identifica la hora en que se produjo la transacción. Los datos del informe se agregarán cada hora del día.
De forma predeterminada, el período de tiempo tendrá el formato de fecha y hora (valor int) delimitados por una sola canalización, es decir, "mm/dd/yyyy 12:00:00 AM|hour" donde se pueden omitir las 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 "3/15/2020 12:00:00 AM|7". Si establece formatVersion del informe 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 "2020-03-15|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 por 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 en cada una de las 24 horas de todos los días. Los valores posibles son 0 - 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 impresiones para HourOfDay que supondrán un total de 15.
Mensualmente
Cada fila del informe identifica el mes en que se produjo la transacción. Los datos del informe se agregarán 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 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 cada año. El período de tiempo que contiene el año tendrá el formato aaaa.
Agregación y hora
Para la mayoría de las solicitudes de informe, debe establecer los elementos Aggregation y Time . A continuación se muestran 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
LastSevenDays
ThisMonth
LastMonth
Intervalo de fechas personalizado
DayOfWeek
Today
Ayer
LastSevenDays
ThisMonth
LastMonth
LastThreeMonths
LastSixMonths
Cada hora
Today
Ayer
Intervalo de fechas personalizado
HourOfDay
Today
Ayer
LastSevenDays
ThisMonth
LastMonth
LastThreeMonths
LastSixMonths
Mensualmente
ThisMonth
LastMonth
LastThreeMonths
LastSixMonths
ThisYear
Último año
Intervalo de fechas personalizado
Resumen
Today
Ayer
LastSevenDays
ThisMonth
LastMonth
Intervalo de fechas personalizado
Semanal
ThisWeek
LastWeek
LastFourWeeks
ThisMonth
LastMonth
ThisYear
Último año
Intervalo de fechas personalizado
Anual
ThisYear
Último año
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, a continuación, se produce una acción posterior como clic, conversión o 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 se produjeran el domingo y, a continuación, se produjeran clics u otro rendimiento, por ejemplo, lunes o martes. Los datos del informe para el lunes o el martes pueden tener clics sin impresiones. Puede usar el Servicio masivo o el Servicio de administración de campañas para obtener todas las entidades de su cuenta, independientemente de si tienen o no datos de rendimiento asociados.
Zonas horarias en informes
Los datos del informe descargados siempre son relativos a 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 de hoy. 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" es relativo a la fecha de hoy. Si no elige una zona horaria, el servicio de informes usa PacificTimeUSCanadaTijuana de forma predeterminada. Por ejemplo, un informe solicitado sin una zona horaria especificada a las 2 AM EasternTimeUSCanada el 2/2/2020 para "Yesterday" se interpretará como una solicitud para el 1/31/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 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, la solicitud puede realizarse correctamente de forma predeterminada, no hay ninguna indicación de si los datos están completos y el informe solo contendrá los datos que el sistema haya terminado de procesar en el momento de la solicitud. Aunque hoy en día todavía está en curso, puede obtener los datos más actuales si no solicita los datos completados. Después de cerrar los libros para el día, es posible que quiera establecer esta marca como verdadera y volver a lo que ahora es "Ayer" y obtener los datos finales del informe.
Nota
Si solicita un informe para campañas que tienen zonas horarias diferentes, los datos se consideran completos solo una vez finalizado el día y los datos de clic se han procesado 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 se completan hasta que todos los datos de clic de la campaña A se hayan procesado 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 ponerlo a disposición de los informes. Por lo general, los datos se consideran completos con libros cerrados después de 3 horas. En algunos casos de excepción debido al tráfico no válido, podría haber ajustes inesperados que podrían tardar una semana o más en resolverse. Por ejemplo, si una queja de anunciante identifica la actividad de clic no válida que escapó del sistema de filtración automatizada, los equipos de calidad de tráfico y soporte técnico procesarán un crédito a la cuenta del anunciante y se asociarán con equipos internos para determinar si pueden actualizar sistemas automatizados con el fin de mejorar la detección en el futuro. Para obtener más información, consulte Traffic Quality Center.
Métricas acreditadas de 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. Consulte la descripción de la medición de clics de la metodología para obtener más información.
Planifique y diseñe la metodología de su proyecto para implementar correctamente aplicaciones de finanzas y operaciones con servicios FastTrack, administración de datos, etc.