The Steps Using Ads API to Create A App Install Campaign

[wenping.wang]

We just want to check the steps to create a App install campaign.
Would you please have a check of the steps?

Step1: Add a app to app list.

Call POST accounts/:account_id/app_lists .

Step2: Create a (image or video) app card with the app added at Step1.

Call POST accounts/:account_id/cards/image(video)_app_download api with specifying
ipad_app_id/iphone_app_id/googleplay_app_id as app_store_identifiers
which is also need to be specified when using POST accounts/:account_id/app_lists api.

Step3: Create a tweet with the app card created at Step2.

Step4: Create a campaign with the tweet.

In the creation, call GET accounts/:account_id/app_lists to get the apps for promotion app selection.

Step5: To set up mobile app conversion tracking, create an account with mobile measurement partners.

[juanshishido]

Thanks for the question, @wenping.wang.

Creating an app install campaign is similar to creating a Tweet engagements campaign.

1. Create an app card.
2. Associate the card with the Tweet.
3. Create a campaign.
   • Create the line item with the objective set to APP_INSTALLS.
   • Associate the Tweet with the line item.
   • Add targeting.

The app that you promote is determined by step 1. In the app card create step, you specify an app.

---

The POST accounts/:account_id/app_lists endpoint is used to create lists of apps which will later be excluded in the targeting criteria step. This is used to prevent ads from being shown in apps when and only when the ad is being promoted on the Twitter Audience Platform.

[wenping.wang]

@juanshishido
Thanks for the reply.

As you said, The POST accounts/:account_id/app_lists endpoint is not for adding apps just like Manage apps at ads.twitter.com,

so which api could be used to add apps for creating
a app card or a app install campaign?

POST accounts/:account_id/app_lists

[JBabichJapan]

Hi @wenping.wang

The only way to retrieve apps would be if the account has them set up for Conversion Tracking with a Mobile Application Conversion Tracking partner. In those cases, the apps (actually the conversion information for the apps) would be available via App Event Tags endpoint. The app lists endpoint has no guarantee of having the relevant apps either. The API for retrieving the App icon and App name unfortunately is not possible for us to provide (because it’s coming directly from the platform of Apple or Google). From an API standpoint, all you need to do is pass in the App ID, so many partners simply have a free form text field to place it (but this can be prone to manual entry mistakes).

If part of the confusion is about what happens when you CREATE a campaign (because the apps also appear there), that app association is essentially similar to calling POST line_item_apps endpoint, but this is actually not necessary for normal Twitter timeline campaigns (it’s only necessary for TAP campaigns).