U heeft toegang tot first-party ID's van uitgevers voor het web en kunt bijbehorende gegevens voor advertentietargeting verwijderen.
Toegang tot first-party ID's van uitgevers op het web
De first-party ID's van uitgevers voor het web zijn rechtstreeks toegankelijk via door JavaScript ingestelde first-party cookies onder het domein van de uitgever. De ID die is bedoeld voor extern gebruik door onze uitgevers en partners, staat in het cookie __gpi. Het andere cookie (met de naam __gads) is niet bedoeld voor extern gebruik door onze uitgevers of partners en is niet toegestaan voor personalisatiedoeleinden.
De waarde van het cookie __gpi heeft de volgende indeling:
UID=<unique_user_ID>:T=<creation_unix_timestamp_in_seconds>:RT=<refresh_unix_timestamp_in_seconds>:S=<google_generated_authenticity_signature>
Voorbeeld van een __gpi-waarde:
UID=00000a1b2c3def45:T=1709171636:RT=1709171636:S=ALNI_Ma_CBr2wmXJhLdNKG9z4FWhjVVIog
De waarde van de ID (UID) en het tijdstempel (T) zijn de enige componenten die zijn bedoeld voor extern gebruik door onze uitgevers en partners:
- UID is op dit moment een hexadecimale tekenreeks van 16 tekens, maar de lengte moet niet als stabiel worden beschouwd en kan in de loop van de tijd veranderen.
- T is een geheel getal op basis 10 dat het Unix-tijdstempel aangeeft van het moment waarop de ID is gemaakt.
De andere 2 componenten zijn interne implementatiegegevens die kunnen worden gewijzigd en waarop u niet kunt vertrouwen.
De cookies __gpi en __gpi hebben momenteel allebei een maximumleeftijd van 13 maanden, tenzij browserbeperkingen het cookie eerder wissen (zoals Safari ITP-beperkingen voor door JavaScript ingestelde cookies). Als het cookie wordt gewist, probeert Google, indien dit is toegestaan, het opnieuw in te vullen met nieuwe waarden.
Naast __gpi en __gpi kan de cookie jar ook het afmeldingscookie __gpi van de gebruiker bevatten. Als de waarde 1 is, heeft de gebruiker het gebruik van personalisatie voor Google Ads in dat domein uitgezet (via het bedieningselement Advertentieopties van Google).
Voordat u toegang krijgt tot die cookies, moet u ervoor zorgen dat uw gebruik van de cookies voldoet aan alle toepasselijke wetgeving, richtlijnen, voorschriften en regels met betrekking tot privacy, gegevensbeveiliging en gegevensbescherming.
Voorbeeld van JavaScript-methode om ID op te halen
/**
* Hiermee worden de first-party ID en het tijdstempel van de uitgever geretourneerd.
* @returns {{UID: string|undefined, T: string|undefined}} Een object
* met de tekenreeksen UID en Tijdstempel, indien beschikbaar.
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// Haal de cookie-sleutel en -waarde op
const getPublisherFirstPartyIdAndCreationTimestamp = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// Gebruik een reguliere expressie voor parseren
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// De geëxtraheerde waarden retourneren
return {
UID: regex_match[1],
T: regex_match[2]
};
}
Voorbeeldgebruik bekijken
try {
const parsedValues = getPublisherFirstPartyIdAndCreationTimestamp();
console.log(parsedValues);
console.log(parsedValues['UID']); // De waarde van de ID
console.log(parsedValues['T']); // het tijdstempel van maken
} catch (error) {
console.error(error.message);
}Gebruikersgegevens verwijderen die zijn gekoppeld aan first-party ID's van uitgevers op het web
Uitgevers kunnen verzoeken om gebruikersgegevens die aan een bepaalde __gpi zijn gekoppeld, te verwijderen uit de interne opslagsystemen voor advertentietargeting van Google.
Als de uitgever verwijdering wil aanvragen voor gegevens die zijn gekoppeld aan de UID-component van een bepaalde __gpi, stuurt deze een HTTP-verzoek van de volgende indeling:
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
Gebruik deze waarden voor het formulier:
- id is de waarde van de ID. Dit moet een hexadecimaal getal van 16 tekens zijn en is de UID-component die wordt opgehaald door de bovenstaande toegangsmethode.
- iu is de Ad Manager-netwerkcode van de uitgever.
- idtype geeft het type ID aan. Voor first-party ID's van uitgevers op het web moet de waarde 'sco' zijn om een sitegericht cookie aan te geven.
Voorbeeld:
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
Verwachte reactie
De HTTP-statuscode 200, die aangeeft dat het verzoek in orde was, wordt geretourneerd als de 3 parameters aanwezig zijn met geldige waarden:
- De id-waarde is een hexadecimale waarde van 16 tekens.
- De iu-waarde is een geldige Ad Manager-netwerkcode
- De waarde van idtype moet 'sco' zijn om aan te geven dat dit een first-party ID van een uitgever op internet is
De HTTP-statuscode 400 wordt geretourneerd als het verzoek niet de juiste indeling heeft.
