Atualizar dados de público-alvo e anúncios

Saiba como atualizar os dados de público-alvo configurando um URL de atualização para um grupo de interesse da API Protected Audience. Leia o guia para desenvolvedores com o ciclo de vida completo da API Protected Audience e confira a explicação sobre ela para conferir uma proposta detalhada de como os navegadores registram grupos de interesse.

Não é um desenvolvedor? Consulte a visão geral da API Protected Audience.

Grupos de interesse da API Protected Audience

Um grupo de interesse da API Protected Audience representa um grupo de pessoas com um interesse comum, correspondente a uma lista de remarketing. Cada grupo de interesse da API Protected Audience tem um proprietário.

Os proprietários do grupo de interesse agem como compradores no leilão de anúncios da API Protected Audience. A associação ao grupo de interesse é armazenada pelo navegador, no dispositivo do usuário e não é compartilhada com o fornecedor do navegador nem com qualquer outra pessoa.

Funções da API

Exemplo de uso

Veja o exemplo do guia sobre como definir dados de público-alvo, mostrando como criar um grupo de interesse e pedir que o navegador participe dele.

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  updateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

updateUrl fornece um URL que retorna JSON para atualizar os atributos do grupo de interesse. Precisa ter a mesma origem que owner.

Atualizar atributos

updateUrl especifica um servidor da Web que retorna JSON que define as propriedades do grupo de interesse, correspondente ao objeto do grupo de interesse transmitido para joinAdInterestGroup().

Isso permite que o proprietário do grupo atualize periodicamente os atributos do grupo de interesse. Na implementação atual, os seguintes atributos podem ser alterados:

  • biddingLogicUrl
  • biddingWasmHelperUrl
  • trustedBiddingSignalsUrl
  • trustedBiddingSignalsKeys
  • ads
  • priority

Qualquer campo não especificado no JSON não será substituído. Somente os campos especificados no JSON serão atualizados. Chamar navigator.joinAdInterestGroup() substitui qualquer grupo de interesse atual.

As atualizações são feitas da melhor maneira possível e podem falhar nas seguintes condições:

  • Tempo limite da solicitação de rede (atualmente 30 segundos).
  • Outra falha de rede.
  • Falha na análise de JSON.

As atualizações são limitadas por taxa a no máximo uma por dia.

As atualizações podem ser canceladas se muito tempo contíguo tiver sido gasto atualizando, embora isso não imponha nenhuma limitação de taxa para atualizações canceladas (restantes). As atualizações que falham devido a erros de rede são repetidas após uma hora, e as que falham devido à desconexão da Internet são repetidas imediatamente após a reconexão.

Atualizações manuais

As atualizações em grupos de interesse da origem do frame atual podem ser acionadas manualmente usando navigator.updateAdInterestGroups().

A limitação de taxa impede que as atualizações aconteçam com muita frequência: chamadas repetidas para navigator.updateAdInterestGroups() não fazem nada até que o período de limite de taxa (atualmente um dia) tenha passado.

O limite de taxa será redefinido se navigator.joinAdInterestGroup() for chamado novamente para os mesmos grupos de interesse owner e name.

Atualizações automáticas

Todos os grupos de interesse carregados para um leilão são atualizados automaticamente após a conclusão dele e estão sujeitos às mesmas limitações de taxa das atualizações manuais.

Para cada proprietário com pelo menos um grupo de interesse participando de um leilão, é como se navigator.updateAdInterestGroups() fosse chamado de um iframe com origem correspondente a esse proprietário.

Todas as referências da API Protected Audience

Os guias de referência da API estão disponíveis:

A explicação da API Protected Audience também fornece detalhes sobre o suporte e as restrições de recursos.