Neste artigo:
- Introdução aos elementos dinâmicos
- Como começar a usar elementos dinâmicos
- Como vincular sua API a elementos na sua sobreposição
- Dicas e truques para usar elementos dinâmicos
Introdução aos elementos dinâmicos
Elementos dinâmicos é um recurso disponível no painel de sobreposição interativo para extrair conteúdo de qualquer API aberta e integrá-lo à sobreposição. Os elementos dinâmicos também podem ser vinculados a URLs de clique nas ações do elemento.
Todos os elementos permitem que os usuários adicionem seu próprio conteúdo e o combinem com conteúdo ou ações da API. Você pode injetar um ponto de extremidade aberto de API e atribuir instantaneamente valores para vários elementos de sobreposição na sua sobreposição.
Algumas vantagens do uso de elementos dinâmicos são:
- Incluir conteúdo dinâmico nas suas sobreposições permite uma integração e conexão mais profundas com os sistemas existentes que gerenciam seus dados, produtos, informações etc.
- Como criar um ativo de vídeo mais bem conectado
- Sempre forneça ao seu público os dados e informações mais precisos e atualizados
- Inclua em tempo real nas suas sobreposições qualquer tipo de dado relevante de uma variedade de fontes.
- Dimensione sua produção de vídeo interativo e economize tempo ao atualizar manualmente seus dados e conteúdo
Como começar a usar elementos dinâmicos
Para usar elementos dinâmicos, você precisa de duas coisas:
- Uma API REST aberta que retorne dados no formato JSON
- Um vídeo interativo que usa sobreposições
Quando tiver ambos, navegue até o editor de sobreposição.Você encontrará o botão Elementos dinâmicos na parte superior da página.
Clicar nele abrirá o gerenciador de API, onde você pode adicionar, editar e excluir APIs associadas ao seu vídeo interativo.
Para adicionar uma API:
- Clique no botão Elementos dinâmicos.A seguinte janela modal será aberta:
- Dê um nome à sua API
- Insira a URL da sua API no campo URL da API
- Clique no botão + Adicionar API para adicionar a API ao seu vídeo.
Você pode adicionar várias APIs ao seu vídeo ou, se sua API for compatível, filtrar as respostas dela adicionando URLs de API filtradas.
Como vincular sua API a elementos na sua sobreposição
Para conectar um elemento de sobreposição a dados dinâmicos da sua API:
- Adicione um elemento novo ou selecione um existente do seu design de sobreposição. No exemplo abaixo, um elemento de texto foi selecionado.
- No menu à direita na seção "Elemento dinâmico", ative a opção Link para API para abrir as configurações do elemento dinâmico do elemento.
- Selecione a API à qual você deseja conectar o item no menu suspenso da API.
- Depois de selecionar uma API, clique em + Adicionar dados dinâmicos.
- Isto abrirá a janela modal "Selecionar uma resposta".Aqui você pode ver a resposta completa da API chamada a partir da URL que você inseriu.Use as setas para encontrar os valores de cada item.
- Selecione a resposta da saída da API clicando no campo desejado diretamente na resposta. Em seguida, clique em Confirmar.
-
No caso da função "Elemento Dinâmico" para textos, você verá o atalho de código gerado no contêiner de texto enquanto estiver no modo de edição. Observação: para elementos vinculados a uma API, o ícone do elemento dinâmico é exibido ao lado da caixa de seleção.
- Assim que você sair do modo de edição do elemento de texto, a resposta será exibida com os dados atuais do valor de API selecionado.
Dicas e truques para usar elementos dinâmicos
- Se você não tem uma API ou precisa de uma API para uma tarefa específica que sua API atual não oferece, confira ferramentas como Sheetlabs, que podem transformar qualquer planilha em uma API.
- A função de elemento dinâmico de "parâmetros customizados" é útil para personalizar consultas de API. No momento, os elementos dinâmicos são compatíveis apenas com APIs públicas. Por motivos de segurança, você deve evitar o uso de parâmetros customizados para anexar chaves de API.