Audiences guide

Before you begin

Consider the following before you proceed:

• CSV format - The CSV should contain one column and one device ID per row. The CSV should contain no headers. For example:

  d5e97b54-5ded-4570-ad87-fe9b42f18820

  c2595c12-9110-4c09-a80e-34cf6c0caf61

  ae2fbdf8-82f1-46a8-8a84-13d6da7e2c7c

  7a1e87b9-b4c2-4869-a55e-5bf1d1278476

• CSV file size - Each CSV can hold up to 10 million rows. Try to avoid uploading big files.
• After uploading the CSV, wait for a confirmation message that the upload succeeded. Don't close the window before you see this message.

How to import an audience by uploading a CSV file

1. Select Import Audience.
2. If it's a new audience, give it a name and save it.
3. Click CSV Upload.
4. Choose what to do with the imported audience:
   • Add New Devices - add a list of device IDS to an existing audience.
   • Overwrite all existing devices - replace the entire list of device IDs with the uploaded one.
   • Exclude from existing device list - remove specific devices from the list of device IDs.
5. Upload the CSV file that contains the list of device IDs.
6. Wait for a confirmation message. 

Possible messages after uploading the CSV

1. Select Import Audience.
2. Choose the API Action:
   • Add - Add additional device advertising IDs to an existing audience.
   • Remove - Remove a list of device advertising IDs from an existing audience.
   Choosing an API Action only changes the path in the URL endpoint that you copy in step 3. It doesn't persist after you save the audience. When you want to add or remove devices from an audience, you can specify the action in the audience endpoint URL as /add or /remove.
3. Copy the API Request URL - the API token is already included in the URL.
4. Copy the API Request Body.
5. Click on Save Audience and Proceed.
6. (optional) Connect your audience to partners.
7. You can now import the list of device IDs to the newly created audience.

Importing device IDs into the audience

The next step is to send a POST request to the API endpoint with a body that contains the device IDs.

Sample request

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"
         ]
}

Responses

API limitations

• You can only add devices to one audience per request
• You can only remove devices from one audience per request
• Batch requests (multiple audiences) are not supported
• You can send up to 10,000 device IDs per request

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. 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. 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 Oath: Ad Platforms 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 Yahoo Gemini, you can view it in your Oath: Ad Platforms dashboard.