다음은 웹사이트와 동일한 퍼스트 파티 컨텍스트에서 서버 측 태그 지정을 호스팅하려는 개발자를 위한 도움말입니다. 동일한 소스에서 제공은 서버 측 쿠키의 보안 및 내구성 이점을 활용할 수 있는 권장사항입니다. 아래 안내는 사이트에 배포된 Google 태그 (gtag.js 또는 gtm.js)와 관계없이 동일 출처 게재 설정에 적용됩니다.
태그 지정 서버를 처음 설정하면 클라우드 제공업체에서 제공하는 도메인에 호스팅됩니다. 기본 엔드포인트를 사용하면 서버 컨테이너에 데이터를 전송하지만 서드 파티 컨텍스트에서 실행됩니다. 내구성이 뛰어난 쿠키와 같은 퍼스트 파티 컨텍스트의 이점을 활용하려면 태그 관리 서버와 웹사이트가 동일한 도메인에서 실행되어야 합니다.
아래 표는 상위 웹사이트가 www.example.com에 호스팅된 경우 태그 지정 서버를 호스팅하는 방법을 보여줍니다.
| 동일한 출처 (권장사항) | 하위 도메인 | 기본 도메인 | |
|---|---|---|---|
| URL 예시 | https:/ |
https:/ |
https:/ |
| 서버 설정 쿠키 액세스 | 보안 및 내구성 혜택을 모두 이용할 수 있습니다. | 보안 및 내구성 혜택을 모두 이용할 수 있습니다. | 없음. JavaScript 쿠키만 설정할 수 있습니다. |
| 설정 복잡성 | 요청을 전달하도록 CDN 또는 부하 분산기를 구성합니다. DNS 항목을 업데이트해야 할 수 있습니다. | DNS 항목을 업데이트합니다. | 사전 구성되어 제공됩니다. |
시작하려면 구현 옵션을 선택합니다.
기본 요건
이 가이드에서는 다음 작업을 이미 완료했다고 가정합니다.
- 태그 관리자에서 서버 컨테이너 설정
- 태그 관리 서버 설정
- 요청을 전달할 수 있는 CDN 또는 부하 분산기
- App Engine을 사용하는 경우: 태그 지정 서버는 버전 2.2.0 이상을 실행해야 합니다. 태그 지정 서버를 미래에 대비하려면 Cloud Run으로 이전하세요.
커스텀 도메인 구성
웹사이트와 동일한 도메인의 경로에서 실행되도록 서버 컨테이너를 설정할 수 있습니다. 예를 들어 웹사이트에서 www.example.com의 웹 트래픽을 제공하는 경우 서버 컨테이너에 www.example.com/metrics와 같은 경로를 예약합니다.
1. 태그 관리 서버에 사용할 도메인 경로 선택
이 경로는 이 퍼스트 파티 게재 구현을 위해 예약됩니다. 아직 사용하지 않는 경로를 선택해야 합니다.
사용할 수 있는 경로의 예로는 /collect, /metrics, /data가 있습니다.
이 경로 문자열을 기록해 둡니다. 후속 단계에서 /metrics가 표시될 때마다 /metrics 대신 사용합니다.
2. 태그 관리 서버로 트래픽 라우팅
경로별 트래픽 라우팅을 지원하는 CDN 또는 부하 분산기가 이미 웹사이트에 설정되어 있는 경우 4단계로 건너뜁니다.
- 웹사이트를 가리키는 원본 또는 백엔드를 추가합니다.
- 호스트 헤더를 웹사이트의 호스트 이름(예:
example.com)으로 재정의합니다. - 모든 쿠키와 쿼리 문자열이 전달되도록 허용합니다. 플랫폼에 이 옵션이 없으면 기본적으로 이 옵션이 실행될 가능성이 높습니다.
- 태그 관리 서버를 가리키는 다른 원본 또는 백엔드를 추가합니다. 클라우드 제공업체가 제공한 도메인(예:
metrics.run.app)일 수 있습니다. - 호스트 헤더를 위에 지정된 도메인과 같은 이름으로 재정의합니다. 모든 쿠키와 쿼리 문자열이 전달되도록 허용합니다.
/metrics/*와 같은 경로 규칙을 추가하여 트래픽을 태그 관리 서버로 라우팅합니다.- 예약된 서버 측 태그 지정 경의 우선순위가 기본 규칙보다 높도록 구성합니다.
- 아직 CDN 또는 부하 분산기를 가리키도록 DNS를 업데이트하지 않았다면 업데이트합니다. DNS 업데이트가 전파되는 데 다소 시간이 걸릴 수 있습니다.
- 방금 설정한 도메인의
/healthy엔드포인트(예:https://example.com/metrics/healthy)로 이동합니다.ok가 표시됩니다.
3. Google 태그 관리자에서 서버 URL 업데이트
경로 접두사를 식별하고 요청을 올바르게 처리할 수 있도록 서버 컨테이너 구성을 업데이트해야 합니다.
새 엔드포인트로 업데이트하려면 다음 단계를 따르세요.
- Google 태그 관리자 열기
- 웹사이트와 동일한 출처에 설정된 서버 컨테이너를 엽니다.
- 관리 탭 > 컨테이너 설정에서 이전 URL을 모두 삭제합니다. 모든 서버 컨테이너 URL이 동일한 경로를 공유해야 하므로 이 작업이 필요합니다.
- URL 추가를 클릭하고 경로 접두사를 포함한 URL을 입력합니다.
- 저장 후 작업공간으로 돌아갑니다.
- 미리보기 버튼을 클릭하여 새 디버그 세션을 시작하고 별도의 탭에서 요청을 보냅니다.
- 전송된 요청을 클릭합니다. 클라이언트에서 수신 요청을 클레임하는지 확인합니다.
일반적인 문제 해결
- 미리보기에 수신 요청이 표시되지 않음
- 클라우드 프로젝트의 로그 탐색기로 이동합니다. 서버 측 태그 지정 배포가 트래픽을 수신하는지 확인합니다. 그렇지 않은 경우 1단계의 안내를 따르세요.
- CDN 또는 부하 분산기가 쿠키를 전달하는지 확인합니다.
- 미리보기 서버가 하나이고 태그 관리 서버에
PREVIEW_SERVER_URL가 설정되어 있는지 확인합니다. PREVIEW_SERVER_URL+/healthy로 이동하여 미리보기 서버가 실행 중인지 확인합니다.ok가 표시됩니다.
- 클라이언트가 요청을 소유하지 않음 - 예약된 경로를 사용하도록 컨테이너 설정의 URL을 업데이트합니다. URL에 경로가 포함되어 있지 않거나 경로가 다른 경우 클라이언트가 올바르게 작동하지 않습니다.