Esta página foi traduzida pela API Cloud Translation.

Visão geral da API Protected Audience
bookmark_border Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Leilões de anúncios no dispositivo para veicular públicos-alvo personalizados e de remarketing sem o rastreamento de terceiros entre sites.

Para quem este artigo é destinado?

Este artigo aborda os conceitos básicos da API Protected Audience e explica alguns conceitos subjacentes, mas não entra em muitos detalhes técnicos.

Se você trabalha com publicidade ou adtech, vai receber uma visão geral de como a API Protected Audience funciona.
Se você for um desenvolvedor ou engenheiro de software, o guia para desenvolvedores da API Protected Audience fornece mais detalhes técnicos sobre a API. Leia o status mais recente dos recursos pendentes da Protected Audience.

Consulte o glossário para conferir os termos usados na documentação da API Protected Audience. Ao final deste artigo, você vai aprender a interagir e compartilhar feedback.

O que é a API Protected Audience?

A API Protected Audience é uma tecnologia do Sandbox de privacidade que veicula casos de uso de remarketing e público-alvo personalizado para que terceiros não possam rastrear o comportamento de navegação do usuário entre sites.

A API Protected Audience permite leilões no dispositivo pelo navegador para escolher anúncios relevantes de sites que o usuário já visitou.

A API Protected Audience é o primeiro experimento a ser implementado no Chromium na família de propostas TURTLEDOVE. A diferença entre a API Protected Audience e o TURTLEDOVE está principalmente relacionada à separação do papel do comprador e do vendedor de anúncios no dispositivo. As seções a seguir explicam como a API Protected Audience funciona.

API Protected Audience em um minuto

Para uma visão geral mais detalhada da API Protected Audience, leia o guia para desenvolvedores da API Protected Audience.

Visão geral de cada etapa do ciclo de vida da API Protected Audience — O ciclo de vida da API Protected Audience.

A API Protected Audience usa grupos de interesse para permitir que os sites mostrem anúncios relevantes para os usuários.

Por exemplo, quando um usuário visita um site que quer anunciar os produtos, um proprietário de grupo de interesse, como uma plataforma de demanda (DSP), pode pedir que o navegador do usuário adicione a associação ao grupo de interesse. Se a solicitação for bem-sucedida, o navegador vai registrar:

O nome do grupo de interesse: por exemplo, "custom-bikes".
O proprietário do grupo de interesse: por exemplo, "https://dsp.example".
Informações de configuração do grupo de interesse para permitir que o navegador acesse o código de lances, o código do anúncio e os dados em tempo real, se o proprietário do grupo for convidado a dar lances em um leilão de anúncios.

Mais tarde, quando o usuário acessa um site com espaço de anúncio disponível, o vendedor do espaço de anúncio (um provedor de venda (SSP, na sigla em inglês) ou o próprio site pode usar a API Protected Audience para realizar um leilão de anúncios e selecionar os anúncios mais adequados para mostrar ao usuário. O vendedor chama a função navigator.runAdAuction(), que fornece uma lista de proprietários de grupos de interesse convidados a dar lances.

Os lances só podem ser fornecidos por grupos de interesse dos quais o navegador faz parte e cujos proprietários foram convidados a dar lances.

O código de lance é recuperado de um URL fornecido na configuração do grupo de interesse. Esse código fornece dados sobre o grupo de interesse e informações do vendedor, além de dados contextuais sobre a página e o navegador.

Cada grupo de interesse que oferece um lance é conhecido como comprador.

Quando o navegador chama a função para executar o leilão de anúncios, o código de cada comprador gera um lance com a ajuda de dados em tempo real fornecidos pelo serviço de chave-valor da API Protected Audience. Em seguida, o vendedor recebe esses lances, além de dados em tempo real do vendedor, e pontua cada lance. O lance com a maior pontuação vence o leilão.

O anúncio vencedor é mostrado em um frame fechado. O URL do criativo do anúncio é especificado no lance, e a origem precisa corresponder a uma na lista fornecida pela configuração do grupo de interesse.

O vendedor pode informar o resultado do leilão (reportResult()), e os compradores podem informar as vitórias (reportWin()).

Saiba mais sobre os relatórios de leilão da Protected Audience.

Por que precisamos da API Protected Audience?

Entender os interesses dos usuários pode gerar anúncios mais relevantes do que apenas escolher anúncios com base no conteúdo do site (segmentação contextual) ou usando informações fornecidas por um usuário no site em que o anúncio aparece (segmentação de dados próprios).

Tradicionalmente, as plataformas de anúncios descobrem os interesses dos usuários rastreando o comportamento deles em vários sites. Os navegadores precisam de uma maneira de permitir que as plataformas de anúncios selecionem anúncios relevantes, para que os editores de conteúdo recebam receita de publicidade sem rastreamento entre sites.

A API Protected Audience tem como objetivo aproximar a plataforma da Web de um estado em que o navegador do usuário no dispositivo, e não as plataformas de adtech ou de publicidade, tenha informações sobre o que interessa a essa pessoa.

Como posso testar a API Protected Audience?

O guia para desenvolvedores da API Protected Audience descreve como usar a API e como fazer testes locais.
protected-audience-demo.web.app oferece um tutorial de implantação básica da API Protected Audience em sites de anunciantes e editores. O vídeo de demonstração da Protected Audience explica como esse código funciona e mostra como usar o Chrome DevTools para depuração.

Qual configuração de navegador está disponível?

Os usuários podem ajustar a participação nos testes do Sandbox de privacidade no Chrome ativando ou desativando a configuração de nível superior em chrome://settings/adPrivacy. Durante o teste inicial, os usuários podem desativar a API Protected Audience usando as configurações do Sandbox de privacidade.

O Chrome planeja permitir que os usuários acessem e gerenciem a lista de grupos de interesse a que foram adicionados nos sites que visitaram. Assim como nas tecnologias do Sandbox de privacidade, as configurações do usuário podem evoluir com o feedback de usuários, reguladores e outros.

Vamos atualizar as configurações disponíveis no Chrome conforme a API Protected Audience avança, com base em testes e feedback. No futuro, vamos oferecer configurações mais detalhadas para gerenciar a API Protected Audience e os dados associados.

Os autores de chamadas de API não podem acessar a associação a grupos quando os usuários navegam no modo de navegação anônima, e a associação é removida quando os usuários limpam os dados do site.

Posso desativar a API Protected Audience?

Saiba como bloquear o acesso à API Protected Audience, como proprietário do site ou usuário individual.

Principais conceitos

Quer mais informações sobre a terminologia da API Protected Audience? Consulte o glossário do Sandbox de privacidade.

O que é um grupo de interesse?

Um grupo de interesse da API Protected Audience representa um grupo de pessoas com um interesse comum, correspondendo a uma lista de remarketing.

Todos os grupos de interesse da API Protected Audience têm um proprietário. Diferentes tipos de proprietários vão criar diferentes tipos de grupos de interesse com diferentes casos de uso.

O proprietário pede ao navegador do usuário para adicionar a associação ao grupo de interesse chamando a função JavaScript navigator.joinAdInterestGroup(), fornecendo informações como dados sobre anúncios relevantes para o grupo de interesse e um URL para o JavaScript usado no lance. Os dados do grupo de interesses (como os anúncios) podem ser atualizados, e um grupo de interesses pode ser ativado por até 30 dias.

Tipos de grupos de interesse

A tabela a seguir mostra exemplos de diferentes tipos de grupos de interesse e proprietários da API Protected Audience.

Proprietário	Exemplo	Interesse	Exemplo	Casos de uso
Advertiser	Fabricante de bicicletas	Produtos	Pessoas que acessaram páginas de produtos de uma categoria específica de bicicleta.	Remarketing para pessoas que já interagiram com a marca.
Editor	Site de notícias	Conteúdo	Pessoas que leem sobre ciclismo.	Os editores podem usar dados próprios para permitir que os anunciantes comprem anúncios relevantes para os leitores no site deles. Um grupo de interesse de propriedade do editor pode permitir que os editores façam o mesmo, mesmo quando essas pessoas estiverem navegando em outros sites. Os editores podem cobrar pela capacidade de veicular anúncios em segmentos específicos do público-alvo.
AdTech	DSP	Categoria de produtos	Pessoas que demonstraram interesse em equipamentos para ciclismo.	Uma empresa de adtech pode criar e gerenciar um grupo de interesse de pessoas que acredita que estão no mercado para alguma categoria de item. Esse grupo de interesse pode ser usado para anunciar produtos em sites que vendem itens dessa categoria (e que trabalham com a empresa de adtech).

O Chrome permite até 1.000 grupos de interesse por proprietário e até 1.000 proprietários de grupos de interesse. Esses limites servem como proteção e não devem ser atingidos em operação normal.

O que é um comprador?

Na API Protected Audience, um comprador é uma parte que é proprietária de um grupo de interesse e faz lances em um leilão de anúncios.

Exemplo:

Anunciante: atua por conta própria.
Plataforma de demanda (DSP): atua em nome dos anunciantes.
Proprietário do grupo de interesse: trabalha para vários anunciantes.

Os compradores têm três tarefas:

Escolha se quer participar de um leilão.
Escolha os anúncios e calcule um lance.
Informe o resultado do leilão.

Esses jobs são feitos de forma programática, em um código fornecido pelo comprador que é executado durante um leilão de anúncios da API Protected Audience.

Quando um comprador pede ao navegador de um usuário para adicionar um grupo de interesse aos grupos de que ele faz parte (chamando a função JavaScript navigator.joinAdInterestGroup()), o comprador fornece ao navegador:

Um URL para o código de lances, que será usado quando o vendedor veicular um leilão de anúncios.
Possivelmente, URLs de criativos de anúncios para o grupo de interesses. (Os URLs de anúncios podem ser adicionados mais tarde com uma atualização.)
Uma lista de chaves de dados a serem consultadas e o URL do serviço de chave-valor do comprador, para permitir que o código de lances receba dados em tempo real durante um leilão.

O código do comprador também pode incluir uma função reportWin() para informar o resultado do leilão.

Quem realiza um leilão de anúncios?

Várias partes podem realizar um leilão para vender espaço publicitário.

Exemplo:

Editor de conteúdo: atua por conta própria para hospedar conteúdo de anúncios no site.
Plataforma de fornecimento (SSP): trabalha com o editor e oferece outros serviços.
Script de terceiros: atua em nome de um editor para permitir a participação em leilões de anúncios.

Com a API Protected Audience, um vendedor de espaço de anúncio tem três funções:

Aplicar as regras do editor: informar quais compradores e lances são qualificados.
Executar a lógica do leilão: o JavaScript é executado em worklets para calcular uma pontuação de desejabilidade para cada lance.
Informe o resultado do leilão.

Esses trabalhos são feitos programaticamente, no código fornecido pelo vendedor quando ele inicia um leilão de anúncios chamando a função JavaScript navigator.runAdAuction().

Como funciona um leilão de anúncios da API Protected Audience?

O diagrama a seguir descreve cada etapa de um leilão de anúncios da API Protected Audience:

Seis etapas em um leilão de anúncios da API Protected Audience — Fases do leilão de anúncios da Protected Audience.

Na API Protected Audience, um leilão de anúncios é uma coleção de pequenos programas JavaScript que o navegador executa no dispositivo do usuário para escolher um anúncio. Para preservar a privacidade, todo o código do leilão de anúncios do vendedor e dos compradores é executado em worklets JavaScript isolados que não podem se comunicar com o mundo externo.

Um vendedor (um editor ou uma plataforma do lado do fornecimento) inicia um leilão de anúncios da Protected Audience em um site que vende espaço publicitário (como um site de notícias). O vendedor escolhe os compradores para participar do leilão, indica qual espaço está à venda e fornece outros critérios para o anúncio. Cada comprador é o proprietário de um grupo de interesse.

O vendedor fornece ao navegador um código para avaliar os lances, que inclui o valor de cada lance, o URL do criativo do anúncio e outros dados retornados de cada comprador. Durante o leilão, o código de lances dos compradores e o código de pontuação de lances do vendedor podem receber dados dos serviços de chave-valor. Depois que um anúncio é escolhido e exibido (em um frame fechado para preservar a privacidade), o vendedor e o comprador vencedor podem informar o resultado do leilão.

Um usuário acessa um site que exibe anúncios.
O código do vendedor inicia um leilão. O vendedor especifica qual espaço publicitário está à venda e quem pode dar lances, além de um método para avaliar esses lances.
O código do comprador convidado é executado para gerar um lance, um URL para um criativo de anúncio relevante e outros dados. O script de lances pode consultar dados em tempo real, como o orçamento restante da campanha publicitária, do serviço de chave-valor do comprador.
O código do vendedor avalia cada lance e seleciona um vencedor. Essa lógica usa o valor do lance e outros dados para retornar a atratividade de um lance e rejeitar um anúncio que não consegue superar o vencedor do anúncio contextual. O vendedor pode usar o próprio serviço de chave-valor para dados em tempo real. Antes de um leilão começar, o vendedor encontra o melhor anúncio contextual para o espaço de anúncio disponível.
O anúncio vencedor é retornado como um objeto de configuração de frame restrito quando a flag resolveToConfig é definida na configuração do leilão. A configuração é usada para navegar pelo frame protegido até o criativo do anúncio, e o URL do criativo é oculto do vendedor e do editor. Se a flag resolveToConfig estiver definida como false ou não for transmitida, o anúncio vencedor será retornado como um URN opaco que pode ser usado para renderizar o anúncio em um iframe. O objeto de configuração de frame cercado está disponível a partir do M114.
O leilão é informado ao vendedor e aos compradores vencedores.
Observação:o reportResult() do vendedor e o reportWin() do comprador podem incluir uma chamada para sendReportTo(). Esse recurso está disponível temporariamente, até que os relatórios agregados sejam disponibilizados com a Agregação privada.

Um mecanismo de denúncia para perda de compradores está em discussão.

O que é um serviço de chave/valor da API Protected Audience?

O serviço de chave-valor da API Protected Audience permite que as adtechs consultem dados em tempo real quando um lance é feito pelo comprador e que os vendedores avaliem anúncios preservando a privacidade. Leia sobre o serviço de chave/valor da API Protected Audience e outros em Serviços da API Protected Audience.

O serviço de chave-valor é implantado na infraestrutura de nuvem da adtech e é executado em um ambiente de execução confiável. Uma solicitação para um serviço de chave/valor não pode resultar em geração de registros no nível do evento ou ter outros efeitos colaterais. O serviço de chave-valor também oferece suporte a funções definidas pelo usuário (UDFs), que permitem que as adtechs executem a própria lógica personalizada no serviço de chave-valor.

Um comprador ou vendedor fornece uma lista de "chaves" para especificar os dados necessários de um serviço de chave/valor da API Protected Audience. O serviço de chave-valor responde com um valor para cada chave.

O código de serviço de chave/valor da API Protected Audience agora está disponível em um repositório do GitHub do Sandbox de privacidade. Esse serviço pode ser usado por desenvolvedores do Chrome e do Android.

Saiba mais sobre o serviço chave-valor da API Protected Audience no explicador de API e no explicador de modelo de confiança.

Como os dados em tempo real são incorporados aos leilões?

Os compradores ou vendedores em um leilão de anúncios podem precisar de acesso a dados em tempo real. Por exemplo, os compradores podem querer calcular o orçamento restante em uma campanha publicitária, ou o vendedor pode precisar verificar os criativos de anúncios em relação às políticas do editor.

Para atender aos requisitos de privacidade da API Protected Audience, os dados em tempo real necessários durante um leilão de anúncios são fornecidos pelo serviço de chave-valor. Quando cada comprador chama navigator.joinAdInterestGroup(), ele especifica um URL de serviço de chave-valor e as chaves que serão consultadas para o serviço durante um leilão. Da mesma forma, quando o vendedor executa um leilão de anúncios chamando navigator.runAdAuction(), ele fornece um URL para o serviço de chave-valor. O serviço de chave/valor do vendedor será consultado com o URL de renderização do criativo.

Para o teste inicial, o modelo "Bring Your Own Server" é usado. A longo prazo, as adtechs vão precisar usar os serviços de chave-valor da API Protected Audience de código aberto em execução em ambientes de execução confiáveis para extrair dados em tempo real.

Para garantir que o ecossistema tenha tempo suficiente para testar, não vamos exigir o uso dos serviços de chave-valor de código aberto ou ambientes de execução confiáveis até algum tempo após a descontinuação dos cookies de terceiros. Vamos enviar um aviso substancial para que os desenvolvedores comecem a testar e adotar o recurso antes que essa transição aconteça.

Como os dados próprios são usados em um leilão de público-alvo protegido?

Os dados próprios são de propriedade do site sobre os usuários. Por exemplo, se um usuário especificou a cor favorita dele no site do anunciante ou editor, essa cor é considerada como dados próprios.

Em um leilão de público-alvo protegido, o anunciante pode usar os dados próprios para determinar a filiação ao grupo de interesse do anúncio e também transmitir dados para o grupo de interesse como userBiddingSignals. Os dados próprios do anunciante só vão estar disponíveis para os compradores durante a etapa de geração de lances e não para os vendedores.

Por exemplo, se o anunciante souber a cor favorita do usuário, o valor poderá ser definido na configuração do grupo de interesse como userBiddingSignals quando o usuário for adicionado a um grupo de interesse:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

O editor também pode transmitir os próprios dados definindo os indicadores na configuração do leilão ao iniciar o leilão e controlar quem recebe os dados próprios. Quando um editor transmite os dados próprios como auctionSignals, eles ficam disponíveis para compradores e vendedores. Quando os dados são transmitidos como sellerSignals, eles ficam disponíveis apenas para o vendedor. Quando são transmitidos como perBuyerSignals, ficam disponíveis apenas para os compradores especificados. O editor também pode transmitir dados próprios para leilões de componentes. O editor e os participantes do leilão precisam concordar sobre quais dados próprios precisam ser compartilhados e como eles precisam ser formatados.

O exemplo a seguir descreve como os dados próprios podem ser transmitidos pelo editor a vários participantes do leilão:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

Saiba mais