AMP Server Side Fetch

The Prefetch API is not part of the default Tickaroo Live Blog plan. Please contact our support if you want to use it.

Why Server Side Fetch

The Server Side Fetch API allows you to integrate a Tickaroo liveblog directly into your AMP page. It is the best way to deliver a seamless AMP experience to you users and to make sure search engines can see all your content.

How it works

Due to the limitations of AMP, more development work is involved in integrating a liveblog deeply into an AMP page. When an AMP page is requested from your server, you must call a Tickaroo API to retrieve the content to be displayed on the page. The API will respond with a JSON containing the following components:

  • AMP HTML Content to display
  • A list of necessary AMP Scripts
  • CSS to include
  • (Optional) Schema.org data

You must include those components at the appropriate places in your AMP following this example:

<!doctype html>
<html >
  <head>
    <link rel="canonical" href="LINK_TO_YOUR_HTML_PAGE" />
    <style amp-custom>
      <!-- Insert amp css -->
    </style>
    <!-- Insert amp scripts  -->
  </head>
  <body>
    <...>
      <!-- Insert  amp html content -->
    </...>
  <body>
</html>

To make sure navigation works properly, you must forward the following query parameters to the Tickaroo API:

  • tickaroo_nav
  • tickaroo_event_id

Fetch API

GET https://cdn.tickaroo.com/api/embed/v4/prefetch-amp/liveblog.json

Query Parameters:

  • client_id
  • client_secret
  • tickaroo_nav
  • tickaroo_event_id
  • In addition you can specify any prameters described in Liveblog Tag Parameters

Returns: A JSON with HTML, CSS, Script and Schema.org data (Content-Type: application/json; charset: utf-8):

{
  "html": "HTML to insert into your document",
  "css": "CSS Content",
  "scripts": "Multiple lines of <script> tags",
  "schema": {
    "@context": "https://schema.org",
    "@type": "LiveBlogPosting"
    "...": "..."
  }
}

To be honored by the google ranking your html page needs to link to the amp page and vice versa. In the example above the amp links to html page.

This is an example how to link the html to the amp page:

<html>
  <head>
    <link rel="amphtml" href="LINK_TO_YOUR_AMP_PAGE">
  </head>
  <body>
  <body>
</html>

Features Support

Webembeds in Liveblog

Currently this embeds are supported, others are rendered as a linked preview:

  • brightcove
  • gfycat
  • instagram
  • soundcloud
  • twitter
  • vimeo
  • youtube

Unsupported Parameters and Options

Currently the following liveblog features are unsupported:

  • Event sharing by email or clipboard
  • Auto refresh (is always notify)
  • Tag filters
  • Comments
  • Masonry Layout
  • Consent Handling