Recuperare i dati dell'imbuto di acquisizioni di app

  • Articolo

Usare questo metodo nell'API di analisi di Microsoft Store per ottenere i dati dell'imbuto di acquisizione per un'applicazione durante un determinato intervallo di date e altri filtri opzionali. Queste informazioni sono disponibili anche nel report sulle acquisizioni nel Centro per i partner.

Prerequisiti

Per usare questo metodo, è necessario prima eseguire le operazioni seguenti:

  • Se non lo si è ancora fatto, completare i prerequisiti per l'API di analisi di Microsoft Store.
  • Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.

Richiesta

Sintassi della richiesta

metodo URI della richiesta
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel

Intestazione della richiesta

Intestazione Type Descrizione
Autorizzazione stringa Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>.

Parametri della richiesta

Parametro Tipo Descrizione Richiesto
applicationId string ID dello Store dell'app per cui si desidera recuperare i dati dell'imbuto di acquisizione. Un esempio di ID dello Store è 9WZDNCRFJ3Q8. Sì
startDate data Data di inizio nell'intervallo di date dei dati dell'imbuto di acquisizione da recuperare. L'impostazione predefinita è la data corrente. No
endDate data Data di fine nell'intervallo di date dei dati dell'imbuto di acquisizione da recuperare. L'impostazione predefinita è la data corrente. No
filter string Una o più istruzioni che filtrano le righe nella risposta. Per ulteriori informazioni, vedere la sezione Campi filtro seguente. No

 

Campi filtro

Il parametro filter della richiesta contiene una o più istruzioni che filtrano le righe nella risposta. Ogni istruzione contiene un campo e un valore associati agli operatori eq o ne e le istruzioni possono essere combinate usando gli operatori and o or.

Sono supportati i seguenti campi filtro. I valori stringa devono essere racchiusi tra virgolette singole nel parametro filter.

Campi Descrizione
campaignId Stringa ID per una campagna promozionale personalizzata per l'app associata all'acquisizione.
market Stringa contenente il codice Paese ISO 3166 del mercato in cui è stata effettuata l'acquisizione.
deviceType Una delle stringhe seguenti che specifica il tipo di dispositivo in cui è stata effettuata l'acquisizione:
  • PC
  • Telefono
  • Console-Xbox One
  • Console-Xbox Series X
  • IoT
  • Holographic
  • Unknown
ageGroup Una delle stringhe seguenti che specifica la fascia di età dell'utente che ha completato l'acquisizione:
  • 0 – 17
  • 18 – 24
  • 25 – 34
  • 35 – 49
  • 50 or over
  • Unknown
sesso Una delle stringhe seguenti che specifica il sesso dell'utente che ha completato l'acquisizione:
  • M
  • F
  • Unknown

Esempio di richiesta

L'esempio seguente illustra diverse richieste di recupero dei dati dell'imbuto di acquisizione per un'app. Sostituire il valore applicationId con l'ID dello Store dell'app.

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>

Response

Corpo della risposta

Valore Tipo Descrizione
Valore matrice Matrice di oggetti che contengono i dati dell'imbuto di acquisizione per l'app. Per ulteriori informazioni sui dati in ogni oggetto, vedere la sezione Valori imbuto seguente.
TotalCount int Numero totale di oggetti nella matrice Value.

Valori imbuto

Gli oggetti nella matrice Value contengono i valori seguenti.

Valore Tipo Descrizione
MetricType string Una delle stringhe seguenti che specifica il tipo di dati dell'imbuto inclusi in questo oggetto:
  • PageView
  • Acquisizione
  • Installa
  • Utilizzo
UserCount string Numero di utenti che hanno eseguito il passaggio dell'imbuto specificato dal valore MetricType.

Esempio di richiesta e risposta

I frammenti di codice seguenti illustrano alcune richieste di esempio e il corpo della risposta JSON per tali richieste.

Richiesta di esempio

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

Risposta di esempio

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

Richiesta di esempio

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>

Risposta di esempio

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