웹 온보딩 가이드

Singular 웹 온보딩 가이드에 오신 것을 환영합니다. 웹 온보딩 절차는 모바일 앱 어트리뷰션의 절차와 다르므로 이에 주의하세요.

Singular는 Javascript 태그를 사용하는 SDK를 통해 웹 사이트의 어트리뷰션을 수행합니다. 태그를 웹 사이트에 구현할 때, Singular는 브라우저가 인지한 특정 유저가 귀하의 웹 사이트를 처음 방문했는지 아니면 웹 캠페인을 따라 웹사이트를 다시 방문한 유저인지 알 수 있습니다. 

1

"Apps" 페이지에 웹 사이트를 추가하세요

Singular 리포트를 사용하기 전, Singular Apps 페이지에서 웹 사이트를 반드시 추가하세요.

  1. Singular > Settings > Apps로 가세요.
  2. 해당 모바일 앱을 이미 추가한 경우, 추가한 모바일 앱을 선택하세요. 앱을 추가한 적이 없다면, Add New App를 클릭하여 앱을 등록하세요.
  3. New Site 하단의 Web을 선택하세요.
  4. "Add an app using" 하단에 Store URL을 선택하고 웹 사이트 URL을 입력하세요.
  5. Bundle ID를 설정하고 Save를 클릭하세요. SDK 초기화 시 이 Bundle ID (또는 Product ID)를 사용하게 됩니다.

web_bundleid.png

팁: Bundle Id는 웹사이트 명이고, 역방향 DNS 표기법 (예시, “com.example.site”) 사용을 권장합니다. 이는 Singular 플랫폼에서 귀하의 웹 사이트를 식별하는 데 사용합니다. 

2

SDK를 웹 사이트에 연동

Singular 웹 사이트 SDK는 유저 활동을 마케팅 터치 포인트에 어트리뷰션하고 웹 사이트 내 유저 이벤트를 추적할 수 있게 합니다. SDK 연동은 다음 가이드를 따르세요.  

참고:

  • SDK 초기화 코드는 모든 웹 페이지와 매번 페이지가 로딩될 때마다 호출되어야 합니다.
  • 로그인 또는 다른 활동들에 Singular SDK를 로딩하지 않도록 권장하는데, 해당 동작의 경우 일부 유저 데이터를 잃어버리게 되기 때문입니다. 
  • 인스톨 후 유저 활동으로 로그인, 트라이얼 시작, 구매, 웹 사이트 구독과 같은 이벤트를 추적할 수 있습니다.  
  • custom_user_id의 구현을 권장하며, 이를 통해 유저 레벨의 데이터를 분석할 수 있습니다. 
  • 커스텀 이벤트를 통해서는 카운트만 추적할 수 있는반면, 매출 이벤트를 통해서 카운트와 매출의 총합을 추적할 수 있습니다.

웹 SDK 연동 확인

Chrome의 Developer Tools를 통해 SDK 연동 상황을 빠르게 확인할 수 있습니다.

  1. 웹 SDK가 연동된 웹 사이트를 오픈합니다.
  2. Ctrl+Shift+I (윈도우) 또는 Cmd+Option+I (맥)를 통해 Developer Tools를 오픈합니다.
  3. Developer Tools의 Network tab에서 "Singular"를 필터 박스에 검색합니다. 웹 SDK가 올바르게 구현되었다면, "__PAGE_VISIT__" 이벤트가 표시됩니다.
  4. Developer Tools > Testing Console에서 웹 SDK 연동 상황을 테스트할 때 사용하는 SDID를 참고할 수 있습니다. 

check_integration.png

3

웹 SDK 연동 테스트

웹 SDK 연동을 테스트하기 위해서는 다음 단계를 따르세요.

  1. Developer Tools > Testing Console로 가세요.
  2. Add Device를 클릭하세요.
  3. "Web" 플랫폼을 선택하고 키 스페이스에 Singular Device ID를 선택하세요.
  4. 이전 단계에서 추출한 SDID를 입력하고 Add를 클릭하세요.
  5. SDID를 추가한 후, 웹 사이트를 다시 로딩하고 이벤트를 발생시킬 수 있습니다. “__PAGE_VISIT__” 와 다른 이벤트들(발생시킨 경우)이 Testing Console에서 보여기 시작합니다.  

testing_sdk.png

참고: Testing Console은 활성화 데이터만 기록합니다. 오프라인 상태에서 발생한 모든 이벤트는 표시되지 않습니다.  

테스트 결과는 Attribution > Export Logs에서 또한 확인할 수 있습니다. 로그 추출(Export Logs)을 통해 컨버전 (인스톨), 이벤트, 등과 같은 유저 레벨 데이터를 수동으로 다운로드할 수 있습니다. 

4

웹-투-앱 링크 구현

웹 사이트에 웹-투-앱 링크를 구현하여, 유저가 도착한 웹 광고 소스에 대한 앱 인스톨을 추적할 수 있습니다.  

이를 구현하기 위해서는, 웹-투-앱 기반의 링크가 필요하며, 이는 Singular 솔루션 엔지니어에 의해 생성됩니다. 링크가 한번 생성된 후 공유되면, Attribution > Manage Links 에서 필요한 변경 사항을 적용할 수도 있습니다.   

Singular 솔루션 엔지니어가 해당 링크를 생성하기 위해서는, Android와 iOS의 딥링크 스킴을 추가했는지 확인하세요. 이는 Apps 설정에서 업데이트할 수 있습니다. Settings > Apps로 가서, 앱과 플랫폼을 선택한 후, Show Advanced Settings를 클릭하세요.

딥링크는 기존 유저들을 앱으로 보낼 수 있어 더 나은 유저 경험을 제공합니다. 딥링크 사용을 원하지 않으면, Singular 솔루션 엔지니어에게 알려주세요. 

webtoapp_implemenetation.png

중요: 웹 사이트의 모든 "Download App" 버튼에는 해당 기능의 작동을 위해 Singular 솔루션 엔지니어가 제공하는 웹-투-앱 트래킹 링크가 태그되어야 합니다. 

구현에 대한 정보는 모바일 웹에 대한 웹 사이트-투-앱 어트리뷰션 포워딩을 참고하세요.

5

웹 캠페인 추적

웹 캠페인을 운영하는 동안, 데스티네이션 URL은 트래킹 파라미터를 포함해야 합니다. 만약 UTM 파라미터를 이미 사용하고 있다면, 이를 계속하여 사용할 수 있으며, 사용 중이 아니라면 Singular의 “Create Web Link” 기능을 사용하여 트래킹 파라미터들에 대한 데스티네이션 URL을 생성할 수 있습니다.

Singular를 사용하는 웹 사이트 링크를 생성할 때, 기존 리포트가 변경되지 않도록 UTM 파라미터 명명 규칙을 유지하세요. UTM 파라미터를 사용하지 않는 경우, 빈칸으로 두고 Generate Link를 클릭하면 됩니다.  

생성된 트래킹 링크에서, Singular는 고유 파라미터 세트를 추가하며, 이는 “wp” 접두사에 의해 인식되는데, 인식된 후 매체로부터 캠페인을 추적할 때 사용할 수 있습니다. “wp” 파라미터값은 매체 매크로를 포함하며, 이는 광고를 제공하는 동안 매체에 의해 대체됩니다. 

참고:

  • 어트리뷰션에서 “wp” 파라미터가 UTM 파라미터와 동시에 존재하는 경우 UTM 파라미터에 선행됩니다.   
  • 웹 트래킹 파라미터에서 Singular의 “wp” 파라미터를 사용하지 않으면, 웹 어트리뷰션과 광고 매체의 웹 캠페인의 매출에 관한 정확한 매칭을 보장할 수 없습니다.
  • 캠페인을 운영할 때마다 매번 웹 트래킹 링크를 생성할 필요는 없습니다. 매체마다 한 번씩 생성하고 해당 매체의 모든 캠페인에 적용하여 사용하세요. 
페이스북

Facebook을 설정하려면:

  1. Campaign과 Ad set 레벨에 대한 정보를 입력한 후, Ad 레벨로 이동하여 URL 파라미터를 설정하세요.
  2. Ad 레벨에서, Website URL 하단의 Build a URL parameter를 클릭하세요.
  3. Singular 트래킹 링크 생성 화면에서, 트래킹 링크 도구에서 생성된 URL을 복사하여 웹 사이트 URL에 추가하세요. 
  4. 자세한 내용은 Facebook 도큐먼트를 참고하세요.

web_fb_link.png

Google Adwords

Adwords를 설정하려면:

  1. Google Analytics를 사용하지 않는 경우라면, 트래킹 템플릿은 다른 파트너들과 비슷하게 설정하세요.
  2. 이를 위해서는, 트래킹 링크 생성 화면에 가서, 트래킹 링크 툴에 의해 베이스 도메인 없이 생성된 URL 파라미터들을 복사하세요. 
  3. Adwords의 광고를 설정할 때, "URL Options"로 이동하여 "Final URL suffix" 필드 내 URL 파라미터들을 붙여 넣으세요.
    참고: 이 작업은 계정, 캠페인, 광고 그룹 또는 광고 레벨에서 원하는 대로 수행할 수 있습니다.
  4. 자세한 내용은 Google 도큐먼트를 참고하세요.

web_adwords_link.png

6

Singular에서 이벤트 설정

SDK를 연동할 때, 추적하고 싶은 이벤트들을 정의하세요. 집계 리포트에서 등록해놓은 해당 이벤트들을 보려면, Settings > Events에서 매핑하세요. 참고할 점은, 리포트는 매핑된 이후의 이벤트들만 표시합니다. 

7

캠페인 리포트 실행

연동과 이벤트 매핑을 완료한 후, 데이터가 들어오기 시작할 때까지 기다리세요. 데이터 업데이트 속도와 주기를 통해 데이터가 업데이트되는 시간을 참고하세요.

집계된 데이터를 확인하려면, Analytics > Reports로 가세요. 리포트에서 보고싶은 디멘션과 메트릭을 선택하고 Run을 클릭하세요. 확인 시 반드시 Platform 디멘션을 선택하여 웹과 앱 데이터를 구분하여 확인하세요.

web_report.png