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/profiles/csv-upload.md
+17-9Lines changed: 17 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,15 +5,15 @@ engage: true
5
5
---
6
6
Use the CSV Uploader to add or update user profiles and set subscription states.
7
7
8
-
When you upload a CSV file, Twilio Engage adds new users and updates existing user profiles. CSV rows correspond to a user and columns to an identifier trait in your [identity resolution configuration](/docs/personas/identity-resolution/identity-resolution-settings/).
8
+
When you upload a CSV file, Twilio Engage adds new users and updates existing user profiles. Each CSV row corresponds to a user profile and columns to an identifier trait in your [identity resolution configuration](/docs/personas/identity-resolution/identity-resolution-settings/).
9
9
10
-
You can also use the CSV Uploader to set email and SMS [subscription states](#set-user-subscriptions)to track email addresses and phone numbers that you have permission to market to.
10
+
You can also [set subscription states](#set-user-subscriptions)for each email and SMS that you upload in the CSV. Subscription states help you track which email addresses and phone numbers you have permission to market to.
11
11
12
12
## Upload a CSV file
13
13
14
-
To upload a CSV file, navigate to **Personas > Profiles** and click **Update Users**.
14
+
To upload a CSV file, navigate to **Personas > Profiles** and click **Upload CSV**.
15
15
16
-
### 1. Download a CSV template with identifiers
16
+
### 1. Download your CSV template
17
17
18
18
Click **Download Template** to download a CSV template with identifier columns from your identity resolution configuration. Engage adds subscription columns next to email and SMS identifiers, where you can update subscription states for email addresses and phone numbers.
19
19
@@ -22,7 +22,14 @@ Click **Download Template** to download a CSV template with identifier columns f
22
22
23
23
Navigate to **Personas > Settings** and select the **Identity Resolution** tab to view or add identifiers in your Segment workspace.
24
24
25
-
### 2. Upload a CSV file
25
+
### 2. Fill out your CSV file
26
+
27
+
Enter values for the identifiers in your CSV file. You can also [set email and phone subscriptions](#set-user-subscriptions) using the `email_subscription_status` and `sms_subscription_status` columns.
28
+
29
+
> success ""
30
+
> Leave any unknown values blank to avoid bad data.
31
+
32
+
### 3. Upload your CSV file
26
33
27
34
Upload a CSV file to Twilio Engage in two ways:
28
35
- Drag and drop the CSV file in the dropzone.
@@ -32,7 +39,7 @@ Engage processes CSV rows sequentially. Column values, except for a blank subscr
32
39
33
40
A blank subscription status in the CSV doesn't overwrite current **email** or **phone**[subscription states](/docs/engage/profiles/user-subscriptions/subscription-states/) in your Segment space.
34
41
35
-
### 3. Name the custom trait
42
+
### 4. Name your custom trait
36
43
37
44
Every time you upload a file, you have the option to add a custom trait to user profiles in the CSV. Use custom traits to help you create audiences or send messages to a specific group of users. You can also add an existing custom trait name from your Segment workspace to the list of users in the CSV file.
38
45
@@ -53,12 +60,13 @@ Use error reports to fix invalid rows and quickly re-upload data.
53
60
From the Upload History page:
54
61
55
62
1. Select the link in the **Report** column to download an error report CSV. All rows not present in the error report were processed successfully.
56
-
2. Correct data in the invalid rows and remove any extra columns.
57
-
3. Click **Update Users** and re-upload the CSV file.
63
+
2. Correct data in the invalid rows.
64
+
3. Remove any extra columns such as `row_number`, `error_message`, and `error_code`.
65
+
3. Click **Upload CSV** and re-upload the file.
58
66
59
67
## Set user subscriptions
60
68
61
-
Use the CSV Uploader to set subscription states for user email addresses or phone numbers. Subscription states help you track which email addresses and numbers you have permission to market to.
69
+
Use the CSV Uploader to set subscription states for user email addresses and phone numbers.
62
70
63
71
> info ""
64
72
> Each user profile in a Segment workspace can have multiple email addresses and phone numbers, all with different subscription states.
0 commit comments