Minősítések és vélemények kérése az alkalmazáshoz

Az univerzális Windows-platform (UWP) alkalmazáshoz kódot adhat hozzá, hogy programozott módon kérje meg az ügyfeleket az alkalmazás értékelésére vagy áttekintésére. Ezt többféleképpen is megteheti:

• Az értékelés és a véleményezés párbeszédpanelt közvetlenül az alkalmazás kontextusában jelenítheti meg.
• Programozott módon megnyithatja az alkalmazás minősítési és felülvizsgálati oldalát a Microsoft Store-ban.

Ha készen áll a minősítések elemzésére és az adatok áttekintésére, megtekintheti az adatokat a Partnerközpontban, vagy a Microsoft Store Analytics API használatával programozott módon lekérheti ezeket az adatokat.

Értékelés és véleményezés párbeszédpanel megjelenítése az alkalmazásban

Ha programozott módon szeretne megjeleníteni egy párbeszédpanelt az alkalmazásból, amely arra kéri az ügyfelet, hogy értékelje az alkalmazást, és küldjön egy felülvizsgálatot, hívja meg a RequestRateAndReviewAppAsync metódust a Windows.Services.Store névtérben.

using Windows.ApplicationModel.Store;

private StoreContext _storeContext;

public async Task Initialize()
{
    if (App.IsMultiUserApp) // pseudo-code
    {
        IReadOnlyList<User> users = await User.FindAllAsync();
        User firstUser = users[0];
        _storeContext = StoreContext.GetForUser(firstUser);
    }
    else
    {
        _storeContext = StoreContext.GetDefault();
    }
}

private async Task PromptUserToRateApp()
{
    // Check if we’ve recently prompted user to review, we don’t want to bother user too often and only between version changes
    if (HaveWePromptedUserInPastThreeMonths())  // pseudo-code
    {
        return;
    }

    StoreRateAndReviewResult result = await 
        _storeContext.RequestRateAndReviewAppAsync();

    // Check status
    switch (result.Status)
    { 
        case StoreRateAndReviewStatus.Succeeded:
            // Was this an updated review or a new review, if Updated is false it means it was a users first time reviewing
            if (result.UpdatedExistingRatingOrReview)
            {
                // This was an updated review thank user
                ThankUserForReview(); // pseudo-code
            }
            else
            {
                // This was a new review, thank user for reviewing and give some free in app tokens
                ThankUserForReviewAndGrantTokens(); // pseudo-code
            }
            // Keep track that we prompted user and don’t do it again for a while
            SetUserHasBeenPrompted(); // pseudo-code
            break;

        case StoreRateAndReviewStatus.CanceledByUser:
            // Keep track that we prompted user and don’t prompt again for a while
            SetUserHasBeenPrompted(); // pseudo-code

            break;

        case StoreRateAndReviewStatus.NetworkError:
            // User is probably not connected, so we’ll try again, but keep track so we don’t try too often
            SetUserHasBeenPromptedButHadNetworkError(); // pseudo-code

            break;

        // Something else went wrong
        case StoreRateAndReviewStatus.OtherError:
        default:
            // Log error, passing in ExtendedJsonData however it will be empty for now
            LogError(result.ExtendedError, result.ExtendedJsonData); // pseudo-code
            break;
    }
}

A RequestRateAndReviewAppAsync metódust a Windows 10, 1809-es verziójában vezették be, és csak olyan projektekben használható, amelyek célplatformja a Windows 10 2018 októberi frissítése (10.0; Build 17763) vagy egy későbbi kiadás a Visual Studio-ban.

A minősítési és felülvizsgálati kérelem válaszadatai

Miután elküldte a minősítési és felülvizsgálati párbeszédpanel megjelenítésére vonatkozó kérést, a StoreRateAndReviewResult osztály ExtendedJsonData tulajdonsága tartalmaz egy JSON formátumú sztringet, amely jelzi, hogy a kérés sikeres volt-e.

Az alábbi példa a kérés visszatérési értékét mutatja be, miután az ügyfél sikeresen beküldte az értékelést vagy felülvizsgálatot.

{ 
  "status": "success", 
  "data": {
    "updated": false
  },
  "errorDetails": "Success"
}

Az alábbi példa a kérés visszatérési értékét mutatja be, miután az ügyfél úgy döntött, hogy nem küld értékelést vagy felülvizsgálatot.

{ 
  "status": "aborted", 
  "errorDetails": "Navigation was unsuccessful"
}

Az alábbi táblázat a JSON formátumú adatsztring mezőit ismerteti.

Az alkalmazás minősítési és felülvizsgálati oldalának elindítása az Áruházban

Ha programozott módon meg szeretné nyitni az alkalmazás minősítési és felülvizsgálati oldalát az Áruházban, a LaunchUriAsync metódust használhatja az ms-windows-store://review URI-sémával, ahogyan az ebben a kód példában is látható.

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://review/?ProductId=9WZDNCRFHVJL"));

További információ: A Microsoft Store alkalmazás indítása.

A minősítések elemzése és az adatok áttekintése

Az ügyfelek értékeléseinek és adatainak elemzéséhez több lehetősége is van:

• A Partnerközpontban a Vélemények jelentéssel megtekintheti az ügyfelek értékeléseit és véleményezéseit. Ezt a jelentést offline állapotban is megtekintheti.
• Az Alkalmazásminősítések lekérése és a Alkalmazásértékelések lekérése metódusokat használhatja a Store Analytics API-ban, hogy programozott módon lekérje az ügyfelek visszajelzéseit és értékeléseit JSON formátumban.

Kapcsolódó témakörök

• Kérések küldése az Áruházba
• A Microsoft Store-alkalmazás indítása
• Vélemények jelentése