diff --git a/content/support/ooni-run/images/image1.png b/content/support/ooni-run/images/image1.png index f0ecc160c..69c1c3ddd 100644 Binary files a/content/support/ooni-run/images/image1.png and b/content/support/ooni-run/images/image1.png differ diff --git a/content/support/ooni-run/images/image10.png b/content/support/ooni-run/images/image10.png index 5279eac3f..44bc5c259 100644 Binary files a/content/support/ooni-run/images/image10.png and b/content/support/ooni-run/images/image10.png differ diff --git a/content/support/ooni-run/images/image11.png b/content/support/ooni-run/images/image11.png index 95a1cfcb2..010f88f40 100644 Binary files a/content/support/ooni-run/images/image11.png and b/content/support/ooni-run/images/image11.png differ diff --git a/content/support/ooni-run/images/image12.png b/content/support/ooni-run/images/image12.png index edadb77fa..e145cd9f6 100644 Binary files a/content/support/ooni-run/images/image12.png and b/content/support/ooni-run/images/image12.png differ diff --git a/content/support/ooni-run/images/image13.png b/content/support/ooni-run/images/image13.png new file mode 100644 index 000000000..22066492d Binary files /dev/null and b/content/support/ooni-run/images/image13.png differ diff --git a/content/support/ooni-run/images/image14.png b/content/support/ooni-run/images/image14.png new file mode 100644 index 000000000..0fdbb8ae3 Binary files /dev/null and b/content/support/ooni-run/images/image14.png differ diff --git a/content/support/ooni-run/images/image15.png b/content/support/ooni-run/images/image15.png index 11ff075fe..9e9af7f10 100644 Binary files a/content/support/ooni-run/images/image15.png and b/content/support/ooni-run/images/image15.png differ diff --git a/content/support/ooni-run/images/image16.png b/content/support/ooni-run/images/image16.png new file mode 100644 index 000000000..328da9bb1 Binary files /dev/null and b/content/support/ooni-run/images/image16.png differ diff --git a/content/support/ooni-run/images/image17.jpg b/content/support/ooni-run/images/image17.jpg new file mode 100644 index 000000000..dda441bef Binary files /dev/null and b/content/support/ooni-run/images/image17.jpg differ diff --git a/content/support/ooni-run/images/image18.jpg b/content/support/ooni-run/images/image18.jpg new file mode 100644 index 000000000..54de6a2ad Binary files /dev/null and b/content/support/ooni-run/images/image18.jpg differ diff --git a/content/support/ooni-run/images/image19.jpg b/content/support/ooni-run/images/image19.jpg new file mode 100644 index 000000000..45898d584 Binary files /dev/null and b/content/support/ooni-run/images/image19.jpg differ diff --git a/content/support/ooni-run/images/image2.jpg b/content/support/ooni-run/images/image2.jpg new file mode 100644 index 000000000..4e4013ddf Binary files /dev/null and b/content/support/ooni-run/images/image2.jpg differ diff --git a/content/support/ooni-run/images/image20.jpg b/content/support/ooni-run/images/image20.jpg new file mode 100644 index 000000000..55fbb6e6e Binary files /dev/null and b/content/support/ooni-run/images/image20.jpg differ diff --git a/content/support/ooni-run/images/image21.png b/content/support/ooni-run/images/image21.png new file mode 100644 index 000000000..4885879eb Binary files /dev/null and b/content/support/ooni-run/images/image21.png differ diff --git a/content/support/ooni-run/images/image22.png b/content/support/ooni-run/images/image22.png new file mode 100644 index 000000000..6cd41c81b Binary files /dev/null and b/content/support/ooni-run/images/image22.png differ diff --git a/content/support/ooni-run/images/image23.png b/content/support/ooni-run/images/image23.png new file mode 100644 index 000000000..3055c557e Binary files /dev/null and b/content/support/ooni-run/images/image23.png differ diff --git a/content/support/ooni-run/images/image24.jpg b/content/support/ooni-run/images/image24.jpg new file mode 100644 index 000000000..b09610916 Binary files /dev/null and b/content/support/ooni-run/images/image24.jpg differ diff --git a/content/support/ooni-run/images/image25.png b/content/support/ooni-run/images/image25.png new file mode 100644 index 000000000..566aca029 Binary files /dev/null and b/content/support/ooni-run/images/image25.png differ diff --git a/content/support/ooni-run/images/image26.png b/content/support/ooni-run/images/image26.png new file mode 100644 index 000000000..0819194b5 Binary files /dev/null and b/content/support/ooni-run/images/image26.png differ diff --git a/content/support/ooni-run/images/image27.png b/content/support/ooni-run/images/image27.png new file mode 100644 index 000000000..e6624c271 Binary files /dev/null and b/content/support/ooni-run/images/image27.png differ diff --git a/content/support/ooni-run/images/image28.png b/content/support/ooni-run/images/image28.png new file mode 100644 index 000000000..8648ea757 Binary files /dev/null and b/content/support/ooni-run/images/image28.png differ diff --git a/content/support/ooni-run/images/image29.png b/content/support/ooni-run/images/image29.png new file mode 100644 index 000000000..9bff1a79d Binary files /dev/null and b/content/support/ooni-run/images/image29.png differ diff --git a/content/support/ooni-run/images/image3.jpg b/content/support/ooni-run/images/image3.jpg new file mode 100644 index 000000000..b41aa01d7 Binary files /dev/null and b/content/support/ooni-run/images/image3.jpg differ diff --git a/content/support/ooni-run/images/image30.png b/content/support/ooni-run/images/image30.png new file mode 100644 index 000000000..69dd86638 Binary files /dev/null and b/content/support/ooni-run/images/image30.png differ diff --git a/content/support/ooni-run/images/image31.png b/content/support/ooni-run/images/image31.png new file mode 100644 index 000000000..0fc4b160f Binary files /dev/null and b/content/support/ooni-run/images/image31.png differ diff --git a/content/support/ooni-run/images/image32.png b/content/support/ooni-run/images/image32.png new file mode 100644 index 000000000..90bfe7ef6 Binary files /dev/null and b/content/support/ooni-run/images/image32.png differ diff --git a/content/support/ooni-run/images/image33.png b/content/support/ooni-run/images/image33.png new file mode 100644 index 000000000..3c82a9c3d Binary files /dev/null and b/content/support/ooni-run/images/image33.png differ diff --git a/content/support/ooni-run/images/image34.png b/content/support/ooni-run/images/image34.png new file mode 100644 index 000000000..27cc7bb79 Binary files /dev/null and b/content/support/ooni-run/images/image34.png differ diff --git a/content/support/ooni-run/images/image35.png b/content/support/ooni-run/images/image35.png new file mode 100644 index 000000000..9379a2c83 Binary files /dev/null and b/content/support/ooni-run/images/image35.png differ diff --git a/content/support/ooni-run/images/image36.png b/content/support/ooni-run/images/image36.png new file mode 100644 index 000000000..1fe5b2e3b Binary files /dev/null and b/content/support/ooni-run/images/image36.png differ diff --git a/content/support/ooni-run/images/image37.png b/content/support/ooni-run/images/image37.png new file mode 100644 index 000000000..774adcf1b Binary files /dev/null and b/content/support/ooni-run/images/image37.png differ diff --git a/content/support/ooni-run/images/image38.png b/content/support/ooni-run/images/image38.png new file mode 100644 index 000000000..5d5b7d5be Binary files /dev/null and b/content/support/ooni-run/images/image38.png differ diff --git a/content/support/ooni-run/images/image39.png b/content/support/ooni-run/images/image39.png new file mode 100644 index 000000000..4d64c1240 Binary files /dev/null and b/content/support/ooni-run/images/image39.png differ diff --git a/content/support/ooni-run/images/image4.png b/content/support/ooni-run/images/image4.png index 6e2e3f21d..ea55b2597 100644 Binary files a/content/support/ooni-run/images/image4.png and b/content/support/ooni-run/images/image4.png differ diff --git a/content/support/ooni-run/images/image40.png b/content/support/ooni-run/images/image40.png new file mode 100644 index 000000000..42af24c3b Binary files /dev/null and b/content/support/ooni-run/images/image40.png differ diff --git a/content/support/ooni-run/images/image41.jpg b/content/support/ooni-run/images/image41.jpg new file mode 100644 index 000000000..3a4df4af7 Binary files /dev/null and b/content/support/ooni-run/images/image41.jpg differ diff --git a/content/support/ooni-run/images/image42.jpg b/content/support/ooni-run/images/image42.jpg new file mode 100644 index 000000000..11d2b10d2 Binary files /dev/null and b/content/support/ooni-run/images/image42.jpg differ diff --git a/content/support/ooni-run/images/image43.png b/content/support/ooni-run/images/image43.png new file mode 100644 index 000000000..bc4b07ea7 Binary files /dev/null and b/content/support/ooni-run/images/image43.png differ diff --git a/content/support/ooni-run/images/image5.png b/content/support/ooni-run/images/image5.png index 4e6069989..9aebe4718 100644 Binary files a/content/support/ooni-run/images/image5.png and b/content/support/ooni-run/images/image5.png differ diff --git a/content/support/ooni-run/images/image6.jpg b/content/support/ooni-run/images/image6.jpg index 0cbf003d0..e7abfbd97 100644 Binary files a/content/support/ooni-run/images/image6.jpg and b/content/support/ooni-run/images/image6.jpg differ diff --git a/content/support/ooni-run/images/image7.png b/content/support/ooni-run/images/image7.png index 37aeb5e7b..c793b1f37 100644 Binary files a/content/support/ooni-run/images/image7.png and b/content/support/ooni-run/images/image7.png differ diff --git a/content/support/ooni-run/images/image8.png b/content/support/ooni-run/images/image8.png new file mode 100644 index 000000000..2842022c4 Binary files /dev/null and b/content/support/ooni-run/images/image8.png differ diff --git a/content/support/ooni-run/images/image9.jpg b/content/support/ooni-run/images/image9.jpg new file mode 100644 index 000000000..8aedb0120 Binary files /dev/null and b/content/support/ooni-run/images/image9.jpg differ diff --git a/content/support/ooni-run/index.md b/content/support/ooni-run/index.md index b6c6d25a7..5375f67de 100644 --- a/content/support/ooni-run/index.md +++ b/content/support/ooni-run/index.md @@ -1,16 +1,14 @@ # User Guide: OONI Run -**Last updated:** 13th December 2022 +**Last updated:** 24th October 2024 {{OONI Run}} -[OONI Run](https://run.ooni.org/) is a web platform that you can use to generate mobile deep links and widget code to coordinate [OONI Probe](https://ooni.org/install/mobile) website testing. Specifically, you can use OONI Run to create links or widget code for: - +[OONI Run](https://run.ooni.org/) is a web platform that you can use to generate mobile deep links to coordinate [OONI Probe](https://ooni.org/install/mobile) website testing. Specifically, you can use OONI Run to create links for: * Testing websites (of your choice) for censorship; * Coordinating website censorship testing with other [OONI Probe](https://ooni.org/install/mobile) users. -**OONI Run links only work with the [OONI Probe mobile app](https://ooni.org/install/mobile).** To learn how to -use OONI Probe, please refer to our [OONI Probe mobile app user guide](https://ooni.org/support/ooni-probe-mobile). +**OONI Run links only work with the [OONI Probe mobile app](https://ooni.org/install/mobile).** To learn how to use OONI Probe, please refer to our [OONI Probe mobile app user guide](https://ooni.org/support/ooni-probe-mobile). This user guide provides **step-by-step instructions** on how to use the [OONI Run](https://run.ooni.org/) platform for custom OONI Probe website testing. @@ -22,145 +20,225 @@ This user guide provides **step-by-step instructions** on how to use the [OONI R * Learn how to **share OONI Run links** with other [OONI Probe mobile app](https://ooni.org/install/mobile) users; -* Learn how to **generate OONI Run widget code**. - Upon reading this guide, we hope you will feel empowered to share your OONI Run knowledge and skills with others! We also hope this guide helps with coordinating OONI Probe website testing around the world. The following table of contents should help with navigating the guide. -* [Creating OONI Run links](#creating-ooni-run-links) +{{}} + +## Joining the platform + +[OONI Run](https://run.ooni.org/) enables you to generate a link to test websites (of your choice) for censorship. You can also share this link with other [OONI Probe mobile app](https://ooni.org/install/mobile) users so that they can test those websites. The first step is to **create an account** on OONI Run platform: + +**Step 1.** Click the “**Log In To Create OONI Run Link**” button. + +**Step 2.** Add your **email address** in the Email slot. -* [Using and sharing OONI Run links for website testing](#using-and-sharing-ooni-run-links-for-website-testing) +{{}} -* [Creating OONI Run widget code for website testing](#creating-ooni-run-widget-code-for-website-testing) +**Note:** We do not store email addresses when you log in, but only when you create an OONI Run link. We store your email address so that when OONI Probe users receive an OONI Run link from you, they can trust it based on your email address (which is displayed in the OONI Run link you create). This can help reduce the risk of running malicious links. -* [Optional, but encouraged: Adding your websites to test lists](#optional-but-encouraged-adding-your-websites-to-test-lists) +**Step 3.** Click the “**Send me the Link**” button. This will send a link to your email address. + +{{}} + +**Step 4.** Click the link (“Please login here”) sent to your email to log into the OONI Run v2 platform. ## Creating OONI Run links -[OONI Run](https://run.ooni.org/) enables you to generate a link to test websites (of your choice) for censorship. You can also share this link with other [OONI Probe mobile [app](https://ooni.org/install/mobile) users so that they can test those websites. The first step is to determine *which* websites you want to test. +You have now logged into the OONI Run platform and can start creating OONI Run links. Here you can customise the title, description, timeframe and a list of URLs for testing. To do this, please use the following instructions: -**Step 1.** Create a list of websites in a text editor, where each URL is in a separate line. You do not need to separate URLs by commas or in any other way. Please see an example below. +**Step 1.** Add a **title** for your OONI Run link. Optionally, you can add translations for your title. -{{List of URLs}} +{{}} -**Important:** Please ensure that each -[URL](https://ooni.org/support/glossary/#url) is typed correctly. If it is mis-typed, [OONI Probe](https://ooni.org/install/mobile) will *not* test the intended website and this will potentially lead to inaccurate test results. +**Note:** This title will appear in the OONI Run link card that testers will install in their [OONI Probe mobile app](https://ooni.org/install/mobile). We recommend using a short title which clearly communicates the type of testing performed. In the above example, we have added “Test social media” as a title because we aim to include social media websites for testing in our OONI Run link. -A few things to keep in mind: +**Step 2.** Add a **short description** for your OONI Run link. Optionally, you can add translations. -* Is the website on **HTTP** or **HTTPS**? If the latter, please add an extra `s` after `http`. +{{}} -* Does the [domain](https://ooni.org/support/glossary/#domain-name) include `www`? If so, please include it. +**Note:** In the above example, we have specified the social media platforms that we plan to add to our OONI Run link, and which we’re asking [OONI Probe mobile app](https://ooni.org/install/mobile) users to test. We recommend specifying the tested platforms or adding other useful context that can help encourage testing. -* If the website is on HTTPS (e.g. `https://www.hrw.org/`), you don't need to specify a webpage (e.g., `https://www.hrw.org/publications`), since ISPs usually cannot limit blocking to a specific webpage when it's hosted on HTTPS. Rather, they would have to block access to the entire website. +**Step 3.** Add a (longer) **description** for your OONI Run link. This is an opportunity to communicate details about the testing, and why it’s important. Optionally, you can add translations. -To ensure that each [URL](https://ooni.org/support/glossary/#url) is typed accurately, **please copy-paste it from a browser.** +{{}} -If you don't have specific websites in mind, you can refer to the [public lists](https://github.com/citizenlab/test-lists/tree/master/lists) ("[test lists](https://ooni.org/get-involved/contribute-test-lists)") that [OONI Probe](https://ooni.org/install/) uses for testing. These lists include a wide range of websites, all of which are [thematically categorized](https://github.com/citizenlab/test-lists/blob/master/lists/00-LEGEND-new_category_codes.csv) (e.g. news media, human rights). +**Step 4.** Add an **expiration date** for your OONI Run link. -**Step 2.** **Copy** your list of URLs (from your text editor). +{{}} -**Step 3.** Visit the **OONI Run** website: [https://run.ooni.org/](https://run.ooni.org/) +**Note:** Determine the expiration date based on how long you would like OONI Probe users to have the ability to run your OONI Run link. -{{OONI Run}} +**Step 5.** Click “Add URL” to start adding URLs to your OONI Run link. + +{{}} + +### Adding URLs to the list + +The next step is to determine *which* websites you want to test. While thinking about the list of websites you want to share with other OONI Probe users, please consider the following: + +* **Number of URLs you are including**: There is no limit for the number of URLs to include in the OONI Run link. However, the length of the list affects the time and amount of traffic it will take for OONI Probe to run the test. Depending on your goals and context, you may want to limit the list of URLs to a few links to allow users to run tests faster and limit the amount of data they would need to spend for testing. +* **URL formatting**: To ensure that each URL is typed accurately, **please copy-paste it from a browser**. Important things to keep in mind while adding URLs to the list: + * Is the website on **HTTP** or **HTTPS**? If the latter, please add an extra `s` after `http`. + * Does the [domain](https://ooni.org/support/glossary/#domain-name) include `www`? If so, please include it. + * If the website is on HTTPS (e.g. https://www.hrw.org/), you don’t need to specify a webpage (e.g., `https://www.hrw.org/publications`), since ISPs usually cannot limit blocking to a specific webpage when it’s hosted on HTTPS. Rather, they would have to block access to the entire website. + +We recommend **creating a list of websites in a text editor**, where each URL is in a separate line. You do not need to separate URLs by commas or in any other way. Please see an example below. + +{{}} + +Once you've created the list, add it to the platform. + +**Step 1.** Add the URLs that you would like to include in your OONI Run link for testing. + +{{}} + +**Note:** You can copy and paste your list of URLs into the first URL slot, and each URL will populate each URL row (if copied based on the above text editor formatting). + +**Step 2.** Click the **Create Link** button to create your OONI Run link. + +You will now see your OONI Run link page which includes the title and description that you added, the expiration date of the link, as well as the list of URLs that you added for testing. + +{{}} + +## Editing the existing OONI Run link + +If you would like to edit your OONI Run link, click the **Edit** button in the top right corner. + +Alternatively, click the **Update Now** button next to the link expiration date. Both actions will enable you to edit the data in your OONI Run link. + +Once the OONI Run link is updated, it will be automatically updated for all users who have it installed in their OONI Probe application if they have “Install updates automatically” option enabled. Alternatively, they will be able to update the OONI Run link manually. + +If you have **old OONI Run links v1 links** (created through the use of the previous OONI Run platform) that you have embedded as widgets into your website or which you are sharing for testing, **please update them** to use OONI Run v2. + +You can update old OONI Run v1 links through the following steps. + +**Step 1.** Scroll down towards the end of the page to the “URLs” section. + +{{}} + +**Step 2.** Click on “**Do you have old OONI Run v1 links? Click here to add URLs from such links**”. + +You will now see a pop-up window for adding your old OONI Run v2 link. + +{{}} + +**Step 3.** Add your old OONI Run v1 link in the “OONI Run Link” field. + +{{}} + +**Step 4.** Click **Add URLs**. + +{{}} + +**Step 5.** Click **Create Link** to create a new OONI Run v2 link based on the URLs of your old OONI Run v1 link. + +**Note:** Through the data fields of the “Create OONI Run Link” page, you will also need to add a title, description, and expiration date for your new OONI Run v2 link before creating it. + +## Sharing OONI Run links + +To **share** your OONI Run link, click the **copy icon** next to your OONI Run link in the “Share this link” section. Then share the copied link with [OONI Probe](https://ooni.org/install/mobile) users who you would like to perform testing. + +{{}} + +You can also **share your link directly on Twitter/X** by clicking on the “Tweet” button. + +Community members often share OONI Run links on Twitter/X when they want to encourage more widespread testing. + +{{}} -**Step 4.** **Paste** your list of URLs into the first URL slot of the OONI Run page. +**Image:** Tweet by Thai Netizen Network sharing an OONI Run link for the testing of Change.org in Thailand. -You should now see that all of your URLs have populated each URL row in the [OONI Run](https://run.ooni.org/) page. +## Using OONI Run links for website testing -{{List of URLs}} +An OONI Run link can only be used with the **OONI Probe mobile app**. -If you notice any empty rows (or otherwise misformatted URLs), please delete them by clicking on the **deletion icon** or edit them by clicking on the URL field. +**OONI Run v2 is currently only supported on Android.** We aim to release support for OONI Run v2 on OONI Probe iOS in subsequent versions. -**Step 5.** Click the **Generate** button at the end of your list. +**Step 1.** Please [install the OONI Probe mobile app](https://ooni.org/install/mobile) on [Android](https://play.google.com/store/apps/details?id=org.openobservatory.ooniprobe). If you already have OONI Probe Android installed, **please update to the latest version (4.0.0)** for OONI Run v2 support. -{{Generate OONI Run link}} +**Step 2.** Tap on the OONI Run link that you received, and **open it with your OONI Probe mobile app** (not with a web browser). This will open a screen in your OONI Probe app, displaying information from the OONI Run link (as illustrated below). -You will now see the following pop-up window. +{{}} -{{Pop-up window}} +As you can see from the above example, we have opened an OONI Run link for the testing of social media in our OONI Probe Android app. This shows information about the requested testing, as well as the list of websites that we are being asked to test. -You have generated an **OONI Run mobile deep link** for the testing of your list of websites. +The **Test Settings of the OONI Run link** include support for: -## Using and sharing OONI Run links for website testing +* **Automated testing of OONI Run link websites.** By keeping the “Run tests automatically” option enabled, the websites included in the OONI Run link will get tested automatically on an ongoing basis. That way, you don’t need to remember to re-test those websites once you have installed the OONI Run link – the OONI Probe app will do that automatically for you! We recommend keeping this option enabled to help ensure ongoing testing, greater measurement coverage, and enhanced ability to confirm potential blocks. +* **Automated updates to the OONI Run link.** The person who created the OONI Run link may need to update the link on an ongoing basis to add more websites for testing. Instead of receiving new links each time (when there’s the need to test more websites), you can instead receive updates to your OONI Run link automatically by keeping the “Install updates automatically” option enabled. -**Step 1.** An OONI Run link can only be used with the **OONI Probe mobile app**. Please **[install the OONI Probe mobile app](https://ooni.org/install/mobile)**. It's available for [Android](https://play.google.com/store/apps/details?id=org.openobservatory.ooniprobe), [F-Droid](https://f-droid.org/repository/browse/?fdid=org.openobservatory.ooniprobe) and [iOS](https://itunes.apple.com/us/app/id1199566366). +**Step 3.** To test the websites included in the OONI Run link, tap **Install Link** in the bottom right corner of the screen. This will **install the OONI Run link in your OONI Probe mobile app**, enabling you to change your OONI Run link settings and to uninstall the OONI Run link at any time. -{{OONI Prome mobile app}} +{{}} -**Step 2.** Copy the link generated in the previous section either by: +Once installed, you can find your **OONI Run link as a card in the Dashboard** of your OONI Probe mobile app (listed under the “OONI Run Links” section). -* Clicking the link under "**Share this link with OONI Probe mobile app users**", pressing Control+A to select the whole link, and subsequently pressing Control + C to copy it; or +{{}} -* Right-clicking the **Link button** and selecting "Copy link address". +Now that your OONI Run link has been installed (while being configured to run automatically), you don’t need to do anything else. Your OONI Probe app will automatically test the websites in the OONI Run link on an ongoing basis! -{{Copy link address}} +You can find the test results through the **Test Results** tab of your OONI Probe app. -**Step 3.** As you're probably doing all these steps from your desktop, **share the copied link with your mobile phone** (so that you can subsequently open the link with your [OONI Probe mobile app](https://ooni.org/install/mobile)). Unfortunately, it's not currently possible to use OONI Run links with the OONI Probe Desktop app. +{{}} -You can also **share this link with other [OONI Probe mobile app](https://ooni.org/install/mobile) users**, if you -would like them to test your list of websites as well. +By tapping on each of the tested websites displayed, you will find further information, including links to relevant OONI measurements that are **published on [OONI Explorer](https://explorer.ooni.org/) in real-time**. -**Step 4.** **Tap** on the OONI Run link **from your mobile device**. +{{}} -{{OONI Run link}} +In the above example, we can see that TikTok was found accessible on the tested network. The “Data” button provides access to the raw OONI network measurement data, while the “Show in OONI Explorer” button provides a link to the published measurement. You can share the measurement through the use of the **share button** on the top right corner. -**Step 5.** **Open** the link with your **OONI Probe mobile app** (not -with a web browser). +If at any moment you would like to **change your OONI Run link settings**, or **uninstall the OONI Run link** entirely, you can do so through the OONI Run link card installed in your OONI Probe mobile app. -{{Open with OONI Probe}} +{{}} -You should now see your list of websites in your OONI Probe mobile app. +Through your installed OONI Run link card, you can change the settings by: +* Disabling the “Install updates automatically” option if you do not want to receive updates to OONI Run links (including additional or different websites for censorship testing) automatically; +* Disabling the “Run tests automatically” option if you do not want OONI Probe to test the websites in your OONI Run link on an ongoing basis automatically. -{{List of websites}} +If you would like to remove the OONI Run link card from your OONI Probe app, tap the “Uninstall Link” button. -**Step 6.** Tap **Run** to test your list of websites. Depending on the length of your list and the performance of the network you're connected to, the test runtime may vary. If the test takes too long and you would like to terminate it, you can **stop the ongoing test by tapping the cross button** at the top of the screen. +In the event that you have **disabled automated OONI Run link testing** and would like to **manually test websites** included in your OONI Run link, you can do so by tapping the main “Run” button in the OONI Probe Dashboard, tapping the “Deselect all tests” button (to deselect all other OONI Probe tests), and by **only enabling the OONI Run link test**. -{{Run test}} +{{}} -Once you complete the testing based on an OONI Run link, your OONI Probe test results will automatically get published on [OONI Explorer](https://explorer.ooni.org/) and on the [OONI API](https://api.ooni.io/) in near real-time. You will also have immediate [access to your test results through the OONI Probe mobile app](https://ooni.org/support/ooni-probe-mobile#websites). +### Finding your OONI Run v2 measurements on OONI Explorer -To learn more about accessing and sharing OONI Probe test results, -please refer to our [OONI Probe mobile app user guide](https://ooni.org/support/ooni-probe-mobile). +By default, all OONI Probe measurements from OONI Run v2 links are automatically published on [OONI Explorer](https://explorer.ooni.org/) as open data in real-time. But given that OONI Explorer hosts a wealth of data – more than 2 billion measurements collected from 242 countries and territories since 2012 – finding the specific measurements from your OONI Run link was previously quite challenging. -## Creating OONI Run widget code for website testing +We are excited to share that you can now easily find and aggregate measurements from your specific OONI Run v2 link through OONI Explorer! Specifically, you can **filter measurements** in both the OONI Explorer [Search Tool](https://explorer.ooni.org/search) and [Measurement Aggregation Toolkit (MAT)](https://explorer.ooni.org/chart/mat) based on the ID of your OONI Run v2 link (“**OONI Run Link ID**”). -Instead of sharing OONI Run links, you can **generate OONI Run widget code**, which you can **embed into your website to encourage (long-term) OONI Probe testing of websites** that you care about. +The ID of your OONI Run link are the **last digits** displayed in the link. In the following example, the OONI Run link ID is `10015`. -For example, we have [embedded several OONI Run widgets into our website](https://ooni.org/get-involved/run) to enable -community members to more easily test specific websites (such as social media, news media, and VPN websites). This is often easier than sharing OONI Run links every time. +{{}} -{{OONI Run widgets}} +You can find measurements collected by all those who ran your OONI Run link through the following steps. -Below we share an example of how our partner, [Sinar Project](https://ooni.org/partners/sinar-project/), -embedded OONI Run widgets into their website to [encourage the testing of specific websites](https://sinarproject.org/digital-rights/measuring-and-detecting-network-interference/ge15) during Malaysia's 2022 general election. +**Step 1.** Access the OONI Explorer Search Tool: [https://explorer.ooni.org/search](https://explorer.ooni.org/search) -{{Sinar example}} +{{}} -To create your own OONI Run widget: +**Step 2.** Add the last digits of your OONI Run link in the “OONI Run Link ID” field on the left. Below we have added `10015` based on the previous OONI Run link example. -**Step 1.** When generating an OONI Run link (see section on "Creating OONI Run links"), the pop-up window will **also generate widget code** for the testing of the websites that you added to the OONI Run platform. This widget code is highlighted in the image below. +{{}} -{{Widget code}} +**Step 3.** Click the **Filter Results** button. -**Step 2.** You can embed an OONI Run widget into your website as **a simple button** or as **a tall banner**. +{{}} -**If you would like to add an OONI run button on your website**, you can copy and paste the widget code from the pop-up window. For a simple button use the `}} -``` -/* If you have not already included the OONI widget code */ - -``` +Similarly, you can use the ID of your OONI Run link to aggregate measurements from your specific OONI Run v2 link through the OONI Explorer [Measurement Aggregation Toolkit (MAT)](https://explorer.ooni.org/chart/mat). By adding the ID digits in the “**OONI Run Link ID**” field of the MAT and clicking **Show Chart**, you will generate charts that are limited to the measurements collected through your OONI Run link. -By default, the button will say “Run OONI!” but you can change this text by editing `Run OONI!` in the code. The banner will say “Fight Censorship” but you can change that by editing `Fight Censorship` in the code. +{{}} ## Optional, but encouraged: Adding your websites to test lists -If some of the websites that you used for OONI Run links or widget code are relevant for country-wide or worldwide testing, please **propose them for the lists of websites ("[test lists](https://ooni.org/get-involved/contribute-test-lists)") tested by all OONI Probe users.** You can do so through our [Test Lists Editor](https://test-lists.ooni.org/). +If some of the websites that you used for OONI Run links are relevant for country-wide or worldwide testing, please **propose them for the lists of websites ("[test lists](https://ooni.org/get-involved/contribute-test-lists)") tested by all OONI Probe users.** You can do so through our [Test Lists Editor](https://test-lists.ooni.org/). -{{Test Lists Editor}} +{{Test Lists Editor}} Please refer to [our guide](https://ooni.org/support/test-lists-editor) to learn **how to update test lists using the Test Lists Editor**.