# User Lists Appier campaigns support user lists supplied by advertisers for usage in campaigns. There are two main types of user lists: * **Suppression lists:** a list of users to not target during the campaign. This list is most commonly used in new user campaigns, which is the list is composed of existing users. * **Retargeting lists:** a list of users to retarget exclusively during the campaign. This kind of list is mostly commonly used in retargeting campaigns, where the advertiser want to only retarget users that meet certain criteria. Users are represented with a specific device ID. On iOS, this is called IDFA, and on Android, this is called GAID. A user list is a document where each row contains a device ID, representing a single user. There are multiple ways that user lists can be transmitted to Appier. Below are the most use cases. *** ## AppsFlyer Audiences AppsFlyer Audience is a tool for AppsFlyer clients, which allows the creation of user segments and automates the transfer to partners such as Appier. {% hint style="info" %} Audiences is a AppsFlyers **premium feature**. For the most up-to-date reference on AppsFlyer Audiences, please refer to AppsFlyer's [official documentation](https://support.appsflyer.com/hc/en-us/articles/115002689186-Audiences-guide). {% endhint %} ### Setup Flow #### 1. Set up your app's policy for sharing user identifiers. 1. In AppsFlyer, from the side menu, select **Engage** > **Audiences**. 2. In order to make sure that Appier can receive the user list, please make sure that IDFA and GAID are enabled on the user identifier policy page. For iOS, do not set the policy to "Never upload."
#### 2. Create your AppsFlyer audience with [this guide](https://support.appsflyer.com/hc/en-us/articles/115002689186#create-a-custom-audience). #### 3. Add Appier as an Audiences partner. 1. First ask your contact window at Appier to provide an AppsFlyer Audiences API token. 2. On the Audiences page, select "New Connection". 3. Select Appier as the partner.
4. Insert the API token given to you by Appier.
#### 4. Connect your Audience to Appier. 1. Find the page for your audience created in step 2. 2. Select "Add partner connection." 3. Select "Appier" and then save. *** ## Adjust Audiences The Adjust Audiences feature allows advertisers to build dynamic user segments directly within the Adjust dashboard and share them with partners such as Appier for suppression or retargeting purposes. Adjust Audiences automatically update based on the segmentation logic you define (e.g., install date, in-app events, revenue behavior, device type, geographic filters). {% hint style="info" %} Relevant [**Adjust official document**](https://help.adjust.com/ko/article/audiences) For the most up-to-date reference on Adjust Audiences, please refer to Adjust's [official documentation](https://help.adjust.com/en/article/audiences). {% endhint %} ### Setup Flow #### 1. Enable Audiences in Adjust * Ensure the **Audiences** feature is enabled for your Adjust account. * If the feature is not visible, contact your Adjust representative to activate it. #### 2. Create an Audience in Adjust 1. Log in to the Adjust dashboard. 2. Navigate to **Campaign Lab → Audiences**. 3. Click **New Audience**. 4. Follow the **Steps**
5. For **Step 1 (Basic Settings)** select **Advertising ID**. 6. For **Step 3 (Conditions)** - define your segmentation rules based on your desired logic. (i.e. In-app events, Install or reattribution date, Gegraphic filters, etc) 7. Save and generate the audience. 8. After finishing all the steps, copy the URL and share with Appier.
{% hint style="warning" %} #### NOTE Ensure the exported identifiers match **Appier’s accepted formats** * **Unencoded IDFA/GAID** * **SHA1 of upper-case IDFA/GAID** * **SHA256 of upper-case IDFA/GAID** * **SHA256 of lower-case IDFA/GAID** {% endhint %} *** ## Singular Audiences Singular supports audience segmentation and automated distribution to advertising partners such as Appier for targeting and suppression use cases. Singular audiences can be built using attribution data, event behavior, revenue signals, and device identifiers. {% hint style="info" %} Relevant [**Singular official document**](https://support.singular.net/hc/en-us/articles/360025454492-Audiences-FAQ) For the most up-to-date reference on Singular Audiences, please refer to Singular's [official documentation](https://support.singular.net/hc/en-us/articles/360025454492-Audiences-FAQ). {% endhint %} ### Setup Flow #### 1. Create an Audience in Singular 1. Log in to the Singular dashboard. 2. Navigate to **Audiences** or **Segment Builder**. 3. Define segmentation rules based on: * App events * Attribution source * Revenue activity * Retention behavior 4. Save the audience segment. {% hint style="warning" %} #### NOTE Ensure the exported identifiers match **Appier’s accepted formats** * **Unencoded IDFA/GAID** * **SHA1 of upper-case IDFA/GAID** * **SHA256 of upper-case IDFA/GAID** * **SHA256 of lower-case IDFA/GAID** {% endhint %} #### 2. Audience Synchronization * Confirm distribution frequency (real-time, daily batch, or scheduled). * Validate that device IDs are correctly formatted. * Coordinate with your Appier representative for ingestion confirmation. *** ## Other User Lists For other user lists, please supply a URL to Appier that links to a file with the list of users. The list of users should have the following format: * First row is a header row * Each row after that represents one user {% hint style="warning" %} #### Appier can support the following user identifier formats * **Unencoded IDFA/GAID** * **SHA1 of upper-case IDFA/GAID** * **SHA256 of upper-case IDFA/GAID** * **SHA256 of lower-case IDFA/GAID** {% endhint %} ## Alternatives Options (i.e. S3) If you need support for other options to uploading user lists to Appier, please reach out to your contact window at Appier for further support.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.adcloud.appier.com/user-lists.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.