Integração Vengo OnSign
Requisitos:
- Uma conta OnSign ativa
- Uma conta Vengo ativa
-
Credenciais Vengo:
- ID da organização Vengo
- ID da unidade de anúncio Vengo geralmente é exclusivo para cada tela
-
Credenciais Vengo:
-
Requisitos do OnSign Player :
- player Windows , Android ou Linux - Executando o aplicativo OnSign versão 10.6.0 ou superior
- Samsung Tizen - Executando o aplicativo OnSign 10.6.3 ou superior e firmware 2430.3 ou superior
- LG webOS 4 ou 6 - Executando o aplicativo OnSign 10.6.3 ou superior e firmware 03.68.33/1.6.8 ou superior
IMPORTANTE - A integração programática não funcionará caso o aplicativo OnSign esteja desatualizado ou caso o firmware do SoC não esteja atendendo aos requisitos.
Embora não seja um requisito rigoroso, recomendamos fortemente o uso de aplicativos programáticos com o plano OnSign Pro ou superior, pois isso permitirá o uso de atributos personalizados Player como variáveis de entrada para os aplicativos programáticos.
Assinatura do Framework de Integração Programática OnSign
A Integração Programática é um serviço separado, não incluído nas licenças OnSign . Certifique-se de que sua conta tenha a assinatura dos Serviços de Integração Programática OnSign para ter acesso ao Vengo e a outras plataformas de anúncios programáticos.
Etapa 1 - Configurando atributos personalizados Player
Atributos personalizados Player atuam como variáveis locais que os aplicativos podem acessar durante a reprodução.
Cada Player pode ter seus próprios valores de atributos exclusivos, definidos e armazenados depois que o atributo é criado.
Isso torna os Atributos Personalizados especialmente úteis para armazenar credenciais programáticas. Em vez de configurar vários aplicativos, apenas um é necessário. Ao ser executado, o aplicativo recupera automaticamente as credenciais armazenadas no Player e as utiliza para fazer a solicitação de anúncio programática.
Embora os Atributos Personalizados possam ser criados nas Configurações da Conta, o aplicativo programático Vengo fornece um atalho interno que permite criar os Atributos Personalizados necessários diretamente do aplicativo.
- Clique no menu “Conteúdo”
- Crie ou navegue até a pasta onde o aplicativo Vengo deve ser armazenado
- Clique no botão “ Novo ” > Aplicativo > Digite “Vengo” na caixa de pesquisa e selecione o aplicativo Vengo.
- Digite um nome válido para que o aplicativo possa ser salvo mais tarde.
- Expanda os Atributos do aplicativo (é aqui que as credenciais devem ser inseridas)
- Na maioria dos casos, o “ ID da Organização Vengo ” será o mesmo para todos players , então ele pode ser inserido diretamente no aplicativo, o que significa que não é necessário criar um Atributo Personalizado para ele.
- O " ID da Unidade de Anúncios Vengo " geralmente é único para cada tela, então conecte-o a um Atributo Player Personalizado existente, caso você já o tenha, ou clique no menu suspenso, vá até o final e clique em "Criar Novo Atributo Player ". Basta seguir os passos para configurar um Atributo Player específico.
- Selecione o ambiente em que o aplicativo deve ser conectado: Produção ou Preparação.
- Selecione uma mídia de reserva. A mídia de reserva é uma imagem ou vídeo que será exibido quando não houver anúncios.
- Configure a Duração do Fallback. Isso é opcional e se aplica apenas ao fallback de mídia de imagens.
- Marque a opção “Ignorar reprodução quando nenhum anúncio estiver agendado” para que o comportamento desejado não interrompa a reprodução do aplicativo quando não houver nenhum anúncio a ser exibido.
- Agora que tudo está pronto, basta salvar o aplicativo!

Agora que os Atributos Player Personalizados foram criados, o ID da Organização Vengo e o ID da Unidade de Anúncio Vengo devem ser configurados em todos players que usarão o
Observação
- O ID da unidade de anúncio do Vengo deve ser exclusivo para cada tela ou player configurado.
- Atributos personalizados diferenciam maiúsculas de minúsculas e devem ser inseridos com a grafia exata.
Etapa 3 - Definindo o ID da unidade de anúncio do Vengo para cada player
Embora o aplicativo esteja pronto para ser publicado, ainda é necessário definir o ID da unidade de anúncio do Vengo para cada player por meio do Atributo Player personalizado configurado anteriormente.
Este processo precisa ser executado para cada player que reproduzirá o aplicativo Vengo.
- Clique no menu player
- Selecione o player a ser configurado
- Clique nas configurações player
- Localize a unidade de anúncio Vengo (atributo Player personalizado)
- Insira a unidade de anúncio Vengo
- Salvar as configurações
Etapa 4 - Publicação do aplicativo Vengo
Agora que tudo está pronto, o único passo restante é publicar o aplicativo!
Aplicativos programáticos são considerados de "Duração de Conteúdo Variável", o que significa que sua duração pode variar dependendo do anúncio recebido. Embora isso ofereça flexibilidade, também exige cuidado extra ao decidir como esses aplicativos são posicionados ou publicados.
Regra principal: aplicativos de comprimento de conteúdo variável podem ser ignorados completamente ou encerrados antes da duração definida, mas nunca podem exceder o tempo alocado ao item.
Exemplo: Suponha que um Aplicativo Programático seja inserido dentro de um item de uma playlist com duração de 10 segundos. Na prática, isso significa:
- Se nenhum anúncio estiver disponível e o aplicativo estiver configurado para pular, o item poderá ser pulado.
- Se um anúncio com menos de 10 segundos for recebido (por exemplo, 7 segundos), o anúncio será reproduzido e terminará em 7 segundos e, em seguida, passará suavemente para o próximo item na playlist .
- Se um anúncio com mais de 10 segundos for recebido, o aplicativo será reproduzido, mas será interrompido em 10 segundos. Como o anúncio não foi exibido na íntegra, a confirmação não será enviada para a plataforma programática — o que significa que este anúncio provavelmente não será pago.
Importante
Para evitar esses problemas, sempre configure o aplicativo programático com uma duração que seja pelo menos tão longa quanto a mídia que ele deve reproduzir.
Etapa 5 - Testando suas credenciais
O Vengo requer duas credenciais para recuperar anúncios corretamente:
- ID da organização Vengo - Número exclusivo para identificar a rede de publicidade
- Vengo Ad Unit ID - ID exclusivo para identificar o espaço de anúncio específico (tela).
Para testar e garantir que suas credenciais estão corretas, basta copiar esta URL no seu navegador, substituindo os respectivos itens pelas suas credenciais.
Testando credenciais no ambiente de teste do Vengo:
https://staging-pubads.vengolabs.com/trafficking/vast/ad_request?organization_id=[VengoOrganizationID]&ad_unit_id=[VengoAdUnit ID]
Testando credenciais no ambiente de produção do Vengo:
https://pubads.vengolabs.com/trafficking/vast/ad_request?organization_id=[VengoOrganizationID]&ad_unit_id=[VengoAdUnit ID]