Sie können auf die eigenen Publisher-Kennungen für das Web zugreifen und die zugehörigen Daten zum Anzeigen-Targeting löschen.
Auf eigene Publisher-Kennungen im Web zugreifen
Auf die eigenen Publisher-Kennungen im Web kann direkt über eigene Cookies zugegriffen werden, die mit JavaScript in der Domain des Publishers gesetzt werden. Die Kennung (ID), die für die externe Nutzung durch unsere Publisher und Partner bestimmt ist, befindet sich im Cookie __gpi. Das andere Cookie (__gads) ist nicht für die externe Nutzung durch unsere Publisher oder Partner vorgesehen und darf nicht für Personalisierungszwecke verwendet werden.
Der Wert des __gpi-Cookies hat folgendes Format:
UID=<unique_user_ID>:T=<creation_unix_timestamp_in_seconds>:RT=<refresh_unix_timestamp_in_seconds>:S=<google_generated_authenticity_signature>
Beispiel für einen __gpi-Wert:
UID=00000a1b2c3def45:T=1709171636:RT=1709171636:S=ALNI_Ma_CBr2wmXJhLdNKG9z4FWhjVVIog
Der Wert der Kennung (UID) und der Zeitstempel (T) sind die einzigen Komponenten, die für die externe Nutzung durch unsere Publisher und Partner vorgesehen sind:
- Die UID ist derzeit ein Hexadezimalstring mit 16 Zeichen. Die Länge sollte jedoch nicht als feststehend betrachtet werden, sondern kann sich im Laufe der Zeit ändern.
- T ist eine Ganzzahl im Dezimalformat, die den UNIX-Zeitstempel der Erstellung der Kennung darstellt.
Die anderen beiden Komponenten sind interne Implementierungsdetails, die sich ändern können und auf die Sie sich nicht verlassen sollten.
Die Cookies __gpi und __gads haben derzeit eine maximale Gültigkeitsdauer von 13 Monaten, es sei denn, sie werden aufgrund von Browsereinschränkungen früher gelöscht (z. B. Safari-ITP-Einschränkungen für von JavaScript gesetzte Cookies). Wenn das Cookie gelöscht wird, versucht Google, neue Werte einzufügen, sofern zulässig.
Neben __gpi und __gads kann der Cookie-Bereich auch das Widerrufs-Cookie __gpi_opt_out enthalten. Wenn dessen Wert „1“ lautet, hat der Nutzer die Verwendung der Personalisierung für Google Ads für diese Domain über die Google-Einstellungen für Anzeigenoptionen deaktiviert.
Bevor Sie auf diese Cookies zugreifen, sollten Sie dafür sorgen, dass Ihre Nutzung der Cookies allen Gesetzen, Richtlinien, Vorschriften und Regeln zum Datenschutz und zur Datensicherheit in allen zuständigen Gerichtsbarkeiten entspricht.
Beispiel für eine JavaScript-Methode zum Abrufen der eigenen Publisher-Kennung (ID)
/**
* Returns the Publisher First Party ID and Timestamp.
* @returns {{UID: string|undefined, T: string|undefined}} An object
* containing the UID and Timestamp strings, if available.
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// Get the cookie key+value
const gpiCookie = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// Use a regular expression for parsing
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// Return the extracted values
return {
UID: regex_match[1],
T: regex_match[2]
};
}
Verwendungsbeispiel
try {
const parsedValues = getPublisherFirstPartyIdAndCreationTimestamp();
console.log(parsedValues);
console.log(parsedValues['UID']); // The value of the ID
console.log(parsedValues['T']); // The creation timestamp
} catch (error) {
console.error(error.message);
}Nutzerdaten löschen, die mit eigenen Publisher-IDs im Web verknüpft sind
Publisher können das Löschen von Nutzerdaten anfragen, die mit bestimmten eigenen Kennungen verknüpft sind. Mit der API zum Löschen von Daten können Sie eine Anfrage für einzelne Kennungen senden. Es gibt zwei Optionen. Option 1 unterstützt das IAB-Framework für Datenlöschanfragen.
Option 1 (unterstützt das IAB-Framework für Datenlöschanfragen)
dsrdelete.json gehostet wird.dsrdelete.json erstellen und im Stammverzeichnis Ihrer Domain hosten. Weitere Informationen zur Datei dsrdelete.json sowie zu den erforderlichen und optionalen Feldern finden Sie in der IAB-Dokumentation.Löschanfrage stellen
Erforderliche Attribute
In der nachfolgenden Tabelle finden Sie die erforderlichen Attribute für eine Datenlöschanfrage. Ausführliche Informationen zu Parametern, Beispielcode sowie weitere Anforderungen finden Sie auf dieser Seite des IAB-Frameworks für Datenlöschanfragen.
| Attribut | Beschreibung | Beispielwert |
|---|---|---|
| sub.identifierType | Art der Kennung | sco_domain |
| sub.identifierValue | Die Kennung, für die das Löschen angefragt wird | 0000128ff97be809 |
| sub.identifierFormat | Format der Nutzer-ID | Nur Text |
Option 2 (wird nicht mehr unterstützt)
Wenn ein Publisher das Löschen von Daten anfragen möchte, die mit der UID-Komponente des jeweiligen __gpi-Cookies verknüpft sind, muss er eine HTTPS-Anfrage in folgendem Format senden:
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
Beachten Sie dabei die folgenden Werte:
- id ist der Wert der Kennung (ID). Dies ist die UID-Komponente, die mit der oben beschriebenen Zugriffsmethode abgerufen wird; sie sollte eine 16-stellige Hexadezimalzahl sein.
- iu ist der Ad Manager-Netzwerkcode des Publishers.
- idtype gibt den Typ der Kennung (ID) an. Für eigene Publisher-Kennungen im Web sollte der Wert „sco“ lauten, womit ein Cookie auf Website-Ebene angegeben wird.
Beispiel:
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
Erwartete Antwort
Der HTTPS-Antwortstatuscode „200“, der angibt, dass die Anfrage in Ordnung war, wird zurückgegeben, wenn die drei genannten Parameter vorhanden sind und gültige Werte aufweisen:
- Der Wert „id“ ist ein Hexadezimalwert mit 16 Zeichen.
- Der Wert „iu“ ist ein gültiger Ad Manager-Netzwerkcode.
- Der Wert „idtype“ muss „sco“ sein, um anzugeben, dass es sich um eine eigene Publisher-Kennung im Web handelt.
Wenn die Anfrage nicht richtig formatiert ist, wird der HTTPS-Antwortstatuscode „400“ zurückgegeben.
Mit IDFV verknüpfte Nutzerdaten unter iOS 14 und höher löschen
Ad Manager-Publisher können das Löschen von mit IDFV (Identifier for Vendor) verknüpften Nutzerdaten anfragen. Mit der API zum Löschen von Daten können Sie eine Anfrage für einzelne Kennungen senden. Die API zum Löschen von Daten entspricht dem IAB-Framework für Datenlöschanfragen.
Vor dem Stellen einer Datenlöschanfrage müssen Sie sich zuerst an Ihren Account Manager wenden, um in das IAB-Framework-Register aufgenommen zu werden. Sie müssen eine Domain einreichen, auf der Ihre Datei dsrdelete.json gehostet wird.
Sobald Ihre Domain bei Google registriert ist, sollten Sie die Datei dsrdelete.json erstellen und im Stammverzeichnis Ihrer Domain hosten. Weitere Informationen zur Datei dsrdelete.json sowie zu den erforderlichen und optionalen Feldern finden Sie in der IAB-Dokumentation.
Anfrage zum Löschen von IDFV-Daten senden
Um das Löschen von IDFV-Daten anzufordern, müssen Sie die Anfrage über die folgende URL initiieren:
Erforderliche Attribute
In der folgenden Tabelle finden Sie die erforderlichen Attribute für eine Anfrage zum Löschen von IDFV-Daten. Ausführliche Informationen zu Parametern, Beispielcode sowie weitere Anforderungen finden Sie auf dieser Seite des IAB-Frameworks für Datenlöschanfragen.
| Attribut | Beschreibung |
Beispielwert |
|---|---|---|
| sub.identifierType | Art der Kennung | ifv |
| sub.identifierValue | Die Kennung, für die das Löschen angefragt wird | 82e812aa-1972-49ad-aad8-6092387e1275 |
| sub.identifierFormat | Format der Nutzer-ID | Nur Text |