Audiences—partner connections

AppsFlyer creates and syncs Traits with your selected Data Source in AAM.

To connect an audience to AAM:

1. Log in to the Adobe Marketing Cloud dashboard

2. Go to Manage Data > Data Sources.

3. On the Data Sources page, create a new Data Source.

   

4. Complete the form as follows:

   • Set ID Type to Device Advertising ID.

   • In the inbound data source settings, enable Customer ID.

5. Click Save.
   The Data Sources selection displays.
6. Record the Data Source ID for later use.
7. In the left-hand menu, go to Administration > Groups.

8. Go to the Permissions tab.

   

9. Create a new group.
10. Select the Data Source you created.
11. Click Save Object.
12. Go to Admin > Users.

    

13. Create a new user for use by AppsFlyer Audiences and complete the mandatory fields as needed.

14. In Assigned Groups, select the group you previously created.
15. Record the Email and Password of the user created.
16. Click Save.

17. In AppsFlyer, go to Audiences > Connection.

18. Click Create new connection.
19. Enter a connection name.

20. Select Adobe Marketing Cloud.
    The Connect to Adobe Marketing Cloud window displays.

21. Complete the fields using the credentials previously recorded.
22. Click Add connection.
    Audience data is available in AAM, under Analytics > Onboarding Status after 24 hours.

Creating an S3 integration allows AppsFlyer to send the audience device IDs directly to your S3 bucket. The file sent to S3 has the following characteristics:

• Filename: Audience name and date. For example, my_audience_2020-06-23.csv
• Content: Single column, with no header, containing device IDs
• An additional file is written each day. Existing files aren't deleted
• If split audiences are sent, a single ZIP file is written, it contains a separate file for each partner (split) 

To connect an audience to Amazon S3:

1. In AppsFlyer, go to Audiences > Connection.

2. Click Create new connection.

3. Enter a Connection name.

4. Select Amazon S3.
   The Add connection window opens.

   

5. Record the Account ID and External ID for later use.
6. In the AWS console, go to IAM > Policies.
7. Click Create Policy.
8. Click JSON.
9. Paste the following policy snippet into the JSON window.
   

   {
   							"Version": "2012-10-17",
   							"Statement": [
   							{
   							"Effect": "Allow",
   							"Action": "s3:*",
   							"Resource": "arn:aws:s3:::BUCKET-NAME/*"
   							}
   							]
   }

10. Replace BUCKET-NAME with the name of the bucket to which you want AppsFlyer to upload your audience.

     Note

    The policy must contain only the root bucket and not additional directories in the path. For example, the resource arn:aws:s3:::BUCKET-NAME/Directory/* is not supported. If you need the files to be transferred to a specific directory, see step 14.

    The actions PutObject, DeleteObject and ListBucket are mandatory for AppsFlyer to perform the necessary actions on your bucket.

11. Click Review policy.
12. Enter a policy Name.
13. Click Create policy.

14. In your AWS console, go to Access management > Roles. 

    

15. Click Create role.

16. Select Another AWS account to provide cross-account access between your AWS account and the AppsFlyer AWS account.

    

17. Enter Account ID. This is the Account ID that you already copied from the AppsFlyer dashboard. 

18. Select Require external ID. This is the external ID that you already copied from the AppsFlyer dashboard.

19. When prompted to select a policy from the existing policies in your AWS account, choose the policy previously created.
20. Click the name of the newly created role to open its properties window.

    

21. Record the Role ARN.

22. In the AppsFlyer S3 integration window, enter the ARN and bucket name in the appropriate fields

    If you want to transfer the files into a specific folder within a bucket, provide the bucket name with the subsequent folders inside it, separated by "/" for example (bucketname/foldername/foldername).

    If you provide a folder name that does not already exist, AppsFlyer creates it during the upload process.

23. Click Add connection.
    Once the integration process is complete and an audience is uploaded, a CSV with the device IDs will be available in the bucket.

Map<String, Object> brazeData = new HashMap<>();
partnerData.put("external_user_id", "some-braze-external-id-value");
AppsFlyerLib.getInstance().setPartnerData("braze_int", brazeData);

NSDictionary *brazeInfo = @{
@"external_user_id":@"some-braze-external-id-value"
};
[[AppsFlyerLib shared] setPartnerDataWithPartnerId:@"braze_int"
partnerInfo:brazeInfo];

To create a partner connection to Braze:

1. In your Braze account, navigate to Integrations > Technology Partners, and select AppsFlyer.
2. From the Data Import Using Cohort Import section, click Generate New Key to generate your Data Import Key.
   • Note: If a key already appears here, no need to generate a new one.
   • Important! Be sure that you working in the Data Import Using Cohort Import section of the page (not the install attribution section).

     

3. Copy the Data Import Key and the REST Endpoint to use when configuring the connection in the AppsFlyer dashboard.
4. In AppsFlyer Audiences, go to the Connections tab and click Add partner connection.
5. Select Braze as the partner and give the connection a name.
6. Enter the Data Import Key and the REST Endpoint you copied from your Braze account in step 3.

   

    

7. Save the connection and it will be available to link to any new or existing audience.
8. Once an AppsFlyer audience has been uploaded to Braze, you can use it as a filter when defining segments in Braze.

   

To connect an audience to Criteo:

1. In the Criteo dashboard, create an API User.

2. Record the API User Client ID and Secret.
3. In AppsFlyer, go to Audiences > Connection.
4. Click Create new connection.
5. Enter a Connection name.
6. Select Criteo.

    

   In the appropriate fields, enter the previously recorded API User Client ID and Client Secret, along with your Advertiser ID.
7. Click Add Connection.

Prerequisite:

Your role in Facebook Business Manager must be either Admin or Advertiser including the campaign management ability. 

To connect an audience to Facebook:

1. Create an Ad Account on Facebook
2. In AppsFlyer, go to Audiences > Connection.
3. Click Create new connection.
4. Enter a Connection name.
5. Select Facebook.
6. Click Log in to Facebook.
7. Log in to Facebook (as an admin or advertiser).
8. Select the required Ad Account.
   The Facebook permissions page opens.
9. Follow the instruction in the Facebook user interface. 
10. If you edit the settings, you must Enable Manage your ads. This is the default setting.
11. To close the Facebook user interface, click Done.
12. Click Add connection.
    Once the integration process is complete and an audience is uploaded, it's available in your Facebook Custom Audiences dashboard.

To enable AppsFlyer to send Audiences to Google Ads the following actions must be completed. Note! We only send data to Google after all the steps are complete. 

Considerations:

• After completing the procedure we are able to connect and upload the audience to Google Ads. It takes 6-12 hours for Google Ads to display the populated list. 
• Google Customer Match:
  • Supports: Universal App Campaigns for Engagement (UACe), Display and Video (DV360)
  • Doesn't support:  Universal App Campaigns (UAC)

Action #	Description	Performed by
1	Connect audiences to your Google Ads account. Prerequisite: Google Ads sign-in credentials.	Team member or Admin
2	Sign (approve) the AppsFlyer Google Customer Match terms in the Audiences page in the AppsFlyer platform
3	Reach out to Google Ads, request that they enable your Google Ads account to use Customer Match.	Team member

To connect an audience to Google Ads:

1. In AppsFlyer, go to Audiences, select an audience.
2. Go to the Connect tab. 
3. Click Create new connection.
4. Enter a connection name.
5. Select Google Ads. If the Google Ads icon does not display, reach out to your CSM or hello@appsflyer.com and request that they enable your Audiences to use Google Adwords. 
6. Click Sign in to Google Ads.
   The Sign in with Google window opens.
7. Complete the Google sign-in and confirm your choices in Google Ads. 
   The window closes. 
8. In the AppsFlyer platform, select an account. 
9. Click Terms of service.
   The terms of service display.
10. If you are the admin: If you agree to the terms, click I accept.
11. If you are not the admin: 
    1. Click Proceed and review later.
    2. Ask the admin to login to accept the terms. Use the procedure that follows to do so. 
12. Click Add connection.
    The Google Ads account is connected. Ensure that you complete all the actions in the preceding checklist to enable the connection. 

To accept the terms and enable the connection the admin performs the following procedure:

1. In AppsFlyer, go to Audiences.
2. Go to Connection tab. 
   The list of Audiences partners displays. 
3. In the Google Ads section, select a connection name. 

   

4. Click Terms of service.
5. Review the terms, and if you agree to the terms, click I accept.
6. Click Save changes. 

To connect an audience to Httpool:

1. In AppsFlyer, go to Audiences > Connection.
2. Click Create new connection.
3. Enter a Connection name.
4. Select Httpool.
5. Click Log in to Httpool.
   A new timestamp displays.
6. Click Add connection.

To connect an audience to MyTarget:

1. In AppsFlyer, go to Audiences > Connection.
2. Click Create new connection.
3. Enter a Connection name.
4. Select MyTarget.
5. Click Log in to MyTarget.
6. Select an ad account.
7. Click Add Connection.

1. Create a new Oracle Data Cloud connection, as in the screenshot below:

   

2. Copy AppsFlyer’s Seat ID, and request your Oracle Data Cloud account manager to allowlist it for you. This enables AppsFlyer to create categories on your behalf.
3. Insert your Seat ID and Site ID (you can receive them from your Oracle Data Cloud account manager).
4. After verifying your Seat ID, a dropdown list displays all of your Parent Categories:

   

5. Select the Parent Category under which your sub-categories should be created.
6. Click Add Connection.

To connect an audience to PushSpring:

1. In AppsFlyer, go to Audiences > Connection.
2. Go to the Connection tab.
3. Click Create new connection.
4. Enter a Connection name.
5. Select PushSpring.
6. Click Log in to PushSpring.
   A new timestamp displays.
7. Click Add connection.
   Once the integration process is complete and an audience is uploaded, it appears in your PushSpring Imported Audiences dashboard.

To connect an audience to SFTP:

1. In SFTP, create access credentials which include Server IP, Username, and Password.
2. In AppsFlyer, go to Audiences > Connection.
3. Click Create new connection. Enter a Connection name.
4. Select SFTP.
5. Enter the SFTP credentials.
6. If you want the files to be transferred to a specific folder path in the server, enter the path with “/” delimiters (for example, “appsflyer/audiences”).

    Note

   Each file will be added to a folder named after the Audience name itself. The file name will contain the audience name and relevant date (eg. “appsflyer/audiences/MyAudience/MyAudience_2017-10-02”).

   If you leave this blank, the files will be added to the root folder of your SFTP server.

7. If you want the files to be compressed with GZIP, enable the GZIP files option.
8. Click Add Connection.

AppsFlyer uploads a CSV file of Device IDs to your public Slack channel.

To connect an audience to Slack:

1. In AppsFlyer, go to Audiences > Connection.
2. Click Create new connection. Enter a Connection name.
3. Select Slack.
4. Click Add to Slack.
5. On the Slack authentication screen, select your relevant Slack Team.
6. Select a public Channel.
7. Click Add connection.
   Once the integration process is complete, and an audience has been uploaded, a CSV file with the Device IDs appears in the selected Slack channel. 

To connect an audience to Snapchat

1. In AppsFlyer, go to Audiences > Connection.
2. Click Create new connection. Enter a Connection name.
3. Select Snapchat.
4. Click Log in to Snapchat.
5. Select your Organization and Ad account.
6. Click Add connection.
   The audience will appear in the Snapchat dashboard 24 hours after upload. 

To connect an audience to Tapjoy:

1. Get your Partner ID from your Tapjoy Account Manager.
2. Get your Publisher Reporting API Key from the Tapjoy App Settings page.

   

3. In AppsFlyer, go to Audiences. Select an audience, and go to the Connection tab.
4. Click Create new connection. Enter a Connection name.
5. Select Tapjoy.

   Enter the Tapjoy Partner ID and Publisher Reporting API Key.

6. Select a Tapjoy list type: 
   • Retarget
   • Denylist
   • App suppression
7. Enter the Tapjoy app ID and Tapjoy offer ID as needed. 
8. Click Add connection.

Prerequisite:

• You need TikTok ad account permissions of either a TikTok for Business account owner, admin, or ad account operator. 

To connect an audience to TikTok:

1. Get the TikTok for Business login credentials from your TikTok account manager.
2. In AppsFlyer, go to Audiences > Connection.
3. Click Create new connection.
4. Enter a Connection name.
5. Select TikTok.
6. Click Log in to TikTok for Business.
   The TikTok for Business for developers window opens.
7. In TikTok for Business, select an authorized account.
8. Click Agree to Authorize. 
   After a few seconds, the AppsFlyer Audiences window displays.
9. Click Add connection.