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 para conhecer o ciclo de vida completo da API Protected Audience e consulte a explicação da API Protected Audience para conferir uma proposta detalhada de como os navegadores registram os 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 em comum, correspondente a uma lista de remarketing. Todo grupo de interesse da API Protected Audience tem um proprietário.
Os proprietários dos grupos de interesse atuam como compradores no leilão de anúncios da API Protected Audience. A associação ao grupo de interesse é armazenada pelo navegador e 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 do público-alvo, que mostra como criar um grupo de interesse e pedir que o navegador entre nele.
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);
O 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 definindo as propriedades do grupo de interesse, correspondendo 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
Os campos não especificados no JSON não serão substituídos. Somente os campos especificados no JSON serão atualizados, enquanto chamar navigator.joinAdInterestGroup() substitui qualquer grupo de interesse atual.
As atualizações são feitas com o melhor esforço 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.
Há uma limitação de taxa para as atualizações, no máximo uma por dia.
As atualizações podem ser canceladas se passar muito tempo contíguo na atualização, embora isso não imponha nenhuma limitação de taxa a atualizações canceladas (restantes). As atualizações que falham devido a erros de rede são repetidas após uma hora. Já as que falham devido à desconexão da Internet são refeitas imediatamente após a reconexão.
Atualizações manuais
As atualizações em grupos de interesse pertencentes à origem do frame atual podem ser acionadas manualmente usando navigator.updateAdInterestGroups().
A limitação de taxa impede que atualizações aconteçam com muita frequência: chamadas repetidas para navigator.updateAdInterestGroups() não fazem nada até que o período de limitação de taxa (atualmente um dia) tenha passado.
O limite de taxa será redefinido se navigator.joinAdInterestGroup() for chamado novamente para o mesmo grupo de interesse owner e name.
Atualizações automáticas
Todos os grupos de interesse carregados em um leilão são atualizados automaticamente após a conclusão do leilão, sujeitos aos mesmos limites de taxa das atualizações manuais.
Para cada proprietário com pelo menos um grupo de interesse que participa de um leilão, é como se navigator.updateAdInterestGroups() fosse chamado de um iframe com a 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.