콘텐츠로 건너뛰기

SQL 세그먼트 확장

Snowflake 데이터의 Snowflake SQL 쿼리를 사용하여 세그먼트 확장을 생성할 수 있습니다. SQL은 다른 세분화 기능으로는 달성할 수 없는 방식으로 데이터 간의 관계를 설명할 수 있는 유연성을 제공하기 때문에 새로운 세그먼트 사용 사례를 발굴하는 데 도움이 됩니다.

표준 세그먼트 확장과 마찬가지로 SQL 세그먼트 확장에서 최대 2년(730일)까지의 이벤트를 쿼리할 수 있습니다. 표준 세그먼트 확장과 달리 SQL 세그먼트 확장은 크레딧을 소모합니다.

사전 요구 사항

SQL 세그먼트 확장을 사용하려면 워크스페이스에 대한 다음 권한이 필요합니다.

권한 허용되는 작업
“View Segments” 세그먼트 확장을 열고 SQL 세그먼트 확장 보기
“Edit Segments” SQL 세그먼트 확장 생성, 편집 및 새로 고침
“View PII” 고객 데이터를 반환할 수 있는 SQL 미리보기 쿼리 실행

세그먼트 확장 생성하기

1단계: 편집기 선택

SQL 세그먼트 확장을 생성할 때는 SQL 편집기와 증분 SQL 편집기, 두 가지 유형의 SQL 편집기 중에서 선택할 수 있습니다.

  • 전체 새로고침: Segment를 새로고침할 때마다 Braze는 사용 가능한 모든 데이터를 쿼리하여 Segment를 업데이트하므로 증분 새로고침보다 더 많은 크레딧을 사용합니다. 전체 새로고침 확장은 매일 멤버십을 자동으로 재생성할 수 있지만, 증분 새로고침으로는 새로고침할 수 없습니다.
  • 증분 새로고침: 증분 새로고침은 쿼리를 설정하는 더 비용 효율적인 방법이지만, 설정 시 몇 가지 단계가 추가됩니다. Segment를 구성할 때 이러한 추가 단계를 완료할 수 있다면, 쿼리가 더 적은 크레딧으로 실행되므로 이 옵션을 선택하는 것이 좋습니다.

Operator가 SQL을 대신 작성하도록 하려면 어느 편집기에서든 Operator에게 질문을 선택하고 오디언스를 일상적인 언어로 설명하세요. 자세한 내용은 Operator로 할 수 있는 작업을 참조하세요.

전체 새로고침 SQL 세그먼트 확장을 생성하려면 다음과 같이 하세요.

  1. 오디언스 > 세그먼트 확장으로 이동합니다.
  2. 새 확장 생성을 선택한 다음 전체 새로고침을 선택합니다.

    전체 새로고침 및 증분 새로고침 옵션이 있는 새 확장 생성 모달.

  3. 세그먼트 확장의 이름을 추가하고 SQL을 입력합니다. 요구 사항 및 리소스는 2단계를 참조하세요.

    SQL 세그먼트 확장 예시를 보여주는 SQL 편집기.

  4. 세그먼트 확장을 저장합니다.

증분 새로고침 SQL 세그먼트 확장을 생성하려면 다음과 같이 하세요.

  1. 오디언스 > 세그먼트 확장으로 이동합니다.
  2. 새 확장 생성을 선택하고 증분 새로고침을 선택합니다.

    전체 새로고침 및 증분 새로고침 옵션이 있는 새 확장 생성 모달.

  3. 세그먼트 확장의 이름을 추가하고 SQL을 입력합니다. 요구 사항 및 리소스는 2단계를 참조하세요.

    증분 SQL 세그먼트 확장 예시를 보여주는 SQL 편집기.

  4. 원하는 경우 매일 확장 재생성을 선택합니다.

    확장을 매일 재생성하는 체크박스.

    이 옵션을 선택하면 Braze가 매일 Segment 멤버십을 자동으로 업데이트합니다. 즉, 매일 회사 시간대 기준 자정에(최대 1시간 지연될 수 있음) Braze가 Segment에 새로운 사용자가 있는지 확인하고 자동으로 Segment에 추가합니다. 세그먼트 확장이 7일 동안 사용되지 않으면 Braze는 매일 재생성을 자동으로 일시 중지합니다. 사용되지 않은 세그먼트 확장이란 Campaign이나 Canvas에 포함되지 않은 확장을 말합니다(확장이 “사용된” 것으로 간주되기 위해 Campaign이나 Canvas가 활성 상태일 필요는 없습니다).

  5. 세그먼트 확장을 저장합니다.

확장 처리가 완료되면 세그먼트 확장을 사용하여 Segment를 생성하고, Campaigns 및 Canvases로 이 새로운 Segment를 타겟팅할 수 있습니다.

2단계: SQL 작성

SQL 쿼리는 Snowflake 구문을 사용하여 작성해야 합니다. 쿼리할 수 있는 테이블 및 열의 전체 목록은 테이블 참조를 참조하세요.

SQL은 추가로 다음 규칙을 준수해야 합니다.

  • 단일 SQL 문을 작성하세요. 세미콜론을 포함하지 마세요.
  • SQL은 user_id 열 하나만 선택해야 합니다. 즉, SQL에 다음이 포함되어야 합니다.
SELECT DISTINCT user_id FROM "INSERT TABLE NAME"
  • 이벤트가 0개인 사용자는 쿼리할 수 없으므로, 이벤트를 X회 미만으로 수행한 사용자를 찾는 쿼리는 다음 해결 방법을 따라야 합니다.
    1. 이벤트를 X회보다 많이 수행한 사용자를 선택하는 쿼리를 작성합니다.
    2. Segment에서 세그먼트 확장을 참조할 때 포함하지 않음을 선택하여 결과를 반전합니다.

user_id 열 요구 사항

user_id 열은 소스 테이블의 user_id를 변경 없이 직접 참조해야 합니다. 최종 user_id 열이 다음에 해당하는 경우 Braze는 쿼리를 거부합니다.

  • 별칭이 지정된 계산 열(예: COALESCE(m.orphaned_by_id, c.user_id) AS user_id)
  • user_id로 이름을 바꾼 다른 열(예: m.orphaned_by_id AS user_id)
  • user_id로 별칭이 지정된 하위 쿼리 열(예: 계산된 user_id를 반환하는 하위 쿼리에서 선택하는 경우)

쿼리에서 이미 user_id 열을 선택하고 있는데도 “sql - Please select only the following columns: user_id” 오류가 발생한다면, 쿼리에 이러한 패턴이 사용되었는지 확인하세요. 쿼리 저장에 실패하더라도 미리보기는 작동할 수 있습니다.

추가 규칙

또한 표준 SQL 쿼리는 다음 규칙을 준수해야 합니다.

  • DECLARE 문은 사용할 수 없습니다.

모든 증분 새로고침 쿼리는 쿼리와 스키마 세부 정보, 두 부분으로 구성됩니다.

  1. 편집기에서 원하는 테이블의 user_id를 선택하는 쿼리를 작성합니다.
  2. 편집기 상단의 필드에서 연산자, 횟수, 기간을 선택하여 스키마 세부 정보를 추가합니다. 쿼리는 집계 열의 합계가 해당 필드로 설정한 조건을 충족하는지 확인합니다. 이는 클래식 세그먼트 확장을 생성하는 워크플로와 비슷하게 작동합니다.

    • 연산자: 이벤트가 특정 발생 횟수보다 많이, 적게 또는 같게 발생했는지 지정합니다.
      „More than"이 선택된 연산자 필드.

    • 횟수: 연산자와 관련하여 이벤트를 평가할 횟수입니다.
      „5"가 입력된 횟수 필드.

    • 기간: 이벤트 발생 인스턴스를 확인할 일수로, 1~730일 사이입니다. 이 기간은 현재 날짜를 기준으로 한 과거 일수를 의미합니다. 다음 예시는 지난 365일 동안 이벤트를 5회보다 많이 수행한 사용자를 쿼리하는 것을 보여줍니다.
      „365"가 입력된 기간 필드.

다음 예시에서 결과 Segment에는 지정된 날짜 이후 지난 30일 동안 favorited 이벤트를 3회보다 많이 수행한 사용자가 포함됩니다.

증분 SQL 세그먼트 확장 예시를 보여주는 SQL 편집기.

증분 SQL 세그먼트 확장의 SQL 미리보기.

증분 새로고침이 시간 경과에 따라 사용자를 추적하는 방식

증분 새로고침을 사용하면 Braze는 각 사용자의 일일 카운트를 내부 카운트 테이블에 저장하므로, 매일 모든 과거 데이터를 다시 쿼리하지 않고도 전체 기간에 걸쳐 Segment를 평가할 수 있습니다.

저장되는 항목: Braze는 일일 사용자 자격 카운트를 (date, user_id, count) 형식으로 누적하는 카운트 테이블(Segment 코호트 테이블과 유사)을 유지합니다. 이 테이블은 2일 롤링 새로고침 기간 외의 과거 데이터를 보존합니다.

새로고침할 때마다 일어나는 일: 증분 새로고침이 실행되면 Braze는 카운트 테이블에서 2일 롤링 새로고침 기간에 해당하는 레코드만 삭제합니다. 그런 다음 업데이트된 시간 매개변수($start_date 사용)로 SQL 쿼리를 다시 실행하여 해당 날짜의 새 행을 삽입합니다. 2일 롤링 새로고침 기간 외의 과거 행은 카운트 테이블에 그대로 유지됩니다.

Braze가 Segment 포함 여부를 결정하는 방식: Braze는 가장 최근의 2일 롤링 새로고침 페이로드만이 아니라 누적된 카운트 테이블 전체를 기준으로 Segment 멤버십 기준을 평가합니다. 즉, 2일 이상 전에 자격을 얻은 사용자는 집계된 카운트가 더 이상 기준을 충족하지 않게 되기 전까지 Segment에 남아 있습니다.

안정적으로 새로고침되는 SQL 작성하기: 증분 새로고침용 SQL을 작성할 때는 부분 새로고침 중에 일관되지 않은 결과를 낼 수 있는 쿼리 패턴을 피하세요. 예를 들어 $start_date 경계를 넘나드는 데이터에 의존하는 MAX(time) 같은 윈도우 집계는 일부 날짜만 다시 계산될 때 행 상태를 예기치 않게 변경할 수 있습니다. 각 날짜의 출력이 해당 날짜의 이벤트에만 의존하도록 쿼리를 구성하면, 쿼리가 2일 분량의 데이터를 처리하든 730일 분량의 데이터를 처리하든 일관된 결과를 유지할 수 있습니다.

추가 규칙

또한 증분 새로고침 쿼리는 다음 규칙을 준수해야 합니다.

  • 단일 SQL 문을 작성하세요. 세미콜론을 포함하지 마세요.
  • 증분 SQL Segment는 하나의 이벤트만 참조할 수 있습니다. 날짜 및 횟수 드롭다운은 해당 이벤트에 적용됩니다.
  • SQL에는 $date() 별칭(예: $date(time))이 포함되어야 하며, user_id와 COUNT() 집계를 선택하고, 날짜와 user_id로 그룹화하고, 시간 열에 $start_date로 필터링해야 합니다(예: time > $start_date). $date() 또는 이러한 필드 없이 SQL을 저장하면 오류가 반환됩니다.
  • DECLARE 문은 사용할 수 없습니다.

3단계: 쿼리 미리보기

저장하기 전에 쿼리 미리보기를 실행할 수 있습니다. 쿼리 미리보기는 자동으로 100개 행으로 제한되며 60초 후에 시간 초과됩니다. 미리보기를 실행할 때는 user_id 열 요구 사항이 적용되지 않습니다.

증분 SQL 세그먼트 확장의 경우, 미리보기에는 연산자, 횟수, 기간 필드의 추가 기준이 포함되지 않습니다.

4단계: SQL 반전 필요 여부 결정

다음으로 SQL을 반전해야 하는지 결정합니다. 이벤트가 0개인 사용자를 직접 쿼리할 수는 없지만, SQL 반전을 사용하여 이러한 사용자를 타겟팅할 수 있습니다.

예를 들어 구매 횟수가 3회 미만인 사용자를 타겟팅하려면 먼저 구매 횟수가 3회 이상인 사용자를 선택하는 쿼리를 작성합니다. 그런 다음 SQL 반전을 선택하여 구매 횟수가 3회 미만인 사용자(구매 횟수가 0회인 사용자 포함)를 타겟팅합니다.

SQL 반전 옵션이 선택된 „Clicked 1-4 emails in the last 30 days"라는 이름의 세그먼트 확장.

세그먼트 멤버십 새로 고침

SQL로 생성한 세그먼트 확장의 세그먼트 멤버십을 새로 고치려면 해당 세그먼트 확장을 열고 새로 고침을 선택합니다.

세그먼트 확장 관리하기

세그먼트 확장 페이지에서 SQL로 생성된 Segments는 이름 옆에 아이콘으로 표시됩니다.

SQL 세그먼트 확장을 선택하면 해당 확장이 사용되는 위치를 확인하거나, 확장을 보관하거나, Segment 멤버십을 수동으로 새로 고칠 수 있습니다.

SQL 세그먼트가 사용되는 위치를 보여주는 SQL 편집기의 메시징 사용 섹션.

새로 고침 설정 지정하기

정기적으로 확장을 새로고침할 필요가 없는 경우 새로고침 설정을 사용하지 않고 저장할 수 있으며, Braze는 해당 시점의 사용자 멤버십을 기반으로 세그먼트 확장을 생성하는 기본값을 적용합니다. 오디언스를 한 번만 생성한 다음 일회성 Campaign으로 타겟팅하려는 경우 기본 동작을 사용하세요.

세그먼트는 항상 최초 저장 후 처리가 시작됩니다. 세그먼트가 새로고침될 때마다 Braze는 세그먼트를 다시 실행하고 새로고침 시점의 사용자를 반영하도록 세그먼트 멤버십을 업데이트합니다. 이를 통해 반복 Campaign이 가장 관련성 높은 사용자에게 도달하는 데 도움이 됩니다.

반복 새로고침 설정하기

새로고침 설정을 지정하여 반복 스케줄을 설정하려면 새로고침 활성화를 선택합니다. 새로고침 설정을 지정하는 옵션은 SQL 세그먼트, CDI 세그먼트 확장 및 간단한 양식 기반 세그먼트 확장을 포함한 모든 유형의 세그먼트 확장에 사용할 수 있습니다.

새로고침 설정 선택하기

새로고침 주기를 주 단위로, 시작 시간을 오전 10시로, 요일을 월요일로 선택한 새로고침 간격 설정.

새로고침 간격 설정 패널에서 이 세그먼트 확장을 새로고침할 주기를 시간별, 일별, 주별 또는 월별 중에서 선택할 수 있습니다. 또한 새로고침이 수행될 특정 시간(회사 시간대 기준)을 선택해야 합니다. 예를 들면 다음과 같습니다:

  • 매주 월요일 오전 11시(회사 시간 기준)에 발송되는 이메일 Campaign이 있고, 발송 직전에 세그먼트를 새로고침하려면 매주 월요일 오전 10시로 새로고침 스케줄을 선택해야 합니다.
  • 세그먼트를 매일 새로고침하려면 일별 새로고침 주기를 선택한 다음 새로고침할 시간을 선택하세요.

크레딧 소비 및 추가 비용

새로고침은 세그먼트의 쿼리를 다시 실행하기 때문에 SQL 세그먼트의 각 새로고침은 SQL 세그먼트 크레딧을 소비하고, CDI 세그먼트 확장의 각 새로고침은 서드파티 데이터 웨어하우스 내에서 비용을 발생시킵니다.

오래된 확장을 자동으로 비활성화하는 기준

세그먼트 확장이 오래되면 스케줄된 새로고침이 자동으로 비활성화됩니다. 세그먼트 확장은 다음 기준을 충족하는 경우 오래된 것으로 간주됩니다:

  • 활성 Campaigns이나 Canvases에서 사용되지 않음
  • 활성 Campaign 또는 Canvas에 있는 Segment에서 사용되지 않음
  • 분석 추적이 켜져 있는 Segment에서 사용되지 않음
  • 7일 이상 수정되지 않음
  • 7일 이상 Campaign이나 Canvas(초안 포함) 또는 Segment에 추가되지 않음

세그먼트 확장에 대해 스케줄된 새로고침이 비활성화되면 해당 확장에 이를 알리는 알림이 표시됩니다.

"이 확장은 활성 Campaigns, Canvases 또는 Segments에서 사용되지 않기 때문에 스케줄된 새로고침이 해제되었습니다. 세그먼트 확장은 2025년 2월 23일 오전 12:00에 비활성화되었습니다."라는 알림.

오래된 세그먼트 확장을 사용할 준비가 되면 새로고침 설정을 검토하고 사용 사례에 맞는 새로고침 스케줄을 선택한 다음 수정 사항을 저장하세요.

Snowflake 크레딧

각 Braze 워크스페이스에는 한 달에 5개의 Snowflake 크레딧이 제공됩니다. 크레딧이 더 필요한 경우 계정 매니저에게 문의하세요. 크레딧은 SQL Segment의 멤버십을 새로고침하거나 저장 후 새로고침할 때마다 사용됩니다. SQL Segment 내에서 미리보기를 실행하거나 클래식 세그먼트 확장을 저장하거나 새로고침할 때는 크레딧이 사용되지 않습니다.

크레딧 사용량은 SQL 쿼리의 실행 시간과 상관관계가 있습니다. 실행 시간이 길수록 쿼리에 드는 크레딧이 많아집니다. 실행 시간은 시간이 지남에 따라 쿼리의 복잡성과 크기에 따라 달라질 수 있습니다. 더 복잡한 쿼리를 더 자주 실행할수록 리소스 할당이 커지고 실행 시간이 빨라집니다.

크레딧을 절약하려면 SQL 세그먼트 확장을 저장하기 전에 쿼리를 미리보기하여 올바른지 확인하세요.

크레딧은 매월 1일 오전 12시(UTC)에 5로 초기화됩니다. 크레딧 사용량 패널에서 한 달 동안의 크레딧 사용량을 모니터링할 수 있습니다. 세그먼트 확장 페이지에서 SQL 크레딧 사용량 보기를 클릭합니다.

SQL 세그먼트 확장 페이지의 SQL 크레딧 사용량 패널

크레딧이 0이 되면 다음과 같은 일이 발생합니다.

  • 자동으로 새로고침되도록 설정된 모든 SQL 세그먼트 확장의 새로고침이 중지되며, 이는 해당 Segments의 멤버십과 해당 Segments를 타겟팅하는 모든 Campaigns 또는 Canvases에 영향을 미칩니다.
  • 해당 월의 남은 기간 동안 새 SQL 세그먼트 확장은 초안으로만 저장할 수 있습니다.

SQL Segment를 생성한 모든 회사 사용자와 회사 관리자는 크레딧의 50%, 80%, 100%를 사용하면 알림 이메일을 받게 됩니다. 다음 달 초에 크레딧이 초기화되면 SQL Segments를 더 만들 수 있으며 자동 새로고침이 다시 시작됩니다.

SQL Segment 크레딧이나 세그먼트 확장을 추가로 구매하려면 계정 매니저에게 문의하세요.

New Stuff!