[NEW] Singular Website SDK Google 태그 관리자 연동

Singular Website SDK (GTM Integration)
브라우저 호환성
  • Chrome: 15+                       
  • Safari: 5.1+
  • Edge: 15+
  • Firefox: 6+       
  • Internet Explorer: 10+            
  • Opera: 15+

 

소개

Singular Website SDK를 사용하면 웹 사이트의 활동을 마케팅 터치포인트에 어트리뷰트하고 웹 사이트 내의 사용자 이벤트를 추적할 수 있습니다. 또한 Singular의 크로스 디바이스 어트리뷰션 솔루션의 핵심 구성 요소로서 사용자 여정을 분석하고 플랫폼 간 LTV 및 ROAS를 계산할 수 있습니다. Singular Website SDK는 본 문서에서 설명하는 기본 JavaScript 버전 외에도 Google 태그 관리자 템플릿으로도 제공됩니다.

준비 사항

Singular Website SDK 연동을 시작하기 전에 아래 사항을 반드시 확인하세요.

  • 웹사이트에 Google 태그 관리자(Google Tag Manager)가 설정되어야 합니다.
  • 전환 이벤트와 모든 커스텀 이벤트를 포함하여 Singular로 보내려는 모든 이벤트에 대한 Google 태그 매니저 트리거를 설정해야 합니다. 트리거에 대해서는 Google의 트리거 정보 문서를 참조하세요.
  • Singular로 보내려는 이벤트에 대한 Google 태그 매니저 변수를 설정해야 합니다. 예를 들어 트랜잭션 이벤트를 보내면서 트랜잭션 매출을 포함하고자 한다면, 트랜잭션 금액(sum)과 통화 단위(currency)를 추가해야 합니다. 자세한 내용은 Google의 변수 정보를 참조하세요.

Singular SDK 연동

SDK 초기화

Singular Web SDK를 웹사이트에서 사용하려면 Singular 초기화 태그를 추가해야 합니다. on window loaded와 같이 웹사이트가 로딩되자마자 (예: window loaded) 초기화를 발동하도록 권장합니다.

Singular 초기화 태그는 다음처럼 추가할 수 있습니다.

  • Google 태그 관리자 계정에서 Tags > New 클릭
  • In the Tag Configuration 창에서 Tag Configuration를 클릭한 후 Tag Type 메뉴에서 “Singular Web Tracking” 선택
  • Track Type 아래에서 “Initialization” 선택
  • 필요 파라미터 삽입
    • API Key: 고객사의 Singular SDK API key, 예:  “example_api_key1”.
    • Secret: 고객사의 Singular SDK secret, 예: “ff3bfbce70b42a70fe920f42737d2123”.
    • Product Id: 웹 사이트의 이름. DNS 표기를 역순으로 사용하기를 권장. 예: “com.example.site”. 이 이름은 Singular 전체 플랫폼에서 웹사이트를 식별하는 식별자로 활용됨.
  • Triggering 클릭 후 “Window Loaded” 트리거 추가
  • Save 클릭

Screen_Shot_2020-04-13_at_18.23.55.png

중요:  단일 페이지 애플리케이션(SPA, Single Page Applications)에서는 다른 페이지로 라우팅할 때마다 PageVisit trackType을 발동해야 합니다. 또한 초기화를 통해 page visit이 전달되므로 첫 페이지에서는 PageVisit을 따로 호출하지 않아야 합니다.

image5.png

선택 사항: 유저 ID 설정

유저가 웹사이트에서 로그인없이 활동한 이벤트는 Singular가 생성한 유저 ID로 Singular에 전송됩니다. 유저가 가입하거나 로그인한다면 이메일 주소처럼 웹사이트에서 사용하는 실제 해당 유저 ID로 Singular에 이벤트를 전송할 수 있습니다.

이러한 유저 ID는 Singular의 유저 레벨 데이터 익스포트(Exporting Attribution Logs 참조)에서 확인할 수 있으며, 내부 BI 포스트백(Configuring Internal BI Postbacks 참조)을 설정한 경우에는 BI로도 전송할 수 있습니다.

다음 두 가지 방법을 통해 유저 ID를 Singular로 전송할 수 있습니다.

  • 권장 사항: 웹사이트가 열릴 때 유저 ID를 알 수 있다면 Initialization track type에 “Custom user ID”를 설정하세요. 이를 통해 최초의 page visit 부터 유저 ID를 확인할 수 있습니다. 앞서 설명한 SDK 초기화 항목을 참조하세요.
  • 아니면 실행 중 어느 지점에서라도 Login 메서드를 사용할 수 있습니다. 유저 ID 식별이 가능한 시점에 바로 이 메서드를 호출하는 것을 권장합니다.

유저 ID를 Singular로 보내려면 “Login” track type으로 Singular 태그를 추가합니다.

  • Google 태그 관리자 계정에서 Tags > New 클릭
  • Tag Configuration 창에서 Tag Configuration 클릭 후 Tag Type 메뉴에서 “Singular Web Tracking” 선택
  • Track Type 아래에서 “Login” 선택
  • Custom User Id 아래에 유저 ID를 포함한 Google 태그 관리자 변수 입력
  • Triggering 클릭 후 triggering event 추가: user login 혹은 registration
  • Save 클릭

image4.png

유저 ID 설정을 해제하려면 “Logout” track type으로 태그를 추가하세요.

  • Google 태그 관리자 계정에서 Tags > New 클릭
  • Tag Configuration 창에서 Tag Configuration 클릭 후 Tag Type 메뉴에서 “Singular Web Tracking” 선택
  • Track Type 아래에서 “Logout” 선택
  • Triggering 클릭 후 triggering event 추가: user logout 
  • Save 클릭

image1.png

주의:

  • 유저 ID는 logout track type을 사용하거나 유저가 로컬 저장소를 삭제하기 전까지 유지됩니다. 
  • 웹사이트를 닫거나 새로고침하는 것으로는 유저 ID 설정이 해제되지 않습니다.
  • Incognito처럼 프라이빗 모드로 브라우징하는 경우 브라우저가 닫히면 자동으로 로컬 저장소가 삭제되므로 유저 ID가 저장되지 않습니다.

선택 사항: 이벤트 및 매출 트래킹

이벤트 트래킹

캠페인 성과를 분석하고 KPI를 측정하기 위해 Singular를 통해 앱 내의 이벤트 데이터를 수집할 수 있습니다. 예를 들어 고객사는 유저 로그인, 회원 가입, 튜토리얼 완료 등과 같은 데이터를 수집하기를 원할 수 있습니다. 

이 경우 event 메서드를 사용해서 Singular에 이벤트를 전송할 수 있습니다.

주의:

  • 서드 파티 파트너 및 외부 분석 솔루션과의 호환성을 위해 이벤트 이름과 속성에는 영어를 사용하세요.
  • 이벤트 이름은 32자 이하의 ASCII 캐릭터로 제한됩니다. ASCII 캐릭터가 아닌 문자열은 UTF-8로 변환되었을 때 32 byte 미만이어야 합니다.
  • 속성과 값은 500자 이하의 ASCII 캐릭터로 제한됩니다.

커스텀 이벤트는 아래 단계를 통해 트래킹할 수 있습니다.

  • Google 태그 관리자 계정에서 Tags > New 클릭
  • Tag Configuration 창에서 Tag Configuration 클릭 후 Tag Type 메뉴에서 “Singular Web Tracking” 선택
  • Track Type 아래에서 “Custom Event” 선택
  • Event Name 아래에서 이벤트 이름을 입력하거나 이미 정의된 Google 태그 매니저 변수가 있는 경우 해당 변수 입력
  • Triggering 클릭 후 triggering event 추가
  • Save 선택

image3.png

매출 트래킹  

캠페인 성과 및 캠페인 ROI를 분석하기 위해 Singular를 통해 웹사이트에서 획득한 매출 데이터를 수집할 수 있습니다. 수집하는 경우 Singular의 리포트, 로그 익스포트, 포스트백을 통해 해당 데이터를 확인할 수 있습니다.

매출 이벤트 전송에는 revenue 메서드를 사용할 수 있습니다. 커스텀 이벤트 이름으로 매출 이벤트를 전달하면 Singular 리포트에서 여러 가지 매출 이벤트 유형을 분류해서 볼 수 있습니다.

주의: 매출을 여러 다른 통화 단위로 보내더라도 데이터 확인 시에는 Singular 계정에 설정한 고객사의 통화 단위로 자동으로 변환되어 표시됩니다.

매출 이벤트는 다음 단계를 통해 트래킹할 수 있습니다.

  • Google 태그 관리자 계정에서 Tags > New 클릭
  • Tag Configuration 창에서 Tag Configuration 클릭 후 Tag Type 메뉴에서 “Singular Web Tracking” 선택
  • Track Type 아래에서 “Revenue Event” 선택
  • Event Name 아래에서 이벤트 이름을 입력하거나 이미 정의된 Google 태그 매니저 변수가 있는 경우 해당 변수 입력.
  • Currency 아래에서 3글자 ISO 4217 통화단위 코드 입력 (예: “USD”, “EUR”, “KRW")
  • Revenue 아래에서 트랜잭션 금액을 포함하는 변수 입력(예:1.99와 같은 십진법(decimal) 숫자)
  • Triggering 클릭 후 triggering event 추가
  • Save 클릭

image2.png

도움이 되었습니까?