Implementation Best Practices

A list of best practices that we've put together, collected from a wide variety of publishers using SimpleReach in many different ways

MULTIPLE IMPLEMENTATIONS 

If you have multiple implementations--for example, a mobile app implementation and a standard implementation on your website--and if the data sent to us from one is different than what is sent from the other, we will always take the information from the most recent data received. For instance, if tags and authors are sent for an piece of content from your website, but not from the mobile app, and the last event we received was from the mobile app, then our system will remove the tags and authors information for that content piece. The solution to this is ensure that all content fields ('title', 'date', 'authors', 'channels', 'tags') match across implementations.

CODE PLACEMENT 

As with most analytics tags, in order to capture all the relevant information about a request, it is important to load the __reach_config tags as early as possible. We strongly recommend putting the SimpleReach code inside the <HEAD> HTML tags or in close proximity to your other analytics providers (like Google Analytics or Omniture), and be sure to set iframe to true. The earlier you can load the SimpleReach tags, the better.

We strongly discourage the use of our code on your home page or channel pages, as this will skew the data, so you will not get a true view of how your content is performing. It is best to include our code only on pages containing content, such as article or gallery pages.

GALLERY IMPLEMENTATION 

There are two primary ways of tracking galleries, slideshows, and other deep-linked content that uses a hash (#) symbol in the URL.

1. Individual Slide Tracking: Each slide or image has its own canonical URL. This means that each slide is sharable and will be tracked individually.

2. Slide Grouping (recommended): All slides in a slideshow or images in a gallery are grouped together and assigned the canonical URL of the main page of the slideshow or gallery. Be sure that the SimpleReach code is set to fire on each slide change, with the same canonical URL attributed to the url field for each slide. If your gallery uses AJAX, please check out our AJAX documentation for more information.

As there are pros and cons to each gallery implementation method, we recommend speaking to one of our Customer Success Managers to determine the correct approach for your site.

DEBUGGING YOUR IMPLEMENTATION 

Once the SimpleReach code has been implemented on your site, we strongly recommend giving it a once-over with our Chrome extension. This can help quickly identify potential issues, so they can be resolved as soon as possible and we can get your account up and running!

To use the extension, just visit this link and add it to your extensions. Open up your developer tools (go to View >> Developer >> Developer Tools) and select 'Reach' from the menu. That's it!