diff options
Diffstat (limited to 'browser/components/asrouter/docs/private-browsing.md')
-rw-r--r-- | browser/components/asrouter/docs/private-browsing.md | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/browser/components/asrouter/docs/private-browsing.md b/browser/components/asrouter/docs/private-browsing.md new file mode 100644 index 0000000000..405a5a1019 --- /dev/null +++ b/browser/components/asrouter/docs/private-browsing.md @@ -0,0 +1,59 @@ +# PrivateBrowsing + +## What is PrivateBrowsing? +Messages shown inside `about:privatebrowsing` (incognito) content page. This messaging surface allows experimentation on content shown (promotion and info section) when new private window or tab is opened. + +### Example of a PrivateBrowsing window +![Private Browsing](./private-browsing.png) + +## Testing PrivateBrowsing + +### Via the dev tools: +1. In the search tab go to `about:config`, set `browser.newtabpage.activity-stream.asrouter.devtoolsEnabled` to `true` +2. Open a new tab, in the search tab go to `about:asrouter` +3. On the left navigation, click on `Private Browsing` +4. This shows all example messages developed for `about:privatebrowsing` messaging surface +5. You can directly modify the message in the text area with your changes or by pasting your custom message JSON. Ensure that all required properties are covered according to the [Private Browsing Schema](https://searchfox.org/mozilla-central/source/browser/components/asrouter/content-src/templates/PBNewtab/NewtabPromoMessage.schema.json) +6. To view message in private browsing window, click the circle to select respective message. Then hit the blue `Open a Private Browsing Window` at the top of the screen. This opens new private window with promotion and info section updated with custom message. + +![Circle](./selected-PB.png) + +7. To reset the chosen PrivateBrowsing window and choose another, click `Reset Message State` at the top of the screen + +### Via Experiments: +You can test any `privatebrowsing` custom message UI by creating an experiment. [Messaging Journey](https://experimenter.info/messaging/desktop-messaging-journey) captures creating experiments via Nimbus. + +### Example of messaging in privatebrowsing window +``` +{ + "id": "TEST_PBM_PROMO", + "template": "pb_newtab", + "content": { + "promoEnabled": true, + "promoType": "VPN", + "infoEnabled": true, + "infoBody": "Nightly clears your search and browsing history", + "infoLinkText": "Click Here to Learn More", + "infoTitleEnabled": false, + "promoLinkType": "button", + "promoLinkText": "fluent:about-private-browsing-prominent-cta", + "promoSectionStyle": "below-search", + "promoHeader": "Get privacy protections", + "promoTitle": "Hide browsing activity and location with Mozilla VPN. One click creates a secure connection", + "promoTitleEnabled": true, + "promoImageLarge": "chrome://browser/content/assets/moz-vpn.svg", + "promoButton": { + "action": { + "type": "OPEN_URL", + "data": { + "args": "https://vpn.mozilla.org/" + } + } + } + }, + "targeting": "firefoxVersion >= 89", + "frequency": { + "lifetime": 3 + } +} +``` |