Creating a Mobile App Promotion (MAP) campaign


Advertisers can drive installs and re-engagements to mobile apps with Mobile App Promotion (MAP) campaigns. This tutorial will walk through the process of setting up an App install objective campaign.


  • Access Tokens for a Twitter Ads account user with either Ad Manager or Account Admin roles
  • App store identifiers for apps that you would like to set up ads for.
    • Examples for the Twitter app:
      • iOS bundle identifier: 333903271
      • Android package identifier: com.twitter.android


1. Create a campaign

Please reference the Creating a Campaign tutorial or POST /accounts/:account_id/campaigns documentation.

2. Create a line item

Create a line item using the APP_INSTALLS objective, associating it with the campaign ID returned from the previous step and set the mobile app(s) being promoted setting the android_app_store_identifierios_app_store_identifier, or both.

For how to create a line item, please reference the Creating a Campaign tutorial or POST /accounts/:account_id/line_items documentation.

3. Add targeting criteria to appropriately target mobile users for the platform you want to advertise against

For using targeting it is recommended at minimum to use Platform targeting to ensure you are targeting users of the correct platform to drive installs to your app.

This shows the targeting value for iOS is 0

twurl -H ads-api.twitter.com "/7/targeting_criteria/platforms"

  "data": [
      "name": "iOS",
      "targeting_type": "PLATFORM",
      "targeting_value": "0"
      "name": "Android",
      "targeting_type": "PLATFORM",
      "targeting_value": "1"
      "name": "Mobile web on other devices",
      "targeting_type": "PLATFORM",
      "targeting_value": "3"
      "name": "Desktop and laptop computers",
      "targeting_type": "PLATFORM",
      "targeting_value": "4"
  "request": {
    "params": {}

Here we are adding the iOS platform as targeting for this line item:

twurl -H ads-api.twitter.com "/5/accounts/:account_id/targeting_criteria" -X POST -d "targeting_type=PLATFORM&targeting_value=0&line_item_id=:id_for_iOS_line_item"

4. Create a Video App Card

Create a Video App Card as described in the video upload tutorial.

5. Create a Tweet using your Video App Card

If you have not created a Tweet containing the Video App Card from previous step, you can do it either via the POST accounts/:account_id/tweet endpoint or from our Ads UI. Here is an example of creating a tweet with a card:

twurl -H "ads-api.twitter.com" "/5/accounts/:account_id/tweet" -d "nullcast=true&card_uri=card://2119368073444638719&text=MAP Ad"

6. Promote the Tweet

Now you can promote a Tweet by calling the POST accounts/:account_id/promoted_tweets endpoint.

twurl -H "ads-api.twitter.com" "/5/accounts/:account_id/promoted_tweets" -d "line_item_id=:iOS_line_item_id&tweet_ids=:app_card_tweet_id"

Next steps

If you would like to see more options and details about creating mobile app promotion campaigns with the Twitter Ads API, please see the MAP Comprehensive Guide.

Ready to build your solution?

Sign up for developer access to get started