diff --git a/.gitignore b/.gitignore
index bf29039..38f3dc0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,6 +4,3 @@
/node_modules/
.idea/
/coverage/
-
-# ignore alternative build configs
-*-build-config.js
diff --git a/README.md b/README.md
index dc5429b..66075c7 100644
--- a/README.md
+++ b/README.md
@@ -27,13 +27,13 @@ Once installed **you must accept the standard terms and conditions of use**. The
### Installation
-There is currently an issue with one or more of the dependencies which means that to install you **must** use
+There is currently an issue with one or more of the dependencies which means that to install you **must** run `npm install` and then
```sh
npm ci
```
-instead of `npm install`.
+instead of just `npm install`.
## Continuous build environment (single machine)
@@ -49,6 +49,17 @@ Build the extension continuously as you edit files:
npm run watch
```
+### Actual real-life development:
+
+in two separate terminals, run these commands.
+
+```sh
+npm run chrome -- -- --env.file=./nyu-build-config.js --env.build=debug --env.config=std
+npm run watch -- --env.file=./nyu-build-config.js --env.browser=chrome --env.build=debug --env.config=std
+```
+
+This starts a fresh Chrome install and also continuously monitors the code and recompiles it.
+
### Build output
Both of the above scripts will generate eight output folders named in the format `{browser}-{config}-{build}`.
@@ -92,6 +103,22 @@ So if, for example, you create your own build config called `alt-build-config.js
Any API URL you set in that file will be used as the default url, unless you specify an `--env.api` option. The `--env.api` option will override whatever you set in your copy of `build-config.js`.
+## NYU Release Ritual
+
+1. up the version in the build config file (`nyu-build-config.js` or `legacy-build-config.js`). Legacy is `v2.x.y`, Full is `v3.x.y`.
+2. tag a version, push tag, `git tag v3.0.2` (or whatever).
+3. build both legacy and standard
+ - legacy:
+ 1. `npm run build -- --env.file=./legacy-build-config.js --env.build=release --env.config=std`
+ 2. `pushd build/chrome-std-release && zip -r0 ../chrome-$(jq .version manifest.json | tr -d \").zip ./* && popd`
+ 3. `pushd build/firefox-std-release && zip -r0 ../firefox-$(jq .version manifest.json | tr -d \").zip ./* && popd`
+ - standard:
+ 1. `npm run build -- --env.file=./nyu-build-config.js --env.build=release --env.config=std`
+ 2. `pushd build/chrome-std-release && zip -r0 ../chrome-$(jq .version manifest.json | tr -d \").zip ./* && popd`
+ 3. `pushd build/firefox-std-release && zip -r0 ../firefox-$(jq .version manifest.json | tr -d \").zip ./* && popd`
+4. download source zip for Firefox
+5. upload source zip to Firefox with msg "There are instructions for how to build the extension in the README in the extension/ folder in the archive -- you'll want to run `npm install`, then `npm ci` and then use `$ npm run build -- --env.file=./nyu-build-config.js --env.build=release --env.config=std --env.browser=firefox` to generate the same minified, production code as in the uploaded version of the extension. Be sure to check the output for sporadic network errors; I've verified that these instructions work in a clean build environment."
+
## Unit tests
Unit tests do not require a running backend server.
diff --git a/TESTING.md b/TESTING.md
new file mode 100644
index 0000000..c8e25a6
--- /dev/null
+++ b/TESTING.md
@@ -0,0 +1,25 @@
+in Legacy version:
+
+1. Share Sponsored Posts ON Share Ad Targeting Information ON
+
+ ensure that ads and targeting is sent ensure that public posts are NOT sent
+
+ CHECK
+
+2. Share Sponsored Posts ON Share Ad Targeting Information OFF
+
+ ensure that targeting is not sent, but ads are
+
+ CHECK
+
+3. Share Sponsored Posts OFF Share Ad Targeting Information ON
+
+ ensure that nothing is sent.
+
+ CHECK
+
+in both versions:
+
+Share My Language
+
+CHECK
diff --git a/build-config.js b/build-config.js
index 6b83204..68b536e 100644
--- a/build-config.js
+++ b/build-config.js
@@ -1,66 +1,68 @@
-const { name, version, description, consentVersion } = require('./package.json');
+const {
+ name,
+ version,
+ description,
+ consentVersion
+} = require('./package.json');
-const title = 'ATI Social Media Monitor Extension';
+const title = 'Ad Observer';
-/**
- * NOTE: If you wish to override the settings in this file, make a copy of it and use that copy
- * when building the extension.
- *
- * So if, for example, you create your own build config called `alt-build-config.js` in the
- * root folder of this project, then you'd use it by adding the param `--env.file=./alt-build-conf`.
- *
- * See README.md for more.
- */
+// override any of these.
module.exports = (isDebug = false) => ({
- name, // the extension name (uses what's in package.json as a default)
+ name: 'Ad Observer', // the extension name (uses what's in package.json as a default)
title,
description,
version,
consentVersion, // if you change this, strange things might happen.
- extensionProviderId: 'ati',
- geckoId: 'info@ati.io',
- homepage: 'https://github.com/AlgorithmicTransparencyInstitute/social-media-collector',
+ extensionProviderId: 'nyu',
+ geckoId: 'developers@adobserver.org',
+ includeYoutube: true,
+ homepage:
+ 'https://adobserver.org',
assetsPath: 'assets',
defaultIcon: 'icon128.png',
consentText: `
-
- By installing this extension and sharing what you see online, you are
- helping to support crucial investigative journalism and academic
- research into how social media impacts our shared civic discourse.
-
-
This tool will collect and share:
-
-
The public content you see on Facebook and YouTube
-
The ads you are shown on these platforms
-
The reasons why you were targeted with these ads
-
Any recommendations associated with the content you view
-
Diagnostic data about the behavior of the extension
-
- A unique identifier to link all the items shared from your browser
-
-
-
This tool will NOT collect:
-
- Personal information about you that is not directly linked to the ads or
- content you see
-
-
You are in control. At any time, you can:
-
-
view everything shared with our project
-
disable or remove this extension
-
change which types of information are shared with the project
-
- request that all information shared by you is permanently deleted from
- our systems
-
-
`,
- helpText: `
-
- help text to go here
-
`,
+
+
These Terms of Use form a legal agreement between you, the end user (“user” or “you”) and New York University (“NYU”, “us” or “we”), for the limited license to use the Ad Observer application, which includes a web browser extension, computer software and electronic documentation (“the Application” or “Ad Observer”).
+
Ownership and distribution
+
The Application is owned and copyrighted by NYU. NYU grants you a limited, worldwide, non-exclusive, royalty-free, revocable, and non-commercial license to download and use Ad Observer. Your license to download and use the Application confers no title or ownership in the Application and should not be construed as a sale of any right in the Application.
+
Ad Observer may be freely distributed subject, but not limited to the following terms:
+
Unless you have the express written consent of NYU, you may not distribute the Application or any portion thereof to any third parties;
If the user would like to distribute the Application they will need to contact NYU at developers@adobserver.org for written consent prior to distribution;
The user may not sell or re-sell the Application;
The user must not distribute the Application as part of any commercial package;
The user must not use or distribute the Application in support of a commercial service;
The user must not use or distribute the Application to support any kind of profit generating activity, even if it is being distributed freely.
+
+
+
+
User conduct
+
The user is strictly prohibited from, and agrees not to adapt, edit, change, modify, transform, publish, republish, distribute, or redistribute the Application or any elements, portions, or parts thereof without NYU’s prior written consent. You agree not to use any automated data collection methods, data mining, robots, scraping or any data gathering methods of any kind on the Application.
+
Copyright
+
The Application and all rights, without limitation including proprietary rights therein, are owned by NYU and protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. The Application is licensed, not sold. You acknowledge that no title to the intellectual property in the Application is transferred to you. You further acknowledge that title and full ownership rights to the Application will remain the exclusive property of NYU and you will not acquire any rights to the Application except as expressly set forth in this license. You agree that any copies of the Application will contain the same proprietary notices which appear on and in the Application. NYU may bring legal proceedings against individuals who contravene these Terms of Use, including to enforce its copyrights to Ad Observer.
+
Warranties
+
Ad Observer is provided to the user “AS IS” with no warranties for use or performance and NYU disclaims any warranty or liability obligations to the user of any kind, whether expressed or implied. Where legislation implies in this agreement any condition or warranty, and that legislation avoids or prohibits provisions in an agreement excluding or modifying application of or exercise of liability under such condition or warranty, the condition or warranty will be deemed to be included in this agreement.
+
Limitation of Liability
+
NYU is not subject to, and the user releases NYU from any additional liability and indemnifies them against any claim, action, suit or proceeding (including but not limited to direct, indirect, consequential loss or damage, removal costs or re-installation costs or liability for loss of use or profit) because of the use of or inability to use the Application or the provision of or failure to provide support services, any delay in delivery or fault or defect in the Application even if NYU has been advised of the possibility of such damages. NYU‘s entire liability under this agreement shall be limited to the amount paid by the user for the Application. The user further indemnifies NYU against any claim, action suit or proceedings brought by any web site provider or any copyright holder in respect of the operation of the Application by the user. The user expressly acknowledges and agrees that it has not relied upon, and NYU is not liable for any advice given by NYU, its servants, agents, representatives or employees in relation to the suitability for any purpose of the Application.
+
+
+
+
Third Party Copyright Infringement
+
NYU does not condone the violation of copyright and other laws. NYU requires all users to Use the Application in strict compliance with copyright and other laws. NYU does not, by the supply of the Application, authorize or encourage you to infringe the copyright or other rights of third parties.
+
Indemnification
+
In connection with your user of Ad Observer and to the extent permitted by applicable law, you agree to defend, indemnify, and hold harmless NYU and its directors, officers, employees, and consultants, from and against any claim or demand (including reasonable attorney fees) arising from and of (a) your use of the Application; (b) any violation of these Terms of Use by you; (c ) any allegation that your use of the Application infringes or violates the copyright, trademark, trade secret or other intellectual property or rights of any third party.
+
Your Information
+
By installing the Application you acknowledge that you have reviewed and agree to the Ad Observer Privacy Policy that describes and governs the Application’s information gathering practices. A copy of Ad Observer’s Privacy Policy is available
+ here. Ad Observer reserves the right to change the provisions of its Privacy Policy from time to time and if it does so, Ad Observer will post any changes to its Privacy Policy at the web address provided.
+
General Provisions
+
This is the entire agreement between you and NYU governing your use of Ad Observer, which supersedes any prior agreement or understanding, whether written, or oral, relating to the subject matter of these Terms of Use. If any part of these Terms of Use is found void and unenforceable, it will not affect the validity of the balance of the agreement, which shall remain valid and enforceable according to its terms. These Terms of Use shall automatically terminate upon failure by you to comply with its terms. NYU in its sole discretion, may modify these Terms of Use in writing at any time.
+
Termination
+
You may terminate these Terms of Use at any time by uninstalling Ad Observer. Your right to use Ad Observer may also be terminated by NYU at any time, without cause and without notice. This agreement will automatically terminate if you fail to comply with any of its terms. Upon termination, you agree to stop using and to uninstall Ad Observer.
+
Changes in these Terms of Use
+
NYU reserves the right to update these Terms of Use from time to time. Since your use of the Application is anonymous, we cannot inform you about this personally. The most current version of the Terms of Use can be reviewed
+ here.
`,
aboutText: `
- The ${title} is an initiative to empower citizens to
+ ${title} is an initiative to empower citizens to
voluntarily share data about what they see online to enable academic
research and investigative journalism about how digital platforms impact
society.
@@ -88,81 +90,121 @@ module.exports = (isDebug = false) => ({
This project is a collaboration between: The Algorithmic Transparency
- Institute, NYU, Quartz, and…
+ Institute, NYU, Quartz, and the University of Grenoble
- Your privacy is important to us. full privacy policy yet to be supplied
-
`,
- preferencesPageFooter: `
-
- If you wish to have all of your data deleted from the data archive,
- please send an email to
- deleteme@ati.io
- and we‘ll walk you through the process.
-
`,
- apiUrl: '',
+
This Privacy Policy (“the Policy”) explains how and why New York University (“NYU”) processes personal data when people install Ad Observer (“the Application”).
+
The Policy does not cover any other personal data processing by NYU, which is covered by other applicable policies and procedures, including
+ NYU’s Digital Privacy Statement.
+
If you have a question regarding the Policy or the use of the Application, please contact
+ developers@adobserver.org.
+
+
+
+
Data controller
+
NYU is the controller of the data covered by the Policy. You can contact NYU’s Data Protection Officer with any questions about this notice, our data collection practices, or your rights. You can reach NYU’s Data Protection Officer, Peter Christensen, at:
+
+
+
+
Peter Christensen
+
c/o Data Protection Officer’s Office
+
70 Washington Square South
+
Room 1201
+
New York, NY 10012
+
+1 212 992 7256
+
+
+
+
Guiding principles
+
NYU is committed to respecting individuals’ right to privacy, protecting personal data and compliance with applicable laws globally. In accordance with these guiding principles, the Application has been designed to process the minimum amount of personal data possible to achieve NYU’s objectives.
+
+
+
+
Purposes and means of data processing
+
The purpose of the Application is to collect information about the political ads directed at and seen by private individuals on Facebook & YouTube. This is done with the objective of facilitating public understanding of how political advertising is deployed. NYU believes that it is in the public interest to understand this phenomenon and its impact on democracy.
+
+ To this end, NYU collects basic demographic information about the individuals who install the Application as well as information about the ads that they see. This information has been kept to an absolute minimum, so that it is not possible for NYU to identify individual users of the Application.
+
NYU also maintains a public, online repository of aggregate data (“the Database”) collected by the Application in order to render its research findings transparent and facilitate research by others. This information is anonymized so that it is not possible to identify individual users of the Application from within the Database. The Database can be accessed
+ here.
+
+
+
+
Data processed by the Application
+
When an individual user installs the Application, they are invited to provide basic demographic information about themselves: their age group, gender and ethnicity. This basic demographic profile (“the Profile”) helps NYU understand which people see which ads. It is not mandatory to provide this information and the Application can still collect data that contributes to the research project without creating a Profile.
+
No other personally identifiable information is requested or processed by NYU. The browser language, which is recorded by the Application for the purposes of correctly parsing the ads, is also included in the Profile. The Application does not undertake any “profiling” or “automated decision-making” as defined by the GDPR.
+
If the user has elected to share their Profile, an instance identification number (“ID”) is created and stored locally by the Application. When an ad is seen by the Application, details of the ad together with the ID and the Profile data is transmitted to NYU. This data is then added to the Database, with the exception of the ID, which is not added to the Database.
+
If the user has decided not to create or share a Profile, only the data related to the ads is transmitted to and included in the Database. All users can view the data related to the ads that has been processed by the Application at any time by clicking on the Ad Observer icon and navigating to ‘My Archive’.
+
+
+
+
Legal basis for processing
+
NYU processes data for the above purposes on the basis of consent. By installing the Application, users consent to the processing of their data for the purposes described above. Individuals may withdraw their consent at any time by uninstalling the Application.
+
+ As noted above, data retained in the Database is anonymized, meaning that a user’s withdrawal of consent will not mean the deletion of the data related to the ads that the Application has collected.
+
+
+
+
“Sensitive data”
+
+ As noted above, individuals may elect to provide information about their ethnicity when they install the Application. This data, which may fall within the definition of “special category data” under the GDPR, is processed with consent. As noted above, this data is not stored by NYU in a format that allows identification of the individual concerned. No other sensitive data is requested or processed by NYU.
+
+
+
+
Information security
+
NYU takes reasonable steps to protect personal data against loss, misuse, and unauthorized access, alteration, disclosure or destruction. This includes the use of technical, organizational and legal measures to ensure the confidentiality, integrity and availability of personal data.
+
Information transmitted across the internet remains vulnerable to unauthorised access. The transmission of such data is therefore at the individual’s own risk. See further
+ here.
+
+
+
+
Data retention
+
No personal data is retained by NYU. The only data that is retained has been fully and irreversibly anonymised.
+
+
+
+
Data Subjects Rights
+
Individuals whose personal data is processed in accordance with the GDPR have the following rights:
+
The right to be informed as to whether NYU holds data about them
The right of access to that information
The right to have inaccurate data corrected
The right to have their data deleted
The right to opt-out of particular data processing operations
The right to receive their data in a form that makes it “portable”
The right to object to data processing
The right to receive an explanation about any automated decision making and/or profiling, and to challenge those decisions where appropriate
+
+
+
+
Individuals wishing to exercise their rights in respect of the Application can do so by contacting NYU’s Data Protection Officer’s Office using the contact details provided above.
+
+
+
+
Data subjects covered by EU law may also be entitled to lodge complaints in regard to data processing or the handling of subject access requests with data protection supervisory authority in their country of residence. Relevant supervisory authority names and contact details are listed
+ here.
+
+
+
+
Changes and revisions
+
Should NYU make changes to this Policy, the date and nature of the change will be indicated below.
`,
+ apiUrl: 'https://observations.nyuapi.org',
permissions: {
SHOW_DEBUG_DATA: {
label: 'Show Debug Data',
hintText: 'Debugging information will be displayed',
defaultValue: isDebug
},
- USER_SHARE_INSTALLATION_ID: {
- label: 'Share Installation ID',
- hintText:
- 'An anonymous user ID that allows us to link all of your content ads and targeting data together',
- defaultValue: true
- },
- USER_SHARE_COUNTRY: {
- label: 'Share My Country',
- hintText: 'The country you told us you are in',
- defaultValue: true
- },
USER_SHARE_LANGUAGE: {
label: 'Share My Language',
hintText: 'The language you told us you speak',
- defaultValue: true
- },
- USER_SHARE_GENDER: {
- label: 'Share My Gender',
- hintText: 'The gender you told us you are',
- defaultValue: true
- },
- USER_SHARE_AGE: {
- label: 'Share My Age',
- hintText: 'The age group you told us you are in',
- defaultValue: true
- },
- USER_SHARE_IP: {
- label: 'Share My IP Address',
- hintText: 'The Internet Protocol address for your computer',
- defaultValue: true
+ defaultValue: true
},
USER_SHARE_DIAGNOSTICS: {
label: 'Share Diagnostic Data',
- hintText: 'If things go wrong we’ll send extra data to help us diagnose the problem',
- defaultValue: true
- },
- // FB_SHARE_PUBLIC_USER_POSTS: {
- // label: 'Share Public User Posts',
- // hintText:
- // 'This allows the extension to collect any public posts posted by actual people that appear in your newsfeed. Posts by shared by your friends and family that are not marked as public will not be shared',
- // defaultValue: false
- // },
- FB_SHARE_PUBLIC_PAGE_POSTS: {
- label: 'Share Public Page Posts',
hintText:
- 'This allows the extension to collect any public posts by brands or pages that appear in your newsfeed. Posts by shared by your friends and family that are not marked as public will not be shared',
+ 'If things go wrong we’ll send extra data to help us diagnose the problem',
defaultValue: true
},
FB_SHARE_SPONSORED_POSTS: {
label: 'Share Sponsored Posts',
- hintText: 'This allows the extension to collect all of the ads shown to you on Facebook',
+ hintText:
+ 'This allows the extension to collect all of the ads shown to you on Facebook',
defaultValue: true
},
FB_SHARE_AD_TARGETING: {
@@ -174,29 +216,7 @@ module.exports = (isDebug = false) => ({
FB_SHOW_COLLECTION_STATUS: {
label: 'Show Collection Status',
hintText: 'If on this will tag your facebook post with collection info.',
- defaultValue: true // change this to `isDebug` if you want this only be on for debug users
+ defaultValue: isDebug // change this to `isDebug` if you want this only be on for debug users
},
- YT_SHARE_WATCHED_VIDEOS: {
- label: 'Share Watched Videos',
- hintText: 'This will share each video you choose to watch on YouTube',
- defaultValue: true
- },
- YT_SHARE_RECOMMENDED_VIDEOS: {
- label: 'Share Recommendations',
- hintText:
- 'This will share the other videos YouTube recommends to you while you are watching a video',
- defaultValue: true
- },
- YT_SHARE_ADS: {
- label: 'Share Advertisments',
- hintText: 'This will share all of the different types of ads you are shown on YouTube',
- defaultValue: true
- },
- YT_SHARE_AD_TARGETING: {
- label: 'Share Ad Targeting Information',
- hintText:
- 'This will share the explanations provided by YouTube for why you were shown a particular ad',
- defaultValue: true
- }
}
});
diff --git a/legacy-build-config.js b/legacy-build-config.js
new file mode 100644
index 0000000..18af7ff
--- /dev/null
+++ b/legacy-build-config.js
@@ -0,0 +1,250 @@
+const { name, version, description, consentVersion } = require('./package.json');
+
+const title = 'Ad Observer';
+
+// override any of these.
+module.exports = (isDebug = false) => ({
+ name: 'Ad Observer', // the extension name (uses what's in package.json as a default)
+ title,
+ description,
+ version: '2.0.5', // FBPAC maxed out at 1.11.0 and this is a major update, so, 2.0
+ consentVersion, // if you change this, strange things might happen.
+ extensionProviderId: 'nyu',
+ includeYoutube: false,
+ homepage: 'https://adobserver.org',
+ assetsPath: 'assets',
+ defaultIcon: 'icon128.png',
+ consentText: `
+
+
Thank you for installing Ad Observer and helping us monitor online political ads.
+
These Terms of Use form a legal agreement between you, the end user (“user” or “you”) and New York University (“NYU”, “us” or “we”), for the limited license to use the Ad Observer application, which includes a web browser extension, computer software and electronic documentation (“the Application” or “Ad Observer”).
+
Ownership and distribution
+
The Application is owned and copyrighted by NYU. NYU grants you a limited, worldwide, non-exclusive, royalty-free, revocable, and non-commercial license to download and use Ad Observer. Your license to download and use the Application confers no title or ownership in the Application and should not be construed as a sale of any right in the Application.
+
Ad Observer may be freely distributed subject, but not limited to the following terms:
+
Unless you have the express written consent of NYU, you may not distribute the Application or any portion thereof to any third parties;
If the user would like to distribute the Application they will need to contact NYU at developers@adobserver.org for written consent prior to distribution;
The user may not sell or re-sell the Application;
The user must not distribute the Application as part of any commercial package;
The user must not use or distribute the Application in support of a commercial service;
The user must not use or distribute the Application to support any kind of profit generating activity, even if it is being distributed freely.
+
User conduct
+
The user is strictly prohibited from, and agrees not to adapt, edit, change, modify, transform, publish, republish, distribute, or redistribute the Application or any elements, portions, or parts thereof without NYU’s prior written consent. You agree not to use any automated data collection methods, data mining, robots, scraping or any data gathering methods of any kind on the Application.
+
Copyright
+
The Application and all rights, without limitation including proprietary rights therein, are owned by NYU and protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. The Application is licensed, not sold. You acknowledge that no title to the intellectual property in the Application is transferred to you. You further acknowledge that title and full ownership rights to the Application will remain the exclusive property of NYU and you will not acquire any rights to the Application except as expressly set forth in this license. You agree that any copies of the Application will contain the same proprietary notices which appear on and in the Application. NYU may bring legal proceedings against individuals who contravene these Terms of Use, including to enforce its copyrights to Ad Observer.
+
Warranties
+
Ad Observer is provided to the user “AS IS” with no warranties for use or performance and NYU disclaims any warranty or liability obligations to the user of any kind, whether expressed or implied. Where legislation implies in this agreement any condition or warranty, and that legislation avoids or prohibits provisions in an agreement excluding or modifying application of or exercise of liability under such condition or warranty, the condition or warranty will be deemed to be included in this agreement.
+
Limitation of Liability
+
NYU is not subject to, and the user releases NYU from any additional liability and indemnifies them against any claim, action, suit or proceeding (including but not limited to direct, indirect, consequential loss or damage, removal costs or re-installation costs or liability for loss of use or profit) because of the use of or inability to use the Application or the provision of or failure to provide support services, any delay in delivery or fault or defect in the Application even if NYU has been advised of the possibility of such damages. NYU‘s entire liability under this agreement shall be limited to the amount paid by the user for the Application. The user further indemnifies NYU against any claim, action suit or proceedings brought by any web site provider or any copyright holder in respect of the operation of the Application by the user. The user expressly acknowledges and agrees that it has not relied upon, and NYU is not liable for any advice given by NYU, its servants, agents, representatives or employees in relation to the suitability for any purpose of the Application.
+
Third Party Copyright Infringement
+
NYU does not condone the violation of copyright and other laws. NYU requires all users to Use the Application in strict compliance with copyright and other laws. NYU does not, by the supply of the Application, authorize or encourage you to infringe the copyright or other rights of third parties.
+
Indemnification
+
In connection with your user of Ad Observer and to the extent permitted by applicable law, you agree to defend, indemnify, and hold harmless NYU and its directors, officers, employees, and consultants, from and against any claim or demand (including reasonable attorney fees) arising from and of (a) your use of the Application; (b) any violation of these Terms of Use by you; (c ) any allegation that your use of the Application infringes or violates the copyright, trademark, trade secret or other intellectual property or rights of any third party.
+
Your Information
+
By installing the Application you acknowledge that you have reviewed and agree to the Ad Observer Privacy Policy that describes and governs the Application’s information gathering practices. A copy of Ad Observer’s Privacy Policy is available
+ here. Ad Observer reserves the right to change the provisions of its Privacy Policy from time to time and if it does so, Ad Observer will post any changes to its Privacy Policy at the web address provided.
+
General Provisions
+
This is the entire agreement between you and NYU governing your use of Ad Observer, which supersedes any prior agreement or understanding, whether written, or oral, relating to the subject matter of these Terms of Use. If any part of these Terms of Use is found void and unenforceable, it will not affect the validity of the balance of the agreement, which shall remain valid and enforceable according to its terms. These Terms of Use shall automatically terminate upon failure by you to comply with its terms. NYU in its sole discretion, may modify these Terms of Use in writing at any time.
+
Termination
+
You may terminate these Terms of Use at any time by uninstalling Ad Observer. Your right to use Ad Observer may also be terminated by NYU at any time, without cause and without notice. This agreement will automatically terminate if you fail to comply with any of its terms. Upon termination, you agree to stop using and to uninstall Ad Observer.
+
Changes in these Terms of Use
+
NYU reserves the right to update these Terms of Use from time to time. Since your use of the Application is anonymous, we cannot inform you about this personally. The most current version of the Terms of Use can be reviewed
+ here.
`,
+ aboutText: `
+
+ Thank you very much for participating in the Facebook Political Ad Collector
+ project!
+
+
+ ${title} is the successor to the Facebook Political Ad Collector. We've
+ upgraded the look of the extension, changed the name and moved to New York
+ University, but the details are the same: this extension still lets you
+ automatically share the ads you see on Facebook for research and journalism.
+
+
+ Now, you can also contribute the ads you see on YouTube. To do that, please
+ visit AdObserver.org and install the extension again, then be sure to enable
+ "Share Advertisements" in the YouTube section of the "Preferences" page. (If
+ you do nothing, you will still be sharing only Facebook ads --
+ the same data as when you installed the Facebook Political Ad Collector.)
+
+
+ ${title} is an initiative to empower citizens to
+ voluntarily share data about what they see online to enable academic
+ research and investigative journalism about how digital platforms impact
+ society.
+
+
+ The central tool for this project is a browser extension that collects
+ content, advertisements, recommendations, and ad targeting information as
+ users browse the web. This data is anonymized and transmitted to a central
+ database where it can be analyzed. Aggregated data about what users see as
+ well as the actual content and advertisements are accessible to
+ researchers, journalists, and the public. This data can be used for
+ non-commercial purposes to investigate how content spreads online, how
+ users are targeted with advertisements, and what kinds of messages are
+ used to persuade the public.
+
+
+ This project is inspired by numerous efforts that have come before it,
+ including the ProPublica Facebook Political Ad Collector (and the TGAM FB
+ Political Ad Collector), Who Targets Me, Ad Analyst.
+
+
+ The goal of this initiative is to make it easier to collect and share data
+ across a range of digital platforms to bring greater transparency to the
+ algorithms that impact our lives.
+
+
+ This project is a collaboration between: The Algorithmic Transparency
+ Institute, NYU, Quartz, and the University of Grenoble
+
+
+ For more information about the project, please visit:
+ adobserver.org.
+
`,
+ privacyText: `
+
This Privacy Policy (“the Policy”) explains how and why New York University (“NYU”) processes personal data when people install Ad Observer (“the Application”).
+
The Policy does not cover any other personal data processing by NYU, which is covered by other applicable policies and procedures, including
+ NYU’s Digital Privacy Statement.
+
If you have a question regarding the Policy or the use of the Application, please contact
+ developers@adobserver.org.
+
+
+
+
Data controller
+
NYU is the controller of the data covered by the Policy. You can contact NYU’s Data Protection Officer with any questions about this notice, our data collection practices, or your rights. You can reach NYU’s Data Protection Officer, Peter Christensen, at:
+
+
+
+
Peter Christensen
+
c/o Data Protection Officer’s Office
+
70 Washington Square South
+
Room 1201
+
New York, NY 10012
+
+1 212 992 7256
+
+
+
+
Guiding principles
+
NYU is committed to respecting individuals’ right to privacy, protecting personal data and compliance with applicable laws globally. In accordance with these guiding principles, the Application has been designed to process the minimum amount of personal data possible to achieve NYU’s objectives.
+
+
+
+
Purposes and means of data processing
+
The purpose of the Application is to collect information about the political ads directed at and seen by private individuals on Facebook & YouTube. This is done with the objective of facilitating public understanding of how political advertising is deployed. NYU believes that it is in the public interest to understand this phenomenon and its impact on democracy.
+
+ To this end, NYU collects basic demographic information about the individuals who install the Application as well as information about the ads that they see. This information has been kept to an absolute minimum, so that it is not possible for NYU to identify individual users of the Application.
+
NYU also maintains a public, online repository of aggregate data (“the Database”) collected by the Application in order to render its research findings transparent and facilitate research by others. This information is anonymized so that it is not possible to identify individual users of the Application from within the Database. The Database can be accessed
+ here.
+
+
+
+
Data processed by the Application
+
When an individual user installs the Application, they are invited to provide basic demographic information about themselves: their age group, gender and ethnicity. This basic demographic profile (“the Profile”) helps NYU understand which people see which ads. It is not mandatory to provide this information and the Application can still collect data that contributes to the research project without creating a Profile.
+
No other personally identifiable information is requested or processed by NYU. The browser language, which is recorded by the Application for the purposes of correctly parsing the ads, is also included in the Profile. The Application does not undertake any “profiling” or “automated decision-making” as defined by the GDPR.
+
If the user has elected to share their Profile, an instance identification number (“ID”) is created and stored locally by the Application. When an ad is seen by the Application, details of the ad together with the ID and the Profile data is transmitted to NYU. This data is then added to the Database, with the exception of the ID, which is not added to the Database.
+
If the user has decided not to create or share a Profile, only the data related to the ads is transmitted to and included in the Database. All users can view the data related to the ads that has been processed by the Application at any time by clicking on the Ad Observer icon and navigating to ‘My Archive’.
+
+
+
+
Legal basis for processing
+
NYU processes data for the above purposes on the basis of consent. By installing the Application, users consent to the processing of their data for the purposes described above. Individuals may withdraw their consent at any time by uninstalling the Application.
+
+ As noted above, data retained in the Database is anonymized, meaning that a user’s withdrawal of consent will not mean the deletion of the data related to the ads that the Application has collected.
+
+
+
+
“Sensitive data”
+
+ As noted above, individuals may elect to provide information about their ethnicity when they install the Application. This data, which may fall within the definition of “special category data” under the GDPR, is processed with consent. As noted above, this data is not stored by NYU in a format that allows identification of the individual concerned. No other sensitive data is requested or processed by NYU.
+
+
+
+
Information security
+
NYU takes reasonable steps to protect personal data against loss, misuse, and unauthorized access, alteration, disclosure or destruction. This includes the use of technical, organizational and legal measures to ensure the confidentiality, integrity and availability of personal data.
+
Information transmitted across the internet remains vulnerable to unauthorised access. The transmission of such data is therefore at the individual’s own risk. See further
+ here.
+
+
+
+
Data retention
+
No personal data is retained by NYU. The only data that is retained has been fully and irreversibly anonymised.
+
+
+
+
Data Subjects Rights
+
Individuals whose personal data is processed in accordance with the GDPR have the following rights:
+
The right to be informed as to whether NYU holds data about them
The right of access to that information
The right to have inaccurate data corrected
The right to have their data deleted
The right to opt-out of particular data processing operations
The right to receive their data in a form that makes it “portable”
The right to object to data processing
The right to receive an explanation about any automated decision making and/or profiling, and to challenge those decisions where appropriate
+
+
+
+
Individuals wishing to exercise their rights in respect of the Application can do so by contacting NYU’s Data Protection Officer’s Office using the contact details provided above.
+
+
+
+
Data subjects covered by EU law may also be entitled to lodge complaints in regard to data processing or the handling of subject access requests with data protection supervisory authority in their country of residence. Relevant supervisory authority names and contact details are listed
+ here.
+
+
+
+
Changes and revisions
+
Should NYU make changes to this Policy, the date and nature of the change will be indicated below.
`,
+ apiUrl: 'https://observations.nyuapi.org',
+ permissions: {
+ SHOW_DEBUG_DATA: {
+ label: 'Show Debug Data',
+ hintText: 'Debugging information will be displayed',
+ defaultValue: isDebug
+ },
+ USER_SHARE_LANGUAGE: {
+ label: 'Share My Language',
+ hintText: 'The language you told us you speak',
+ defaultValue: true
+ },
+ USER_SHARE_COUNTRY: {
+ label: 'Share My Country',
+ hintText: 'The country you told us you are in',
+ defaultValue: true
+ },
+ USER_SHARE_GENDER: {
+ label: 'Share My Gender',
+ hintText: 'The gender you told us you are, if selected on the preferences page',
+ defaultValue: false
+ },
+ USER_SHARE_AGE: {
+ label: 'Share My Age',
+ hintText: 'The age group you told us you are in, if selected on the preferences page',
+ defaultValue: false
+ },
+ USER_SHARE_DIAGNOSTICS: {
+ label: 'Share Diagnostic Data',
+ hintText: 'If things go wrong we’ll send extra data to help us diagnose the problem',
+ defaultValue: true
+ },
+ FB_SHARE_SPONSORED_POSTS: {
+ label: 'Share Facebook Ads',
+ hintText: 'This allows the extension to collect all of the ads shown to you on Facebook',
+ defaultValue: true
+ },
+ FB_SHARE_AD_TARGETING: {
+ label: 'Share Ad Targeting Information',
+ hintText:
+ 'This allows the extension to request and collect the "Why am I seeing this?" information from facebook that explains why a particular ad was targeted to you',
+ defaultValue: true
+ },
+ FB_SHOW_COLLECTION_STATUS: {
+ label: 'Show Collection Status',
+ hintText: 'If on this will tag your facebook post with collection info.',
+ defaultValue: isDebug // change this to `isDebug` if you want this only be on for debug users
+ }
+ }
+});
diff --git a/nyu-build-config.js b/nyu-build-config.js
new file mode 100644
index 0000000..ba2fb6f
--- /dev/null
+++ b/nyu-build-config.js
@@ -0,0 +1,265 @@
+const { name, version, description, consentVersion } = require('./package.json');
+
+const title = 'Ad Observer';
+
+// override any of these.
+module.exports = (isDebug = false) => ({
+ name: 'Ad Observer', // the extension name (uses what's in package.json as a default)
+ title,
+ description,
+ version: '3.0.5', // legacy build is v2.0+, this is better, so it's 3.0
+ consentVersion, // if you change this, strange things might happen.
+ extensionProviderId: 'nyu',
+ geckoId: 'developers@adobserver.org',
+ includeYoutube: true,
+ homepage: 'https://adobserver.org',
+ assetsPath: 'assets',
+ defaultIcon: 'icon128.png',
+
+ helpText: `
+
+
`,
+ preferencesPageFooter: `
+
+
`,
+
+ consentText: `
+
+
Thank you for installing Ad Observer and helping us monitor online political ads.
+
These Terms of Use form a legal agreement between you, the end user (“user” or “you”) and New York University (“NYU”, “us” or “we”), for the limited license to use the Ad Observer application, which includes a web browser extension, computer software and electronic documentation (“the Application” or “Ad Observer”).
+
Ownership and distribution
+
The Application is owned and copyrighted by NYU. NYU grants you a limited, worldwide, non-exclusive, royalty-free, revocable, and non-commercial license to download and use Ad Observer. Your license to download and use the Application confers no title or ownership in the Application and should not be construed as a sale of any right in the Application.
+
Ad Observer may be freely distributed subject, but not limited to the following terms:
+
Unless you have the express written consent of NYU, you may not distribute the Application or any portion thereof to any third parties;
If the user would like to distribute the Application they will need to contact NYU at developers@adobserver.org for written consent prior to distribution;
The user may not sell or re-sell the Application;
The user must not distribute the Application as part of any commercial package;
The user must not use or distribute the Application in support of a commercial service;
The user must not use or distribute the Application to support any kind of profit generating activity, even if it is being distributed freely.
+
User conduct
+
The user is strictly prohibited from, and agrees not to adapt, edit, change, modify, transform, publish, republish, distribute, or redistribute the Application or any elements, portions, or parts thereof without NYU’s prior written consent. You agree not to use any automated data collection methods, data mining, robots, scraping or any data gathering methods of any kind on the Application.
+
Copyright
+
The Application and all rights, without limitation including proprietary rights therein, are owned by NYU and protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. The Application is licensed, not sold. You acknowledge that no title to the intellectual property in the Application is transferred to you. You further acknowledge that title and full ownership rights to the Application will remain the exclusive property of NYU and you will not acquire any rights to the Application except as expressly set forth in this license. You agree that any copies of the Application will contain the same proprietary notices which appear on and in the Application. NYU may bring legal proceedings against individuals who contravene these Terms of Use, including to enforce its copyrights to Ad Observer.
+
Warranties
+
Ad Observer is provided to the user “AS IS” with no warranties for use or performance and NYU disclaims any warranty or liability obligations to the user of any kind, whether expressed or implied. Where legislation implies in this agreement any condition or warranty, and that legislation avoids or prohibits provisions in an agreement excluding or modifying application of or exercise of liability under such condition or warranty, the condition or warranty will be deemed to be included in this agreement.
+
Limitation of Liability
+
NYU is not subject to, and the user releases NYU from any additional liability and indemnifies them against any claim, action, suit or proceeding (including but not limited to direct, indirect, consequential loss or damage, removal costs or re-installation costs or liability for loss of use or profit) because of the use of or inability to use the Application or the provision of or failure to provide support services, any delay in delivery or fault or defect in the Application even if NYU has been advised of the possibility of such damages. NYU‘s entire liability under this agreement shall be limited to the amount paid by the user for the Application. The user further indemnifies NYU against any claim, action suit or proceedings brought by any web site provider or any copyright holder in respect of the operation of the Application by the user. The user expressly acknowledges and agrees that it has not relied upon, and NYU is not liable for any advice given by NYU, its servants, agents, representatives or employees in relation to the suitability for any purpose of the Application.
+
Third Party Copyright Infringement
+
NYU does not condone the violation of copyright and other laws. NYU requires all users to Use the Application in strict compliance with copyright and other laws. NYU does not, by the supply of the Application, authorize or encourage you to infringe the copyright or other rights of third parties.
+
Indemnification
+
In connection with your user of Ad Observer and to the extent permitted by applicable law, you agree to defend, indemnify, and hold harmless NYU and its directors, officers, employees, and consultants, from and against any claim or demand (including reasonable attorney fees) arising from and of (a) your use of the Application; (b) any violation of these Terms of Use by you; (c ) any allegation that your use of the Application infringes or violates the copyright, trademark, trade secret or other intellectual property or rights of any third party.
+
Your Information
+
By installing the Application you acknowledge that you have reviewed and agree to the Ad Observer Privacy Policy that describes and governs the Application’s information gathering practices. A copy of Ad Observer’s Privacy Policy is available
+ here. Ad Observer reserves the right to change the provisions of its Privacy Policy from time to time and if it does so, Ad Observer will post any changes to its Privacy Policy at the web address provided.
+
General Provisions
+
This is the entire agreement between you and NYU governing your use of Ad Observer, which supersedes any prior agreement or understanding, whether written, or oral, relating to the subject matter of these Terms of Use. If any part of these Terms of Use is found void and unenforceable, it will not affect the validity of the balance of the agreement, which shall remain valid and enforceable according to its terms. These Terms of Use shall automatically terminate upon failure by you to comply with its terms. NYU in its sole discretion, may modify these Terms of Use in writing at any time.
+
Termination
+
You may terminate these Terms of Use at any time by uninstalling Ad Observer. Your right to use Ad Observer may also be terminated by NYU at any time, without cause and without notice. This agreement will automatically terminate if you fail to comply with any of its terms. Upon termination, you agree to stop using and to uninstall Ad Observer.
+
Changes in these Terms of Use
+
NYU reserves the right to update these Terms of Use from time to time. Since your use of the Application is anonymous, we cannot inform you about this personally. The most current version of the Terms of Use can be reviewed
+ here.
`,
+ aboutText: `
+
+ ${title} is an initiative to empower citizens to
+ voluntarily share data about what they see online to enable academic
+ research and investigative journalism about how digital platforms impact
+ society.
+
+
+ The central tool for this project is a browser extension that collects
+ content, advertisements, recommendations, and ad targeting information as
+ users browse the web. This data is anonymized and transmitted to a central
+ database where it can be analyzed. Aggregated data about what users see as
+ well as the actual content and advertisements are accessible to
+ researchers, journalists, and the public. This data can be used for
+ non-commercial purposes to investigate how content spreads online, how
+ users are targeted with advertisements, and what kinds of messages are
+ used to persuade the public.
+
+
+ This project is inspired by numerous efforts that have come before it,
+ including the ProPublica Facebook Political Ad Collector (and the TGAM FB
+ Political Ad Collector), Who Targets Me, Ad Analyst.
+
+
+ The goal of this initiative is to make it easier to collect and share data
+ across a range of digital platforms to bring greater transparency to the
+ algorithms that impact our lives.
+
+
+ This project is a collaboration between: The Algorithmic Transparency
+ Institute, NYU, Quartz, and the University of Grenoble
+
+
+ For more information about the project, please visit:
+ adobserver.org.
+
`,
+ privacyText: `
+
This Privacy Policy (“the Policy”) explains how and why New York University (“NYU”) processes personal data when people install Ad Observer (“the Application”).
+
The Policy does not cover any other personal data processing by NYU, which is covered by other applicable policies and procedures, including
+ NYU’s Digital Privacy Statement.
+
If you have a question regarding the Policy or the use of the Application, please contact
+ developers@adobserver.org.
+
+
+
+
Data controller
+
NYU is the controller of the data covered by the Policy. You can contact NYU’s Data Protection Officer with any questions about this notice, our data collection practices, or your rights. You can reach NYU’s Data Protection Officer, Peter Christensen, at:
+
+
+
+
Peter Christensen
+
c/o Data Protection Officer’s Office
+
70 Washington Square South
+
Room 1201
+
New York, NY 10012
+
+1 212 992 7256
+
+
+
+
Guiding principles
+
NYU is committed to respecting individuals’ right to privacy, protecting personal data and compliance with applicable laws globally. In accordance with these guiding principles, the Application has been designed to process the minimum amount of personal data possible to achieve NYU’s objectives.
+
+
+
+
Purposes and means of data processing
+
The purpose of the Application is to collect information about the political ads directed at and seen by private individuals on Facebook & YouTube. This is done with the objective of facilitating public understanding of how political advertising is deployed. NYU believes that it is in the public interest to understand this phenomenon and its impact on democracy.
+
+ To this end, NYU collects basic demographic information about the individuals who install the Application as well as information about the ads that they see. This information has been kept to an absolute minimum, so that it is not possible for NYU to identify individual users of the Application.
+
NYU also maintains a public, online repository of aggregate data (“the Database”) collected by the Application in order to render its research findings transparent and facilitate research by others. This information is anonymized so that it is not possible to identify individual users of the Application from within the Database. The Database can be accessed
+ here.
+
+
+
+
Data processed by the Application
+
When an individual user installs the Application, they are invited to provide basic demographic information about themselves: their age group, gender and ethnicity. This basic demographic profile (“the Profile”) helps NYU understand which people see which ads. It is not mandatory to provide this information and the Application can still collect data that contributes to the research project without creating a Profile.
+
No other personally identifiable information is requested or processed by NYU. The browser language, which is recorded by the Application for the purposes of correctly parsing the ads, is also included in the Profile. The Application does not undertake any “profiling” or “automated decision-making” as defined by the GDPR.
+
If the user has elected to share their Profile, an instance identification number (“ID”) is created and stored locally by the Application. When an ad is seen by the Application, details of the ad together with the ID and the Profile data is transmitted to NYU. This data is then added to the Database, with the exception of the ID, which is not added to the Database.
+
If the user has decided not to create or share a Profile, only the data related to the ads is transmitted to and included in the Database. All users can view the data related to the ads that has been processed by the Application at any time by clicking on the Ad Observer icon and navigating to ‘My Archive’.
+
+
+
+
Legal basis for processing
+
NYU processes data for the above purposes on the basis of consent. By installing the Application, users consent to the processing of their data for the purposes described above. Individuals may withdraw their consent at any time by uninstalling the Application.
+
+ As noted above, data retained in the Database is anonymized, meaning that a user’s withdrawal of consent will not mean the deletion of the data related to the ads that the Application has collected.
+
+
+
+
“Sensitive data”
+
+ As noted above, individuals may elect to provide information about their ethnicity when they install the Application. This data, which may fall within the definition of “special category data” under the GDPR, is processed with consent. As noted above, this data is not stored by NYU in a format that allows identification of the individual concerned. No other sensitive data is requested or processed by NYU.
+
+
+
+
Information security
+
NYU takes reasonable steps to protect personal data against loss, misuse, and unauthorized access, alteration, disclosure or destruction. This includes the use of technical, organizational and legal measures to ensure the confidentiality, integrity and availability of personal data.
+
Information transmitted across the internet remains vulnerable to unauthorised access. The transmission of such data is therefore at the individual’s own risk. See further
+ here.
+
+
+
+
Data retention
+
No personal data is retained by NYU. The only data that is retained has been fully and irreversibly anonymised.
+
+
+
+
Data Subjects Rights
+
Individuals whose personal data is processed in accordance with the GDPR have the following rights:
+
The right to be informed as to whether NYU holds data about them
The right of access to that information
The right to have inaccurate data corrected
The right to have their data deleted
The right to opt-out of particular data processing operations
The right to receive their data in a form that makes it “portable”
The right to object to data processing
The right to receive an explanation about any automated decision making and/or profiling, and to challenge those decisions where appropriate
+
+
+
+
Individuals wishing to exercise their rights in respect of the Application can do so by contacting NYU’s Data Protection Officer’s Office using the contact details provided above.
+
+
+
+
Data subjects covered by EU law may also be entitled to lodge complaints in regard to data processing or the handling of subject access requests with data protection supervisory authority in their country of residence. Relevant supervisory authority names and contact details are listed
+ here.
+
+
+
+
Changes and revisions
+
Should NYU make changes to this Policy, the date and nature of the change will be indicated below.
+ Politicians, dark money groups and scammers use YouTube ads too. But we have even less
+ understanding of what they're saying and how they're target their ads.
+ Google's transparency tools are even worse than Facebook's! We built a version of
+ the Facebook Political Ad Collector that also lets you share YouTube ads.
+
+
+ Would you be willing to help out? You'll have to install a new version of this extension
+ by going to AdObserver.org and following the
+ directions there. It lets you share the the ads and recommendations you see on YouTube, in
+ addition to ads from Facebook too.
+
+
+ Thanks!
+
+
+);
+
const CARDS = {
locale: {
title: 'Your Settings',
@@ -57,6 +77,11 @@ const CARDS = {
title: 'YouTube Preferences',
subtitle: 'These options control what data you share when you are using YouTube',
permissions: YOUTUBE_PERMISSIONS
+ },
+ legacy: {
+ title: 'Help us monitor YouTube ads too',
+ subtitle: ,
+ permissions: []
}
};
@@ -68,6 +93,7 @@ const makeCard = (key, content) => (
// no need for a ConsentAwareView as this page is not visible unless you
// have granted latest consent.
+const ytCard = process.env.INCLUDE_YOUTUBE ? makeCard('youtube') : makeCard('legacy', '');
const PreferencesPage = () => (