Obtención de datos de rendimiento de anuncios

Usa este método en la API de análisis de Microsoft Store para obtener datos de rendimiento de anuncios agregados para tus aplicaciones durante un intervalo de fechas determinado y otros filtros opcionales. Este método devuelve los datos en formato JSON.

Este método devuelve los mismos datos que proporciona el informe de rendimiento de la publicidad en el Centro de Partners.

Prerrequisitos

Para usar este método, primero debe hacer lo siguiente:

• Si aún no lo ha hecho, complete todos los requisitos previos para la API de análisis de Microsoft Store.
• Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Después de obtener un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.

Para obtener más información, consulte Acceda a los datos de análisis utilizando los servicios de Microsoft Store.

Solicitud

Sintaxis de la solicitud

Cabecera de solicitud

Parámetros de solicitud

Para recuperar datos de rendimiento de anuncios para una aplicación específica, use el parámetro applicationId . Para recuperar los datos de rendimiento de los anuncios de todas las aplicaciones asociadas con la cuenta de desarrollador, omita el parámetro applicationId .

Filtrar campos

El parámetro de filtro del cuerpo de la solicitud contiene una o varias instrucciones que filtran las filas de la respuesta. Cada instrucción contiene un campo y un valor asociados a los operadores eq o ne , y las instrucciones se pueden combinar mediante yo . Aquí tienes un ejemplo de filtro , parámetro:

• filter=market eq 'US' y deviceType eq 'phone'

Para obtener una lista de los campos admitidos, consulte la tabla siguiente. Los valores de cadena deben estar delimitados por comillas simples en el parámetro del filtro .

Ejemplo de solicitud

En el ejemplo siguiente se muestran varias solicitudes para obtener datos de rendimiento de anuncios. Sustituya el valor de applicationId por el identificador de tienda para su aplicación.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/adsperformance?applicationId=9NBLGGH4R315&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0  HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/adsperformance?applicationId=9NBLGGH4R315&startDate=8/1/2015&endDate=8/31/2015&skip=0&$filter=market eq 'US' and deviceType eq 'phone’ eq 'US'; and gender eq 'm'  HTTP/1.1
Authorization: Bearer <your access token>

Respuesta

Cuerpo de respuesta

Valores de rendimiento de anuncios

Los elementos de la matriz Value contienen los valores siguientes.

Ejemplo de respuesta

En el ejemplo siguiente se muestra un cuerpo de respuesta JSON de ejemplo para esta solicitud.

{
  "Value": [
    {
      "date": "2015-03-09",
      "applicationId": "9NBLGGH4R315",
      "applicationName": "Contoso Demo",
      "market": "US",
      "deviceType": "phone",
      "adUnitId":"10765920",
      "adUnitName":"TestAdUnit",
      "revenueInAccountCurrency": 10.0,
      "impressions": 1000,
      "requests": 10000,
      "clicks": 1,
      "accountCurrencyCode":"USD"
    },
    {
      "date": "2015-03-09",
      "applicationId": "9NBLGGH4R315",
      "applicationName": "Contoso Demo",
      "market": "US",
      "deviceType": "phone",
      "adUnitId":"10795110",
      "adUnitName":"TestAdUnit2",
      "revenueInAccountCurrency": 20.0,
      "impressions": 2000,
      "requests": 20000,
      "clicks": 3,
      "accountCurrencyCode":"USD"
    },
  ],
  "@nextLink": "adsperformance?applicationId=9NBLGGH4R315&aggregationLevel=week&startDate=2015/03/01&endDate=2016/02/01&top=2&skip=2",
  "TotalCount": 191753
}

Temas relacionados

• informe de rendimiento de publicidad
• Acceso a datos de análisis mediante servicios de Microsoft Store