Audiences guide

Audiences can be defined using one of the following:

• Create a new ruleset
• Use an existing audience ruleset 
• Import an audience from your other systems by file upload or API 

Define the audience using one of the methods that follow.

HTTP POST 
https://hq1.appsflyer.com/audience-import-api?api_token=
Accept: application/json
Content-Type: application/json
body: {
     "import_key": "EKFH2UMC5PPCU8J7M5QQCBPKIH89E6NCOB7XQFWMC",
     "platform": "android", 
     "devices": [
      "a23416b8-a21a-4051-a62f-5d3cb85e16ed",
      "09a14a6b-cce8-44f3-8f77-62eff8b5aa4f",
      "289da41f-0473-4977-89ae-8fc92234a921"
     ]
}

• The audience is sent by upload to one or more selected partners.
• The audience is updated daily and replicated to the partner. AppsFlyer either sends a new list to the partner or notifies the partner which devices to add/delete. The methodology differs from partner to partner but the end result is the same. 
• The following sending options are available:
  • Send the entire audience list to all connected partners.
  • Split the audience and allocate a portion to each partner.
  • Split the audience and allocate a portion to each partner and a portion to a control group.
• (Optional) Send a copy of split audience groups, to an Amazon S3 bucket. This includes the control group where applicable. Note: This is not the same as defining Amazon S3 as a connected partner.
• Download audience lists: The audience list can be downloaded to a CSV file. You can use the CSV file, for example, to send to partners who are not integrated with AppsFlyer. To download the file: In the Audiences window, hover-over Actions, select Download CSV. 

To connect an audience to a partner:

1. In the Audience builder window, select the Connect tab.
   The list of partners displays. 

2. Select a partner.
   The connect to partner window displays.
   

3. Do one of the following:
   • Select Existing Connection.
     --OR --
   • Select Add a new connection and follow the partner-specific instructions for the selected partner. 

4. Select one or more connections for the partner. Selecting multiple connections means that the audience is sent to the partner multiple times. 

5. Click Save Connections.
   The partner is added to the list of partners. 

6. Do one of the following:

   • To select an additional partner, repeat this procedure.

   • Split Audience: To split the audience with optional control groups follow the instructions in the section that follows.
   • Close: The connection is complete. The audience is sent to the partners daily. Note: In this configuration, the entire audience is sent to all connected partners daily. 

Split audience

Split Audience enables advertisers to split the audience from two to ten partners. Each partner is allocated a unique part, by percent, of the audience. When Split Audience is enabled, it means that a user is uploaded to only one partner.

Advertisers split audiences for a variety of reasons like A/B testing, target a user from a single channel, etc.

You can modify split audience configurations after creation, meaning that you can change the allocation between partners, remove, and add partners. Take into consideration that allocation modifications can impact the validity of A/B or other test measurements. For this reason, we display an alert message, before you can make a modification.

Control groups

A portion of the audience can be sent to a control group. The control group is not sent to any partner. Use the control group to compare the behavior of targeted users relative to the control group. 

Send copies of split audience lists to S3 

CSV files containing the split audience lists and control group can be sent to an Amazon S3 bucket. The directory and file name structure is as follows:

• Directory structure: 

   \YYYY-MM-DD\audienceID_audienceName_timestamp\

• Filename: The name of the partner or control group. Note: If the connection to the partner fails, and the file is not uploaded then the parnter_name will have the suffix failed. Example: partner_name_failed.csv 

Creating a split audience configuration and control group

Before you can split the audience:

• Define the audience in the Audiences Build tab.
• Connect your audience to selected partners in the Audiences Connect tab.

To create a split audience configuration:

1. Click Split Audience.
   The Set Audience Percentages window displays.
2. Enable Split audience
3. (option) To enable a control group: Select Enable Control Group 
4. Fill in the audience allocation, in percentage, for each partner and if needed for the control group. 
5. Click Apply.
   The percentage allocated to each partner is displayed. 
   

   

6. (Optional) Send split groups to S3: Sends the audience list in CSV files to an Amazon S3 bucket. (See above for details.) 

7.  Click Close.
   AppsFlyer sends the split audience to the designated partners once a day.

You can modify the split audience allocation as follows:

• Modify the current allocation 
• Remove a partner
• Add a partner

When you modify the allocation between partners, the entire audience is redistributed between the partners. Note that this could impact the validity of A/B or other test measurements. In addition, modification resets the existing audience allocation.

To modify a split audience configuration:

1. Go to Integration > Audiences.
2. Select the audience to be modified.
3. Go to the Connect tab.
   The split audience allocation displays.
4. Select one of the following:

Go to Integration > Audiences to view and manage your Audiences.

In the Audiences window, you can view information about audiences, add an audience, use the actions and bulk actions controls. These features are described here. 

In the Audiences window you can view the following information: 

• Audience name
• Size: number of users in the audience
• App name 
• Upload to: names of partners to whom the audience is sent. 
  • If split audiences are enabled the icon  displays next to the list
  • If a control group is enabled this is indicated by the control group icon. 
• Upload Status has the following indicators:
  
  • Success and the last upload time 
  • Failure, click View Details to see the reason the upload failed

Actions control 

Select an audience Action control to perform one of the following: 

• View history displays the upload history of that audience. Because the audience updates daily, you can view the size differences of the user list throughout its lifecycle:
• Upload now sends the audience to the connected partners
• Download as CSV to download the audience device ID list in a CSV file. There is a separate file for each partner. 

• Duplicate allows you to make a copy of the selected audience definition. (Option) remove one or more of the existing partners. Note: Audience names do not have to be unique. When you duplicate an audience you should give it a unique name. 

• Delete

Bulk actions

The Bulk actions control enables you to carry out the same action on multiple audiences. To use Bulk actions, select two or more audiences and a Bulk action: 

• Upload now sends the audience to the connected partners.
• Show audience overlap: displays the audience overlap between the selected audiences,
• Delete the selected audiences 

1. Obtain your app's API Key from your Aarki account manager.

2. Create a new Aarki integration. The following window opens:

   

3. Paste your API Key in the input bar.
4. Click Add Connection.

1. Obtain your app's API Key from your AdColony Account Manager
2. Create a new AdColony integration. 
3. Enter the API Key.
4. Click Add Connection.

 To connect to Adikteev:

1. Obtain the API Username, API Password, and Company ID from your Adikteev account manager.
2. Click Add a new connection.
3. Complete the fields API username, API Password, and Company ID. 
4. Click Add Connection.
   The connection is created. 

AppsFlyer creates and syncs Traits with your selected DataSource.

1. Log into your Adobe Maketing Cloud dashboard

2. Go to Manage Data > Data Sources

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

3. Set as follows:

   • ID Type to Device Advertising ID,

   • Inbound settings to Customer ID.

     

4. Once saved, you are redirected to the Data Sources selection menu. Find your newly created Data Source, and save its ID for later.
5. In the left-hand menu, select Administration > Groups.

6. Create a new group, and in the permissions settings tab, select the Data Source you previously created:

   

7. Save the group and go to Administration >> Users.

8. Create a new user for AppsFlyer’s Audiences:

   

9. Select the group you previously created in the Assigned Groups selection menu.
10. Copy the Data Source ID, and the Email and Password of the user you previously created.

11. Go to AppsFlyer’s Audiences page, and select Adobe Marketing Cloud. The following window opens:

    

12. Paste the values you copied in their corresponding locations
13. Save the connection.

About 24 hours after uploading your audience to Adobe, you can see the data in your Adobe Marketing Cloud dashboard, under Analytics >> Onboarding Status.

1. Obtain your app’s API Key from your Affle account manager.

2. Create a new Affle integration. The following window opens:

   

3. Paste your API Key in the input bar.
4. Click Add connection.

Creating an S3 integration allows AppsFlyer to send the audience Device IDs directly to your S3 bucket.

1. Create a new Amazon S3 integration. The following window opens:

   

2. Before going through the integration process, you must first create a Policy dedicated to AppsFlyer’s Audience feature.
3. In your AWS console, go to IAM > Policies tab.
4. Click Create Policy and then Create your own policy.
5. Enter the following policy document (this is a suggestion):

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

6. 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 minimal actions on your bucket.

7. After creating your policy, proceed to the next steps:

8. In your AWS Dashboard, go to IAM and click Create a new role:

   

9. Under Role, for cross-account access, select the option Another AWS account to provide access between your AWS account and a 3rd party AWS account.

   

10. Select Require external ID.

    Copy the AccountID and ExternalID provided in AppsFlyer's S3 integration screen. Paste them into the appropriate input boxes in the role's creation screen.

11. You are prompted to select a policy from the existing policies in your AWS account. Choose the policy previously created.
12. Once the new role is created, click the name of the role to open its properties window.

13. Copy the Role ERN.

    

14. Paste the ARN, with your bucket name, into the appropriate box in the AppsFlyer integration window.

    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 provided a folder name that does not already exist, AppsFlyer creates it during the upload process.

    

    Once the integration process is complete and an audience is uploaded, you can see a CSV file with the Device IDs in the bucket specified.

1. Obtain your API Key from your Applift account manager.

2. Create a new Applift integration. The following window opens:

   

3. Enter your DataLift 360 Advertiser email (your login email to DataLift 360’s dashboard) the API Key you've just copied.
4. Click Add Connection to complete the connection.
5. After uploading an Audience to AppLift, you will see it in your DataLift 360’s Audiences dashboard (https://applift.datalift360.com/audiences).

1. Obtain your Custom Audience Key from your Applovin advertiser’s account page.

   

2. Create a new Applovin integration. The following window opens:

   

3. Paste your Custom Audience Key in the input bar.
4. Click Add Connection.

1. Obtain your app’s API Key from your Appreciate account manager.
2. Obtain your buyerId from your Appreciate account manager.
3. Create a new Appreciate integration, you will see the following screen:
   

   

4. Paste your buyerId and API Key in the input bar, click Add Connection.

1. Obtain your Buzzkey from Beeswax
2. Obtain your Account ID from Beeswax

3. Create a new Beeswax integration. The following window opens:

   

4. Complete all the necessary fields - email, password, Buzzkey and Account ID.
5. Click Add Connection

1. Obtain your app’s API Key from your Beintoo account manager.

2. Create a new Beintoo integration. The following window opens:

   

3. Paste your API Key in the input bar.
4. Click Add connection.

1. Obtain your Chartboost User ID and User Signature from your Chartboost account dashboard.

2. Create a new Chartboost integration. The following window opens:

   

3. Paste your User ID and User Signature in the input bar.
4. Click Add connection.

1. Obtain your Criteo Advertiser ID.

2. Create an API User in your Criteo dashboard -

   Criteo Marketing API

3. Copy the API User’s Client ID and Secret, provided to you after its creation.

4. Create a new Criteo integration. The following window opens:

   

5. Paste your API User’s Client ID and Client Secret, along with your Advertiser ID in the input bar.
6. Click Add Connection.

1. Obtain your API Key from your Downstream.ai account manager.

2. Create a new Downstream.ai integration. The following window opens:

   

3. Paste your API Key in the input bar.
4. Click Add connection.

1. Create an Ad Account on Facebook

2. Select Facebook in AppsFlyer’s Audiences integrations page. The following window opens:

   

3. Login to your Facebook account and select the required Ad Account.

After uploading an Audience to Facebook, it appears in your Facebook’s Custom Audiences dashboard.

1. Select Httpool in AppsFlyer’s Audiences integrations page. You will see the following screen:
   
   

   

2. Login to your Httpool account. You then see a new timestamp:
   
   

   

3. Click Add Connection.

1. Obtain your app's API Key from your GetLoyal account manager.

2. Create a new GetLoyal integration. The following window opens:

   

3. Enter your API Key in the input bar.
4. Click Add Connection.

1. Obtain your app's Property ID from InMobi's dashboard.
2. Under the Monetize tab, select your app and copy the Property ID displayed at the top of the screen:

   

3. Create a new InMobi integration. The following window opens:

   

4. Paste your Property ID in the input bar.
5. Select the DST LIST Type you want and click Add.

1. Obtain your API Key from IronSource's dashboard.
2. On the top right-hand side, click your account email.
3. From the dropdown menu select My Account.
4. In the Account window, under Reporting API tab, copy the Secret Key:

   

5. Create a new ironSource integration. The following window opens:

   

6. Enter your IronSource User ID (your email address, specified on the top right-hand side of the IronSource dashboard), and the API Key you just copied.
7. Click Add to complete the connection.

1. Obtain the following from your Jampp account manager:
   • Client ID
   • Client secret
   • App ID
2. Create a new Jampp integration. The following window opens:

   

3. Paste the client ID, client secret and app ID in the relevant fields.
4. Click Add Connection.

1. Obtain your app’s API Key from your Lemmonet Account Manager.
2. Create a new Lemmonet integration. The following window opens:

   

3. Paste your API Key in the input bar.
4. Click Add connection.

1. Obtain your app’s API Key from your Liftoff Account Manager.
2. Create a new Liftoff integration. The following window opens:

   

3. Paste your API Key in the input bar.
4. Click Add connection.

1. Obtain your app's API Key from your Manage Account Manager.
2. Create a new Manage integration. The following screen opens:

   

3. Paste your API Key in the input bar.
4. Click Add Connection.

1. Request your MediaSmart account manager to provide you with an Organization ID.
2. Create a new MediatSmart integration.
   The window opens.
3. In the organizationid field, paste the Organization ID you received from MediaSmart.
4. Click Add Connection.

1. Obtain your app’s API Key from your Mobusi account manager.

2. Create a new Mobusi integration. The following window opens:

   

3. Paste your API Key in the input bar.
4. Click Add connection.

1. Obtain your app’s API Key and Advertiser ID from your Mobvista account manager.

2. Create a new Mobvista integration. The following window opens:

   

3. Paste your API Key and Advertiser ID in the input bar.
4. Click Add connection.

1. Select MyTarget in AppsFlyer’s Audiences integrations page. The following window opens:
2. Login to your MyTarget account, and select your ad account.
3. Click Add Connection.

After uploading an Audience to MyTarget, it appears in your MyTarget’s Users Lists dashboard.

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

1. Obtain your app’s API Key from your Persona.ly account manager.
2. Select Persona.ly in AppsFlyer’s Audiences integrations page. The following window opens:
   
   

   

3. Paste the API key.
4. Click Add Connection.

1. Select PushSpring in AppsFlyer’s Audiences integrations page. The following window opens:

   

2. Click Login with PushSpring and complete the login process. Once you've logged in, a new timestamp is displayed.

   

3. Click Add Connection.

After uploading an Audience to PushSpring, it appears in your PushSpring’s Imported Audiences dashboard.

1. Obtain your Access Key Id from your Remerge account manager.
2. Obtain your Secret Access Key from your Remerge account manager.
3. Obtain the Path from your Remerge account manager.
4. Select Remerge in AppsFlyer Audiences integrations page
   

5. Paste your Access Key Id, Secret Access Key and the Path in the relevant fields.

6. Click Add Connection.

1. Obtain your app API Key from your RTBHouse account manager.
2. Select RTBhouse in AppsFlyer Audiences integrations page. The following window opens:
   

3. Paste your API Key in the Your API Key field.

4. Click Add Connection.

1. Create SFTP access credentials which include Server IP, Username, and Password.
2. Create a new SFTP connection. The following window opens:

   

3. Enter the SFTP credentials.
4. 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.

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

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

1. Create a new Slack integration. The following window opens:

   

2. Click Add to Slack button. You are redirected to an authentication screen, where you pick your relevant Slack Team.
3. Once the Slack Team is selected, select your public Channel.
4. Click Add.

Once the integration process is complete, and an audience has been uploaded, you can see a CSV file with the Device IDs downloaded to the selected channel.

1. Create a new Smadex integration. The following window opens:

   

2. Login to your Smadex account and authorize AppsFlyer to access your account.
3. Click Add Connection.

1. Select Snapchatin AppsFlyer’s Audiences integrations page. The following window opens:

   

2. Login to your SnapChat account.
3. Select your Organization and Ad Account.

   

4. Click Add Connection.

24 hours after uploading an Audience to Snapchat, it can be seen in the dashboard.

1. Obtain your app's API Token from your StartApp account manager.

2. Create a new StartApp integration. The following window opens:

   

3. Paste your API Token in the input bar.
4. Click Add Connection.

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

   

3. Create a new Tapjoy integration. The following window opens:
   
4. Paste your Tapjoy Partner ID and Publisher Reporting API Key in the input bar.
5. Click Add.

1. Obtain your app’s API Key from your Taptica Account Manager.
2. Create a new Taptica integration. The following window opens:

   

3. Paste your API Key in the input bar.
4. Click Add connection.

1. Create an Ad Account on Yahoo Gemini
2. Select Verizon Media in AppsFlyer’s Audiences Integrations page. The following window opens:

   

3. Login to your Yahoo account, and select your desired Ad Account.

After uploading an Audience to Verizon Media, you can view it in your Verizon Media dashboard.