Můžete získat přístup k ID první strany majitele obsahu pro web a smazat související data cílení reklam.
Přístup k ID první strany majitele obsahu na webu
K ID první strany majitele obsahu na webu lze získat přístup přímo ze souborů cookie první strany nastavených pomocí JavaScriptu v doméně majitele obsahu. ID určené k externímu použití našimi majiteli obsahu a partnery se nachází v souboru cookie __gpi. Druhý soubor cookie (s názvem __gads) není určen k externímu použití ze strany majitelů obsahu a partnerů a není ho povoleno používat k personalizaci.
Hodnota souboru cookie __gpi má následující formát:
UID=<unique_user_ID>:T=<creation_unix_timestamp_in_seconds>:RT=<refresh_unix_timestamp_in_seconds>:S=<google_generated_authenticity_signature>
Příklad hodnoty __gpi:
UID=00000a1b2c3def45:T=1709171636:RT=1709171636:S=ALNI_Ma_CBr2wmXJhLdNKG9z4FWhjVVIog
K externímu použití ze strany majitelů obsahu a partnerů jsou určeny pouze součásti UID (hodnota ID) a T (časové razítko):
- UID je v současné době řetězec představující 16místné hexadecimální číslo. Délku však nelze považovat za stabilní. Může se v průběhu času měnit.
- T je celé dekadické číslo, které představuje unixové časové razítko vytvoření ID.
Dvě zbývající součásti jsou interní podrobnosti o implementaci, které se mohou měnit a na které se nelze spoléhat.
Soubory cookie __gpi a __gpi mají v současné době maximální dobu platnosti 13 měsíců, pokud k jejich smazání nedojde kvůli omezení prohlížeče dříve (například omezení ITP v prohlížeči Safari pro soubory cookie nastavené v JavaScriptu). Pokud je soubor cookie vymazán, Google se ho pokusí znovu vyplnit novými hodnotami (pokud je to povoleno).
Kromě souborů cookie __gpi a __gads může úložiště souborů cookie obsahovat také soubor pro odhlášení uživatele __gpi_opt_out. Pokud má hodnotu 1, uživatel v dané doméně používání personalizace pro Google Ads zakázal (prostřednictvím ovládacího prvku Možnosti reklamy od Googlu).
Než si tyto soubory cookie přečtete, musíte nejdříve zkontrolovat, zda je vaše použití v souladu se všemi zákony, směrnicemi, nařízeními a pravidly o ochraně a zabezpečení dat v příslušné jurisdikci.
Příklad metody JavaScriptu k načtení ID
/**
* Vrátí ID první strany majitele obsahu a časové razítko.
* @returns {{UID: string|undefined, T: string|undefined}} Objekt,
* který obsahuje řetězce s ID uživatele a časovým razítkem (pokud jsou k dispozici).
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// Získání klíče+hodnoty souboru cookie
const gpiCookie = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// Analýza pomocí regulárního výrazu
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// Vrácení extrahovaných hodnot
return {
UID: regex_match[1],
T: regex_match[2]
};
}
Příklad použití
try {
const parsedValues = getPublisherFirstPartyIdAndCreationTimestamp();
console.log(parsedValues);
console.log(parsedValues['UID']); // Hodnota ID
console.log(parsedValues['T']); // Časové razítko vytvoření
} catch (error) {
console.error(error.message);
}Smazání údajů o uživatelích přidružených k ID první strany majitele obsahu na webu
Majitelé obsahu mohou požádat o smazání údajů o uživatelích spojených s daným __gpi z interních úložných systémů společnosti Google pro cílení reklam.
Pokud chce majitel obsahu požádat o smazání dat přidružených k části UID konkrétního souboru cookie __gpi, musí odeslat požadavek HTTP v následujícím formátu:
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
Ve formuláři je potřeba odeslat tyto hodnoty:
- id je hodnota ID. Mělo by se jednat o 16místné hexadecimální číslo, což je součást UID načtená výše popsanou metodou.
- iu je kód sítě Ad Manager majitele obsahu.
- idtype určuje typ identifikátoru. U ID první strany majitele obsahu na webu by hodnota měla být „sco“, což označuje soubor cookie na úrovni webu.
Příklad:
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
Očekávaná odpověď
Pokud jsou přítomny všechny tři parametry a mají platné hodnoty, bude vrácen stavový kód odpovědi HTTP 200 na znamení, že byl požadavek v pořádku:
- Hodnota „id“ je 16místné hexadecimální číslo.
- Hodnota „iu“ je platný kód sítě Ad Manager.
- Hodnota „idtype“ by měla být „sco“, což znamená, že se jedná o ID první strany majitele obsahu na webu.
Pokud požadavek nemá správný formát, bude vrácen stavový kód odpovědi HTTP 400.
