Visão geral da API Protected Audience

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

Qual é o público deste artigo?

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

Consulte o glossário para ver os termos usados em Documentação da API Protected Audience. Ao final deste artigo, você vai saber como interagir e compartilhar feedback.

O que é a API Protected Audience?

A API Protected Audience é um Sandbox de privacidade tecnologia para atender a casos de uso de remarketing e público-alvo personalizado, projetadas terceiros não podem rastrear o comportamento de navegação do usuário em sites diferentes.

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

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

API Protected Audience em um minuto

Para mais detalhes sobre a API Protected Audience, leia o Guia da API Protected Audience para desenvolvedores.

Informações gerais de cada estágio 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 exibir anúncios relevantes para seus usuários.

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

  • O nome do grupo de interesse: por exemplo, "bicicletas personalizadas".
  • 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 código de lance, código de anúncio e dados em tempo real, se o proprietário do grupo for convidado a dar lances em um leilão de anúncios.
.

Depois, quando o usuário acessar um site com espaço publicitário disponível, o vendedor do espaço publicitário (um fornecedor do lado do vendedor (SSP, na sigla em inglês) ou o site pode usar a API Protected Audience para fazer um leilão e selecionar os anúncios mais adequados. exibir ao usuário. O vendedor chama navigator.runAdAuction(). que fornece uma lista de proprietários de grupos de interesse convidados a definir lances.

Os lances só podem ser fornecidos por grupos de interesse dos quais o navegador faz parte e que têm proprietários convidados a fazer lances.

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

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

Quando o navegador chama a função para realizar o leilão de anúncios, o código de cada comprador gera um lance com a ajuda de dados em tempo real fornecidos pela serviço de chave-valor da API Protected Audience. Depois, o vendedor recebe esses lances, bem como dados em tempo real de propriedade do vendedor e pontua cada lance. O lance com a pontuação mais alta vence o leilão.

O anúncio vencedor é exibido frame isolado. O URL do criativo do anúncio é especificado no lance, e a origem precisa corresponder a um a 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 API Protected Audience.

Por que precisamos da API Protected Audience?

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

Tradicionalmente, as plataformas de anúncios aprendem sobre os interesses dos usuários rastreando os do comportamento nos sites. Os navegadores precisam permitir que as plataformas de publicidade selecionem relevantes, para que os editores de conteúdo possam gerar receita de publicidade sem monitoramento.

O objetivo da API Protected Audience é aproximar a plataforma da Web de um estado em que o o navegador do usuário no dispositivo (não o anunciante nem as plataformas de adtech) mantém informações sobre no que essa pessoa está interessada.

Como faço para testar a API Protected Audience?

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

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

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

Vamos atualizar as configurações disponíveis no Chrome à medida que a API Protected Audience avançar. com base em testes e feedback. No futuro, vamos oferecer configurações mais granulares para gerenciar as APIs Protected Audience e dados associados.

Os autores das 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. seja como proprietário de um site ou como um usuário individual.

Principais conceitos

Procurando mais informações sobre a terminologia da API Protected Audience? Consulte a 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 em comum, que correspondem a uma lista de remarketing.

Cada grupo de interesse da API Protected Audience tem um proprietário. Diferentes tipos de proprietários criam diferentes tipos de grupos de interesse com diferentes casos de uso.

O proprietário solicita que o navegador do usuário adicione a associação ao grupo de interesse dele 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 JavaScript usado nos lances. Os dados do grupo de interesse (como os anúncios) podem ser atualizado e um grupo de interesse pode ser ativado por até 30 dias.

Tipos de grupo 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 visualizaram 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 para comprar anúncios relevantes para os leitores no site. Um o grupo de interesse de um editor poderá permitir que os editores façam o mesmo, quando essas pessoas estiverem navegando em outros sites. Os editores podem cobram pela capacidade de exibir anúncios para segmentos específicos de seus público-alvo.
AdTech DSP Categoria de produtos Pessoas que mostraram interesse em equipamentos de ciclismo. Uma empresa de adtech pode criar e gerenciar um grupo de interesse de pessoas que acreditam estar no mercado em busca de alguma categoria de item. Este grupo de interesse possam ser usados para anunciar produtos em sites que vendem itens dessa categoria (e que trabalham com a empresa de adtech).

O Chrome permite até mil grupos de interesse por proprietário e até mil grupos de interesse. donos. Esses limites são usados como uma proteção, e não durante a operação normal.

O que é um comprador?

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

Exemplo:

  • Anunciante: agindo por conta própria.
  • Plataforma de demanda (DSP): atuação para anunciantes.
  • Proprietário do grupo de interesse: trabalhar para vários anunciantes.

Os compradores têm três empregos:

  • Escolha se você quer participar de um leilão.
  • Escolha anúncios e calcule um lance.
  • Informar o resultado do leilão.

Esses jobs são realizados de maneira programática, no 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 dos quais ele é membro (chamando o função JavaScript navigator.joinAdInterestGroup()), o comprador fornece ao navegador:

  • Um URL para o código de lance que será usado quando o vendedor fizer um leilão de anúncios.
  • É possível que sejam URLs para criativos de anúncios do grupo de interesse. Os URLs dos anúncios podem ser adicionados mais tarde com uma atualização.
  • Uma lista de chaves de dados que serão consultadas e o URL do serviço de chave-valor do comprador para ativar o código de lances e acessar 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?

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

Exemplo:

  • Editor de conteúdo: agindo por conta própria para hospedar o conteúdo do anúncio no próprio site.
  • Plataforma de fornecimento (SSP): trabalhar com o editor e oferecer outros serviços.
  • Script de terceiros: atuar para um editor, permitir a participação em leilões de anúncios.

Com a API Protected Audience, um vendedor de espaços publicitários tem três funções:

  • Aplicar regras do editor: informando quais compradores e lances são qualificados.
  • Executar lógica de leilão: JavaScript executado em worklets para calcular uma o índice de atratividade para cada lance.
  • Informar o resultado do leilão.

Esses trabalhos são realizados de forma programática, no código fornecido pelo vendedor quando ele inicia um anúncio. leilão 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 de um leilão de anúncios da API Protected Audience
Fases do leilão de anúncios da API Protected Audience.

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

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

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

  1. Um usuário visita um site que exibe anúncios.
  2. O código do vendedor inicia um leilão. O vendedor especifica qual espaço de anúncio é para venda e quem pode definir lances, bem como um método para pontuar esses lances.
  3. O código do comprador convidado é executado para gerar um lance e o URL de um anúncio relevante criativos e outros dados. O script de lances consulta dados em tempo real, como o orçamento restante da campanha publicitária, da chave-valor do comprador serviço.
  4. O código do vendedor pontua cada lance e seleciona um vencedor. Essa lógica usa valor de lance e outros dados para mostrar a atratividade de um lance e rejeitar um anúncio que não pode vencer o vencedor do anúncio contextual. O vendedor pode usar as próprias Serviço de chave-valor para dados em tempo real. Antes um leilão é iniciado, o vendedor encontra o melhor anúncio contextual para espaço de anúncio.
  5. O anúncio vencedor é retornado como um objeto de configuração de frame isolado quando a sinalização resolveToConfig é definida na configuração do leilão. A configuração é usada para navegar entre o frame isolado e o criativo do anúncio, e o URL do criativo fica oculto para o vendedor e o editor. Se a flag resolveToConfig for definida como false ou não for transmitida, o anúncio vencedor vai 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 isolado está disponível da versão M114 em diante.
  6. O leilão é informado ao vendedor e aos compradores vencedores.

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 pontuam os anúncios enquanto preservam a privacidade. Saiba mais sobre o serviço de chave-valor da API Protected Audience e outros nos serviços da API Protected Audience.

O serviço de chave-valor é implantado na infraestrutura em nuvem da própria 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 registros no nível do evento nem ter outros efeitos colaterais. O serviço de chave-valor também vai oferecer suporte a funções definidas pelo usuário (UDFs), que permitem que as adtechs executem a própria lógica personalizada nesse serviço.

Um comprador ou vendedor fornece uma lista de "chaves" para especificar os dados exigidos 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 (link em inglês). Esse serviço pode ser usado por desenvolvedores do Chrome e do Android.

Saiba mais sobre o serviço de chave-valor da API Protected Audience do Explicação sobre a API e a explicação do modelo de confiança.

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

Os compradores ou vendedores de um leilão de anúncios precisam acessar os dados de relatórios dados. Por exemplo, os compradores podem querer calcular o orçamento restante em uma campanha publicitária ou o o vendedor pode ser obrigado a verificar se os criativos do anúncio estão de acordo com as políticas do editor.

Para atender aos requisitos de privacidade da API Protected Audience, o serviço de chave-valor fornece dados em tempo real durante um leilão de anúncios. Quando cada comprador chama navigator.joinAdInterestGroup(), ele especifica um URL de serviço de chave-valor e as chaves a serem 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, é usado o modelo "traga seu próprio servidor". A longo prazo, as adtechs vão precisar usar os serviços de chave-valor da API Protected Audience de código aberto em ambientes de execução confiáveis para recuperar dados em tempo real.

Para garantir que o ecossistema tenha tempo suficiente para os testes, não esperamos exigir o uso dos serviços de chave-valor de código aberto ou de ambientes de execução confiáveis até algum tempo após a descontinuação dos cookies de terceiros. Antes dessa transição, vamos enviar avisos para os desenvolvedores começarem os testes e a adoção.

Como os dados próprios são usados em um leilão com Protected Audience?

Os dados próprios são as informações que o site tem sobre os usuários dele. Por exemplo, se um usuário especificar sua cor favorita no site do anunciante ou do editor, essa cor será considerada dados primários.

Em um leilão da API Protected Audience, o anunciante pode usar dados próprios para determinar a assinatura do grupo de interesse no anúncio e transmitir dados ao grupo como userBiddingSignals. Os dados próprios do anunciante só ficam disponíveis para os compradores durante a etapa de geração de lances e não são disponibilizados para 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 dados próprios definindo os indicadores na configuração do leilão ao iniciar o leilão e pode controlar quem recebe esses dados. 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 e, quando 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 devem concordar antes sobre quais dados próprios precisam ser compartilhados e como os dados 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

Para mais detalhes sobre a API Protected Audience, leia o Guia da API Protected Audience para desenvolvedores.

Desenvolvedores

Se estiver com tudo pronto para começar a trabalhar com a API Protected Audience, leia experimentar e participar.

Criamos um guia para desenvolvedores sobre APIs e criamos uma demonstração da API Protected Audience, que oferece um tutorial da implantação básica dessa API. O vídeo de demonstração da API Protected Audience explica como o código de demonstração funciona e mostra como usar o Chrome DevTools para depurar essa API.

Interaja e compartilhe feedback