Integração Hivestack OnSign TV

Plataformas programáticas são uma forte tendência e uma ótima maneira de aumentar as vendas de anúncios DOOH.

Hivestack é uma plataforma de publicidade programática completa e mundial que oferece fácil acesso aos maiores DSPs do mercado, como Yahoo OmniChannel e Google DV360.

Este tutorial descreve como integrar OnSign TV Screens com o Hivestack.

Requisitos:

• Uma conta ativa OnSign TV
• Uma conta Hivestack ativa
• Você deve ter uma chave de API Hivestack fornecida pela Hivestack para fazer solicitações de anúncios
• Você precisará de um ID de tela do Hivestack para cada tela Player
   
• Requisitos Player :

A conta OnSign TV deve ser habilitada para os seguintes recursos que não são habilitados por padrão:

• Atributos personalizados
• Eventos de aplicativos
• Aplicativo Hivestack

Etapa 1 - Configurando atributos personalizados Player

Atributos personalizados Player funcionam como variáveis locais Player que os aplicativos podem acessar durante o tempo de reprodução.

Depois que um Atributo Player Personalizado for criado no menu de configurações, será possível inserir um Atributo Personalizado para cada Player .

Atributos personalizados Player são configurados em cada Player em Configurações > Atributos personalizados

Para usar o aplicativo Hivestack, estes dois atributos personalizados devem ser configurados:

• Chave de API do Hivestack - Digite Texto
• ID da tela do Hivestack - Digite texto

Agora que os Atributos Personalizados Player foram criados, a Chave de API do Hivestack e o ID da Tela precisam ser configurados nas configurações de cada Player .

1. Clique no Menu Player
2. Selecione um Player específico
3. Clique em Configurações
4. Insira a chave da API do Hivestack e o ID da tela do Hivestack

Etapa 2 - Configurar o aplicativo Hivestack

A configuração do aplicativo Hivestack segue o mesmo processo de qualquer outro aplicativo de conteúdo OnSign TV.

Clique no menu Conteúdo e navegue até a pasta onde o aplicativo Hivestack deve ser armazenado.

Clique no botão Novo > Aplicativo > Digite "Hivestack" na caixa de pesquisa e selecione o aplicativo Hivestack.

1 - Configure o nome do aplicativo (como qualquer outro aplicativo OnSign TV).

Para os Atributos do Aplicativo, você pode escolher entre usar um atributo de player personalizado ou escrever os IDs do Hivestack na caixa de texto abaixo. Se o Aplicativo estiver conectado a um atributo de player e houver texto escrito na caixa de texto, o atributo de player terá precedência.

2 - Selecione o ambiente Hivestack ao qual o aplicativo deve se conectar. Pode ser S- tag , caso você ainda esteja validando a solução, ou Produção, caso seu ambiente esteja configurado e pronto para exibir anúncios ao seu público.

3 - Selecione uma imagem de reserva. Isso será exibido quando não houver nenhuma imagem criativa disponível no Hivestack ou quando não houver tempo suficiente para recuperar a imagem criativa da plataforma Hivestack.

O modo de depuração pode ser ativado para fornecer informações adicionais. Esta é uma maneira prática de garantir que tudo esteja funcionando conforme o esperado ou de depurar o que está errado caso o aplicativo não esteja apresentando os criativos corretamente. Quando o modo de depuração estiver ativado, o aplicativo não pulará se nenhum anúncio estiver programado.

Erros comuns são:

• Usar uma chave de API errada ou uma ID de tela inválida não permitirá que o aplicativo obtenha os criativos do servidor Hivestack.
• A mídia é muito grande e o download completo não foi executado a tempo para ser apresentado. Não se preocupe, pois a mídia será baixada em segundo plano e deverá ser apresentada normalmente no próximo ciclo.

Aqui está um aplicativo publicado com o modo de depuração habilitado.

Observe que, como a mídia recuperada tem 20 segundos de duração, a reprodução dessa mídia será exatamente 20 segundos, mesmo que a duração publicada do contêiner seja maior.

Etapa 3 - Crie uma campanha wrapper

O aplicativo Hivestack tem um comportamento de comprimento variável. Isso permite a reprodução de Criativos com durações diferentes provenientes do Hivestack. Para tag esse recurso, o aplicativo Hivestack deve ser colocado em um contêiner que tenha pelo menos o mesmo comprimento do maior Criativo a ser apresentado.

Por exemplo, se o criativo tiver uma duração máxima de 15 segundos, o aplicativo deverá ser colocado em uma campanha com duração variável e o aplicativo durando pelo menos 15 segundos ou em uma Playlist com o aplicativo durando 15 segundos.

Ainda assim, devido ao seu comportamento variável, se o Criativo recebido tiver apenas 10 segundos de duração, o item será reproduzido por apenas 10 segundos e pulará para o próximo item.

Etapa 4 - Relatório de reprodução do aplicativo Hivestack

OnSign TV pode fornecer dois relatórios diferentes para o aplicativo Hivestack:

• Relatório de reprodução de conteúdo - Contará as vezes que o aplicativo Hivestack foi apresentado.
• Eventos do Aplicativo - Fornece informações detalhadas sobre cada mídia reproduzida pelo aplicativo Hivestack. Esta é uma ótima maneira de cruzar o número de anúncios exibidos, comparando-os com os relatórios da Plataforma Hivestack.

Requisitos de firewall

Além das configurações do firewall OnSign , certifique-se de que os seguintes domínios possam ser acessados por cada player que precisa apresentar anúncios programáticos do Hivestack:

• apps.hivestack.com (Para enviar solicitações de anúncios e reproduzir chamadas de confirmação)
• cdn-apps.hivestack.com (Para baixar os arquivos criativos)
• *.hsdlv.com (Para baixar os arquivos criativos - novo)
• dgg3rnz8nudgw.cloudfront.net (Para baixar os arquivos criativos - eliminado gradualmente em agosto de 2025) 

Investigando Erros

Se o aplicativo Hivestack não estiver se comportando conforme o esperado, os problemas mais prováveis são:

• Sem rede – Se não houver rede, o aplicativo não poderá verificar se há um anúncio designado a ser apresentado.
• Credenciais erradas ou ausentes – Se o OrgID ou o Screen ID estiverem ausentes, o aplicativo não poderá consultar os anúncios disponíveis.

Testando suas credenciais do Hivestack

Testar suas credenciais do Hivestack é bem simples, basta abrir uma das duas URLs abaixo, substituindo [ScreenID] e [Org_ID] pelas suas credenciais.

S tag – Se suas credenciais funcionam apenas no ambiente de teste e tag

https://uat.hivestack.com/nirvana/api/v1/units/schedulevast/[SCREEN_ID]?apikey=[API_KEY]

Produção – Se suas credenciais já estiverem disponíveis no ambiente de produção

https://apps.hivestack.com/nirvana/api/v1/units/schedulevast/[SCREEN_ID]?apikey=[API_KEY]