외부 세그먼트

외부 세그먼트를 사용하면 CSV로 내보내고 목록이 변경될 때마다 다시 업로드하는 대신 CRM 또는 데이터 웨어하우스와 같이 자체 데이터베이스에 이미 저장된 사람들을 타겟팅할 수 있습니다. Pushwoosh에 올바른 사용자 ID를 반환하는 SQL 쿼리를 제공하면 Pushwoosh는 해당 쿼리를 계속 재실행하여 세그먼트를 최신 상태로 유지합니다. 설정이 완료되면 이러한 사용자를 다른 세그먼트와 동일한 방식으로 사용할 수 있습니다.

개발자 지원 필요

연결을 설정하려면 개발자 또는 데이터베이스 관리자의 도움이 필요합니다. 시작하려면 이 가이드를 그들과 공유하세요.

연결 설정은 프로덕션 데이터베이스에 영향을 미칩니다. 시작하기 전에 개발자 또는 데이터베이스 관리자에게 다음을 요청하세요:

• 읽기 전용 사용자(또는 BigQuery의 경우 읽기 전용 서비스 계정)를 준비합니다.
• 사용할 쿼리를 확인합니다.
• 데이터베이스가 방화벽 뒤에 있는 경우 Pushwoosh 지원팀에 허용할 IP 주소를 문의합니다.

외부 세그먼트 생성

세그먼트 이름 지정 및 데이터베이스 선택

1. Audience → External Segments로 이동합니다.
2. Create external segment를 클릭합니다.

3. 세그먼트의 이름을 입력합니다(최대 100자).
4. 데이터베이스 유형을 선택합니다: PostgreSQL, MySQL, Google BigQuery 또는 Microsoft SQL Server / Fabric.

연결 필드 채우기

PostgreSQL 및 MySQL

PostgreSQL 및 MySQL의 경우 다음을 입력합니다:

• 호스트 및 포트: 데이터베이스 서버의 주소입니다. Pushwoosh는 공개적으로 접근 가능한 호스트가 필요하며, 연결을 확인하거나 세그먼트를 저장할 때 개인, 내부 또는 루프백 주소를 거부합니다.
• 데이터베이스: 데이터베이스 이름입니다.
• 사용자 및 암호: 읽기 전용 계정의 자격 증명입니다.
• SSL 모드(PostgreSQL만 해당, MySQL 연결은 TLS를 사용하지 않음)는 SSL/TLS(연결을 암호화하는 프로토콜)가 데이터베이스 연결에 적용되는 방식을 설정합니다. 데이터베이스 관리자에게 사용할 모드를 문의하세요:
  • Disable: 암호화 없음.
  • Require: 연결을 암호화하지만 데이터베이스 서버의 ID는 확인하지 않습니다.
  • Verify CA: 연결을 암호화하고 서버의 인증서가 신뢰할 수 있는 인증 기관(CA)에서 발급되었는지 확인합니다.
  • Verify full: Verify CA와 동일하며, 인증서가 데이터베이스의 호스트 이름과 일치하는지도 확인합니다. 가장 강력한 옵션입니다.
• Disable 이외의 모드의 경우, 인증서 소스 아래에 CA 인증서(파일 업로드 또는 PEM 붙여넣기)를 제공하고, 데이터베이스에 필요한 경우 클라이언트 인증서와 클라이언트 키도 제공합니다.

BigQuery

Google BigQuery의 경우 다음을 입력합니다:

• 프로젝트 ID: 데이터 세트를 보유한 GCP 프로젝트입니다.
• 서비스 계정 JSON: BigQuery 읽기 액세스 권한이 있는 서비스 계정의 키입니다.
• 위치: 데이터 세트의 지역입니다(예: EU, US 또는 europe-west3). 데이터 세트에서 위치를 자동으로 확인하려면 비워 둡니다.

SQL Server / Fabric

Microsoft SQL Server / Fabric의 경우 다음을 입력합니다:

• 호스트 및 포트: 데이터베이스 서버의 주소 또는 Fabric SQL 분석 엔드포인트입니다. Pushwoosh는 공개적으로 접근 가능한 호스트가 필요하며, 연결을 확인하거나 세그먼트를 저장할 때 개인, 내부 또는 루프백 주소를 거부합니다.
• 데이터베이스: 데이터베이스 이름입니다.
• 사용자 및 암호: 읽기 전용 계정의 자격 증명입니다.
• Microsoft Entra 테넌트 ID: 선택 사항입니다. SQL Server 로그인의 경우 비워 둡니다. SQL 로그인이 없는 Microsoft Fabric의 SQL 분석 엔드포인트의 경우, 대신 서비스 주체로 로그인하도록 설정합니다. 애플리케이션(클라이언트) ID를 사용자로, 클라이언트 시크릿을 암호로 입력합니다.

쿼리 입력

1. 쿼리를 입력합니다. 세그먼트에 포함하려는 사용자당 한 행씩 user_id라는 단일 열을 반환해야 합니다. 예:

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

참고

user_id 값은 사용자에 대해 설정한 Pushwoosh User ID와 일치해야 합니다(사용자 ID로 세그먼트 구축에서 사용되는 것과 동일한 식별자). Pushwoosh가 인식하지 못하는 ID를 반환하는 쿼리는 어떤 장치와도 일치하지 않습니다.

2. 연결 확인을 클릭하여 Pushwoosh가 데이터베이스에 연결할 수 있는지 확인합니다(30초 후 시간 초과).
3. 쿼리 확인을 클릭하여 쿼리가 실행되고 올바른 열을 반환하는지 확인합니다(역시 30초 후 시간 초과).

확인 및 생성

두 확인이 모두 성공하면 생성을 클릭합니다. Pushwoosh는 세그먼트를 저장하고 즉시 외부 세그먼트 목록에 추가합니다.

세그먼트가 최신 상태를 유지하는 방법

Pushwoosh는 고정된 일정에 따라 쿼리를 실행하지 않습니다. 대신, 마지막으로 사용된 시점을 기준으로 세그먼트를 새로 고칩니다:

• 세그먼트 데이터가 한 시간 미만인 경우 Pushwoosh는 현재 데이터를 그대로 사용합니다.
• 한 시간이 지난 경우 Pushwoosh는 백그라운드에서 새로 고치는 동안 현재 데이터를 계속 사용합니다.
• 세 시간이 지난 경우 Pushwoosh는 세그먼트를 사용하기 전에 새로 고침을 기다립니다.

실제로 이는 정기적으로 사용하는 세그먼트(예: 반복되는 Journey에서)는 최신 상태를 유지하는 반면, 거의 사용하지 않는 세그먼트는 다시 사용할 때 새로 고치는 데 시간이 걸릴 수 있음을 의미합니다.

새로 고침이 실패하면(예: 데이터베이스에 연결할 수 없게 되거나 쿼리에서 오류가 발생하기 시작하면) Pushwoosh는 오류를 기록하지만 외부 세그먼트 목록의 세그먼트 상태는 자체적으로 변경되지 않습니다. 문제를 해결한 후 세그먼트를 열고 연결 확인을 클릭하여 수정 사항을 확인합니다. 오류는 다음에 세그먼트 데이터가 성공적으로 새로 고쳐질 때 자동으로 지워집니다.

외부 세그먼트 사용

생성되면 외부 세그먼트는 Audience → Segments에 동일한 이름으로 자동으로 나타나며, 캠페인 또는 Journey 오디언스와 같이 다른 세그먼트처럼 사용할 수 있습니다.

다른 조건과 결합하려면 필터로 추가합니다:

1. Audience → Segments → Create Segment로 이동합니다.
2. 필터 추가 기준 → 세그먼트를 클릭합니다.
3. 이름으로 외부 세그먼트를 선택합니다.

동일한 세그먼트 필터는 복합 필터와 오디언스 기반 진입에서 오디언스를 선택할 때 사용할 수 있습니다. 세그먼트 결합에 대한 자세한 내용은 기존 세그먼트로 세그먼트 구축을 참조하세요.

세그먼트에 포함된 사람 수 확인

외부 세그먼트 목록에는 구성원 수가 표시되지 않습니다. Audience → Segments에서 세그먼트의 래퍼를 열고(외부 세그먼트 사용 참조) 거기서 크기를 계산합니다.

외부 세그먼트 관리

외부 세그먼트 목록의 각 행에는 세그먼트 이름, 코드(API 호출에서 세그먼트를 참조하는 데 사용되는 식별자), 데이터베이스 유형, 호스트 및 상태(유효 또는 무효)가 표시됩니다.

• 편집을 클릭하여 연결 또는 쿼리를 변경합니다. 데이터베이스 유형은 생성 후 변경할 수 없습니다. 대신 새 세그먼트를 생성하세요.
• 삭제를 클릭하여 세그먼트를 제거합니다. Pushwoosh는 세그먼트가 캠페인, Journey, 필터 또는 팝업 양식에서 사용되는 동안 삭제를 차단합니다. 먼저 해당 참조를 제거한 다음 세그먼트를 삭제하세요. 이 작업은 취소할 수 없습니다.