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

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 being promoted setting either android_app_store_identifier or ios_app_store_identifier.

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

3. Create a Video App Card

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

4. 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" "/9/accounts/:account_id/tweet" -d "nullcast=true&card_uri=card://2119368073444638719&text=MAP Ad"

5. 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" "/9/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?

Apply for developer access to get started