Data Collaboration Platform (DCP) - Set up your cloud services

At a glance: Set up your cloud services so you can connect your source data to DCP and export audiences to your cloud storage buckets.

About cloud service setup

DCP uses two types of connections to move data between your cloud services and the platform:

  • Source connections: Enables you to connect your first-party data to DCP for collaboration and audience creation.
  • Cloud storage connections: Enables you to export your audiences to your cloud storage buckets after each audience update.

Setting up a connection is a two-step process:

The table below shows which services are supported for each connection type:

Cloud service Source (inbound) Cloud storage (outbound)
Amazon S3
Google Cloud Storage (GCS)
BigQuery -
Snowflake -
Salesforce Cloud/CRM -

For Amazon S3 and GCS, the same bucket setup and permissions apply for both source and cloud storage connections, so no separate setup is needed for each direction. Creating a source connection automatically creates a matching cloud storage connection (and vice versa), and deleting one deletes the other, since it's really one underlying connection that's shared across both tabs.

Set up your cloud services

Select your cloud service below for setup instructions.

Amazon S3

Use the following instructions to prepare an Amazon S3 bucket for use with DCP.

Note

The following procedure must be performed by your AWS admin.

To create a bucket:

  1. Log in to the AWS console.
  2. Go to the S3 service.
  3. Create the bucket:
    1. Click Create bucket.
    2. Complete the Bucket name, starting with af-dcr- 

       and followed by your text, according to the DCR naming requirements.

    3. Click Create bucket.

To grant AppsFlyer bucket permissions:

  1. Select the bucket you created.
  2. Go to the Permissions tab.
  3. In the Bucket policy section, click Edit. The Edit bucket policy window opens.
  4. Paste the following code snippet into the window:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Sid": "AF-DCR-DL",
          "Effect": "Allow",
          "Principal": {
            "AWS": [
              "arn:aws:iam::195229424603:user/product=dcr-reporter__envtype=prod__ns=default",
              "arn:aws:iam::195229424603:user/product=datalocker__envtype=prod__ns=default"
            ]
          },
          "Action": [
            "s3:GetObject",
            "s3:ListBucket",
            "s3:DeleteObject",
            "s3:PutObject"
          ],
          "Resource": [
            "arn:aws:s3:::af-dcr-mybucket",
            "arn:aws:s3:::af-dcr-mybucket/*"
          ]
        }
      ]
    }
  5. In the snippet, replace af-dcr-mybucket (in the two lines in which it appears) with the name of the bucket you created.
  6. Click Save changes.

Important!

When replacing the bucket name in the snippet, do not overwrite /* in the second line in which the bucket name appears.

Google Cloud Storage (GCS)

Use the following instructions to prepare a GCS bucket for use with DCP.

Note

The following procedure must be performed by your Google Cloud admin.

To create a bucket:

  1. Log in to your GCS console.
  2. Go to the Cloud Storage Browser page.
  3. Create the bucket:
    1. Click Create bucket.
    2. Enter your bucket information on the Create a bucket page. Include the bucket name, starting with af-dcr- 

       and followed by your text, according to the DCR naming requirements.

    3. Click Continue.
    4. Click Create.

To grant AppsFlyer bucket permissions:

  1. Select the bucket you created.
  2. Go to the Permissions tab.
  3. In the Permissions section, click + Add. The Add members window opens.
  4. In the New members box, enter the following accounts:
    • appsflyer-dcr@dcr-report.iam.gserviceaccount.com
    • af-data-delivery@af-raw-data.iam.gserviceaccount.com
  5. From the Role list, select Cloud storage > Storage Admin.
  6. Click Save.

BigQuery

BigQuery supports source connections only. Use the following instructions to create a dataset and grant AppsFlyer permissions.

Note

The following procedure must be performed by your Google Cloud admin.

To create a dataset:

  1. Log in to your Google Cloud console.
  2. Go to the BigQuery page.
  3. In a new or existing Google Cloud project, create a dataset for the exclusive use of DCP:
    1. In the left-side panel, click the three-dot menu icon (View actions) to the right of the project ID.
    2. Select Create dataset

    3. In the right-side panel that opens, enter the name of the dataset and select other options as required.
      • You can use any name: letters, numbers, and underscores only.
        • Recommended: Use a name that indicates the dataset is being used for a source connection.
      • Do not use the Enable table expiration option, as DCP will be unable to read your data after the tables expire.
    4. Click Create dataset.

To grant AppsFlyer permissions to the dataset:

  1. In the left-side panel, click the three-dot menu icon (View actions) to the right of the dataset you created.
  2. Select Share.
  3. In the right-side panel that opens, click Add principal.
  4. In the Add principals section, enter the following account in the New principals field:
    • appsflyer-dcr@dcr-report.iam.gserviceaccount.com
  5. In the Assign roles section, select BigQuery > BigQuery Data Viewer

  6. Click Save.
  7. Click Close to close the right-side panel.

Snowflake

Snowflake supports source connections only. Use the following instructions to create a private share for use by DCP.

Note

The following procedure must be performed by a Snowflake Accountadmin.

To create a private share:

  1. Log in to the Snowflake account that contains the data you want to share with DCP.
  2. Switch your role to Account admin.
  3. From the left-side panel, select Private Sharing.
  4. On the page that opens, select the Shared By Your Account tab. 

  5. Click Share. From the list that opens, select Create a Direct Share.
  6. Select the tables and/or views you want to share with DCP, then click Done.
  7. Change the Secure Share Identifier and add an optional description as needed.
  8. In the Add accounts in your region by name field, enter the AppsFlyer Snowflake account for your region:

    Region AppsFlyer account
    EU West (eu-west-1) QL63117
    US East - N. Virginia (us-east-1) MWB70410
    US East - Ohio (us-east-2) BM15378
  9. Click Create Share.

Salesforce Cloud/CRM

Salesforce Cloud/CRM supports source connections only. See DCP - Integration with Salesforce Data Cloud for setup instructions.

Traits and limitations

Trait Description
Supported cloud services Amazon S3 and GCS support both source and cloud storage connections. BigQuery, Snowflake, and Salesforce Cloud/CRM support source connections only.
Bucket use S3 and GCS buckets must be for the exclusive use of DCP. No other service can write data to the bucket.
DCR naming requirements

The following naming requirements apply to all DCR data entities, including buckets, folders, and files:

  • Maximum length: 200 characters
  • Valid characters: letters (A-Z, a-z), numbers (0-9), hyphens (-)
  • Invalid characters: spaces, and all other symbols or special characters
  • Numbers and hyphens cannot be the first character of a name
  • Special-purpose characters only:
Bucket naming

Bucket names must begin with af-dcr- followed by your text. Example: af-dcr-example-bucket