Skip to content

SQL 세그먼트 확장

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

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

전제 조건

이 기능을 통해 PII 데이터에 접근할 수 있으므로, SQL 세그먼트 쿼리를 실행하려면 PII 권한이 있어야 합니다.

세그먼트 확장 만들기

1단계: 에디터 선택

SQL 세그먼트 확장을 만들 때 선택할 수 있는 SQL 에디터는 두 가지입니다: SQL 에디터와 증분 SQL 에디터입니다.

  • 전체 새로고침: Segment가 새로고침될 때마다 Braze가 사용 가능한 모든 데이터를 쿼리하여 Segment를 업데이트하므로, 증분 새로고침보다 더 많은 크레딧을 사용합니다. 전체 새로고침 확장은 매일 자동으로 멤버십을 재생성할 수 있지만, 증분 새로고침을 사용하여 새로고침할 수는 없습니다.
  • 증분 새로고침: 증분 새로고침은 쿼리를 설정하는 더 비용 효율적인 방법이지만, 설정 시 몇 가지 추가 단계가 필요합니다. Segment를 구성할 때 이러한 추가 단계를 완료할 수 있다면 이 옵션을 선택하는 것이 좋습니다. 쿼리가 더 적은 크레딧으로 실행되기 때문입니다.
  • AI SQL 생성기: AI SQL 생성기를 사용하면 일반 언어로 프롬프트를 작성하여 Segment에 대한 SQL 쿼리로 변환할 수 있습니다. SQL을 직접 작성할 필요 없이 빠르게 시작할 수 있는 방법입니다.

전체 새로고침 SQL 세그먼트 확장을 만들려면 다음과 같이 합니다:

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

    전체 새로고침과 증분 새로고침 옵션이 있는 새 확장 만들기 모달.

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

    예시 SQL 세그먼트 확장을 보여주는 SQL 에디터.

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

증분 새로고침 SQL 세그먼트 확장을 만들려면 다음과 같이 합니다:

  1. 오디언스 > 세그먼트 확장으로 이동합니다.
  2. 새 확장 만들기를 선택한 다음 증분 새로고침을 선택합니다.

    전체 새로고침과 증분 새로고침 옵션이 있는 새 확장 만들기 모달.

  3. 세그먼트 확장의 이름을 추가하고 SQL을 입력합니다. 요구 사항 및 리소스에 대해서는 SQL 작성 섹션을 참조하세요.

    예시 증분 SQL 세그먼트 확장을 보여주는 SQL 에디터.

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

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

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

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

AI SQL 생성기는 OpenAI가 지원하는 GPT를 레버리지하여 SQL Segment에 대한 SQL을 추천합니다.

프롬프트 "지난 달 알림을 받은 사용자"가 입력된 AI SQL 생성기

AI SQL 생성기를 사용하려면 다음과 같이 합니다:

  1. 전체 새로고침 또는 증분 새로고침을 사용하여 SQL Segment를 만든 후 AI SQL 생성기 실행을 선택합니다.
  2. 프롬프트를 입력하고 생성을 선택하여 프롬프트를 SQL로 변환합니다.
  3. 생성된 SQL이 올바른지 검토한 후 Segment를 저장합니다.

예시 프롬프트

  • 지난 달에 이메일을 받은 사용자
  • 지난 1년간 구매 횟수가 5회 미만인 사용자

팁

  • 사용 가능한 Snowflake 데이터 테이블을 숙지하세요. 이 테이블에 존재하지 않는 데이터를 요청하면 ChatGPT가 가짜 테이블을 만들어낼 수 있습니다.
  • 이 기능의 SQL 작성 규칙을 숙지하세요. 이러한 규칙을 따르지 않으면 오류가 발생합니다. 예를 들어, SQL 코드는 user_id 열을 선택해야 합니다. 프롬프트를 “~한 사용자”로 시작하면 도움이 될 수 있습니다.
  • AI SQL 생성기를 사용하여 분당 최대 20개의 프롬프트를 전송할 수 있습니다.

내 데이터는 어떻게 사용되어 OpenAI로 전송되나요?

OpenAI를 활용하는 BrazeAI 기능을 통해 AI 출력(“출력”)을 생성하기 위해, Braze는 특정 정보(“입력”)를 OpenAI로 전송합니다. 입력은 사용자의 프롬프트로 구성되며, 대시보드에 표시되는 콘텐츠 및 쿼리와 관련된 기타 워크스페이스 데이터가 해당되는 경우 포함될 수 있습니다. OpenAI의 API 플랫폼 약정에 따라, Braze를 통해 OpenAI의 API로 전송된 데이터는 OpenAI 모델을 학습하거나 개선하는 데 사용되지 않습니다. OpenAI는 악용 모니터링 목적으로 데이터를 30일간 보관할 수 있으며, 이후 삭제됩니다. 귀하와 Braze 사이에서 출력은 귀하의 지적 재산입니다. Braze는 해당 출력에 대해 저작권 소유권을 주장하지 않습니다. Braze는 출력을 포함하여 AI가 생성한 콘텐츠와 관련하여 어떠한 종류의 보증도 하지 않습니다.

확장 처리가 완료되면 세그먼트 확장을 사용하여 Segment를 만들고 이 새 Segment를 Campaign 및 Canvases에 타겟팅할 수 있습니다.

2단계: SQL 작성

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

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

  • 단일 SQL 문을 작성합니다. 세미콜론은 포함하지 마세요.
  • SQL은 user_id 열 하나만 선택해야 합니다. 즉, SQL에는 다음이 포함되어야 합니다:
1

SELECT DISTINCT user_id FROM "INSERT TABLE NAME"
  • 이벤트가 0회인 사용자를 쿼리하는 것은 불가능하므로, 이벤트를 X회 미만 수행한 사용자에 대한 쿼리는 다음 해결 방법을 따라야 합니다:
    1. 이벤트를 X회 이상 수행한 사용자를 선택하는 쿼리를 작성합니다.
    2. Segment에서 세그먼트 확장을 참조할 때 doesn't include를 선택하여 결과를 반전합니다.

추가 규칙

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

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

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

  1. 에디터에서 원하는 테이블로부터 user_id를 선택하는 쿼리를 작성합니다.
  2. 에디터 상단의 필드에서 연산자, 횟수, 기간을 선택하여 스키마 세부 정보를 추가합니다. 쿼리는 집계 열의 합이 {{operator}}와 {{number of times}} 입력 안내로 지정된 특정 조건을 충족하는지 확인합니다. 이 기능은 클래식 세그먼트 확장을 만드는 워크플로와 유사하게 작동합니다.

    • 연산자: 이벤트가 발생 횟수보다 많은지, 적은지, 또는 같은지를 나타냅니다.
      연산자 필드에서 "초과"가 선택된 화면.

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

    • 기간: 이벤트의 인스턴스를 확인할 1~730일 범위의 일수입니다. 이 기간은 현재 날짜를 기준으로 과거 일수를 나타냅니다. 다음 예시는 지난 365일 동안 이벤트를 5회 이상 수행한 사용자를 쿼리하는 것을 보여줍니다.
      기간 필드에 "365"가 입력된 화면.

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

예시 증분 SQL 세그먼트 확장을 보여주는 SQL 에디터.

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

추가 규칙

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

  • 단일 SQL 문을 작성합니다. 세미콜론은 포함하지 마세요.
  • 증분 SQL Segment는 하나의 단일 이벤트만 참조할 수 있습니다. 날짜 및 횟수 드롭다운은 선택한 이벤트를 기준으로 합니다.
  • SQL에는 user_id, $start_date, 그리고 집계 함수(예: COUNT)가 포함되어야 합니다. 이 세 가지 필드 없이 저장된 SQL은 오류가 발생합니다.
  • DECLARE 문을 사용할 수 없습니다.

3단계: 쿼리 미리보기

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

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

4단계: SQL 반전이 필요한지 결정

다음으로, SQL 반전이 필요한지 결정합니다. 이벤트가 0회인 사용자를 직접 쿼리하는 것은 불가능하지만, SQL 반전을 사용하면 이러한 사용자를 타겟팅할 수 있습니다.

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

SQL 반전 옵션이 선택된 "지난 30일 동안 이메일 1~4회 클릭" 세그먼트 확장.

세그먼트 멤버십 갱신

SQL을 사용하여 생성한 세그먼트 확장의 세그먼트 멤버십을 갱신하려면, 해당 세그먼트 확장을 열고 갱신을 선택합니다.

SQL 세그먼트 확장 관리하기

세그먼트 확장 페이지에서 SQL을 사용하여 생성된 Segments는 이름 옆에 로 표시됩니다.

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

SQL 에디터의 메시징 사용 섹션으로, SQL Segment가 사용되고 있는 위치를 보여줍니다.

새로고침 설정 지정하기

정기적으로 확장을 새로고침할 필요가 없는 경우 새로고침 설정을 사용하지 않고 저장할 수 있으며, 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 세그먼트 확장은 새로고침을 중지하여 이러한 세그먼트의 멤버십과 이러한 세그먼트를 타겟팅하는 모든 Campaign 또는 Canvases에 영향을 미칩니다.
  • 새 SQL 세그먼트 확장은 남은 한 달 동안 초안으로만 저장할 수 있습니다.

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

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