To deliver Reconnect messages to your users, you must upload a list of user identifier values for those users who opted in to receive messages for each specific channel. A subscriber list must be uploaded for each channel integration you have in your section’s Reconnect app.
The subscriber list is a CSV file that you upload to an AWS S3 bucket, and sync daily.
Important to know before you begin:
- Each section supports one subscriber list for each channel integration.
- You can use subscriber lists to sync opted-in users for the Email and SMS channels. For Push Notification channels, use events. Learn more in Getting Started with Reconnect.
- You must use the same identifier type in the subscriber list as you defined for the channel integration. So if you set the channel integration identifier as a custom user ID (or email address, or phone number...), that's the identifier value you must use in the subscriber list file.
Sync your subscriber list
-
-
- In Reconnect › Integrations, on the relevant channel integration card, click Sync Now.
- Click Continue. An S3 bucket is generated.
- Click Copy Credentials and store the S3 bucket details and the credentials in a safe location so they don't get lost or exposed. You can generate credentials only one more time. If you then need to generate additional credentials, open a support ticket.
- Prepare your CSV file according to the following format:
- For Email Addresses:
- File type: CSV
- Encoding: UTF8 encoding
- File name: data.csv.
- First row: "email"
- Rest of the rows: plain text email addresses, one per row (up to 10 million rows).
Example:
- For Phone Numbers:
- File type: CSV
- Encoding: UTF8 encoding
- File name: data.csv.
- First row: "phone numbers"
- Rest of the rows: plain text phone numbers, one per row (up to 10 million rows). Each number should consist of the country code, area code, and subscriber number with digits only, in E.164 format.
Note: Make sure the phone numbers are valid. If 30% or more of the numbers are invalid, the feed won't sync.
Example:
Download a sample CSV file: data.csv
- For Email Addresses:
- Upload the CSV file to the following folder in the S3 bucket with the appropriate date information:
upload_yyyy-MM-dd_HH-mm
For example:
upload_2020-03-19_14-00 - Upon file upload, synchronization to Dynamic Yield is initiated within a few minutes.
-
After you upload the file to the designated S3 bucket, you can view the sync status of each subscriber list in the relevant integration card under Reconnect Integrations. You can also click Sync Settings to view your S3 bucket or to regenerate credentials (limited to 1 more time after initial generation. If you need to generate them again, contact support).
Important: When the subscriber list is synced, it overrides any previous opted-in and opted-out information, including statuses derived from opt-in/opt-out events.