Skip to content

SQL 세그먼트 확장

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

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

필수 조건

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

세그먼트 확장 생성하기

1단계: 편집기 선택

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

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

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

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



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

    SQL 편집기에 표시된 SQL 세그먼트 확장 예시.

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

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

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



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

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

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

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

    이 옵션을 선택하면 Braze가 매일 자동으로 세그먼트 멤버십을 업데이트합니다. 즉, 매일 자정(최대 1시간 지연 가능)에 회사 시간대 기준으로 Braze가 세그먼트에 새로운 사용자가 있는지 확인하고 자동으로 추가합니다. 7일 동안 세그먼트 확장을 사용하지 않은 경우, Braze는 자동으로 일일 재생성을 일시 중지합니다. 사용하지 않은 세그먼트 확장은 캠페인 또는 캔버스에 포함되지 않은 확장을 말합니다(캠페인 또는 캔버스가 활성 상태가 아니어도 확장은 “사용 중”으로 간주됩니다).

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

AI SQL 생성기는 OpenAI가 제공하는 GPT를 활용하여 SQL 세그먼트에 맞는 SQL을 추천합니다.

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

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

  1. 전체 또는 증분 새로고침을 사용하여 SQL 세그먼트를 생성한 후 AI SQL 생성기 시작을 선택합니다.
  2. 프롬프트를 입력하고 생성을 선택하여 프롬프트를 SQL로 변환합니다.
  3. 생성된 SQL을 검토하여 올바른지 확인한 다음 세그먼트를 저장합니다.

프롬프트 예시

  • 지난 달에 이메일을 받은 사용자
  • 지난 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가 생성한 콘텐츠와 관련하여 어떠한 종류의 보증도 하지 않습니다.

확장 처리가 완료되면 세그먼트 확장을 사용하여 세그먼트를 생성하고, 캠페인 및 캔버스를 통해 이 새 세그먼트를 타겟팅할 수 있습니다.

2단계: SQL 작성하기

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

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

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

추가 규칙

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

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

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

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

    • Operator: 이벤트가 발생 횟수보다 많거나, 적거나, 같은 횟수로 발생했는지 표시합니다.
      "보다 크다"가 선택된 Operator 필드.

    • 횟수: Operator와 관련하여 이벤트를 몇 번 평가할지 입력합니다.
      "5"가 입력된 횟수 필드.

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

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

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

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

추가 규칙

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

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

3단계: 쿼리 미리보기

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

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

4단계: SQL 반전 필요 여부 판단

다음으로, SQL을 반전시켜야 하는지 판단합니다. 이벤트가 0건인 사용자를 직접 쿼리할 수는 없지만, SQL 반전을 사용하여 해당 사용자를 타겟팅할 수 있습니다.

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

"지난 30일 동안 1~4개의 이메일을 클릭함"이라는 세그먼트 확장에 SQL 반전 옵션이 선택된 상태.

세그먼트 멤버십 새로고침

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

세그먼트 확장 관리

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

SQL 세그먼트 확장을 선택하여 확장이 사용 중인 위치를 확인하거나, 확장을 아카이브하거나, 세그먼트 멤버십을 수동으로 새로고침할 수 있습니다.

SQL 편집기의 메시징 사용 섹션에서 SQL 세그먼트가 사용되는 위치를 표시합니다.

새로고침 설정 지정

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

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

반복 새로고침 설정하기

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

새로고침 설정 선택하기

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

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

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

크레딧 소비 및 추가 비용

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

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

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

  • 활성 캠페인이나 캔버스에서 사용되지 않음
  • 활성 캠페인 또는 캔버스에 있는 세그먼트에서 사용되지 않음
  • 분석 추적이 켜져 있는 세그먼트에서 사용되지 않음
  • 7일 이상 수정되지 않음
  • 7일 이상 캠페인이나 캔버스(초안 포함) 또는 세그먼트에 추가되지 않음

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

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

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

Snowflake 크레딧

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

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

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

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

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

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

  • 자동으로 새로고침되도록 설정된 모든 SQL 세그먼트 확장은 새로고침을 중지하여 이러한 세그먼트의 멤버십과 이러한 세그먼트를 타겟팅하는 모든 캠페인 또는 캔버스에 영향을 미칩니다.
  • 새 SQL 세그먼트 확장은 남은 한 달 동안 초안으로만 저장할 수 있습니다.

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

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

New Stuff!