Integrations
Connect Hudl StatsBomb for player and match data and TransferRoom for market values.
Integrations bring data from the club's own data providers into Agones: Hudl StatsBomb for player and match data, and TransferRoom for market values. Each club connects with its own license and account.
Open Settings → Integrations. Every member can see whether an integration is connected; only the Football Director can connect, change or disconnect one.
Overview
Each integration has a tile with what it provides and its status. Click a tile to open the integration's page.
| Status | Meaning |
|---|---|
| Connected | The details were checked and work. |
| Not checked yet | Details are saved but have not been confirmed to work. |
| Check failed | The last check did not succeed. The reason is shown at the bottom of the integration's page. |
| No API access | The account works, but its subscription does not include API access. |
| Not connected | No details have been entered. |
Connect an integration
Open the integration
Go to Settings → Integrations and click Hudl StatsBomb or TransferRoom.
Enter the account details
Under Connection, enter the API username and password from the club's license (for TransferRoom: the email address and password of the TransferRoom account). When details are already saved, leave the password blank to keep the current one.
Connect
Click Connect. Agones checks the details with the provider and saves them when they work. Once connected, the button reads Reconnect.
If the provider cannot be reached at that moment, Save without checking appears. It saves the details anyway; use Reconnect later to confirm the connection. Disconnect removes the saved details.
Credentials are stored encrypted and cannot be viewed again, not even by the Football Director. A lost password has to be entered again.
Hudl StatsBomb
Hudl StatsBomb provides the player and match data for the squad, targets and Scouting.
Load the license
Once connected, the Player data card shows how many players and seasons are in Agones. The first time, a button loads every season in the club's license. This takes a few minutes; work can continue meanwhile.
Link teams
Link each team to its team in Hudl StatsBomb under Settings → Teams, with Hudl StatsBomb team. Linking starts a check straight away, and a notification follows when the squad is ready to bring in. See Teams and seasons.
Nightly updates
Every night, Agones checks Hudl StatsBomb for the current seasons of linked teams and of linked players. What it finds falls into two kinds:
| Kind | What happens |
|---|---|
| Match data for players already in Agones: match numbers, minutes, height, weight, date of birth | Applied automatically. Scores are recalculated for the players concerned. |
| Squad changes: new players in a linked team, or a target who now plays for one of the club's teams | Waits for review in the notifications. |
After an automatic update, the bell shows Match data updated with some of the players concerned, for seven days. Height and weight are only filled in when Agones does not have them yet.
Review squad changes
Open the notification
Open the bell and click Squad changes from Hudl StatsBomb, or use the Hudl StatsBomb card on the notifications page.
Review
The window lists the new players per team, who will be added to the squad, and any targets who will move from the targets list to the squad.
Apply or wait
Click Update now to apply the changes; scores are recalculated afterwards. Not now closes the window without changing the squad. The change stays in the notifications and can be applied later.
Only the Football Director can apply squad changes. Other roles see the notification with a note that the Football Director can bring it in.
Hudl StatsBomb never removes a player or marks a player as departed. That remains a decision for the club.
TransferRoom
TransferRoom provides each player's expected transfer value (xTV). Agones uses it as the player's value unless the club has entered its own value for that player, which always takes precedence.
The TransferRoom account needs API access, which is not part of every TransferRoom subscription. Without it, the status shows No API access.
Once connected, the Market values card has a Sync values button for the Football Director. It brings in the xTV for every player in the squad and reports how many values were updated. Players that could not be matched are listed by name; check their date of birth and surname in Agones. Values are synced when the button is used, not overnight.
Data changed by integrations
Changes made by Hudl StatsBomb or TransferRoom appear in the Activity log and in a player's history as made by Agones.