메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

사이트나 앱에서 사용자가 상호작용하는 페이지를 기반으로 OneSignal에서 사용자에게 태그를 지정한 다음, 해당 태그를 타겟 메시징을 위해 세그먼트화할 수 있습니다. 이 페이지는 두 가지 별개의 패턴을 다룹니다 — 목표에 맞는 것을 선택하거나, 둘을 함께 실행하세요.

​
패턴 선택

패턴코드 실행 시점설정 내용플랫폼
페이지 주제별 태그모든 페이지 또는 화면 방문 시주제별 카운터 태그(gaming = 5)웹, Android, iOS
구독 시 태그사용자가 푸시에 옵트인할 때 한 번귀속 태그(subscription_page = gaming)웹 전용
페이지 주제별 태그는 참여도가 높아질수록 성장하는 행동 관심사 프로필을 구축합니다 — 콘텐츠 추천, 재참여 캠페인 및 카테고리 기반 세그멘테이션에 유용하며, 명시적으로 주제에 옵트인하지 않은 사용자에게도 사용 가능합니다. 구독 시 태그는 옵트인 시점에 단일 시점의 신호를 캡처합니다 — 출처 인식 환영 메시징 및 사용자가 구독한 페이지가 다음에 읽고 싶은 콘텐츠를 예측하는 드립 캠페인에 유용합니다.

​
전제 조건

​
페이지 주제별 태그(매 방문 시)

사용자가 가장 많이 참여하는 주제로 사용자에게 태그를 지정하여 보다 개인화된 메시징을 제공할 수 있습니다 — 관련성, 클릭률 및 만족도를 높입니다. 예제 사용 사례:
  • 패션 사이트에서 사용자는 남성 신발에만 관심이 있고 여성 드레스에는 관심이 없습니다.
  • 뉴스 앱에서 사용자는 금융 및 스포츠 기사를 지속적으로 방문하지만 엔터테인먼트나 정치는 방문하지 않습니다.

​
1. 주제 분류 정의

추적하려는 콘텐츠 카테고리 또는 주제를 식별하는 것부터 시작합니다. 다음과 같을 수 있습니다:
  • sports, finance 또는 entertainment와 같은 광범위한 카테고리
  • laptops, accessories 또는 premium과 같은 제품 유형
  • 작가 또는 브랜드
  • 관리를 간단하게 유지하려면 3~8개의 주제로 시작하세요.
  • 전체적으로 20개 미만의 주제를 유지하여 비대화를 방지하세요.

​
2. 주제 방문을 추적하는 코드 추가

아래 예제는 세 가지 작업을 수행합니다:
  • 페이지 또는 화면당 하나 이상의 주제를 추적합니다.
  • 주제가 볼 때마다 방문 횟수를 증가시킵니다.
  • 각 조회 시 업데이트된 횟수로 사용자에게 태그를 지정합니다.
const topics = ["sports", "entertainment"]; // One or many

if (typeof localStorage !== "undefined" && Array.isArray(topics)) {
  topics.forEach(topic => {
    let count = parseInt(localStorage.getItem(topic), 10);
    count = isNaN(count) ? 1 : count + 1;
    localStorage.setItem(topic, count);
    OneSignal.User.addTag(topic, count.toString());
  });
}

​
3. 세그먼트 및 개인화된 메시지 보내기

태그가 적용되면 다음을 사용하여 사용자를 타겟팅할 수 있습니다:
  • 세그먼트를 사용하여 규칙 기반 그룹 구축(예: gaming >= 3인 사용자).
  • API 필터를 사용하여 단일 캠페인에 사용자를 동적으로 포함.
예제 사용 사례:
  • 관련 페이지를 5회 이상 방문한 특정 주제에 대해서만 사용자에게 메시지 보내기.
  • 특정 작가의 게시물을 3개 이상 읽은 사용자에게 게시물 홍보.
  • 특정 제품 카테고리를 계속 방문하는 쇼핑객에게 할인 제공.

​
모범 사례

수행:
  • 캠페인을 시작하기 전에 console.log()(웹) 또는 플랫폼의 로거를 사용하여 태그 로직을 테스트하세요.
  • 페이지 전체에서 일관된 주제 명명 규칙을 사용하세요.
  • 모든 페이지를 건드리지 않고 조정할 수 있도록 주제 목록을 중앙 위치(구성 파일 또는 원격 구성)에 보관하세요.
피해야 할 사항:
  • 긴 또는 지나치게 구체적인 태그 키(전체 기사 제목, 긴 URL).
  • OneSignal의 태그 제한 초과.
  • 개인 식별 정보(PII)로 태그 지정.

​
구독 시 태그(일회성, 웹 전용)

구독자가 구독한 페이지 주제 또는 URL 경로와 같은 컨텍스트 데이터로 웹 푸시 구독자에게 태그를 지정하여 타겟팅된 후속 캠페인을 제공합니다. 이 패턴은 옵트인을 감지하고, 태그를 적용하고, 드립 스타일 메시징을 위한 세그먼트에 제공합니다.

​
1. 옵트인 시 사용자에게 태그 지정

사용자가 푸시 알림을 구독할 때 PushSubscription change 리스너를 사용하여 옵트인을 감지하고 보고 있던 페이지에 대한 컨텍스트 데이터가 포함된 태그를 적용합니다. 
function pushSubscriptionChangeListener(event) {
  if (event.current.optedIn && !event.previous.optedIn) {
    // User just opted in — tag with subscription context
    var pathSegment = window.location.pathname.split('/')[1] || 'home';
    var pageTopic = document.querySelector('meta[name="article-topic"]')?.content || 'general';

    OneSignal.User.addTags({
      subscription_page: pathSegment,
      subscription_page_topic: pageTopic,
    });
  }
}

OneSignalDeferred.push(function(OneSignal) {
  OneSignal.User.PushSubscription.addEventListener("change", pushSubscriptionChangeListener);
});
작동 방식:
  • change 이벤트는 사용자의 푸시 구독 상태가 변경될 때(옵트인, 옵트아웃, 토큰 새로 고침) 실행됩니다.
  • 사용자가 활성 구독을 가질 때 event.current.optedIn은 true입니다. !event.previous.optedIn을 확인하면 태그가 모든 상태 변경이 아닌 최초 옵트인 시에만 적용됩니다.
  • window.location.pathname.split('/')[1]은 구독 컨텍스트로 첫 번째 경로 세그먼트를 캡처합니다. 예를 들어 URL이 https://example.com/gaming/article-123이면 subscription_page 태그는 gaming으로 설정됩니다.
  • pageTopic은 <meta> 태그에서 추출되며 'general'로 폴백됩니다. 사이트의 메타데이터 구조에 맞게 조정하세요.

​
2. 태그별로 사용자 세분화

태그가 적용되면 세그먼트 또는 API 필터를 사용하여 해당 태그를 기반으로 사용자를 타겟팅합니다. 예를 들어:
  • subscription_page가 gaming인 사용자에게 캠페인 보내기.
  • 태그 값 및 타이밍을 기반으로 동적 세그먼트 만들기(예: 첫 세션 이후 시간).

​
3. 후속 메시징 자동화

사용자가 구독한 시기와 구독한 콘텐츠를 기반으로 메시지를 트리거하는 드립 스타일 캠페인을 구축합니다. 예제: 게임 구독자를 위한 드립 캠페인
세그먼트 이름필터설명
Gaming 1subscription_page = gaming AND First Session > 2h AND < 24h구독 후 2~24시간 후 연락.
Gaming 2subscription_page = gaming AND First Session > 24h AND < 48h1일 후 후속 조치.
Gaming 3subscription_page = gaming AND First Session > 72h AND < 96h3일 후 최종 확인.
메시징 기간이 지나면 사용자가 세그먼트에 남아 있지 않도록 상한 시간 제한(<)을 사용하세요.

​
4. 세그먼트와 메시지 템플릿 결합

세그먼트가 생성되면:
  • 캠페인의 각 단계(예: 소개, 알림, 프로모션)에 대한 템플릿을 작성합니다.
  • Journeys를 사용하여 사용자가 적절한 세그먼트에 진입할 때 이러한 메시지를 보냅니다.
예제 메시지 아이디어:
  • 게임 커뮤니티 또는 소셜 그룹 초대.
  • 주제와 관련된 인기 기사 추천.
  • 독점 제안 또는 할인 코드 보내기.

​
모범 사례

  • 실제 사용자 의도를 반영하는 의미 있는 태그 이름 및 값을 사용하세요.
  • 가능한 경우 페이지 메타데이터에서 태그 값을 동적으로 추출하세요.
  • 최초 옵트인 시에만 태그를 지정하세요 — 위의 리스너 예제는 모든 상태 변경 시 재태그 지정을 방지하기 위해 !event.previous.optedIn을 확인합니다.
태그 값에 이름이나 이메일 주소와 같은 개인 식별 정보(PII)를 포함하지 마세요. 전체 사이트에서 태그 값을 하드코딩하는 것을 피하고 페이지 컨텍스트에서 동적으로 추출하세요.

​
자주 묻는 질문

​
어떤 패턴을 사용해야 합니까?

시간이 지남에 따라 행동 관심 프로필을 구축하려면 페이지 주제별 태그를 사용하세요. 매 방문마다 카운터가 증가하므로 세그먼트를 참여 깊이(gaming >= 5)로 조정할 수 있습니다. 옵트인 시 단일 시점 귀속을 캡처하려면 구독 시 태그를 사용하세요. 사용자가 긴 방문 기록을 갖기 전에 그들이 구독한 위치에 대응하고 싶은 출처 인식 환영 메시징에 유용합니다. 두 패턴은 동일한 사이트에서 함께 실행될 수 있습니다 — 서로 다른 태그를 설정하고 서로 다른 질문에 답합니다.

​
사용자가 브라우저 데이터를 지우면 태그가 유지됩니까?

아니요. 웹에서 브라우저 데이터를 지우면 새 구독이 생성되고 localStorage에 저장된 주제별 카운터도 함께 재설정됩니다. 사용자가 다시 구독하면(수동으로 또는 자동 재구독을 통해), change 리스너가 다시 실행되고 현재 페이지를 기반으로 구독 태그가 재적용되지만 방문 카운터는 새로 시작됩니다.

​
최초 구독 후 태그를 업데이트할 수 있습니까?

예. 언제든지 OneSignal.User.addTag() 또는 OneSignal.User.addTags()를 호출하여 태그를 추가하거나 업데이트할 수 있습니다. 구독 리스너는 초기 컨텍스트에 유용하지만, 지속적인 행동을 기반으로 사용자에게 태그를 지정할 수도 있습니다.

​
메시지 이벤트 필터 대신 이러한 패턴을 사용해야 합니까?

서로 다른 목적을 가지고 있습니다. 사용자가 방문하거나 구독한 페이지 기준으로 세그먼트화하려면 — 즉, 사이트나 앱에서 시작된 신호 — 이 페이지의 패턴을 사용하세요. 사용자가 어떤 OneSignal 메시지와 상호작용했는지(전달됨, 클릭됨 등) 기준으로 세그먼트화하려면 메시지 이벤트 필터를 사용하세요. 둘은 보완적이며 중복되지 않습니다.

​
구독 출처 패턴이 모바일에서 작동합니까?

직접적으로는 아닙니다. PushSubscription.addEventListener("change", ...) API는 웹 전용입니다. iOS 및 Android에서는 옵트인 흐름 내에서 addTag를 호출하여 유사한 귀속을 달성할 수 있습니다 — 예를 들어, 사용자가 권한 프롬프트를 수락한 직후 그들이 있던 화면이나 기능으로 태그를 지정합니다.

​
관련 페이지

태그

개인화 및 세그멘테이션을 위해 사용자에게 사용자 지정 속성을 추가합니다.

세그먼트

타겟 메시징을 위해 속성, 태그 및 행동별로 사용자를 그룹화합니다.

웹 SDK 참조

구독 리스너 및 태그 지정 메서드를 포함한 OneSignal 웹 SDK의 전체 참조.

모바일 SDK 참조

태그 지정 메서드를 포함한 OneSignal 모바일 SDK의 전체 참조.

Journeys

세그먼트 진입 또는 사용자 지정 이벤트에 의해 트리거되는 다단계 메시징 워크플로를 구축합니다.