U kunt first-party-ID's van uitgevers voor het web openen en gekoppelde advertentietargetinggegevens verwijderen.
Toegang tot first-party-ID's van uitgevers voor 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 de cookie __gpi. De andere cookie (met de naam __gads) is niet bedoeld voor extern gebruik door onze uitgevers of partners en mag niet worden gebruikt voor personalisatie.
De waarde van de cookie __gpi heeft de volgende vorm:
UID=<unique_user_ID>:T=<creation_unix_timestamp_in_seconds>:RT=<refresh_unix_timestamp_in_seconds>:S=<google_generated_authenticity_signature>
Voorbeeldwaarde van __gpi:
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 bedoeld zijn voor extern gebruik door onze uitgevers en partners:
- UID is op dit moment een hexadecimale tekenreeks van 16 tekens, maar de lengte is niet stabiel en kan in de loop van de tijd veranderen.
- T is een geheel getal in het tientallige stelsel dat het Unix-tijdstempel aangeeft van het moment waarop de ID werd gemaakt.
De andere 2 componenten zijn interne implementatiegegevens die kunnen worden gewijzigd en waarop u niet moet vertrouwen.
De cookies __gpi en __gads hebben op dit moment allebei een maximumleeftijd van 13 maanden, tenzij browserbeperkingen de cookie eerder wissen (zoals Safari ITP-beperkingen voor door JavaScript ingestelde cookies). Als de cookie wordt gewist, probeert Google deze, wanneer toegestaan, opnieuw te vullen met nieuwe waarden.
Naast __gpi en __gads kan de cookie jar ook de afmeldingscookie __gpi_opt_out van de gebruiker bevatten. Als de waarde 1 is, heeft de gebruiker het gebruik van personalisatie voor Google Ads uitgezet voor dat domein (via de beheeroptie voor advertentieopties van Google).
Voordat u toegang krijgt tot die cookies, moet u zorgen dat uw gebruik van de cookies voldoet aan alle wetten, richtlijnen, voorschriften en regels met betrekking tot privacy, gegevensbeveiliging en gegevensbescherming in alle toepasselijke jurisdicties.
Voorbeeld van een JavaScript-methode om de ID op te halen bekijken
/**
* Retourneert de first-party-ID en het tijdstempel van de uitgever.
* @returns {{UID: string|undefined, T: string|undefined}} Een object
* met de tekenreeksen UID en Tijdstempel, wanneer beschikbaar.
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// Haal de sleutel+waarde van de cookie op
const gpiCookie = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// Gebruik een reguliere expressie om te parseren
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// Retourneer de geëxtraheerde waarden
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 gekoppeld zijn aan first-party-ID's van uitgevers voor het web
Uitgevers kunnen vragen om verwijdering van gebruikersgegevens die aan een bepaalde first-party-ID gekoppeld zijn. U kunt de API voor gegevensverwijdering gebruiken om een verzoek voor één ID in te dienen. Er zijn 2 opties. Optie 1 ondersteunt het IAB-framework voor verzoeken tot gegevensverwijdering.
Optie 1 (ondersteunt het IAB-framework voor verzoeken tot gegevensverwijdering)
dsrdelete.json wordt gehost.dsrdelete.json en host u het in de root van uw domein. Meer informatie over het bestand dsrdelete.json en de vereiste en optionele velden vindt u in de IAB-documentatie.Een verzoek indienen
Vereiste kenmerken
Neem de vereiste kenmerken voor uw verzoek tot gegevensverwijdering door in de volgende tabel. Ga naar het IAB-framework voor verzoeken tot gegevensverwijdering voor alle informatie over parameters, voorbeeldcode en andere vereisten.
| Kenmerk | Beschrijving | Voorbeeldwaarde |
|---|---|---|
| sub.identifierType | Type ID | sco_domain |
| sub.identifierValue | De ID waarvoor u verwijdering aanvraagt | 0000128ff97be809 |
| sub.identifierFormat | Indeling van gebruikers-ID | plaintext |
Optie 2 (beëindigd)
Als de uitgever verwijdering wil aanvragen voor gegevens die gekoppeld zijn aan de UID-component van een bepaalde __gpi, moet de uitgever een HTTPS-verzoek in de volgende vorm sturen:
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
Noteer 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 toegangsmethode die hierboven wordt beschreven.
- iu is de Ad Manager-netwerkcode van de uitgever.
- idtype geeft het type ID aan. Voor first-party-ID's van uitgevers voor het web moet de waarde sco zijn om een cookie met sitebereik aan te geven.
Voorbeeld:
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
Verwachte reactie
De HTTPS-statuscode 200, die aangeeft dat het verzoek in orde was, wordt geretourneerd als de 3 parameters aanwezig zijn met geldige waarden:
- De waarde 'id' is een hexadecimale waarde van 16 tekens.
- De waarde 'iu' is een geldige Ad Manager-netwerkcode.
- De waarde 'idtype' moet 'sco' zijn om aan te geven dat dit een first-party-ID van een uitgever voor het web is
De HTTPS-statuscode 400 wordt geretourneerd als het verzoek niet de juiste indeling heeft.
Gebruikersgegevens verwijderen die gekoppeld zijn aan IDFV in iOS 14 en hoger
Ad Manager-uitgevers kunnen verzoeken om verwijdering van gebruikersgegevens die aan een bepaalde ID voor leverancier (IDFV) gekoppeld zijn. U kunt de API voor gegevensverwijdering gebruiken om een verzoek voor één ID in te dienen. De API voor gegevensverwijdering is afgestemd op het IAB-framework voor verzoeken tot gegevensverwijdering.
Voordat u een verzoek voor gegevensverwijdering indient, moet u eerst uw accountmanager vragen om u toe te voegen aan ons register voor het IAB-framework. U moet een domein indienen waarop uw bestand dsrdelete.json wordt gehost.
Nadat uw domein bij Google is geregistreerd, maakt u het bestand dsrdelete.json en host u het in de root van uw domein. Meer informatie over het bestand dsrdelete.json en de vereiste en optionele velden vindt u in de documentatie van het IAB.
Een verzoek indienen om IDFV-gegevens te verwijderen
Als u verwijdering van IDFV-gegevens wilt aanvragen, start u het verzoek via de volgende URL:
Vereiste kenmerken
Neem de vereiste kenmerken voor uw verzoek tot verwijdering van IDFV-gegevens door in de volgende tabel. Ga naar het IAB-framework voor verzoeken tot gegevensverwijdering voor alle informatie over parameters, voorbeeldcode en andere vereisten.
| Kenmerk | Beschrijving |
Voorbeeldwaarde |
|---|---|---|
| sub.identifierType | Type ID | ifv |
| sub.identifierValue | De ID waarvoor u verwijdering aanvraagt | 82e812aa-1972-49ad-aad8-6092387e1275 |
| sub.identifierFormat | Indeling van gebruikers-ID | plaintext |