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:
- Step 1: Use your cloud service's interface to prepare it for use with DCP.
- Step 2: Connect it to DCP in the AppsFlyer platform. See Data Collaboration Platform (DCP) - Add connections.
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:
- Log in to the AWS console.
- Go to the S3 service.
- Create the bucket:
- Click Create bucket.
-
Complete the Bucket name, starting with
af-dcr-and followed by your text, according to the DCR naming requirements.
- Click Create bucket.
To grant AppsFlyer bucket permissions:
- Select the bucket you created.
- Go to the Permissions tab.
- In the Bucket policy section, click Edit. The Edit bucket policy window opens.
-
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/*" ] } ] } - In the snippet, replace
af-dcr-mybucket(in the two lines in which it appears) with the name of the bucket you created. - 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:
- Log in to your GCS console.
- Go to the Cloud Storage Browser page.
- Create the bucket:
- Click Create bucket.
-
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.
- Click Continue.
- Click Create.
To grant AppsFlyer bucket permissions:
- Select the bucket you created.
- Go to the Permissions tab.
- In the Permissions section, click + Add. The Add members window opens.
- In the New members box, enter the following accounts:
appsflyer-dcr@dcr-report.iam.gserviceaccount.comaf-data-delivery@af-raw-data.iam.gserviceaccount.com
- From the Role list, select Cloud storage > Storage Admin.
- 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:
- Log in to your Google Cloud console.
- Go to the BigQuery page.
- In a new or existing Google Cloud project, create a dataset for the exclusive use of DCP:
- In the left-side panel, click the three-dot menu icon (View actions) to the right of the project ID.
-
Select Create dataset.
- 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.
- You can use any name: letters, numbers, and underscores only.
- Click Create dataset.
To grant AppsFlyer permissions to the dataset:
- In the left-side panel, click the three-dot menu icon (View actions) to the right of the dataset you created.
- Select Share.
- In the right-side panel that opens, click Add principal.
- In the Add principals section, enter the following account in the New principals field:
appsflyer-dcr@dcr-report.iam.gserviceaccount.com
-
In the Assign roles section, select BigQuery > BigQuery Data Viewer.
- Click Save.
- 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:
- Log in to the Snowflake account that contains the data you want to share with DCP.
- Switch your role to Account admin.
- From the left-side panel, select Private Sharing.
-
On the page that opens, select the Shared By Your Account tab.
- Click Share. From the list that opens, select Create a Direct Share.
- Select the tables and/or views you want to share with DCP, then click Done.
- Change the Secure Share Identifier and add an optional description as needed.
-
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 - 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:
|
| Bucket naming |
Bucket names must begin with |