이 페이지에서

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

Google 태그 관리자(클라이언트)

이것은 Amplitude 애널리틱스를 위한 클라이언트측 Google 태그 관리자(GTM) 템플릿입니다. 이 태그는 데이터 수집을 위해 Amplitude Browser SDK 2.0을 사용합니다.

버전 240a7의 중단 변경 사항 체크리스트

2023년 8월 240a7버전 부터 이 템플릿은 더 나은 지원, 향상된 기능 및 추가 기능을 제공하는 마케팅 분석 SDK(사용 중지됨) 대신 Amplitude Browser SDK 2.0을 사용합니다.

이 업데이트된 템플릿은 추가 기능과 개선 사항을 제공하지만 기존 분석 차트에 영향을 줄 수 있는 다른 동작을 초래할 수 있습니다. 일관성을 유지하기 위해 이러한 변경 사항을 활성화하거나 비활성화할 수 있습니다. 기존 동작을 유지하려면 다음 중단 변경 사항 목록을 검토하고 구성을 조정하십시오.

중단 변경 사항 체크리스트에서 중단 변경 사항 체크리스트를 참조하십시오.

향상된 기능 세트, 중요한 버그 수정, 향상된 사용자 경험을 위해 Amplitude GTM 템플릿을 지속적으로 최신 버전으로 업데이트하십시오.

컨테이너 만들기

새로운 구현을 작업하고 있다면 먼저 컨테이너를 구성하세요.

  1. 사이트의 URL을 사용하여 컨테이너의 이름을 지정합니다.
  2. Web대상 플랫폼을 선택합니다.
  3. 생성을 클릭합니다.

템플릿 추가

작업공간 탭에서 템플릿을 클릭합니다. 태그 템플릿 섹션에서 갤러리 검색을 클릭합니다. Amplitude를 검색하고 Amplitude 분석 Browser SDK를 선택합니다. 작업 공간에 추가를 클릭하고 커뮤니티 템플릿을 추가할 것을 확인합니다.

태그 생성

태그 탭으로 이동합니다. 새로 만들기를 클릭하고 Amplitude 애널리틱스 Browser SDK 템플릿을 선택합니다.

태그 구성

인스턴스 이름

각각 별도의 API 키 또는 초기화 옵션이 있는 둘 이상의 Amplitude 인스턴스를 실행하려는 경우, 각 인스턴스에 Instance Name를 할당하십시오. Amplitude는 태그를 동일한 것과 연결하고 해당 Instance Name에 대해 Initialization 태그의 API 키를 사용합니다Instance Name.

이 접근 방식은 또한 시스템에 여러 버전의 Amplitude SDK가 공존하는 경우 이벤트 누락을 방지할 수 있습니다.

사용자 지정 HTML 태그에서 인스턴스에 amplitude액세스할 수 있습니다.

js
// For amplitude-js-gtm@3.1.4 and above
amplitudeGTM.getDeviceId();
// Others
amplitude.getDeviceId();

사용자 정의된 인스턴스 이름 사용

js
// For amplitude-js-gtm@3.1.4 and above
amplitudeGTM._iq["yourInstanceName"].getDeviceId();
// Others
amplitude._iq["yourInstanceName"].getDeviceId();

태그 유형 선택

태그 유형을 사용하면 응용 프로그램에서 추적할 동작이나 이벤트의 유형을 지정할 수 있습니다. Amplitude GTM 템플릿에서는 다음과 같은 태그 유형을 지원합니다.

초기화

init 는 사용자가 생성해야 하는 별도의 태그 유형으로 작동합니다. Amplitude는 지연된 초기화를 제공하지만, Amplitude는 init태그가 실행될 때까지 이벤트를 수신하지 않습니다.

Amplitude는 초기화 단계에서 쿠키를 생성합니다. 쿠키 관리에 대한 자세한 내용은 쿠키 관리 세부 정보를 참조하십시오. Amplitude는 쿠키 동의를 얻은 후 초기화할 것을 권장합니다. Amplitude는 지연된 초기화를 지원하며 init명령 이전에 발생한 모든 이벤트를 캡처합니다.

API 키

API 키 필드에 Amplitude 프로젝트 API 키를 복사하세요. EU 거주자의 경우 프로젝트 API 키는 analytics.eu.amplitude.com에 있습니다. 각 프로젝트마다 다른 API 키가 있으므로 올바른 프로젝트에서 API 키를 복사해야 합니다. 설정 > 프로젝트 > 목록에서 올바른 프로젝트 이름을 클릭하여 프로젝트 API 키를 찾습니다. 자세한 내용은 API 인증을 참조하세요.

자동 캡처 옵션

다음 이벤트 유형에 대해 자동 캡처를 활성화하려면 자동 캡처 이벤트를 활성화하십시오.

  • 마케팅 기여도 분석을 추적합니다.
  • 페이지 뷰 추적.
  • 세션 추적.
  • 양식 상호 작용을 추적합니다.
  • 파일 다운로드를 추적합니다.
  • 요소 상호 작용을 추적합니다.

자세한 내용은 브라우저 SDK 2 - 자동 캡처를 참조하십시오.

GTM 템플릿 버전 5d7e5부터는 이벤트 속성 기여가 기본적으로 설정되어 있습니다. UTM 매개 변수, 참조자, 참조 도메인 및 클릭 식별자는 이벤트 속성으로 모든 추적된 이벤트에 자동으로 첨부됩니다. 추적 방법을 변경하거나 이벤트 속성 기여를 비활성화하려면 autocapture.attribution.trackingMethod와 함께 새 구성 옵션을 사용하십시오. 5d7e5 이전 버전의 템플릿은 기존 설치 지침을 참조하십시오.

페이지 뷰 추적

페이지 뷰 추적을 활성화하려면 이 확인란을 선택합니다. 다음 구성은 사용 가능한 페이지 뷰 추적 옵션입니다. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

세션 추적

세션 추적을 활성화하려면 이 확인란을 선택합니다. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

양식 상호 작용 추적

양식 상호 작용 추적을 활성화하려면 이 확인란을 선택합니다. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

파일 다운로드 추적

파일 다운로드 추적을 활성화하려면 이 확인란을 선택합니다. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

네트워크 추적

네트워크 추적을 활성화하려면 이 확인란을 선택합니다. 네트워크 추적은 XHR 및 Fetch에 의해 호출된 네트워크 요청 이벤트를 캡처합니다. 자세한 내용은 브라우저 SDK 2 - 네트워크 요청 추적을 참조하십시오.

EU 데이터 상주

EU 데이터 거주지를 위해서는 Amplitude EU 내에서 프로젝트를 생성하고 Amplitude EU의 API 키를 사용하세요. 태그 구성 > 태그 초기화init 아래의 EU 데이터 상주 확인란을 선택하여 서버 영역을 구성할 수 있습니다. 초기화 섹션은 태그 유형이 init로 설정된 경우에만 표시됩니다. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

사용자 ID

사용자 ID를 이미 사용할 수 있는 경우 다음을 수행할 수 있습니다.

  • 태그의 "사용자 ID" 입력 상자에 해당 정보를 입력하여 인스턴스를 초기화합니다init.
  • 나중에 사용자 ID를 설정하려면 setUserId태그 유형을 사용하십시오. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

구성

다음 옵션 중에서 선택하십시오.

  • Use default values. 초기화는 각 구성 옵션의 기본값을 사용합니다.
  • Set configuration manually. 해당 옵션을 선택하여 설정합니다. 다음 구성은 GTM 템플릿의 값 유형에 대해 사용 가능한 구성입니다.
  • Select a **GTM variable** from the list. 인스턴스 구성에 사용할 키-값 쌍이 포함된 객체를 반환해야 합니다. 키가 사용 가능한 구성에 포함되어 있는지 확인하십시오.

GTM에서 logLevel 설정 GTM에서는 TypeScript 또는 JavaScript 프로젝트에서처럼 LogLevel열거형을 가져올 수 없습니다. 숫자 값을 사용하여 로그 수준을 설정하십시오.

  • 0 - 없음(모든 로그를 제외함).
  • 1 - 오류(오류 메시지만 해당).
  • 2 - 경고(오류 및 경고 메시지, 기본값).
  • 3 - 세부적인 내용(유익한 메시지).
  • 4 - 디버그(함수 컨텍스트를 포함한 모든 메시지).

예를 들어, 모든 Amplitude SDK 콘솔 로그를 억제하려면 구성 섹션에서 0로 설정하십시오logLevel. "LogLevel.None"또는 "LogLevel.Warn"과 같은 문자열 값은 GTM에서 작동하지 않으므로 사용하지 마십시오.

새로운 구성 옵션

새 구성 옵션 필드를 사용하여 추가 구성 객체를 init에 전달합니다. GTM은 사용자 지정 템플릿의 필드 수를 100개로 제한하는데, init 태그가 이 한도에 도달했으므로 최신 브라우저 SDK 옵션은 태그에 고유한 필드를 갖지 않습니다. 이러한 옵션을 GTM 변수의 객체에 빌드한 다음 해당 변수를 이 필드에 할당하십시오. 태그는 해당 객체를 태그의 나머지 부분으로부터 구축된 구성 위에 병합합니다init.

이 필드는 인라인 객체가 아닌 변수 참조를 허용하므로 먼저 변수를 생성하십시오.

  1. 구성 객체를 반환하는 GTM 변수를 생성합니다. 커뮤니티 템플릿 갤러리의 Amplitude Browser SDK 구성 변수 템플릿을 사용하여 제공되는 옵션을 사용하거나, 템플릿에서 다루지 않는 항목에 대해서는 사용자 지정 JavaScript 변수를 사용하세요.
  2. init태그에서 새 구성 옵션을 해당 변수로 설정합니다(예: {{New config options}}).

두 구성 필드는 다르게 작동합니다. 이러한 상호 작용을 이해하면 태그가 예기치 않게 삭제되거나 설정을 덮어쓰는 일이 발생하지 않습니다.

  • 구성은 태그가 시작되는 기준입니다. 그런 다음 태그는 자동 캡처, 세션 리플레이 및 EU 데이터 상주 등의 init태그의 다른 설정을 그 위에 적용하여 일치하는 모든 최상위 키를 덮어씁니다. 태그 자체의 자동 캡처 구성은 이 필드에서 GTM 변수를 통해 전달된 것과 같은 키를 autocapture대체합니다.
  • 새 구성 옵션이 마지막에 제공되므로 충돌하는 전체 최상위 키에 대해 우선합니다. 병합은 얕습니다. 태그는 autocapturewholesale 등의 최상위 키를 깊이 병합하는 대신 이를 대체합니다.

다음 예제에서는 단일 구성 객체를 사용하고 각 필드에 할당한 결과를 보여 줍니다. 자동 캡처 이벤트가 활성화되어 있다고 가정합니다.

js
{
  deviceId: 'my-device-id',
  autocapture: {
    attribution: {
      trackingMethod: ['userProperty', 'eventProperty']
    },
    newAutocaptureOption: 'value'
  }
}

템플릿 버전 5d7e5 이상

에서는 기본값입니다.trackingMethod: ['userProperty', 'eventProperty'] 아래 예제에서는 이를 사용하여 병합 동작을 설명합니다. 5d7e5 이전 버전의 템플릿에서는 이 구성을 새 구성 옵션에 전달하여 이벤트 속성 어트리뷰션을 활성화하십시오.

구성에 할당되면 객체가 기본이 되며 태그의 자동 캡처 구성이 전체 autocapture키를 덮어씁니다.

js
{
  deviceId: 'my-device-id',              // ✅ kept (UI never touches it)
  autocapture: { /* UI autocapture */ }, // ❌ entire object overwritten —
                                         //    attribution + newAutocaptureOption lost
}

새 구성 옵션에 할당된 태그는 객체를 마지막으로 병합합니다. 병합 작업이 단순하기 때문에 autocapture는 태그의 자동 캡처 구성을 완전히 바꿉니다.

js
{
  deviceId: 'my-device-id',              // ✅ added
  autocapture: {                         // ✅ your value wins, but it REPLACES
    attribution: {                       //    the tag's Autocapture config (shallow merge)
      trackingMethod: ['userProperty', 'eventProperty']
    },
    newAutocaptureOption: 'value'
  }
}

값이 적용되도록 하려면 새 구성 옵션을 사용하십시오. 병합은 단순하기 때문에 autocapture와 같은 최상위 키에 대한 전체 객체를 포함하십시오. 태그는 사용자가 자체 구성에서 생략한 전체 하위 키를 전달하지 않습니다.

세션 시작 전에 사용자 속성 설정

사용자 속성에 자동 session_start이벤트의 새 값이 필요할 때 새 구성 옵션을 통해 identify객체를 전달합니다. SDK는 결과 이벤트를 바로 직$identify전에 추적하므로 session_start업데이트된 속성을 session_start전달합니다. setUserProperties태그 이후에 발생하는 identify또는 init태그는 이 작업을 수행할 수 없습니다. 이는 해당 ID 이벤트가 이후 이벤트에 session_start도착하고 이후 이벤트에만 적용되기 때문입니다.

Amplitude Browser SDK 구성 변수 템플릿은 identify필드를 노출하지 않으므로 사용자 지정 JavaScript 변수에 객체를 빌드하십시오. SDK는 값에 대해서만 해당 메서드를 호출하므로, 해당 메서드를 가진 getUserProperties()일반 객체는 인스턴스 대신 작동합니다:Identify

js
function() {
  var identify = {
    getUserProperties: function() {
      return {
        "$set": {
          "location": "vancouver"
        }
      };
    }
  };
  return {
    identify: identify
  };
}

getUserProperties()는 식별(identify) 이벤트의 user_properties 페이로드를 반환하므로, 이 이벤트는 모든 식별 작업을 키로 받아들입니다: $set, $setOnce, $add, $append, $prepend, $remove, $preInsert, $postInsert, $unset, 또는 $clearAll. 필요한 경우 같은 변수에서 다른 초기화 옵션을 identify와 함께 반환합니다.

init태그는 새 세션을 시작할 때만 이 식별 이벤트를 추적합니다. 이전 세션이 여전히 활성 상태인 경우 init는 새 세션을 시작하지 않으며 이벤트를 추적하지 않습니다. 세션 다음 기간동안 사용자 속성을 업데이트하려면 identify태그 유형을 사용하십시오.

사용자 지정 보강 플러그인

사용자 지정 보강 플러그인 활성화를 사용하여 사용자 지정 보강 플러그인을 init태그에 추가합니다. 플러그인은 태그가 추적하는 모든 이벤트에 대해 보강 함수를 실행합니다. Amplitude는 해당 함수를 프로젝트의 원격 설정에 저장하므로, 컨테이너를 다시 게시하지 않고도 동작을 변경할 수 있습니다.

기본적으로 이 확인란은 선택되어 있지 않습니다.

이 확인란은 사용자가 직접 추가한 플러그인에는 영향을 주지 않습니다.

이 플러그인은 사용자 지정 HTML 태그를 통해 등록한 플러그인과는 별개입니다amplitudeGTM.add(). 사용자 지정 플러그인 추가를 참조하십시오. 이 상자를 선택하거나 선택 해제해도 해당 플러그인에는 아무런 영향을 주지 않습니다.

이벤트 추적

이벤트는 사용자가 애플리케이션과 상호 작용하는 방식을 나타냅니다. 예를 들어 '버튼 클릭됨'은 기록해야 할 동작일 수 있습니다.

track태그 유형은 특정 트리거에 따른 이벤트를 추적합니다.

이벤트 유형

개별 이벤트 속성

이벤트 속성 객체

유효한 이벤트 속성 객체를 반환하는 GTM 변수를 선택합니다. 중복된 키가 전체 있는 경우 개별 이벤트 속성을 덮어씁니다. Amplitude는 오브젝트 형식이 아닌 모든 입력과 해당 user_properties키 아래의 모든 값을 무시합니다.

javascript
    {
        'eventPropKey' : 'eventPropValue',
        'otherEventPropKey': 'otherEventPropValue',
    }

속성을 정의하기 위한 확장 가능한 접근 방식을 설정하려면 GTM에서 Google 태그: 이벤트 설정 변수를 사용할 수 있습니다. GTM Google 태그: 이벤트 설정 변수를 사용하면 여러 태그에서 이벤트 설정을 재사용할 수 있습니다. 자세한 내용은 브라우저 SDK 2를 참조하십시오. 이 변수를 사용하여 속성을 생성하고 여러 태그에서 재사용할 수 있습니다.

Google 태그: 이벤트 설정 변수의 형식:

javascript
    {
        'eventPropKey' : 'eventPropValue',
        'otherEventPropKey': 'otherEventPropValue',
        'user_properties': {
            'user_property_key': 'user_property_value'
        }
    }

Google 태그: 이벤트 설정 변수를 이벤트 속성 객체의 입력으로 선택하면 Amplitude는 해당 키 아래의 값을 무시합니다user_properties.

사용자 지정 타임스탬프

그룹과 함께 추적

이벤트 수준 그룹을 설정합니다. 이벤트 수준 그룹의 경우 그룹 지정은 기록된 특정 이벤트에만 적용되며 setGroup를 사용하여 명시적으로 설정하지 않는 한 사용자에게 지속되지 않습니다. 자세한 내용은 브라우저 SDK 2 - 사용자 그룹을 참조하십시오.

사용자 속성 설정

식별 호출은 사용자 검색에 나타나지 않습니다. identify 호출은 사용자 속성을 설정하며, 업데이트된 사용자 속성은 사용자가 다음 이벤트를 실행한 후에만 나타납니다.

개별 사용자 속성 작업을 각각 테이블의 고유 행으로 추가합니다. 원하는 만큼 추가할 수 있지만, 특정 사용자 속성은 단일 작업에만 포함할 수 있습니다. 작업은 순서대로 실행됩니다. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

그룹 설정

Amplitude는 사용자를 그룹에 할당하고 해당 그룹에 대해 고유 사용자별 수행 회수가와 같은 쿼리를 수행하는 것을 지원합니다. 그룹 구성원 중 적어도 한 명이 특정 이벤트를 수행한 경우 해당 그룹도 수행 회수가에 포함됩니다. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

그룹 속성 설정

Group Identify API를 사용하여 특정 그룹의 속성을 설정하거나 업데이트하십시오. 이러한 업데이트는 앞으로 진행되는 이벤트에만 영향을 줍니다. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

매출 추적

사용자의 수익 이벤트를 추적합니다. 수익 인스턴스는 각 수익 거래를 저장하며, Amplitude의 이벤트 세분화 및 수익 LTV 차트에서 사용하는 몇 가지 특별한 수익 속성(예: revenueType 및 productIdentifier)을 정의할 수 있도록 합니다.

이벤트 플러시

flush 메서드는 클라이언트가 버퍼링된 이벤트를 전송하도록 유도합니다.flush 태그 유형을 수동으로 호출할 필요가 없으며, 이 태그 유형은 flushIntervalMillis 또는 flushQueueSize 중 먼저 발생하는 항목에 따라 트리거됩니다. 브라우저가 닫히는 데 따른 이벤트 손실을 transport방지하려면 구성 옵션에서 beacon을 로 설정하거나 이벤트 시 amplitude.setTransport('beacon')를 호출하는 것을 고려하십시오pagehide. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

이벤트 트래픽 부하에 따라 값을 줄여 클라이언트에서 이벤트가 중단되지 않도록 flushQueueSize하십시오flushIntervalMillis.

사용자 ID 설정

로그아웃 후 userId및 deviceId를 재설정하려면 대신 reset태그 유형을 확인하십시오.

장치 ID 설정

로그아웃 후 userId및 deviceId를 재설정하려면 대신 reset태그 유형을 확인하십시오.

세션 ID 설정

Amplitude는 세션 로직을 자동으로 처리합니다. 세션 제어를 거부하려면 sessionId를 -1 로 설정해야 할 수도 있습니다. 값이 에포크 날짜 이후 밀리초 단위인지 확인하십시오(Unix 타임스탬프) 또는 -1. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

재설정

사용자가 로그아웃할 때 reset사용합니다. 여기에는 두 가지 setUserId(undefined) 작업(및 setDeviceId(UUID()))이 포함됩니다. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

옵트아웃 설정

사용자가 추적을 거부하려면 Opt current user out of tracking확인란을 선택합니다. 자세한 내용은 브라우저 SDK 2를 참조하십시오.

트리거를 정의하세요

모든 태그는 이벤트를 기반으로 실행됩니다. Google 태그 관리자는 이벤트를 등록할 때 이벤트 트리거를 평가하고 태그를 실행합니다. GTM에서 사용 가능한 트리거에 대한 자세한 내용은 트리거 유형을 참조하십시오.

대부분의 경우 init 태그는 페이지에서 실행해야 할 첫 번째 요소입니다. All Pages 또는 Initialization - All Pages 트리거를 사용하여 init 태그를 실행하는 것이 일반적입니다. 신호를 수신할 때까지 init 태그를 연기하고 동의 허가와 같은 사용자 지정 트리거를 사용하여 태그를 실행할 수 있습니다. 다른 모든 태그는 태그가 init발사될 때까지 기다렸다가 Amplitude로 전송할 수 있습니다.

사용자 지정 플러그인 추가

플러그인을 사용하면 이벤트를 수정할 수 있습니다. 자세한 내용은 브라우저 SDK 플러그인 문서를 참조하십시오. 사용자 지정 HTML 태그를 사용하여 사용자 지정 플러그인을 추가할 수 있습니다.

예를 들어, 기본 페이지 보기 이벤트에 이벤트 속성을 추가하기 위한 HTML은 다음과 같습니다.

HTML
<script>
  window.amplitudeGTM.add({
    name: "page-view-enrichment-plugin",
    execute: function(event) {
      if(event.event_type === "[Amplitude] Page Viewed"){
        event.event_properties["custom_key"] = "custom_value";
      }
      return event;
    }
  });
</script>

명명된 인스턴스에 플러그인을 추가하려면 window.amplitudeGTM.createInstance('instanceName').add()를 사용하십시오.

GTM은 해당 템플릿에 기반한 태그가 실행될 때만 템플릿을 로드합니다. 따라서 플러그인이 처음에 로드되고 이후의 모든 이벤트에 적용되도록 태그의 순서를 구성하십시오. 이를 수행하려면 플러그인을 init 태그의 설정 태그로 추가하는 사용자 지정 HTML 태그를 생성하십시오. 그런 다음 플러시 태그를 사용자 정의 HTML 태그에 대한 설정 태그로 구성합니다. 태그의 순서를 다음 순서대로 지정합니다.

  • 플러시.
  • 사용자 지정 HTML.
  • 초기화합니다.

문제 해결

이러한 문제는 GTM 템플릿에서 발생하는 일반적인 문제입니다. GTM 인스턴스의 추가 문제 해결에 대한 자세한 내용은 GTM 헬프 센터를 참조하십시오.

Amplitude GTM 템플릿은 React Native(Android 또는 iOS) 앱을 지원하나요?

아니요. Amplitude 애널리틱스 브라우저 SDK는 데스크톱 및 모바일 브라우저용으로 설계된 웹 컨테이너만 지원합니다. Amplitude는 모바일 앱용 GTM 템플릿을 지원하지 않습니다. 이 기능을 요청하려면 Amplitude 헬프 센터를 통해 기능 요청을 제출하십시오.

내 플러그인이 작동하려면 사용자 지정 보강 플러그인 활성화를 확인해야 합니까?

아니요. 사용자 지정 보강 플러그인 활성화 확인란은 프로젝트의 원격 구성에서 보강 기능을 실행하는 Amplitude에서 구축한 플러그인을 제어합니다. 이 기능은 amplitudeGTM.add()에서 사용자 지정 HTML 태그를 통해 등록한 플러그인과는 관련이 없습니다.

템플릿을 업그레이드했는데 이 확인란의 선택이 취소된 경우 선택을 취소한 상태로 둡니다. 자신의 플러그인은 계속 작동합니다. 이 확인란의 기능에 대해서는 Custom enrichment plugin을 참조하고, 사용자가 작성한 플러그인에 대해서는 Add a custom plugin을 추가하십시오.

Amplitude 템플릿에 로직을 추가할 수 있습니까?

예, 하지만 권장되지 않습니다. 수정된 커뮤니티 갤러리 템플릿은 개발자로부터 업데이트를 받지 못하지만, 템플릿을 복원하여 알림을 다시 받기 시작할 수 있습니다.

누락된 이벤트

  • 여러 버전의 Amplitude 브라우저 SDK가 설치되어 있는지 확인하십시오. SDK의 다른 버전 대상 구간 충돌이 있을 수 있습니다. GTM 인스턴스에 대해 다른 인스턴스 이름을 지정해 보십시오.
  • 웹사이트가 템플릿이 삽입하려는 스크립트를 차단하는 경우 브라우저의 콘솔 또는 네트워크 탭을 확인하여 스크립트를 차단했는지 또는 전체 오류가 발생했는지 확인하십시오.
  • 초기화 웹 속성 이벤트가 누락되었습니다. 쿠키 동의를 설치한 경우 현재 도메인에 대한 document.referrer업데이트 값이 있는지 확인하십시오. 현재 도메인의 캠페인은 추적되지 않습니다.
  • 적절한 태그 실행 옵션을 선택했는지 확인하십시오. Once per event이 옵션을 선택하면 사용자가 트리거 이벤트를 수행할 때마다 태그가 실행됩니다. 선택하면 태그가 Once per Page한 번만 실행됩니다. 이러한 불일치로 인해 이벤트가 예상대로 전송되지 않을 수 있습니다.

전체 사용자 수 증가

쿠키가 실수로 변경되거나 삭제되었는지 확인하십시오. 쿠키는 중요한 사용자 세션 데이터와 마케팅 캠페인 정보를 저장합니다. 이러한 쿠키가 삭제되면 Amplitude는 사용자 식별자(예: 사용자 ID 및 기기 ID)를 재설정하며, 이로 인해 사용자 수가 급증합니다. 또한 마지막으로 조회한 캠페인 매개 변수를 삭제하면 다른 효과 중에서도 유기적 및 직접 트래픽이 증가할 수 있습니다.

도메인 간 추적

도메인 전체에서 사용자 식별을 유지하려면 사용자 지정 HTML 태그를 생성하여 추적하려는 deviceId도메인 링크에 사용자의 정보를 연결하십시오. URL에 추가할 때 Amplitude Browser SDK는 새 deviceId를 생성하는 대신 URL 매개변수 값을 사용합니다ampDeviceId=YourDeviceId. 자세한 내용은 GitHub의 예제 스크립트를 참조하십시오.

템플릿 버전 15cce(라이브러리 버전 amplitude-ts-gtm/3.17.1)부터 템플릿은 동일한 세션을 유지하기 위해 URL 매개변수 ampSessionId에서 세션 ID를 가져오는 기능을 지원합니다. 또한 ampTimestamp 매개변수를 포함하여 추적 매개변수가 만료되지 않은 경우에만 사용되도록 보장하는 평가 창을 만들 수도 있습니다. 자세한 내용은 브라우저 SDK 2.0을 사용한 교차 도메인 추적을 참조하세요.

identify 또는 groupIdentify 값에 다른 유형을 전달하는 방법

태그에 값을 하드 코딩하면 입력을 강제로 string 유형으로 변환합니다. number또는 boolean과 같은 다른 유형을 사용하려면 GTM 변수, 특히 데이터 계층 변수를 생성하십시오.

내 데이터 레이어는 올바르지만 이벤트는 잘못된 이유는 무엇입니까?

이 문제는 태그가 데이터 계층의 변수에서 값을 읽고, 짧은 시간 첫 사용 후 두 값이 데이터 계층에 푸시될 때 발생합니다. 예상되는 동작은 Amplitude가 서로 다른 값을 가진 두 이벤트를 추적하는 것입니다. 그러나 실제로 발생하는 일은 두 이벤트 모두 두 번째(가장 최근에 푸시된) 값을 갖는 것입니다.

이는 첫 번째 값이 데이터 계층에 푸시될 때 데이터 계층이 값을 업데이트하지만 이벤트를 트리거하지는 않기 때문에 발생합니다. 두 번째 값이 푸시되면 데이터 계층은 값을 다시 업데이트하고 두 개의 이벤트를 트리거하며 둘 다 두 번째 값을 읽습니다.

이는 GTM의 알려진 제한 사항입니다. Google 문서를 참조하여 이벤트 이름을 추가하여 이를 해결하십시오.

메시지에 이벤트 이름을 추가했는데도 이 문제가 여전히 발생하는 경우 트랙 태그에 설정 태그가 있는지 확인하십시오. 설정 태그는 트랙 태그를 지연시킬 수 있으므로 데이터 레이어 변수가 최신 값으로 덮어쓰여진 후 이를 읽게 됩니다. 설정 태그를 제거하면 이 문제가 해결될 것입니다.

중대한 변경 체크리스트

페이지 보기 이벤트의 이름 및 속성

새 템플릿은 기본 페이지 보기 이벤트를 변경하여 접두어를 [Amplitude] 포함합니다. 이전 페이지 보기 이벤트를 계속 사용하려면 Use legacy page view properties확인란을 선택합니다. 자세한 내용은 표를 참조하십시오.

  • - 이벤트 이름: Page View; - 속성: page_location, page_path, page_title. page_url
    • 현재:
      • 이벤트 이름: [Amplitude] Page Viewed.
      • 속성: [Amplitude] Page Domain, [Amplitude] Page Location, [Amplitude] Page Path, [Amplitude] Page Title, [Amplitude] Page URL.

하위 도메인 속성 추적

한 하위 도메인에서 다른 하위 도메인으로의 트래픽(analytics.amplitude.com예: experiment.amplitude.com)은 기본적으로 추적되지 않습니다. 다른 하위 도메인이 아닌 location.hostname에 대한 속성 추적을 제외하려면 Track marketing attribution섹션 아래의 Exclude Referrers입력에 location.hostname의 문자열 값을 추가하십시오. 자세한 내용은 표를 참조하십시오.

사용자 에이전트 파서

새 템플릿은 장치 관련 정보를 구문 분석하는 방법을 변경하며, 이는 OS, 장치 유형, 장치 제품군(event.os_name, event.os_version, event.device_model, event.device_manufacturer) 및 관련 속성의 값에 영향을 줄 수 있습니다. 이전 방법을 계속 사용하여 사용자 에이전트를 구문 분석하려면 이 (Legacy) Enable client side user agent enrichment확인란을 선택합니다. 자세한 내용은 표를 참조하십시오.

이 내용이 도움이 되었나요?