Templates de anúncios nativos

Em Templates de anúncios nativos, você cria o layout visual usado para renderizar um anúncio nativo diretamente no Portal, em vez de fornecer esse layout no código do app. Esse é o equivalente, no Portal, à chamada showTemplatedNative() do SDK (AdsManager.showTemplatedNative no Android, AppsKitSDKAdsManagerIOS.instance.showTemplatedNative no iOS): o template configurado aqui para um placeholder é exatamente o que essa chamada do SDK renderiza em tempo de execução — o app não passa nenhum recurso de layout (nem res nem XIB), pois o design fica definido aqui.

A lista de templates

A página Templates de anúncios (na barra lateral, agrupada com Marcas e Grupos de regiões) lista em uma tabela todos os templates nativos que você criou.

Cada linha mostra: um índice numérico, uma pequena prévia do layout em miniatura na coluna Imagem, o Nome do template, uma contagem de Elementos (quantos dos componentes disponíveis — ícone, título, mídia, CTA etc. — o template realmente usa), um indicador de Status (Publicado ou Rascunho), as datas de Criado em / Atualizado em, que permitem ordenação, e um menu de Ações. Um campo de busca filtra por nome, e os menus suspensos Filtro, Status e Marca refinam ainda mais a lista, com a opção Limpar tudo para redefinir os filtros. A paginação segue o mesmo padrão de rodapé "Exibindo X de Y" usado em todo o Portal. Clique em + Criar template para começar um novo ou clique em uma linha existente para abri-lo no editor de canvas descrito abaixo.

Criando um template (o canvas)

Ao abrir um template — novo ou existente — você acessa o editor de canvas, onde monta o layout elemento por elemento.

• Elementos (painel esquerdo) — os componentes disponíveis para um anúncio nativo: Ícone, Título, Anunciante, Rótulo de patrocinado, Avaliação, Descrição, Mídia, Preço, Loja e Botão de CTA. Somente os elementos presentes no canvas ficam ativos (é isso que a contagem de "Elementos" na página da lista reflete); os demais permanecem esmaecidos no painel até serem adicionados. Esse conjunto corresponde exatamente ao que um objeto de anúncio nativo pode disponibilizar — você escolhe quais recursos nativos da própria rede de anúncios posicionar e como fazer isso, sem criar campos personalizados.
• Canvas (centro) — uma prévia em tempo real do layout no tamanho real em dp, com um seletor Rótulos / Dados de exemplo para visualizar rótulos de placeholder ou conteúdo de exemplo realista, controles de zoom, a opção Importar XML (para importar um layout Android existente em vez de criar um do zero) e Restaurar estado inicial para descartar as alterações e voltar ao último estado salvo do template.
• Propriedades do canvas (painel direito) — posição e tamanho (um menu suspenso de Tamanho predefinido, além dos campos Largura / Altura, cada um configurável de forma independente com um valor fixo, match_parent ou wrap_content), aparência (Cor de fundo como amostra de cor + valor hexadecimal e Raio dos cantos) e Espaçamentos internos (Esquerda / Superior / Direita / Inferior, cada um com seu próprio controle de incremento e decremento).

O seletor Rascunho / Publicado ao lado do título (com um ícone de lápis para renomear o template) controla se ele já pode ser atribuído a um placeholder — um template mantido como Rascunho não aparece como opção disponível em nenhuma outra área. Salvar alterações permanece desabilitado até que você modifique algo, seguindo o mesmo padrão usado em todo o Portal para impedir salvamentos sem alterações.

Configurando a disponibilidade do template

Clicar em Configurar no editor de canvas abre o modal Configurar disponibilidade do template — é isso que efetivamente torna um template disponível para um determinado app ou marca, em uma etapa separada da criação do design.

O modal é um seletor de duas colunas, com a mesma estrutura da etapa Publicação do assistente de Campanhas (a seção Marcas da etapa Segmentação, com "Todas as marcas" ou uma lista de seleção de marcas/apps específicos):

• Marcas (esquerda) — uma caixa de seleção geral Todas as marcas, ou a opção de escolher marcas específicas em uma lista com busca. As marcas selecionadas também aparecem como etiquetas removíveis acima da lista.
• Apps (direita) — preenchida com base nas marcas selecionadas à esquerda, com os apps agrupados por marca. Cada grupo de marca tem seu próprio atalho Todos os apps (incl. futuros) para incluir todos os apps dessa marca — atuais e futuros — sem selecioná-los individualmente. Você também pode marcar apps específicos, um por um. Os apps selecionados também aparecem como etiquetas.

Clique em Concluído para salvar o escopo de disponibilidade. Somente quando um template estiver Publicado e tiver sido disponibilizado para um app/marca aqui, ele poderá ser selecionado ao atribuir um template nativo a um placeholder na configuração desse app, conforme descrito abaixo.

Atribuindo um template a um placeholder

De volta à grade Detalhes do app → Placeholders de anúncios → Blocos de anúncios para placeholders de anúncios de um app (descrita acima, em Detalhes do app), a coluna Nativo funciona da mesma forma que Intersticial / Banner / Premiado — você pode adicionar um ou mais posicionamentos por placeholder e reordená-los por prioridade para fallback —, mas ela também tem um ícone de template ao lado do cabeçalho, pois os posicionamentos nativos precisam de um design atribuído, não apenas de um bloco de anúncios.

Clicar nesse ícone abre Configurar template nativo, com escopo que abrange todos os placeholders nativos exibidos na grade naquele momento (o cabeçalho do modal informa o escopo, por exemplo, "Todos os placeholders nativos (10)").

Busque e selecione um dos templates disponibilizados para esse app (conforme Configurando a disponibilidade do template, acima) e clique em Aplicar template para atribuí-lo a todo o escopo em uma única ação, em vez de abrir o card Nativo de cada placeholder individualmente. Depois da aplicação, qualquer placeholder desse escopo que chamar showTemplatedNative() em tempo de execução será renderizado com o design desse template — esse é o mecanismo que conecta o template criado aqui ao anúncio nativo efetivamente exibido no app, da mesma forma que a Promoção cruzada (descrita em Blocos de anúncios para placeholders de anúncios, na seção Detalhes do app acima) conecta uma Campanha a um posicionamento de anúncio ativo.