> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Modelos de Banners de Anúncios Nativos
export const LastUpdatedPt = ({date}) => {
const label = "Última atualização:";
return <>
;
};
Os marketplaces usam anúncios nativos que consistem não apenas em imagens, mas também em múltiplos
campos de texto, imagens de fundo, imagens de primeiro plano e outros elementos
personalizáveis. Esses elementos podem variar entre diferentes posicionamentos, tornando
desafiador manter a consistência e otimizar a criação de anúncios entre
campanhas.
Os modelos criativos fornecem uma solução oferecendo banners pré-projetados que
permitem às equipes construir anúncios rapidamente seguindo uma estrutura organizada e repetível.
Esses modelos são altamente personalizáveis e podem incluir campos
específicos. Seja necessário campos para um botão, imagens, títulos,
parâmetros personalizados ou outros elementos de design, os modelos permitem padronizar e
simplificar o processo.
**Limitação de Gerenciamento de Modelos**: Atualmente, os modelos não podem ser editados ou
excluídos uma vez criados. Planeje cuidadosamente a estrutura do seu modelo antes da criação
para garantir que atenda às suas necessidades de campanha a longo prazo.
## Como Funciona
### Criando um Novo Modelo
Os varejistas podem criar modelos personalizados adaptados às suas necessidades. Esses modelos
podem ser configurados com vários campos, como texto, imagens, links externos
e outros elementos, para atender aos requisitos específicos do posicionamento. Veja
como você pode criar e configurar um novo modelo:
* **Tipo de Campo**: Escolha entre texto, imagem, seleção, botão, link, etc.
* **Variável**: O nome da variável que o campo vai usar.
* **Nome do Campo**: Defina um rótulo claro para o campo para identificá-lo no processo de criação da campanha.
* **Descrição**: Forneça uma explicação ou instruções sobre o que deve ser inserido no campo.
* **Obrigatório ou Opcional**: Decida se o campo é obrigatório para os anunciantes preencherem, ou se pode ser deixado em branco.
* **MinLength**: número mínimo de caracteres para campos de texto
* **MaxLength**: número máximo de caracteres para campos de texto
* **Default**: valor padrão para o campo
* **Prefix**: para campos do tipo link, eles começarão com o prefixo
* **MultiSelect**: para campos do tipo seleção se o usuário deve selecionar um ou múltiplos
* **Options (querystring)**: chaves e valores para campos do tipo seleção
Isso pode ser feito usando um CSV ou a UI
**
**
URLs de visualização dinâmica permitem visualização em tempo real de como os campos do modelo
aparecerão no posicionamento real do anúncio. O sistema de visualização carrega sua URL especificada
em um iframe e preenche dinamicamente as variáveis do modelo com dados da campanha.
Antes de configurar a visualização dinâmica no modelo, certifique-se de ter uma URL de visualização disponível que possa renderizar a estrutura do modelo. Isso pode ser em seu ambiente de desenvolvimento local ou em uma aplicação de staging implantada.
Configure sua URL de visualização dinâmica usando marcadores de variáveis de modelo. A estrutura da URL deve incluir parâmetros que correspondem aos campos do seu modelo:
```
https://your-preview-domain.com/?slotId=slot-1&headline={headline}&mainImage={urlEncodedImageURL}&price={price}&availability={availability}
```
O sistema de visualização substituirá automaticamente as variáveis do modelo na URL com valores reais conforme os anunciantes preenchem os campos da campanha, permitindo atualizações de visualização em tempo real.
Sua URL de visualização deve incluir a lógica necessária do lado do cliente para localizar e preencher elementos do modelo com os parâmetros fornecidos.
**Requisitos da URL de Visualização**: Sua URL de visualização deve estar acessível e incluir
a lógica de renderização necessária para exibir o conteúdo do modelo corretamente. O
sistema usa JavaScript do lado do cliente para substituir conteúdo dentro de elementos de modelo
designados.
### Usando Modelos
## Estrutura de Resposta do Modelo
Cada vencedor na resposta do leilão inclui um objeto `content` contendo os
parâmetros configurados durante a criação da campanha:
```json theme={null}
{
"results": [
{
"resultType": "banners",
"winners": [
{
"rank": 1,
"asset": [
{
"url": "https://topsortassets.com/000.json",
"content": {
"cta": "Shop Now",
"mainImage": "https://topsortassets.com/0001.png",
"headline": "Test Headline",
"backgroundImage": "https://topsortassets.com/0002.jpeg"
}
}
],
"type": "url",
"id": "http://topsort.com",
"resolvedBidId": "ChAGiHlBYmh4DaUEsuubfw7wEhABl8c_uHx3Aa8pw_EgHrHIGhABjoa6wYJ3wqhfIGHIdxYgIhYKEmh0dHA6Ly90b3Bzb3J0LmNvbRAFMOGtDw",
"vendorId": "babolat",
"campaignId": "0197c73f-b87c-7701-af29-c3f1201eb1c8"
}
],
"error": false
}
]
}
```
A estrutura do objeto `content` corresponde diretamente aos campos do modelo
configurados durante a criação do modelo, permitindo que seu frontend renderize dinamicamente
os elementos criativos apropriados para cada posicionamento.
**Nota de Implementação**: Use as variáveis dos campos do modelo como chaves na sua
lógica de renderização para garantir consistência entre a configuração da campanha e
a exibição frontend em todos os posicionamentos.
***
