Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The integration of the PrematchCenter The integration of the PrematchCenter tracker is a very simple process which can be achieved in 3 basic steps.

Step 1: Test Tracker placement

The basic test which will show the tracker on your website can be done using our test Tracker. This scenario doesn't require any domain validation or agreement. You can place the tracker wherever you would like to.
To do the test you need to place two pieces of scripts on your website:
 

  1. Tracker generator:
    Include the JavaScript code on your page once, ideally right before closing <body> tag.

    Code Block
    languagexml
    titleTracker generator
    <script rel="script" src="https://prematch.statscore.com/prematchcenter/generator"></script>



  2. Tracker placeholder: 
    Place the code for your Tracker wherever you want the Tracker to appear on your page. 

    Code Block
    languagexml
    titleTracker placeholder
    <section id="Tracker-1" class="STATSCORE__Tracker" data-event="1853382" data-lang="en" data-config="203" data-zone="" data-use-mapped-id="0"></section>




  • id - it's the html element identifier. In case where few trackers will be visible on the same page, each id should have different value e.g. "tracker-2", "tracker-3" etc.
  • class - tracker element should always contain "STATSCORE__Tracker" class
  • data-event - this value should include STATSCORE event ID or CUSTOMER event ID.
    Please note: To force the script to use CUSTOMER event ID flag "use-mapped-id" should have value = 1.
  • data-lang - sets language for tracker
  • data-config - configuration id, different for each customer
  • data-zone - sets time-zone for tracker. If empty local time-zome will be detected automatically.
  • use-mapped-id - switch tracker to use STATSCORE or CUSTOMER event id in data-event parameter to display visualisation. 
    Possible values:
    "0" - in this case data-config parameter should store STATSCORE event ID to display widget.
    "1" - in this case data-config parameter should store CUSTOMER event ID to display widget and CUSTOMER event ID should be mapped with STATSCORE event ID in STATSCORE system.

Please note: 
The test widget has the same parameters as the real one, so you can change parameters like: lang and timezone to see how you can adjust the widget on your website. 
Colours, fonts and other styles in the production Tracker can be adjusted at the deployment stage after agreement has been reached.

Step 2: Pairing events with STATSCORE

...

  • very important feature is the filter based on TIMESTAMP e.g. timestamp="1490959672" - then we can filter only the customer events which were created or changed after provided timestamp value.
    This feature allows to ensure your events will be mapped automatically up to 1 minute after you add this event to your feed.
  • filter by dates (date_from e.g. "date_from="2015-09-10 11:30:00", date_to e.g. date_to="2015-09-11 11:30:00").
    The mapping system goes past the dates and will include the following 6 months. 
    This feature allows to ensure your events will be mapped automatically up to 190 minutes after you add this event to your feed.
  • filter by sport_id separated by comma f.e. sport_id="1,3,5,7", would be good additional feature.
Please note:
  • the maximum size of the feed should not be greater than 2 MB, if there is more data it should be paginated.
  • the maximum execution time of the feed should not be longer than 30 seconds.

Step 3:

...

Tracker configuration

If the test step is successful we are ready to place the production widget configured according to your needs.
In the production widget you Tracker you need to set two basic parameters:

  1. data-config
    This value is given by STATSCORE to customers. You can have many configurations for the Prematch Center Widget There is a possibility to have more than one configuration for a customer (for example two different trackers or parts of the tracker on one website). By default STATSCORE prepares one configuration for each customer . (however more configurations can be ordered).
    On our demo website you can check different configurations (Select template):
    https://demo-prematchcenter.statscore.com
     
  2. data-event
    STATSCORE'sunique identifier for an event (match). It should be a numeric value.

    All event identifiers are provided by STATSCORE in the API method named booked-events.
    Examples of calling this method are listed below:
    1. https://api.statscore.com/v2/booked-events?product=prematchcenter&client_id=2&mapped_status=mapped - JSON format
    2. https://api.statscore.com/v2/booked-events.xml?product=prematchcenter&client_id=2&mapped_status=mapped - XML format

In this method a customer can find his own event ID (client_event_id attribute). Then he can look for the STATSCORE event ID (id attribute) corresponding to the same event.



To get the right list of booked events the customer needs to call this method with the proper value of CLIENT_ID provided by STATSCORE.
There is also more information provided about the events which could be useful for the customer.


Simplified integration method (Using your event id)

In case you don't need to know id advance which of the games are covered and mapped you can use simple integration method.

...