변환을 사용하여 태그에 사용할 수 있는 이벤트 매개변수 제어

이 문서는 태그에 노출되는 이벤트 매개변수를 관리해야 하는 서버 측 태그 지정 사용자를 대상으로 합니다.

서버 측 컨테이너에는 수신되는 HTTP 요청을 수락하는 클라이언트가 포함되어 있습니다. HTTP 요청의 정보는 이벤트 데이터 객체로 변환됩니다. 서버 측 태그가 이벤트 데이터 객체를 읽습니다.

변환이란?

변환을 사용하면 클라이언트에서 출력된 이벤트 매개변수가 태그에 노출되기 전에 포함, 제외 또는 수정할 수 있습니다. 변환을 사용하면 민감한 정보를 보호하고 추가 처리에 사용할 수 있는 이벤트 매개변수를 세밀하게 관리할 수 있습니다.

변환을 사용하면 다음과 같은 규칙을 만들 수 있습니다.

• 태그를 사용해 명시적으로 정의된 이벤트 매개변수만 공유할 수 있습니다.
• 이벤트 매개변수를 수정하거나 추가하는 규칙을 만들어 이벤트 매개변수를 보강합니다.
• 태그에서 이벤트 매개변수를 제외하여 수신 정보를 수정합니다.

모든 태그, 태그 유형 전체 또는 개별적으로 선택한 세트에 변환을 적용할 수 있습니다. 또한 변환이 실행되기 전에 충족해야 하는 여러 조건을 적용할 수 있습니다.

변수는 변환이 실행될 때마다 평가됩니다. 변환이 수행하는 작업에 따라 변수가 다른 값으로 확인될 수 있습니다.

태그가 이벤트 매개변수를 사용하도록 허용

매개변수 허용 변환을 사용하면 태그에 노출할 특정 이벤트 매개변수를 지정할 수 있습니다. 명시적으로 정의되지 않은 이벤트 매개변수는 삭제됩니다.

주의: 매개변수 허용 변환은 명시적으로 지정되지 않은 모든 이벤트 매개변수 (Google 태그에 필요한 값 포함)를 삭제합니다. 이 변환을 생성하기 전에 태그에서 사용하는 이벤트 매개변수를 검사하고 필요한 모든 이벤트 매개변수를 포함해야 합니다. 그렇지 않으면 측정이 손상될 수 있습니다. 자세한 내용은 이벤트 데이터 참조 및 측정 프로토콜 이벤트를 참조하세요.

태그가 특정 이벤트 매개변수를 사용하도록 허용하는 방법은 다음과 같습니다.

1. 작업공간에서 변환 메뉴를 엽니다.
2. 새 변환 규칙을 만듭니다.
3. 변환 구성을 클릭하고 매개변수 허용을 선택합니다.
4. 태그가 사용할 수 있는 이벤트 매개변수를 추가합니다. 모든 일반적인 이벤트 매개변수를 참고하세요.
5. 선택사항: 일치 조건을 사용하면 변환을 활성화할 시점에 대한 규칙을 정의할 수 있습니다. 기본적으로 변환 규칙은 항상 적용됩니다.
6. 영향을 받은 태그에서 이 변환 규칙에 응답하는 태그 유형 또는 개별 태그를 선택합니다. 기본적으로 변환은 모든 태그에 적용됩니다.
7. 변환 규칙의 이름을 지정하고 저장합니다.

예: 선별된 정보를 BigQuery 테이블에 로그

로그하는 매개변수를 관리해 다음과 같은 효과를 거둘 수 있습니다.

• 민감한 정보가 내부 데이터 스토어에 로그되지 않습니다.
• 오버 로깅을 방지하여 스토리지 및 클라우드 비용을 절약할 수 있습니다.
• 모니터링 및 보고를 위한 관련 측정항목을 저장할 수 있습니다.

실행 방법

특정 매개변수만 로그되도록 하려면 다음과 같이 합니다.

1. 새 변환 규칙을 만듭니다.
2. 변환 구성을 클릭하고 매개변수 허용을 선택합니다.
3. 허용할 매개변수에서 필요한 매개변수(예: event_name, page_hostname, page_path, client_id 등)를 추가합니다.
4. 영향을 받은 태그에서 데이터 웨어하우스로 데이터를 보내는 태그를 선택합니다. BigQuery의 경우 맞춤 태그에서 addEventCallback 및 BigQuery APIs를 사용하거나 커뮤니티 템플릿 갤러리에서 서버 컨테이너를 모니터링하기 위한 사전 빌드된 옵션을 탐색할 수 있습니다.
5. 변환의 이름을 지정하고 저장합니다. 다음과 같이 표시됩니다.

이벤트 매개변수 보강

이벤트 보강 변환을 사용하면 이벤트 매개변수의 값을 수정하거나 태그에 사용할 수 있는 새 매개변수를 추가할 수 있습니다.

주의: 태그가 사용하는 매개변수를 수정하면 태그가 예상대로 작동하지 않을 수 있습니다. 매개변수를 보강하기 전에 태그가 사용하는 매개변수를 확인하세요.

특정 이벤트 매개변수를 수정하거나 추가하는 방법은 다음과 같습니다.

1. 작업공간에서 변환 메뉴를 엽니다.
2. 새 변환 규칙을 만듭니다.
3. 변환 구성을 클릭하고 이벤트 보강을 선택합니다.

4. 보강할 매개변수에서 다음과 같이 처리합니다.

   • 기존 이벤트 매개변수를 수정하려면 이름에 수정할 매개변수를 입력하고 새 값을 추가합니다. 모든 일반적인 이벤트 매개변수를 참고하세요.

   • 새 이벤트 데이터 객체 값을 추가하려면 원하는 이름 및 변수를 입력합니다.

5. 선택사항: 일치 조건을 사용하면 변환을 활성화할 시점에 대한 규칙을 정의할 수 있습니다. 기본적으로 변환 규칙은 항상 적용됩니다.

6. 영향을 받은 태그에서 이 변환 규칙에 응답하는 태그 유형 또는 개별 태그를 선택합니다. 기본적으로 변환은 모든 태그에 적용됩니다.

7. 변환 규칙의 이름을 지정하고 저장합니다.

예: 구매 이벤트에 대한 가치 기반 입찰 설정

가치 기반 입찰은 광고비 지출액을 최적화해 캠페인 실적을 개선하여 비즈니스에 더 큰 가치를 지닌 사용자를 타겟팅하는 데 도움이 됩니다. 가치 기반 입찰을 설정하면, Google Ads에서 전환 가치를 사용하여 더 가치 있는 입찰가를 설정합니다. 이벤트 보강 변환은 서버 측에서 가치 기반 입찰을 설정하는 데 유용합니다.

실행 방법

다음 안내는 Google Ads 전환 추적 태그가 전환 가치를 지정하지 않는 경우에만 적용됩니다.

가치 기반 입찰을 설정하는 방법은 다음과 같습니다.

1. 새 변환 규칙을 만듭니다.
2. 변환 구성을 클릭하고 이벤트 보강을 선택합니다.
3. 보강할 매개변수에서 새 행을 추가합니다. 항목의 금전적 가치를 변환에 로드하도록 변수를 설정합니다.
   1. 매개변수 이름에 조정할 값의 이름(예: value)을 입력합니다. 모든 value 필드는 이벤트의 금전적 가치를 나타내므로 대체합니다.
   2. 값 매개변수에 데이터베이스에서 가격을 검색하는 변수를 구성합니다. 예를 들어 Firestore에 제품 데이터를 저장하는 경우 Firestore 조회 변수를 추가합니다.
4. 일치 조건에서 이 변환이 특정 이벤트에만 적용되도록 설정합니다. 구매 이벤트에만 가치 기반 입찰을 적용하려면 {{Event Name}}과 purchase를 같음으로 설정합니다.
5. 영향을 받은 태그에서 이 변환이 적용되어야 하는 모든 Google Ads 전환 추적 태그를 추가합니다.
6. 태그의 이름을 지정하고 저장합니다. 다음과 같이 표시됩니다.

태그에서 이벤트 매개변수 제외

매개변수 제외 변환은 태그에서 특정 이벤트 매개변수를 제거하는 데 유용합니다.

주의: 필요한 매개변수가 제외되면 태그가 예상대로 작동하지 않을 수 있습니다. 매개변수를 변환하기 전에 태그가 어떤 매개변수를 사용하는지 확인하세요.

특정 이벤트 매개변수를 사용하는 태그를 제외하는 방법은 다음과 같습니다.

1. 작업공간에서 변환 메뉴를 엽니다.
2. 새 변환 규칙을 만듭니다.
3. 변환 구성을 클릭하고 매개변수 제외를 선택합니다.
4. 태그가 사용할 수 없는 이벤트 매개변수를 추가합니다. 모든 일반적인 이벤트 매개변수를 참고하세요.
5. 선택사항: 일치 조건을 사용하면 변환을 활성화할 시점에 대한 규칙을 정의할 수 있습니다. 기본적으로 변환 규칙은 항상 적용됩니다.
6. 영향을 받은 태그에서 이 변환 규칙에 응답하는 태그 유형 또는 개별 태그를 선택합니다. 기본적으로 변환은 모든 태그에 적용됩니다.
7. 변환 규칙의 이름을 지정하고 저장합니다.

예: 사용자 동의 여부에 따라 일부 GA4 맞춤 측정기준 제외

매개변수 제외를 사용하면 Google로 전송되는 퍼스트 파티 데이터를 관리할 수 있습니다. 예를 들어 사용자가 analytics_storage 쿠키를 거부하는 경우 일부 맞춤 측정기준을 제거할 수 있습니다.

실행 방법

맞춤 측정기준을 삭제하는 방법은 다음과 같습니다.

1. 새 변환 규칙을 만듭니다.
2. 변환 구성을 클릭하고 매개변수 제외를 선택합니다.
3. 제외할 매개변수에서 새 행을 추가하고 제외할 맞춤 측정기준(예: payment_type, payment_status)을 설정합니다.
4. 일치 조건에서 사용자가 analytics_storage 쿠키를 거부하는 경우에만 변환이 적용되도록 설정합니다.
   다음 조건 양식:
   • {{gcs}}가 G100과 같음
   • {{gcs}}가 G110과 같음
5. 선택사항: 영향을 받은 태그에서 이 변환이 적용되어야 하는 모든 태그를 추가합니다.
6. 태그의 이름을 지정하고 저장합니다. 다음과 같이 표시됩니다.

변환 규칙 적용 여부 확인

작업공간을 미리 보고 변환 규칙을 확인할 수 있습니다.

1. 웹사이트를 엽니다.

2. Google 태그 관리자 서버 컨테이너에서 미리보기를 선택합니다.

   Tag Assistant가 시작되고 서버 컨테이너가 로드됩니다.

3. 이벤트에 대해 실행된 모든 태그와 작업을 보려면 왼쪽 목록에서 이벤트 이름을 선택합니다.

다음과 같이 변환이 실행되었는지 확인할 수 있습니다.

1. 확인하려는 이벤트에서 태그 탭을 엽니다.

2. 실행된 태그를 선택하여 태그 속성, 전송된 HTTP 요청, 실행 트리거, 변환을 확인합니다.

   참고: 변환은 실행된 태그에만 영향을 줍니다. 변환으로 인해 필수 이벤트 매개변수 필드가 수정되거나 삭제되는 경우 태그가 실행되지 않을 수 있습니다.

3. 태그 세부정보 개요는 태그에 대해 실행된 변환과 순서를 보여줍니다. 기본 순서는 다음과 같습니다.

   1. 매개변수 허용
   2. 매개변수 보강
   3. 매개변수 제외
   팁: 변환에 우선순위 값을 할당하여 기본 순서를 변경할 수 있습니다. 값이 높을수록 우선순위가 높습니다.

   

4. 변환 세부정보를 보려면 변환을 클릭합니다. 태그에 제공된 이벤트 매개변수는 이벤트 데이터 섹션 아래에 표시됩니다.

   

5. 이벤트 데이터 상자를 클릭하면 모든 변환이 실행된 후의 이벤트 매개변수 상태를 볼 수 있습니다. 원본 이벤트 데이터와 변환된 이벤트 매개변수를 모두 보려면 원본 보기를 선택합니다.