General information
For each sport offered in the ScoutsFeed product, there is the possibility of receiving information about match line-ups. This chapter is designed to help with:
understanding the process of creating match line-ups
understanding the differences between position and position type
understanding when and in what form you can receive the message with the match line-ups
understanding how to identify all players who started the match in the starting line-up
understanding how to identify players who were not in the starting line-up but participated in the match
The availability of full match lineups depends on several factors:
the match must be included in the ScoutsFeed offer
the match lineups must be available before the match
the competition in which the match is played must be at the Gold or VIP levels
In matches provided within the ScoutsFeed product but within competitions at lower statistical levels (bronze and silver levels), we do not guarantee access to full match lineups for every match. In some cases, we may still provide information about the match lineups, but we will not simultaneously provide player statistics.
When providing match lineups, we always rely on official sources to ensure that the ‘events_ lineups’ message we send is 100% verified and accurate. We base this on official league websites or the official websites of the clubs.
Player positions for specific sports
Each sport available in our ScoutsFeed offer has its own specifics, and consequently - the players associated with them have different roles or positions.
In STATSCORE we distunguish:
position - the player's position specific to a given sport and match. In each sport, there are greater or lesser differences in terminology. Examples of positions:
Soccer - 1st lineup, Bench
Basketball - Starting lineup, Substitute
Baseball - Pitcher, Batter
position_type - a broader concept than 'position.' The type of position should be identified as the player's status before the match. Example:
Soccer - zawodnicy z pozycją Goalkeeper i 1st lineup będą posiadali position_type= starting lineup
Baseball - zawodnicy na pozycji Pitcher i Batter będą posiadali position_type= starting lineup
American football - zawodnicy na pozycji Offense i Defense będą posiadali position_type=starting lineup
W przypadku braku możliwości identyfikacji zawodników pod kątem dokładnej pozycji, zastrzegamy sobie w wybranych meczach możliwość przypisania pozycji typu 'Player”. Przykład:
Basketball - nie wiemy, którzy zawodnicy rozpoczną mecz w pierwszej piątce, a którzy nie (Starting lineup/Substitute). Wszyscy zawodnicy ze składu meczowego otrzymają wówczas pozycję=Player
Pozycja “Will not play” jest nadawana zawodnikom, którzy z różnych powodów nie będą uczestniczyli w meczu. Dla tej pozycji wyróżniamy następujące powodu absencji:
Federation decision
Coach decision
Disqualification
Injury
W przypadku kontuzji, jako powodu nadania roli “Will not play” nie podajemy dokładniejszych danych dotyczących rodzaju kontuzji czy orientacyjnej daty powrotu do zdrowia.
Poniższa tabela zawiera informację na temat wszystkich sportów, które posiadamyId w produkcie ScoutsFeed oraz pozycje i typy pozycji dla każdego z nich:
Sport | Position | Position type | Note |
---|---|---|---|
Soccer | goalkeeper | starting lineup | |
1st lineup | starting lineup | ||
bench | substitute | ||
coach | coach | ||
will not play | will not play | ||
Basketball | starting lineup | starting lineup | |
substitute | substitute | ||
player | starting lineup | ||
coach | coach | ||
will not play | will not play | ||
Ice hockey | goalkeeper | starting lineup | |
line 1 | starting lineup | ||
line 2 | starting lineup | ||
line 3 | starting lineup | ||
line 4 | starting lineup | ||
substitute | substitute | Only for second goalkeeper | |
coach | coach | ||
will not play | will not play | ||
Volleyball | starting lineup | starting lineup | |
substitute | substitute | ||
player | starting lineup | ||
coach | coach | ||
will not play | will not play | ||
Handball | goalkeeper | starting lineup | |
player | starting lineup | ||
coach | coach | ||
will not play | will not play | ||
Futsal | goalkeeper | starting lineup | |
starting lineup | starting lineup | ||
substitute | substitute | ||
coach | coach | ||
will not play | will not play | ||
Baseball | batter | starting lineup | |
pitcher | starting lineup | ||
coach | coach | ||
will not play | will not play | ||
American football | offense | starting lineup | |
defense | starting lineup | ||
substitute | substitute | ||
coach | coach | ||
will not play | will not play | ||
Cricket | player | starting lineup | |
coach | coach | ||
will not play | will not play |
Wysyłanie wiadomości ze składami meczowymi
Najważniejsze informacje dotyczące składów meczowych i wiadomości, w jakiej są one wysyłane:
Składy meczowe są wysyłane osobną wiadomością “events_lineups”
Ten typ wiadomości jest wysyłany wyłącznie do partnerów z:
access to GOLD or VIP package - SportsAPI
ScoutsFeed product with PUSH players stats add-on
Jest ona wysyłana przez Skauta zawsze przed rozpoczęciem meczu
To, kiedy ta wiadomość jest wysyłana jest uzależnione od dostępności oficjalnych składów meczowych przed jego startem. Zazwyczaj jest to przedział między 30 minutami a 10 minutami przed rozpoczęciem meczu
struktura wiadomości jest dokładnie opisana TUTAJ
Oznaczanie zawodników występujących w meczu
Poniższa tabela zawiera informacje na temat wszystkich statystych, które pozwalają na
Sport | Statistics | Statistics ID | Sended with the ‘event_lineups’ message | Note | |
---|---|---|---|---|---|
Soccer | Appearance | 35 | |||
First lineups | 36 | ||||
On bench | 37 | ||||
Current goalkeeper | 648 | ||||
|
|
|
|
|
|
Basketball | Appearance | 35 | |||
Starting lineup | 838 | ||||
|
|
|
|
|
|
Ice hockey | Appearance | 35 | |||
Starting lineup | 838 | ||||
Substitute | 1240 | ||||
Current goalkeeper | 1312 | ||||
Handball | Appearance | 35 | |||
Baseball | Appearance | 35 | |||
Game started | 1229 | ||||
Current pitcher | 1364 | ||||
Am. football | Appearance | 35 | |||
Starting lineup | 838 | ||||
Substitute | 1240 |