웹용 게시자 퍼스트 파티 ID에 액세스하고 연결된 광고 타겟팅 데이터를 삭제할 수 있습니다.
웹에서 게시자 퍼스트 파티 ID에 액세스하기
웹의 게시자 퍼스트 파티 ID는 JavaScript에서 직접 액세스할 수 있으며, 게시자의 도메인에서 퍼스트 파티 쿠기를 설정할 수 있습니다. Google 게시자 및 파트너가 외부에서 사용할 수 있는 ID는 __gpi 쿠키 내에 있습니다. 다른 쿠키(__gads)는 Google 게시자 또는 파트너가 외부에서 사용하기 위한 것이 아니며 맞춤설정 용도로는 사용할 수 없습니다.
__gpi 쿠키의 값은 다음과 같은 형식입니다.
UID=<unique_user_ID>:T=<creation_unix_timestamp_in_seconds>:RT=<refresh_unix_timestamp_in_seconds>:S=<google_generated_authenticity_signature>
__gpi 값의 예:
UID=00000a1b2c3def45:T=1709171636:RT=1709171636:S=ALNI_Ma_CBr2wmXJhLdNKG9z4FWhjVVIog
ID 값(UID)과 타임스탬프(T)는 Google 게시자와 파트너가 외부에서 사용할 수 있는 유일한 구성요소입니다.
- UID는 현재 16자리 16진수 문자열이지만 길이가 안정적인 것으로 간주해서는 안 되며 시간이 지남에 따라 변경될 수 있습니다.
- T는 ID 생성의 Unix 타임스탬프를 나타내는 10진 정수입니다.
나머지 두 구성요소는 내부 구현 세부정보로, 변경될 수 있기 때문에 이를 의존해서는 안 됩니다.
현재 __gpi 및 __gads 쿠키는 브라우저 제한으로 인해 쿠키가 더 일찍 완전히 삭제되지 않는 한(예: JavaScript 설정 쿠키에 대한 Safari ITP 제한) 최대 수명이 둘 다 13개월입니다. 쿠키가 삭제되면 허용되는 경우 Google에서 새 값으로 쿠키를 다시 채우려고 시도합니다.
쿠키 저장소에는 __gpi 및 __gads 외에도 사용자 거부 쿠키 __gpi_opt_out이 포함될 수 있습니다. 값이 1이면 사용자가 Google의 광고 옵션 관리를 통해 해당 도메인에서 Google Ads에 대한 맞춤설정 사용을 사용 중지한 것입니다.
이러한 쿠키에 액세스하기 전에 해당 쿠키의 사용이 관련 관할권의 모든 개인 정보 보호, 데이터 보안, 데이터 보호 관련 법규, 지침, 규제 및 규칙을 준수하는지 확인해야 합니다.
ID를 가져오는 JavaScript 메서드의 예시 보기
/**
* 게시자 퍼스트 파티 ID 및 타임스탬프를 반환합니다.
* @returns {{UID: string|undefined, T: string|undefined}} UID 및
* 타임스탬프 문자열(있는 경우)을 포함하는 객체입니다.
*/
function getPublisherFirstPartyIdAndCreationTimestamp() {
// 쿠키 키 + 값 가져오기
const gpiCookie = document.cookie.split('; ').find(cookie => cookie.startsWith('__gpi='));
if (!gpiCookie) {
return {UID: undefined, T: undefined};
}
// 파싱에 정규 표현식 사용
const regex_match = gpiCookie.match(/UID=([^:]+):T=([^:]+)/);
if (!regex_match) {
return {UID: undefined, T: undefined};
}
// 추출된 값 반환
return {
UID: regex_match[1],
T: regex_match[2]
};
}
사용 예시 보기
try {
const parsedValues = getPublisherFirstPartyIdAndCreationTimestamp();
console.log(parsedValues);
console.log(parsedValues['UID']); // ID 값
console.log(parsedValues['T']); // 생성 타임스탬프
} catch (error) {
console.error(error.message);
}웹에서 게시자 퍼스트 파티 ID와 연결된 사용자 데이터 삭제
게시자는 주어진 __gpi와 연결된 사용자 데이터를 Google의 내부 광고 타겟팅 저장소 시스템에서 삭제해 달라고 요청할 수 있습니다.
특정 __gpi의 UID 구성요소와 연결된 데이터의 삭제를 요청하려면 게시자는 다음 형식의 HTTP 요청을 전송해야 합니다.
https://securepubads.g.doubleclick.net/user_data_deletion?id={id_value}&iu={network_code}&idtype=sco
양식의 다음 값을 참고하세요.
- id는 ID 값입니다. 16자리 16진수 숫자여야 하며 위에서 설명한 액세스 메서드에 의해 검색된 UID 구성요소입니다.
- iu는 게시자의 Ad Manager 네트워크 코드입니다.
- idtype은 ID 유형을 식별합니다. 웹의 게시자 퍼스트 파티 ID의 경우 사이트 범위 쿠키를 나타내기 위해 값이 'sco'여야 합니다.
예시:
https://securepubads.g.doubleclick.net/user_data_deletion?id=123456789012345&iu=12345&idtype=sco
예상 응답
세 개의 매개변수에 유효한 값이 있는 경우 요청이 정상적으로 완료되었음을 나타내는 HTTP 응답 상태 코드 '200'이 반환됩니다.
- 'id' 값은 16자리 16진수 값입니다.
- 'iu' 값은 유효한 Ad Manager 네트워크 코드입니다.
- 웹의 게시자 퍼스트 파티 ID임을 나타내기 위해 'idtype' 값은 'sco'로 지정해야 합니다.
요청 형식이 올바르지 않으면 HTTP 응답 상태 코드 '400'이 반환됩니다.
