Compartir a través de

Adquisiciones de aplicaciones

Usa este método en la API de análisis de Microsoft Store para obtener datos de adquisición agregados en formato JSON para una aplicación durante un intervalo de fechas determinado y otros filtros opcionales. Esta información también está disponible en el informe de Adquisiciones 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.

Solicitud

Sintaxis de la solicitud

Método Solicitud de URI
OBTENER https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions

Cabecera de solicitud

Cabecera Tipo Descripción
Autorización cuerda / cadena Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>.

Parámetros de solicitud

Parámetro Tipo Descripción Obligatorio
applicationId cuerda / cadena El ID de la tienda Store de la aplicación de la que deseas recuperar datos de adquisición. Sí
Fecha de inicio fecha Fecha de inicio del rango de fechas de adquisición de datos a recuperar. El valor predeterminado es la fecha actual. No
fecha de finalización fecha Fecha de finalización del intervalo de fechas de los datos de adquisición que se van a recuperar. El valor predeterminado es la fecha actual. No
Parte superior Int Número de filas de datos que se van a devolver en la solicitud. El valor máximo y el valor predeterminado si no se especifica es 10000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo siguiente que puede usar para solicitar la siguiente página de datos. No
saltarse Int Número de filas que se van a omitir en la consulta. Use este parámetro para paginar conjuntos de datos grandes. Por ejemplo, top=10000 y skip=0 recupera las primeras 10000 filas de datos, top=10000 y skip=10000 recupera las siguientes 10000 filas de datos, etc. No
filtro cuerda / cadena Una o varias instrucciones que filtran las filas de la respuesta. Cada declaración contiene un nombre de campo del cuerpo de respuesta y un valor que están asociados a los operadores eq o ne. Además, las declaraciones se pueden combinar usando y o o. Los valores de cadena deben estar delimitados por comillas simples en el parámetro del filtro . Por ejemplo, filtro=mercado eq 'US' y género eq 'm'.

Puede especificar los campos siguientes desde el cuerpo de la respuesta:

  • tipo de adquisición
  • Grupo de edad
  • storeClient
  • género
  • mercado
  • versión del sistema operativo
  • tipoDeDispositivo
  • nombre del pedido
 No
nivel de agregación cuerda / cadena Especifica el intervalo de tiempo para el que se van a recuperar los datos agregados. Puede ser una de las siguientes cadenas: día, semana o mes. Si no se especifica, el valor predeterminado es day. No
Ordenar por cuerda / cadena Instrucción que ordena los valores de los datos de resultado para cada adquisición. La sintaxis es orderby=field [order],field [order],.... El parámetro field puede ser una de las siguientes cadenas:
  • fecha
  • tipo de adquisición
  • Grupo de edad
  • storeClient
  • género
  • mercado
  • versión del sistema operativo
  • tipoDeDispositivo
  • nombre del pedido

El parámetro order es opcional y puede ser asc o desc para especificar el orden ascendente o descendente de cada campo. El valor predeterminado es asc.

Este es un ejemplo de cadena orderby: orderby=date,market

 No
groupby cuerda / cadena Instrucción que aplica la agregación de datos solo a los campos especificados. Puede especificar los siguientes campos:
  • fecha
  • Nombre de la aplicación
  • tipo de adquisición
  • Grupo de edad
  • storeClient
  • género
  • mercado
  • versión del sistema operativo
  • tipoDeDispositivo
  • nombre del pedido

Las filas de datos devueltas contendrán los campos especificados en el parámetro groupby , así como los siguientes:

  • fecha
  • Id de la aplicación
  • cantidadDeAdquisición

El parámetro groupby se puede usar con el parámetro aggregationLevel . Por ejemplo: &groupby=ageGroup,market&aggregationLevel=week

 No

Ejemplo de solicitud

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR&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/appacquisitions?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and gender eq 'm'  HTTP/1.1
Authorization: Bearer <your access token>

Respuesta

Cuerpo de respuesta

Importancia Tipo Descripción
Importancia arreglo Matriz de objetos que contienen datos de adquisición agregados para la aplicación. Para obtener más información sobre los datos de cada objeto, consulte la siguiente sección valores de adquisición.
@nextLink cuerda / cadena Si hay páginas adicionales de datos, esta cadena contiene un URI que puede usar para solicitar la siguiente página de datos. Por ejemplo, este valor se devuelve si el parámetro superior de la solicitud se establece en 10000, pero existen más de 10000 filas de datos de adquisición en la consulta.
Conteo Total Int Número total de filas en el resultado de los datos de la consulta.

Valores de adquisición

Los elementos de la matriz Value contienen los valores siguientes.

Importancia Tipo Descripción
fecha cuerda / cadena La primera fecha en el rango de fechas para los datos de adquisición. Si la solicitud especificó un solo día, este valor es esa fecha. Si la solicitud especificó una semana, mes u otro intervalo de fechas, este valor es la primera fecha de ese intervalo de fechas.
applicationId cuerda / cadena El identificador de la tienda de la app para la cual recuperas los datos de adquisición.
Nombre de la aplicación cuerda / cadena Nombre visible de la aplicación.
tipo de dispositivo cuerda / cadena Una de las siguientes cadenas que especifica el tipo de dispositivo en el que se produjo la adquisición:
  • PC
  • Teléfono
  • Console-Xbox Uno
  • Console-Xbox Serie X
  • Internet de las Cosas
  • Holográfico
  • Desconocido
nombre de pedido cuerda / cadena Nombre del pedido.
storeClient cuerda / cadena Una de las siguientes cadenas que indica la versión de store donde se produjo la adquisición:
  • Cliente de la Tienda de Windows Phone
  • Microsoft Store (cliente) (o Tienda Windows (cliente) si se consulta datos antes del 23 de marzo de 2018)
  • Microsoft Store (web) (o Tienda de Windows (web) si consulta datos antes del 23 de marzo de 2018)
  • Compra por volumen por parte de organizaciones
  • Otros
osVersion cuerda / cadena Una de las siguientes cadenas que especifica la versión del sistema operativo en la que se produjo la adquisición:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Desconocido
mercado cuerda / cadena El código de país ISO 3166 del mercado donde se produjo la adquisición.
género cuerda / cadena Una de las siguientes cadenas que especifica el género del usuario que realizó la adquisición:
  • m
  • f
  • Desconocido
grupo de edad cuerda / cadena Una de las siguientes cadenas que especifica el grupo de edad del usuario que realizó la adquisición:
  • menor que 13
  • 13-17
  • 18-24
  • 25-34
  • 35-44
  • 44-55
  • mayor que 55
  • Desconocido
tipo de adquisición cuerda / cadena Una de las siguientes cadenas que indica el tipo de adquisición:
  • Gratis
  • Juicio
  • Pagado
  • código promocional
  • Iap
  • Iap de suscripción
  • Audiencia Privada
  • Pedido previo
  • Xbox Game Pass (o Game Pass si consulta datos antes del 23 de marzo de 2018)
  • Disco
  • código prepago
cantidadDeAdquisición número Número de adquisiciones que se produjeron durante el nivel de agregación especificado.

Ejemplo de solicitud y respuesta

En los fragmentos de código siguientes se muestran algunos ejemplos de solicitud y cuerpo de respuesta JSON para esa solicitud.

Solicitud de ejemplo

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR  HTTP/1.1
Authorization: Bearer <your access token>

Respuesta de ejemplo

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "date": "2022-07-29",
            "acquisitionQuantity": 7,
            "purchasePriceUSDAmount": 0.0,
            "purchasePriceLocalAmount": 0.0,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
  ],
  "TotalCount": 1,
  "DataFreshnessTimestamp": "2022-07-29T08:42:00"
}

Solicitud de ejemplo

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR&startDate=8/1/2021&endDate=12/21/2021&skip=0&filter=market&groupby=date,applicationName,acquisitionType,ageGroup,storeClient,gender,market,osVersion,deviceType  HTTP/1.1
Authorization: Bearer <your access token>

Respuesta de ejemplo

	{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "acquisitionType": "Free",
            "storeClient": "Microsoft Store (client)",
            "gender": "f",
            "market": "TW",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "date": "2021-08-01",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 0.0,
            "purchasePriceLocalAmount": 0.0,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "acquisitionType": "Free",
            "storeClient": "Microsoft Store (client)",
            "gender": "Unknown",
            "market": "BR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "date": "2021-08-01",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 0.0,
            "purchasePriceLocalAmount": 0.0,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
      ],  
  "TotalCount": 2,
  "DataFreshnessTimestamp": "2022-07-29T08:42:00"
 }
  • Last updated on