App Card Composer Usage Guidelines¶
The App Card Composer in Twitter Kit allows a user of your application to post Tweets with an App Card attached, displaying media with a prominent call-to-action to install your application.
The App Card Composer functionality is provided strictly for the purpose of sharing user-centric media, that is media created by the user, or directly expressing a user’s activity and progress in the app or game. As such you must read and adhere to these usage guidelines, and then request your application be whitelisted to post App Cards.
Read the following guidelines to determine if your use case is appropriate for the App Card Composer and if so, apply to add the permission to your app. These guidelines are additional to the requirements of the Developer Agreement and Developer Policy.
The App Card must include user media. This may be media that is the direct product a user’s use of the application, or a representation of the user’s unique state in the app. For example:
- A map showing a metropolis built by the player in a city simulator.
- An image summarizing a player’s level, stats and quest progress after levelling up in an RPG.
- A screenshot of a player’s garden in a domesticated animal collection game.
- A visualisation of the end-of-season performance stats for the player’s team in a incomprehensibly-engrossing football management simulation.
- A highlight image of the moment a well-aimed turtle shell displaced the leader in an arcade karting game.
- An image representing a player unlocking an achievement in an adventure game, including unique content (e.g. the player’s score, or their personalized character.)
- An image generated by the user’s use of the application: e.g. an annotated image, or a text snippet highlight.
An App Card may be Tweeted only at the user’s direction, using the Twitter Kit composer interface. App Cards must not be submitted to the API automatically or without the user seeing the card preview.
App Cards must not contain media not created by the user or not unique to the user’s behaviour in the app. Including such in App Cards may result in Tweets from your app being flagged as spam, and may result in the App Card Composer privilege being revoked or your application being suspended.
Example uses that are inappropriate for App Cards:
- Purely promotional imagery, or a banner ad for your company, app, game or other products.
- The logo of the game or app as primary subject of the image (logo watermarks in the corner of generated images are OK, up to ~⅕ the size of the image).
- Generic representations of an application event, such as an “Achievement Unlocked” trophy image with no information about the player.
Also remember that App Cards are not presented in all Tweet displays and applications, and are not available through the Twitter REST API. Imagery that would be considered primary content for the Tweet may not be appropriate in an App Card, depending on your use case. In cases where an image is essential to the meaning of the Tweet, we recommend posting a conventional Tweet with an attached image.
If you have questions about the App Card Composer, please join the discussion on the Twitter forum.