I. Initial Set Up

Here is a list of items your account strategist will need in order to prepare your site for launch:

• Where do you plan to install Outbrain?
  Outbrain supports multiple page types such as articles, blogs, slideshows, and videos.
• What areas of your site would you like to recommend in the Outbrain widget?
  Outbrain can set up content whitelists if you only want to recommend specific sections of your site.
• What do you want the Outbrain widget to look like?
  Our widget is a humble guest on your page and will inherit CSS to remain consistent with your site design. If you have something specific in mind, let us know. You name it, we can probably do it.
• Quality image file of logo.
  Send us a high-quality file of your site’s logo and we’ll attach it to any article that doesn’t have a thumbnail. That way great, image-free content gets the chance to shine in image-based widgets.

II. The Outbrain JS

You can start working with the code as soon as the initial set up is complete. We take the quality of our products very seriously. Every pixel and line of code we download to your page has an essential function. Here are a few facts that illustrate our commitment:

• The Outbrain widget is less than 25KB (8 KB zipped).
• When serving thumbnails, we only serve images in the exact size of the thumbnail, which means our total impact on page size and load time is minimal.
• Our widget loads asynchronously, and therefore will never delay page loading. In the rare cases we have issues with our recommendation server, the widget will simply not load. (This rarely happens thanks to our backend redundancy.)

III. Indexing URLs & Learning About Content

We use the data-src value for two purposes. The first is simply to index the URLs from your site. Outbrain crawls a URL the first time our JavaScript loads on the page. The second is to learn about content on that page.
 

1. Indexing URLs: Outbrain needs to index your site before launch to ensure the best possible performance on day one. Indexing in advance also gives us recommendations to display during the testing process. Here are the ways we can crawl your site before we’re live:
    
   Option A
   RSS feeds. If you have a list of RSS feeds, please send it to your account strategist.
    
   Option B
   No feeds? No problem. We can also use a sitemap or list of URLs.
    
   Option C- Advanced Dev Ninja Option
   We can make our JS results invisible. This means that you could roll the code out to production before the testing phase is complete. In this scenario, we would hide the widget on our end and just use the code for the purpose of indexing URLs. This also allows us to get a lot of the data needed to better inform our recommendations. Without this data, the recommendations may not be optimal for the first day or two in production.
   * See this in action here: http://widgets.outbrain.com/external/demos/draft-demo.html
    
   Option D
   If none of these options are feasible, we will crawl your site whenever the code launches in production. In this scenario, the widget may take a few hours to fully populate with recommendations.
    
2. Learning about content: Outbrain will also crawl information about the URLs we are indexing in order to serve more interesting and relevant recommendations to your readers.
    
   Here’s a list of what we look for:
   • Title
   • Description
   • Publish Date
   • Image
   • Author
   • Content

    
   The best way for us to gather this information is via microdata, like Google’s Schema and Facebook’s Open-graph, or via Outbrain proprietary tags. We highly recommend deploying one of these options across your site and have provided tag examples for each of the above attributes in Appendix A.

IV. Testing and Styling

Now that we have indexed your content and know where to pick up important information, we can begin testing. This process is for validating code and styling the widget(s). Please make sure that the placements and page types in testing mirror the eventual experience in production. Also note that the recommendation results in testing do not reflect what will come through in production since we will not have all possible behavioral data yet.

 
If you have a test environment …
You will need to do the following in order for the Outbrain widgets to work:

• Whitelist our crawler IP addresses and user agent (your Account Strategist will provide both sets of IPs if needed). If your test environment is behind a firewall and our crawlers don’t have access, the widget won’t work. Please contact your account strategist for the most up to date crawler IP information.
• Grant your account strategist access to the test environment. The fastest and most reliable way for Outbrain to validate the code and style the widgets is to do so directly in testing. If needed, your account strategist can provide you with our office IP addresses.
• Pass production permalinks in testing. It’s ideal if you can pass production URLs into the data-src variable in testing, either dynamically or hard-coded. This prevents us from indexing your test domains. This step is not a requirement for the widgets to work, but streamlines the process and ensures a faster styling turnaround.

 
If not, don’t worry…
Outbrain can also work without a proper dev site:

• We can hide the recommendation results so that you can launch the code directly in production. Outbrain has our own shareable draft environment where the results will be visible. We can use this environment to finalize styling and guarantee everything is functioning correctly.
  * See this in action here: http://widgets.outbrain.com/external/demos/draft-demo.html
• You can launch the code visibly on one low-traffic production page.

 
Once your account strategist has a working test page…
She/he can begin implementing the UI upon which your teams agreed in section I!

V. Launch

Once Outbrain has validated everything in testing, you can push our JS to production! Just let your account strategist know the expected date and time of launch. If you encounter any issues post-launch, please contact your account strategist.