Skip to main content

Tatari: Connection guide

If you’d like to connect your Tatari data to Funnel, you can do so by submitting a Custom Connector Request.

Updated today

If your use case requires this data in Funnel, you can request it as a Custom Connector.

Custom Connectors and the Custom Connector Request feature are available in the following plans: Business and Enterprise. See our Pricing page for more details.


Importing Tatari Data via Amazon S3 (Custom Connector)

To ingest Tatari data into Funnel, the data must first be delivered by Tatari into an Amazon S3 bucket that you control.
Please coordinate directly with Tatari’s team to confirm:

  • Which reports can be delivered

  • File format and schema

  • Delivery frequency

  • Folder/path structure in S3

If you have any questions about the export itself, Tatari is the best point of contact.
Once Tatari confirms the S3 delivery setup, follow the steps below to connect the data to Funnel.


Step 1: Submit a Custom Connector Request

When submitting your Custom Connector Request to Funnel, include the following information:

  • Data platform origin
    Example: Tatari TV Performance Data

  • Bucket name
    The name of the Amazon S3 bucket where Tatari will upload the data.

  • Bucket region
    Example: us-east-1, eu-west-1

  • Path where reports will be uploaded
    The folder or prefix inside the bucket (as defined with Tatari).

  • Sample report file
    A sample file provided by Tatari that includes all fields to be integrated (required for validation).


Step 2: Grant Funnel Access to Your S3 Bucket

To allow Funnel to retrieve Tatari data from your Amazon S3 bucket, grant access using one of the following options.


Option 1: Whitelist Funnel’s IAM Role (Recommended)

Depending on which Funnel instance your account belongs to, use the corresponding IAM role:

Funnel Instance

IAM Role ARN

Global

arn:aws:iam::071303700930:role/productionCustomsExternalS3Pull

EU

arn:aws:iam::861035124038:role/CustomsExternalS3Pull-eu

Steps:

  1. Log in to the AWS Management Console

  2. Go to S3 → Buckets and select the relevant bucket

  3. Open the Permissions tab and click Bucket Policy

  4. Add a policy granting:

    • s3:GetObject

    • s3:ListBucket
      for the appropriate IAM role and only for the path where Tatari uploads reports

  5. Save your changes

This allows Funnel to securely retrieve Tatari data from your S3 bucket.


Option 2: Create a New IAM Role for Funnel to Assume

If preferred, you can create a dedicated IAM role:

  1. Create a new IAM role in your AWS account

  2. Grant read-only access (s3:GetObject) to the specific S3 bucket or path

  3. Share the role ARN with Funnel so we can assume it


Step 3: Share Credentials Securely

After granting access:

  1. Visit the Custom Connector Request Status page

  2. Click Add Credentials for the relevant request

  3. Enter the required details and submit

  4. Notify the Funnel team once completed so we can validate access


Step 4: Confirmation

Once access is verified, Funnel’s Integration Engineering team will:

  • Test the S3 connection

  • Validate the Tatari file structure

  • Complete setup of your Amazon S3 Custom Connector


How to Request the Amazon S3 Custom Connector

You can request the connector in either of the following ways:

  • Submit a Custom Connector Request (see linked instructions), or

  • Enable Show custom connectors and select the Amazon S3 (Custom) tile
    – selecting the tile automatically submits your request


Notes

If you are interested in Tatari data that hasn’t been covered here, please contact our Integration Engineering team by submitting a Custom Connector Request. They will be happy to explore adding support for your data.


Helpful Resources

Did this answer your question?