쿠키 매칭은 쿠키 일치를 가능하게 하는 기능으로 예를 들어 웹사이트를 둘러본 사용자의 ID를 Google 사용자 ID를 만들고, 광고를 만드는 데 도움이 되는 사용자 목록을 더 효과적인 입찰을 선택할 수 있습니다 이 가이드에서는 쿠키에서 사용되는 개념을 설명합니다. 매칭, 다양한 쿠키 매칭 워크플로 및 모든 변형 특정 사용 사례에 적용할 수 있습니다
<ph type="x-smartling-placeholder">개념
쿠키 일치란 무엇인가요?
도메인 소유자는 일반적으로 도메인 내에서 해당 도메인 내의 사용자를 식별하는 데 사용됩니다. 두 개라도 그렇지 않은 경우에는 도메인 소유자가 이 데이터를 교환하는 데 동의하지 않을 것이며, 사용자가 다른 브라우저에서 설정한 쿠키를 읽지 못하도록 제한하는 인터넷 브라우저의 비율 있습니다.
디지털 광고 측면에서 Google은 쿠키를 통해 사용자를 식별합니다.
doubleclick.net
도메인에 속한 입찰자
실시간 입찰에 참여하는 광고주는
광고를 게재할 사용자 집단 파악 쿠키 매칭
Google의 쿠키와 일치시켜서
입찰 요청에서 전송된 노출이
사용자는 자신의 쿠키 데이터 또는
입찰자별 Google 사용자 ID는
doubleclick.net
쿠키가 포함되어야 합니다.
이 가이드에 설명된 쿠키 매칭 서비스는 입찰자의 쿠키와 Google Ad Manager 간의 연결을 유지하고 사용자 ID이며 사용자 목록을 채울 수도 있습니다.
데이터 이동 색인
데이터 이동 색인을 사용하여 한 도메인의 ID 또는 기타 데이터를 있습니다. 입찰자는 쿠키 매칭 서비스를 사용하여 자체 사용자의 Google 계정에 쿠키 정보를 매핑하여 데이터 이동 색인 사용자 ID를 입력하거나 Google에서 호스팅하는 데이터 이동 색인을 채웁니다. 데이터 이동 색인은 사용자의 쿠키 데이터에 액세스하는 데 필요합니다. 자동으로 표시됩니다
Google에서 호스팅하는 데이터 이동 색인
보다 쉬운 유지보수, 지연 시간 개선, 일치하는 데이터 액세스를 위해 특정 지역의 사용자를 대상으로 하는 경우 Google이 데이터 이동 색인 이를 통해 웹 보안 base64 인코딩 문자열을 지정할 수 있습니다. 호스팅된 일치 데이터라고 하며, 지정된 사용자의 Google 사용자 ID입니다. 매칭이 설정되면 이를 다음과 같은 방식으로 사용됩니다.
실시간 입찰: 노출에 대한 후속 입찰 요청에서 Google은 귀하가 제공한 호스팅된 일치 데이터를 Google 사용자 ID와 일치합니다. 입찰 엔드포인트가 구성된 경우 Google의 RTB 프로토콜을 사용할 경우
<ph type="x-smartling-placeholder">BidRequest.hosted_match_data
필드 Google의 OpenRTBBidRequest.user.buyeruid
는 이 구현을 반환합니다. 데이터를 웹 보안 base64 인코딩 문자열로 반환합니다.사용자 목록: 사용자 목록을 채울 수 있습니다. Google 사용자 ID 또는 호스팅된 일치 데이터와 함께 사용합니다
<ph type="x-smartling-placeholder">- 사전 타겟팅: 입찰 요청만 수신하도록 사전 타겟팅을 구성할 수 있습니다. 포함된 데이터 세트입니다. 이를 통해 관련성이 낮은 노출의 영향을 받을 수 있습니다.
사용자 목록
사용자 목록은 실시간 입찰 API를 사용하여 만들고 관리할 수 있습니다. 목록이 만들어지면 쿠키 매칭 워크플로로 이러한 목록을 채울 수 있습니다. 일괄 업로더 서비스를 통해 업로드할 수 있습니다.
<ph type="x-smartling-placeholder">시작하기
쿠키 매칭을 시작하려면 기술계정 관리자(기술계정 관리자)가 다음과 같이 구성합니다.
- 쿠키 매칭 네트워크 ID (NID): 고유하게 식별하는 문자열 ID입니다. 쿠키 매칭 및 기타 관련 작업을 위한 입찰자 계정
- 쿠키 매칭 URL: 수락하는 엔드포인트의 기본 URL입니다. 쿠키 일치 워크플로의 일부로 수신 요청을 처리합니다. 입찰자는 이 URL에 매크로를 삽입하여 쿠키 일치 워크플로에서 여기에 전달되는 매개변수의 순서를 제어합니다.
- 일치 태그: 쿠키 매칭 워크플로를 사용할 수 있습니다. 이는 광고와 함께 게재할 수 있으며 광고 외부의 웹 서비스에 배치될 수 있습니다.
- 쿠키 일치 보고서 URL (선택사항): 단방향 쿠키 일치 워크플로에서 이 URL은 쿠키가 생성된 이벤트에서 오류 세부정보를 수신할 엔드포인트를 HTTP 302 리디렉션을 통해 매칭이 실패합니다 기본적으로 응답은 쿠키 일치 작업에 오류가 발생하면 이 URL로 전송됩니다. 입찰자는 리디렉션이 항상 전송되도록 요청할 수 있습니다.
- Cookie Match Assist URL: 쿠키 매칭 지원 워크플로에서는 수신 요청에 응답하려는 엔드포인트의 기본 URL입니다.
- 쿠키 일치 지원 할당량: 쿠키 매칭 지원 워크플로에서는 쿠키 일치 URL이 수신할 수 있는 최대 요청 수 둘째, 이는 CMA 요청이 Cloud CDN에 과부하되는 것을 방지하기 요청을 전송합니다.
쿠키 매칭 매크로
지원되는 쿠키 매칭 워크플로에서 일반적으로 입찰자의 쿠키 일치 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의 쿠키 매칭 서비스가
사용자의 브라우저에서 요청이 전송되면 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.google_user_id
를 통해 지정된 값에 해당합니다.
Google의 RTB 프로토콜에서 또는 BidRequest.user.id
를
OpenRTB 구현
google_cver
에 지정된 버전은 숫자로 표시된
Google 사용자 ID의 버전 번호입니다. 특정 사용자의 Google 사용자 ID는
드물게 변경되며 그 이후에는 증가합니다.
Google에서 일치 요청을 처리하는 동안 오류가 발생하면
대신 google_error
매개변수가 지정됩니다.
3단계: 입찰자가 리디렉션을 처리하고 픽셀로 응답
입찰자는 매개변수와 Google이 두 번째 단계입니다. 또한 HTTP(S) 쿠키에서 있습니다. 작업이 성공하면 입찰자가 자체 데이터 이동 색인을 호스팅하는 경우 응답에 포함된 Google 사용자 ID와 쿠키를 일치시킬 수 있습니다. 그것은 쿠키 일치 기능이 반환한 문자열을 정확히 저장하는 것이 좋습니다 서비스.
작업에 실패하면 입찰자에게 google_error
이 전송됩니다.
매개변수를 사용합니다. 이 값은 각 네임스페이스에 해당하는
발생한 특정 오류를 식별하는 오류 상태 자세한 내용은
여기에서 가능한 오류 값에 대해 자세히 알아보세요.
오류가 발생한 경우
새 일치 태그를 배치하지 마세요.
입찰자는 항상 1x1 크기의 보이지 않는 픽셀 이미지를 게재하여 응답해야 합니다.
또는 HTTP 204
No Content 응답을 반환합니다.
쿠키 매칭 워크플로 다이어그램
이 워크플로는 아래 다이어그램에 나와 있습니다. 화살표로 표시되며, 이에 수반되는 데이터 항목은 괄호 안에 표시됩니다.
![](https://google-developers.gonglchuangl.net/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=0&hl=ko)
일치 태그 URL 매개변수
매개변수 | 설명 |
---|---|
google_nid |
입찰자 계정의 네트워크 ID (NID)입니다. 이 ID를 가져올 수 있습니다. 입찰자 리소스도 제공합니다 |
google_cm |
Google의 쿠키 일치 서비스가 수행해야 함을 나타냅니다. 쿠키 매칭 매개변수 값은 무시되며 생략했습니다. |
google_sc |
이 매개변수는 지원 중단되었습니다. 다음에 대해 Google의 쿠키를 설정합니다. 사용자를 찾습니다. 매개변수 값은 무시되며 생략할 수 있습니다. 쿠키가 없는 경우 매개변수를 생략하면 오류가 발생합니다. 존재하지 않습니다. |
google_no_sc |
이 매개변수는 지원 중단되었습니다. 이는 쿠키 일치 서비스에서 사용자에게 쿠키를 설정해서는 안 됩니다. 나타냅니다. 매개변수 값은 무시되며 생략했습니다. |
google_hm |
입찰자가 Google에서 호스팅하는 데이터 이동 색인에 저장하려는 데이터
값은 웹 보안 base64 인코딩 문자열 (선택사항 패딩)입니다. 원시 데이터는 40이어야 함
바이트 이하이어야 합니다. 예를 들면 |
google_redir |
입찰자가 직접 연결할지 여부를 지정할 수 있는 URL 인코딩 문자열입니다.
Google은 HTTP 302 리디렉션을
이 일치 태그를 지정합니다. 이렇게 하면 Google이
통화할 수 있습니다. 이 매개변수를 지정하지 않고 지정하면 오류가 발생합니다.
google_hm 또는 google_cm 를 사용합니다. |
google_ula |
기존 사용자 목록에 사용자를 추가하는 데 사용되는 문자열입니다. 값의
올바른 형식은 userlistid[,timestamp] 입니다.
<ph type="x-smartling-placeholder">
이 URL 매개변수를 반복하여 사용자를 여러 할 수 있습니다. |
gdpr |
요청에 데이터에 대한 GDPR 제한이 적용됨을 나타냅니다.
사용합니다 자세한 내용은 을(를) 참조하세요.
아래의 EU 사용자 동의 요건 또는 쿠키 매칭에 미치는 영향
자격 요건을
<ph type="x-smartling-placeholder"></ph>
Authorized Buyers IAB TCF v2.0 문서를 참조하세요.
예: |
gdpr_consent |
최종 사용자 동의를 나타내는 TC 문자열입니다. 자세한 내용은 EU 사용자 동의 요건을 참고하세요. 또는 아래의 TC 문자열은 어떻게 전달되나요? <ph type="x-smartling-placeholder"></ph> Authorized Buyers IAB TCF v2.0 문서를 참조하세요. |
process_consent |
입찰자가
<ph type="x-smartling-placeholder"></ph>
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_
및 입찰자 정의 매개변수 포함)
일치 태그에 지정된 값에 따라 달라집니다. 다음 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
매개변수 - 쿠키 일치 서비스는 사용자의 Google 쿠키를 읽고 사용자의
FinestDSP의 쿠키 일치 URL로 리디렉션하도록
google_user_id
및google_cver
매개변수가 설정되었습니다. - 사용자의 브라우저가 FinestDSP의 쿠키 매칭 URL로 리디렉션을 로드합니다.
- FinestDSP의 쿠키 매칭 엔드포인트는 리디렉션 요청을 처리하고
여기에는 Google이 설정한 URL 매개변수와
HTTP 헤더. FinestDSP는 이제 쿠키의 매핑을
google_user_id
을(를) 데이터 이동 색인에 추가합니다. - FinestDSP는 보이지 않는 1x1 픽셀로 리디렉션에 응답합니다.
![](https://google-developers.gonglchuangl.net/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=0&hl=ko)
시나리오 2: 기존 매핑이 있는 사용자
시나리오 1이 발생한 지 일주일 후 사용자가 ExampleNews.com을 다시 방문했습니다. 이제 Jane님도 입찰자와 Ad Manager 쿠키가 모두 없는 경우 있습니다.
- 웹페이지가 렌더링되어 Google (Ad Manager)은 페이지에 렌더링됩니다.
- 광고 입찰 중에 Google은 입찰 요청을 여기에는 FinestDSP가 포함됩니다.
- FinestDSP는 다음과 같은 신호를 포함하여 입찰 요청을 수신합니다.
google_user_id
- FinestDSP는 데이터 이동 색인에서
google_user_id
를 조회합니다. 1주일 전에 생성된 Jane과 연결된 쿠키를 찾습니다. (시나리오 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의 쿠키 매칭 서비스로 리디렉션
입찰자의 쿠키 매칭 엔드포인트가 Google의 쿠키로 리디렉션되어야 함
일치 서비스, google_hm
매개변수가
웹 보안 base64로 인코딩된 쿠키 데이터를 저장합니다. 리디렉션 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이
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 투명 픽셀을 게재하여 있습니다.
개인 정보 보호 제한이 있는 미국 주의 사용자를 위한 쿠키 매칭 워크플로 다이어그램
다이어그램에는 개인 정보 보호 제한이 적용되는 미국 주의 사용자를 위한 기본 워크플로가 나와 있습니다. 아래에서 요청과 응답이 화살표로 표시되고 함께 제공되는 항목은 괄호 안에 표시됩니다.
![](https://google-developers.gonglchuangl.net/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=0&hl=ko)
Google의 쿠키 일치 서비스로 리디렉션되는 입찰자의 URL 매개변수
매개변수 | 설명 |
---|---|
google_nid |
입찰자 계정의 네트워크 ID (NID)입니다. 이 ID를 가져올 수 있습니다. 입찰자 리소스도 제공합니다 |
google_sc |
이 매개변수는 지원 중단되었습니다. 다음에 대해 Google의 쿠키를 설정합니다. 사용자를 찾습니다. 매개변수 값은 무시되며 생략할 수 있습니다. 쿠키가 없는 경우 매개변수를 생략하면 오류가 발생합니다. 존재하지 않습니다. |
google_no_sc |
이 매개변수는 지원 중단되었습니다. 이는 쿠키 일치 서비스에서 사용자에게 쿠키를 설정해서는 안 됩니다. 나타냅니다. 매개변수 값은 무시되며 생략했습니다. |
google_hm |
입찰자가 Google에서 호스팅하는 일치에 저장하려는 데이터가 포함됨 표에서 볼 수 있습니다. |
google_redir |
Google에서 HTTP 302 리디렉션을 보내도록 할 인코딩된 URL입니다. 이
지정된 URL은 google_error
매개변수를 사용하세요. |
google_ula |
기존 사용자 목록에 사용자를 추가하는 데 사용되는 문자열입니다. 값의
올바른 형식은 userlistid[,timestamp] 입니다.
<ph type="x-smartling-placeholder">
이 URL 매개변수를 반복하여 사용자를 여러 할 수 있습니다. |
gdpr |
요청에 데이터에 대한 GDPR 제한이 적용됨을 나타냅니다.
사용합니다 자세한 내용은 을(를) 참조하세요.
아래의 EU 사용자 동의 요건 또는 쿠키 매칭에 미치는 영향
자격 요건을
<ph type="x-smartling-placeholder"></ph>
Authorized Buyers IAB TCF v2.0 문서를 참조하세요.
예: |
gdpr_consent |
최종 사용자 동의를 나타내는 TC 문자열입니다. 자세한 내용은 EU 사용자 동의 요건을 참고하세요. 또는 아래의 TC 문자열은 어떻게 전달되나요? <ph type="x-smartling-placeholder"></ph> Authorized Buyers IAB TCF v2.0 문서를 참조하세요. |
process_consent |
입찰자가
<ph type="x-smartling-placeholder"></ph>
Google의 EU 사용자 동의 정책.
요청에 EU 사용자 동의 정책이 적용되지 않거나
요청에 사용할 수 있는 다른 동의 매개변수
( 예: |
입찰자의 쿠키 일치 보고서 URL로 Google 리디렉션하기 위한 URL 매개변수
매개변수 | 설명 |
---|---|
google_error |
전체 요청 오류를 나타내는 정수 값입니다. 날짜
작업이 수행되지 않았으며
응답 매개변수
|
Google에서 시작한 경우: 양방향 픽셀 일치
양방향 픽셀 매칭은 Google의 쿠키 매칭 워크플로입니다. Google이 알고리즘을 통해 Google 사용자 ID와 일치시키려고 시도하는 서비스 실시간 입찰 낙찰자가 아닌 선택된 입찰자를 대상으로 합니다. 광고가 Google은 사용자의 브라우저에 투명 픽셀을 처리합니다. 이렇게 하면 특정 사용자로 데이터 이동 색인을 채울 수 있습니다. 다음은 이 워크플로의 간단한 예시를 살펴보겠습니다.
1단계: Google에서 일치 태그 배치
참여 게시자의 페이지가 사용자의 브라우저에 로드되고
페이지의 광고 슬롯이 Google에 의해 채워지는 경우 일치 태그를
알고리즘에 따라 선택된 입찰자에게 픽셀을 요청합니다. 픽셀 매칭
태그는 입찰자의 쿠키 일치 URL과
추가 매개변수를 사용해
사용하여 데이터 이동 색인을 채울 수 있습니다. 쿠키 매칭 URL의 경우
https://ad.network.com/pixel
로 지정된 경우 다음과 같이 구조화됩니다.
다음과 같습니다.
<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은
입찰자가 시작한 쿠키 매칭 워크플로에 대한 일치 태그도 사용할 수 있습니다.
픽셀 일치에서 google_cm
매개변수는
google_push
매개변수이며 값은 값과 같아야 합니다.
Google에서 제공한 정보와 일치해야 합니다. 또한 입찰자가 시작한
워크플로, 추가 매개변수
추가 사용 사례를 충족하기 위해 지정할 수 있습니다.
3단계: Google에서 리디렉션을 처리하고 픽셀로 응답
Google은 사용자에 대해 일치 항목이 생성되었음을 기록하고 쿼리 매개변수를 통해 요청된 추가 작업 수, 마지막으로 Google은 1x1 투명 픽셀로 구성됩니다.
픽셀 일치 워크플로 다이어그램
이 워크플로는 아래 다이어그램에 나와 있습니다. 화살표로 표시되며, 이에 수반되는 데이터 항목은 괄호 안에 표시됩니다.
![](https://google-developers.gonglchuangl.net/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=0&hl=ko)
Google 일치 태그 요청 매개변수
매개변수 | 설명 |
---|---|
google_gid |
Google 사용자 ID입니다. 개인 정보 보호 제한이 적용되는 미국 주가 아닌 사용자의 경우 항상 지정할 수 있습니다. |
google_cver |
쿠키 버전입니다. 항상 Google의 일치 항목에 지정됩니다. 태그 사이에 있어야 합니다. |
google_push |
이 요청이 픽셀 일치 워크플로를 시작함을 나타냅니다. 이 값은 입찰자의 리디렉션 응답을 반환합니다. |
입찰자 픽셀 일치 리디렉션 매개변수
매개변수 | 설명 |
---|---|
google_nid |
입찰자 계정의 네트워크 ID (NID)입니다. 이 ID를 가져올 수 있습니다. 입찰자 리소스도 제공합니다 |
google_push |
이 리디렉션이 픽셀 일치를 완료함을 나타냅니다. 워크플로에 따라 다릅니다. 해당하는 Google 일치 태그의 값은 여기에 지정됩니다 |
google_hm |
입찰자가 Google에서 호스팅하는 일치에 저장하려는 데이터가 포함됨 표에서 볼 수 있습니다. |
google_ula |
기존 사용자 목록에 사용자를 추가하는 데 사용되는 문자열입니다. 값의
올바른 형식은 userlistid[,timestamp] 입니다.
<ph type="x-smartling-placeholder">
이 URL 매개변수를 반복하여 사용자를 여러 할 수 있습니다. |
Google에서 시작한 단방향 픽셀 매칭
단방향 픽셀 일치는 Google의 일치 태그에 Google 사용자를 지정하는 매개변수가 포함되어 있지 않음 ID가 채워지지만 Google에서 호스팅하는 데이터 이동 색인은 계속 채워집니다. 이는 입찰자가 자체 데이터 이동 색인을 생성합니다. 변경된 워크플로에 대한 간단한 예는 다음 표에 요약되어 있습니다. 단계를 따르세요.
1단계: Google에서 일치 태그 배치
Google은 알고리즘 방식으로 선택된 입찰자에 대해 일치 태그를 배치합니다. 일치 태그에는
google_push
매개변수 예를 들면 다음과 같습니다.
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
2단계: 사용자의 브라우저가 입찰자의 요리 일치 URL에서 픽셀을 요청
사용자의 브라우저가 입찰자의 쿠키 일치 URL에서 픽셀을 요청합니다. HTTP 헤더에 입찰자의 쿠키를 포함합니다.
3단계: Google 쿠키 매칭 서비스로 리디렉션
입찰자의 쿠키 매칭 엔드포인트가 Google의 쿠키로 리디렉션되어야 함
일치 서비스, google_hm
매개변수가
웹 보안 base64로 인코딩된 쿠키 데이터를 저장합니다. 리디렉션 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.hosted_match_data
에서 입찰자가 호스팅하는 일치 데이터
Google 프로토콜 또는 BidRequest.user.buyeruid
(Google의 경우)
OpenRTB 구현 입찰자는 또한 호스팅된
지정한 데이터와 일치합니다.
마지막으로 Google은 사용자 브라우저에 1x1 투명 픽셀을 반환합니다.
쿠키 매칭 지원
공개 입찰을 통해 거래소는 입찰자가 시작한 입찰 방식을 사용할 수 있음 Google에서 쿠키 매칭 워크플로를 사용하여 Google 사용자 ID를 쿠키와 일치시킵니다. 쿠키 Match Assist (CMA)는 거래소에서 사용할 수 있는 추가 기능으로 자체 입찰자로 데이터 이동 색인을 생성할 수 있습니다
쿠키 매칭 지원의 작동 방식
광고를 게재할 때 Google이 알고리즘에 따라 참여 중인 광고를 선택합니다. 다음과 같은 쿠키 일치 지원 태그를 구조:
드림<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
Google의 CMA 일치 태그로 인해 거래소의 쿠키 일치 URL이 픽셀 요청을 수신합니다.
- 거래소의 쿠키 매칭 엔드포인트가 요청을 수신합니다. 여기서 자체 쿠키 매칭 서비스가 사용자 ID를 입찰할 수 있습니다. 아래 다이어그램에서 거래소의 쿠키 매칭은 사용자의 브라우저에 대해 입찰자의 엔드포인트가 있습니다
- 입찰자는 사용자 ID를 쿠키와 일치시킵니다.
![](https://google-developers.gonglchuangl.net/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=0&hl=ko)
제한사항
새 일치 요청 빈도 제한
입찰자는 쿠키에 대한 호출 수를 제한할 책임이 있습니다. Google에서 호스팅하는 매치에 새로 항목이 있는 사용자를 위한 매칭 서비스 표에서 볼 수 있습니다. 호스팅된 데이터 이동 색인의 항목은 14일 후에 만료된 것으로 간주될 수 있습니다. 그 후에는 새로고침할 수 있습니다
<ph type="x-smartling-placeholder">모든 픽셀 일치 요청에 응답
픽셀 일치 워크플로를 사용하는 입찰자는
google_push
를 포함하는 응답과 함께 수신되는 Pixel Match 요청
매개변수 값으로 사용됩니다. 이렇게 하면 Google에서 사용량을 모니터링하여 정책을 시행할 수 있습니다. 만약
입찰 응답률이 90% 아래로 떨어지면 Google에서
계정으로 전송된 픽셀 일치 요청
HTTPS 엔드포인트 사용
모든 쿠키 매칭 워크플로에서 사용되는 엔드포인트는 HTTPS를 사용합니다.
HTTPS를 통해 전송된 픽셀 일치 요청에 응답할 때 다음을 수행하게 됩니다. 쿠키 일치 서비스로 리디렉션하는 데 필요합니다. 마찬가지로 입찰자로 리디렉션되는 쿠키 매칭 지원 엔드포인트도 HTTPS를 사용해야 합니다. 2분마다 한 번 이상 HTTP를 통해 Google에 요청을 보내는 경우 계정에 전송되는 일치 요청 수가 제한됩니다.
EU 사용자 동의 요건
Google EU 사용자 동의 정책에는 최종 사용자 동의를 표시해야 합니다. 이러한 요청은 다음 방법 중 하나를 사용하여 동의가 수집되었음을 나타냅니다.
- TCFv2:
gdpr
및gdpr_consent
가 포함됩니다. 매개변수입니다. 자세한 내용은 <ph type="x-smartling-placeholder"></ph> 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_gid
매개변수는 다음과 같이 리디렉션에 없습니다.
일치 태그에 google_cm
이(가) 포함되지 않았으며 google_hm
이(가)
포함되지 않습니다. 노출에 대한 향후 입찰 요청
입찰하는 경우 입찰자는
BidRequest.hosted_match_data
: Google의 RTB 프로토콜용
Google의 OpenRTB 구현: BidRequest.user.buyeruid
입찰자가
google_hm
이 base64로 인코딩되지 않았습니다. 예를 들면 다음과 같습니다.
chocolate_chunk!
: 리디렉션 URL은 다음과 같이 표시될 수 있습니다.
있습니다.
https://cookie-monster.com/pixel?google_hm=2
위의 리디렉션 URL에는google_hm
2
: 값이 다음과 같은 이유로 작업이 실패했음을 나타냅니다.
디코딩되지 않습니다.
사용자 목록이 포함된 입찰자 및 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 사용자 ID와
google_gid
에서 데이터 이동 색인에 쿠키 데이터를 포함합니다. 포함
또한 Google이 호스팅하는 데이터 이동 색인과 사용자 목록이
작업이 성공했습니다. 그 결과, 해당 입찰자를 사전 타겟팅한
지정된 사용자 목록 ID를 타겟팅하도록 구성된 경우 입찰자가
사용자로부터 노출에 대한 입찰 요청을 받게 됩니다. 마찬가지로 이러한 입찰가에서
입찰하는 경우 입찰자는
BidRequest.hosted_match_data
: Google의 RTB 프로토콜용
Google의 OpenRTB 구현: BidRequest.user.buyeruid