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:
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
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:
- Guia do desenvolvedor da API Protected Audience.
- Guia do comprador de anúncios sobre grupos de interesse e geração de lances da API Protected Audience.
- Guia do vendedor de anúncios para leilões de anúncios da Protected Audience.
- Guia para gerar relatórios de resultados do leilão
- Práticas recomendadas para latência do leilão de anúncios da Protected Audience
- Resolver problemas da API Protected Audience
A explicação da API Protected Audience também fornece detalhes sobre o suporte e as restrições de recursos.