쿠키 매칭은 쿠키(예: 웹사이트를 둘러본 사용자의 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은
BidRequest.user.buyeruid을 웹 보안 base64 인코딩 문자열로 지정합니다.사용자 목록: 사용자 목록은 Google 사용자 ID 또는 호스팅된 일치 데이터로 채울 수 있습니다.
- 사전 타겟팅: 호스팅된 일치 데이터가 포함된 입찰 요청만 수신하도록 사전 타겟팅을 구성할 수 있습니다. 이를 사용하여 쿠키 스페이스 외부 사용자의 관련성이 낮은 노출을 삭제할 수 있습니다.
사용자 목록
사용자 목록은 실시간 입찰 API를 사용하여 만들고 관리할 수 있습니다. 생성된 목록은 다음 쿠키 매칭 워크플로를 사용하거나 일괄 업로더 서비스를 통해 채울 수 있습니다.
시작하기
쿠키 매칭을 시작하려면 기술계정 관리자에게 문의해야 합니다. 기술계정 관리자는 특정 워크플로를 사용 설정하고 다음을 구성하는 데 도움을 줄 수 있습니다.
- 쿠키 매칭 네트워크 ID (NID): 쿠키 매칭 및 기타 관련 작업을 위해 입찰자 계정을 식별하는 문자열 ID입니다.
- 쿠키 매칭 URL: 쿠키 매칭 워크플로의 일부로 새로 추가되는 요청을 수락하고 처리하는 엔드포인트의 기본 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로 인코딩된 문자열입니다. 일치 테이블을 호스팅하기로 선택한 입찰자의 경우 쿠키 일치 서비스에서 반환된 정확한 문자열을 저장하는 것이 좋습니다. 후속 입찰 요청에서는 BidRequest.user.id를 통해 지정된 값에 해당합니다.
google_cver에 지정된 버전은 Google 사용자 ID의 숫자 버전 번호를 나타냅니다. 특정 사용자의 Google 사용자 ID는 드물게 변경되며, 변경되면 값이 증가합니다.
Google에서 경기 요청을 처리하는 중에 오류가 발생하면 대신 google_error 매개변수가 지정됩니다.
3단계: 입찰자가 리디렉션을 처리하고 픽셀로 응답
입찰자는 첫 번째 단계에서 지정한 매개변수와 두 번째 단계에서 Google이 제공한 매개변수가 포함된 쿠키 매칭 URL로 리디렉션됩니다. 또한 HTTP 헤더에서 쿠키를 수신합니다. 작업이 성공하면 자체 일치 테이블을 호스팅하는 입찰자는 쿠키를 응답에 포함된 Google 사용자 ID와 일치시킬 수 있습니다. 입찰자는 쿠키 매칭 서비스에서 반환된 정확한 문자열을 저장하는 것이 좋습니다.
작업이 실패하면 입찰자는 리디렉션에서 google_error 매개변수를 받습니다. 발생한 특정 오류를 식별하는 다양한 오류 상태에 해당하는 숫자 값입니다. google_error URL 매개변수의 설명에서 가능한 오류 값에 대해 자세히 알아볼 수 있습니다. 오류가 발생하면 새 일치 태그를 배치하여 해당 사용자를 다시 일치시킬 수 있습니다.
입찰자는 항상 1x1의 보이지 않는 픽셀 이미지를 제공하여 응답해야 합니다. 또는 HTTP 204 No Content 응답을 반환할 수도 있습니다.
쿠키 매칭 워크플로 다이어그램
이 워크플로는 다음 다이어그램에 나와 있습니다. 요청과 응답은 화살표로 표시되고, 요청과 응답에 포함된 데이터 항목은 괄호 안에 나열됩니다.
일치 태그 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에 이 일치 태그의 인코딩된 URL로 HTTP 302 리디렉션을 전송하도록 지시하려는 경우 지정할 수 있는 URL 인코딩 문자열입니다. 이를 통해 Google은 파트너에 대한 연결된 호출에서 앞에 배치될 수 있습니다. google_hm 없이 또는 google_cm와 함께 지정하면 오류가 발생합니다. |
google_ula |
기존 사용자 목록에 사용자를 추가하는 데 사용되는 문자열입니다. 값의 예상 형식은 userlistid[,timestamp]입니다.
이 URL 매개변수는 사용자를 여러 목록에 추가하기 위해 반복될 수 있습니다. |
gdpr |
데이터 사용에 대한 GDPR 제한사항이 요청에 적용됨을 나타냅니다. 자세한 내용은
EU 사용자 동의 요구사항 또는
Authorized Buyers IAB TCF v2.0 문서의 쿠키 일치 자격에 미치는 영향을 참고하세요.
예: |
gdpr_consent |
최종 사용자 동의를 나타내는 TC 문자열입니다. 자세한 내용은 EU 사용자 동의 요건 또는 공인 구매자 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은 google_ 및 입찰자 정의 매개변수를 포함하여 입찰자의 계정에 구성된 기본 쿠키 일치 URL에서 빌드되며, 이는 일치 태그에 지정된 항목에 따라 달라집니다. 다음 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의 광고 및 일치 태그를 게재합니다.
- 일치 태그는 Google의 쿠키 매칭 서비스를 호출하여
google_nid및google_cm매개변수를 지정합니다. - 쿠키 매칭 서비스는 Jane의 Google 쿠키를 읽고
google_gid및google_cver매개변수가 설정된 FinestDSP의 쿠키 매칭 URL로 리디렉션을 Jane의 브라우저에 전송합니다. - Jane의 브라우저가 FinestDSP의 쿠키 일치 URL로 리디렉션을 로드합니다.
- FinestDSP의 쿠키 매칭 엔드포인트는 Google에서 설정한 URL 매개변수와 HTTP 헤더의 Jane 쿠키를 포함하는 리디렉션 요청을 처리합니다. 이제 FinestDSP는 쿠키와
google_gid의 매핑을 일치 테이블에 저장할 수 있습니다. - FinestDSP는 보이지 않는 1x1 픽셀로 리디렉션에 응답합니다.
시나리오 2: 기존 매핑이 있는 사용자
시나리오 1에서 일주일 후 Jane이 ExampleNews.com을 다시 방문합니다. 이제 Jane의 머신에 입찰자와 Ad Manager 쿠키가 모두 있으므로 매칭이 작동하는 방식은 다음과 같습니다.
- 웹페이지가 렌더링되어 Google (Ad Manager)에서 페이지에 렌더링될 광고를 요청합니다.
- 광고 입찰 중에 Google은 FinestDSP를 비롯한 관련 입찰자에게 입찰 요청을 전송합니다.
- FinestDSP는
google_gid와 같은 신호를 포함한 입찰 요청을 수신합니다. - FinestDSP는 일치 테이블에서
google_gid를 조회하고 일주일 전에 생성된 Jane과 연결된 쿠키를 찾습니다(시나리오 1). - 쿠키와 연결된 정보를 기반으로 FinestDSP의 입찰 로직이 노출에 입찰하고 입찰에서 낙찰됩니다.
- 제인에게는 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 투명 픽셀을 게재하며 워크플로가 여기서 종료됩니다.
후속 입찰 요청에서 이 사용자의 노출에는 BidRequest.user.buyeruid에 호스팅된 입찰자의 일치 데이터가 포함됩니다. 입찰자는 지정한 호스팅된 매치 데이터를 사용하여 사용자 목록을 채울 수도 있습니다.
그렇지 않고 오류가 발생한 경우 Google은 google_error 매개변수에 지정된 오류 원인과 함께 입찰자의 쿠키 매칭 보고서 URL로 리디렉션을 전송합니다. 입찰자의 쿠키 매칭 보고서 URL이 https://ad.network.com/report인 경우 리디렉션 URL은 다음과 같습니다.
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
5단계: 사용자의 브라우저가 입찰자의 쿠키 일치 보고서 URL로 리디렉션됨
사용자의 브라우저가 입찰자의 쿠키 매칭 보고서 URL로 리디렉션되며, 여기에는 Google이 google_error 매개변수에 지정한 오류 이유 (있는 경우)가 포함됩니다. 오류 코드 해석에 대한 자세한 내용은 매개변수 설명을 참고하세요.
6단계: 입찰자가 1x1 투명 픽셀을 제공함
입찰자는 사용자 브라우저에 1x1 투명 픽셀을 제공하여 응답해야 합니다.
개인 정보 보호 제한이 있는 미국 주의 사용자를 위한 쿠키 매칭 워크플로 다이어그램
개인 정보 보호 제한이 있는 미국 주에 거주하는 사용자의 기본 워크플로는 다음 다이어그램에 나와 있습니다. 여기서 요청과 응답은 화살표로 표시되고, 함께 제공되는 데이터 항목은 괄호 안에 나열됩니다.
Google의 쿠키 일치 서비스로 리디렉션하는 입찰자의 URL 매개변수
| 매개변수 | 설명 |
|---|---|
google_nid |
입찰자 계정의 네트워크 ID (NID)입니다. 이 ID는 Bidders 리소스를 통해 가져올 수 있습니다. |
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 사용자 동의 요구사항 또는
Authorized Buyers 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 |
이 요청이 픽셀 매칭 워크플로를 시작함을 나타냅니다. 값은 입찰자의 리디렉션 응답의 해당 매개변수를 통해 반환되어야 합니다. |
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 문자열은 어떻게 전달되나요?** 를 참고하세요. |
입찰자 Pixel Matching 리디렉션 매개변수
| 매개변수 | 설명 |
|---|---|
google_nid |
입찰자 계정의 네트워크 ID (NID)입니다. 이 ID는 Bidders 리소스를 통해 가져올 수 있습니다. |
google_push |
이 리디렉션이 픽셀 매칭 워크플로를 완료하고 있음을 나타냅니다. 해당 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단계: 사용자의 브라우저가 입찰자의 쿠키 매칭 URL에서 픽셀을 요청함
사용자의 브라우저가 입찰자의 쿠키 매칭 URL에서 픽셀을 요청하며, HTTP 헤더에 입찰자의 쿠키가 포함됩니다.
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 쿠키 외에도 지정한 매개변수가 포함된 리디렉션을 수신합니다. 작업이 성공하면 후속 입찰 요청에서 이 사용자의 노출에 BidRequest.user.buyeruid의 입찰자 호스팅 일치 데이터가 포함됩니다.
입찰자는 지정한 호스팅된 일치 데이터를 사용하여 사용자 목록을 채울 수도 있습니다.
마지막으로 Google은 1x1 투명 픽셀을 사용자 브라우저에 반환합니다.
쿠키 매치 지원
공개 입찰을 통해 거래소는 입찰자 시작 및 Google 시작 쿠키 매칭 워크플로를 사용하여 Google 사용자 ID를 쿠키와 일치시킬 수 있습니다. 쿠키 매칭 지원 (CMA)은 거래소가 자체 입찰자와 매칭 테이블을 구축할 수 있도록 지원하는 거래소용 추가 기능입니다.
쿠키 매치 지원의 작동 방식
광고를 게재할 때 Google 알고리즘은 참여 거래소를 선택하고 다음 구조를 갖는 쿠키 매칭 지원 태그를 배치합니다.
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
Google의 CMA 매칭 태그로 인해 거래소의 쿠키 매칭 URL이 픽셀 요청을 수신합니다.
- 거래소의 쿠키 매칭 엔드포인트는 요청을 수신하며, 자체 쿠키 매칭 서비스는 사용자 ID를 입찰자 중 한 명과 매칭합니다. 다음 다이어그램에서 거래소의 쿠키 일치 서비스는 입찰자의 엔드포인트 중 하나로 리디렉션하여 사용자의 브라우저에 응답합니다.
- 입찰자는 사용자 ID를 쿠키와 일치시키기 위해 거래소에서 지정한 매개변수와 함께 요청을 수신합니다.
제한사항
새 일치 항목 요청 빈도 제한
입찰자는 Google 호스팅 일치 테이블에 새로운 항목이 있는 사용자에 대한 쿠키 일치 서비스 호출 수를 제한해야 합니다. 호스팅된 데이터 이동 색인의 항목은 14일 후에 만료된 것으로 간주되며, 이후에 새로고침할 수 있습니다.
모든 픽셀 일치 요청에 응답
픽셀 매칭 워크플로를 사용하는 입찰자는 수신되는 모든 픽셀 매칭 요청에 google_push 매개변수가 포함된 응답으로 응답해야 합니다. 이를 통해 Google은 사용량을 모니터링하여 정책을 시행할 수 있습니다. 입찰자의 응답률이 90% 미만이면 Google에서 해당 계정으로 전송되는 픽셀 일치 요청 수를 제한합니다.
HTTPS 엔드포인트 사용
모든 쿠키 일치 워크플로에 사용되는 엔드포인트는 HTTPS를 사용해야 합니다.
HTTPS를 통해 전송된 픽셀 일치 요청에 응답할 때는 HTTPS를 통해 쿠키 일치 서비스로 리디렉션해야 합니다. 마찬가지로 입찰자에게 리디렉션되는 쿠키 매치 지원 엔드포인트도 HTTPS를 사용해야 합니다. 2분마다 한 번 이상 HTTP를 통해 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 매개변수가 리디렉션에 없습니다. 이 사용자의 노출에 대한 향후 입찰 요청에서 입찰자는 BidRequest.user.buyeruid에 호스팅된 일치 데이터를 수신합니다.
입찰자가 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를 타겟팅하도록 구성한 사전 타겟팅은 이제 입찰자가 사용자로부터 노출에 대한 입찰 요청을 수신하도록 합니다. 마찬가지로 이러한 입찰 요청에서 입찰자는 호스팅된 일치 데이터를 BidRequest.user.buyeruid에서 수신합니다.