Skip to main content
All CollectionsBrazeBraze - Dynamic Optimisation General Articles
Braze - Dynamic Optimisation - Use an Existing Amazon S3 Bucket Current for Click Tracking
Braze - Dynamic Optimisation - Use an Existing Amazon S3 Bucket Current for Click Tracking

If you're using an Amazon S3 bucket to collect your Braze data today, we can leverage that existing relationship for use with Jacquard

Updated over 6 months ago

There's more than one way to track a click with Braze and Jacquard. If you're using an Amazon S3 bucket to export your data from Braze today, we'll show you how to replicate that data into Jacquard's S3 bucket. You'll then be able to send Jacquard your clicks using the Braze Current you already have.

If you're not sure whether or not you use an S3 bucket today to receive data from a Braze Current, check with your Braze system admin.

In order for your data to replicate from your S3 bucket to Jacquard's, you must start by enabling bucket versioning.

In your Amazon Web Services interface, navigate to the Management tab for the S3 bucket to which your Braze Current is currently set up to send data.

Click on Create replication rule.

Give the replication rule a unique name. In our example, we've creatively named ours replication rule.

You can set the rule to be applied to all objects in your source bucket or create a prefix. Braze Currents send data per event type in distinct folders. So, you could choose a prefix like /event_type=users.messages.email.Open/ to exclude all data that isn’t part of the email open events, for example.

The easiest option is to select Apply to all objects in the bucket to send all available event types to Jacquard. Jacquard will ignore any files it can't process.

For the destination, choose Specify a bucket in another account. A Jacquard Solutions Architect will provide you with the proper Account ID and Bucket name upon request. Leave the Change object ownership to destination bucket owner option unchecked.

Next, select the IAM role S3 should use to replicate the objects on your behalf.

AWS recommends creating a new role, which will be done upon save. However, if you want to select an existing one you can. Jacquard will require the details of this role in order to allow replication to be received on our side. You should provide the details to your Jacquard representative in the following format:

arn:aws:iam::SourceBucket-account-ID:role/service-role/source-account-IAM-role

S3 objects are automatically encrypted at rest via SSE-S3.

You may choose to use AWS-KMS, but you will be required to add a role and then create and apply a policy to allow the role to perform the necessary actions. You will also need to share the ARN of this role and the ARN value of the KLM key used to encrypt the files. Jacquard also needs the region of the bucket and your AWS Account ID. Please let Jacquard know if you choose this option, as we're required to set up our own KLM key to handle the encryption.

Leave Change the storage class for the replicated objects unchecked.

You can choose the rest of the settings in accordance with your preferences. However, we do recommend you toggle on Replication Time Control (RTC), as this replicates 99.9% of objects within 15 minutes. You may incur additional charges when using RTC.

When you're finished, click Save.

Summary Requirements

Jacquard will provide:

  • Account ID

  • Bucket name

Customer to provide:

  • IAM Role Details (format as above)

If using, AWS-KMS:

  • ARN of this role

  • ARN of the KLM key used to encrypt the files.

  • the Region of the Bucket

  • AWS Account ID

Please do not share these details directly via email. Instead, please place in a password-protected file and share the password via a one-time service, such as Privnote (https://privnote.com/).

Did this answer your question?