Required Technical ConfigurationLast Updated: 21 May 2021
The goal of this document is to describe the ideal way of delivering digital content online, and help you get the most out of your Echobox service. This technical configuration also greatly benefits the performance of your content on search engines, recommendation tools and social platforms.
Please note: If you are unable to accommodate all of these requirements, please discuss this with your Echobox customer representative to see how Echobox might be able to help mitigate any issues.
The following sections discuss various parts of digital content delivery, in order of priority, starting with the most important.
Various platforms use different semantic tag protocols to extract article meta content such as title, description, images etc. Echobox uses this information as part of its algorithms and to prepopulate previews, saving you a lot of time. The tags also ensure that people on social media who share your content to their friends and followers always use the best share information. Echobox requires that these protocols are implemented at the moment of publication. Please implement:
- Facebook: Open Graph Protocol - http://ogp.me/
- Twitter: Twitter Cards - https://dev.twitter.com/cards/markup
- Google: Structured Data - http://schema.org/ (optional)
Media Content Feeds
The majority of your content is pulled by Echobox via media content feeds. Your feeds must be valid (i.e. conform to either the RSS, ATOM or XML sitemap standard) and contain articles as soon as they are publicly available on your website. Echobox checks each media content feed once per minute.
To ensure your feeds are valid, you can check them using the following tool: https://validator.w3.org/feed/. You will be unable to connect invalid feeds to Echobox.
For Echobox to always get articles as quickly as possible, please ensure the feeds you connect to Echobox do not use any caching.
In order for your new content to be processed more quickly, you can further reduce the size of your media content feeds to only include content published within the last few hours.
Echobox supports the following image formats: JPEG, JPG, PNG, JFIF, GIF
Echobox supports the following video formats: MP4, MPG, AVI, MOV, WMV, WEBM, OGM, OGV, ASX, MPEG, M4V
Echobox gains powerful insights from your traffic data. Typically, data on Google Analytics is sampled but Echobox has access to your raw unsampled data set. It is important to ensure the following so that Echobox can maximize the use of this data:
- The URLs recorded by Google Analytics (GA), and visible within your GA dashboard, must exactly match that of the article when viewing in a web browser. This is the default behaviour of GA unless the GA tracking code has been manually edited or your website configuration is unusual.
- Echobox requires a single GA view that contains all traffic from all sources for all articles.
- Echobox requires Google Analytics V3 (GA3).
- Providing Echobox has access to Google Analytics, you may use any additional analytics solutions you require.
Properties, Pages and Domains
Echobox requires that one Property represents a single top-level domain (TLD). It is not possible to combine multiple TLDs into a single Property on Echobox. However, subdomains within a TLD can be in the same Property on Echobox.
Social pages can only be added into a single Property on Echobox Social if they post content mostly to the TLD of said Property. For instance, if 2 social pages post content to 2 separate TLDs, then each social page needs to be added to a separate Property on Echobox Social, with each Property linked to said TLD.
To provide a seamless experiences to mobile website visitors, all content should be made available from a single URL/domain using responsive design (https://en.wikipedia.org/wiki/Responsive_web_design).
The more classical technical implementation involves redirecting mobile visitors to a different page or domain, e.g. www.domain.com -> mobile.domain.com. Whilst not ideal, please ensure the following if you have such an implementation:
- The mobile version of the article must include an embedded canonical reference tag to the desktop version (https://support.google.com/webmasters/answer/139066?hl=en).
- The mobile version of the website must redirect non-mobile visitors back to the full desktop version. On social media, for instance, it ensures that any reshares made by visitors who land on the mobile version will display normally to viewers on a desktop.
- Traffic for mobile visitors must be included in the same Google Analytics view that has been configured to provide Echobox with desktop pageviews. If Echobox does not receive all traffic (mobile, desktop, etc), Echobox cannot function properly.
Your URLs should contain all essential hierarchical information within the URL path.
URLs that use query parameters (?) require additional setup to work correctly. Please speak to your customer representative to set this up.
It's not possible to optimize article URLs that use fragment parameters (#) due to constraints with Google Analytics.
A common structure followed by publishers is as follows: https://moz.com/learn/seo/url
Each distinct article or other piece of content you publish must be made available on its own unique URL path and not change or redirect over time.
For more information about URL standards, please see here: https://www.ietf.org/rfc/rfc3986.txt
Republishing Articles & Duplicate Content
Republished content. Content is considered republished if the article reappears in a media feed with a newer publish time and the same URL.
Duplicate content. Content is considered duplicated if two versions of an article (possibly with the same or modified content) are published on different URLs.
It is important that when you wish to change the content of an article, for example, to modify the title, correct a grammatical error etc., that the URL of the article remain unchanged. This ensures that any traffic associated with the original content is easily associated with the updated content. If you duplicate your content (i.e. different URL) when making changes, it becomes more difficult to detect this relationship.
Content must not be duplicated on your website, i.e. published more than once on different URLs or domains. Duplicating content also has a significant negative impact on the engagement and visibility of the article on both search engines and social media.
Echobox can provide some support to help minimize the effect of duplicate content. For the best possible results, however, content must only ever be available via a single URL/domain.
In cases where duplicate content cannot be avoided, Echobox strongly recommends the correct implementation of canonical URL tags (https://support.google.com/webmasters/answer/139066?hl=en). A canonical reference is defined as:
- "A canonical link element is an HTML element that helps webmasters prevent duplicate content issues by specifying the "canonical" or "preferred" version of a web page as part of search engine optimization. It is described in RFC 6596, which went live in April 2012." - Wikipedia
Some common invalid implementations of canonical references are given in the following figures:
Examples of valid implementations of canonical references:
You can use the following tool to validate your configuration here: https://seositecheckup.com/tools/url-canonicalization-test
Echobox supports the following desktop browsers, provided they have been updated to a version released on or after 1 July 2019:
- Chrome (Recommended)
- Microsoft Edge
- Apple Safari
Echobox supports the following mobile browsers, provided they have been updated to the most recent version available:
- Chrome (iOS and Android) (Recommended)
- Firefox (iOS and Android)
- Opera Mobile (iOS and Android)
- Safari (iOS)
- Samsung Internet
There is a direct link between website load times and visitor bounce rate, https://econsultancy.com/blog/10936-site-speed-case-studies-tips-and-tools-for-improving-your-conversion-rate/: "A one second delay in page-load can cause 7% loss in customer conversions."
Echobox strongly recommends that your articles can all be loaded in under 1 second. This not only ensures you keep visitors on your website as long as possible, but it also ensures that Echobox can react as quickly as possible to changes on your website. There are many free tools available online that help assess your website performance, such as:
Facebook Instant Articles
It is important that visitors are tracked on Facebook Instant Articles in the same way that they would be on your website. Please ensure the same Google Analytics tracker you use on your website is configured on your Instant Articles. Please see https://developers.facebook.com/docs/instant-articles/analytics.
When a URL is redirected to another URL, for example because an article has been republished elsewhere (see section 6) or because the URL is now being provided via https:// rather than http://, it is necessary to ensure all tracking parameters are preserved, i.e. utm_source, utm_campaign & utm_medium. If these tracking parameters are removed or altered it will severely inhibit Echobox from creating a valid optimization strategy.
If all or some of your content is located behind a paywall, please ensure Echobox's scrapers are allowed to access this content. For this, you may either whitelist our user agent or IP ranges, although we recommend whitelisting our user agent as our IP ranges change over time. Your Customer Success Manager will be able to share those with you.
Echobox Social: Facebook Domain Verification
Facebook introduced Domain Verification to fight against fake news. Only the owner of a domain can edit link posts from that domain. It's therefore important you ensure you've completed Facebook's Domain Verification before using Echobox Social. Full details can be found here: https://developers.facebook.com/docs/sharing/domain-verification#add-your-domain-in-business-manager. Please note that this is not the same as the blue Verified badge or Link Ownership.
Echobox Social: Share Messages & Autofeed
When using the Autofeed on Echobox Social, which automatically publishes your best content at optimal times, you need to select a "data source" for the share message. A data source can be your og:description (see http://ogp.me/), your RSS title or similar.
Whenever the Autofeed wants to share, it will pull the text from your chosen data source, and use it as the share message. It is crucial your chosen data source consists of social-ready share messages. If the quality of the share messages in your data source is below the quality of share messages you posted before using the Autofeed, your traffic will most likely decline. To benefit from the Autofeed's potential, you have to ensure your data source consists of high-quality share messages.
Useful Tools Appendix
Website Performance Summary: https://developers.google.com/speed/pagespeed/insights
Website Performance Summary: https://gtmetrix.com/
RSS Feed Validator: https://validator.w3.org/feed/
Facebook Object Debugger: https://developers.facebook.com/tools/debug/og/object/
Canonical Reference Validator: http://seositecheckup.com/tools/url-canonicalization-test