Para facilitar a integração com diversos SSPs de mídia programática, a 4yousee desenvolveu um aplicativo que permite a conexão automática e facilitada com vários fornecedores, como Hivestack, PlaceExchange, AdsMovil, Outcon, Magnite, Aqui Ads, AdMooH e adzymic.
Este documento fornece as orientações necessárias para que você possa configurar corretamente cada SSP e integrar seu conteúdo publicitário de maneira eficaz.
Passo 1: Preparar o Conteúdo
- Baixe o arquivo .zip
- Baixe o conteúdo que deseja utilizar. Neste artigo possuímos um conteúdo de template para download: Baixar modelo programático
- Baixe o conteúdo que deseja utilizar. Neste artigo possuímos um conteúdo de template para download: Baixar modelo programático
- Acesse a plataforma 4yousee Manager
- Entre na sua conta no 4yousee Manager.
Passo 2: Carregar o Conteúdo
Caso deseje mais informações sobre como adicionar um conteúdo consulte o artigo: Como adicionar conteúdos?
1. Carregar o arquivo .zip
- Na tela principal, acesse o menu Conteúdo -> Conteúdo.
- Clique em Adicionar e selecione o seu arquivo.
2. Configurar o Conteúdo
- Após o upload, selecione a Categoria em que o conteúdo será inserido.
- Em seguida vá para aba Metadados. Saiba como Habilitar Metadados
3. Configurar Metadados
- Acessar a aba Metadados
- Do lado direito serão exibidas as opções de integrações disponíveis. Basta clicar sobre uma delas e preencher os parâmetros correspondentes nos campos do lado esquerdo de acordo aos dados fornecidos pela empresa de mídia programática.
- Salvar Configurações
- Após adicionar os parâmetros, clique no botão Adicionar para confirmar as configurações.
Cada SSP possui suas próprias credências e endpoints que precisam ser configurados. Segue uma lista dos principais SSPs suportados e os campos de metadados que devem ser configurados.
| Campo | Descrição | Obrigatório |
|---|---|---|
| Hivestack | ||
| hivestack_adServerURL | URL do servidor de anúncios do Hivestack. | ✔ Sim |
| hivestack_apiKey | Chave API para autenticação e acesso à API do Hivestack. | ✔ Sim |
| hivestack_serverCache | Servidor de cache. | Opcional |
| Place Exchange | ||
| placeexchange_orgId | ID da organização no PlaceExchange. | ✔ Sim |
| placeexchange_adServerURL | URL do servidor de anúncios do PlaceExchange. | ✔ Sim |
| placeexchange_username | Nome de usuário para autenticação. | ✔ Sim |
| placeexchange_password | Senha para autenticação. | ✔ Sim |
| placeexchange_serverCache | Servidor de cache. | Opcional |
| Adsmovil | ||
| adsmovil_deal | UUID do negócio configurado. | ✔ Sim |
| adsmovil_apiKey | Token de Integração AdsMovil. | ✔ Sim |
| adsmovil_serverCache | Servidor de cache. | Opcional |
| Outcon | ||
| outcon_publisher | ID do publisher no Outcon. | ✔ Sim |
| outcon_serverCache | Servidor de cache. | Opcional |
| Magnite | ||
| magnite_dealId | ID do acordo de publicidade (deal ID). | ✔ Sim |
| magnite_boxingAllowed | 0 mantém o aspecto; 1 aceita qualquer formato. | ✔ Sim |
| magnite_adDuration | Duração do anúncio (segundos). | ✔ Sim |
| magnite_site_id | ID do site cadastrado na Magnite. | ✔ Sim |
| magnite_language | Idioma (pt | es). | ✔ Sim |
| magnite_country | País (BR, AR, MX, etc.). | ✔ Sim |
| Aqui Ads | ||
| aquiads_token | Token de autenticação EDN. | ✔ Sim |
| aquiads_adServerURL | URL do servidor de anúncios EDN. | ✔ Sim |
| Admooh | ||
| admooh_companyId | ID da empresa no Admooh. | ✔ Sim |
| admooh_adServerURL | URL do servidor de anúncios Admooh. | ✔ Sim |
| Adzymic | ||
| adzymic_urlVast | URL do VAST fornecido pela Adzymic. | ✔ Sim |
| adzymic_urlHtml | URL do criativo HTML responsivo. | ✔ Sim |
| adzymic_vastType | Tipo do criativo (video | html). | ✔ Sim |
| adzymic_width | Largura da tela (px). | ✔ Sim |
| adzymic_height | Altura da tela (px). | ✔ Sim |
| adzymic_refreshInterval | Intervalo de atualização do HTML (segundos). | ✔ Sim |
| adzymic_serverCache | Servidor de cache. | Opcional |
Passo 3: Habilitar Campos Personalizados
- Criar Campos Personalizados
- Na tela principal, vá para opção Players(1) -> Campos Personalizados(2).
- Na tela de Campos Personalizados clique no botão Template(3)
- Na tela que abrir habilite a integração de campos(4) para empresa de programática que deseja utilizar.
*Para a adMooH os passos 3 & 4 não são necessários. |
Passo 4: Configurar Campos Personalizados em Player
Configurar Campos Personalizados nos players
Acesse a opção Players(1) -> Players(2) e escolha na lista o player que deseja configurar.
Na coluna operações, clique no ícone Alterar(3), em seguida na aba Campos Personalizados(4).
Adicione os parâmetros(5):
Cada SSP habilitada possui seus próprios parâmetros, que devem ser preenchidos de acordo com o que será fornecido
*Para cada tela onde o conteúdo de mídia programática será exibido, é necessário preencher o ID da tela conforme o ID disponibilizado pelo seu SSP. Essa configuração é fundamental para garantir que os anúncios corretos sejam exibidos na tela específica onde a mídia está rodando. |
2. Salvar Configurações do Player
- Após adicionar o valor para o parâmetro, clique em Alterar para confirmar as configurações.
Passo 5: Verificar e Publicar
- Verificar Configurações
- Revise todos os detalhes para garantir que os metadados e campos personalizados estejam corretos.
- Publicar o Conteúdo
- Se tudo estiver certo, insira o conteúdo na playlist do player em que o conteúdo será exibido.
Se você tiver dúvidas sobre a configuração de metadados ou qualquer outra etapa do processo, consulte a documentação sobre metadados para mais informações. Como Criar Aplicativos Integrados com Campos de Metadados