Puoi accedere agli ID proprietari dei publisher per il web ed eliminare i dati di targeting degli annunci associati.
Accedi agli ID proprietari dei publisher sul web
Gli ID proprietari dei publisher sul web sono accessibili direttamente dai cookie proprietari impostati da JavaScript nel dominio del publisher. L'ID destinato all'utilizzo esterno da parte dei nostri publisher e partner si trova all'interno del cookie __gpi. L'altro cookie (chiamato __gads) non è destinato all'utilizzo esterno da parte dei nostri publisher o partner e non è consentito usarlo per la personalizzazione.
Il valore del cookie __gpi ha il seguente formato:
UID=<unique_user_ID>:T=<creation_unix_timestamp_in_seconds>:RT=<refresh_unix_timestamp_in_seconds>:S=<google_generated_authenticity_signature>
Valore di esempio di __gpi:
UID=00000a1b2c3def45:T=1709171636:RT=1709171636:S=ALNI_Ma_CBr2wmXJhLdNKG9z4FWhjVVIog
Il valore dell'ID (UID) e il timestamp (T) sono gli unici componenti destinati all'utilizzo esterno da parte dei nostri publisher e partner:
- L'UID è attualmente una stringa esadecimale di 16 caratteri, ma la lunghezza non deve essere considerata stabile e potrebbe cambiare nel tempo.
- T è un numero intero in base 10 che rappresenta il timestamp Unix della creazione dell'ID.
Gli altri due componenti sono dettagli di implementazione interni che sono soggetti a modifica e non devono essere considerati affidabili.
Al momento, i cookie __gpi e __gads hanno entrambi un valore di età massima di 13 mesi, a meno che le limitazioni del browser non cancellino il cookie prima (ad esempio i limiti ITP di Safari per i cookie impostati da JavaScript). Se il cookie viene cancellato, Google tenterà, se consentito, di ricompilarlo con nuovi valori.
Oltre a __gpi e __gads, l'archivio di cookie può contenere anche il cookie di disattivazione dell'utente __gpi_opt_out. Se ha un valore pari a 1, l'utente ha disattivato l'uso della personalizzazione per Google Ads in quel dominio (tramite il controllo delle opzioni per gli annunci di Google).
Prima di accedere a questi cookie, devi assicurarti che il modo in cui li usi sia conforme a tutte le leggi, le direttive, i regolamenti e le norme riguardanti la privacy, la sicurezza dei dati e la protezione dei dati in qualsiasi giurisdizione applicabile.
Visualizza un esempio di metodo JavaScript per recuperare l'ID
/**
* Restituisce l'ID proprietario del publisher e il timestamp.
* @returns {{UID: string|undefined, T: string|undefined}} Un oggetto
* contenente le stringhe di UID e timestamp, se disponibili.
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// Recupera la chiave e il valore del cookie
const gpiCookie = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// Usa un'espressione regolare per analizzare
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// Restituisci i valori estratti
return {
UID: regex_match[1],
T: regex_match[2]
};
}
Visualizza un esempio di utilizzo
try {
const parsedValues = getPublisherFirstPartyIdAndCreationTimestamp();
console.log(parsedValues);
console.log(parsedValues['UID']); // Il valore dell'ID
console.log(parsedValues['T']); // Il timestamp di creazione
} catch (error) {
console.error(error.message);
}Elimina i dati utente associati agli ID proprietari dei publisher sul web
I publisher possono richiedere l'eliminazione dei dati utente associati a un determinato ID proprietario. Puoi usare l'API di eliminazione dei dati per inviare una richiesta per un singolo identificatore. Sono disponibili due opzioni. L'opzione 1 supporta il Data Deletion Request Framework di IAB.
Opzione 1 (supporta il Data Deletion Request Framework di IAB)
dsrdelete.json.dsrdelete.json e ospitarlo nella directory radice del dominio. Per scoprire di più sul file dsrdelete.json e sui relativi campi obbligatori e facoltativi, consulta la documentazione di IAB.Invia una richiesta
Attributi obbligatori
Consulta la tabella seguente per esaminare gli attributi obbligatori per la richiesta di eliminazione dei dati. Per conoscere i dettagli su parametri, codice campione e altri requisiti, visita la pagina IAB Data Deletion Request Framework.
| Attributo | Descrizione | Valore di esempio |
|---|---|---|
| sub.identifierType | Tipo di identificatore | sco_domain |
| sub.identifierValue | L'identificatore di cui richiedi l'eliminazione | 0000128ff97be809 |
| sub.identifierFormat | Formato dell'identificatore dell'utente | plaintext |
Opzione 2 (ritirata)
Per richiedere l'eliminazione dei dati associati al componente UID di un determinato __gpi, il publisher deve inviare una richiesta HTTPS nel seguente formato:
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
Prendi nota di questi valori per la formattazione:
- id è il valore dell'ID. Deve essere un numero esadecimale di 16 caratteri ed è il componente UID recuperato dal metodo di accesso descritto sopra.
- iu è il codice di rete Ad Manager del publisher.
- idtype identifica il tipo di ID. Per gli ID proprietari del publisher sul web, il valore deve essere "sco" per indicare il cookie basato sul sito.
Esempio:
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
Risposta prevista
Il codice di stato della risposta HTTPS "200", che indica che la richiesta era corretta, verrà restituito se i tre parametri sono presenti con valori validi:
- Il valore "id" è un valore esadecimale di 16 caratteri.
- Il valore "iu" è un codice di rete Ad Manager valido.
- Il valore "idtype" deve essere "sco" per indicare che si tratta di un ID proprietario del publisher sul web.
Il codice di stato della risposta HTTPS "400" viene restituito se la richiesta non è formattata correttamente.
Elimina i dati utente associati all'IDFV su iOS versione 14 o successiva
I publisher Ad Manager possono richiedere l'eliminazione dei dati utente associati a un determinato identificatore per fornitore (IDFV). Puoi usare l'API di eliminazione dei dati per inviare una richiesta per un singolo identificatore. L'API per l'eliminazione dei dati è in linea con il Data Deletion Request Framework di IAB.
Prima di inviare una richiesta di eliminazione dei dati, devi contattare il tuo account manager e chiedere che ti aggiunga al nostro registro per il framework IAB. Dovrai inviare un dominio che ospiterà il file dsrdelete.json.
Una volta registrato il dominio con Google, devi creare il file dsrdelete.json e ospitarlo nella directory radice del dominio. Per saperne di più sul file dsrdelete.json e sui relativi campi obbligatori e facoltativi, consulta la documentazione di IAB.
Invia una richiesta di eliminazione dei dati dell'IDFV
Per richiedere l'eliminazione dei dati dell'IDFV, avvia la richiesta utilizzando il seguente URL:
Attributi obbligatori
Rivedi gli attributi obbligatori per la richiesta di eliminazione dei dati IDFV nella seguente tabella. Per conoscere i dettagli su parametri, codice campione e altri requisiti, visita la pagina IAB Data Deletion Request Framework.
| Attributo | Descrizione |
Valore di esempio |
|---|---|---|
| sub.identifierType | Tipo di identificatore | ifv |
| sub.identifierValue | L'identificatore di cui richiedi l'eliminazione | 82e812aa-1972-49ad-aad8-6092387e1275 |
| sub.identifierFormat | Formato dell'identificatore dell'utente | plaintext |