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.
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_identifier, ios_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.
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"
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"
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"
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"
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.