Compartir a través de

Obtención de datos de embudo de adquisición de aplicaciones

Usa este método en la API de análisis de Microsoft Store para obtener datos de embudo de adquisición 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/funnel

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 La ID de la Tienda de la aplicación para la que quiera obtener los datos del embudo de adquisición. Un ID de tienda como ejemplo es 9WZDNCRFJ3Q8. Sí
Fecha de inicio fecha Fecha de inicio en el intervalo de fechas de los datos de embudo de adquisición que se van 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 embudo de adquisición que se van a recuperar. El valor predeterminado es la fecha actual. No
filtro cuerda / cadena Una o varias instrucciones que filtran las filas de la respuesta. Para obtener más información, consulte la siguiente sección de los campos de filtro . No

 

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 .

Se admiten los siguientes campos de filtro. Los valores de cadena deben estar delimitados por comillas simples en el parámetro del filtro .

Campos Descripción
ID de campaña Cadena de identificador de una campaña de promoción de aplicaciones personalizada asociada a la adquisición.
mercado Cadena que contiene el código de país ISO 3166 del mercado donde se produjo la adquisición.
tipo de dispositivo Una de las siguientes cadenas que especifica el tipo de dispositivo en el que se produjo la adquisición:
  • PC
  • Teléfono
  • Console-Xbox One
  • Console-Xbox Serie X
  • Internet de las Cosas
  • Holográfico
  • Desconocido
grupo de edad Una de las siguientes cadenas que especifica el grupo de edad del usuario que completó la adquisición:
  • 0 – 17
  • 18 – 24
  • 25 – 34
  • 35 – 49
  • 50 o más
  • Desconocido
género Una de las siguientes cadenas que especifica el género del usuario que completó la adquisición:
  • M
  • F
  • Desconocido

Ejemplo de solicitud

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=1/1/2017&endDate=2/1/2017  HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=8/1/2016&endDate=8/31/2016&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 embudo de adquisición para la aplicación. Para obtener más información sobre los datos de cada objeto, consulte la siguiente sección de valores de embudo .
Conteo Total Int Número total de objetos de la matriz Value .

Valores de embudo

Los objetos en la matriz Value contienen los siguientes valores.

Importancia Tipo Descripción
Tipo de Métrica cuerda / cadena Una de las siguientes cadenas que especifica el tipo de datos de embudo que se incluye en este objeto:
  • VistaDePágina
  • de adquisición
  • Instalación
  • Uso
Cantidad de Usuarios cuerda / cadena Número de usuarios que realizaron el paso de embudo especificado por el valor de MetricType.

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/funnel?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>

Respuesta de ejemplo

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 6214
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 1502
        },
        {
            "MetricType": "Usage",
            "UserCount": 606
        },
        {
            "MetricType": "Install",
            "UserCount": 977
        }
    ],
    "TotalCount": 4
}

Solicitud de ejemplo

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=12/19/2021&endDate=12/21/2021&filter=market eq 'US' and gender eq 'm'
HTTP/1.1
Authorization: Bearer <your access token>

Respuesta de ejemplo

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 10
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 8
        },
        {
            "MetricType": "Usage",
            "UserCount": 5
        },
        {
            "MetricType": "Install",
            "UserCount": 3
        }
    ],
    "TotalCount": 4
}