Opened 2 years ago

Last modified 4 months ago

#3175 reopened change

Change app workflow

Reported by: sven Assignee: ashephard
Priority: P2 Milestone: Adblock-Plus-for-iOS-next
Module: Adblock-Plus-for-iOS Keywords: salsita 2015q4
Cc: fhd, mario, lisabielik, jeen Blocked By:
Blocking: Platform: iOS
Ready: no Confidential: no
Tester: Unknown Verified working: no
Review URL(s):

https://github.com/adblockplus/adblockplussafariios/pull/12

Description (last modified by mario)

Background

There are several problems, when activating the content blocker. Therefore, we decided to improve the user workflow.
The workflow changes mainly aim at the following issues:

  • When the app is started and ABP isn't activated in the iOS Settings, show a notification, that locks the rest of the app. The notification states, that the user needs to enable ABP in the Settings before he can proceed. "Locking" the app by a notification prevents users from assuming, that ABP works by only starting the app (and not reading the information as currently shown).
  • Show a direct link to the iOS Settings in order to make it easier for the user to find where to enable ABP

What to change

The new workflow is put into five steps.

Step 1
The Acceptable Ads introduction will be displayed in a modal dialog.

Headline: You're in control
Text: Annoying ads are always blocked, while nonintrusive ads are displayed by default. You can change this setting at any time in:
Acceptable Ads → Allow some nonintrusive ads

After that, there is a (standard iOS) blue button with the label "Got it". Clicking this button will lead you to step 2.

Step 2
The user will see a notification overlay, which prevents the user to use/see the main app. The notification is a combination of what we currently showing in our second on-boarding slide and the main screen. The headline of the notification overlay, which is designed like a default iOS notification, is:
Headline: "Before you proceed, turn on Adblock Plus in your Safari settings"

Text:

  1. Go to Settings → Safari → Content Blockers.
  2. Turn on Adblock Plus.

After that there is a visual separator (little 2px dots) and another label which says "Watch how-to video" (color: standard blue). When clicking this label, the how-to video opens and behave like it currently does.

Step 3
The user needs to activate Adblock Plus in the Safari settings. Step 2 will be visible in the app as long as the activation is not done. If Adblock Plus is activated and ABP for iOS is opened again, another screen will appear which tells, that the activation was successfully and that there is some progress to configure the filter lists.

Wording:

Text: “You’ve activated Adblock Plus in Safari”

(dotted separator)

Headline: Configuring filter lists

(spinner/progress indicator)

Text: This can take some second

Step 4
After the configuration is done, there will be one last screen which will tell the user, that Adblock Plus for Safari is now ready to use, or, if there were connection problems, that the user needs to manually update the filterlists.

Wording (if everything went well):

Headline: “Adblock Plus is installed”

Text: “Adblock Plus is activated in Safari and all filter lists are up to date. You can use Safari without annoying ads now.”

Button: “Finish”

Wording (if there was a problem, while updating the filter lists):

Headline: Filter lists are not up to date

Text: “There was no internet connection while trying to update the filter lists. Please update the filter lists manually in the settings. It’s possible, that you still see some ads in Safari, because of the outdated filter lists.”

Button: “Finish”

After clicking “Finish” the main app will appear.

Step 5
The main app is basically the current settings page but with little visual adjustments. Please ignore and omit the "Feedback" menu item as of now. The functionality will be described in a separate issue. The ad for Adblock Browser is not part of the visuals, but it should be part of the main app. The ad should be placed on the bottom of the main app, means that a user needs to scroll to see it, if there are too many menu items.

  • Exception: If the user disables ABP for iOS in the Safari Settings afterwards, the modal notification from Step 1 is shown again (if possible).

Screenshots:

Style Guides

(Please note that the screenshots above don't use the exact same style as described in this style guide. Please apply this style guide to the content for each notification.)

Images

Attachments (25)

Adblock Plus iOS 17 1st step.png (106.7 KB) - added by sven 2 years ago.
Adblock Plus iOS 17 AA.png (109.4 KB) - added by sven 2 years ago.
Adblock Plus iOS 17 main.png (107.9 KB) - added by sven 2 years ago.
Adblock Plus iOS 18 main styleguide.png (115.9 KB) - added by sven 2 years ago.
Adblock Plus iOS 17 1st step style guide.png (123.4 KB) - added by sven 2 years ago.
Adblock Plus iOS 18 AA style guide.png (123.8 KB) - added by sven 2 years ago.
Adblock Plus iOS 18 1st step style guide.png (123.4 KB) - added by sven 2 years ago.
checkmark_48.png (20.8 KB) - added by sven 2 years ago.
dotted separator.png (17.3 KB) - added by sven 2 years ago.
Ticket_3175.png (25.5 KB) - added by lisabielik 2 years ago.
Adblock Plus iOS 20 AA.png (125.8 KB) - added by sven 2 years ago.
Adblock Plus for iOS 22 - 0 AA introduction.png (123.6 KB) - added by sven 2 years ago.
Adblock Plus for iOS 22 - 1 step activation.png (121.7 KB) - added by sven 2 years ago.
Adblock Plus for iOS 22 - 2nd step verification.png (122.0 KB) - added by sven 2 years ago.
Adblock Plus for iOS 22 - 3 step result bad.png (125.3 KB) - added by sven 2 years ago.
Adblock Plus for iOS 22 - 3 step result goood.png (120.0 KB) - added by sven 2 years ago.
Adblock Plus iOS 22 step 1.png (132.1 KB) - added by sven 2 years ago.
Adblock Plus iOS 22 step 2.png (129.6 KB) - added by sven 2 years ago.
checkmark-48.png (20.8 KB) - added by sven 2 years ago.
dotted-separator-step3.png (17.3 KB) - added by sven 2 years ago.
Adblock Plus iOS 22 step 3.png (129.8 KB) - added by sven 2 years ago.
ABP_for_iOS_ALERT_v2.0.pdf (147.4 KB) - added by mario 22 months ago.
Notification Styleguide
Settings notification.png (65.4 KB) - added by mario 13 months ago.
alert icon@2x.png (5.0 KB) - added by jeen 13 months ago.
Alert icon
ABP-iOS_workflow_inconsistencies.png (134.4 KB) - added by mario 7 months ago.

Download all attachments as: .zip

Change History (81)

Changed 2 years ago by sven

Changed 2 years ago by sven

Changed 2 years ago by sven

comment:1 Changed 2 years ago by sven

  • Description modified (diff)

comment:2 Changed 2 years ago by sven

  • Cc fhd added

comment:3 Changed 2 years ago by sven

  • Description modified (diff)

comment:4 Changed 2 years ago by mario

  • Cc mario added

Changed 2 years ago by sven

comment:5 Changed 2 years ago by sven

  • Description modified (diff)

Changed 2 years ago by sven

Changed 2 years ago by sven

Changed 2 years ago by sven

comment:6 Changed 2 years ago by sven

  • Description modified (diff)

comment:7 follow-up: Changed 2 years ago by philll

The background section does not give enough info about which issues the app had, thus it cannot be evaluated, if the suggested change solved those issues. Please be more explicit.

comment:8 Changed 2 years ago by lisabielik

Please see Ticket_3175.png for text changes.

Changed 2 years ago by lisabielik

comment:9 follow-ups: Changed 2 years ago by vojtab

The "Feedback" menu item is out of scope for now as it is unclear what it should do. Please raise a separate ticket for Feedback feature.

comment:10 Changed 2 years ago by vojtab

You want to show blocking "modal" popup (step 1) until ABP is enabled in content blocking settings in Safari. What should happen when user disables it again in Safari settings after some time & then open the Adblock Plus for iOS app? Do you want to fall back to blocking step 1 modal again? Or should normal settings page be shown from this point forward (= blocking modals steps 1 & 2 would be show always only once)?

comment:11 Changed 2 years ago by vojtab

In case modal should not be shown again, do you want to display certain status icon etc. on main page (step 4) to indicate that ABP is disabled in Safari Settings?

comment:12 in reply to: ↑ 7 Changed 2 years ago by mario

Replying to philll:

The background section does not give enough info about which issues the app had, thus it cannot be evaluated, if the suggested change solved those issues. Please be more explicit.

Last Wednesday we've discussed the most recent user feedback and concluded, that there are issues, that can be avoided by restructuring the app's layout and workflow:

  • When the app is started and ABP isn't activated in the iOS Settings, show a notification, that locks the rest of the app. The notification states, that the user needs to enable ABP in the Settings before he can proceed. "Locking" the app by a notification prevents users from assuming, that ABP works by only starting the app (and not reading the information as currently shown).
  • Show a confirmation-screen as soon as ABP is enabled and subsequently unlock the app.
  • Show a direct link to the iOS Settings in order to make it easier for the user to find where to enable ABP

I'll add this to the background section.

comment:13 Changed 2 years ago by mario

  • Description modified (diff)

comment:14 in reply to: ↑ 9 Changed 2 years ago by sven

Replying to vojtab:

"The "Feedback" menu item is out of scope for now as it is unclear what it should do. Please raise a separate ticket for Feedback feature."

Yes ignore that please.

"You want to show blocking "modal" popup (step 1) until ABP is enabled in content blocking settings in Safari. What should happen when user disables it again in Safari settings after some time & then open the Adblock Plus for iOS app? Do you want to fall back to blocking step 1 modal again? Or should normal settings page be shown from this point forward (= blocking modals steps 1 & 2 would be show always only once)?"

It would be optimal to check if a user disabled the setting, to show the lock screen again, but for a first implementation this is not necessary, but a nice to have.

comment:15 in reply to: ↑ 9 Changed 2 years ago by mario

  • Description modified (diff)

comment:16 Changed 2 years ago by mario

  • Keywords needs wording approvement removed

comment:17 Changed 2 years ago by mario

  • Keywords salsita added

Changed 2 years ago by sven

comment:18 Changed 2 years ago by sven

  • Description modified (diff)

comment:19 Changed 2 years ago by mario

  • Keywords 2015q4 added

comment:20 Changed 2 years ago by sven

  • Description modified (diff)

comment:21 Changed 2 years ago by mario

  • Priority changed from Unknown to P2

Changed 2015q4-issues to P2

comment:22 Changed 2 years ago by mario

  • Ready set

comment:23 Changed 2 years ago by sven

  1. "The ad should be placed on the bottom of the main app, means that a user needs to scroll to see it, if there are too many menu items.". At the moment it's sticky at the initial screem at the bottom
  1. Another thing that i saw is that the app conten is scrolled a bit while you see the overlay in the beginning. So if you see the overlay, which tells you to activate the content blocker first, you see the app content in the background, but a bit scrolled down.

comment:24 Changed 2 years ago by philll

  • Ready unset

Not ready. Most of the what to change section is rather background if at all and does neither give specific changes nor a description of the desired state.
Examples:

  • "The new workflow is put into three steps." but there are four steps.
  • I don't understand what "Step 4" refers to.
  • "What needs to be done: Final wording" is neither a change nor a description and hints to unfinished requirements.
  • The attachments are not referred to in the description

I also don't get what the last comment here refers to? If there's something important to the implementation, it should land in the description.

Please provide a clear and precise description of either changes that need to be done or (preferably) a complete description of the desired features. If using attachments, refer to them in the actual description, not as a lose list to be matched to the relevant points by the reader. If texts are required, include them in the description after having gotten approval from tech writing.

comment:25 Changed 2 years ago by sven

"What needs to be done: Final wording" is neither a change nor a description and hints to unfinished requirements. -> correct. Don't know how you handle that, but the implementation can start without final wordings. So I'm fine, if the issue isn't set "Ready" as long it does mean that there is something missing, but you can already work on that. Please clarify that with mario.

"The attachments are not referred to in the description" - Not sure what you mean with "The attachments" b/c all relevant attachments are. There are more in the attachments, b/c they were uploaded in a time of a previous version of this ticket.

The last comment was made while we had the meeting today to not forget these two points. There are 3 steps that we implemented but 4 which are necessary for the user to activate adblock plus. Step 3 is just a user interaction. We could write that it's 4 steps, if this is confusing.


comment:26 Changed 2 years ago by sven

  • Description modified (diff)

comment:27 Changed 2 years ago by sven

  • Description modified (diff)

comment:28 Changed 2 years ago by sven

  • Description modified (diff)

Changed 2 years ago by sven

Changed 2 years ago by sven

Changed 2 years ago by sven

Changed 2 years ago by sven

Changed 2 years ago by sven

comment:29 Changed 2 years ago by sven

  • Description modified (diff)

comment:30 Changed 23 months ago by mario

  • Ready set

comment:31 Changed 23 months ago by sven

The workflow lgtm, but there are some minor visual things, which are not implemented such as described in that ticket:

  • In step 2 in "Go to Safari settings → Content Blockers." Safari settings and Content Blockers should be displayed in bold.
  • The font size is smaller than defined.

Changed 22 months ago by mario

Notification Styleguide

comment:32 Changed 22 months ago by mario

  • Ready unset

comment:33 Changed 21 months ago by mario

  • Description modified (diff)
  • Ready set

comment:34 Changed 13 months ago by mario

As per step 2:

After that a (standard iOS) blue button with the label "Open iOS Settings".
This button will link to the general iOS settings (we're not able to link to the Safari -> Content Blockers menu. The reasons are iOS restrictions).

This is currently not reflected in the app.

How to reproduce

  1. Deactivate ABP in Safari's settings and uninstall ABP
  2. Install ABP for iOS 1.2.0
  3. Start ABP for iOS
  4. Tap the button "Open iOS Settings" when prompted

Observed behavior

Tapping the button "Open iOS Settings" opens ABB's Settings page

Expected behavior

Tapping the button "Open iOS Settings" opens the iOS Settings

comment:35 Changed 13 months ago by pavelz

@mario not a bug, unfortunately. The feature of opening iOS settings through custom crafted URL was disabled in iOS10.
https://gist.github.com/phynet/471089a51b8f940f0fb4
http://stackoverflow.com/questions/8246070/ios-launching-settings-restrictions-url-scheme
http://stackoverflow.com/questions/5655674/opening-the-settings-app-from-another-app

The app does as much as it can: when opening that custom URL fails, it opens the only legally and publicly available URL, which is the app's settings itself. Now the question is, how to improve the UX:

  1. either do nothing, falling back to the previous waiting on the user to go to the Settings on his own
  2. or instruct the user to click "Settings>" in the app's settings page, which will take him to the Settings
Last edited 13 months ago by pavelz (previous) (diff)

comment:36 Changed 13 months ago by pavelz

@mario while i was hunting the disappearance of #3241 from devbuild (configurable filter lists), i had a multiple opportunity to activate the filter in safari through both methods and i must say that method 2 is WAY MORE user friendly.

For method 1, one must leave the ABP app to reach settings from the main iOS screen. When Safari is found and settings changed, ABP app has to be found again manually in app listing.

For method 2, Settings "app" is entered directly from ABP app. Now since iOS9, there is a desperate attempt at Android's hardware back button - i.e. navigating to "previous" app. It's covering top left corner where signal strength is normally. It shows "Adblock Plus" all the time being in iOS Settings. So when the user switches the Safari blocker switch, he can appear directly back in the ABP onboarding with a single click!

It's so much better UX that i don't recommend method 1 at all anymore even at expense of needing to make a new tutorial video.

comment:37 Changed 13 months ago by mario

@pavelz, Thanks for the feedback. We're currently looking into this.

Other than that, we just found an issue with the current preview:

How to reproduce

  1. Install ABP for iOS 1.2.1 preview devbuild
  2. Open ABP
  3. Navigate to step 3

Observed behaviour

The spinner icon is not displayed

Expected behaviour

The spinner icon is displayed as shown in this screenshot.

comment:38 Changed 13 months ago by mario

  • Description modified (diff)
  • Ready unset

Changed 13 months ago by mario

comment:39 Changed 13 months ago by mario

  • Cc lisabielik added

@pavelz, I've updated "Step 2" to reflect the fact, that we can't deep-link to the Settings app anymore. Please review the following changes:

  • The headline of Step 2 has changed
  • The text of Step 2 has changed
  • We have removed the "Open iOS Settings" button

Our designers have figured, that deep-linking to the ABP settings might cause more confusion than requiring users to open the Settings app themselves. In order to avoid introducing another fail-state we've removed the button altogether instead of giving any choice of confirmation (like a "Go it!" button).

@lisabielik, could you please review the changed strings in "Step 2"?
The strings in question are:

  • "Turn on Adblock Plus in your Safari settings first" to "Before you proceed, turn on Adblock Plus in your Safari settings"
  • "Go to Safari settings -> Content Blockers." to "Go to Settings -> Safari -> Blockers."

comment:40 Changed 13 months ago by lisabielik

@mario:

Before you proceed, turn on Adblock Plus in your Safari settings.

  1. Go to Settings -> Safari -> Blockers.
  2. Turn on Adblock Plus.

comment:41 Changed 13 months ago by mario

  • Description modified (diff)

@lisabielik, thanks a lot, I modified the description accordingly.
Regarding "Before you proceed, turn on Adblock Plus in your Safari settings.": We did not use punctuation in headlines in the introduction slides so far. Would you rather add punctuation to all headlines? This would concern the following headlines:

comment:42 Changed 13 months ago by lisabielik

@mario:

No, sorry for the mistake...no punctuation in the headlines.

Thanks!

comment:43 Changed 13 months ago by mario

  • Description modified (diff)

Thanks, changed.

comment:44 Changed 13 months ago by pavelz

  • Cc vojtab removed

comment:45 Changed 13 months ago by jand

@mario: Can you provide me image from Step 2?

comment:46 Changed 13 months ago by mario

  • Cc jeen added

@jeen, can you please attach the "(i)" symbol from Step 2 as an image? Alternatively feel free to invite me to Zeplin, if this project is online there.

Changed 13 months ago by jeen

Alert icon

comment:47 Changed 12 months ago by jand

  • Status changed from new to reviewing

comment:48 Changed 12 months ago by mario

  • Ready set
  • Review URL(s) modified (diff)

comment:49 Changed 12 months ago by mario

  • Description modified (diff)

comment:51 Changed 12 months ago by mario

@pavelz, we're holding back the review until the discussed changes in Slide 2 are implemented. See discussion on slack: Fonts on Slide 2 are too big. Please adjust fonts to match the style guide.

comment:52 Changed 10 months ago by abpbot

A commit referencing this issue has landed:
Issue 3175 - Change app workflow

comment:53 Changed 10 months ago by fhd

  • Milestone set to Adblock-Plus-for-iOS-next
  • Resolution set to fixed
  • Status changed from reviewing to closed

Changed 7 months ago by mario

comment:54 Changed 7 months ago by mario

  • Resolution fixed deleted
  • Status changed from closed to reopened

We encountered inconsistencies in the style of the onboarding slides, which need to be addressed.

As per this comparison, numbered accordingly:

  1. The icon on slide 1 ("Before you proceed") is too big. Please adjust it to the same size as in slide 3 ("Updating filter list").
  2. The headlines on slide 1 ("Before you proceed") and slide 4 ("You're in control") do have a different style compared to slide 2 and 3. Please adjust the two headlines to match the style (size and boldness) of slide 2 and 3.
  3. The bottom spacing on slide 1 ("Before you proceed") is bigger than on slide 3 ("Updating filter list"). Please adjust the spacing on slide 1 to match the spacing on slide 3.
  4. The paragraph text on slide 1 ("Before you proceed") is bigger compared to slide 2 and 4. The paragraph text on slide 3 ("Updating filter list") is smaller than on slide 2 and 4. Please adjust the paragraph text on slide 1 and 3 to match the style/size of the paragraph text of slide 2 and 4.

Except for 1., the styles of all elements are described in this styleguide. Inconsistencies should be covered by the list above, however, please double check all elements on all onboarding slides to exactly match the style guide.

comment:55 Changed 4 months ago by ashephard

  • Owner set to ashephard

comment:56 Changed 4 months ago by mario

  • Cc jand pavelz removed
  • Ready unset

Temporarily marking this issue as not ready as a discussion is going on about whether to introduce additional changes.
Will update asap.

Note: See TracTickets for help on using tickets.