Modelo de Reporting Service
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.
| Metadatos de encabezado | Descripción |
|---|---|
| Nombre del informe | ReportName que eligió cuando se envió el informe. |
| Hora del informe | 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. "
Para obtener más información sobre cada tipo de columnas disponibles, vea Atributos de informe y estadísticas de rendimiento.
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.
Las siguientes columnas de estadísticas de rendimiento del recurso compartido de impresiones y atributos son mutuamente excluyentes al enviar AccountPerformanceReportRequest y AdGroupPerformanceReportRequest.
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 |
|---|---|
| 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 |
|---|---|
| BidMatchType BudgetAssociationStatus BudgetName BudgetStatus DeviceOS Meta GoalType TopVsOther |
AbsoluteTopImpressionRatePercent AbsoluteTopImpressionShareLostToBudgetPercent AbsoluteTopImpressionShareLostToRankPercent AbsoluteTopImpressionSharePercent AudienceImpressionLostToBudgetPercent AudienceImpressionLostToRankPercent AudienceImpressionSharePercent Haga clic enSharePercent ExactMatchImpressionSharePercent ImpressionLostToBudgetPercent ImpressionLostToRankAggPercent ImpressionSharePercent RelativeCtr TopImpressionRatePercent TopImpressionShareLostToBudgetPercent TopImpressionShareLostToRankPercent TopImpressionSharePercent |
Los atributos siguientes están restringidos al enviar HotelDimensionPerformanceReportRequest.
| Atributos |
|---|
| AdId |
Los atributos siguientes están restringidos al enviar HotelGroupPerformanceReportRequest.
| Atributos |
|---|
| AdId |
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.
Consulta también
Atributos de informe y estadísticas de rendimiento
Tipos de informe
Solicitud y descarga de un informe
Direcciones del servicio web de la API de Bing Ads