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).

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.

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 que dure pelo menos 15 segundos ou em uma Playlist , e então o item Playlist deverá ser definido como 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)
• dgg3rnz8nudgw.cloudfront.net (Para baixar os arquivos criativos)
• cdn-apps.hivestack.com (Para baixar os arquivos criativos)

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]