API Topics: guia de integração

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

A API Topics para Android foi projetada para oferecer suporte a publicidade com base em interesses sem depender de identificadores entre apps.

Os anunciantes se esforçam para veicular anúncios relevantes relacionados aos interesses do usuário. Por exemplo, para um usuário interessado em culinária, anúncios relacionados a esse assunto provavelmente vão ser mais relevantes do que anúncios de outros temas.

A publicidade com base em interesses (IBA) é uma forma de publicidade personalizada em que os anúncios são selecionados com base nos interesses do usuário. Com o Sandbox de privacidade no Android, esses interesses são derivados de apps com que o usuário interagiu. Essa abordagem é diferente da publicidade contextual, que tem como base exclusivamente os interesses derivados do conteúdo visualizado no momento. A IBA permite que os apps mostrem anúncios mais relevantes e envolventes do que os anúncios contextuais.

A IBA geralmente envolve a comunicação entre apps, vendedores e compradores. Este guia é destinado a todas essas partes, incluindo redes e adtechs que funcionam como compradores e vendedores.

A API Topics reconhece indicadores de interesse gerais no dispositivo com base no uso de apps do usuário. Esses indicadores, chamados de temas, são compartilhados com os anunciantes para oferecer suporte à IBA sem a necessidade de rastrear usuários individuais em apps.

Há considerações importantes de alto nível ao implementar a publicidade com base em interesses com a API Topics:

  • A inferência de interesse do usuário é processada no dispositivo: as informações do usuário sobre exatamente quais apps estão instalados no dispositivo do usuário não saem do dispositivo, e a privacidade fica protegida. Esse modelo é diferente do atual usado com frequência para enviar e processar os dados de um app entre dispositivos de um usuário em servidores de adtech. Alguns tipos de processamento vão continuar ativos nos servidores de adtech, como o uso dos sinais fornecidos pela API Topics em modelos de personalização e otimização para seleção de anúncios.

  • Compradores e anunciantes dependem do lado do vendedor: para receber temas, os apps e SDKs do lado do vendedor precisam estabelecer uma presença ao ser um observador da API Topics por pelo menos uma época.

Terminologia

  • Anunciante: empresa que gera engajamento com os usuários pela compra de inventário de anúncios.
  • Editor: empresa que vende o inventário de anúncios disponível ao lado do conteúdo.
  • Comprador (ou lado do comprador): uma empresa de adtech que facilita a compra de inventário de anúncios pelos anunciantes.
  • Vendedor (ou lado do vendedor): uma empresa de adtech que faz a intermediação dos editores na venda de inventário de anúncios.
  • Rede: empresa de adtech que atua como comprador e vendedor.
  • Pertencente e operado: empresa que atua como editor, vendedor e comprador.

Metas

Se a IBA for importante para sua empresa, queremos que você tenha uma versão da API Topics em execução no contexto dos casos de negócios do app para que possamos receber seu feedback e permitir que você molde a API. Queremos garantir que você possa desbloquear designs e desenvolvimentos para que possa receber temas quando a versão Beta for iniciada.

No momento, os objetivos do planejamento de integração do Sandbox de privacidade na prévia para desenvolvedores do Android incluem a capacidade de fazer o seguinte:

Para todas as adtechs

  • Revise a taxonomia de temas e dê feedback sobre os temas incluídos.
  • Teste os apps de exemplo da API Topics para saber quais dados de temas são retornados do classificador no dispositivo.
  • Atualize os fluxos do app e do SDK para começar a chamar a API Topics.
  • Atualize os protocolos para começar a enviar temas em solicitações de anúncios.
  • Registre sua adtech com o Sandbox de privacidade.

Para adtechs de venda

  • Torne-se um observador para estabelecer uma presença na API Topics. A API Topics é um novo indicador. Atualize o SDK para começar a chamar a API Topics. Para extrair temas de forma consistente, os apps precisam chamar a API pelo menos uma vez por época. A entrega do número máximo de temas (três) com suas solicitações de anúncios pode levar até quatro épocas.
  • Incluir informações da API Topics nas solicitações de anúncio. Para cada solicitação de anúncio, comece a compartilhar os dados da API Topics com parceiros de compra. A API Topics planeja complementar outros indicadores (como indicadores de contexto) para ajudar a encontrar um anúncio adequado para um determinado visitante.
  • Colabore em um protocolo para compartilhar temas com seus parceiros de compra. A API Topics precisa que cada SDK funcione com parceiros downstream para chegar a um acordo sobre como os dados da API Topics são compartilhados.

Para adtechs de compra

  • Conecte-se com parceiros do lado do vendedor para confirmar os planos deles de observar temas e estabelecer presença. Para receber temas, os provedores do lado do vendedor precisam chamar a API Topics pelo menos uma vez por época.
  • Colabore em um protocolo para receber temas de parceiros do lado do vendedor. Os temas são um novo indicador que será compartilhado pelos parceiros do lado do vendedor como parte da solicitação de anúncio. Os consumidores de compras precisam garantir que trabalham com parceiros upstream para saber como os temas serão compartilhados.
  • Incorporar temas em modelos de lances e otimização A API Topics precisa complementar outros indicadores, como contextuais, para encontrar um anúncio adequado para o visitante.

Pré-requisitos e configuração

Desenvolvedores de apps, vendedores e compradores precisam seguir estas etapas para configurar a API Topics.

Saiba mais sobre a API

  1. Comece lendo a proposta de design para se familiarizar com a API Topics e os recursos dela.
  2. Leia o guia para desenvolvedores para aprender a incorporar o código e as chamadas de API que você vai precisar para seus casos de uso.
  3. Analise a taxonomia (link em inglês) e dê feedback sobre quais temas estão na lista.
  4. Envie feedback para a proposta ou documentação de design.
  5. Inscreva-se para receber atualizações sobre a API Topics. Assim, você vai ficar por dentro dos novos recursos introduzidos em versões futuras.

Configurar e testar o app de exemplo

  1. Siga as instruções desta página para configurar o Sandbox de privacidade no SDK do Android usando o Android Studio.
  2. Copie e execute o código na versão Java ou Kotlin (links em inglês) do app de exemplo para se familiarizar com a extração de temas em um dispositivo.
  3. Durante os testes, faça experimentos com as informações do app, incluindo nome e descrição, para mudar os temas que serão retornados do classificador no dispositivo.
  4. Depois de entender como a API do cliente e as classificações no dispositivo funcionam, use o app de exemplo para orientar sua própria integração.

Dica: leia com atenção a utilidade dos dados dos temas retornados para o app. Identifique maneiras de melhorar a classificação ou a taxonomia e envie feedback se tiver recomendações sobre melhorias.