Abrufen von Xbox Live-AnalysedatenGet Xbox Live analytics data

Verwenden Sie diese Methode in der Microsoft Store Analytics-API, um die letzten 30 Tage allgemeiner Analysedaten für Kunden zu erhalten, die Ihr Xbox Live-fähiges Spielspielen, einschließlich Geräte Zubehör, Internet Verbindungstyp, Gamerscore-Verteilung, Spielstatistik und Freunde und Follower-Daten.Use this method in the Microsoft Store analytics API to get the last 30 days of general analytics data for customers playing your Xbox Live-enabled game, including device accessory usage, internet connection type, gamerscore distribution, game statistics, and friends and followers data. Diese Informationen sind auch im Bericht " Xbox Analytics " im Partner Center verfügbar.This information is also available in the Xbox analytics report in Partner Center.

Wichtig

Diese Methode unterstützt nur Spiele für Xbox oder Spiele, die Xbox Live-Dienste verwenden.This method only supports games for Xbox or games that use Xbox Live services. Diese Spiele müssen den Genehmigungsprozess des Konzeptsdurchlaufen, der Spiele umfasst, die von Microsoft-Partnern und über das ID@Xbox Programmgesendeten spielen veröffentlicht wurden.These games must go through the concept approval process, which includes games published by Microsoft partners and games submitted via the ID@Xbox program. Diese Methode unterstützt zurzeit keine Spiele, die über das Xbox Live Creators-Programmveröffentlicht wurden.This method does not currently support games published via the Xbox Live Creators Program.

Zusätzliche Analysedaten für Spiele, die Xbox Live-fähig sind, sind über die folgenden Methoden verfügbar:Additional analytics data for Xbox Live-enabled games is available via the following methods:

VoraussetzungenPrerequisites

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:To use this method, you need to first do the following:

  • Wenn Sie dies nicht bereits getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store Analytics-API erfüllen.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird.Obtain an Azure AD access token to use in the request header for this method. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft.After you obtain an access token, you have 60 minutes to use it before it expires. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.After the token expires, you can obtain a new one.

AnforderungRequest

AnforderungssyntaxRequest syntax

MethodeMethod Anforderungs-URIRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/gameanalytics

AnforderungsheaderRequest header

HeaderHeader typeType BESCHREIBUNGDescription
AuthorizationAuthorization Zeichenfolgestring Erforderlich.Required. Das Azure AD-Zugriffstoken im Format Bearer <token>.The Azure AD access token in the form Bearer <token>.

AnforderungsparameterRequest parameters

ParameterParameter TypType BESCHREIBUNGDescription ErforderlichRequired
applicationIdapplicationId Zeichenfolgestring Die Speicher-ID des Spiels, für das Sie allgemeine Xbox Live-Analysedaten abrufen möchten.The Store ID of the game for which you want to retrieve general Xbox Live analytics data. JaYes
metrictypemetricType Zeichenfolgestring Eine Zeichenfolge, die den Typ der abzurufenden Xbox Live Analytics-Daten angibt.A string that specifies the type of Xbox Live analytics data to retrieve. Geben Sie für diese Methode den Wert ProductValuesan.For this method, specify the value productvalues. JaYes

AnforderungsbeispielRequest example

Das folgende Beispiel zeigt eine Anforderung zum erhalten allgemeiner Analysedaten für Kunden, die Ihr Xbox Live-fähiges Spiel spielen.The following example demonstrates a request for getting general analytics data for customers playing your Xbox Live-enabled game. Ersetzen Sie den Wert ApplicationId durch die Store-ID für Ihr Spiel.Replace the applicationId value with the Store ID for your game.

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

AntwortResponse

Diese Methode gibt ein Wert Array zurück, das die folgenden Objekte enthält.This method returns a Value array that contains the following objects.

ObjectObject BESCHREIBUNGDescription
ProductdataProductData Enthält ein deviceproperties -Objekt und ein UserProperties -Objekt, das die letzten 30 Tage der Geräte-und Benutzer Analysedaten für das Spiel enthält.Contains one DeviceProperties object and one UserProperties object that contain the last 30 days of device and user analytics data for your game.
XboxwidedataXboxwideData Enthält ein deviceproperties -Objekt und ein UserProperties -Objekt, das die letzten 30 Tage der durchschnittlichen Geräte-und Benutzer Analysedaten für alle Xbox Live-Kunden als Prozentsätze enthält.Contains one DeviceProperties object and one UserProperties object that contain the last 30 days of average device and user analytics data for all Xbox Live customers, as percentages. Diese Daten sind für Vergleichszwecke mit den Daten für Ihr Spiel enthalten.This data is included for comparison purposes with the data for your game.

DevicepropertiesDeviceProperties

Diese Ressource enthält Geräte Verwendungs Daten für Ihr Spiel oder die durchschnittlichen Geräte Verwendungs Daten für alle Xbox Live-Kunden während der letzten 30 Tage.This resource contains device usage data for your game or average device usage data for all Xbox Live customers during the last 30 days.

WertValue TypType BESCHREIBUNGDescription
applicationIdapplicationId Zeichenfolgestring Die Speicher-ID des Spiels, für das Sie Analysedaten abgerufen haben.The Store ID of the game for which you retrieved analytics data.
connectiontypedistributionconnectionTypeDistribution arrayarray Enthält Objekte, die angeben, wie viele Kunden eine kabelgebundene Internetverbindung oder eine drahtlos Internetverbindung auf Xbox verwenden.Contains objects that indicate how many customers use a wired internet connection versus a wireless internet connection on Xbox. Jedes-Objekt verfügt über zwei Zeichen folgen Felder:Each object has two string fields:
  • Contype: gibt den Verbindungstyp an.conType: Specifies the connection type.
  • devicecount: im productdata -Objekt gibt dieses Feld die Anzahl der Kunden des Spiels an, die den Verbindungstyp verwenden.deviceCount: In the ProductData object, this field specifies the number of your game's customers that use the connection type. Im xboxwidedata -Objekt gibt dieses Feld den Prozentsatz aller Xbox Live-Kunden an, die den Verbindungstyp verwenden.In the XboxwideData object, this field specifies the percentage of all Xbox Live customers that use the connection type.
deviceCountdeviceCount Zeichenfolgestring Im productdata -Objekt gibt dieses Feld die Anzahl der Kunden Geräte an, auf denen das Spiel während der letzten 30 Tage wiedergegeben wurde.In the ProductData object, this field specifies the number of customer devices on which your game has been played during the last 30 days. Im xboxwidedata -Objekt ist dieses Feld immer 1, was einen Anfangs Prozentsatz von 100% für Daten für alle Xbox Live-Kunden angibt.In the XboxwideData object, this field is always 1, indicating a starting percentage of 100% for data for all Xbox Live customers.
elitecontrollerpresentdevicecounteliteControllerPresentDeviceCount Zeichenfolgestring Im productdata -Objekt gibt dieses Feld die Anzahl der Kunden Ihres Spiels an, die den drahtlosen Xbox Elite-Controller verwenden.In the ProductData object, this field specifies the number of your game's customers that use the Xbox Elite Wireless Controller. Im xboxwidedata -Objekt gibt dieses Feld den Prozentsatz aller Xbox Live-Kunden an, die den drahtlosen Xbox Elite-Controller verwenden.In the XboxwideData object, this field specifies the percentage of all Xbox Live customers that use the Xbox Elite Wireless Controller.
externaldrivepresentdevicecountexternalDrivePresentDeviceCount Zeichenfolgestring Im productdata -Objekt gibt dieses Feld die Anzahl der Kunden Ihres Spiels an, die eine externe Festplatte auf Xbox verwenden.In the ProductData object, this field specifies the number of your game's customers that use an external hard drive on Xbox. Im xboxwidedata -Objekt gibt dieses Feld den Prozentsatz aller Xbox Live-Kunden an, die eine externe Festplatte auf der Xbox verwenden.In the XboxwideData object, this field specifies the percentage of all Xbox Live customers that use an external hard drive on Xbox.

UserPropertiesUserProperties

Diese Ressource enthält Benutzerdaten für das Spiel oder die durchschnittlichen Benutzerdaten für alle Xbox Live-Kunden während der letzten 30 Tage.This resource contains user data for your game or average user data for all Xbox Live customers during the last 30 days.

WertValue TypType BESCHREIBUNGDescription
applicationIdapplicationId Zeichenfolgestring Die Speicher-ID des Spiels, für das Sie Analysedaten abgerufen haben.The Store ID of the game for which you retrieved analytics data.
userCountuserCount Zeichenfolgestring Im productdata -Objekt gibt dieses Feld die Anzahl der Kunden an, die Ihr Spiel innerhalb der letzten 30 Tage wiedergegeben haben.In the ProductData object, this field specifies the number of customers that have played your game during the last 30 days. Im xboxwidedata -Objekt ist dieses Feld immer 1, was einen Anfangs Prozentsatz von 100% für Daten für alle Xbox Live-Kunden angibt.In the XboxwideData object, this field is always 1, indicating a starting percentage of 100% for data for all Xbox Live customers.
dvrusagecountsdvrUsageCounts arrayarray Enthält Objekte, die angeben, wie viele Kunden Game DVR verwendet haben, um das-Spiel aufzuzeichnen und anzuzeigen.Contains objects that indicate how many customers have used game DVR to record and view gameplay. Jedes-Objekt verfügt über zwei Zeichen folgen Felder:Each object has two string fields:
  • dvrname: gibt das verwendete Spiel-DVR-Feature an.dvrName: Specifies the game DVR feature used. Mögliche Werte sind " gameclipuploads", " gameclipviews", " screenshotuploads" und " screenshotviews".Possible values are gameClipUploads, gameClipViews, screenshotUploads, and screenshotViews.
  • User count: im productdata -Objekt gibt dieses Feld die Anzahl der Kunden Ihres Spiels an, die das angegebene Spiel-DVR-Feature verwendet haben.userCount: In the ProductData object, this field specifies the number of your game's customers that used the specified game DVR feature. Im xboxwidedata -Objekt gibt dieses Feld den Prozentsatz aller Xbox Live-Kunden an, die das angegebene Spiel-DVR-Feature verwendet haben.In the XboxwideData object, this field specifies the percentage of all Xbox Live customers that used the specified game DVR feature.
Follow-count-perzentilesfollowerCountPercentiles arrayarray Enthält Objekte, die Details zur Anzahl der Follower für Kunden bereitstellen.Contains objects that provide details about the number of followers for customers. Jedes-Objekt verfügt über zwei Zeichen folgen Felder:Each object has two string fields:
  • Prozentsatz: derzeit ist dieser Wert immer 50, was darauf hinweist, dass die Follower-Daten als Medianwert bereitgestellt werden.percentage: Currently, this value is always 50, indicating that the follower data is provided as a median value.
  • Wert: im productdata -Objekt gibt dieses Feld die durchschnittliche Anzahl von Followern für die Kunden Ihres Spiels an.value: In the ProductData object, this field specifies the median number of followers for your game's customers. Im xboxwidedata -Objekt gibt dieses Feld die durchschnittliche Anzahl von Followern für alle Xbox Live-Kunden an.In the XboxwideData object, this field specifies the median number of followers for all Xbox Live customers.
friendzählperzentilefriendCountPercentiles arrayarray Enthält Objekte, die Details zur Anzahl der Freunde für Kunden bereitstellen.Contains objects that provide details about the number of friends for customers. Jedes-Objekt verfügt über zwei Zeichen folgen Felder:Each object has two string fields:
  • Prozentsatz: derzeit ist dieser Wert immer 50, was darauf hinweist, dass die Friends-Daten als Medianwert bereitgestellt werden.percentage: Currently, this value is always 50, indicating that the friends data is provided as a median value.
  • Wert: im productdata -Objekt gibt dieses Feld die durchschnittliche Anzahl der Freunde für die Kunden Ihres Spiels an.value: In the ProductData object, this field specifies the median number of friends for your game's customers. Im xboxwidedata -Objekt gibt dieses Feld die durchschnittliche Anzahl der Freunde für alle Xbox Live-Kunden an.In the XboxwideData object, this field specifies the median number of friends for all Xbox Live customers.
gamerscorerangedistributiongamerScoreRangeDistribution arrayarray Enthält Objekte, die Details zur Gamerscore-Verteilung für Kunden bereitstellen.Contains objects that provide details about the gamerscore distribution for customers. Jedes-Objekt verfügt über zwei Zeichen folgen Felder:Each object has two string fields:
  • scorerange: der Gamerscore-Bereich, für den das folgende Feld Verwendungs Daten bereitstellt.scoreRange: The gamerscore range for which the following field provides usage data. Beispielsweise 10K-25K.For example, 10K-25K.
  • User count: im productdata -Objekt gibt dieses Feld die Anzahl der Kunden des Spiels an, die ein Gamerscore im angegebenen Bereich für alle Spiele haben, die Sie gespielt haben.userCount: In the ProductData object, this field specifies the number of your game's customers that have a gamerscore in the specified range for all games they have played. Im xboxwidedata -Objekt gibt dieses Feld den Prozentsatz aller Xbox Live-Kunden an, die über ein Gamerscore im angegebenen Bereich für alle Spiele verfügen, die Sie gespielt haben.In the XboxwideData object, this field specifies the percentage of all Xbox Live customers that have a gamerscore in the specified range for all games they have played.
titlegamerscorerangedistributiontitleGamerScoreRangeDistribution arrayarray Enthält-Objekte, die Details zur Gamerscore-Verteilung für das spielbereit stellen.Contains objects that provide details about the gamerscore distribution for your game. Jedes-Objekt verfügt über zwei Zeichen folgen Felder:Each object has two string fields:
  • scorerange: der Gamerscore-Bereich, für den das folgende Feld Verwendungs Daten bereitstellt.scoreRange: The gamerscore range for which the following field provides usage data. Beispiel: 100-200.For example, 100-200.
  • User count: im productdata -Objekt gibt dieses Feld die Anzahl der Kunden des Spiels an, die über ein Gamerscore im angegebenen Bereich für Ihr Spiel verfügen.userCount: In the ProductData object, this field specifies the number of your game's customers that have a gamerscore in the specified range for your game. Im xboxwidedata -Objekt gibt dieses Feld den Prozentsatz aller Xbox Live-Kunden an, die über ein Gamerscore im angegebenen Bereich für das Spiel verfügen.In the XboxwideData object, this field specifies the percentage of all Xbox Live customers that have a gamerscore in the specified range for your game.
socialusagecountssocialUsageCounts arrayarray Enthält Objekte, die Details zur sozialen Nutzung für Kunden bereitstellen.Contains objects that provide details about the social usage for customers. Jedes-Objekt verfügt über zwei Zeichen folgen Felder:Each object has two string fields:
  • scname: der Typ der sozialen Nutzung.scName: The type of social usage. Beispielsweise Gaman Vites und TextMessages.For example, gameInvites and textMessages.
  • User count: im productdata -Objekt gibt dieses Feld die Anzahl der Kunden des Spiels an, die am angegebenen Typ der sozialen Nutzung beteiligt waren.userCount: In the ProductData object, this field specifies the number of your game's customers that have participated in the specified social usage type. Im xboxwidedata -Objekt gibt dieses Feld den Prozentsatz aller Xbox Live-Kunden an, die am angegebenen Typ der sozialen Nutzung beteiligt sind.In the XboxwideData object, this field specifies the percentage of all Xbox Live customers that have participated in the specified social usage type.
streamingusagecountsstreamingUsageCounts arrayarray Enthält Objekte, die Details zur streamingverwendung für Kunden bereitstellen.Contains objects that provide details about the streaming usage for customers. Jedes-Objekt verfügt über zwei Zeichen folgen Felder:Each object has two string fields:
  • stname: der Typ der streamingplattform.stName: The type of streaming platform. Beispielsweise " youtubeusage", " twitchusage" und " mixerusage".For example, youtubeUsage, twitchUsage, and mixerUsage.
  • User count: im productdata -Objekt gibt dieses Feld die Anzahl der Kunden Ihres Spiels an, die die angegebene streamingplattform verwendet haben.userCount: In the ProductData object, this field specifies the number of your game's customers that have used the specified streaming platform. Im xboxwidedata -Objekt gibt dieses Feld den Prozentsatz aller Xbox Live-Kunden an, die die angegebene streamingplattform verwendet haben.In the XboxwideData object, this field specifies the percentage of all Xbox Live customers that have used the specified streaming platform.

AntwortbeispielResponse example

Das folgende Beispiel zeigt ein Beispiel für einen JSON-Antworttext für diese Anforderung.The following example demonstrates an example JSON response body for this request.

{
  "Value": [
    {
      "ProductData": {
        "DeviceProperties": [
          {
            "applicationId": "9NBLGGGZ5QDR",
            "connectionTypeDistribution": [
              {
                "conType": "WIRED",
                "deviceCount": "43806"
              },
              {
                "conType": "WIRELESS",
                "deviceCount": "104035"
              }
            ],
            "deviceCount": "148063",
            "eliteControllerPresentDeviceCount": "10615",
            "externalDrivePresentDeviceCount": "46388"
          }
        ],
        "UserProperties": [
          {
            "applicationId": "9NBLGGGZ5QDR",
            "userCount": "142345",
            "dvrUsageCounts": [
              {
                "dvrName": "gameClipUploads",
                "userCount": "31264"
              },
              {
                "dvrName": "gameClipViews",
                "userCount": "52236"
              },
              {
                "dvrName": "screenshotUploads",
                "userCount": "27051"
              },
              {
                "dvrName": "screenshotViews",
                "userCount": "45640"
              }
            ],
            "followerCountPercentiles": [
              {
                "percentage": "50",
                "value": "11"
              }
            ],
            "friendCountPercentiles": [
              {
                "percentage": "50",
                "value": "11"
              }
            ],
            "gamerScoreRangeDistribution": [
              {
                "scoreRange": "10K-25K",
                "userCount": "30015"
              },
              {
                "scoreRange": "25K-50K",
                "userCount": "20495"
              },
              {
                "scoreRange": "3K-10K",
                "userCount": "32438"
              },
              {
                "scoreRange": "50K-100K",
                "userCount": "10608"
              },
              {
                "scoreRange": "<3K",
                "userCount": "45726"
              },
              {
                "scoreRange": ">100K",
                "userCount": "3063"
              }
            ],
            "titleGamerScoreRangeDistribution": [
              {
                "scoreRange": "400-600",
                "userCount": "133875"
              },
              {
                "scoreRange": "800-1000",
                "userCount": "45960"
              },
              {
                "scoreRange": "<100",
                "userCount": "269137"
              },
              {
                "scoreRange": "≥1K",
                "userCount": "11634"
              },
              {
                "scoreRange": "100-200",
                "userCount": "334471"
              },
              {
                "scoreRange": "600-800",
                "userCount": "123044"
              },
              {
                "scoreRange": "200-400",
                "userCount": "396725"
              }
            ],
            "socialUsageCounts": [
              {
                "scName": "gameInvites",
                "userCount": "82390"
              },
              {
                "scName": "textMessages",
                "userCount": "91880"
              },
              {
                "scName": "partySessionCount",
                "userCount": "68129"
              }
            ],
            "streamingUsageCounts": [
              {
                "stName": "youtubeUsage",
                "userCount": "74092"
              },
              {
                "stName": "twitchUsage",
                "userCount": "13401"
              }
              {
                "stName": "mixerUsage",
                "userCount": "22907"
              }
            ]
          }
        ]
      },
      "XboxwideData": {
        "DeviceProperties": [
          {
            "applicationId": "XBOXWIDE",
            "connectionTypeDistribution": [
              {
                "conType": "WIRED",
                "deviceCount": "0.213677732584786"
              },
              {
                "conType": "WIRELESS",
                "deviceCount": "0.786322267415214"
              }
            ],
            "deviceCount": "1",
            "eliteControllerPresentDeviceCount": "0.0476609278128012",
            "externalDrivePresentDeviceCount": "0.173747147416134"
          }
        ],
        "UserProperties": [
          {
            "applicationId": "XBOXWIDE",
            "userCount": "1",
            "dvrUsageCounts": [
              {
                "dvrName": "gameClipUploads",
                "userCount": "0.173210623993245"
              },
              {
                "dvrName": "gameClipViews",
                "userCount": "0.202104713778096"
              },
              {
                "dvrName": "screenshotUploads",
                "userCount": "0.136682414274251"
              },
              {
                "dvrName": "screenshotViews",
                "userCount": "0.158057895120314"
              }
            ],
            "followerCountPercentiles": [
              {
                "percentage": "50",
                "value": "5"
              }
            ],
            "friendCountPercentiles": [
              {
                "percentage": "50",
                "value": "5"
              }
            ],
            "gamerScoreRangeDistribution": [
              {
                "scoreRange": "10K-25K",
                "userCount": "0.134709282586519"
              },
              {
                "scoreRange": "25K-50K",
                "userCount": "0.0549468789343825"
              },
              {
                "scoreRange": "50K-100K",
                "userCount": "0.017301313342277"
              },
              {
                "scoreRange": "3K-10K",
                "userCount": "0.216512780268453"
              },
              {
                "scoreRange": "<3K",
                "userCount": "0.573515440094644"
              },
              {
                "scoreRange": ">100K",
                "userCount": "0.00301430477372488"
              }
            ],
            "titleGamerScoreRangeDistribution": [
              {
                "scoreRange": "100-200",
                "userCount": "0.178055695637076"
              },
              {
                "scoreRange": "200-400",
                "userCount": "0.173283639825241"
              },
              {
                "scoreRange": "400-600",
                "userCount": "0.0986865193958259"
              },
              {
                "scoreRange": "600-800",
                "userCount": "0.0506375775462092"
              },
              {
                "scoreRange": "800-1000",
                "userCount": "0.0232398822856435"
              },
              {
                "scoreRange": "<100",
                "userCount": "0.456443551582991"
              },
              {
                "scoreRange": "≥1K",
                "userCount": "0.0196531337270126"
              }
            ],
            "socialUsageCounts": [
              {
                "scName": "gameInvites",
                "userCount": "0.460375855738335"
              },
              {
                "scName": "textMessages",
                "userCount": "0.429256324070832"
              },
              {
                "scName": "partySessionCount",
                "userCount": "0.378446577751268"
              },
              {
                "scName": "gamehubViews",
                "userCount": "0.000197115778147329"
              }
            ],
            "streamingUsageCounts": [
              {
                "stName": "youtubeUsage",
                "userCount": "0.330320919178683"
              },
              {
                "stName": "twitchUsage",
                "userCount": "0.040666241835399"
              }
              {
                "stName": "mixerUsage",
                "userCount": "0.140193816053558"
              }
            ]
          }
        ]
      }
    }
  ],
  "@nextLink": null,
  "TotalCount": 4
}