{"__v":0,"_id":"58b8bfeefd96650f002e266e","category":{"__v":6,"_id":"561c7260cd5e7b0d00eb48c6","pages":["561c774b92a66f0d00987915","561c7c46be5c860d007bc1cd","561c7c6e2764990d00f546c4","561c7cc72764990d00f546c6","561dc41143c36d0d00da7798","563a920c0ed6332300378872"],"project":"561c70aabe5fb20d00077758","version":"561c70aabe5fb20d0007775b","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-13T02:54:24.912Z","from_sync":false,"order":1,"slug":"messaging","title":"Messaging"},"parentDoc":null,"project":"561c70aabe5fb20d00077758","user":"5825dece55b1060f00ec4134","version":{"__v":6,"_id":"561c70aabe5fb20d0007775b","project":"561c70aabe5fb20d00077758","createdAt":"2015-10-13T02:47:06.824Z","releaseDate":"2015-10-13T02:47:06.824Z","categories":["561c70abbe5fb20d0007775c","561c725c4b0a9b0d00c0f515","561c7260cd5e7b0d00eb48c6","561c726bf0e0580d00ddd9a4","561c7271d2fb350d004bf89a","564de219b5bea52b00c3457a"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-03-03T00:59:26.959Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"Message Stream is a home for your in-app messages. By default, when a person receives an in-app message, it will disappear as soon as it has been read. A Message Stream will act as a personalized inbox for these messages.\n\nEvery user will see a different stream of messages based on the targeting options you defined in Audience Builder. You define who should see a message and for how long: messages can have an expiration date, and can be archived and deleted from your Carnival Platform. When messages expire (or you archive them), they will simply disappear from a person's Message Stream.\n\nMessage Streams can be used for different purposes, for example:\n\n- **Personalized inbox.** Users will have a unique inbox, with personalized messages based on their preferences and behavior.\n- **Curated news feed.** You can create and distribute your own feed of stories. Stories can be targeted based on people interests and demographics. For example, fashion apps can choose to show women's apparel to women only, or to display accessories if a person has browsed the Accessories category in the past 7 days.\n- **Channels.** You can have people subscribe to multiple channels, and use a message stream to filter by these channels. This is useful for marketers that want to categorize promotions and offers into different categories.\n\n## Types of message streams\nYou define the UX and behavior of your message stream. To give people a seamless app experience, we encourage you to make it blend into your original look and feel.\nCarnival provides [message stream templates](https://github.com/carnivalmobile/carnival-stream-examples) as a blueprint to build and customize your experience. These examples contain the underlying logic to retrieve messages and media assets, in addition to track impressions and read status. Use these templates as the foundation of your message streams, so you can focus on delivering an awesome user experience.\n\nAll message streams are fully customizable, and you can add or remove functionality and components.\n\n<p align=\"center\">\n<a href=\"https://github.com/carnivalmobile/carnival-stream-examples\" class=\"btn btn-primary\">Download Message Stream Templates</a>\n</p>\n[block:parameters]\n{\n  \"data\": {\n    \"0-1\": \"## Standard\\n\\nDisplays messages in a list with title and description.\\n\\nIdeal for media in the 16:9 aspect ratio.\\n\\nThe template displays message type, date and unread badge.\",\n    \"h-1\": \"Message Stream Type\",\n    \"h-0\": \"Preview\",\n    \"0-0\": \"<img src=\\\"https://files.readme.io/13493fd-Standard.gif\\\" width=\\\"388\\\" />\",\n    \"1-1\": \"## Cards\\n\\nDisplays messages in a list with title and description.\\n\\nSimilar to Standard Message stream, but adapt for 4:3 aspect ratio.\",\n    \"1-0\": \"<img src=\\\"https://files.readme.io/49f1889-Cards.gif\\\" width=\\\"388\\\" />\",\n    \"2-1\": \"## Graphical Cards\\n\\nImmersive UX for messages with images and videos.\\n\\nPerfect for 16:9 aspect ratio, with rich media (videos and high resolution images).\\n\\nDisplays full bleed images and videos.\\n\\nTitle and description blend into graphical asset.\",\n    \"2-0\": \"<img src=\\\"https://files.readme.io/950fe8a-GraphicalCards.gif\\\" width=\\\"388\\\" />\",\n    \"3-1\": \"## List\\n\\nDisplays messages in a condensed view.\\n\\nPerfect for link messages with image or video thumbnails.\\n\\nDisplays message title, thumbnail, type, date and unread badge.\\n\\nThe template supports swipe actions out of the box (useful to remove a message or mark it as read).\",\n    \"3-0\": \"<img src=\\\"https://files.readme.io/fa3ea24-List.gif\\\" width=\\\"388\\\" />\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]","excerpt":"","slug":"message-stream","type":"basic","title":"Message Stream"}
Message Stream is a home for your in-app messages. By default, when a person receives an in-app message, it will disappear as soon as it has been read. A Message Stream will act as a personalized inbox for these messages. Every user will see a different stream of messages based on the targeting options you defined in Audience Builder. You define who should see a message and for how long: messages can have an expiration date, and can be archived and deleted from your Carnival Platform. When messages expire (or you archive them), they will simply disappear from a person's Message Stream. Message Streams can be used for different purposes, for example: - **Personalized inbox.** Users will have a unique inbox, with personalized messages based on their preferences and behavior. - **Curated news feed.** You can create and distribute your own feed of stories. Stories can be targeted based on people interests and demographics. For example, fashion apps can choose to show women's apparel to women only, or to display accessories if a person has browsed the Accessories category in the past 7 days. - **Channels.** You can have people subscribe to multiple channels, and use a message stream to filter by these channels. This is useful for marketers that want to categorize promotions and offers into different categories. ## Types of message streams You define the UX and behavior of your message stream. To give people a seamless app experience, we encourage you to make it blend into your original look and feel. Carnival provides [message stream templates](https://github.com/carnivalmobile/carnival-stream-examples) as a blueprint to build and customize your experience. These examples contain the underlying logic to retrieve messages and media assets, in addition to track impressions and read status. Use these templates as the foundation of your message streams, so you can focus on delivering an awesome user experience. All message streams are fully customizable, and you can add or remove functionality and components. <p align="center"> <a href="https://github.com/carnivalmobile/carnival-stream-examples" class="btn btn-primary">Download Message Stream Templates</a> </p> [block:parameters] { "data": { "0-1": "## Standard\n\nDisplays messages in a list with title and description.\n\nIdeal for media in the 16:9 aspect ratio.\n\nThe template displays message type, date and unread badge.", "h-1": "Message Stream Type", "h-0": "Preview", "0-0": "<img src=\"https://files.readme.io/13493fd-Standard.gif\" width=\"388\" />", "1-1": "## Cards\n\nDisplays messages in a list with title and description.\n\nSimilar to Standard Message stream, but adapt for 4:3 aspect ratio.", "1-0": "<img src=\"https://files.readme.io/49f1889-Cards.gif\" width=\"388\" />", "2-1": "## Graphical Cards\n\nImmersive UX for messages with images and videos.\n\nPerfect for 16:9 aspect ratio, with rich media (videos and high resolution images).\n\nDisplays full bleed images and videos.\n\nTitle and description blend into graphical asset.", "2-0": "<img src=\"https://files.readme.io/950fe8a-GraphicalCards.gif\" width=\"388\" />", "3-1": "## List\n\nDisplays messages in a condensed view.\n\nPerfect for link messages with image or video thumbnails.\n\nDisplays message title, thumbnail, type, date and unread badge.\n\nThe template supports swipe actions out of the box (useful to remove a message or mark it as read).", "3-0": "<img src=\"https://files.readme.io/fa3ea24-List.gif\" width=\"388\" />" }, "cols": 2, "rows": 4 } [/block]