Anúncios limitados e configurações de identificadores próprios

Com os anúncios limitados, os apps podem veicular anúncios quando os usuários não autorizam o compartilhamento de dados pessoais. O modo de anúncios limitados interrompe a coleta, o compartilhamento e o uso de dados pessoais para a seleção de anúncios. Se os usuários optarem por não compartilhar dados pessoais, esse recurso permitirá que os anúncios continuem sendo veiculados.

Este guia aborda o uso de configurações de anúncios limitados no seu app e a correspondência do comportamento do app com as configurações globais da sua rede do Google Ad Manager.

Configurar as opções de anúncios limitados do cliente

O PAL está atualizando a forma como lida com as configurações para refinar o controle sobre a privacidade do usuário e o uso de dados. A versão 1.90.0 do PAL introduz a propriedade forceLimitedAds e descontinua a propriedade allowStorage. Essas propriedades estão na classe ConsentSettings.

A partir da versão 1.90.0, a PAL lê os dados da Estrutura de Transparência e Consentimento (TCF, na sigla em inglês) do dispositivo para determinar o consentimento do usuário em relação ao armazenamento local. Essa mudança na leitura de dados da TCF torna a propriedade allowStorage redundante. Seu app ainda precisa transmitir os parâmetros gdpr= e gdpr_consent= no URL da tag de anúncio.

Se a determinação automática com base na TCF for insuficiente, defina diretamente a propriedade forceLimitedAds no seu app. Para mais detalhes, consulte Integração do publisher com a TCF do IAB Europe. Definir a propriedade forceLimitedAds como um valor true impede que a PAL armazene ou envie identificadores de usuário no nonce enviado ao servidor. Definir a propriedade forceLimitedAds como um valor true é o mesmo que adicionar o parâmetro ltd=1 ao URL da solicitação de anúncio nos SDKs do IMA (Interactive Media Ads). Para mais detalhes sobre anúncios limitados, consulte ltd (Anúncios limitados). Quando você define a propriedade forceLimitedAds como um valor true, a PAL inclui o parâmetro ltd=1 no nonce.

Para manter o comportamento atual no app, talvez seja necessário atualizar a implementação, mesmo que você não tenha definido a propriedade allowStorage antes. A propriedade allowStorage atual tem como padrão um valor false, que ativa os anúncios limitados. A propriedade forceLimitedAds tem como padrão um valor false que não ativa os anúncios limitados.

Atualização da Fase 1 da determinação da TCF

A versão da Fase 1 do PAL HTML5 prepara você para fazer a transição da propriedade ConsentSettings.allowStorage para a determinação automática de anúncios limitados com base na TCF.

Durante essa fase de transição, a PAL considera os dados da TCF do usuário, a propriedade allowStorage atual e a propriedade forceLimitedAds mais recente. Durante essa fase, você precisa sempre definir a propriedade allowStorage como um valor true para permitir que a PAL determine se os anúncios limitados se aplicam com base nos dados da TCF. Se você quiser ativar os anúncios limitados independente da determinação da TCF, defina a propriedade forceLimitedAds como um valor true.

Durante a Fase 1, a PAL ativa anúncios limitados em qualquer uma das seguintes circunstâncias:

  • A propriedade allowStorage é um valor false ou não está definida. Não recomendamos usar essa configuração para a propriedade allowStorage, já que ela é apenas para oferecer suporte a apps que não foram atualizados.
  • A propriedade forceLimitedAds é um valor true.
  • A PAL detecta que o consentimento da finalidade 1 da TCF (Transparency and Consent Framework) do IAB (Interactive Advertising Bureau) não foi concedido.

A tabela a seguir mostra todos os estados possíveis e se os anúncios limitados estão ativados:

Consentimento para a finalidade 1 da TCF Propriedade allowStorage Propriedade forceLimitedAds Anúncios limitados ativados
Concedido Verdadeiro Verdadeiro Verdadeiro
Não concedido Verdadeiro Verdadeiro Verdadeiro
Concedido Verdadeiro False (padrão) Falso
Não concedido Verdadeiro False (padrão) Verdadeiro
Concedido False (padrão) Verdadeiro Verdadeiro
Não concedido False (padrão) Verdadeiro Verdadeiro
Concedido False (padrão) False (padrão) Verdadeiro
Não concedido False (padrão) False (padrão) Verdadeiro

Prepare-se para a determinação da TCF da Fase 2

A versão da Fase 2 remove a funcionalidade da propriedade allowStorage. Estamos planejando o lançamento da Fase 2 90 dias após os lançamentos da Fase 1, estimado para 10 de março de 2026. Antes dessa data, atualize sua implementação para usar o parâmetro ConsentSettings.forceLimitedAds.

Para a versão da Fase 2, a PAL ativa anúncios limitados com base apenas na ausência de consentimento para a Finalidade 1 da TCF e na propriedade opcional ConsentSettings.forceLimitedAds:

Consentimento para a finalidade 1 da TCF Propriedade forceLimitedAds Anúncios limitados ativados
Concedido Verdadeiro Verdadeiro
Não concedido Verdadeiro Verdadeiro
Concedido False (padrão) Falso
Não concedido False (padrão) Verdadeiro

Corresponder às configurações globais do Google Ad Manager

Se você atualizar as configurações do Ad Manager Anúncios limitados programáticos ou Cookies primários para anúncios na Web, use essas novas APIs para corresponder às configurações no Ad Manager. Se você não usar as APIs, a PAL poderá incluir os identificadores no nonce usado na solicitação de anúncio ao servidor. No entanto, o Ad Manager pode descartar os indicadores com base nas configurações dele.

As APIs são as seguintes:

  • disableLimitedAdsStorage: desativa os cookies exclusivos para detecção de tráfego inválido e o uso do armazenamento local para anúncios limitados. Se você atualizou a configuração Anúncios limitados programáticos no Ad Manager em Administrador > Configurações globais, use essa API para desativar o uso do armazenamento local para anúncios limitados na PAL. Essa configuração não se aplica a anúncios não limitados.
  • disableFirstPartyIdentifiers - desativa os identificadores próprios usados para a seleção de anúncios. Se você atualizou a configuração Cookies primários para anúncios na Web no Ad Manager em Administrador > Global, use esta API para desativar esses identificadores na PAL. Essa configuração não se aplica ao uso de cookies e armazenamento local para detecção de tráfego inválido.

O exemplo a seguir processa a privacidade do usuário e o uso de dados em uma implementação da PAL:

const consentSettings = new goog.pal.ConsentSettings();
consentSettings.allowStorage = true;
// During the PAL Phase 1 release, best practice is to always set the
// `allowStorage` property to a `true` value to allow PAL to automatically
// determine whether limited ads applies based on the TCF data.
// To enable limited ads regardless of the TCF determination, set the
// `forceLimitedAds` property to a `true` value.

const adManagerSettings = new goog.pal.GoogleAdManagerSettings();
// Add this line if the "Programmatic limited ads" toggle is turned off in
// Ad Manager.
adManagerSettings.disableLimitedAdsStorage = true;
// Add this line if the "First party cookies for ads on web" toggle
// is turned off in Ad Manager.
adManagerSettings.disableFirstPartyIdentifiers = true;

const nonceLoader = new goog.pal.NonceLoader(consentSettings, adManagerSettings);