API Topics para dispositivos móveis: visão geral

Saiba mais sobre a API Topics no Android e as etapas envolvidas na implementação. Você também pode implementar temas.

Como a API Topics funciona

A API Topics pode ser usada para observar e fornecer acesso a temas que parecem ser de interesse do usuário com base na atividade dele. A API Topics pode dar aos autores de chamada de API (como plataformas de adtech) acesso aos temas de interesse de um usuário, mas sem revelar outras informações sobre a atividade dele.

Principais conceitos

• Um tema é um conjunto de interesses legível por humanos que faz parte da taxonomia de temas da API Topics.
• Um autor de chamada é uma entidade, como um app, um SDK de terceiros, um site ou serviço, que faz uma solicitação para a API Topics para observar ou acessar os interesses de um usuário.
• Um tema é observado por um autor de chamada se ele fez uma solicitação para a API Topics em uma página da Web ou um app associado a esse tema durante as últimas três épocas.
• Uma época é um período de contabilização de um tema, que é definido como uma semana por padrão.
• Uma taxonomia é uma lista hierárquica de categorias, que inclui, por exemplo, /Arts & Entertainment/Music & Audio/Soul & R&B e /Business & Industrial/Business Services/Corporate Events.
• Os temas são derivados usando um modelo de classificador que mapeia a atividade do usuário para zero ou mais temas.

Etapas principais do fluxo da API Topics

O ciclo de vida da API Topics tem três etapas principais:

• Observe a atividade do usuário, como quando ele visita a página da Web https://cats.example/tabby/index.html ou faz o download do app cats.
• Derive tópicos da atividade do usuário, por exemplo, /Pets & Animals/Pets/Cats.
• Acessar temas observados anteriormente para o usuário, por exemplo, como um indicador para selecionar publicidade relevante (como uma promoção de ração para gatos).

Observar temas

Os autores das chamadas só podem acessar os temas de interesse que observaram. Um autor de chamada observa um tema quando faz uma solicitação para a API Topics em um contexto associado a ele. Para ilustrar esse conceito, considere o exemplo simplificado a seguir.

• Suponha que haja dois autores de chamadas da API Topics: A e B.
• Há dois contextos:
  • Greenhouse, por exemplo, um app chamado Greenhouse ou um site greenhouse.example, associado ao tópico Home & Garden.
  • Exercícios de tênis, por exemplo, um app chamado "Exercícios de tênis" ou um site "tennis.example", associado ao tema Sports/Tennis.
• Os autores da chamada A e B estão presentes no contexto de Greenhouse.
• Apenas o autor da chamada B está presente no contexto dos exercícios de tênis.
• Para simplificar, vamos supor que nenhum tema foi observado para o usuário antes da época 1.
• O usuário visita o app Greenhouse, e os autores de chamada A e B fazem uma chamada da API Topics para registrar a visita do usuário à página ou ao app. Consulte o guia de implementação sugerido em Próximas etapas para saber como chamar a API Topics. Esse registro (um nome de host ou dados do app) é usado mais tarde para gerar tópicos de interesse. A API Topics vai marcar o tema Home & Garden como observado pelos autores das chamadas A e B.
• O usuário acessa o app Tennis exercises. Somente o autor da chamada B envia uma solicitação da API Topics. A API Topics vai marcar o tema Sports/Tennis como observado pelo autor da chamada B.
• Ao final da época, a API Topics atualiza os principais temas do usuário e determina os autores de chamadas que observaram esses temas com base na atividade do usuário.
• Mais tarde, quando o autor da chamada B fizer outra chamada da API Topics, ele poderá receber o tema Home & Garden ou Sports/Tennis (ou, com uma chance de 5%, um tema aleatório) para esse usuário na matriz de resposta.
• O autor da chamada A só pode acessar o tópico Home & Garden, porque nunca observou o tópico Sports/Tennis. Isso significa que terceiros só vão saber sobre o tema de interesse de um usuário no contexto específico (app ou site) em que ele está presente.

Extrair temas

A API Topics extrai temas de interesse da atividade do usuário. Os temas são selecionados em uma taxonomia predefinida de código aberto. Uma vez por época, o Topics atualiza os cinco principais temas do usuário e os autores das chamadas que os observaram durante a época. O modelo de classificador de temas deriva temas da atividade do usuário: nome do host para uma visita a uma página da Web, informações do app no Android.

O autor da chamada acessa os temas de interesse do usuário

A API retorna apenas os temas que foram observados pelo autor da chamada nas três épocas mais recentes. Um máximo de três temas pode ser retornado para um autor da chamada,um para cada uma das três épocas recentes (se o autor da chamada observou temas para essa época). Os temas retornados podem ser usados pelo autor da chamada para complementar qualquer informação contextual e podem ser combinados para ajudar a encontrar um anúncio mais relevante para o usuário.

Períodos

A API Topics precisa garantir que os temas de interesse sejam atualizados. Os temas são inferidos para um usuário com base na atividade dele durante um período conhecido como época, uma semana por padrão. Cada usuário tem as próprias épocas (as épocas são "por usuário") e o horário de início inicial é aleatório.

Uma vez por época, a API Topics calcula os cinco principais temas do usuário e determina quais autores das chamadas observaram esses temas usando informações no dispositivo. O tema para cada época é escolhido aleatoriamente entre os cinco principais temas do usuário no período. Para aumentar ainda mais a privacidade e garantir que todos os temas sejam representados, há uma chance de 5% dele ser selecionado aleatoriamente entre todos os temas possíveis na taxonomia de interesses.

Tópicos no Android na prática

A API Topics no Android foi projetada para oferecer suporte a SDKs de publicidade de terceiros que geralmente operam em vários apps. A API Topics fornece aos autores de chamada temas de publicidade de interesse gerais com base no uso do app do usuário, sem depender de identificadores entre apps. Esses temas podem ser usados para complementar qualquer informação contextual relacionada ao app que quer mostrar um anúncio e podem ser combinados para ajudar a selecionar um anúncio adequado ao usuário.

No contexto da API Topics, os compradores e os anunciantes dependem do lado do vendedor. É o lado do vendedor que tem uma ampla presença nos apps do editor, observa os temas dos usuários e compartilha os temas com os compradores para ajudar a selecionar anúncios mais relevantes. Para receber temas, os apps e SDKs do lado do vendedor precisam estabelecer uma presença como observadores da API Topics por pelo menos uma época.

Consulte o guia de implementação da API Topics para conferir exemplos de código que demonstram como configurar a capacidade de buscar temas para publicidade com base em interesses.

Integração de tópicos por tipo de empresa

Ative a publicidade com base em interesses (IBA) com a API Topics. Siga as etapas com base no tipo de empresa de adtech para integrar a API Topics e se preparar para o lançamento.

Para todas as adtechs

• Analise a taxonomia de temas e dê feedback.
• 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 oferece um novo indicador. Atualize o SDK para começar a chamar a API Topics. Para extrair temas de forma consistente, o SDK precisa chamar a API dos apps do editor 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.

Como a API infere temas para um app

No Android, a API Topics infere temas para um app com base nas informações dele, usando um modelo de classificador. Na implementação atual, o Topics usa nomes de apps e pacotes para atribuir temas de interesse a um app, mas isso pode ser estendido para incluir outras informações, como a descrição do app.

Classificador de temas

Os temas de interesse são derivados de um modelo de classificador treinado com informações de apps disponíveis publicamente.

• Quando o modelo de classificador é usado para inferência ao calcular os temas de uma determinada época, o conjunto de indicadores usados permanece no dispositivo. Esse conjunto de indicadores pode incluir apps instalados ou usados recentemente, e pode ser expandido para incluir outros indicadores.
• O modelo V5 foi treinado pelo Google com 540.000 rótulos definidos por humanos e 17 milhões de rótulos definidos por ML em informações de apps disponíveis publicamente em app stores,como a Google Play Store. O modelo usa nomes de apps e pacotes como indicadores de entrada e está disponível sem custo financeiro para que os desenvolvedores de apps testem e descubram em quais temas o app se encaixa.
• É possível que um app seja associado a mais de um tema ou a nenhum ou mesmo que ele não seja adicionado ao histórico de temas do usuário. Caso um app seja associado a mais de um tema na taxonomia, o número de temas escolhidos desse app vai ser limitado aos três principais.

Para entender melhor como o modelo de classificador funciona, teste como diferentes dados do app afetam a classificação usando o Colabificador de temas do Android.

Taxonomia

Os temas são selecionados em uma taxonomia de código aberto predefinida. A taxonomia está disponível publicamente e está sujeita a mudanças. As sugestões podem ser enviadas usando o botão de feedback na parte de cima desta página. Essa taxonomia é selecionada por análise humana para que temas sensíveis não façam parte dela. Ela será personalizada para as categorias de anúncios que podem ser exibidas em apps para dispositivos móveis no Android.

Tópicos no Android na prática

Suponha que um usuário tenha sete apps instalados no dispositivo: A, B, C, D, E, F e G. Vamos supor que a classificação de temas do app e dos SDKs de adtechs nesses apps seja esta:

App	Classificação dos temas	SDK de tecnologias de publicidade
A	T1, T5	ad-sdk1, ad-sdk2
B	T2	ad-sdk2
C	T3, T6	ad-sdk3, ad-sdk4
D	T1, T4	ad-sdk1
E	T5	ad-sdk4, ad-sdk5
F	T6	ad-sdk2, ad-sdk3, ad-sdk4
G	T7	ad-sdk2

Fim da primeira semana: a API Topics gera os cinco temas principais do usuário para essa época.

Temas principais	Autores de chamadas que podem receber o tema
T1	ad-sdk1, ad-sdk2
T2	ad-sdk2
T3	ad-sdk3, ad-sdk4
T4	ad-sdk1
T5	ad-sdk1, ad-sdk2, ad-sdk4, ad-sdk5

Na segunda semana, se um autor de chamada de qualquer app chamar a API, a lista de temas retornados vai abranger apenas os temas em que o autor da chamada está incluído na coluna "Autores de chamadas que podem receber o tema" do app em questão naquela época.

• A janela de histórico incluída no cálculo dos temas disponíveis para cada autor de chamada é de três períodos (ou três semanas).
• Somente temas associados a apps que invocam a API Topics por SDKs de anúncios são usados. Isso significa que, se um app não inclui SDKs de anúncios que chamam a API Topics, os temas associados a ele não contribuem para o conjunto de temas acessíveis pelos SDKs de anúncios.
• Um app também pode desativar a API Topics de maneira declarativa. Os temas associados a apps desativados não contribuem para o cálculo semanal de temas. Este documento vai ser atualizado para incluir detalhes de implementação relacionados.

Se não houver uso suficiente do app para que a plataforma reconheça cinco temas, a plataforma pode considerar o uso de outras opções, como gerar os temas restantes de maneira aleatória.

Criptografia dos tópicos retornados

As plataformas de adtech registradas que chamam a API Topics também precisam fornecer chaves de criptografia para garantir que os temas retornados sejam legíveis apenas para o autor da chamada.

O Sandbox de privacidade vai buscar essas chaves no endpoint fornecido pela adtech . Como prática recomendada, sugerimos que as chaves sejam atualizadas regularmente, mas não a cada seis meses.

O Sandbox de privacidade vai pedir que as adtechs confirmem a disponibilidade do endpoint fornecido durante o processo de registro. Para mais detalhes sobre as ações exigidas pelas adtechs atuais e recém-registradas, consulte o guia de registro.

Próximas etapas

Consulte também

Confira nossos recursos para entender melhor a API Topics no Android.

• Confira apps de exemplo, vídeos de collab e tutoriais da API Topics.
• Veja como usuários e desenvolvedores podem controlar a API.
• Confira os recursos de suporte para fazer perguntas, interagir e compartilhar feedback.