Skip to content
Raise a Ticket
Contact us
  • There are no suggestions because the search field is empty.

How to Integrate Pearl Diver With AWS S3

The AWS S3 integration in Pearl Diver allows users to upload raw personal web or intent data directly into an Amazon S3 bucket. This integration is designed for developers who need a secure and automated method to transfer data from Pearl Diver into their AWS infrastructure for further processing or analysis.

 Prerequisites


🔐To authorize the AWS S3 integration within Pearl Diver and enable data syncing for Custom Audience creation, ensure the following:

  • An AWS account with permissions to create and access S3 buckets.
  • AWS Access Key ID and Secret Access Key (with s3:PutObject permissions).
  • An existing S3 bucket to receive data.

Key Capabilities

  • Export raw web and intent data to AWS S3.

  • Secure authentication using AWS Access and Secret keys.

  • Supports configuration at the bucket level for targeted data storage.

  • Enables seamless audience data sync between Pearl Diver and AWS S3.

🛠️ How to Set Up the AWS (S3) Integration

Step 1: Connect your AWS S3 bucket to Pearl Diver

a) Log into your Pearl Diver account.

b) Go to the "Actions" page.

c) Click on the AWS S3 action to open the integration configuration screen.

Step 2: Configure AWS Credentials
Under the Action Configuration section, enter the following:
image (23)

Field

 

Description

 

Bucket name

The S3 bucket where Pearl Diver will upload your data. Ensure the bucket exists and is accessible to your credentials.

Access key

Your AWS Access Key ID. This key must have write access to the specified bucket.

Secret

Your AWS Secret Access Key. Ensure this is kept confidential and not shared publicly.
After filling out the fields, click Authorize to validate and connect the integration.
 

Note: The Access Key and Secret used must have the s3:PutObject permission for the target bucket.

Step 3: Add Audience Configuration

Once authorized, you can configure which audiences from Pearl Diver should export their data to the connected AWS S3 bucket.

  • Under Audience Configuration, select one or more audiences to connect.

  • Click Update to save the configuration.

🔍Where It Appears in S3 bucket

Once the audiences are successfully uploaded to the bucket, data will be placed in a folder with the audience name and key (audienceName_audienceKey) which will be inside a parent folder with the audience type as its name (either web or intent)
image (24)

image (25)