Saiba como atualizar 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 todo o ciclo de vida da API Protected Audience e consulte a explicação da API para uma proposta detalhada de como os navegadores registram grupos de interesse.
Não é 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 de grupos de interesse atuam como compradores no leilão de anúncios da API Protected Audience. A participação no grupo de interesse é armazenada pelo navegador no dispositivo do usuário e não é compartilhada com o fornecedor ou qualquer outra pessoa.
Funções da API
Exemplo de uso
Confira o exemplo do guia sobre como definir dados de público-alvo, mostrando como criar um grupo de interesse e pedir ao navegador para participar 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);
O updateUrl fornece um URL que retorna JSON para atualizar atributos do grupo de interesse. Precisa ter a mesma origem do owner.
Atualizar atributos
updateUrl especifica um servidor da Web que retorna JSON definindo propriedades do grupo de interesse, correspondentes 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, é possível mudar os seguintes atributos:
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
Qualquer campo não especificado no JSON não será substituído. Somente os campos especificados no JSON serão atualizados. Já a chamada navigator.joinAdInterestGroup() substitui qualquer grupo de interesse existente.
As atualizações são mais eficientes 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 JSON.
As atualizações são limitadas a uma por dia.
As atualizações podem ser canceladas se muito tempo contínuo tiver sido gasto na atualização, mas isso não impõe limitação de taxa às 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 nos grupos de interesse pertencentes à 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 limitação de taxa (atualmente um dia) tenha passado.
O limite de taxa é 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 para um leilão são atualizados automaticamente após a conclusão dele, sujeitos aos mesmos limites 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 cuja origem corresponde 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.