In-app review prompt

[vesta0]

User Story

• As a user, I want to have the option to easily rate the app without it disruptive to my browsing flow.

Dependencies

Using the Google In-app review API since it will allow user to rate the app without having the leave the browser.

Acceptance Criteria

• I can rate the app without being taken out of the app (to the play store)
• I am not prompted excessively for a review (max 3 times a year)

┆Issue is synchronized with this Jira Task

[liuche]

I think we decided that this would be something that we want to do through LeanPlum.

EDIT: out of date!

Here are the specs:
We will go with the Google In-app review API for now since it is simpler to implement AND collect an unbiased sample of reviews without forcing the user to leave the app.

Acceptance criteria:

• Review prompt should be triggered only for users that have Firefox set as their default browser AND after the 5th time the user opened the app.
• User should be able to rate app without being taken out of the app (to the play store)
• User should not be prompted excessively for a review (max 3 times a year)

Other noteworthy guidelines:

• Surface the card as-is, without tampering or modifying the existing design in any way, including size, opacity, shape, or other properties.
• Do not add any overlay on top of the card or around the card.
• The card and the card’s background should be on the topmost layer. Once the card has surfaced, do not programmatically remove the card. The card is removed automatically based on either the user’s explicit action, or an internal Play Store mechanism.

[liuche]

Moving this back to sourpatch bc the search work is almost done!

[liuche]

Just to be explicit, this does not require any strings, per the Android guidelines. We can only control when the prompt is shown, and we must not show it too often.

Your app should not ask the user any questions before or while presenting the rating button or card, including questions about their opinion (such as “Do you like the app?”) or predictive questions (such as “Would you rate this app 5 stars”).

[liuche]

This should be triggered on Nightly (but depends on Google Play Services) by doing the following:

• fenix is set to default browser
• restart browser 5 times

We're not entirely clear on when Google Play chooses to show this, but those steps will set it up to be able to be shown (so if it doesn't happen exactly with those steps, please note it in the comments, but we don't actually have full control over this)

If you want to trigger it again, it needs to be a fresh install because one of the restrictions is that GPS will not show the prompt too close together (by a few weeks).
This may not work if you have already rated Firefox Nightly.

Link to Google API in comment 0 can provide more info on how it should look.

[LaurentiuApahideanSV]

I tested the issue on Firefox Preview Nightly 200831 (Build #2015761139) but was unable to trigger the In-App Review prompt. I tried the following scenario:

1. Log in the Play Store with a google account that has not rated Firefox Preview Nightly;
2. Remove all other google accounts found on the device;
3. Restart Firefox Preview more than 5 times;
4. Browse through web pages;
5. Navigate through the setting menu.

Are there any more steps that need to be completed in order for the In-App Review prompt to be shown?

[liuche]

Did you set Firefox Nightly as default browser @LaurentiuApahideanSV ? Did not see that in your list of steps, but maybe it was done but not written down. Could you also try browsing a site for each of the 5 restarts?

I was able to get this to show up on Nightly, but others had not been able to, so the unknown is probably related to where Google Play Services is controlling something.

[liuche]

@boek if I'm cutting a new 80 Release with the crashfix from #14357 could we get this uplifted too? and there was a follow-up crash with lower API level devices, maybe @eliserichards you know what that is?

Let me know if it's too risky at this point, just a few days into nightly. Would be worthwhile for someone to check the crashes too to see if there's anything google play services / ratings related.

[sv-ohorvath]

@liuche Neither of us could trigger the Gplay review prompt on Nightly 9/1 or 80.1.2 RC (this one because is not yet in the Gplay Store, maybe?) following the criteria mentioned:

• new GPlay account, with no other reviews/apps installed
• first time installation of Nightly
• set as the default browser
• browsing & restarted the app for 5+ times
  So we can't confirm the issue on this RC build.

[liuche]

Hmmm, this is very strange - I was only able to trigger this once on my Nightly build.

The Google Play Services APIs are not clear on how exactly the prompt gets triggered. However, we will keep an eye out for new reviews possibly through here.

This is a low-risk change and maybe it is just unpredictable how the GPS APIs are working. I'll leave this open for now though. Maybe someone who sees this prompt show up can comment.

[Diana-Rus]

@liuche unfortunately we still didn't managed to trigger the In-app review prompt on Beta 81.1.0-beta.2.
We also tried with a VPN, besides the scenarios from "#13507 (comment)"

[vesta0]

Can we close this issue?

[liuche]

I think even though QA wasn't able to reproduce this, some on the eng team could, and we're seeing a bump in positive reviews! so this is something we can close. Maybe there are some Google Play settings that we are not aware of that is making this difficult to test, thank you for trying!

[lobontiumira]

Hi all!
I was able to trigger the review prompt on the 9/28 Nightly build with Samsung Galaxy Note 8 (Android 9), and HTC 10 (Android 8).
I'll remove the qa:needed label.
*Notes:

• tapping on Undo, takes the user back to the review prompt (screenshot 2),
• tapping on Not now or Cancel, removes the prompt.