Integração do Place Exchange OnSign

Requisitos:

• Uma conta ativa OnSign TV
• Uma conta PlaceExchange ativa
• Você deve ter um ID de organização PlaceExchange fornecido pelo PlaceExchange
• Você precisará de um nome de unidade de anúncio do PlaceExchange para cada tela de Player
• Requisitos Player:
  • Player Windows, Android ou Linux - Executando o aplicativo OnSign TV versão 10.3.0 ou superior
  • Samsung SSSP6 - Executando o aplicativo OnSign TV 10.3.5 ou superior e firmware 2430.3 ou superior
  • LG webOS 6 - Executando o aplicativo OnSign TV 10.3.5 ou superior e firmware 03.68.33/1.6.8 ou superior

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
• Plugin do Player
• Aplicativo PlaceExchange

Etapa 1 - Configurando atributos personalizados de Player

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

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

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

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

• ID da organização PlaceExchange - Digite Texto
• Nome da unidade de anúncio do PlaceExchange - Digite Texto

Agora que os Atributos Personalizados de Player foram criados, o ID da Organização e o ID da Tela do PlaceExchange 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 o ID da organização e o ID da tela do PlaceExchange

Etapa 2 - Configurar o aplicativo PlaceExchange

A configuração do aplicativo Place Exchange 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 Place Exchange deve ser armazenado.

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

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

2 - Selecione uma mídia de fallback . Isso será exibido quando não houver nenhum criativo disponível no PlaceExchange ou quando não houver tempo suficiente para recuperar o criativo da plataforma PlaceExchange.

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 um ID de organização do PlaceExchange ou um nome de unidade de anúncio não permitirá que o aplicativo obtenha os criativos do servidor PlaceExchange.
• Caso a mídia seja muito grande e o download completo não tenha sido 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 - Plugin programático para cada player

Além de um aplicativo dedicado para cada plataforma SSP, a equipe OnSign desenvolveu um plugin de Anúncio Programático. Este plugin fornece um canal de retorno para cada SSP programático, confirmando a reprodução de cada anúncio programático.

O processamento da confirmação programática de anúncios por meio do plugin oferece uma vantagem significativa: garante que o evento não dependa do horário de exibição do anúncio. Essa arquitetura aumenta a confiabilidade e resiste a problemas temporários de rede, permitindo que o plugin confirme a reprodução do anúncio até 10 minutos após sua ocorrência.

O Plugin Programático é genérico, suportando todas as plataformas programáticas integradas OnSign TV. É necessário adicionar apenas uma instância por player.

Portanto, para qualquer player que apresente Anúncios Programáticos, um Plugin Programático deve ser configurado e instalado.

Etapa 4 - Crie uma campanha wrapper

O aplicativo PlaceExchange possui um comportamento de duração variável. Isso permite a reprodução de Criativos com durações diferentes provenientes do PlaceExchange. Para tirar vantagem desse recurso, o aplicativo PlaceExchange 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 lista de reprodução, e então o item da lista de reprodução 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 5 - Relatório de reprodução de aplicativo programático

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

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

Investigando Erros

Se o aplicativo PlaceExchange 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, por algum motivo, o OrgID ou o Screen ID estiverem ausentes, o aplicativo não poderá consultar os anúncios disponíveis.