The Soccer Trigger is an OnSign plugin that monitors live soccer matches and automatically triggers actions on a player when specific events occur, such as goals, victories, or draws.
Using real-time match data, the Soccer Trigger allows you to display targeted content—such as animations, campaigns, videos, overlays, or promotional messages—at the exact moment an event happens.
This makes it ideal for sports bars, stadiums, retail stores, corporate environments, and other digital signage deployments that want to react dynamically to live soccer events and enhance audience engagement.
How it works
The Soccer Trigger plugin runs in the background on the player and continuously monitors events from the configured match. When a selected event occurs—such as a goal, victory, draw, match start, or match end—the plugin sends a predefined value to the player's Local API.
This value activates the corresponding trigger configured on the player, which then executes the desired playback action, such as displaying a campaign, playing a video, showing an animation, or launching other interactive content.
For the integration to work correctly, two configurations are required:
- Create and configure the Soccer Trigger plugin in the Content Manager.
- Configure triggers on the player from the Triggers & Interactivity tab, using the values defined in the Soccer Trigger plugin.
Once both configurations are in place, the player will automatically react to live match events without requiring any manual intervention.
Configuring the plugin
Step 1 — Create the App
- From the main menu, go to Content.
- Click New + and select App.
- In the category filter, select Player Plugins.
- Locate and select Soccer Trigger.
Step 2 — Configure the Plugin
On the Soccer Trigger configuration screen, fill in the following fields:
- App Name: A descriptive name used to identify the plugin in the Content Manager. Choose a name that clearly indicates the team or competition being monitored.
- Tags (Optional): Associate one or more tags with the plugin to improve organization and content management.
- Championship: Select the championship or competition that the plugin should monitor. Example: World Cup.
- Filter by Team (Optional): Restricts monitoring to events involving a specific team. The filter performs a partial, case-insensitive match. For national teams, use the English country name (for example, Brazil, Germany, or Argentina). Leave this field blank to monitor all teams within the selected championship.
-
Local API – On Goal (Optional): The value sent to the player's Local API whenever a goal is scored. This value must exactly match the value configured in the Contains field of the corresponding player trigger. Example:
brazil-goal -
Local API – On Win (Optional): The value sent to the player's Local API when a monitored match ends with a winner. This value must exactly match the value configured in the corresponding player trigger. Example:
brazil-win -
Local API – On Draw (Optional): The value sent to the player's Local API when a monitored match ends in a draw. This value must exactly match the value configured in the corresponding player trigger. Example:
brazil-draw
Notice that the Local API fields are individually optional — only configure the events you want to monitor.
Once the plugin is configured and published, it will begin monitoring the selected competition and sending the configured Local API values whenever the corresponding events occur. These values can then be used to trigger content playback through the player's Triggers & Interactivity settings.
- Click Save and Publish.
Configuring triggers on the Player
Step 3 — Configure Player Triggers
Once the plugin has been published, configure triggers on the player to react to the events generated by the Soccer Trigger plugin.
- Open the desired player in the Player Manager.
- Navigate to the Triggers & Interactivity tab.
- Click + Add Trigger.
Configure the trigger with the following settings:
- Name: Enter a descriptive name for the trigger (for example, Brazil Goal).
- When: Select Local API.
-
Contains: Enter the exact value configured in the Soccer Trigger plugin, such as
brazil-goal. - Action: Define the action to execute when the trigger is activated, including the content to play, the target loop, and the playback duration. For example, play a goal celebration video in the Playing Loop for 30 seconds.
Check the example configuration below:
- Save the trigger configuration.
Repeat the process for each event you want to monitor, such as goals, wins, and draws:
When the Soccer Trigger plugin detects one of these events, it sends the corresponding value to the player's Local API. The matching trigger is then activated automatically, causing the configured content to play immediately.
Notice that the value in the Contains field must be identical to what was configured in the Local API fields of the plugin. Any difference in text will prevent the trigger from firing.
Troubleshooting
- The trigger does not fire when a goal occurs: The value in the Contains field does not exactly match the value configured in the Local API – On Goal field of the plugin. Check for extra spaces, incorrect characters, or mismatched capitalization.
- The plugin monitors teams that were not configured: The Filter by Team field was left blank. When this field is empty, the plugin generates events for any team participating in matches within the selected championship. Enter the desired team name to restrict monitoring.
- The content configured in the trigger is not displayed: Confirm that the plugin is Published and assigned to the correct player. Also verify that the trigger is enabled and that the configured action points to a valid and available content item.
- No events are detected even when a match is in progress: Verify that the championship selected in the Championship field is correct and that there are active matches currently being monitored by the service. Also ensure that the player is online and communicating with the OnSign platform.