Ottenere le acquisizioni dei componenti aggiuntivi

Usare questo metodo nell'API di analisi di Microsoft Store per ottenere dati aggregati sulle acquisizioni per i componenti aggiuntivi dell'app in formato JSON durante un determinato intervallo di date e altri filtri opzionali. Queste informazioni sono disponibili anche nel report sulle acquisizioni dei componenti aggiuntivi 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.

Richiedi

Sintassi della richiesta

Intestazione della richiesta

Parametri della richiesta

Il parametro applicationId o inAppProductId è obbligatorio. Per recuperare i dati sulle acquisizioni di tutti i componenti aggiuntivi registrati nell'app, specificare il parametro applicationId. Per recuperare i dati sulle acquisizioni di un singolo componente aggiuntivo, specificare il parametro inAppProductId. Se si specificano entrambi, il parametro applicationId viene ignorato.

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. Di seguito sono riportati alcuni esempi di parametri filter:

• filter=market eq 'US' and gender eq 'm'
• filter=(market ne 'US') and (gender ne 'Unknown') and (gender ne 'm') and (market ne 'NO') and (ageGroup ne 'greater than 55' or ageGroup ne ‘less than 13’)

Per un elenco dei campi supportati, vedere la tabella seguente. I valori stringa devono essere racchiusi tra virgolette singole nel parametro filter.

Esempio di richiesta

Gli esempi seguenti illustrano diverse richieste di recupero dei dati sulle acquisizioni del componenti aggiuntivo. Sostituire i valori inAppProductId e applicationId con l'ID dello Store ID appropriato per il componente aggiuntivo o l'app.

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>

Response

Corpo della risposta

Valori di acquisizione dei componenti aggiuntivi

Gli elementi nella matrice Value contengono i valori seguenti.

Esempio di richiesta e risposta

Il frammento di codice seguente illustra una richiesta di esempio e il corpo della risposta JSON per tali richieste.

Richiesta di esempio

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

Risposta di esempio

{
    "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"
}

Argomenti correlati

• Report Acquisizioni componenti aggiuntivi
• Accedere ai dati di analisi usando i servizi di Microsoft Store
• Recuperare le conversioni dei componenti aggiuntivi per canale
• Ottenere le acquisizioni dell'app
• Recuperare i dati dell'imbuto di acquisizioni di app
• Recuperare le conversioni di app per canale