Pozyskiwanie dodatków

Aby uzyskać zagregowane dane dotyczące pozyskiwania dodatków do swojej aplikacji w formacie JSON w określonym zakresie dat i z opcjonalnymi filtrami, użyj tej metody w interfejsie API analizy sklepu Microsoft Store. Te informacje są również dostępne w raporcie dotyczącym pozyskiwania dodatków w Centrum partnerskim.

Wymagania wstępne

Aby użyć tej metody, należy najpierw wykonać następujące czynności:

• Jeśli jeszcze tego nie zrobiłeś, wykonaj wszystkie wymagania wstępne i dla API analizy Microsoft Store.
• Uzyskaj token dostępu usługi Azure AD do użycia w nagłówku żądania dla tej metody. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu można uzyskać nowy.

Żądanie

Składnia żądania

Nagłówek żądania

Parametry żądania

Wymagany jest parametr applicationId lub inAppProductId. Aby pobrać dane pozyskiwania dla wszystkich dodatków zarejestrowanych w aplikacji, określ parametr applicationId. Aby pobrać dane pozyskiwania dla pojedynczego dodatku, określ parametr inAppProductId. Jeśli określisz oba parametry, to parametr applicationId zostanie zignorowany.

Filtrowanie pól

Parametr filtru w żądaniu zawiera jedną lub więcej instrukcji filtrujących wiersze w odpowiedzi. Każde wyrażenie zawiera pole i wartość, które są powiązane z operatorami eq lub ne, a wyrażenia mogą być łączone za pomocą i albo lub. Oto kilka przykładowych parametrów filtru:

• filter=market eq "US" i gender eq "m"
• filter=(market != "US") i (płeć != "nieznana") i (płeć != "m") i (market != "NO") i (ageGroup != "więcej niż 55" i ageGroup != "mniej niż 13")

Aby uzyskać listę obsługiwanych pól, zobacz poniższą tabelę. Wartości ciągu muszą być otoczone pojedynczymi cudzysłowami w parametrze filtru .

Przykład zapytania

W poniższych przykładach przedstawiono kilka żądań dotyczących uzyskiwania danych o nabyciu dodatków. Zastąp wartości inAppProductId i applicationId odpowiednim identyfikatorem sklepu dla Twojego dodatku lub aplikacji.

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>

Odpowiedź

Ciało odpowiedzi

Wartości nabycia dodatków

Elementy w tablicy Value zawierają następujące wartości.

Przykład żądania i odpowiedzi

Poniższy fragment kodu przedstawia przykładowe żądanie i treść odpowiedzi JSON dla tego żądania.

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Tematy pokrewne

• Raport dotyczący nabycia dodatków
• Uzyskiwanie dostępu do danych analitycznych przy użyciu usług ze Sklepu Microsoft
• Uzyskaj konwersje rozszerzeń według kanału
• Pozyskiwanie użytkowników aplikacji
• Uzyskaj dane lejka pozyskiwania aplikacji
• Zdobądź konwersje aplikacji według kanału