Setting up App Cards


  • What is an App Card?
    Arrow down icon

    Twitter Cards allow you to go beyond 280 characters by adding engaging media experiences to your Tweets. The App Card is one of these experiences.

    Adding an App Card to your Tweet enables you to feature media rich information about your app, such as an image, ratings and a call to action:

    This added media is designed to improve the rate at which users engage with your Tweet.

  • How can I create an App Card?
    Arrow down icon

    To create an App Card, log into your advertiser account by visiting and navigate to the Cards section in the Creatives drop down.


    From here, select either the Basic or Image App Card and click the “Create Your First App Card” button to begin.

    You will then be asked to enter the details of your Card.

  • Video App Card
    Arrow down icon

    Advertisers can now use the power of video to promote their mobile apps on Twitter. Creating a Video App Card for your campaigns enables you to feature rich videos from and about your app to the Twitter audience.

    To create a Video App Card

    1. Log into your advertiser account by visiting
    2. If your video is not uploaded yet, navigate to the Videos section in the Creatives drop down and upload your video within that section.

    Once your video has been uploaded you have two options:

    1. Navigate to the Cards section in the Creatives drop down. Select the Video App option and click the “Create Your First Video App Card” button to begin. After choosing Video App Card, you will be prompted to enter the details of your card. Please see the “Card Content” section for further guidelines on each section. On the card setup page, you will also have the ability to attach a video to the Video App Card. Before you can attach a video, you’ll need to upload it to your video library.

    Create a new “app installs or re-engagements” campaign. Select “Video App Card” from the “Card type” drop down in the Compose Tweets section of the campaign form. From there, enter the details of your card.

  • Card content
    Arrow down icon

    Primary App Store Territory

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

    App Store Territory for Image App Cards

    When setting up Image App Cards, it is not necessary to set up a card for each country you want to target. The card can be set up once, using United States as the country and the card will work for any and all countries you target where the app is available. The only time you need to specify a country for the Image App Card is if the app is not available in the United States. In that case, all that is needed is to select a country where your app is available to verify your app id.

    App Store Territory for Basic App Cards

    Since the Basic App Cards pull the app’s description directly from the App Store, Basic App Cards need to be set up with different countries if the desire is to change the language of the card based on the country chosen.

    iPhone, iPad and Android App IDs

    For iPhone and iPad, this number is usually numeric and can be located in your App Store URL. For example, the App ID for the Vine App is highlighted in bold:

    Similar to iPhone, the Android App ID can be found from within the Google Play Store URL. For example, the App ID for the Vine App on Android is highlighted in bold:

  • Deep link Scheme

    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.

  • Finding your App’s deep link scheme will require communication with your developer team, as the information is located within the Apps source code and is likely only available to Engineers on your team.

    On iPhone, the deep link scheme is located in the info.plist file under URL Types. On Android, deep link information is passed to your app as part of the Intent data.  

    Full deep link

    A full deep link is analogous to a complete URL for a website, except it allows users to be linked directly into a specific place in your App.  For example, try typing twitter://account in your mobile web browser and hitting “Go.” If you have the Twitter app installed, it will open the App on your phone and take you to the Me account tab.

    App Card image (Image App Card only)

    Attach an image to have your App Card display with a large image.  

  • Advanced settings (basic App Card only)
    Arrow down icon

    Custom Icon

    Adding a custom icon allows you to replace the default icon from the app store with your custom icon.

    Custom App Description

    Adding a custom app description allows you to replace the default description from the app store with your custom description.

  • Frequently Asked Questions
    Arrow down icon

    How do I Tweet an App Card?

    After creating the Card, select the Compose Tweet With This Card button in the Cards dashboard next to the Card you’d like to Tweet. You can also include the URL of the Card in any Tweet and the Card will be rendered.

    How do I get my app’s deep link?

    It is different depending on iOS or Android.

    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. A more detailed tutorial 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 filterto 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 the image in the App Card?

    The image specifications for the App Card are presented in the Card creator UI when setting up the card. 

    How are advertisers charged for this ad format within promoted campaigns?

    Advertisers are charged on ‘app clicks’ - any click that leads a user to the App Store or Google Play, or opens the app directly.

    Will it work on mobile and desktop?

    The App Card will only render on Mobile.

    What is the benefit of using an App Card?

    With rich media, the App Card is more engaging to users and often results in a higher click through rate.

Did we help answer your question?

The maximum length for this field is 5000 characters.
Thanks for submitting feedback on this article!
Problem sending form.

Visit Twitter Ads