Você pode acessar os IDs próprios do publisher para a web e excluir os dados de segmentação de anúncios associados.
Acessar IDs próprios do publisher na web
Os IDs próprios do publisher na web podem ser acessados diretamente nos cookies primários definidos em JavaScript no domínio do publisher. O ID destinado ao uso externo pelos nossos publishers e parceiros está no cookie __gpi. O outro cookie (chamado __gads) não é destinado a uso externo por nossos publishers ou parceiros nem pode ser usado para personalização.
O valor do cookie __gpi tem o seguinte formato:
UID=<unique_user_ID>:T=<creation_unix_timestamp_in_seconds>:RT=<refresh_unix_timestamp_in_seconds>:S=<google_generated_authenticity_signature>
Exemplo de valor __gpi:
UID=00000a1b2c3def45:T=1709171636:RT=1709171636:S=ALNI_Ma_CBr2wmXJhLdNKG9z4FWhjVVIog
O valor do ID (UID) e o carimbo de data/hora (T) são os únicos componentes destinados ao uso externo pelos nossos publishers e parceiros:
- Atualmente, o UID é uma string hexadecimal de 16 caracteres, mas o comprimento não é estável e pode mudar com o tempo.
- T é um número inteiro de base 10 que representa o carimbo de data/hora Unix da criação do ID.
Os outros dois componentes são detalhes de implementação internos que estão sujeitos a mudanças e não devem ser usados como referência.
Os cookies __gpi e __gads têm um atributo max-age de 13 meses, a menos que as limitações do navegador apaguem o cookie antes (como os limites do ITP do Safari para cookies definidos por JavaScript). Se o cookie for apagado, o Google tentará, quando permitido, preencher novamente com novos valores.
Além do __gpi e do __gads, o repositório de cookies também pode conter o cookie de recusa do usuário __gpi_opt_out. Se o valor for 1, o usuário desativou o uso da personalização no Google Ads nesse domínio (usando o controle de opções de anúncios do Google).
Antes de acessar esses cookies, garanta que o uso que você faz deles obedeça a todas as leis, diretivas, regulamentações e regras de privacidade, segurança de dados e proteção de dados em qualquer jurisdição relevante.
Ver exemplo de método JavaScript para extrair o ID
/**
* Retorna o ID próprio do publisher e o carimbo de data/hora.
* @returns {{UID: string|undefined, T: string|undefined}} Um objeto
* que reúne as strings com o UID e o carimbo de data/hora, quando disponíveis.
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// Acesse a chave e o valor do cookie
const gpiCookie = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// Use uma expressão regular para análise
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// Retorne os valores extraídos
return {
UID: regex_match[1],
T: regex_match[2]
};
}
Ver exemplos de uso
try {
const parsedValues = getPublisherFirstPartyIdAndCreationTimestamp();
console.log(parsedValues);
console.log(parsedValues['UID']); // O valor do ID
console.log(parsedValues['T']); // A criação do carimbo de data/hora
} catch (error) {
console.error(error.message);
}Excluir dados do usuário associados a IDs próprios do publisher na web
Os publishers podem pedir que dados de usuário associados a um determinado ID próprio sejam excluídos. É possível usar a API de exclusão de dados para enviar a solicitação de um único identificador. Há duas opções disponíveis. A opção 1 é compatível com a Estrutura de Solicitação de Exclusão de Dados do IAB.
Opção 1 (compatível com a Estrutura de Solicitação de Exclusão de Dados do IAB)
dsrdelete.json.dsrdelete.json e hospede-o na raiz do seu domínio. Saiba mais sobre o arquivo dsrdelete.json e os campos obrigatórios e opcionais na documentação do IAB (em inglês).Enviar uma solicitação
Atributos obrigatórios
Revise os atributos obrigatórios para sua solicitação de exclusão de dados na tabela a seguir. Para ver mais detalhes sobre parâmetros, exemplo de código e outros requisitos, acesse a Estrutura de Solicitação de Exclusão de Dados do IAB (em inglês).
| Atributo | Descrição | Valor de exemplo |
|---|---|---|
| sub.identifierType | Tipo de identificador | sco_domain |
| sub.identifierValue | O identificador que você está pedindo para excluir | 0000128ff97be809 |
| sub.identifierFormat | Formato do identificador de usuário | plaintext |
Opção 2 (descontinuada)
Para pedir a exclusão de dados associados ao componente UID de um determinado __gpi, o publisher precisa enviar uma solicitação HTTPS conforme o formulário abaixo:
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
Confira os valores que devem ser usados:
- id é o valor do ID. Ele precisa ser um número hexadecimal de 16 caracteres e é o componente UID recuperado pelo método de acesso descrito acima.
- iu é o código de rede do Ad Manager do publisher.
- idtype identifica o tipo do ID. Para IDs próprios do publisher na web, o valor precisa ser "sco", sinalizando que o cookie tem escopo restrito ao site.
Exemplo:
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
Resposta esperada
A resposta HTTPS com código de status "200", indicando que a solicitação foi bem-sucedida, será retornada se os três parâmetros estiverem presentes com valores válidos:
- O valor "id" é um valor hexadecimal de 16 caracteres
- O valor "iu" é um código de rede válido do Ad Manager
- O valor "idtype" precisa ser "sco" para indicar que este é um ID próprio do publisher na web.
A resposta HTTPS com código de status "400" será retornada se a solicitação não estiver formatada corretamente.
Excluir dados do usuário associados ao IDFV no iOS 14 ou mais recente
Os publishers do Ad Manager podem solicitar a exclusão dos dados do usuário associados a um determinado Identificador de Fornecedor (IDFV, na sigla em inglês). É possível usar a API de exclusão de dados para enviar a solicitação de um único identificador. Essa API está alinhada com a Estrutura de Solicitação de Exclusão de Dados do IAB (em inglês).
Antes de enviar uma solicitação de exclusão de dados, entre em contato com seu gerente de contas e peça a inclusão em nosso registro da estrutura do IAB. Você terá que enviar um domínio que vai hospedar o arquivo dsrdelete.json.
Depois que seu domínio for registrado no Google, crie o arquivo dsrdelete.json e hospede-o na raiz do seu domínio. Saiba mais sobre o arquivo dsrdelete.json e os campos obrigatórios e opcionais na documentação do IAB (link em inglês).
Enviar uma solicitação de exclusão de dados do IDFV
Para solicitar a exclusão de dados do IDFV, use este URL:
Atributos obrigatórios
Revise os atributos obrigatórios para sua solicitação de exclusão de dados do IDFV na tabela a seguir. Para ver mais detalhes sobre parâmetros, exemplo de código e outros requisitos, acesse a Estrutura de solicitação de exclusão de dados do IAB (em inglês).
| Atributo | Descrição |
Valor de exemplo |
|---|---|---|
| sub.identifierType | Tipo de identificador | ifv |
| sub.identifierValue | O identificador que você está pedindo para excluir | 82e812aa-1972-49ad-aad8-6092387e1275 |
| sub.identifierFormat | Formato do identificador de usuário | plaintext |