Adquisiciones de complementos

Usa este método en la API de análisis de Microsoft Store para obtener datos de adquisición agregados para complementos para tu aplicación en formato JSON durante un intervalo de fechas determinado y otros filtros opcionales. Esta información también está disponible en el informe de adquisiciones de complementos en el Centro de socios.

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

Cabecera de solicitud

Parámetros de solicitud

Se requiere el parámetro applicationId o inAppProductId . Para recuperar los datos de adquisición de todos los complementos registrados en la aplicación, especifique el parámetro applicationId . Para recuperar los datos de adquisición de un único complemento, especifique el parámetro inAppProductId . Si especifica ambos, se omite el parámetro applicationId .

Filtrar campos

El parámetro de filtro de la solicitud contiene una o varias declaraciones 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 . Estos son algunos parámetros de filtro de ejemplo:

• filtro=equación de mercado 'EE.UU.' y equación de género 'm'
• filtro=(mercado ne 'EE. UU.') y (género ne 'Desconocido') y (género ne 'm') y (mercado ne 'NO') y (grupo de edad ne 'mayor de 55' o grupo de edad ne 'menor de 13')

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 los ejemplos siguientes se demuestra cómo realizar varias solicitudes para obtener datos de adquisición de complementos. Reemplace los valores inAppProductId y applicationId por el identificador de la Tienda adecuado para el complemento o la aplicación.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappacquisitions?inAppProductId=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/inappacquisitions?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/inappacquisitions?inAppProductId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=7/3/2015&top=100&skip=0&filter=market ne 'US' and gender ne 'Unknown' and gender ne 'm' and market ne 'NO' and ageGroup ne '>55' HTTP/1.1
Authorization: Bearer <your access token>

Respuesta

Cuerpo de respuesta

Valores de adquisición de complementos

Los elementos de la matriz Value contienen los valores siguientes.

Ejemplo de solicitud y respuesta

En el fragmento de código siguiente se muestra un ejemplo de solicitud y un cuerpo de respuesta JSON para esa solicitud.

Solicitud de ejemplo

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

Respuesta de ejemplo

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Deluxe Collector's Edition",
            "addonProductId": "9NBLGGAAGZDQ",
            "date": "2022-07-29",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 18.12,
            "purchasePriceLocalAmount": 18.12,
            "purchaseTaxUSDAmount": 1.13,
            "purchaseTaxLocalAmount": 1.13
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Episode 4",
            "addonProductId": "9NAAAAAAAAAQ",
            "date": "2017-01-07",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 4.147206,
            "purchasePriceLocalAmount": 3.99,
            "purchaseTaxUSDAmount": 0.686004,
            "purchaseTaxLocalAmount": 0.66
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Deluxe Collector's Edition",
            "addonProductId": "9NALGGGZ5QDQ",
            "date": "2018-04-01",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 1.99,
            "purchasePriceLocalAmount": 1.99,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Strategy Guide Episode 4",
            "addonProductId": "9NBLGGGZ5QDQ",
            "date": "2021-11-25",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 1.31902922876179,
            "purchasePriceLocalAmount": 150.0,
            "purchaseTaxUSDAmount": 0.114315866492689,
            "purchaseTaxLocalAmount": 13.0
        },
    ],
    "TotalCount": 4,
    "DataFreshnessTimestamp": "2022-07-29T05:54:00"
}

Temas relacionados

• Informe de adquisiciones de complementos
• Acceso a datos de análisis mediante servicios de Microsoft Store
• Conseguir conversiones adicionales por canal
• Obtener los datos de las adquisiciones de la aplicación
• Obtener datos de embudo de adquisiciones de aplicaciones
• Obtención de conversiones de aplicaciones por canal