I've added T203042: Output 2.2: Characterizing readership by demographics as a parent task as this task was split out of T213696: Sample by title in QuickSurvey (see T213696#4881990) and has it as its parent.

I've pulled in T213696 to T139317. Because of the context switch any of these tasks involve it's probably good to think about the 3 of them (and possibly do them) together.

https://gerrit.wikimedia.org/r/#/c/mediawiki/extensions/QuickSurveys/+/493130 defines a generic approach for defining an audience.

Re: T213847#4986729:

1. Nice find, @Jdlrobson!
2. Should we discard surveys that required CentralNotice to be loaded if it isn't?

In T213847#4987746, @phuedx wrote:

Re: T213847#4986729:

1. Nice find, @Jdlrobson!
2. Should we discard surveys that required CentralNotice to be loaded if it isn't?

We already use window.Geo
The Geo object is derived from a Cookie response header in the

• CentralNotice ext.centralNotice.geoIP module (loaded on all
• page views when installed). If the cookie was refused, this
• falls back to the string "Unknown".

So looks like we can use it in the code provided we account for when it's not available.

@ovasileva Stephen had a good question about this. Is it anticipated that surveys will be targetted to one country or multiple countries? Who is the customer for this task. Is it @leila? We need to ask a few more questions along this line.

@Jdlrobson feel free to ping @Isaac or myself here or in IRC.

Jumping in, I think multiple countries would be a good thing to plan for. For instance, if we want to survey users from a number of Latin American countries, we'd probably want to send the same survey to everyone but not write separate config files for each Spanish-speaking country. And Spain represents ~20% of the page views on eswiki [1] so not sampling by country would lead to a bunch of extra surveys going out.

And same thought process can be applied to regions in Africa that predominantly read English Wikipedia or French Wikipedia etc. where we may want to target 10+ countries at a time in a given language edition with the same survey.

[1] https://stats.wikimedia.org/wikimedia/animations/wivivi/wivivi.html

Change 494544 had a related patch set uploaded (by Jdlrobson; owner: Jdlrobson):
[mediawiki/extensions/QuickSurveys@master] Surveys can be targetted at specific countries

https://gerrit.wikimedia.org/r/494544

Change 494544 merged by jenkins-bot:
[mediawiki/extensions/QuickSurveys@master] Surveys can be targeted at specific countries

https://gerrit.wikimedia.org/r/494544

Pending QA of T139317

This looks good to me. A few notes:

• Targeting a survey to a particular country requires including that country's two-character code in the configuration. It must be capitalized -- e.g., if you want to include the United States, you must have countries include "US"; none of "us" or "Us" or "USA" would work.
• Not including countries in the configuration means country is not considered when targeting the survey
• Including no countries in the configuration (i.e. "countries" => []) means no country is targeted (and therefore no one sees the survey)
• Including one country in the configuration (e.g. "countries" => ["US"]) means that only users whose IP geocodes them to that country will be included
• Including multiple countries in the configuration (e.g. "countries" => ["US", "CA"]) means that users from all of those countries can be shown the survey

The applicable two-letter country codes can be found in several places:

• They come from: https://dev.maxmind.com/geoip/legacy/codes/iso3166/
• They are processed via CentralNotice -- see https://github.com/wikimedia/mediawiki-extensions-CentralNotice/blob/master/includes/GeoTarget.php
• Practically, checking the codes in webrequest (geocoded_data) or geoeditors (country_code) tables ensures you are using an appropriate code
• You can check what country you are considered to be in by navigating to a Wikipedia article, opening your web console, and looking what value window.Geo has

Just wanted to follow up w/ @Jdlrobson @ovasileva @phuedx @pmiazga @Edtadros (and anyone else I missed) to say thank you thank you for working on this!! Amongst others, we are currently running reader surveys in English and French (T212444) that are scoped to countries from Africa and getting thousands of responses, which is something we never would have been able to do without also getting literally hundreds of thousands of responses from the US, India, France, etc. that would be far more than we need.