Segment 문제 해결

아래에서 증상을 찾아 해당 섹션으로 이동하세요. 이 페이지에서는 시작 오류, 사용자 자격, 필터 문제 및 분석 불일치를 다룹니다. 필터 정의는 세분화 필터를 참조하세요. Segment 크기 추정, 정확한 수 및 과거 멤버십 차트에 대해서는 Segment 크기 측정을 참조하세요.

시작하기: 증상 매칭

표준 조사 경로

사용자가 Segment에 포함되어야 하는데 포함되지 않거나 Segment 수가 잘못된 것으로 보일 때 이 워크플로를 사용하세요.

1. 시작 차단: 오디언스 복잡도 또는 10,000바이트 필터 오류가 Campaign 또는 Canvas에 표시되는 경우, 오류(CSV 해결 방법, 필터 단순화)부터 시작하세요.
2. 사용자 미리보기 또는 사용자 조회: 특정 사용자를 Segment 필터와 비교하여 테스트하세요. 사용자가 기준의 일부 또는 전체와 일치하지 않으면 문제 해결을 위해 누락된 기준이 나열됩니다. 단계는 Segment 만들기의 Segments 테스트를 참조하세요.
3. 정확한 통계 계산: Segment 추정치가 0명의 사용자를 표시하거나 잘못된 것으로 보이면 도달 가능한 사용자 패널에서 정확한 통계 계산을 선택하세요. 계산하기 전에 Segment를 저장하세요. 계산이 이미 실행 중인 경우 완료될 때까지 기다리세요. 새로운 계산이 완료될 때까지 이전 수치가 표시될 수 있습니다. 자세한 내용은 정확한 통계 계산을 참조하세요.
4. 필터 값 확인: 오타, 데이터 유형 불일치, 오래된 캔버스 단계 참조, 부정 필터 + OR 로직을 확인하세요.
5. 복잡도 확인: 시작이 차단된 경우 타겟 오디언스가 너무 복잡하여 시작할 수 없음을 참조하세요.
6. 고객지원 문의: 여전히 차단된 경우 Braze 고객지원에 문의하세요.

Segment에서 사용자가 0명으로 표시됨

대시보드의 Segment 크기는 종종 사용자 샘플을 기반으로 한 추정치입니다. 매우 작은 Segment는 필터와 일치하는 사용자가 있더라도 0을 포함하는 추정 범위를 표시할 수 있습니다.

• 도달 가능한 사용자 패널에서 정확한 통계 계산을 선택하여 정확한 수치를 확인하세요. 먼저 Segment를 저장해야 합니다. 자세한 내용은 추정 수치에 대한 고려 사항을 참조하세요.
• 사용자 미리보기에서 작은 Segment에 대해 사용자가 0명으로 반환되더라도, 반드시 해당 Segment가 비어 있다는 의미는 아닙니다. 정확한 통계 계산을 실행하여 확인하세요. 자세한 내용은 사용자 미리보기를 참조하세요.

소급 Segment 멤버십

Braze는 사용자별 과거 Segment 멤버십 기록을 저장하지 않습니다. 특정 사용자가 과거 발송 시점에 특정 Segment에 포함되어 있었는지 조회할 수 없습니다.

특정 시점의 멤버십을 캡처하려면 Campaign 또는 Canvas를 발송하기 전에 대시보드에서 Segment의 사용자를 내보내거나 /users/export/segment 엔드포인트를 호출하세요. 자세한 내용은 세분화 필터(Segment 멤버십 필터) 및 Segment 데이터를 CSV로 내보내기를 참조하세요.

오류

타겟 오디언스가 너무 복잡하여 실행할 수 없음

이 드문 오류는 타겟 오디언스에 너무 많은 정규식 값, 지나치게 긴 정규식 값, 지나치게 상세한 필터(예: “30,000개의 우편번호 중 하나에 해당”)가 포함되어 있거나 필터가 너무 많을 때 발생합니다. 여기에는 참조된 Segments 내에 있거나 타겟 오디언스 단계에서 필터로 추가된 것을 포함하여, Campaign 또는 Canvas 오디언스의 모든 필터가 해당됩니다.

Campaign 또는 Canvas에 Segment 필터를 추가하면 해당 필터는 Braze 내에서 쿼리로 변환됩니다(이러한 쿼리의 문자 수는 대시보드 사용자가 보는 문자 수와 1:1로 대응하지 않습니다). Braze가 Campaign 또는 Canvas를 발송할 때, 타겟 오디언스의 모든 필터를 결합하는 쿼리를 실행합니다. 타겟 오디언스에 대한 결과 쿼리의 문자 수를 제한하는 임계값이 적용됩니다. 특정 Campaign 또는 Canvas의 경우, 모든 추가 필터를 포함하여 참조된 모든 Segments의 문자 수가 합산됩니다. 특정 Segment의 경우, 모든 필터와 필터 값의 문자 수가 합산됩니다.

Campaign, Canvas 또는 Segment가 임계값을 초과하여 실행할 수 없는 경우 대시보드에 오류가 표시됩니다. 이 오류가 발생하면 다시 실행하기 전에 타겟 오디언스를 단순화하세요:

• 오디언스가 여러 Segments를 참조하는 경우, 동일한 필터가 여러 Segments에 나타나는 것과 같은 중복이 없는지 확인하세요.
• Segment 필터에서 오래된 데이터를 참조하고 있지 않은지 확인하세요. 예를 들어, Canvas가 몇 달 전에 중지되었음에도 지난주에 특정 캔버스 단계를 받지 않은 사용자를 찾는 오래된 필터가 있을 수 있습니다.
• 사용자 ID 또는 이메일 목록으로만 구성된 Segments(주로 정규식 필터를 사용하는 경우)는 CSV 가져오기로 변환하여 단일 CSV 필터로 단순화할 수 있습니다.
• CDI를 사용하는 경우, 데이터 웨어하우스에서 직접 그룹을 가져오는 CDI Segment를 생성할 수 있습니다.

필터 최적화에 대한 추가 지원이 필요하면 고객지원에 문의할 수도 있습니다.

참고

2025년 4월부터 문자 수 제한이 시작되었습니다. 2025년 4월 이전에 실행된 Campaigns 및 Canvases는 면제 대상이므로 제한을 계속 초과할 수 있지만, 새로 생성된 Campaigns 및 Canvases는 제한을 초과할 수 없습니다. 면제된 Campaign 또는 Canvas를 편집하거나 복제하는 경우, 오디언스가 제한 이하로 업데이트될 때까지 실행할 수 없습니다.

X개의 활성 또는 중지된 Campaigns 또는 Canvases가 오디언스 복잡도 임계값을 초과함

이 배너는 활성 또는 중지된 Campaigns 또는 Canvases의 오디언스가 오디언스 복잡도 임계값을 초과할 때마다 Campaign 또는 Canvas 목록 상단에 표시됩니다. 배너를 선택하면 임계값을 초과하는 Campaigns 또는 Canvases만 목록에 필터링되며, 타겟 오디언스가 너무 복잡하여 실행할 수 없음의 문제 해결 단계를 따르세요.

필터가 10,000바이트를 초과하거나 너무 길어서 저장할 수 없음

Braze는 개별 Segment 필터를 최대 10,000바이트로 제한하며, 이는 영어 문자 10,000자 또는 일본어 문자 3,333자에 해당합니다. 필터가 Segment 내에 있든 Campaign 또는 Canvas에 직접 추가되었든, 개별 필터가 10,000바이트를 초과할 때마다 경고가 나타납니다.

이 오류는 매우 드물게 발생하지만, 발생하는 경우 일반적으로 사용자 ID 또는 이메일 주소 목록을 대상으로 하는 정규식 필터에서 나타납니다. 이 경우 다음 단계를 따라 필터를 CSV로 변환할 수 있습니다:

1. 영향을 받는 Segment 또는 특정 정규식 필터에서 사용자를 내보냅니다.
2. 필요에 따라 CSV를 정리합니다. Braze ID 또는 Appboy ID가 필요하지만, 필요하지 않은 다른 열은 모두 제거할 수 있습니다. 또한 데이터가 최신인지 검토하는 것이 좋습니다(예: 더 이상 타겟팅하지 않는 사용자는 제거).
3. CSV 파일을 다시 가져오면 사용자가 자동으로 하나의 효율적인 CSV 기반 필터로 그룹화됩니다.

사용자 행동

사용자가 더 이상 Segment에 포함되지 않음

Segment을 생성하는 동안 사용자가 사용할 수 없는 경우, Segment 자격을 결정하는 사용자 데이터가 사용자 자신의 활동이나 이전에 상호작용한 다른 Campaigns 및 Canvases로 인해 변경되었을 수 있습니다. 재자격이 활성화된 경우, 고객 프로필에는 수신한 Campaign의 최신 데이터가 표시됩니다.

특정 사용자가 오늘 Segment에 해당하는지 테스트하려면 사용자 미리보기 또는 사용자 조회를 사용하세요.

특정 앱으로 필터링할 때 다른 앱 사용자의 정보가 표시됨

사용자는 여러 앱을 사용할 수 있으므로, 세분화 페이지의 사용된 앱 섹션에서 특정 앱을 선택하면 해당 앱을 최소한 하나 이상 보유한 사용자에 대한 결과가 표시됩니다. 이 필터는 해당 앱만 독점적으로 보유한 사용자에 대한 결과를 반환하지 않습니다.

필터링

필터 옵션이 변경됨

필터 옵션은 커스텀 속성에 대해 Braze에 전달하는 형식(데이터 유형)과 관련이 있습니다. Braze가 커스텀 속성에 대해 인식하는 데이터 유형을 확인하려면 데이터 설정 > 커스텀 속성으로 이동하세요.

필터 옵션이 변경되었다면, 이는 데이터가 이전과 다른 형식(데이터 유형)으로 Braze에 전달되고 있다는 것을 나타냅니다. 다양한 데이터 유형 및 필터 옵션에 대한 자세한 설명은 커스텀 속성 데이터 유형을 참조하세요.

대시보드에서 커스텀 속성의 데이터 유형을 변경하면 다른 형식으로 Braze에 전송되는 데이터가 거부된다는 점에 유의하세요. 해당 속성이 활성 Campaign, Canvases 또는 Segments에서 참조되는 동안에는 커스텀 속성의 데이터 유형을 변경할 수 없으며, 대시보드에 오류가 표시되고 변경이 차단됩니다.

커스텀 속성의 Values 탭은 약 250,000명의 사용자 샘플에서 가져온 결과를 표시합니다. 문제 해결을 위해 특정 속성 값이 존재하는지 확인하는 데 Values 탭을 사용하지 마세요. 자세한 내용은 Values 탭을 참조하세요.

중첩된 커스텀 속성을 필터 옵션으로 사용할 수 없음

중첩된 커스텀 속성이 Segment를 구축할 때 필터 옵션으로 표시되지 않는 경우, 먼저 스키마를 생성하세요. 데이터 설정 > 커스텀 속성으로 이동하여 해당 속성을 찾고 스키마 생성을 선택하세요. 생성이 완료되면 Segment 필터 드롭다운에서 해당 속성을 사용할 수 있습니다. 자세한 내용은 중첩 객체 탐색기를 사용하여 스키마 생성을 참조하세요.

Segment가 예상보다 훨씬 큼

Segment가 제한적으로 보이는 필터에도 불구하고 예상보다 훨씬 큰 경우, 동일한 속성에 대해 부정 필터(is not, does not equal, does not match regex 또는 not included)를 OR 연산자와 함께 두 번 이상 사용하고 있는지 확인하세요. 이 조합은 해당 속성의 모든 값을 가진 사용자를 타겟팅할 수 있습니다.

OR 대신 AND를 사용해야 하는 경우에 대한 안내는 Segment 만들기의 OR 연산자를 피해야 하는 경우를 참조하세요.

분석 및 보고

Campaign Analytics에서 발송된 메시지 또는 고유 수신자가 Segment 수와 일치하지 않음

Campaign 분석에서 발송된 메시지 또는 고유 수신자 수가 Has received message from campaign X Segment 필터의 사용자 수와 일치하지 않는 경우, 세 가지 가능한 이유가 있을 수 있습니다.

1. Campaign 시작 이후 사용자가 아카이브, 고아 상태가 되거나 삭제되었을 수 있습니다
   
   예를 들어, 1,000명의 사용자가 Campaign을 수신하고 같은 날 CSV 내보내기를 수행한다고 가정해 보겠습니다. 1,000명의 사용자가 보고됩니다. 그 후 한 달 동안 해당 1,000명 중 50명이 삭제됩니다(예: users/delete 엔드포인트를 통해). 다시 CSV 내보내기를 하면 950명의 사용자가 보고되지만, Campaign Analytics의 고유 수신자 수는 여전히 1,000으로 표시됩니다.
   
   즉, 고유 수신자 지표는 누적 카운트이며, 세그멘터와 CSV 내보내기는 현재 존재하는 사용자의 수를 제공합니다.
   
   

2. Campaign에 재자격이 설정되어 있어 사용자가 Campaign에 여러 번 재진입할 수 있습니다
   
   예를 들어, 이메일 Campaign에 재자격이 0분으로 설정되어 있고(사용자가 오디언스 Segment 요건을 충족하는 한 Campaign에 재진입할 수 있음) Campaign이 한 달 이상 실행되었다고 가정해 보겠습니다. Campaign Analytics의 발송된 메시지 수는 이 필드에 중복 사용자에게 보낸 메시지가 포함되기 때문에 Segment의 수와 일치하지 않을 수 있습니다.
   
   이는 Braze가 고유 사용자를 일일 고유 수신자, 즉 하루 동안 특정 메시지를 수신한 사용자 수로 카운트하기 때문입니다. 재자격 사용자는 “고유” 기간이 하루에 불과하므로 고유 수신자로 여러 번 카운트됩니다. 이로 인해 일일 고유 수신자 수가 CSV 내보내기의 고객 프로필 수보다 높을 수 있습니다. CSV 파일의 고객 프로필은 진정한 고유 값입니다.
   
   

3. 채널 식별자를 공유하는 사용자가 필터에 매칭되었습니다
   
   Has received message from campaign X 필터(및 기타 “received” 필터)는 동일한 푸시 토큰이나 이메일 주소 등 채널 식별자를 다른 고객 프로필과 공유하는 사용자와 매칭될 수 있으며, 해당 프로필이 메시지를 수신, 열람 또는 클릭한 경우에 해당합니다.

하나의 앱에서만 세션을 기록했음에도 사용자가 두 개의 앱에 할당됨

Segment를 생성할 때 특정 앱을 사용한 사용자를 타겟팅할 수 있습니다. 사용자가 특정 앱에 할당되려면 해당 앱에서 세션을 가져야 하지만, 앱에서 세션을 기록하지 않고도 사용자가 특정 앱에 할당될 수 있는 두 가지 시나리오가 있습니다.

첫 번째 시나리오는 /users/track 엔드포인트를 사용할 때 app_id 필드가 채워지는 경우입니다. 구체적으로 다음 예시처럼 이벤트 또는 구매 객체를 사용할 때입니다:

1
2
3
4
5
6
7
8
9
10
{
    "events": [
    {
      "external_id": "john_doe123",
      "app_id": "my_web_app_id",
      "name": "Custom Event",
      "time": "2025-08-17T19:20:30+1:00"
    }
  ]
}

두 번째 시나리오는 /users/track 엔드포인트를 사용하여 푸시 토큰을 마이그레이션할 때 app_id 필드가 채워지는 경우입니다. 예시는 다음과 같습니다:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"app_group_id": "{YOUR_APP_GROUP_ID}",
"attributes": [
{
      "push_token_import": false,
      "external_id": "external_id1",
      "country": "US",
      "language": "en",
      "{YOUR_CUSTOM_ATTRIBUTE}": "{YOUR_VALUE}",
      "push_tokens": [
        {"app_id": "{APP_ID_OF_OS}", "token": "{PUSH_TOKEN_STRING}"}
      ]
  }
]
}