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.

18. Select a specific audience > Connect tab.

19. Click + New connection.
20. Enter a connection name.

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

22. Complete the fields using the credentials previously recorded.
23. Click Save.
    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, and select an audience.
2. Click the Connect tab.

3. Click + New connection.

4. Enter a Connection name.

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

   

6. Enter the Cross-account role ARN, Bucket name, and Region name.
   Note: It's recommended to always enter the Region name. If the Region name is not automatically enabled by default on AWS, it must be entered here or the connection can't be created. To find the region on the AWS console home page, click the country dropdown on the upper right of the page, and the regions will display.
7. Record the Account ID and External ID for later use.
8. In the AWS console, go to IAM > Policies.
9. Click Create Policy.
10. Click JSON.
11. Paste the following policy snippet into the JSON window.
    

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

12. 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.

13. Click Review policy.
14. Enter a policy Name.
15. Click Create policy.

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

    

17. Click Create role.

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

    

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

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

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

    

23. Record the Role ARN.

24. 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.

25. 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];

USING THE CUID FIELD

There is no need to configure a dedicated parameter for the Braze External ID if:

• You have configured the SDK to send AppsFlyer a CUID for each user
• The CUID has the same value as the Braze External ID

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 + New connction.
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 Audiences 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 > Connections.
4. Click + 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 Save.

Note: If adding a connection is impossible because the relevant app is grayed out with the message “Already granted”, go to https://consent.criteo.com, revoke the connection and try again.

Prerequisite:

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

To connect Audiences to Facebook:

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

Note: If you receive an error that prevents you from creating ads from the advertising account, please make sure you’ve accepted the Meta Custom Audience Terms Of Service.

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)
  • 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.	Account user 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.	Account user

To connect an audience to Google Ads:

1. In AppsFlyer, go to Audiences, select an audience.
2. Go to the Connect tab. 
3. Click + Partner 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 an admin: If you agree to the terms, click I accept.
11. If you are not an admin: 
    1. Click Proceed and review later.
    2. Ask an admin to login to accept the terms. Use the procedure that follows to do so. 
12. Click Save.
    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, an admin performs the following procedure:

1. In AppsFlyer, go to Audiences.
2. Go to Connections 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 Audiences to Httpool:

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

To create a partner connection to Leanplum:

1. In your Leanplum account, navigate to Partner Integrations > AppsFlyer. Under Audiences, generate a new Secret.

   

2. Choose whether profiles should be created in Leanplum for Non-existing users.
   • Non-existing user = a user whose user ID as sent by AppsFlyer Audiences doesn't exist in Leanplum
3. Copy the App ID and the newly generated Secret to use when configuring the connection in the AppsFlyer dashboard.
4. In AppsFlyer Audiences, go to the Connections tab and click + New connection.
5. Select Leanplum as the partner and give the connection a name.
6. Enter the App ID and the Secret you copied from your Leanplum account in step 3.

   

7. Save the connection and it will be available to link to any new or existing audience.

Within up to 30 minutes, the audience and the users in it will be populated in your Audiences dashboard in Leanplum.

• Audiences synced to Leanplum from AppsFlyer will display the prefix "APPSFLYER:" in the Leanplum dashboard.

To create a partner connection to MoEngage:

1. Login to your MoEngage dashboard and navigate to Settings > APIs > General Settings.
2. From the Data API Settings section, copy these keys to use when configuring the connection in AppsFlyer Audiences:
   • Data API ID ( in the image below)
   • Data API Key ( in the image below)

   

3. In the address bar of your web browser, check the URL of your MoEngage dashboard to obtain the number of your MoEngage Data Center:
   • If the URL of your MoEngage dashboard is https://dashboard-01.moengage.com, your account is assigned to Data Center 1.
   • If the URL is https://dashboard-02.moengage.com, your account is assigned to Data Center 2.
   • If the URL is https://dashboard-03.moengage.com, your account is assigned to Data Center 3.
4. In AppsFlyer Audiences, go to the Connections tab and click + New connection.
5. Select MoEngage as the partner and give the connection a name.

   

6. Enter the Data API ID and the Data API Key you copied from your MoEngage account in step 2.
7. Select your MoEngage Data Center as determined in step 3.
8. Save the connection and it will be available to link to any new or existing audience.

Audiences synced to MoEngage from AppsFlyer will be available as custom segments in your MoEngage dashboard.

To connect Audiences to MyTarget:

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

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 Audiences to to PushSpring:

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

To connect Audiences to to SFTP:

1. In SFTP, create access credentials which include Server IP, Username, and Password.
2. In AppsFlyer, go to Audiences > Connections tab.
3. Click + 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 Save.

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

To connect Audiences to to Slack:

1. In AppsFlyer, go to Audiences > Connections tab.
2. Click + New connection. 
3. Enter a Connection name.
4. Select Slack.
5. Click Add to Slack.
6. On the Slack authentication screen, select your relevant Slack Team.
7. Select a public Channel.
8. Click Save.
   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 Audiences to to Snapchat

1. In AppsFlyer, go to Audiences > Connections tab.
2. Click + New connection. 
3. Enter a Connection name.
4. Select Snapchat.
5. Click Log in to Snapchat.
6. Select your Organization and Ad account.
7. Click Save.
   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 Connect tab.
4. Click + Partner connection. 
5. Enter a Connection name.
6. Select Tapjoy.

   Enter the Tapjoy Partner ID and Publisher Reporting API Key.

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

Prerequisite:

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

To connect Audiences to TikTok:

1. Get the TikTok for Business login credentials from your TikTok account manager.
2. In AppsFlyer, go to Audiences > Connections tab.
3. Click + 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 Save.