Setting up App Cards

App Cards are a specialized format to help users see your app in an engaging, media-rich way. You can create video or image App Cards in your Twitter Ads account. 


Creating an App Card

  1. Log into your Twitter Ads account
  2. Navigate to Creatives > Cards
  3. Select either image or video, depending on which format you want to create
  4. Build your card:
    1. Add your video or image according to our required specs
    2. Choose your primary app store territory
    3. Select your call-to-action
    4. Choose your app. Your app must already be in your App Manager
    5. Name your card. This name will not be visible in your final Tweet
  5. Click "Create"
  6. After you've created your app card, it will show in your cards library
  7. From your card library, select your card and create a Tweet!

Tweeting your App Card

After you created your card, you must add it to a Tweet in order to use it in a campaign. They are not complete ad units on their own. 

  1. Navigate to Creatives > Cards
  2. Filter to "App Cards" in the top right corner
  3. Select image or video, depending on which card type you want to use
  4. Hover over your selected App Card to display the action buttons
  5. Choose the "Tweet" button 
  6. This will bring you to the Tweet composer. Here you can enter the copy you want in your Tweet and a preview of how your card will appear
  7. Click "Tweet"!

Once you've created your Tweet with your App Card, you can add the Tweet to your campaigns.

Please note that all four versions of the App Card will only render on mobile, not desktop.


Frequently asked questions

What should I set for my primary app store territory?

This is the primary territory in which your app is available. We use this information to verify your App ID.

If you're not sure what the primary territory for your app is, try selecting the United States. 

If you're outside of the US, set your territory to wherever your app was first available in. This will not limit where you can target your ad. App IDs can be the same for multiple countries as long as that version of your app is available in that country.

What is a deep link?

A deep link scheme is analogous to a domain for a website, except it allows users to launch an app and serves as the base scheme for full deep links (see below). For example, try typing twitter:// in your mobile web browser and hitting “Go.” If you have the Twitter app installed, it will open the app on your phone.

In the context of an App Card on iOS, adding deep link schemes to your card configuration allows Twitter to recognize if an app is installed and enable users to directly open the app from Twitter. Of course, if the app is not installed, the App Card will send the user to the App Store, where they can proceed to download the app.

A deep link scheme is also required to enable "Install Notifications" on iOS. Install notifications are prompts that occur on Twitter once an app is fully downloaded and are designed to drive activation of your app.

To get your app's deep link scheme:

For iOS

In order for your app to respond to open URL requests correctly, you’ll need to add a URL scheme into your app’s.plist file. Common patterns for naming this scheme include reverse-DNS, or simply myappname://.

Look for the URL types section in your app’s .plist file. If it doesn’t exist, you can add it yourself. If you haven’t already edited URL types, it should be an array with a single item, a dictionary with the key “URL Identifier”. Click the + button associated with the dictionary to add a “URL Schemes” section, which is another array, and add your scheme to this array. You can add as many custom schemes as you like. More information can be found here.

In your app delegate, you can add logic to the application:openURL:sourceApplication:annotation:method to take in the incoming URL (the one you specified in the card) and parse it within your app.

For Android

Deep-link information is passed to your app as part of the intent data. You can add an intent filter to the relevant receiving activities in your app. The intent filter might look something like this:

  1. @string/filter_title_viewcardcontent”>

  2.        <action android:name=”android.intent.action.VIEW” />

  3.        <category android:name=”android.intent.category.DEFAULT” />

  4.        <category android:name=”android.intent.category.BROWSABLE” />

  5.        <!— Accepts URIs that begin with “example://action” —>

  6.        <data android:scheme=”example”

  7.              android:host=”action” />

  8.    </intent-filter>

A more complete explanation can be found in Google’s developer docs.

What are the specs for App Cards?

We offer 4 types of App Cards: 

  • 1:1 Image App Card
  • 1.91:1 Image App Card
  • 16:9 Video App Card
  • 1:1 Video App Card

To see specific specs for each, read our specifications page

What are the creative best practices for App Cards?

Image App Card

  • Use vibrant colors to make the image stand out
  • Don't cram too much into a small space
  • Include a preview of what someone can expect in your app
  • Don't use overly branded imagery with just company logos
  • Include an app store and play store logo if space permits

Video App Card

  • Include visual cues and don't rely on audio
  • Include a card in the beginning and end of the video that shows the app or play store logos and a visual CTA to download your app
  • Make it clear that the video revolves around an app
  • Don't re-purpose branded video, make sure it's app-focused
  • Show the interface/usability/what someone what to expect within the app
  • Keep the video between 6-15 seconds

For more optimization tips and creative suggestions, check out our app installs or app re-engagements optimization page. 



Additional reading

Ready to get started?