Skip to content

Commit 8ee4cfa

Browse files
Merge pull request #1025 from segmentio/pd-265
[PD-265] Updated Personas docs given new audience CSV formats
2 parents 535b045 + d591ee0 commit 8ee4cfa

File tree

4 files changed

+6
-7
lines changed

4 files changed

+6
-7
lines changed

src/personas/audiences.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -117,9 +117,9 @@ You can download a copy of your audience by visiting the the audience overview p
117117
![](images/audience_overview.png)
118118
Audience CSVs are generated on demand. Before you can download the CSV, you will need to generate it. There are three different options for formatting:
119119

120-
- **Unformatted:** Contains two columns. The first contains the user or account key and the second is a JSON object containing the external IDs. Generating this CSV is by far the fastest of the three options. [Download example unformatted CSV](files/audience_csv_format_a.csv)
121-
- **Distinct columns for unique external IDs (with indexed columns for ID types with multiple values):** Contains the same first two columns as the unformatted CSV. Additional columns are added for each distinct external ID type. When a given external ID type has more than one value, for example a user with three email addresses, _additional columns with indexed headers are added_, (`email`, `email_1`, `email_2`). [Download example formatted CSV with indexed columns](files/audience_csv_format_b.csv)
122-
- **Distinct columns for unique external IDs (with additional rows for ID types with multiple values):** Contains the same first two columns as the unformatted CSV. Additional columns are added for each distinct external ID type. When a given external ID type has more than one value, for example a user with two email addresses, _additional rows are added with the first two columns repeated (user or account key and external IDs JSON)._ [Download example formatted CSV with additional rows](files/audience_csv_format_c.csv)
120+
- **Unformatted:** Contains two columns. The first contains the user or account key and the second is a JSON object containing the external IDs. Generating this CSV is faster than the formatted option below. [Download example unformatted CSV](files/audience_csv_format_a.csv)
121+
- **Formatted (with indexed columns for ID types with multiple values):** Contains the same first two columns as the unformatted CSV. Additional columns are added for each distinct external ID type. When a given external ID type has more than one value, for example a user with three email addresses, _additional columns with indexed headers are added_, (`email`, `email_1`, `email_2`). [Download example formatted CSV with indexed columns](files/audience_csv_format_b.csv)
122+
- **Single Column (with one external ID type):** Contains only a single column of data with the selected external ID type. When the given external ID type has more than one value, for example a user with two email addresses, _additional rows are added._ Data in this format is hashed by default with the SHA256 hashing algorithm, but may be downloaded raw (unhashed) with appropriate permissions. This format is useful for uploading the audience to destinations like Snapchat or Braze, which may require a single column of hashed emails, for example. [Download example single column hashed CSV](files/audience_csv_format_c.csv)
123123

124124

125125
<table>
Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
key,external_ids,anonymous_id,email
2-
segment_id_1,"{""anonymous_id"":[""anon_1""], ""email"": [“[email protected]”, “[email protected]”]}",anon_1,[email protected]
3-
segment_id_1,"{""anonymous_id"":[""anon_1""], ""email"": [“[email protected]”, “[email protected]”]}",,[email protected]
4-
segment_id_2,"{“anonymous_id"":[""anon_2""], ""email"": [“[email protected]”]}",anon_2,[email protected]
1+
email
2+
A111F4879EC86CA6DE45B23732CB9CC5DA7EB381196377BC4933E4E1F50C7275
3+
523D49004682AB1BFDCAB9718B2595F24102C8D2162F6A450C68A5F95DCC908D
11 KB
Loading
117 KB
Loading

0 commit comments

Comments
 (0)