You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/engage/audiences/computed-traits.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -207,9 +207,9 @@ You can read the [full Profile API docs](/docs/profiles/profile-api/) to learn m
207
207
You can download a copy of your trait by visiting the the computed trait overview page.
208
208

209
209
Computed Trait CSVs are generated on demand. Before you can download the CSV, you will need to generate it. There are three different options for formatting:
210
-
-**Unformatted:** Contains three columns. The first contains the user or account key, the second contains the trait value and the third 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/trait_csv_format_a.csv)
211
-
-**Distinct columns for unique external IDs (with indexed columns for ID types with multiple values):** Contains the same first three columns as the unformatted CSV. Additional columns are added for each distinct external ID type. When a single row has more than one value for a given external ID type, 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/trait_csv_format_b.csv)
212
-
-**Distinct columns for unique external IDs (with additional rows for ID types with multiple values):** Contains the same first three columns as the unformatted CSV. Additional columns are added for each distinct external ID type. When a single row has more than one value for a given external ID type, for example a user with two email addresses, _additional rows are added with the first three columns repeated (user or account key, trait value and external IDs JSON)._[Download example formatted CSV with additional rows](files/trait_csv_format_c.csv)
210
+
-**Unformatted:** Contains three columns. The first contains the user or account key, the second contains the trait value and the third is a JSON object containing the external IDs. Generating this CSV is by far the fastest of the three options. [Download example unformatted CSV](/docs/engage/files/trait_csv_format_a.csv)
211
+
-**Distinct columns for unique external IDs (with indexed columns for ID types with multiple values):** Contains the same first three columns as the unformatted CSV. Additional columns are added for each distinct external ID type. When a single row has more than one value for a given external ID type, 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](/docs/engage/files/trait_csv_format_b.csv)
212
+
-**Distinct columns for unique external IDs (with additional rows for ID types with multiple values):** Contains the same first three columns as the unformatted CSV. Additional columns are added for each distinct external ID type. When a single row has more than one value for a given external ID type, for example a user with two email addresses, _additional rows are added with the first three columns repeated (user or account key, trait value and external IDs JSON)._[Download example formatted CSV with additional rows](/docs/engage/files/trait_csv_format_c.csv)
213
213
<table>
214
214
<tr>
215
215
<td></td>
Copy file name to clipboardExpand all lines: src/engage/audiences/sql-traits.md
+6-23Lines changed: 6 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -84,38 +84,24 @@ To connect BigQuery to Segment SQL Traits, follow these instructions to create a
84
84
85
85
2. Click the drop down to the left of the search bar and select the project that you want to connect.
86
86
87
-

88
-
89
87
> **Note**: If you don't see the project you want in the menu, click the account switcher in the upper right corner, and verify that you're logged in to the right Google account for the project.
90
88
91
89
3. Click the menu in the upper left and select **IAM & Admin**, then **Service accounts**.
92
90
93
-
5. Click **Create Service Account**.
94
-
95
-

96
-
97
-
6. Give the service account a name like `segment-sqltraits`.
98
-
99
-
7. Under **Project Role**, add _only_ the `BigQuery Data Viewer` and `BigQuery Job User` roles.
91
+
4. Click **Create Service Account**.
100
92
101
-

93
+
5. Give the service account a name like `segment-sqltraits`.
102
94
103
-

95
+
6. Under **Project Role**, add _only_the `BigQuery Data Viewer` and `BigQuery Job User` roles.
104
96
105
97
> IMPORTANT: Do not add any other roles to the service account. Adding other roles can prevent Segment from connecting to the account.
106
98
107
-
6. Click **Create Key**.
99
+
7. Click **Create Key**.
108
100
109
-

110
-
111
-
7. Select `JSON` and click **Create**.
112
-
113
-

101
+
8. Select `JSON` and click **Create**.
114
102
115
103
A file with the key is saved to your computer. Save this; you'll need it to set up the warehouse source in the next step.
116
104
117
-

118
-
119
105
You're now ready to create a new BigQuery warehouse source, upload the JSON key you just downloaded, and complete the BigQuery setup.
120
106
121
107
### Step 2. Add the warehouse as a Source
@@ -219,7 +205,6 @@ Yes, Segment limits request sizes to a maximum of 16kb. Records larger than this
219
205
### I'm getting a permissions error.
220
206
221
207
You might encounter a `permission denied for schema` error, like the following:
222
-

223
208
224
209
Segment usually displays this error because you're querying a schema and table that the current user cannot access. To check the table privileges for a specific grantee (user), view the credentials of the stored warehouse user.
225
210
@@ -236,13 +221,11 @@ Learn more about granting permissions using the following links:
236
221
237
222
### I'm seeing a maximum columns error.
238
223
239
-

240
-
241
224
Segment supports returning only 25 columns. [Contact Segment](https://segment.com/help/contact/){:target="_blank"} with a description of your use case if you need access to more than 25 columns.
242
225
243
226
### I'm seeing a duplicate `user_id` error.
244
227
245
-

228
+

246
229
247
230
Each query row must correspond to a unique user. Segment displays this error if it detects multiple rows with the same `user_id`. Use a `distinct` or `group by` statement to ensure that each row has a unique user_id.
0 commit comments