Teste, implante e escalone uma solução baseada em tópicos

Nesta página, explicamos como criar, testar e escalonar uma implementação para produção usando a API Topics.

Implementação do back-end da API Topics

A implementação do back-end depende de como você quer usar os tópicos calculados no navegador. Recomendamos que as soluções de tecnologias de publicidade usem a API Topics como um indicador adicional de IBA.

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

Usar os "Tópicos" como um indicador adicional

Os dados de tópicos podem ser considerados junto com outros indicadores, como URLs, palavras-chave ou outros metadados, como um indicador adicional sobre seu público-alvo.

Conforme explicado em Maximizar a relevância do anúncio após cookies de terceiros, existem várias abordagens para usar a API Topics e veicular anúncios relevantes. Algumas envolvem o uso da API Topics para criar públicos-alvo, e outras sugerem usar o recurso como um indicador, entre outros, para treinar modelos de aprendizado de máquina que serão usados para inferir interesses adicionais do público-alvo ou até mesmo otimizar a lógica de lances.

Criar e implantar

  1. Colete temas observando os usuários em produção (tempo de implementação estimado: aproximadamente uma semana):
    • Entenda suas opções: como chamar Topics com cabeçalhos HTTP ou iframe e JavaScript.
    • Defina o domínio do iframe que vai chamar a API Topics.
    • Crie sua solução usando a demonstração do cabeçalho ou a demonstração do JavaScript como referência de código.
    • Integre tópicos no código que os editores incorporam nos sites deles (por exemplo, seu iframe de anúncio). Chame os temas da incorporação.
    • Para começar a observar os tópicos dos usuários, incorpore a versão mais recente do script nos seus sites de produção. Recomendamos que você teste primeiro a implementação nos seus próprios sites que recebem um pequeno número de visitas mensais. Nesta etapa, recomendamos incorporar sua nova solução com base em tópicos em pelo menos cinco sites.
    • Nesse ponto, espera-se que a API retorne uma matriz vazia como resultado. Isso ocorre porque nenhum tema foi observado para o usuário ainda. Pode levar até três semanas para os temas dos usuários começarem a aparecer.
    • Realizar testes e validação funcionais. É possível testar a solução de forma manual ou automática. Por exemplo:
      • Abra o navegador com flags e defina a época como 15 segundos para que o navegador recalcule os tópicos mais rapidamente.
      • Acesse os sites que incorporam seu script.
      • Verifique se os temas são observados pelo seu script em chrome://topics-internals/.
      • Confira os resultados que você pode esperar.
  2. Use os dados da API Topics com outros indicadores de contexto (como URLs, metadados etc.) (tempo estimado: cerca de 3 dias).
    • Após três semanas em produção, seu script deve ter observado o comportamento tópicos. Agora, você pode usar os dados da API Topics como um indicador adicional.
    • Quando você começar a receber uma lista de tópicos não vazia, poderá enviá-la ao back-end com outros indicadores contextuais.

Implantar nos sites de destino

Depois de integrar uma chamada da API Topics ao seu script, verifique se ela está incorporada em alguns sites de produção para um primeiro teste. Confira se a implementação funciona conforme o esperado:

  • A API Topics é chamada.
  • Os tópicos podem ser observados nesse ambiente controlado.
  • Os temas podem ser acessados. A API retorna temas observados para o usuário.

Escolha sites de destino

Antes de implantar sua solução nos sites dos editores, recomendamos testá-la em um ambiente controlado nos sites que você possui. Recomendamos que você escolha os sites de destino da seguinte maneira:

  • O site recebe um pequeno número de visitas mensais (menos de um milhão de visitas/mês): comece implantando a API para um público pequeno.
  • Você é proprietário e controla o site: se necessário, pode desativar rapidamente a implementação sem aprovações complexas.
  • O site não é essencial para os negócios: comece com sites de destino de baixo risco.
  • No máximo cinco sites: você não vai precisar de tanto tráfego ou exposição por enquanto.
  • Os sites segmentados representam temas diferentes: escolha sites que representem categorias diferentes (por exemplo, um sobre esportes, outro sobre notícias e outro sobre alimentação e bebidas). Você pode usar a ferramenta interna de temas no Chrome para validar os domínios e como eles são classificados pelo classificador de aprendizado de máquina da API Topics.

Teste funcional e validação

Ao chamar a API Topics nesse ambiente limitado, você pode esperar os seguintes resultados:

  • Uma matriz vazia de temas [], se esta for a primeira chamada deste dispositivo para o site e o autor da chamada nos últimos sete dias.

  • Uma lista de zero a três temas que representam os interesses do usuário. Após sete dias de observação, você receberá:

    • Um tema, selecionado entre os cinco principais para o usuário, calculado com base nos nomes de host das páginas em que o autor da chamada observou temas durante essa semana.

  • A mesma resposta de API de todas as chamadas anteriores da API Topics. Para o mesmo autor da chamada, usuário e site de nível superior, a API vai retornar os mesmos temas para toda a época. Isso ajuda a evitar a exposição de muitos interesses do usuário. Confira mais detalhes no GitHub.

  • Um novo tema que substitui um dos três antigos se você estiver chamando os tópicos após quatro semanas de observação.

  • Se você não tiver observado os temas do usuário nas últimas três semanas ou mais, a API Topics vai retornar uma matriz vazia [] de novo.

Colete métricas de desempenho para avaliar a experiência do usuário:

  • O ambiente de execução das chamadas JavaScript para a API Topics em um iframe de origem cruzada precisa ser medido para ser usado em análises de performance futuras.
  • O tempo necessário para criar um iframe e tópicos postMessage() depois que eles são recebidos.

Para resolver problemas, consulte a seção de suporte.

Escalar para a produção

A esta altura, você já deve ter testado a Topics em um ambiente controlado (em alguns dos seus sites). Se tudo funcionar conforme o esperado, é hora de dimensionar essa implementação. Implante o mesmo código em mais sites de destino. Assim, você poderá observar mais usuários, coletar mais dados de tópicos e entender melhor seus públicos-alvo.

Confira um resumo detalhado de como escalonar para produção:

  1. Teste sua solução baseada em tópicos com um volume maior de tráfego.
    • Adicione seu iframe a mais sites seus com um número maior de visitas e siga as instruções abaixo para realizar o teste de carga.
  2. Implante sua solução nos sites dos editores.
    • Assim que sua solução estiver funcionando corretamente em seu próprio ambiente de teste, colabore com os editores para integrar seu iframe aos sites deles. Por exemplo, talvez seja necessário atualizar a biblioteca que inclui seu iframe.
  3. Processar e usar dados de tópicos (tempo estimado: cerca de quatro semanas).
    • Incorpore dados de tópicos como um indicador aditivo com outros dados.
    • Encontrar parceiros de teste de lances em tempo real.
    • Faça testes de utilitários com tópicos como um indicador complementar aos outros dados.

Teste de carga

Para garantir que seu sistema possa lidar com o tráfego, recomendamos realizar testes de carga antes de implantar a solução baseada em tópicos nos sites dos editores.

  1. Implante gradualmente em mais sites de destino que você possui, especialmente aqueles com um volume maior de tráfego.
  2. Faça testes de carga para os dados dos tópicos de acordo com o tráfego esperado.
    • Você precisa enviar informações do tópico do iframe para o back-end. Isso permite que você processe ainda mais os resultados da API Topics e os use como um indicador adicional para ajudar a selecionar anúncios mais relevantes para o usuário. À medida que mais sites incorporarem sua incorporação, o número de chamadas para seu back-end aumentará significativamente. Confirme se o back-end consegue lidar com um grande volume de chamadas do iframe.
    • Configurar a coleta de métricas e os registros para análise.
  3. Imediatamente após implantar a API Topics, verifique suas métricas para detectar problemas graves dos usuários finais. Verifique suas métricas regularmente.
  4. Em caso de interrupção ou comportamento inesperado, reverta a implantação e analise os registros para entender e corrigir o problema.

Consulte também

Confira nossos recursos para entender melhor a API Topics na Web.