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

Nesta página, você vai aprender a criar, testar e escalonar uma implementação para produção usando a API Topics.

Implementação de back-end de tópicos

A implementação do back-end depende de como você quer usar os temas calculados no navegador. Recomendamos que as soluções de adtech usem os tópicos como um sinal 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 a API Topics como um indicador adicional

Os dados de temas podem ser considerados 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, há várias abordagens para usar a API Topics e veicular anúncios relevantes. Algumas delas envolvem o uso de tópicos para criar públicos-alvo, e outras abordagens sugerem usar tópicos como um indicador entre outros para treinar modelos de aprendizado de máquina que serão usados para inferir outros interesses do público-alvo ou até mesmo para otimizar a lógica de lances.

Criar e implantar

  1. Colete temas observando os usuários em produção (tempo estimado de implementação: aproximadamente uma semana):
    • Entenda suas opções: como chamar tópicos 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 de cabeçalho ou a demonstração de JavaScript como referência de código.
    • Integre a API Topics ao código que os editores incorporam nos sites deles (por exemplo, o iframe de anúncio). Chame os tópicos da incorporação.
    • Para começar a observar os temas de interesse dos usuários, incorpore a versão mais recente do script nos seus sites de produção. Recomendamos que você teste a implementação nos seus próprios sites com um pequeno número de visitas mensais. Nesta etapa, recomendamos incorporar sua nova solução baseada em tópicos em pelo menos cinco sites.
    • Neste ponto, espera-se que a API retorne uma matriz vazia como resultado. Isso acontece porque ainda não foram observados temas para o usuário. Pode levar até três semanas para começar a receber tópicos do usuário.
    • Realize testes e validações funcionais. Você pode testar sua 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 cedo.
      • Acesse os sites que incorporam seu script.
      • Verifique se os temas são observados pelo script em chrome://topics-internals/.
      • Confira os resultados que você pode esperar.
  2. Use os dados da API Topics com outros indicadores contextuais, como URLs, metadados etc. (tempo estimado: cerca de 3 dias).
    • Depois de três semanas em produção, o script já terá observado os temas de alguns usuários. Nesse momento, você já pode usar os dados de tópicos como um indicador adicional.
    • Quando você começar a receber uma lista de temas não vazia, envie-a para seu back-end com outros indicadores contextuais.

Implantar em sites de destino

Depois de integrar uma chamada de tópicos 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 temas podem ser observados nesse ambiente controlado.
  • Os temas podem ser acessados (a API retorna os temas observados para o usuário).

Escolher 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 por mês): comece implantando a API para um público-alvo pequeno.
  • Você é o proprietário e tem controle sobre o site: se necessário, é possível 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.
  • Total de até cinco sites: por enquanto, você não precisa de tanto tráfego ou exposição.
  • Os sites de destino representam temas diferentes: escolha sites que representem categorias diferentes (por exemplo, um sobre esportes, outro sobre notícias e mais um sobre comida e bebida). Você pode usar a ferramenta de temas internos no Chrome para validar domínios e como eles são classificados pelo classificador de machine learning da API Topics.

Teste e validação funcionais

Ao chamar a API Topics nesse ambiente limitado, espere os seguintes resultados:

  • Uma matriz vazia de tópicos [], se esta for a primeira chamada deste dispositivo, para este site e chamador nos últimos sete dias.

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

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

  • A mesma resposta da API que em 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 durante todo um período. Isso ajuda a evitar a exposição de muitos interesses do usuário. Encontre mais detalhes no GitHub.

  • Um novo tema que substitui um dos três antigos, se você estiver chamando a API Topics após quatro semanas de observação.

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

Reúna métricas de performance para avaliar a experiência do usuário:

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

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

Escalonar para produção

Neste ponto, você já testou os tópicos em um ambiente controlado (em alguns sites de sua propriedade). Se tudo funcionar como 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 temas e aprofundar seu entendimento sobre os públicos-alvo.

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

  1. Teste sua solução com base em temas em um volume maior de tráfego.
    • Adicione o iframe a mais sites de sua propriedade com um número maior de visitas e siga as instruções abaixo para realizar testes de carga.
  2. Implante sua solução nos sites dos editores.
    • Quando a solução estiver funcionando corretamente no seu ambiente de teste, colabore com os editores para integrar o 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).
    • Incorporar dados de temas como um indicador adicional junto com outros dados.
    • Encontre parceiros de teste de lances em tempo real.
    • Faça testes de utilidade com temas como um indicador adicional aos seus outros dados.

Teste de carga

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

  1. Faça a implantação gradual em mais sites de destino de sua propriedade, principalmente aqueles com um volume maior de tráfego.
  2. Faça testes de carga nos dados de tópicos de acordo com o tráfego esperado.
    • Você precisará enviar informações de tópico do iframe para seu back-end. Isso permite processar ainda mais os resultados da API Topics e usá-los como um indicador adicional para ajudar a selecionar anúncios mais relevantes para o usuário. À medida que mais sites incorporam seu embed, o número de chamadas para seu back-end aumenta significativamente. Confirme se o back-end pode processar um grande volume de chamadas do iframe.
    • Configure 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 do usuário final. 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.