Upload files to a service
This article describes how to configure your file service to prepare files for import.
After you set up your data source, upload your CSV files to your file service using a third-party app. Though you may use any client for this purpose, we recommend Cyberduck because it’s free and supports FTP and Amazon S3.
Upload and manage files using Cyberduck and Amazon CLI
Use the following articles to get started uploading and managing your files:
- Upload a file via FTP or Amazon S3 with Cyberduck
- Upload and manage files using the Amazon Command Line Interface
- Upload files to an empty S3 bucket using the Amazon CLI
After you set up a file import data source, use usage reports to review the number of file import rows or lines imported into AudienceStream. For more information, see Understanding the usage report.
Amazon S3 access configuration
If you use your company’s own Amazon S3 bucket for your file service (not the included Tealium S3 bucket), you need to allow Tealium access to the Amazon S3 bucket before processing any files.
Storing large numbers of files in your S3 bucket may slow read times. We recommend regularly removing processed files from your S3 bucket to maintain efficient read times.
Amazon bucket policies
Use the AWS Policy Generator and the Amazon S3 console to add a new bucket policy. The Amazon S3 bucket policies control access to buckets from specific virtual private cloud (VPC) endpoints.
For more information about AWS bucket policies, see the following articles in the AWS documentation:
- Adding a bucket policy by using the Amazon S3 console
- Controlling access from VPC endpoints with bucket policies
Use the following configuration details to allow Tealium access to the Amazon S3 bucket used in your file import data source.
{
"Version": "YYYY-MM-DD",
"Id": "VPCe and SourceIP",
"Statement": [{
"Sid": "VPCe and SourceIP",
"Effect": "Deny",
"Principal": "*",
"Action": "s3:*",
"Resource": [
"arns3:::name",
"arns3:::name/*"
],
"Condition": {
"StringNotEquals": {
"aws [
"vpce-0e9f123ab6789" // Replace this value with the vpcEndpointId that is trying to access your S3 bucket. You can find this ID in CloudTrail logs.
]
},
"NotIpAddress": {
"aws [
//(Optional) To help diagnose potential connection problems, ask your Tealium Customer Service Manager
//for the Tealium Office VPN IP Address(es) and add them below. The following addresses are examples only.
"54.206.4.11",
"54.150.228.144"
]
}
}
}]
}
VPCe addresses to allow
Ensure that you allow both the VPCe for us-west-1
and the VPCe for your profile region.
To find your profile region, navigate to the server-side admin menu and select Server-Side Settings > Region. After you locate your region, select the corresponding VPCe from Tealium IP addresses to allow.
File upload errors
When a file process failure occurs, the file is ignored. The system does not attempt to process the file again. The most common reasons for failure are:
- The CSV file is improperly formatted and is therefore not a valid CSV file.
- The CSV file must be in UTF-8 format with no BOM encoding.
- Column names used in the file definition do not exist in the file.
- A column name is used more than once in the File Service configuration.
If AudienceStream fails to copy a file using the file transfer service, it will retry in 10 minutes.
This page was last updated: December 29, 2023