개요

Singular 웹 SDK를 사용하면 웹사이트의 사용자 방문, 전환 및 이벤트를 추적할 수 있습니다. 올바르게 구현하면 Singular는 웹사이트 전환을 해당 방문을 유도한 마케팅 캠페인에 귀속시켜 웹 마케팅 성과에 대한 완벽한 가시성을 제공합니다.

웹 어트리뷰션 작동 방식

Singular 웹 SDK는 JavaScript를 사용하여 브라우저별로 사용자를 식별하고 웹사이트를 통한 사용자의 여정을 추적합니다. 사용자가 사이트를 방문하면 SDK는 첫 방문인지 웹 캠페인에 따른 재방문 세션인지 판단합니다.

주요 기능은 다음과 같습니다:

• 페이지 방문 및 사용자 세션 추적
• 전환 이벤트 기록(구매, 가입, 구독)
• 비즈니스에 특화된 맞춤형 이벤트 측정
• 마케팅 캠페인에 대한 전환 어트리뷰션
• 모바일 SDK와 결합한 크로스 디바이스 어트리뷰션(크로스 디바이스 기능 구독 필요)

시작하기 전에

웹 SDK를 구현하기 전에 다음 사항이 있는지 확인하세요:

요구 사항	설명
SDK 키	Singular SDK 키. 개발자 도구 > SDK 연동 > SDK 키에서 Singular 계정에서 찾을 수 있습니다.
웹사이트 액세스	직접 또는 태그 관리 시스템을 통해 웹사이트의 HTML에 자바Script 코드를 추가할 수 있는 권한입니다.
이벤트 계획	추적하려는 이벤트(예: 구매, 장바구니에 추가, 가입)의 문서화된 목록입니다.
개인정보 처리방침	교차 하위 도메인 추적( 쿠키 사용)을 활성화한 경우 업데이트된 개인정보처리방침.

연동 방법 선택

Singular는 두 가지 연동 옵션을 제공합니다. 기술 설정에 가장 적합한 방법을 선택하세요:

---

네이티브 자바Script 구현

최적 대상: 웹사이트 코드에 직접 액세스할 수 있는 팀, JavaScript에 익숙한 개발자 또는 최대한의 제어와 최소한의 타사 종속성을 원하는 상황.

장점:

• 일반적인 광고 차단기에 의해 차단되지 않음
• 더 빠른 페이지 로딩 성능
• 보다 안정적인 추적
• 구현에 대한 직접 제어
• 배너 지원

단점:

• 웹사이트에 코드 변경이 필요함
• 업데이트에는 개발자의 참여가 필요합니다.

네이티브 자바Script 가이드 보기

---

구글 태그 매니저 구현

최상의 대상: 이미 구글 태그 매니저를 사용하고 있는 팀, 개발자의 도움 없이 변경해야 하는 마케팅 팀.

장점:

• 직접 코드를 변경할 필요가 없음
• 기술 전문가가 아닌 팀도 관리하기 쉬움
• GTM 인터페이스를 통해 변경 사항을 배포할 수 있음

단점:

• 광고 차단기에 의해 차단되는 경우가 많음
• GTM이 올바르게 로드되는지 여부에 따라 달라짐
• 디버깅이 더 복잡해짐
• 배너 지원 없음

구글 태그 관리자 가이드 보기

주요 개념 이해

---

제품 ID(앱 번들 ID)

제품 ID는 웹사이트를 Singular에 식별합니다. 모바일 앱 번들 식별자와 유사한 역 DNS 표기법이어야 합니다.

형식: com.website-name

예시:

• 정답: com.acme
• 틀림: acme-store
• 틀림 www.acme.com

---

세션 및 리인게이지먼트

세션이란 무엇인가요?

Singular 추적에서 세션은 웹사이트에 대한 사용자 참여의 고유한 기간을 나타냅니다. 페이지 요청 전반에 걸쳐 로그인 상태와 같은 기술적 상태를 유지하는 HTTP 세션과 달리, Singular 세션은 분석에 중점을 두며 어트리뷰션 및 참여 지표를 위한 사용자 활동 패턴을 측정합니다.

세션이 생성되는 시기

Singular는 다음과 같은 경우 자동으로 새 세션을 생성합니다:

• 사용자가 30분 이상 비활성 상태인 경우(기본 세션 타임아웃)
• 사용자가 새로운 캠페인 파라미터(다른 광고 소스)를 사용하여 방문한 경우
• 사용자가 다른 추천 웹사이트에서 방문한 경우

세션 타임아웃과 리인게이지먼트 비활성 기간 비교

두 가지 다른 시간 기반 설정을 이해하는 것이 중요합니다:

세션 타임아웃(SDK 수준)

• 새 세션이 시작되는 시점을 제어합니다.
• 기본값: WebSDK의 경우 30분, 모바일 SDK의 경우 60초
• SDK 초기화를 통해 구성 가능
• 사용자 활동이 감지될 때마다 재설정
• 세션 기반 지표(세션 수, 세션 지속 시간 등)에 사용됩니다.

리인게이지먼트 비활성 기간(플랫폼 수준)

• 리인게이지먼트 어트리뷰션이 가능한 시기를 제어합니다.
• 기본값: 7일
• 설정 > 앱에서 앱별로 구성
• 리타겟팅 캠페인 클릭이 리인게이지먼트 이벤트로 간주되기 전에 사용자가 비활성 상태여야 하는 최소 시간을 결정합니다.
• 일반 세션 생성에는 영향을 미치지 않습니다.

예시 시나리오

다음과 같은 사용자가 있다고 가정해 보겠습니다:

1. 사이트를 방문했다가 5분 후에 떠남
2. 45분 후에 리타겟팅 광고를 통해 재방문합니다.

어떤 일이 일어날까요?

• 새 세션이 생성됩니다(세션 시간 제한 30분 초과).
• 리인게이지먼트 어트리뷰션이 발생하지 않음 (사용자가 7일 동안 비활성 상태가 아니었음).
• 해당 방문은 이전 어트리뷰션 소스에 코호트된 일반 세션으로 추적됩니다.

동일한 사용자가 리타겟팅 광고를 통해 10일 동안 활동하지 않은 후 다시 방문한 경우:

• 새 세션이 생성됩니다.
• 리인게이지먼트 어트리뷰션이 트리거됩니다(7일 비활성 기간 초과).
• 이벤트는 리타겟팅 캠페인에 대한 적절한 어트리뷰션과 함께 리인게이지먼트로 기록됩니다.

구성 옵션

세션 시간 제한 사용자 지정:
세션 타임아웃은 SDK 초기화 중에 조정할 수 있습니다. 구현 방법과 관련된 문서에서 WebSDK 초기화 옵션을 검토하세요: 네이티브 자바Script 또는 구글 태그 관리자

리인게이지먼트 비활성 기간 사용자 지정하기:
설정 > 앱으로 이동하여 Singular 플랫폼에서 '고급 설정 표시' 옵션을 확장하면 리인게이지먼트 어트리뷰션에 대한 리인게이지먼트 비활성 기간을 앱별로 맞춤 설정할 수 있습니다. 일반적인 사용자 참여 패턴과 리타겟팅 캠페인 전략에 따라 이를 조정하세요.

---

이벤트: 전환 대 표준

Singular 이벤트는 두 가지 유형의 이벤트를 구분합니다:

전환 이벤트: 성공을 나타내는 비즈니스 크리티컬 액션(구매, 구독, 가입, 다운로드)입니다. 이는 어트리뷰션 보고서와 ROI 계산에 나타납니다.

표준 이벤트: 사용자 행동을 이해하는 데 도움이 되는 지원 작업(페이지 조회, 장바구니에 추가, 동영상 재생)입니다. 이는 로데이터 보고서에 표시되며 사용자 여정을 분석하는 데 도움이 됩니다.

개인정보 및 쿠키 사용

기본적으로 Singular는 쿠키를 사용하지 않습니다. 그러나 교차 하위 도메인 식별자 지속성을 사용하도록 설정하면 Singular는 퍼스트 파티 쿠키를 설정하여 하위 도메인에서 사용자 신원을 유지합니다.

쿠키 세부 정보(활성화된 경우):

속성	Value
쿠키 이름	singular_device_id
목적	개인 정보를 수집하지 않고 세션 전반에서 사용자의 활동과 상호작용을 추적하기 위해 사용자에게 고유 ID를 할당합니다.
기간	1년
유형	퍼스트 파티 쿠키(도메인에 설정)
개인정보 처리방침	https://www.singular.net/privacy-policy/

다음 단계

1. 연동 방법 선택(네이티브 자바Script 또는 구글 태그 관리자)
2. 선택한 방법에 대한 단계별 구현 가이드를 따릅니다.
3. 제공된 유효성 검사 단계를 사용하여 구현을 테스트합니다.
4. 문제 해결 가이드에서 모범 사례를 검토합니다.

관련 문서

• 네이티브 자바Script 구현 가이드
• 구글 태그 관리자 구현 가이드
• 문제 해결 및 모범 사례
• 웹 어트리뷰션 FAQ