App Card

Updated on Wed, 2013-07-31 22:50

App Card is a great way to better represent mobile applications on Twitter and to drive installs. We designed the App Card to allow for a name, description and icon, and also to highlight attributes such as the rating and the price. This will require adding some new markup tags to your pages, which we will cover in this document. This Card type is currently only available on the iOS and Android mobile clients. It is not yet available on web or mobile web.

This Card is unique, as we use each of the respective app stores to proxy the pertinent Card data. The App Card is great for things like your homepage, or your /about page. All you need to do is specify the Card type, and each of the corresponding App IDs to the respective app stores so that we can proxy the rest for you (# of reviews, # of stars for the app, etc.). You also can optionally specify a more concise description of your app.

Special treatment for App Store and Google Play links

Twitter auto-creates App Cards for Tweets which contain a link to either the App Store or Google Play. This means that you can create an App Card experience just by sharing links directly to the download page for your application.

Mobile

Define the App Card with these properties:

Card Property Description Required
twitter:card Must be set to a value of "app" Yes
twitter:description You can use this as a more concise description than what you may have on the app store. This field has a maximum of 200 characters. No
twitter:app:id:iphone String value, and should be the numeric representation of your app ID in the App Store (.i.e. "307234931"). Yes
twitter:app:id:ipad String value, should be the numeric representation of your app ID in the App Store (.i.e. "307234931"). Yes
twitter:app:id:googleplay String value, and should be the numeric representation of your app ID in Google Play (.i.e. "com.android.app"). Yes
twitter:app:url:iphone Your app's custom URL scheme (you must include "://" after your scheme name) No
twitter:app:url:ipad Your app's custom URL scheme No
twitter:app:country If your application is not available in the US App Store, you must set this value to the two-letter country code for the App Store that contains your application. No
twitter:app:url:googleplay Your app's custom URL scheme No
  1. <meta name="twitter:card" content="app">
  2. <meta name="twitter:description" content="The perfect for grabbing a nearby taxi. Try it by downloading today.">
  3. <meta name="twitter:app:id:iphone" content="306934135">
  4. <meta name="twitter:app:url:iphone" content="example://action/5149e249222f9e600a7540ef">
  5. <meta name="twitter:app:name:ipad" content="Example App">
  6. <meta name="twitter:app:url:ipad" content="example://action/5149e249222f9e600a7540ef">
  7. <meta name="twitter:app:id:googleplay" content="com.example.app">
  8. <meta name="twitter:app:url:googleplay" content="http://example.com/action/5149e249222f9e600a7540ef">