O Soccer Trigger é um plugin do OnSign que monitora partidas de futebol ao vivo e aciona automaticamente ações em um player quando eventos específicos ocorrem, como gols, vitórias ou empates.
Utilizando dados de partidas em tempo real, o Soccer Trigger permite exibir conteúdo direcionado — como animações, campanhas, vídeos, sobreposições ou mensagens promocionais — no exato momento em que um evento acontece.
Isso o torna ideal para bares esportivos, estádios, lojas de varejo, ambientes corporativos e outras instalações de sinalização digital que desejam reagir dinamicamente a eventos de futebol ao vivo e aumentar o engajamento do público.
Como funciona
O plugin Soccer Trigger é executado em segundo plano no player e monitora continuamente os eventos da partida configurada. Quando um evento selecionado ocorre — como um gol, vitória, empate, início ou fim da partida — o plugin envia um valor predefinido para a API local do player.
Esse valor ativa o gatilho correspondente configurado no player, que então executa a ação de reprodução desejada, como exibir uma campanha, reproduzir um vídeo, mostrar uma animação ou iniciar outro conteúdo interativo.
Para que a integração funcione corretamente, são necessárias duas configurações:
- Crie e configure o plugin Soccer Trigger no Gerenciador de Conteúdo.
- Configure os gatilhos no player na aba Gatilhos e Interatividade, usando os valores definidos no plugin Soccer Trigger.
Assim que ambas as configurações estiverem implementadas, o player reagirá automaticamente aos eventos da partida ao vivo, sem necessidade de intervenção manual.
Configurando o plugin
Etapa 1 — Criar o aplicativo
- No menu principal, acesse Conteúdo.
- Clique em Novo + e selecione Aplicativo.
- No filtro de categoria, selecione Plugins Player.
- Localize e selecione Soccer Trigger.
Etapa 2 — Configurar o Plugin
Na tela de configuração do Soccer Trigger, preencha os seguintes campos:
- Nome do aplicativo: Um nome descritivo usado para identificar o plugin no Gerenciador de Conteúdo. Escolha um nome que indique claramente a equipe ou competição que está sendo monitorada.
- Etiquetas (Opcional): Associe uma ou mais etiquetas ao plugin para melhorar a organização e o gerenciamento de conteúdo.
- Campeonato: Selecione o campeonato ou competição que o plugin deve monitorar. Exemplo: Copa do Mundo.
- Filtrar por Equipe (Opcional): Restringe o monitoramento a eventos que envolvam uma equipe específica. O filtro realiza uma correspondência parcial, sem distinção entre maiúsculas e minúsculas. Para seleções nacionais, use o nome do país em inglês (por exemplo, Brazil, Germany ou Argentina). Deixe este campo em branco para monitorar todas as equipes do campeonato selecionado.
-
API Local – Ao marcar um gol (Opcional): O valor enviado para a API Local do player sempre que um gol é marcado. Este valor deve corresponder exatamente ao valor configurado no campo "Contém" do gatilho do player correspondente. Exemplo:
brazil-goal -
API Local – Na Vitória (Opcional): O valor enviado para a API Local do player quando uma partida monitorada termina com um vencedor. Este valor deve corresponder exatamente ao valor configurado no gatilho player correspondente. Exemplo:
brazil-win -
API Local – Em Caso de Empate (Opcional): O valor enviado para a API Local do player quando uma partida monitorada termina em empate. Este valor deve corresponder exatamente ao valor configurado no gatilho player correspondente. Exemplo:
brazil-draw
Observe que os campos da API Local são opcionais individualmente — configure apenas os eventos que deseja monitorar.
Após a configuração e publicação do plugin, ele começará a monitorar a competição selecionada e a enviar os valores da API Local configurados sempre que os eventos correspondentes ocorrerem. Esses valores podem então ser usados para acionar a reprodução de conteúdo por meio das configurações de Gatilhos e Interatividade do player.
- Clique em Salvar e Publicar.
Configurando gatilhos no Player
Etapa 3 — Configurar gatilhos Player
Após a publicação do plugin, configure os gatilhos no player para reagir aos eventos gerados pelo plugin Soccer Trigger.
- Abra o player desejado no Gerenciador Player.
- Acesse a aba Gatilhos e Interatividade.
- Clique em + Adicionar gatilho.
Configure o gatilho com as seguintes configurações:
- Nome: Insira um nome descritivo para o gatilho (por exemplo, Gol do Brasil).
- Quando: Selecione API Local.
-
Contém: Insira o valor exato configurado no plugin Soccer Trigger, como
brazil-goal. - Ação: Defina a ação a ser executada quando o gatilho for ativado, incluindo o conteúdo a ser reproduzido, o loop de destino e a duração da reprodução. Por exemplo, reproduzir um vídeo de comemoração de gol no Loop de Reprodução por 30 segundos.
Confira o exemplo de configuração abaixo:
- Salve a configuração do gatilho.
Repita o processo para cada evento que você deseja monitorar, como gols, vitórias e empates:
Quando o plugin Soccer Trigger detecta um desses eventos, ele envia o valor correspondente para a API local do player. O gatilho correspondente é então ativado automaticamente, fazendo com que o conteúdo configurado seja reproduzido imediatamente.
Observe que o valor no campo "Contém" deve ser idêntico ao que foi configurado nos campos da API Local do plugin. Qualquer diferença no texto impedirá que o gatilho seja acionado.
Solução de problemas
- O gatilho não é acionado quando uma meta é atingida: o valor no campo "Contém" não corresponde exatamente ao valor configurado no campo "API Local – Ao atingir a meta " do plugin. Verifique se há espaços extras, caracteres incorretos ou erros de capitalização.
- O plugin monitora equipes que não foram configuradas: o campo "Filtrar por Equipe" foi deixado em branco. Quando este campo está vazio, o plugin gera eventos para qualquer equipe que participe de partidas dentro do campeonato selecionado. Insira o nome da equipe desejada para restringir o monitoramento.
- O conteúdo configurado no gatilho não está sendo exibido: confirme se o plugin foi publicado e atribuído ao player correto. Verifique também se o gatilho está ativado e se a ação configurada aponta para um item de conteúdo válido e disponível.
- Nenhum evento é detectado mesmo quando uma partida está em andamento: verifique se o campeonato selecionado no campo "Campeonato" está correto e se há partidas ativas sendo monitoradas pelo serviço. Certifique-se também de que o player esteja online e se comunicando com a plataforma OnSign.