쿠키 매칭은 웹사이트를 둘러본 사용자의 ID와 같은 쿠키를 해당 입찰자별 Google 사용자 ID와 일치시키고, 보다 효과적으로 입찰을 선택하는 데 도움이 되는 사용자 목록을 구성할 수 있는 기능입니다. 이 가이드에서는 쿠키 매칭에 사용되는 개념과 다양한 쿠키 매칭 워크플로, 특정 사용 사례에 따라 워크플로에 있을 수 있는 변형을 설명합니다.
개념
쿠키 매칭이란 무엇인가요?
도메인 소유자는 일반적으로 사이트를 탐색하는 사용자의 쿠키 콘텐츠를 설정하며, 이 쿠키는 해당 도메인 내 사용자를 식별하는 데 사용됩니다. 두 도메인 소유자가 이 데이터를 교환하는 데 동의하더라도 인터넷 브라우저의 보안 모델은 한 도메인이 다른 도메인에서 설정한 쿠키를 읽지 못하도록 제한합니다.
디지털 광고의 맥락에서 Google은 doubleclick.net 도메인에 속하는 쿠키로 사용자를 식별하며, 실시간 입찰에 참여하는 입찰자는 광고를 게재하려는 일부 사용자를 식별하는 자체 도메인을 가질 수 있습니다. 쿠키 매칭을 사용하면 입찰자가 자신의 쿠키를 Google 쿠키와 일치시킬 수 있으므로 입찰 요청에 전송된 노출이 타겟팅되는 사용자 중 하나와 연결되어 있는지 확인할 수 있습니다. 입찰자는 자체 쿠키 데이터 또는 입찰 요청의 doubleclick.net 쿠키의 암호화된 형식인 입찰자별 Google 사용자 ID를 수신합니다.
이 가이드에 설명된 쿠키 일치 서비스는 입찰자의 쿠키와 Google 사용자 ID 간의 연결을 생성하고 유지 관리하는 것을 용이하게 하며 사용자 목록을 채울 수 있도록 합니다.
데이터 이동 색인
일치 테이블은 한 도메인의 ID 또는 기타 데이터를 다른 도메인에 매핑하는 데 사용할 수 있습니다. 입찰자는 쿠키 데이터 이동 색인을 사용하여 특정 사용자의 쿠키를 사용자의 Google 사용자 ID에 매핑하여 자체 데이터 이동 색인을 채우거나 Google에서 호스팅하는 데이터 이동 색인을 채울 수 있습니다. 일치 테이블은 입찰자의 입찰자 애플리케이션이 노출이 표시되는 사용자의 쿠키 데이터에 액세스하는 데 필요합니다.
Google에서 호스팅하는 데이터 이동 색인
더 쉬운 유지보수, 지연 시간 개선, 특정 지역 사용자의 일치 데이터 액세스를 위해 Google에서 일치 테이블을 호스팅하도록 허용하는 것이 좋습니다. 이렇게 하면 지정된 사용자의 Google 사용자 ID에 매핑될 웹 보안 Base64로 인코딩된 문자열(이하 호스팅된 일치 데이터라고 함)을 지정할 수 있습니다. 일치가 설정되면 다음과 같은 방식으로 사용할 수 있습니다.
실시간 입찰: 사용자와 연결된 노출에 대한 후속 입찰 요청에서 Google은 Google 사용자 ID와 일치시킨 호스팅된 일치 데이터를 광고주에게 전송합니다. Google의 OpenRTB 구현에서
BidRequest.user.buyeruid는 이를 웹 안전 base64 인코딩 문자열로 지정합니다. 입찰 엔드포인트가 지원 중단된 Google RTB 프로토콜을 사용하도록 구성된 경우BidRequest.hosted_match_data필드를 통해 디코딩된 바이트로 수신됩니다.사용자 목록: 사용자 목록은 Google 사용자 ID 또는 호스팅된 일치 데이터로 채울 수 있습니다.
- 사전 타겟팅: 호스팅된 일치 타겟팅 데이터가 포함된 입찰 요청만 수신되도록 사전 타겟팅을 구성할 수 있습니다. 쿠키 공간 외부의 사용자에게 관련성이 낮은 노출을 제거하는 데 사용할 수 있습니다.
사용자 목록
사용자 목록은 실시간 입찰 API를 사용하여 만들고 관리할 수 있습니다. 생성된 후에는 아래에 설명된 쿠키 일치 워크플로 또는 일괄 업로더 서비스를 통해 이러한 목록을 채울 수 있습니다.
시작하기
쿠키 매칭을 시작하려면 기술계정 관리자에게 문의해야 합니다. 기술계정 관리자는 특정 워크플로를 사용 설정하고 다음을 구성하는 데 도움을 줄 수 있습니다.
- 쿠키 일치 네트워크 ID (NID): 쿠키 일치 및 기타 관련 작업을 위해 입찰자 계정을 식별하는 문자열 ID입니다.
- 쿠키 일치 URL: 쿠키 일치 워크플로의 일부로 새로 추가되는 요청을 수락하고 처리하는 엔드포인트의 기본 URL입니다. 입찰자는 이 URL에 매크로를 삽입하여 쿠키 일치 워크플로에서 전달된 매개변수의 순서를 제어할 수 있습니다.
- 일치 태그: 입찰자가 시작한 쿠키 매칭 워크플로를 위해 사용자의 브라우저에 배치해야 하는 태그입니다. 이는 광고와 함께 게재하거나 광고 외부의 웹 서비스에 배치할 수 있습니다.
- 쿠키 일치 보고서 URL (선택사항): 단방향 쿠키 일치 워크플로에서 쿠키 일치가 실패하는 경우에 HTTP 302 리디렉션을 통해 오류 세부정보를 수신할 엔드포인트를 지정하기 위해 제공할 수 있는 선택사항 URL입니다. 기본적으로 응답은 쿠키 일치 작업에 오류가 있는 경우에만 이 URL로 전송되지만 입찰자가 항상 리디렉션을 전송하도록 요청할 수 있습니다.
- 쿠키 매칭 지원 URL: 쿠키 매칭 지원 워크플로를 구현하는 거래소의 경우 수신되는 요청에 응답하기 위한 엔드포인트의 기본 URL입니다.
- 쿠키 매칭 지원 할당량: 쿠키 매칭 지원 워크플로를 구현하는 거래소의 경우 쿠키 매칭 URL이 매초 수신할 수 있는 최대 요청 수입니다. 이는 CMA 요청으로 인해 거래소 서버에 과부하가 발생하지 않도록 하기 위한 조치입니다.
쿠키 매칭 매크로
지원되는 모든 쿠키 매칭 워크플로에서 입찰자의 쿠키 매칭 URL에는 일반적으로 미보장 순서로 추가된 매개변수가 있습니다. 일관된 매개변수 순서가 필요한 통합이 있는 입찰자는 쿠키 매칭 URL에 매크로를 배치하여 게재위치를 보장할 수 있습니다.
지원되는 매크로
입찰자는 선택적으로 쿠키 매칭 URL을 구성하여 %%GOOGLE_<PARAM_NAME>%% 또는 %%GOOGLE_<PARAM_NAME>_PAIR%% 형식의 매크로를 하나 이상 포함할 수 있습니다. 지원되는 매크로와 확장된 값은 다음과 같습니다.
| Macro | 확장 값 |
|---|---|
| GOOGLE_GID | GOOGLE_USER_ID |
| GOOGLE_GID_PAIR | &google_gid=GOOGLE_USER_ID |
| GOOGLE_CVER | COOKIE_VERSION_NUMBER |
| GOOGLE_CVER_PAIR | &cver=COOKIE_VERSION_NUMBER |
| GOOGLE_ERROR | ERROR_ID |
| GOOGLE_ERROR_PAIR | &google_error=ERROR_ID |
| GOOGLE_PUSH | PIXEL_MATCH_DATA |
| GOOGLE_PUSH_PAIR | &google_push=PIXEL_MATCH_DATA |
| GOOGLE_ALL_PARAMS | google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&google_error=ERROR_ID |
매크로 예시
입찰자가 https://user.bidder.com.cookies에 호스팅된 엔드포인트와 쿠키 일치 통합을 사용하고 있으며, 구현에는 픽셀 일치 매개변수 외에도 다음 순서(google_push, google_gid, google_cver, google_error)로 미리 설정된 입찰자 정의 매개변수가 필요합니다. 입찰자는 쿠키 일치 URL을 다음과 같이 설정하여 이를 실행할 수 있습니다.
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
나중에 Google에서 이 입찰자에게 일치 요청을 보내면 다음과 같이 확장됩니다.
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
쿠키 매칭 서비스 워크플로
Google의 쿠키 일치 서비스는 현재 아래에 설명된 다양한 사용 사례에 관한 세 가지 워크플로를 지원합니다.
입찰자 시작: 양방향 쿠키 매칭
양방향 쿠키 매칭은 입찰자가 시작한 워크플로를 의미하며, 여기서 입찰자는 사용자의 브라우저에 일치 태그를 배치하여 Google로 연결합니다. 이 워크플로를 사용하면 Google과 입찰자가 모두 일치 테이블을 채울 수 있습니다. 다음은 이 워크플로의 간단한 예입니다.
1단계: 일치 태그 배치
이 흐름을 시작하려면 입찰자가 일치 태그를 배치하여 사용자의 브라우저에서 렌더링되도록 해야 합니다. 입찰자에게 Google 사용자 ID만 반환하는 간단한 일치 태그의 구조는 다음과 같습니다.
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
일치 태그에 포함하여 다양한 사용 사례를 처리할 수 있는 추가 매개변수가 있습니다. 이러한 매개변수에 대해 자세히 알아보려면 타겟팅 태그 URL 매개변수를 참고하세요.
2단계: Google에서 일치 데이터를 포함한 리디렉션으로 응답
일치 태그를 사용하면 Google의 쿠키 일치 서비스가 사용자의 브라우저에서 요청을 수신하여 입찰자의 쿠키 매칭 URL로 HTTP 302 리디렉션을 실행합니다. 리디렉션에는 URL에 Google 사용자 ID와 버전 번호를 지정하는 쿼리 매개변수가 포함되며 입찰자는 요청 헤더에 포함된 쿠키도 수신합니다. 실제로 https://ad.network.com/pixel로 지정된 쿠키 일치 URL의 경우 위와 같이 단순 일치 태그의 리디렉션 URL은 다음과 같이 표시될 수 있습니다.
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
google_gid 매개변수를 통해 전달된 Google 사용자 ID는 패딩되지 않은 웹 보안 base64로 인코딩된 문자열입니다. 데이터 이동 색인을 호스팅하기로 선택한 입찰자는 쿠키 일치 서비스에서 반환한
정확한 문자열을 저장하는 것이 좋습니다. 후속 입찰 요청에서 이 값은 OpenRTB의 BidRequest.user.id 또는 지원 중단된 Google RTB 프로토콜의 BidRequest.google_user_id를 통해 지정된 값에 해당합니다.
google_cver에 지정된 버전은 Google 사용자 ID의 숫자 버전 번호를 나타냅니다. 특정 사용자의 Google 사용자 ID는 가끔 변경되며 이후에 증가합니다.
Google에서 일치 요청을 처리하는 중에 오류가 발생하면 대신 google_error 매개변수가 지정됩니다.
3단계: 입찰자가 리디렉션을 처리하고 픽셀로 응답
입찰자는 첫 번째 단계에서 지정한 매개변수와 Google이 두 번째 단계에서 제공한 매개변수를 포함하여 쿠키 일치 URL로 리디렉션됩니다. 또한 사용자는 HTTP 헤더에서도 쿠키를 수신합니다. 작업이 성공하면 자체 일치 테이블을 호스팅하는 입찰자가 자신의 쿠키를 응답에 포함된 Google 사용자 ID와 일치시킬 수 있습니다. 입찰자는 쿠키 일치 서비스에서 반환한 정확한 문자열을 저장하는 것이 좋습니다.
작업에 실패하면 입찰자가 리디렉션에서 google_error 매개변수를 수신합니다. 발생한 특정 오류를 식별하는 다양한 오류 상태에 해당하는 숫자 값입니다. 여기에서 가능한 오류 값에 대해 자세히 알아보세요.
오류가 발생하면 새 일치 태그를 배치하여 해당 사용자를 다시 일치시킬 수 있습니다.
입찰자는 항상 1x1의 보이지 않는 픽셀 이미지를 게재하여 응답하거나 HTTP 204 콘텐츠 없음 응답을 반환해야 합니다.
쿠키 매칭 워크플로 다이어그램
이 워크플로는 아래 다이어그램에 나와 있습니다. 요청과 응답은 화살표로 표시되고, 함께 제공되는 데이터 항목은 괄호 안에 나열되어 있습니다.
일치 태그 URL 매개변수
| 매개변수 | 설명 |
|---|---|
google_nid |
입찰자 계정의 네트워크 ID (NID)입니다. 이 ID는 Bidders 리소스를 통해 가져올 수 있습니다. |
google_cm |
Google의 쿠키 매칭 서비스에 쿠키 매칭을 실행해야 한다고 나타냅니다. 매개변수 값은 무시되며 생략할 수 있습니다. |
google_sc |
이 매개변수는 지원 중단되었습니다. 쿠키가 없는 경우 사용자의 Google 쿠키를 설정합니다. 매개변수 값은 무시되며 생략할 수 있습니다. 쿠키가 없는 경우 매개변수를 생략하면 오류가 발생합니다. |
google_no_sc |
이 매개변수는 지원 중단되었습니다. 이는 Google의 쿠키 일치 서비스에 사용자의 쿠키가 없는 경우 쿠키를 설정해서는 안 된다고 나타냅니다. 매개변수 값은 무시되며 생략할 수 있습니다. |
google_hm |
입찰자가 Google에서 호스팅하는 일치 테이블에 저장하려는 데이터입니다.
값은 웹 보안 base64 인코딩 문자열 (선택사항 패딩)입니다. 원시 데이터는 40바이트 이하여야 합니다. 예를 들면 |
google_redir |
Google에 HTTP 302 리디렉션을 이 일치 태그의 인코딩된 URL로 전송하도록 하려는 경우 입찰자가 지정할 수 있는 URL 인코딩 문자열입니다. 이렇게 하면 Google이 파트너에 대한 체이닝된 호출의 맨 앞에 배치될 수 있습니다. google_hm 없이 지정하거나 google_cm를 사용하면 오류가 발생합니다. |
google_ula |
기존 사용자 목록에 사용자를 추가하는 데 사용되는 문자열입니다. 값의 예상 형식은 userlistid[,timestamp]입니다.
이 URL 매개변수를 반복하여 사용자를 여러 목록에 추가할 수 있습니다. |
gdpr |
요청에 데이터 사용에 대한 GDPR 제한이 적용됨을 나타냅니다. 자세한 내용은 아래의
EU 사용자 동의 요구사항 또는
승인된 구매자 IAB TCF v2.0 문서의 쿠키 매칭 자격요건에 미치는 영향을 참고하세요.
예: |
gdpr_consent |
최종 사용자 동의를 나타내는 TC 문자열입니다. 자세한 내용은 아래의 EU 사용자 동의 요구사항 또는 Authorized Buyers IAB TCF v2.0 문서의 TC 문자열은 어떻게 전달되나요?를 참고하세요. |
process_consent |
입찰자가
Google의 EU 사용자 동의 정책에 명시된 데이터 사용에 대한 최종 사용자 동의를 얻었음을 나타냅니다.
요청에 EU 사용자 동의 정책이 적용되지 않거나 요청에서 사용할 수 있는 다른 동의 매개변수( 예: |
입찰자는 위의 매개변수 외에도 자체 매개변수를 지정할 수 있으며, 이 매개변수는 리디렉션 URL에 매개변수로 추가됩니다. google_ 접두사로 이름이 지정된 입찰자 정의 매개변수는 향후 개발을 위해 Google에서 예약한 것이므로 무시되며 매개변수 순서가 보장되지 않습니다. 입찰자 정의 매개변수가 포함된 일치 태그는 다음과 같이 표시될 수 있습니다.
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
리디렉션 URL 매개변수
리디렉션 URL은 입찰자의 계정에 구성된 기본 쿠키 일치 URL(google_ 및 입찰자가 정의한 매개변수 포함, 일치 태그에 지정된 매개변수에 따라 다름)에서 생성됩니다. 다음 google_ 응답 매개변수가 정의됩니다.
| 매개변수 | 설명 |
|---|---|
google_gid |
Google 사용자 ID 요청에 google_cm가 지정되었고 요청이 성공한 경우에 설정됩니다. |
google_cver |
쿠키 버전입니다. 요청에 google_cm가 지정되었고 요청이 성공한 경우 설정합니다. |
google_error |
전체 요청 오류를 나타내는 정수 값입니다. 수신되면 작업이 실행되지 않았음을 나타내며 다른
|
google_hm |
Google에서 호스팅하는 일치 테이블에 쓰려고 시도했다가 실패한 경우에만 표시됩니다. 이 경우 값은 다음 상태 코드 중 하나가 됩니다.
|
google_ula |
사용자 목록 추가 작업의 상태입니다. 요청에 여러 개의 예:
|
쿠키 매칭 워크플로 예시 시나리오
다음 시나리오에서는 웹페이지를 탐색하는 일반적인 사용자에게 쿠키 매칭이 어떻게 표시되는지 설명합니다.
시나리오 1: 사용자가 쿠키를 삭제하고 사이트를 탐색함
사용자가 모든 쿠키의 캐시를 삭제합니다. 그런 다음 ExampleNews.com의 홈페이지를 방문합니다.
그 과정은 다음과 같습니다.
- ExampleNews.com은 Google (Ad Manager)의 광고를 렌더링하고 호출합니다.
- 광고 단위는 동적 할당이 가능하므로 Google은 실시간 입찰 서비스를 통해 FinestDSP 및 다른 입찰자에게 입찰 요청을 전송합니다.
- FinestDSP의 입찰자 애플리케이션은 입찰 요청을 수신 및 처리한 후 입찰 응답을 전송합니다.
- Google은 일치 태그 (픽셀)가 있는 광고를 지정하는 FinestDSP의 응답을 비롯하여 입찰자로부터 입찰 응답을 수신합니다.
- FinestDSP가 입찰에서 낙찰을 받습니다. Google에서 FinestDSP의 광고 및 검색 태그를 Jane에게 게재합니다.
- 일치 태그는 Google의 쿠키 일치 서비스를 호출하여
google_nid및google_cm매개변수를 지정합니다. - 쿠키 매칭 서비스는 에이미의 Google 쿠키를 읽고 에이미의 브라우저에
google_gid및google_cver매개변수가 설정된 FinestDSP의 쿠키 매칭 URL로 리디렉션합니다. - 에이미의 브라우저가 FinestDSP의 쿠키 일치 URL로 리디렉션을 로드합니다.
- FinestDSP의 쿠키 매칭 엔드포인트는 Google에서 설정한 URL 매개변수와 HTTP 헤더의 제인 쿠키가 포함된 리디렉션 요청을 처리합니다. 이제 FinestDSP는 일치 테이블에 쿠키와
google_gid의 매핑을 저장할 수 있습니다. - FinestDSP는 보이지 않는 1x1픽셀로 리디렉션에 응답합니다.
시나리오 2: 기존 매핑이 있는 사용자
시나리오 1의 1주일 후, 제인은 ExampleNews.com을 다시 방문합니다. 이제 컴퓨터에 입찰자 쿠키와 Ad Manager 쿠키가 모두 있으므로 다음과 같이 일치가 작동합니다.
- 웹페이지가 렌더링되면 Google (Ad Manager)에서 페이지에 렌더링될 광고를 요청합니다.
- 광고 입찰 중에 Google은 FinestDSP를 비롯한 관련 입찰자에게 입찰 요청을 전송합니다.
- FinestDSP는
google_gid과 같은 신호를 포함하여 입찰 요청을 수신합니다. - FinestDSP는 일치 테이블에서
google_gid를 조회하고 1주일 전에 생성된 에이미와 연결된 쿠키를 찾습니다(시나리오 1). - 쿠키와 연결된 정보를 기반으로 FinestDSP의 입찰 로직은 노출에 입찰하고 낙찰됩니다.
- 에이전트가 보유한 정보를 기반으로 에이전트의 관심분야에 맞는 광고가 표시될 수 있습니다.
입찰자 시작: 단방향 쿠키 매칭
단방향 쿠키 매칭은 Google만 일치 테이블을 호스팅하고 채우도록 변경되었다는 점을 제외하고는 양방향 워크플로와 유사합니다. 입찰자가 자체 일치 테이블에 Google 사용자 ID를 호스팅할 수 없는 경우에 사용할 수 있습니다. 이 흐름을 사용하려면 입찰자가 Google에서 일치 테이블을 호스팅하도록 허용해야 하며 더 이상 Google의 쿠키 일치 서비스에 대한 요청에서 google_cm를 지정할 수 없으므로 자체 일치 테이블을 채우기 위한 google_gid를 수신하지 못하게 됩니다. Google에서 사용자와 일치하는 항목을 확인하면 입찰자는 자체 쿠키 데이터를 사용하여 사용자 목록에 사용자를 추가할 수 있습니다. 마찬가지로 이러한 사용자의 입찰 요청은 Google 사용자 ID를 제외하지만 호스팅된 일치 타겟팅 데이터를 포함합니다. 수정된 워크플로의 간단한 예는 아래 단계에 요약되어 있습니다.
1단계: 입찰자의 쿠키 일치 URL로 연결되는 일치 태그 배치
이 과정을 시작하려면 입찰자가 사용자의 브라우저에서 렌더링되도록 일치 태그를 배치해야 합니다. 개인 정보 보호 제한이 적용되는 미국 주에 거주하지 않는 사용자의 워크플로와 달리 일치 태그는 사용자의 브라우저를 쿠키 일치 URL로 안내해야 합니다. 예를 들어 쿠키 일치 URL이 https://ad.network.com/pixel로 구성된 경우 다음과 같이 표시됩니다.
<img src="https://ad.network.com/pixel" />
사용자의 브라우저에서 로드되면 입찰자의 쿠키 일치 URL에서 픽셀을 요청합니다. 이 요청에는 HTTP 헤더에 쿠키가 포함되며, 이 쿠키는 다음 단계에서 추출해야 합니다.
2단계: Google의 쿠키 일치 서비스로 리디렉션
입찰자의 쿠키 매칭 엔드포인트는 웹 보안 base64 인코딩 쿠키 데이터로 채워진 google_hm 매개변수를 포함하여 Google의 쿠키 매칭 서비스로 리디렉션되어야 합니다. 리디렉션 URL은 다음과 같이 표시될 수 있습니다.
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
3단계: 사용자의 브라우저가 Google의 쿠키 일치 서비스로 리디렉션됨
Google은 HTTP 헤더의 Google 쿠키 외에도 지정된 매개변수가 포함된 리디렉션을 수신합니다.
4단계: 보고서 URL이 지정된 경우 Google에서 성공 또는 오류 리디렉션 시 픽셀을 게재합니다.
쿠키 매칭 작업이 성공하거나 입찰자의 계정에 쿠키 매칭 보고서 URL이 지정되지 않은 경우 Google은 기본적으로 1x1 투명 픽셀을 게재하고 워크플로가 여기에서 종료됩니다.
후속 입찰 요청에서 이 사용자의 노출에는 OpenRTB의 경우 BidRequest.user.buyeruid에 있는 입찰자의 호스팅된 일치 데이터 또는 지원 중단된 Google RTB 프로토콜의 경우 BidRequest.hosted_match_data에 있는 입찰자의 호스팅된 일치 데이터가 포함됩니다. 입찰자는 지정한 호스팅된 일치 데이터를 사용하여 사용자 목록을 채울 수도 있습니다.
그렇지 않고 오류가 발생하면 Google은 입찰자의 쿠키 일치 보고서 URL로 리디렉션을 전송하고 google_error 매개변수에 지정된 오류의 원인을 전송합니다. 입찰자의 쿠키 일치 보고서 URL이 https://ad.network.com/report인 경우
리디렉션 URL은 다음과 같습니다.
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
5단계: 사용자의 브라우저가 입찰자의 쿠키 일치 보고서 URL로 리디렉션됨
사용자의 브라우저가 Google에서 google_error 매개변수에 지정한 오류 이유 (있는 경우)를 포함하여 입찰자의 쿠키 일치 보고서 URL로 리디렉션됩니다. 오류 코드 해석에 관한 자세한 내용은 매개변수 설명을 참고하세요.
6단계: 입찰자가 1x1 투명 픽셀을 게재합니다.
입찰자는 사용자의 브라우저에 1x1 투명 픽셀을 게재하여 응답해야 합니다.
개인 정보 보호 제한이 적용되는 미국 주의 사용자를 위한 쿠키 일치 워크플로 다이어그램
개인 정보 보호 제한이 적용되는 미국 주의 사용자를 위한 기본 워크플로는 아래 다이어그램에 나와 있습니다. 요청과 응답은 화살표로 표시되고, 함께 제공되는 데이터 항목은 괄호 안에 표시됩니다.
Google의 쿠키 일치 서비스로 입찰자 리디렉션을 위한 URL 매개변수
| 매개변수 | 설명 |
|---|---|
google_nid |
입찰자 계정의 네트워크 ID (NID)입니다. 이 ID는 입찰자 리소스를 통해 검색할 수 있습니다. |
google_sc |
이 매개변수는 지원 중단되었습니다. 쿠키가 없는 경우 사용자의 Google 쿠키를 설정합니다. 매개변수 값은 무시되며 생략할 수 있습니다. 쿠키가 없는 경우 매개변수를 생략하면 오류가 발생합니다. |
google_no_sc |
이 매개변수는 지원 중단되었습니다. 이는 Google의 쿠키 일치 서비스에 사용자의 쿠키가 없는 경우 쿠키를 설정해서는 안 된다고 나타냅니다. 매개변수 값은 무시되며 생략할 수 있습니다. |
google_hm |
입찰자가 Google에서 호스팅하는 데이터 이동 색인에 저장하려는 데이터가 포함되어 있습니다. |
google_redir |
Google에서 HTTP 302 리디렉션을 전송할 인코딩된 URL입니다. 지정된 URL은 오류와 성공한 작업 모두에 대해 google_error 매개변수가 포함된 리디렉션을 수신합니다. |
google_ula |
기존 사용자 목록에 사용자를 추가하는 데 사용되는 문자열입니다. 값의 예상 형식은 userlistid[,timestamp]입니다.
이 URL 매개변수를 반복하여 사용자를 여러 목록에 추가할 수 있습니다. |
gdpr |
요청에 데이터 사용에 대한 GDPR 제한사항이 적용됨을 나타냅니다. 자세한 내용은 아래의
EU 사용자 동의 요구사항 또는
승인된 구매자 IAB TCF v2.0 문서의 쿠키 매칭 자격요건에 미치는 영향을 참고하세요.
예: |
gdpr_consent |
최종 사용자 동의를 나타내는 TC 문자열입니다. 자세한 내용은 아래의 EU 사용자 동의 요구사항 또는 승인된 구매자 IAB TCF v2.0 문서의 TC 문자열은 어떻게 전달되나요?를 참고하세요. |
process_consent |
입찰자가
Google의 EU 사용자 동의 정책에 명시된 데이터 사용에 대한 최종 사용자 동의를 얻었음을 나타냅니다.
요청에 EU 사용자 동의 정책이 적용되지 않거나 요청에 사용할 수 있는 다른 동의 매개변수( 예: |
Google에서 입찰자의 쿠키 일치 보고서 URL로 리디렉션할 때 사용하는 URL 매개변수
| 매개변수 | 설명 |
|---|---|
google_error |
전체 요청 오류를 나타내는 정수 값입니다. 수신되면 작업이 실행되지 않았음을 나타내며 다른
|
Google에서 시작: 양방향 픽셀 일치
양방향 픽셀 매칭은 Google의 쿠키 매칭 서비스의 워크플로로, Google에서 Google 사용자 ID를 실시간 입찰 입찰 낙찰자가 아닌 알고리즘으로 선택된 입찰자와 일치시키려고 시도합니다. 광고가 게재되면 Google은 선택된 입찰자의 쿠키 매칭 URL에서 투명 픽셀을 로드하도록 사용자의 브라우저를 안내하는 일치 태그를 삽입합니다. 이렇게 하면 Google과 입찰자가 모두 특정 사용자로 데이터 이동 색인을 채울 수 있습니다. 다음은 이 워크플로의 간단한 예입니다.
1단계: Google에서 일치 태그 배치
참여하는 게시자의 페이지가 사용자의 브라우저에 로드되고 이 페이지의 광고 슬롯이 Google에 의해 채워지면, 알고리즘에 따라 선택된 입찰자에게 픽셀을 요청하는 일치 태그를 배치할 수 있습니다. Google이 배치한 픽셀 일치 태그는 입찰자의 쿠키 매칭 URL과 입찰자가 데이터 이동 색인을 채우기 위해 사용할 수 있는 추가 매개변수를 결합합니다. https://ad.network.com/pixel로 지정된 쿠키 일치 URL의 구조는 다음과 같습니다.
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
2단계: 입찰자가 Google의 쿠키 일치 서비스 URL로 리디렉션하여 응답해야 함
픽셀 매칭 요청을 수신하는 입찰자는 다음과 같이 구성된 Google의 쿠키 매칭 서비스에 대한 리디렉션으로 응답해야 합니다.
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
위의 리디렉션 URL은 입찰자 시작 쿠키 일치 워크플로의 일치 태그에 사용된 URL과 유사합니다.
픽셀 일치에서 google_cm 매개변수는 google_push 매개변수로 대체되며 그 값은 Google이 요청에서 제공한 값과 같아야 합니다. 입찰자 시작 워크플로와 마찬가지로 추가 사용 사례를 충족하도록 추가 매개변수를 지정할 수 있습니다.
3단계: Google에서 리디렉션을 처리하고 픽셀로 응답
Google은 사용자에 대해 일치 항목이 생성되었음을 기록하고 쿼리 매개변수를 통해 요청된 추가 작업을 처리합니다. 마지막으로 Google은 1x1 투명 픽셀로 응답합니다.
픽셀 일치 워크플로 다이어그램
이 워크플로는 아래 다이어그램에 나와 있습니다. 요청과 응답은 화살표로 표시되고, 함께 제공되는 데이터 항목은 괄호 안에 나열되어 있습니다.
Google 일치 태그 요청 매개변수
| 매개변수 | 설명 |
|---|---|
google_gid |
Google 사용자 ID입니다. 개인 정보 보호 제한이 적용되는 미국 주에 거주하지 않는 사용자의 경우 항상 Google의 일치 태그에 지정됩니다. |
google_cver |
쿠키 버전입니다. 이는 항상 Google의 일치 태그에 지정됩니다. |
google_push |
이 요청이 Pixel Matching 워크플로를 시작하고 있음을 나타냅니다. 값은 입찰자의 리디렉션 응답에서 해당 매개변수를 통해 반환되어야 합니다. |
gdpr_consent |
최종 사용자 동의를 나타내는 TC 문자열입니다. 자세한 내용은 아래의 [EU 사용자 동의 요건](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) 또는 [공식 구매자 IAB TCF v2.0 문서](//support.google.com/authorizedbuyers/answer/9789378)의 **TC 문자열은 어떻게 전달되나요?** 를 참고하세요. |
입찰자 Pixel Matching 리디렉션 매개변수
| 매개변수 | 설명 |
|---|---|
google_nid |
입찰자 계정의 네트워크 ID (NID)입니다. 이 ID는 입찰자 리소스를 통해 검색할 수 있습니다. |
google_push |
이 리디렉션이 Pixel Matching 워크플로를 완료하고 있음을 나타냅니다. 여기에 해당하는 Google 일치 태그의 값을 지정해야 합니다. |
google_hm |
입찰자가 Google에서 호스팅하는 데이터 이동 색인에 저장하려는 데이터가 포함되어 있습니다. |
google_ula |
기존 사용자 목록에 사용자를 추가하는 데 사용되는 문자열입니다. 값의 예상 형식은 userlistid[,timestamp]입니다.
이 URL 매개변수를 반복하여 사용자를 여러 목록에 추가할 수 있습니다. |
gdpr_consent |
최종 사용자 동의를 나타내는 TC 문자열입니다. 자세한 내용은 아래의 [EU 사용자 동의 요구사항](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) 또는 [Authorized Buyers IAB TCF v2.0 문서](//support.google.com/authorizedbuyers/answer/9789378)의 **TC 문자열은 어떻게 전달되나요?** 를 참조하세요. |
Google에서 시작: 단방향 픽셀 일치
단방향 픽셀 일치는 Google의 일치 태그에 Google 사용자 ID를 지정하는 매개변수가 포함되지 않지만 Google에서 호스팅하는 데이터 이동 색인을 계속 게재한다는 점에서 양방향 워크플로와 다릅니다. 이는 입찰자가 자체 데이터 이동 색인에서 Google 사용자 ID를 호스팅할 수 없는 경우에 사용할 수 있습니다. 아래 단계에 수정된 워크플로의 간단한 예가 요약되어 있습니다.
1단계: Google에서 일치 태그 배치
Google은 알고리즘에 의해 선택된 입찰자에 대해 일치 태그를 배치합니다. 일치 태그에는 google_push 매개변수가 포함됩니다. 예를 들면 다음과 같습니다.
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
2단계: 사용자의 브라우저가 입찰자의 Cooking Matching URL에서 픽셀을 요청합니다.
사용자의 브라우저가 HTTP 헤더에 있는 입찰자의 쿠키를 포함하여 입찰자의 쿠키 일치 URL에서 픽셀을 요청합니다.
3단계: Google의 쿠키 일치 서비스로 리디렉션
입찰자의 쿠키 일치 엔드포인트는 웹에 적합한 base64로 인코딩된 쿠키 데이터로 채워진 google_hm 매개변수를 포함하여 Google의 쿠키 일치 서비스로 리디렉션해야 합니다. 리디렉션 URL은 다음과 같이 표시될 수 있습니다.
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA
4단계: 사용자의 브라우저가 Google의 쿠키 일치 서비스로 리디렉션됨
Google은 HTTP 헤더의 Google 쿠키 외에도 지정된 매개변수가 포함된 리디렉션을 수신합니다. 작업이 성공하면 후속 입찰 요청에서 이 사용자의 노출에는 OpenRTB의 경우 BidRequest.user.buyeruid, 지원 중단된 Google RTB 프로토콜의 경우 BidRequest.hosted_match_data에 있는 입찰자의 호스팅 일치 데이터가 포함됩니다. 입찰자는 지정한 호스팅된 일치 데이터를 사용하여 사용자 목록을 채울 수도 있습니다.
마지막으로 Google은 1x1 투명한 픽셀을 사용자의 브라우저에 반환합니다.
쿠키 매칭 지원
공개 입찰을 사용하면 거래소에서 입찰자 시작 및 Google 시작 쿠키 매칭 워크플로를 사용하여 Google 사용자 ID를 쿠키와 일치시킬 수 있습니다. 쿠키 매칭 지원 (CMA)은 거래소에서 자체 입찰자로 데이터 이동 색인을 만들 수 있게 해주는 추가 기능입니다.
쿠키 매칭 지원의 작동 방식
광고를 게재할 때 Google은 알고리즘을 사용하여 참여 거래소를 선택하고 다음과 같은 구조의 Cookie Match Assist 태그를 게재합니다.
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
Google의 CMA 일치 태그를 사용하면 거래소의 쿠키 일치 URL이 픽셀 요청을 수신합니다.
- 거래소의 쿠키 매칭 엔드포인트가 요청을 수신하며, 이때 자체 쿠키 매칭 서비스가 사용자 ID를 입찰자 중 하나와 매칭하는 일을 담당합니다. 아래 다이어그램에서 거래소의 쿠키 매칭 서비스는 입찰자의 엔드포인트 중 하나로의 리디렉션으로 사용자의 브라우저에 응답합니다.
- 입찰자는 사용자 ID를 쿠키와 일치시키기 위해 거래소에서 지정한 매개변수와 함께 요청을 수신합니다.
제한사항
최신 일치 항목 요청 빈도 제한
입찰자는 Google에서 호스팅하는 일치 테이블에 최신 항목이 있는 사용자의 경우 쿠키 일치 서비스 호출 수를 제한해야 합니다. 호스팅된 데이터 이동 색인의 항목은 14일 후에 만료된 것으로 간주될 수 있으며, 그 후에는 새로고침할 수 있습니다.
모든 픽셀 일치 요청에 응답
Pixel Matching 워크플로를 사용하는 입찰자는 수신되는 모든 Pixel Match 요청에 google_push 매개변수가 포함된 응답으로 응답해야 합니다. 이를 통해 Google은 사용량을 모니터링하여 정책을 시행할 수 있습니다. 입찰자의 응답률이 90% 미만으로 떨어지면 Google에서는 계정으로 전송되는 Pixel Match 요청 수를 제한합니다.
HTTPS 엔드포인트 사용
모든 쿠키 일치 워크플로에 사용되는 엔드포인트는 HTTPS를 사용해야 합니다.
HTTPS를 통해 전송된 Pixel Match 요청에 응답할 때는 HTTPS를 통해 Cookie Matching Service로 리디렉션해야 합니다. 마찬가지로 입찰자로 리디렉션되는 쿠키 매칭 지원 엔드포인트도 HTTPS를 사용해야 합니다. HTTP를 통해 2분마다 한 번 이상 Google에 요청을 보내는 경우 계정에 전송되는 일치 요청 수가 제한됩니다.
EU 사용자 동의 요건
Google의 EU 사용자 동의 정책이 적용되는 쿠키 매칭 요청에는 최종 사용자 동의가 표시되어야 합니다. 이러한 요청은 다음 방법 중 하나를 사용하여 동의를 수집했음을 나타내야 합니다.
- TCFv2: 여기에는
gdpr및gdpr_consent매개변수가 포함됩니다. 자세한 내용은 Authorized Buyers IAB TCF v2.0 문서를 참고하세요. process_consent: 입찰자가 필요한 사용자 동의를 얻었음을 나타내는 선언입니다.
예
아래 예는 쿠키 매칭 서비스를 사용하여 특정 목표를 달성하는 방법을 보여줍니다. 달리 명시되지 않는 한 조치를 취하는 사용자가 개인 정보 보호 제한이 적용되는 미국 주에 거주하지 않는 것으로 간주됩니다.
입찰자가 호스팅하는 데이터 이동 색인 채우기
입찰자는 쿠키 매칭 워크플로를 사용하여 일치 태그에 google_nid 및 google_cm 매개변수만 제공하여 자체 일치 테이블을 채울 수 있습니다. 다음과 같습니다.
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
입찰자의 쿠키 일치 URL이 https://ad.network.com/pixel?id=1로 설정되어 있고 쿠키 일치 작업이 성공하면 Google에서 입찰자의 일치 태그에 대한 응답으로 전송하는 리디렉션은 다음과 같을 수 있습니다.
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
사용자에게 Google 쿠키가 없어 쿠키 일치 작업이 실패하면 다음과 같은 응답이 반환됩니다.
https://ad.network.com/pixel?id=1&google_error=3
오류 코드는 오류의 근본 원인에 따라 다릅니다. 쿠키 일치 워크플로에서 발생할 수 있는 오류 코드에 관한 자세한 내용은 리디렉션 URL 매개변수를 참고하세요.
단일 사용자 목록에 추가
google_ula 매개변수를 입찰자의 일치 태그에 지정하여 지정된 ID로 사용자를 사용자 목록에 추가할 수 있습니다. Google 또는 입찰자가 호스팅하는 데이터 이동 색인에 사용자의 새 항목이 있는 경우 입찰자는 google_nid 및 google_ula 매개변수가 포함된 일치 태그를 배치하여 전체 쿠키 매칭 워크플로를 시작하지 않고도 지정된 목록에 사용자를 추가할 수 있습니다. 자세한 내용은 쿠키 일치 서비스 호출 시 제한사항을 참고하세요. 상응하는 일치 태그는 다음과 같이 표시될 수 있습니다.
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
입찰자의 쿠키 일치 URL이 https://ad.network.com/pixel인 경우 성공적인 응답의 경우 Google의 리디렉션 URL은 다음과 같습니다.
https://ad.network.com/pixel?google_ula=12345,0
전반적인 오류가 있는 경우(예: 사용자의 Google 쿠키가 없음) 리디렉션 URL에 google_error 매개변수가 포함됩니다.
https://ad.network.com/pixel?google_error=3
사용자를 목록에 추가하는 것과 관련된 오류가 있는 경우 리디렉션에서 google_ula이 표시됩니다. 해당하는 일치 태그 매개변수와 달리 이 매개변수는 타임스탬프를 상태 코드로 대체하여 작업의 성공을 나타냅니다. 예를 들어 입찰자 계정에 지정된 사용자 목록에 대한 액세스 권한이 없어서 요청이 실패한 경우 리디렉션 URL은 다음과 같습니다.
https://ad.network.com/pixel?google_ula=12345,2
여러 사용자 목록에 추가
입찰자는 일치 태그에 여러 개의 google_ula 매개변수를 포함하여 사용자를 여러 사용자 목록에 추가해야 한다고 지정할 수 있습니다. 실제로는 다음과 같이 표시될 수 있습니다.
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
각 사용자 목록의 작업 상태도 마찬가지로 리디렉션의 고유한 google_ula 매개변수를 통해 보고됩니다.
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
위의 리디렉션에서 ID가 45678인 사용자 목록의 경우 작업이 성공했지만 입찰자가 액세스 권한이 없어 사용자 목록 ID 12345의 경우 작업이 실패한 것을 확인할 수 있습니다.
쿠키 일치 워크플로를 진행하고 사용자 목록에 추가
단일 요청에서 쿠키 일치를 실행하고 사용자를 사용자 목록에 추가하려면 입찰자의 일치 태그에 google_cm 및 google_ula가 포함되어야 합니다.
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />
Google에서 지정한 리디렉션 URL에는 google_gid, google_cver, google_ula가 포함됩니다. 다음과 같이 표시될 수 있습니다.
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Google에서 호스팅하는 데이터 이동 색인에 일치 항목 저장
입찰자가 Google에서 호스팅하는 일치 테이블에 쿠키 데이터를 저장하려고 하며 자체 일치 테이블에 Google 사용자 ID와 일치하는 항목을 저장할 의도가 없는 경우 일치 태그에 google_hm 매개변수를 포함해야 하며 이 값은 웹 보안 Base64로 인코딩된 문자열이어야 합니다. 입찰자의 인코딩되지 않은 쿠키 데이터가 Cookie number 1!인 사용자의 경우 인코딩된 값은 Q29va2llIG51bWJlciAxIQ==이며 다음과 같은 일치 태그에 사용됩니다.
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
입찰자의 쿠키 일치 URL이 https://cookie-monster.com/pixel인 경우 성공적인 응답의 경우
Google의 리디렉션 URL은
다음과 같습니다.
https://cookie-monster.com/pixel
일치 태그에 google_cm가 포함되지 않았고 google_hm가 성공 응답에 포함되지 않았기 때문에 google_gid 매개변수가 리디렉션에 없습니다. 향후 이 사용자의 노출에 대한 입찰 요청에서 입찰자는 OpenRTB의 경우 BidRequest.user.buyeruid, 지원 중단된 Google RTB 프로토콜의 경우 BidRequest.hosted_match_data에서 호스팅된 일치 데이터를 수신합니다.
대신 입찰자가 google_hm 값이 base64로 인코딩되지 않은 일치 태그(예: chocolate_chunk!)를 사용한 경우 리디렉션 URL은 다음과 같이 표시될 수 있습니다.
https://cookie-monster.com/pixel?google_hm=2
위의 리디렉션 URL에 포함된 2의 google_hm 값은 값을 디코딩할 수 없어 작업이 실패했음을 나타냅니다.
입찰자 및 Google에서 호스팅하는 사용자 목록이 포함된 일치 테이블
입찰자가 Google에서 호스팅하는 사용자 목록 외에 자체 사용 목록을 호스팅하고 단일 일치 태그로 두 표를 일치시키고 사용자를 지정된 사용자 목록에 추가하려는 경우 일치 태그에 google_cm, google_hm, google_ula 매개변수가 포함되어야 합니다. 입찰자의 쿠키 데이터가 Cookie number 1!인 경우 인코딩된 값은 Q29va2llIG51bWJlciAxIQ==가 되어 다음과 같은 일치 태그가 생성됩니다.
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
응답이 성공하고 입찰자의 쿠키 일치 URL이 https://cookie-monster.com/pixel인 경우 Google의 리디렉션 URL은 다음과 같습니다.
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
리디렉션을 받은 입찰자는 google_gid에 지정된 Google 사용자 ID를 데이터 이동 색인의 쿠키 데이터와 일치시킬 수 있습니다. 또한 Google에서 호스팅하는 일치 테이블 및 사용자 목록 작업이 성공적으로 완료되었는지 확인할 수 있습니다. 따라서 이제 지정된 사용자 목록 ID를 타겟팅하도록 구성된 입찰자의 사전 타겟팅을 통해 입찰자가 사용자로부터 노출에 대한 입찰 요청을 받게 됩니다. 마찬가지로 이러한 입찰 요청에서 입찰자는 OpenRTB의 경우 BidRequest.user.buyeruid, 지원 중단된 Google RTB 프로토콜의 경우 BidRequest.hosted_match_data에서 호스팅된 일치 데이터를 수신합니다.