세그먼트 사용자 속성 가이드

SDK로 보낸 속성과 서버가 기록한 행동을 조건으로 조합해, 발송 대상을 자동으로 분류합니다.

전체 흐름

1. 커스텀 속성 보내기

등급·생일·관심 카테고리처럼 내 서비스에만 있는 정보는 identify()의 customFields로 보냅니다. 미리 항목을 등록할 필요 없이, 보내는 즉시 콘솔 조건 목록에 나타납니다.

// 로그인 성공 후
await tracker.identify({
    externalUserId: user.id,
    name: user.name,
    email: user.email,
    customFields: {
        grade: 'gold',              // 회원 등급
        birthday: '1990-07-26',     // 생일
        joinedAt: '2024-03-15',     // 가입일(내 서비스 기준)
        point: 15000,               // 보유 포인트
        favoriteCategory: '주방용품'
    }
});

보낸 값은 키 단위로 합쳐집니다

매번 전체 속성을 보낼 필요가 없습니다. 보낸 키만 갱신되고 나머지는 그대로 유지됩니다.

// ① 로그인 시
await tracker.identify({
    externalUserId: 'u1001',
    customFields: { grade: 'silver', birthday: '1990-07-26' }
});
// 저장 결과: { grade: 'silver', birthday: '1990-07-26' }

// ② 구매 완료 시 — 등급만 갱신
await tracker.identify({
    externalUserId: 'u1001',
    customFields: { grade: 'gold', lastOrderAmount: 89000 }
});
// 저장 결과: { grade: 'gold', birthday: '1990-07-26', lastOrderAmount: '89000' }
//            ↑ 갱신됨      ↑ 보내지 않았지만 유지됨    ↑ 새로 추가됨(텍스트로 저장)

2. 행동은 서버가 자동 기록합니다

아래 네 가지 행동은 따로 보내지 않아도 서버가 최초·마지막 시각을 기록합니다. "마지막 구매일로부터 30일 경과" 같은 조건에 바로 사용할 수 있습니다.

각 행동은 최초·마지막 시각뿐 아니라 발생 횟수도 함께 기록되어, "N회 이상" 조건에 쓸 수 있습니다.

누적 구매액(LTV)

구매 전환에 금액을 함께 보내면 서버가 회원별 누적 구매액을 합산합니다. "누적 구매액 10만 이상 VIP" 같은 조건을 만들 수 있습니다.

// 구매 전환 기록 시 금액(goalValue)과 통화(goalCurrency)를 함께
await tracker.trackGoal('purchase', {
    goalValue: 89000,        // 이 거래 금액
    goalCurrency: 'KRW'      // 통화 (생략 시 조직 기준 통화로 간주)
});

커스텀 이벤트

위 표준 4가지 외의 행동(예: 장바구니_담기, 영상_시청완료)도 trackEvent()로 보내면 회원별로 발생 시각·횟수가 집계되어 세그먼트 조건이 됩니다.

// 식별된(identify 완료) 사용자의 커스텀 이벤트
await tracker.trackEvent('add_to_cart', { productId: 'A100' });
// → 콘솔 세그먼트 조건에 "add_to_cart 횟수", "마지막 add_to_cart일" 등이 자동 노출

3. 캠페인 반응

특정 캠페인을 받은/클릭한 회원을 조건으로 쓸 수 있습니다 — "여름 세일 클릭자에게 후속 발송" 같은 리타겟팅에 유용합니다. 별도 SDK 호출은 필요 없고, 발송·클릭 이력에서 자동으로 판정됩니다.

4. 조건 만들기

콘솔 메시징 → 세그먼트에서 조건을 조합합니다.

사용할 수 있는 속성

비교 연산자

AND / OR 조합

한 그룹 안의 조건은 AND(모두 만족), 그룹끼리는 OR(하나라도 만족)로 묶입니다. 그룹은 최대 5개, 그룹당 조건은 최대 10개까지 사용할 수 있습니다.

[그룹 1]  등급 = gold  AND  포인트 ≥ 10000
   또는(OR)
[그룹 2]  마지막 구매일이 최근 7일 이내

→ "골드 등급이면서 포인트 1만 이상인 회원" 또는 "최근 일주일 안에 구매한 회원"

활용 예시

쿠폰 시나리오 레시피

쿠폰은 서비스마다 규칙이 달라 플랫폼의 고정 기능이 아니라 커스텀 이벤트·속성으로 표현합니다. 아래 세 가지만 보내면 대부분의 쿠폰 세그먼트를 만들 수 있습니다.

// 1) 쿠폰 다운로드(발급) 시 — 만료일을 커스텀 속성으로, 다운로드를 이벤트로
await tracker.identify({
    externalUserId: user.id,
    customFields: { coupon_expiry: '2024-06-30' }   // 회원별 만료일 (YYYY-MM-DD)
});
await tracker.trackEvent('coupon_download', { coupon: 'SUMMER10' });

// 2) 쿠폰 사용 시
await tracker.trackEvent('coupon_use', { coupon: 'SUMMER10' });

케이스별 조건

대상자 갱신 주기

세그먼트는 매일 한 번 전체를 다시 계산합니다. 오늘 등급이 바뀐 회원은 다음 계산 시점에 반영됩니다.

탈퇴 회원 처리

SDK withdraw()로 탈퇴 처리된 회원은 개인정보와 커스텀 속성이 즉시 삭제되고 모든 세그먼트에서 자동으로 빠집니다. 행동 기록도 함께 삭제되므로 재가입 시 이전 이력이 조건에 잡히지 않습니다.

→ 사용자 식별 & 수신동의 API에서 자세한 내용을 확인하세요.

트러블슈팅