쿠키 매칭은 내 쿠키(예: 웹사이트를 탐색한 사용자의 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의 RTB 프로토콜을 사용하도록 구성된 경우
BidRequest.hosted_match_data
필드를 통해 디코딩된 바이트로 수신됩니다. Google의 OpenRTB 구현에서BidRequest.user.buyeruid
은 이 데이터를 웹에 적합한 base64 인코딩 문자열로 반환합니다.사용자 목록: 사용자 목록은 Google 사용자 ID 또는 호스팅된 일치 데이터로 채워질 수 있습니다.
- 사전 타겟팅: 호스팅된 일치 데이터가 포함된 입찰 요청만 수신하도록 사전 타겟팅을 구성할 수 있습니다. 이는 쿠키 공간 외부에 있는 사용자에게 관련성이 낮은 노출을 제거하는 데 사용될 수 있습니다.
사용자 목록
사용자 목록은 실시간 입찰 API를 사용하여 만들고 관리할 수 있습니다. 생성된 후 아래에 설명된 쿠키 매칭 워크플로로 또는 일괄 업로더 서비스를 통해 이 목록을 채울 수 있습니다.
시작하기
쿠키 매칭을 시작하려면 특정 워크플로를 사용 설정하고 다음을 구성할 수 있도록 지원하는 기술계정 관리자에게 문의해야 합니다.
- 쿠키 매칭 네트워크 ID (NID): 쿠키 매칭 및 기타 관련 작업을 위해 입찰자 계정을 고유하게 식별하는 문자열 ID입니다.
- 쿠키 일치 URL: 쿠키 일치 워크플로의 일부로 수신되는 요청을 수락하고 처리하는 엔드포인트의 기본 URL입니다. 입찰자는 이 URL에 매크로를 삽입하여 쿠키 일치 워크플로에서 이 URL에 전달된 매개변수의 순서를 제어할 수 있습니다.
- 일치 태그: 입찰자가 시작하는 쿠키 매칭 워크플로를 위해 사용자 브라우저에 배치해야 하는 태그입니다. 이는 광고와 함께 게재하거나 광고 외부의 웹 서비스에 배치할 수 있습니다.
- 쿠키 매칭 보고서 URL (선택사항): 단방향 쿠키 매칭 워크플로에서 쿠키 매칭이 HTTP 302 리디렉션을 통해 실패하는 경우 오류 세부정보를 수신할 엔드포인트를 지정하기 위해 제공할 수 있는 선택적 URL입니다. 기본적으로 쿠키 매칭 작업에 오류가 발생한 경우에만 응답이 이 URL로 전송되지만 입찰자는 리디렉션을 항상 전송하도록 요청할 수 있습니다.
- 쿠키 매칭 지원 URL: 쿠키 매칭 지원 워크플로를 구현하는 거래소의 경우 수신 요청에 응답하기 위한 엔드포인트의 기본 URL입니다.
- 쿠키 매칭 지원 할당량: 쿠키 매칭 지원 워크플로를 구현하는 거래소의 경우 쿠키 매칭 URL이 1초에 수신할 수 있는 최대 요청 수입니다. 이는 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 인코딩 문자열입니다. 데이터 이동 색인을 호스팅하기로 한 입찰자의 경우 쿠키 일치 서비스에서 반환한 정확한 문자열을 저장하는 것이 좋습니다. 후속 입찰 요청에서 이 값은 Google RTB 프로토콜의 BidRequest.google_user_id
또는 Google의 OpenRTB 구현의 BidRequest.user.id
를 통해 지정된 값에 해당합니다.
google_cver
에 지정된 버전은 Google 사용자 ID의 숫자 버전 번호를 나타냅니다. 특정 사용자의 Google 사용자 ID는 자주 변경되지 않으며 이후 증가됩니다.
Google에서 일치 요청을 처리하는 중에 오류가 발생하면 google_error
매개변수가 대신 지정됩니다.
3단계: 입찰자가 리디렉션을 처리하고 픽셀로 응답
입찰자는 첫 번째 단계에서 지정한 매개변수와 두 번째 단계에서 Google이 제공한 매개변수가 포함된 쿠키 일치 URL로 리디렉션을 받습니다. 또한 HTTP 헤더에서도 쿠키를 수신합니다. 작업이 성공하면 자체 데이터 이동 색인을 호스팅하는 입찰자가 쿠키를 응답에 포함된 Google 사용자 ID와 일치시킬 수 있습니다. 입찰자는 쿠키 일치 서비스에서 반환한 정확한 문자열을 저장하는 것이 좋습니다.
작업이 실패하면 입찰자는 리디렉션에서 google_error
매개변수를 수신합니다. 이는 발생한 특정 오류를 식별하는 다양한 오류 상태에 해당하는 숫자 값입니다. 가능한 오류 값에 대한 자세한 내용은 여기를 참조하세요.
오류가 발생하면 새 일치 태그를 배치하여 해당 사용자에 대한 일치를 다시 시도할 수 있습니다.
입찰자는 항상 1x1 크기의 보이지 않는 픽셀 이미지를 게재하여 응답하거나
HTTP 204
콘텐츠 없음 응답을 반환해야 합니다.
쿠키 일치 워크플로 다이어그램
이 워크플로는 아래 다이어그램에 나와 있습니다. 여기서 요청과 응답은 화살표로 표시되고, 수반되는 데이터 항목은 괄호로 표시됩니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=2&hl=ko)
태그 URL 매개변수 일치
매개변수 | 설명 |
---|---|
google_nid |
입찰자 계정의 네트워크 ID (NID) 이 ID는 입찰자 리소스를 통해 가져올 수 있습니다. |
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 사용자 동의 요구사항 또는 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: 사용자가 쿠키를 지우고 사이트를 탐색함
Jane이 모든 쿠키 캐시를 지웁니다. 그런 다음 ExampleNews.com의 홈페이지를 방문합니다.
다음과 같은 결과가 나타납니다.
- ExampleNews.com이 렌더링되고 Google (Ad Manager)의 광고를 호출합니다.
- 광고 단위가 동적 할당에 적합하므로 Google은 실시간 입찰 서비스를 통해 FinestDSP 및 기타 입찰자에게 입찰 요청을 전송합니다.
- FinestDSP의 입찰자 애플리케이션이 입찰 요청을 수신 및 처리하고 입찰 응답을 전송합니다.
- Google은 입찰자로부터 입찰 응답을 수신합니다. 여기에는 일치 태그 (픽셀)가 있는 광고를 지정하는 FinestDSP의 응답이 포함됩니다.
- FinestDSP가 낙찰됩니다. Google이 FinestDSP의 광고 및 일치 태그를 Jane에게 게재합니다.
- 일치 태그는
google_nid
및google_cm
매개변수를 지정하여 Google의 쿠키 일치 서비스를 호출합니다. - 쿠키 일치 서비스가 사용자의 Google 쿠키를 읽고
google_user_id
및google_cver
매개변수가 설정된 FinestDSP의 쿠키 매칭 URL로 리디렉션을 전송합니다. - 사용자의 브라우저가 FinestDSP의 쿠키 일치 URL로 리디렉션을 로드합니다.
- FinestDSP의 쿠키 일치 엔드포인트는 Google에서 설정한 URL 매개변수와 HTTP 헤더의 Jane에 대한 쿠키가 포함된 리디렉션 요청을 처리합니다. 이제 FinestDSP에서 데이터 이동 색인의
google_user_id
에 대한 쿠키 매핑을 저장할 수 있습니다. - FinestDSP는 리디렉션에 대해 보이지 않는 1x1 픽셀로 응답합니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=2&hl=ko)
시나리오 2: 기존 매핑이 있는 사용자
시나리오 1이 발생하고 일주일 후 사용자가 ExampleNews.com을 다시 방문했습니다. 이제 사용자의 컴퓨터에 입찰자와 Ad Manager 쿠키가 모두 있으므로 매칭이 작동하는 방식은 다음과 같습니다.
- 웹페이지가 렌더링되어 Google (Ad Manager)이 페이지에서 렌더링될 광고를 요청합니다.
- 광고 입찰이 진행되는 동안 Google은 FinestDSP를 비롯한 해당하는 입찰자에게 입찰 요청을 전송합니다.
- FinestDSP에서
google_user_id
와 같은 신호를 포함한 입찰 요청을 수신합니다. - FinestDSP는 데이터 이동 색인에서
google_user_id
를 조회하여 1주일 전(시나리오 1)에서 생성된 Jane과 관련된 쿠키를 찾습니다. - 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 투명 픽셀을 제공하며, 워크플로는 여기에서 종료됩니다.
후속 입찰 요청에서 이 사용자의 노출에는 Google 프로토콜의 경우 BidRequest.hosted_match_data
에, Google의 OpenRTB 구현의 경우 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로 리디렉션됨
사용자의 브라우저가 google_error
매개변수에 Google이 지정한 오류 이유 (있는 경우)를 포함하여 입찰자의 쿠키 일치 보고서 URL로 리디렉션됩니다. 오류 코드 해석에 관한 자세한 내용은 매개변수 설명을 참고하세요.
6단계: 입찰자가 1x1 투명 픽셀을 게재
입찰자는 사용자의 브라우저에 1x1 투명 픽셀을 게재하여 응답해야 합니다.
개인 정보 보호 제한이 있는 미국 주 사용자를 위한 쿠키 매칭 워크플로 다이어그램
개인 정보 보호 제한이 있는 미국 주 사용자를 위한 기본 워크플로는 아래 다이어그램에 나와 있습니다. 여기서 요청과 응답은 화살표로 표시되고, 수반되는 데이터 항목은 괄호로 표시됩니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=2&hl=ko)
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 사용자 동의 요구사항 또는
Authorized Buyers IAB TCF v2.0 문서의 쿠키 매칭 자격요건에 미치는 영향을 참조하세요.
예: |
gdpr_consent |
최종 사용자 동의를 나타내는 TC 문자열입니다. 자세한 내용은 아래의 EU 사용자 동의 요구사항 또는 Authorized Buyers IAB TCF v2.0 문서의 TC 문자열은 어떻게 전달되나요?를 참조하세요. |
process_consent |
입찰자가
Google의 EU 사용자 동의 정책에 명시된 데이터 사용에 대해 최종 사용자 동의를 얻었음을 나타냅니다.
요청에 EU 사용자 동의 정책이 적용되지 않거나 요청에 사용할 수 있는 다른 동의 매개변수( 예: |
입찰자의 쿠키 일치 보고서 URL로 리디렉션되는 Google의 URL 매개변수
매개변수 | 설명 |
---|---|
google_error |
전반적인 요청 오류를 나타내는 정수 값입니다. 이 메시지가 수신되면 실행된 작업이 없으며 다른
|
Google에서 시작: 양방향 픽셀 일치
양방향 픽셀 매칭은 Google이 Google 사용자 ID를 실시간 입찰 입찰 낙찰자가 아닌 알고리즘 방식으로 선택된 입찰자와 매칭하는 Google 쿠키 매칭 서비스의 워크플로입니다. 광고가 게재되면 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의 URL과 유사합니다.
픽셀 일치에서 google_cm
매개변수는 google_push
매개변수로 대체되며 그 값은 Google이 요청에서 제공한 값과 같아야 합니다. 또한 입찰자가 시작한 워크플로와 마찬가지로 추가 매개변수를 지정하여 추가 사용 사례를 처리할 수 있습니다.
3단계: Google에서 리디렉션을 처리하고 픽셀로 응답
Google은 사용자에 대해 일치 항목이 생성되었음을 기록하고, 쿼리 매개변수를 통해 요청된 모든 추가 작업을 처리합니다. 마지막으로 Google은 1x1 투명 픽셀로 응답합니다.
픽셀 일치 워크플로 다이어그램
이 워크플로는 아래 다이어그램에 나와 있습니다. 여기서 요청과 응답은 화살표로 표시되고, 수반되는 데이터 항목은 괄호로 표시됩니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=2&hl=ko)
Google 일치 태그 요청 매개변수
매개변수 | 설명 |
---|---|
google_gid |
Google 사용자 ID입니다. 개인 정보 보호 제한이 있는 미국 주에 거주하지 않는 사용자의 경우 항상 Google의 일치 태그에 지정됩니다. |
google_cver |
쿠키 버전입니다. 이 값은 항상 Google의 일치 태그에 지정됩니다. |
google_push |
이 요청이 픽셀 일치 워크플로를 시작 중임을 나타냅니다. 이 값은 입찰자의 리디렉션 응답에서 해당 매개변수를 통해 반환되어야 합니다. |
입찰자 픽셀 일치 리디렉션 매개변수
매개변수 | 설명 |
---|---|
google_nid |
입찰자 계정의 네트워크 ID (NID) 이 ID는 입찰자 리소스를 통해 가져올 수 있습니다. |
google_push |
이 리디렉션이 픽셀 일치 워크플로를 완료하고 있음을 나타냅니다. 해당하는 Google 일치 태그의 값은 여기에 지정해야 합니다. |
google_hm |
입찰자가 Google에서 호스팅하는 데이터 이동 색인에 저장하려는 데이터가 포함됩니다. |
google_ula |
기존 사용자 목록에 사용자를 추가하는 데 사용되는 문자열입니다. 값의 예상 형식은 userlistid[,timestamp] 입니다.
이 URL 매개변수를 반복하여 사용자를 여러 목록에 추가할 수 있습니다. |
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에서 픽셀을 요청
사용자의 브라우저가 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 쿠키 외에도 지정된 매개변수가 포함된 리디렉션을 수신합니다. 작업이 성공하면 후속 입찰 요청에서 이 사용자의 노출에 Google 프로토콜의 경우 BidRequest.hosted_match_data
, Google의 OpenRTB 구현의 경우 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와 쿠키를 일치시키기 위해 거래소에서 지정한 매개변수와 함께 요청을 수신합니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=2&hl=ko)
제한사항
새로운 일치 항목의 요청 빈도 제한
입찰자는 Google에서 호스팅하는 데이터 이동 색인에 새 항목이 있는 사용자의 쿠키 매칭 서비스에 대한 호출 수를 제한해야 합니다. 호스팅된 데이터 이동 색인의 항목은 14일 후에 만료된 것으로 간주될 수 있으며, 그 후에 새로고침할 수 있습니다.
모든 픽셀 일치 요청에 응답
픽셀 일치 워크플로를 사용하는 입찰자는 google_push
매개변수를 포함한 응답으로 수신되는 모든 픽셀 일치 요청에 응답해야 합니다. 이렇게 하면 Google에서 사용량을 모니터링하여 정책을 시행할 수 있습니다. 입찰자의 응답률이 90% 미만으로 떨어지면 Google은 계정에 전송되는 Pixel Match 요청 수를 제한합니다.
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와의 일치 항목을 저장하지 않으려는 경우, 일치 태그에 해당 값이 웹에 적합한 base64로 인코딩된 문자열이어야 하는 google_hm
매개변수를 포함해야 합니다. 입찰자의 인코딩되지 않은 쿠키 데이터가 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
매개변수가 리디렉션에 없습니다. 향후 이 사용자의 노출에 대한 입찰 요청에서 입찰자는 Google의 RTB 프로토콜의 경우 BidRequest.hosted_match_data
, Google의 OpenRTB 구현의 경우 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를 타겟팅하도록 구성된 입찰자가 구성된 사전 타겟팅을 통해 이제 입찰자가 사용자의 노출에 대한 입찰 요청을 받게 됩니다. 마찬가지로 이러한 입찰 요청에서 입찰자는 Google의 RTB 프로토콜의 경우 BidRequest.hosted_match_data
,
Google의 OpenRTB 구현의 경우 BidRequest.user.buyeruid
에서 호스팅된 일치 데이터를 수신합니다.