Compartir a través de

Obtener datos de embudo de adquisiciones de aplicaciones

  • Artículo

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 Adquisiciones del Centro de partners.

Requisitos previos

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

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

Solicitar

Sintaxis de la solicitud

Método URI de solicitud
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel

Encabezado de solicitud

Encabezado Tipo Descripción
Autorización string Necesario. Token de acceso de Azure AD con el formato Token<de portador>.

Parámetros de solicitud

Parámetro Tipo Descripción Obligatorio
applicationId string El identificador de la Tienda de la aplicación para la que quieres recuperar los datos del embudo de adquisición. Un ejemplo de Id. de Store es 9WZDNCRFJ3Q8. Sí
startDate date Fecha de inicio en el intervalo de fechas de los datos de embudo de adquisición que se van a recuperar. La fecha actual es el valor predeterminado. No
endDate date Fecha de finalización del intervalo de fechas de los datos de embudo de adquisición que se van a recuperar. La fecha actual es el valor predeterminado. No
filter string Una o varias instrucciones que filtran las filas de la respuesta. Para más información, consulte la sección campos de filtro a continuación. No

 

Campos de filtro

El parámetro filter 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 y u o.

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

Campos Descripción
campaignId Cadena de identificador de una campaña de promoción de aplicaciones personalizada asociada a la adquisición.
market Cadena que contiene el código de país ISO 3166 del mercado donde se produjo la adquisición.
deviceType Una de las siguientes cadenas que especifica el tipo de dispositivo en el que se produjo la adquisición:
  • PC
  • Teléfono
  • Consola-Xbox One
  • Consola-Xbox Series X
  • IoT
  • Holográfico
  • Unknown
ageGroup 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
  • Unknown
gender Una de las siguientes cadenas que especifica el género del usuario que completó la adquisición:
  • M
  • F
  • Unknown

Ejemplo de solicitud

En el ejemplo siguiente se muestran varias solicitudes para obtener datos de embudo de adquisición para una aplicación. Reemplaza el valor applicationId por el Id. de Store de tu 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 la respuesta

Valor Tipo Descripción
Valor array 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 sección valores de embudo a continuación.
TotalCount int Número total de objetos de la matriz Value .

Valores de embudo

Los objetos de la matriz Value contienen los siguientes valores.

Valor Tipo Descripción
MetricType string Una de las siguientes cadenas que especifica el tipo de datos de embudo que se incluye en este objeto:
  • PageView
  • Adquisición
  • Instalación
  • Uso
UserCount string Número de usuarios que realizaron el paso de embudo especificado por el valor MetricType .

Ejemplo de solicitud y respuesta

En los fragmentos de código siguientes se muestran algunos ejemplos de solicitud y del cuerpo de la respuesta en formato JSON de esa solicitud.

Solicitud de muestra

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 muestra

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
}