{"__v":2,"_id":"56abb8b49327b30d00f7c234","category":{"__v":8,"_id":"5666dac5d784a70d00397bcb","pages":["5666dda06819320d000c2e19","567856b9e5da8d0d00591c66","567861b8e5da8d0d00591c7c","568bdbf9e3e30f0d0021e07c","568be56983d2061900d86ce9","5697f7a60b09a41900b245d7","56abb8b49327b30d00f7c234","56d088977c2e100b000af8f0"],"project":"564de2dbfe07a81700b5c3a5","version":"564de2dbfe07a81700b5c3a8","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-08T13:27:33.662Z","from_sync":false,"order":5,"slug":"tutorials","title":"Tutorials"},"parentDoc":null,"project":"564de2dbfe07a81700b5c3a5","user":"568c2f46e111c70d002d84b6","version":{"__v":10,"_id":"564de2dbfe07a81700b5c3a8","project":"564de2dbfe07a81700b5c3a5","createdAt":"2015-11-19T14:55:23.838Z","releaseDate":"2015-11-19T14:55:23.837Z","categories":["564de2ddfe07a81700b5c3a9","564df317826645210097a890","564df3217c8f372b00b934df","564e5227c3553e0d003e53ba","5666dac5d784a70d00397bcb","56cd08ddd98d851d00c0c3bd","56e9a50946bfd60e008840a7","5718e37bf8f7de1900683fad","58c3308dfedf070f0043b72c","58ce99c75457d02300560c0a"],"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":"2016-01-29T19:08:36.840Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"This is a tutorial to give you an overview of recommendations and content promotion with Embedly. You can integrate recommendations on your site, or create a single recommendation as a test. Integration is far more successful to increase pageviews and recirculation among your content, and the single recommendation is great for prototyping. \n\nRecommendations show up only after a video is played. You can [see a demo of it here](http://embed.ly/recommend#rec-demo). \n\nI'll highlight an example. See this post on the Raspberry Pi blog: \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/Sd6UDnDnQTqQ9PG8OgWr_Screen%20Shot%202016-01-27%20at%203.59.40%20PM.png\",\n        \"Screen Shot 2016-01-27 at 3.59.40 PM.png\",\n        \"668\",\n        \"897\",\n        \"#2d4b4b\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nWhich you can [find in this post](https://www.raspberrypi.org/blog/raspberry-pi-zero/).  The recommendations are for other posts on the Raspberry PI blog, and only display after the video has started playing. \n\nWhen you use Recommend, the recommendations come from other pages on your site that have embedded videos on them.  Embedly makes a recommendations based on audience behavior across the Embedly network.  When you use Recommend, Embedly leverages the information across the network to determine which of your posts to recommend alongside your embeds.\n\nThe key is that videos are embedded across your site, so that there is a breadth of your posts to draw from when making a recommendation.  Embedly can measure how your audience engages with your posts, and use this to inform the recommendations. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Getting Started - Cards\"\n}\n[/block]\nThe first step to using recommendations is to start embedding. You can use the [Embed API](http://embed.ly/embed) to do this, or [Cards](http://embed.ly/cards).\n\nCards are much easier to integrate, as simple as a copy/paste. They automatically include recommendations. Once you start using Cards on several pages, they will start recommending your posts to increase recirculation. When your audience watches one video embedded, other posts of yours with video are recommended, making it more likely that they will see more content on your site. \n\nMore information on [integrating Cards here](docs:cards).\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Getting Started - API\"\n}\n[/block]\nYou can also start embedding with the oEmbed and Extract endpoints. To get more information about using recommendations programmatically, check out this [tutorial](/recommendations). \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Layout Options for Recommendations\"\n}\n[/block]\nThere are a few layout options available for recommendations: List (default), Grid, and Carousel. You can see a [demo of these options](http://embed.ly/recommend#rec-display).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/sDEWjRlRN6EXh7OrBFTb_Screen%20Shot%202016-02-08%20at%203.12.12%20PM.png\",\n        \"Screen Shot 2016-02-08 at 3.12.12 PM.png\",\n        \"628\",\n        \"695\",\n        \"#724a42\",\n        \"\"\n      ],\n      \"caption\": \"List layout\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/IQOJgVQISzL5pVXKiF7Q_Screen%20Shot%202016-02-08%20at%203.12.23%20PM.png\",\n        \"Screen Shot 2016-02-08 at 3.12.23 PM.png\",\n        \"625\",\n        \"569\",\n        \"#714a41\",\n        \"\"\n      ],\n      \"caption\": \"Grid layout\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/XO1cyuoQcFAF7lYbxeeg_Screen%20Shot%202016-02-08%20at%203.12.30%20PM.png\",\n        \"Screen Shot 2016-02-08 at 3.12.30 PM.png\",\n        \"617\",\n        \"499\",\n        \"#72483d\",\n        \"\"\n      ],\n      \"caption\": \"Carousel layout\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"recommendation-intro","type":"basic","title":"Recommendation Intro"}

Recommendation Intro


This is a tutorial to give you an overview of recommendations and content promotion with Embedly. You can integrate recommendations on your site, or create a single recommendation as a test. Integration is far more successful to increase pageviews and recirculation among your content, and the single recommendation is great for prototyping. Recommendations show up only after a video is played. You can [see a demo of it here](http://embed.ly/recommend#rec-demo). I'll highlight an example. See this post on the Raspberry Pi blog: [block:image] { "images": [ { "image": [ "https://files.readme.io/Sd6UDnDnQTqQ9PG8OgWr_Screen%20Shot%202016-01-27%20at%203.59.40%20PM.png", "Screen Shot 2016-01-27 at 3.59.40 PM.png", "668", "897", "#2d4b4b", "" ], "sizing": "full" } ] } [/block] Which you can [find in this post](https://www.raspberrypi.org/blog/raspberry-pi-zero/). The recommendations are for other posts on the Raspberry PI blog, and only display after the video has started playing. When you use Recommend, the recommendations come from other pages on your site that have embedded videos on them. Embedly makes a recommendations based on audience behavior across the Embedly network. When you use Recommend, Embedly leverages the information across the network to determine which of your posts to recommend alongside your embeds. The key is that videos are embedded across your site, so that there is a breadth of your posts to draw from when making a recommendation. Embedly can measure how your audience engages with your posts, and use this to inform the recommendations. [block:api-header] { "type": "basic", "title": "Getting Started - Cards" } [/block] The first step to using recommendations is to start embedding. You can use the [Embed API](http://embed.ly/embed) to do this, or [Cards](http://embed.ly/cards). Cards are much easier to integrate, as simple as a copy/paste. They automatically include recommendations. Once you start using Cards on several pages, they will start recommending your posts to increase recirculation. When your audience watches one video embedded, other posts of yours with video are recommended, making it more likely that they will see more content on your site. More information on [integrating Cards here](docs:cards). [block:api-header] { "type": "basic", "title": "Getting Started - API" } [/block] You can also start embedding with the oEmbed and Extract endpoints. To get more information about using recommendations programmatically, check out this [tutorial](/recommendations). [block:api-header] { "type": "basic", "title": "Layout Options for Recommendations" } [/block] There are a few layout options available for recommendations: List (default), Grid, and Carousel. You can see a [demo of these options](http://embed.ly/recommend#rec-display). [block:image] { "images": [ { "image": [ "https://files.readme.io/sDEWjRlRN6EXh7OrBFTb_Screen%20Shot%202016-02-08%20at%203.12.12%20PM.png", "Screen Shot 2016-02-08 at 3.12.12 PM.png", "628", "695", "#724a42", "" ], "caption": "List layout" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/IQOJgVQISzL5pVXKiF7Q_Screen%20Shot%202016-02-08%20at%203.12.23%20PM.png", "Screen Shot 2016-02-08 at 3.12.23 PM.png", "625", "569", "#714a41", "" ], "caption": "Grid layout" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/XO1cyuoQcFAF7lYbxeeg_Screen%20Shot%202016-02-08%20at%203.12.30%20PM.png", "Screen Shot 2016-02-08 at 3.12.30 PM.png", "617", "499", "#72483d", "" ], "caption": "Carousel layout" } ] } [/block]