Overview
The Audience Uploader from AWS Clean Rooms solution deploys a web application with services including AWS Glue and AWS Lambda that automatically prepares, transforms, and uploads audience signals into popular advertising platforms using their respective APIs.
Benefits
Reduce IT resources by automating the ETL of data collaboration results from AWS Clean Rooms to advertising platforms
Ensure data is stored, encrypted, and controlled within your AWS account and have end-to-end visibility on each step of the upload workflow.
Improve campaign planning by developing insights based on multi-party customer intersection and attribute enrichment.
Technical details
Deploying this solution with the default parameters deploys the following components in your AWS account.
Step 1
TargetPlatform parameter is captured during stack deployment and stored in AWS Systems Manager Parameter Store.
Step 2
User uses Audience Uploader from AWS Clean Rooms application user interface to log in.
Step 3
Amazon Cognito is used for user authentication.
Step 4
Audience Uploader from AWS Clean Rooms web app is loaded on the browser from Amazon CloudFront distribution to help reduce latency and improve security.
Step 5
All requests are authenticated and then handled via Amazon API Gateway using the credentials from Amazon Cognito.
Step 6
Once user selects the data they want to upload and map the columns in the file to a schema compatible with TikTok, a REST API call is invoked to start the AWS Glue transformation job.
Step 7
The data will be normalized and partitioned and any relevant PII columns will be hashed using AWS Glue.
Step 8
Once the transformation AWS Glue job is completed and the output data is uploaded to the Amazon S3 Bucket, a notification is published to Amazon EventBridge.
Step 9
Amazon EventBridge routes the Amazon S3 object event to an Amazon SQS queue allowing support for API retry, replay, and throttling.
Step 10
Amazon SQS queue event initiates TikTok AWS Lambda uploader function.
Step 11
The AWS Lambda uploader function retrieves the access tokens from AWS Secrets Manager.
Note: User must add access credentials (keys and corresponding secret values) via AWS Secrets Manager console before using Audience Uploader from AWS Clean Rooms App (refer to the Readme.md file in the GitHub repository for target specific settings).
Step 12
The AWS Lambda uploader function uploads the transformed and encrypted data to TikTok API for use in marketing campaigns.
Step 1
TargetPlatform parameter is captured during stack deployment and stored in AWS Systems Manager Parameter Store.
Step 2
User uses Audience Uploader from AWS Clean Rooms application user interface to log in.
Step 3
Amazon Cognito is used for user authentication.
Step 4
Audience Uploader from AWS Clean Rooms web app is loaded on the browser from Amazon CloudFront distribution to help reduce latency and improve security.
Step 5
All requests are authenticated and then handled via Amazon API Gateway using the credentials from Amazon Cognito.
Step 6
Once user selects the data they want to upload and map the columns in the file to a schema compatible with TikTok, a REST API call is invoked to start the AWS Glue transformation job.
Step 7
The data will be normalized and partitioned and any relevant PII columns will be hashed using AWS Glue.
Step 8
Once the transformation AWS Glue job is completed and the output data is uploaded to the Amazon S3 Bucket, a notification is published to Amazon EventBridge.
Step 9
Amazon EventBridge routes the Amazon S3 object event to an Amazon SQS queue allowing support for API retry, replay, and throttling.
Step 10
Amazon SQS queue event initiates TikTok AWS Lambda uploader function.
Step 11
The AWS Lambda uploader function retrieves the access tokens from AWS Secrets Manager.
Note: User must add access credentials (keys and corresponding secret values) via AWS Secrets Manager console before using Audience Uploader from AWS Clean Rooms App (refer to the Readme.md file in the GitHub repository for target specific settings).
Step 12
The AWS Lambda uploader function uploads the transformed and encrypted data to TikTok API for use in marketing campaigns.
Related content
This Guidance demonstrates how to import first party data from third party sources to Amazon Simple Storage Service (Amazon S3), and then upload and query your data directly to Amazon Marketing Cloud (AMC).
This Guidance allows brands to upload audience outputs into the Meta Business Platform without having to build custom workflows.
This Guidance allows brands to upload audience outputs into TikTok Ads without having to build custom workflows.
Disclaimer
Any customer list output from your Amazon environment that you are seeking to activate through TikTok’s Custom Audiences will still need to adhere to TikTok’s Custom Audience terms, including verifying that data you share with TikTok does not include information about children, sensitive health or financial information, other categories of sensitive information.