Skip to Content

Acxiom

Deliver audience and customer data files to Acxiom via Amazon S3 for identity resolution, data enrichment, and audience activation. Zeotap exports model results, audience lists, or enriched profiles as CSV or JSONL files to an Acxiom-managed S3 bucket, where Acxiom processes them through their identity graph (AbiliTec/Real ID) and activates audiences across downstream channels.

Prerequisites

  • An Acxiom account with data onboarding enabled
  • An Acxiom-managed S3 bucket provisioned by your Acxiom representative
  • AWS access credentials (access key + secret key) with write permissions to the bucket
  • Bucket name and AWS region provided by Acxiom

Authentication

Acxiom data delivery uses AWS Access Keys to authenticate with the S3 bucket.

  1. Contact your Acxiom representative to provision an S3 bucket for data delivery
  2. Obtain the AWS Access Key ID and AWS Secret Access Key with write access to the bucket
  3. Enter both credentials in Zeotap when configuring the destination

Required Permissions

The AWS credentials need the following IAM permissions on the Acxiom S3 bucket:

  • s3:PutObject — write data files to the bucket
  • s3:GetBucketLocation — verify bucket region
  • s3:ListBucket — list objects for verification
  • s3:DeleteObject — clean up test objects during connection testing

Configuration

FieldTypeRequiredDescription
S3 Bucket NametextYesThe Acxiom-managed S3 bucket for data delivery
AWS RegionselectYesAWS region where the bucket is hosted (default: us-east-1)
Path PrefixtextNoFolder path prefix within the bucket for organizing files (default: zeotap/)

Target Settings

FieldTypeRequiredDescription
File FormatselectYesOutput file format: CSV or JSONL (default: CSV)
Enable Gzip CompressiontoggleNoCompress files with gzip before uploading (default: enabled)

Supported Operations

Sync Modes

ModeSupportedDescription
InsertYesWrite a new file for each sync batch
MirrorYesWrite the full dataset snapshot as a file
UpsertNot applicable for file-based delivery
UpdateNot applicable for file-based delivery

Audience Sync Modes

ModeSupportedDescription
AddYesWrite audience members as a new file
MirrorYesWrite the full audience membership snapshot
RemoveNot applicable for file-based delivery
UpsertNot applicable for file-based delivery

Features

FeatureSupported
Field MappingNo
Schema IntrospectionNo

How It Works

  1. Serialization — Zeotap serializes the batch rows into the configured format (CSV or JSONL)
  2. Compression — If enabled, files are gzip-compressed before upload
  3. Upload — Files are uploaded to the Acxiom S3 bucket using the AWS S3 PutObject API
  4. Path — Files are organized by date partition: {prefix}/{YYYY-MM-DD}/{batch_id}.{ext}
  5. Processing — Acxiom picks up delivered files and processes them through their identity graph for resolution and activation (typically within 24-48 hours)

Each sync batch produces a single file. Mirror mode writes the complete dataset snapshot, while insert mode appends new data files.

Rate Limits

S3 supports up to 3,500 PUT requests per second per prefix partition. This is well above typical sync volumes and unlikely to be a limiting factor.

File size is limited to 5 GB per object via single-part upload. For larger datasets, Zeotap automatically splits data across multiple batch files.

Best Practices

  • Use CSV format for Acxiom delivery — CSV is the standard format for Acxiom data onboarding pipelines
  • Enable gzip compression to reduce upload time and storage costs
  • Coordinate path prefix with your Acxiom representative so they know where to find delivered files
  • Include identity fields (email, phone, postal address) to maximize Acxiom’s identity resolution match rates
  • Use mirror mode for audience syncs to ensure Acxiom always has the latest complete membership list

Troubleshooting

Connection test fails with “Access Denied”

The AWS credentials do not have permission to access the S3 bucket. Verify the access key has s3:PutObject, s3:GetBucketLocation, and s3:ListBucket permissions on the bucket. Contact your Acxiom representative to verify bucket provisioning.

Connection test fails with “bucket not found”

The bucket name is incorrect or the bucket has not been provisioned yet. Double-check the bucket name provided by Acxiom and verify the correct AWS region is selected.

Files are not being processed by Acxiom

Acxiom processes delivered files on a batch schedule (typically 24-48 hours). If files are not processed after 48 hours, verify the path prefix matches what Acxiom expects and contact your Acxiom representative.

Upload fails with timeout

Large files may timeout on slow connections. Enable gzip compression to reduce file sizes, or check your network connectivity to the AWS region hosting the bucket.

”InvalidAccessKeyId” error

The AWS Access Key ID is incorrect or has been deactivated. Generate new credentials and update them in Zeotap.

Region mismatch error

The selected AWS region does not match the bucket’s actual region. Contact your Acxiom representative to confirm the correct region.

Last updated on