From 142280615f339e88b6f76305478980f4cfc828c8 Mon Sep 17 00:00:00 2001
From: Nat DeFries <42820733+nmdefries@users.noreply.github.com>
Date: Wed, 8 Sep 2021 17:41:56 -0400
Subject: [PATCH] state territories not included; point to UMD

---
 docs/api/covidcast-signals/fb-survey.md   | 10 ++++++++++
 docs/symptom-survey/contingency-tables.md |  8 ++++++++
 docs/symptom-survey/survey-files.md       | 10 ++++++++++
 3 files changed, 28 insertions(+)

diff --git a/docs/api/covidcast-signals/fb-survey.md b/docs/api/covidcast-signals/fb-survey.md
index c2dfde83c..6215d153c 100644
--- a/docs/api/covidcast-signals/fb-survey.md
+++ b/docs/api/covidcast-signals/fb-survey.md
@@ -643,6 +643,16 @@ declines, some indicators will become unavailable once they no longer meet the
 This affects some signals, such as those based on a subset of responses, more
 than others, with finer geographic resolutions becoming unavailable first.
 
+### Target Region
+
+Facebook only invites users to take the survey if they appear, based on
+attributes in their Facebook profiles, to reside in the 50 states or
+Washington, DC. Puerto Rico is sampled separately as part of the
+[international version of the survey](https://covidmap.umd.edu/). If Facebook
+believes a user qualifies for the survey, but the user then replies that they
+live in Puerto Rico or another US territory, we do not include their response
+in the aggregations.
+
 
 ## Survey Weighting
 
diff --git a/docs/symptom-survey/contingency-tables.md b/docs/symptom-survey/contingency-tables.md
index 6cc56de1f..5adb919f8 100644
--- a/docs/symptom-survey/contingency-tables.md
+++ b/docs/symptom-survey/contingency-tables.md
@@ -73,6 +73,14 @@ CSVs for the month of January 2021 only use data from January 6-31 due to a
 
 At the moment, only nation-wide and state groupings are available.
 
+Facebook only invites users to take the survey if they appear, based on
+attributes in their Facebook profiles, to reside in the 50 states or
+Washington, DC. Puerto Rico is sampled separately as part of the
+[international version of the survey](https://covidmap.umd.edu/). If Facebook
+believes a user qualifies for the survey, but the user then replies that they
+live in Puerto Rico or another US territory, we do not include their response
+in the aggregations.
+
 ### Privacy
 
 The aggregates are filtered to only include estimates for a particular group
diff --git a/docs/symptom-survey/survey-files.md b/docs/symptom-survey/survey-files.md
index f2fd26339..d181449a1 100644
--- a/docs/symptom-survey/survey-files.md
+++ b/docs/symptom-survey/survey-files.md
@@ -104,10 +104,20 @@ Responses qualify for inclusion in these files if they meet the following condit
   open-ended question (A2, A2b, B2b, Q40, C10_1_1, C10_2_1, C10_3_1, C10_4_1,
   D3, D4, D5) means to provide any number (floats okay) and to “answer” a radio
   button question is to provide a selection
+* starting September 2021, indicated that they live in the 50 states or
+  Washington, DC
 
 We do not require the user to have completed the survey, or to have seen all
 pages of the survey.
 
+Facebook only invites users to take the survey if they appear, based on
+attributes in their Facebook profiles, to reside in the 50 states or
+Washington, DC. Puerto Rico is sampled separately as part of the
+[international version of the survey](https://covidmap.umd.edu/). Starting in
+September 2021, if Facebook believes a user qualifies for the survey, but the
+user then replies that they live in Puerto Rico or another US territory, we do
+not include their response in the individual response data.
+
 ## Collisions
 
 One thing we haven't been able to fully fix is the problem of people forwarding