Jak wyświetlać okienka z oceną, kiedy chcesz

Opublikowano 24. lipca 2024 przez Jan Bunk


Funkcje opisane na tej stronie wymagają planu z przypomnieniami o recenzjach.
Szukasz ogólnych informacji i zrzutów ekranu? Zajrzyj do naszego głównego artykułu o przypomnieniach o recenzjach.

Domyślnie Twoja aplikacja poprosi użytkowników o zostawienie recenzji w sklepach z aplikacjami kilka dni po instalacji, jeśli do tego czasu otworzyli aplikację kilka razy. Chcesz to dostosować? Skorzystaj z naszego API JavaScript!

Oto kilka zalet ręcznego wyświetlania przypomnienia o recenzji:

  • Możesz pokazać przypomnienie o recenzji po tym, jak użytkownik skorzysta z Twojej aplikacji i będzie z niej zadowolony, więc jest większa szansa na pozytywną opinię.
  • Możesz uniknąć pokazywania przypomnienia o recenzji, gdy użytkownik jest w trakcie wykonywania zadania i nie chce być rozpraszany.
  • Możesz wykorzystać swoje dane, aby pokazać przypomnienie tylko najbardziej zadowolonym klientom.

Możesz chcieć wyłączyć automatyczne przypomnienia o recenzji, jeśli teraz będziesz je wywoływać ręcznie.

Korzystanie z funkcji JavaScript

Możesz sprawdzić funkcję executeWhenAppReady() w naszym pomocniczym skrypcie aplikacji. Zapewnia, że Twoja strona nie próbuje komunikować się z aplikacją zanim będzie gotowa lub gdy strona jest otwarta w zwykłej przeglądarce (ReferenceError, funkcja nie jest zdefiniowana).

showReviewReminder

Użyj tej funkcji, aby wyświetlić przypomnienie o recenzji. Jeśli nie korzystasz z natywnego przypomnienia, funkcja zwróci przycisk, który kliknął użytkownik.


<script>
    try {
        let useNativeReviewReminder = false;
        // These are the default texts. If you don't want to change them, you can also pass null and the app will
        // default to them.
        let title = "Please rate us!";
        let message = "If you like this app, please take a minute of your time and leave us a positive review! It helps us out a ton. Thank you for your generosity!";
        let rateButton = "Rate";
        let noButton = "No thanks";
        let laterButton = "Remind me later";
        
        let clickedButton = (await showReviewReminder(useNativeReviewReminder, title, message, rateButton, noButton, laterButton))["clickedButton"];
        
        switch (clickedButton) {
            case "rate":
                // The user clicked the button to rate the app.
                break;
            case "later":
                // The user clicked the button to be reminded later.
                break;
            case "no":
                // The user doesn't want to rate the app.
                break;
        }
    }
    catch (e) {
        // Can occur if:
        // - the app couldn't connect to the native code. Should be very unlikely.
        console.log(e);
    }
</script>
    

Jeśli chcesz wyświetlić natywne okno przypomnienia o recenzji, liczy się tylko pierwszy argument. Pamiętaj jednak, aby przekazać wartości dla pozostałych argumentów (nawet jeśli ich wartość jest nieistotna).


<script>
    try {
        let useNativeReviewReminder = true;
        await showReviewReminder(useNativeReviewReminder, null, null, null, null, null);
    }
    catch (e) {
        // Can occur if:
        // - the app couldn't connect to the native code. Should be very unlikely.
        console.log(e);
    }
</script>
    

Pamiętaj, że natywne przypomnienie o recenzji nie zawsze się pojawi. Oto możliwe powody, dla których może się nie wyświetlić:

  • Użytkownikowi już wyświetlono to okno w ciągu ostatniego miesiąca (na Androidzie) lub więcej niż 3 razy w ciągu ostatnich 365 dni (na iOS).
  • Użytkownik już ocenił aplikację.
  • Twoja aplikacja nie jest jeszcze opublikowana w sklepie z aplikacjami danej platformy.

Niestety nie ma też sposobu, aby programowo sprawdzić, czy natywne przypomnienie zostało wyświetlone.

Ze względu na te ograniczenia polecam testować swój kod z nienatywnym oknem dialogowym, gdzie masz pewność, że się pojawi.