App lists are collections of Chartboost app IDs you can use to exclude (but not target) low-performing or unwanted games from your campaigns. (To brush up on how to identify low-performing games, visit our app filtering page). (Note: App lists are optional.) To create one, start by heading to the app list builder, then:

• Enter a name for the list and pick iOS, Android, or Amazon from the Platform dropdown. You’ll need to create separate app lists for each platform.
• Click Choose File in the Select File field to upload your list. App lists must have a .csv extension, contain fewer than 800 app IDs, and should contain nothing but a single list of app IDs separated by line breaks. (We recommend using Excel or other spreadsheet editor to export your single column of IDs in .csv form.)
• Hit Save, and you’re done – you’ll see your new list appear in the page’s lower section

To overwrite ², edit the name of, or delete an app list from your account, just click one of the three icons in the list’s Actions column:

Using App Lists

Once you’ve created an app list, you can apply it to your campaigns via the Edit Campaign page’s App Filtering tab:

After clicking the name of your app list, you’ll see its entries populate in the same section, after which you can add/remove apps as needed.

Notes

1. Excel has a 1 million row limitation, but you can create a text-based CSV (or use our API) if you need to add additional devices to your list

2. Uploading a new file to an existing list will replace the original list

3. Downloads stop working after 7 days

4. You cannot delete lists that are currently used in active campaigns

Last Updated on April 6, 2020

‍