Tutorials / Creating a Mobile App Promotion (MAP) campaign

Creating a Mobile App Promotion (MAP) campaign

Introduction

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.

Requirements

  • 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


Steps


1. Create a campaign

Follow the instructions in Creating a Campaign tutorial which uses the POST /accounts/:account_id/campaigns endpoint.


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.

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


3. Associate the line item with the app

The line item can be associated with the app being advertised by using the POST /accounts/:account_id/line_item_apps endpoint

Example twurl command:

twurl -H ads-api.twitter.com "/5/accounts/:account_id/line_item_apps" -X POST -d "os_type=IOS&app_store_identifier=333903271&line_item_id=:id_for_iOS_line_item"


4. 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 "/5/targeting_criteria/platforms"

{
  "data": [
    {
      "name": "iOS",
      "targeting_type": "PLATFORM",
      "targeting_value": "0"
    },
    {
      "name": "Android",
      "targeting_type": "PLATFORM",
      "targeting_value": "1"
    },
    {
      "name": "BlackBerry phones and tablets",
      "targeting_type": "PLATFORM",
      "targeting_value": "2"
    },
    {
      "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"


5. Create a Video App Card

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


6. 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"


7. 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?

Apply for developer access to get started

  • Read Previous
  • Read Next