Singular Website SDK: Google Tag Manager 방식 통합

팔로우
Avatar
Eyal Rabinovich
Updated

단수 웹사이트 SDK는 기업용 기능입니다. 이 기능을 사용하는 데 관심이 있는 경우 고객 성공 관리자에게 문의하세요.

단일 웹사이트 SDK(GTM 통합)
브라우저 호환성
  • Chrome: 15+
  • Safari: 5.1+
  • Edge: 15+
  • Firefox: 6+
  • 인터넷 익스플로러: 10+
  • Opera: 15+

 

소개

싱귤러 웹사이트 SDK를 사용하면 웹사이트 활동을 마케팅 터치포인트에 어트리뷰션하고 웹사이트 내 사용자 이벤트를 추적할 수 있습니다. 또한 싱귤러의 크로스 디바이스 어트리뷰션 솔루션의 핵심 구성 요소로, 사용자 여정을 분석하고 크로스 플랫폼 LTV 및 ROAS를 계산할 수 있게 해줍니다. 사용자의 편의를 위해 싱귤러 웹사이트 SDK는 구글 태그 매니저와 통합되어 있습니다.

참조: 구글 태그 매니저 없이 싱글 웹사이트 SDK 통합하기

전제 조건

싱글 웹사이트 SDK를 통합하기 전에 다음 사항을 확인하세요:

  • 사이트에 Google 태그 관리자가 구성되어 있습니다.
  • 싱귤러로 보내려는 이벤트(전환 이벤트 및 모든 사용자 지정 이벤트)에 대해 필요에 따라 Google 태그 관리자 트리거를 설정했습니다. Google 문서에서 트리거에 대한정보를 참조하세요.
  • Singular로 보내려는 이벤트에 대해 필요에 따라 Google 태그 관리자 변수를 설정했습니다. 예를 들어, 거래 이벤트를 전송하고 거래 수익을 포함하려면 거래 금액과 통화에 대한 변수를 설정해야 합니다. Google 문서에서 변수 정보를참조하세요.

싱글 SDK 통합

SDK 초기화

웹사이트에서 Singular 웹 SDK를 사용하려면 Singular 초기화 태그를 추가해야 합니다. 웹사이트가 로드되는 즉시(예: 페이지 보기) 이 이벤트가 트리거되도록 설정하는 것이 좋습니다.

단일 초기화 태그를 추가하려면 다음과 같이 하세요:

  1. Google 태그 관리자 계정에서 태그 > 새로 만들기를 클릭합니다.
  2. 태그 구성 창에서 태그 구성을 클릭하고 태그 유형메뉴에서 "단일 웹 추적"을 선택합니다.
  3. 추적 유형 아래에서 "초기화"를 선택합니다.
  4. 다른 필수 파라미터를 입력합니다:
    • SDK 키 및 SDK 시크릿: Singular 계정에 로그인하고 "개발자 도구 > SDK 통합 > SDK 키"로 이동하여 검색할 수 있습니다.
    • 제품 ID: 웹사이트의 이름입니다. 기본 웹 도메인의 역 DNS 표기법(예: "com.example")을 사용하는 것이 좋습니다. 이 값은 Singular 플랫폼 전체에서 웹사이트를 식별하는 데 사용됩니다. 이 값은 싱글 플랫폼의 앱 페이지에 있는 앱 번들 ID와도 일치해야 합니다.
    • 선택 사항입니다:
      • 로그 수준: 콘솔에 대한 SDK 디버그 로깅의 구성입니다. 기본값은 없음입니다.
      • 세션 시간 초과: SDK가 새 세션을 생성하기 전에 사용자가 비활성 상태여야 하는 시간입니다. 싱귤러는 사용자 세션을 전송하여 사용자 리텐션을 계산하고 리인게이지먼트 어트리뷰션을 활성화합니다. 기본값은 30분입니다.
      • 교차 하위 도메인 추적
  5. 트리거링을 클릭하고 "페이지 보기" 트리거를 추가합니다.
  6. 저장을 클릭합니다.

mceclip0.png

참고: SPA(단일 페이지 애플리케이션)의 경우, 다른 페이지로 라우팅할 때마다 PageVisit 트랙 유형을 트리거해야 합니다. 초기화에서 이미 페이지 방문을 보고하므로 로드되는 첫 번째 페이지에서는 PageVisit을 호출하지 마세요.

image5.png

선택 사항입니다: 사용자 ID 설정

사용자가 로그인하지 않고 웹사이트에서 작업을 수행하는 한, 이벤트는 Singular에서 생성된 사용자 ID를 사용하여 Singular로 전송됩니다. 그러나 사용자가 등록하거나 로그인한 후에는 이메일 주소와 같이 웹사이트에서 사용되는 사용자 ID와 함께 이벤트를 Singular로 전송할 수 있습니다.

싱귤러는 사용자 수준 데이터 내보내기( 어트리뷰션 로그 내보내기 참조)와 내부 BI 포스트백을 구성한 경우( 내부 BI 포스트백 구성 참조)에도 사용자 ID를 사용합니다.

사용자 ID를 Singular로 전송하는 방법에는 두 가지가 있습니다:

  • 권장: 웹사이트가 열릴 때 사용자 ID를 알고 있는 경우, SDK를 초기화할 때 초기화 트랙 유형에서 사용자 ID를 설정합니다. 이렇게 하면 첫 번째 페이지 방문부터 사용자 ID를 Singular에서 사용할 수 있습니다.
  • 또는 실행 중 언제든지 로그인 메서드를 호출할 수 있습니다. 사용자 ID를 사용할 수 있게 되는 즉시 호출하는 것이 좋습니다.

싱귤러와 사용자 ID를 공유하려면 '로그인' 트랙 유형으로 싱귤러 태그를 추가합니다:

  1. Google 태그 관리자 계정에서 태그 > 새로 만들기를 클릭합니다.
  2. 태그 구성 창에서 태그 구성을 클릭하고 태그 유형메뉴에서 "싱글 웹 추적"을 선택합니다.
  3. 추적 유형에서"로그인"을 선택합니다.
  4. 맞춤 사용자 아이디 아래에 사용자 아이디가 포함된 구글 태그 관리자 변수를 입력합니다.
  5. 트리거링을 클릭하고 트리거링 이벤트(사용자 로그인 또는 등록)를 추가합니다.
  6. 저장을 클릭합니다.

image4.png

사용자 ID를 설정 해제하려면 트랙 유형이 "로그아웃"인 태그를 추가합니다:

  1. Google 태그 관리자 계정에서 태그 > 새로 만들기를 클릭합니다.
  2. 태그 구성 창에서 태그 구성을 클릭하고 태그 유형메뉴에서 "단일 웹 추적"을 선택합니다.
  3. 추적 유형에서"로그아웃"을 선택합니다.
  4. 트리거링을 클릭하고 트리거링 이벤트인 사용자 로그아웃을 추가합니다.
  5. 저장을 클릭합니다.

image1.png

참고:

  • 사용자 ID는 로그아웃 트랙 유형을 사용하여 설정을 해제하거나 사용자가 로컬 저장소를 삭제할 때까지 지속됩니다.
  • 웹사이트를 닫거나 새로 고침해도 사용자 ID는 설정이 해제되지 않습니다.
  • 시크릿과 같은 비공개 모드로 브라우징하면 브라우저를 닫을 때 로컬 저장소가 자동으로 삭제되므로 Singular에서 사용자 ID를 유지하지 못합니다.

선택 사항입니다: 이벤트 및 수익 추적

이벤트 추적(비수익)

싱귤러는 사이트 내 사용자 이벤트에 대한 데이터를 수집하여 캠페인의 성과를 분석하고 KPI를 측정할 수 있습니다. 예를 들어, 조직에서 사용자 로그인, 등록 또는 튜토리얼 완료에 대한 데이터를 수집하고자 할 수 있습니다.

이벤트 메서드를 사용하여 싱귤러로 이벤트를 보낼 수 있습니다.

참고:

  • 타사 파트너 및 분석 솔루션을 사용하려는 경우 타사 파트너 및 분석 솔루션과의 호환성을 보장하기 위해 이벤트 이름과 속성을 영어로 전달할 것을 적극 권장합니다.
  • 이벤트 이름은 32개의 ASCII 문자로 제한됩니다. ASCII가 아닌 문자로 된 문자열은 UTF-8로 변환한 후 32바이트 미만이어야 합니다.
  • 속성 및 값은 500 ASCII 문자로 제한됩니다.

맞춤 이벤트를 추적하려면 다음과 같이 하세요:

  1. Google 태그 관리자 계정에서 태그 > 새로 만들기를 클릭합니다.
  2. 태그 구성 창에서 태그 구성을 클릭하고 태그 유형메뉴에서 "단일 웹 추적"을 선택합니다.
  3. 추적 유형에서"맞춤 이벤트"를 선택합니다.
  4. 이벤트 이름 아래에 이벤트의 이름을 입력하거나 이전에 정의한 Google 태그 관리자 변수를 입력합니다.
  5. 트리거링을 클릭하고 트리거 이벤트를 추가합니다.
  6. 저장을 클릭합니다.

image3.png

수익 추적

싱귤러는 웹사이트를 통해 얻은 수익에 대한 데이터를 수집하여 캠페인의 성과와 ROI를 분석하는 데 도움을 줄 수 있습니다. 싱귤러는 보고서, 로그 내보내기 및 포스트백에서 데이터를 사용할 수 있도록 합니다.

수익 방식을 사용하여 이벤트를 보고합니다. 수익 방식을 사용하면 사용자 지정 이벤트 이름을 전달할 수 있으므로 Singular 보고서에서 다양한 유형의 수익 이벤트별로 분류된 수익을 볼 수 있습니다.

참고: 다른 통화로 보고된 모든 수익은 단수 계정에 설정된 대로 조직의 기본 통화로 자동 변환됩니다.

수익 이벤트를 추적하려면 다음과 같이 하세요:

  1. Google 태그 관리자 계정에서 태그 > 새로 만들기를 클릭합니다.
  2. 태그 구성 창에서 태그 구성을 클릭하고 태그 유형메뉴에서 "단일 웹 추적"을 선택합니다.
  3. 추적 유형에서"수익 이벤트"를 선택합니다.
  4. 이벤트 이름에 이벤트의 이름을 입력하거나 이전에 정의한 Google 태그 관리자 변수를 입력합니다.
  5. 통화 아래에 "USD", "EUR" 또는 "INR"과 같은 세 글자로 된 ISO 4217 통화 코드를 나타내는 변수를 입력합니다.
  6. Revenue(매출)에 거래 금액이 포함된 변수를 입력합니다(예: 1.99와 같이 소수점 값으로 전달 가능).
  7. 트리거링을 클릭하고 트리거 이벤트를 추가합니다.
  8. 저장을 클릭합니다.

image2.png

선택 사항입니다: 교차 하위 도메인 추적

기본적으로 싱귤러 웹사이트 SDK는 싱귤러 디바이스 ID를 생성하고 브라우저 저장소를 사용하여 이를 유지합니다. 이 저장소는 하위 도메인 간에 공유할 수 없으므로 SDK는 각 하위 도메인에 대해 새 ID를 생성하게 됩니다.

하위 도메인에서 단일 장치 ID를 유지하려는 경우 다음 옵션 중 하나를 사용할 수 있습니다:

방법 A: 쿠키를 사용하여 자동 지속

사용자 지정 퍼스트 파티 쿠키를 사용하여 싱귤러 SDK가 싱귤러 디바이스 ID를 유지하도록 할 수 있습니다. 다음 옵션을 선택하고 추적하려는 기본 도메인을 설정합니다.

mceclip1.png

방법 B(고급): GTM 변수에 대한 단일 디바이스 ID 읽기

싱귤러 SDK가 디바이스 ID를 자동으로 유지하지 않도록 하려면 최상위 도메인 쿠키 또는 서버 측 쿠키를 사용하여 도메인 전체에서 수동으로 ID를 유지할 수 있습니다. 이 값은 이전에 Singular에서 유효한 uuid4 형식으로 생성한 ID여야 합니다.

참고: 사용자 지정 JavaScript 변수를 정의하고 Init 트랙 유형 태그를 호출한 후 singularSdk.getSingularDeviceId()를 호출하여 Singular 디바이스 ID를 읽을 수 있습니다.

mceclip2.png

사용자 지정 사용자 ID 디바이스 매핑

중요: 이 기능은 고급 기능입니다. 구현하기 전에 싱귤러의 솔루션 엔지니어와 상담하세요.

싱귤러는 서버 간 통합을 통해 추가 웹 추적 데이터를 수신할 수 있습니다. 이 기능을 활용하려면 사용자 지정 사용자 아이디를 Singular의 웹 추적 식별자에 매핑해야합니다.

참고: SDK를 초기화한 후 또는 사용자 지정 사용자 ID를 확보한 후 가능한 한 빨리 이 트랙 유형을 호출하세요.

사용자 지정 사용자 아이디를 Singular의 웹 추적 식별자에 매핑하려면다음과 같이 하세요:

  1. Google 태그 관리자 계정에서 태그 > 새로만들기를 클릭합니다 .
  2. 태그 구성 창에서 태그 구성을 클릭하고 태그 유형 메뉴에서 '싱글 웹 추적'을 선택합니다.
  3. 추적 유형에서"기기 맞춤 사용자 아이디 설정"을 선택합니다.
  4. 맞춤 사용자 아이디 아래에 사용자 아이디가 포함된 구글 태그 관리자 변수를 입력합니다.
  5. 트리거링을 클릭하고 트리거 이벤트를 추가합니다.
  6. 저장을 클릭합니다.

Screen_Shot_2020-04-13_at_18.14.29.png