세그먼트 문제 해결

오류

대상 오디언스가 너무 복잡하여 시작할 수 없습니다

이 드문 오류는 대상 오디언스에 너무 많은 정규식 값, 지나치게 긴 정규식 값, 지나치게 상세한 필터(예: “30,000개의 우편번호 중 하나”) 또는 너무 많은 필터가 포함된 경우 발생합니다. 이는 참조된 세그먼트 내에 위치한 필터이든 대상 오디언스 단계에 필터로 추가된 것이든 캠페인 또는 캔버스 오디언스의 모든 필터를 포함합니다.

캠페인이나 캔버스에 세그먼트 필터를 추가하면 이러한 필터는 Braze에서 쿼리로 변환됩니다(이 쿼리의 문자 수는 대시보드 사용자가 보는 문자 수와 1:1이 아닙니다). Braze가 캠페인이나 캔버스를 보낼 때, 우리는 대상 오디언스의 모든 필터를 결합한 쿼리를 실행합니다. 대상 오디언스에 대한 결과 쿼리의 문자 수를 제한하는 임계값을 적용합니다. 주어진 캠페인이나 캔버스에 대해, 우리는 참조된 모든 세그먼트의 문자 수를 합산하며, 모든 추가 필터를 포함합니다. 주어진 세그먼트에 대해, 우리는 모든 필터와 필터 값의 문자 수를 합산합니다.

캠페인, 캔버스 또는 세그먼트가 임계값을 초과하고 시작할 수 없을 때 대시보드에 오류가 표시됩니다. 이 오류가 발생하면 다시 시작하기 전에 대상 오디언스를 단순화하십시오. 포함할 내용은 다음과 같습니다:

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

필터 최적화에 대한 추가 지원을 원하시면 지원팀에 문의할 수 있습니다.

X개의 활성 또는 중지된 캠페인이나 캔버스가 청중 복잡성 임계값을 초과합니다.

이 배너는 활성 또는 중지된 캠페인이나 캔버스의 청중이 청중 복잡성 임계값을 초과할 때마다 캠페인 또는 캔버스 목록의 상단에 표시됩니다. 배너를 선택하여 임계값을 초과하는 캠페인이나 캔버스만 필터링한 후, 대상 청중이 너무 복잡하여 시작할 수 없음의 문제 해결 단계를 따르십시오.

필터가 10,000바이트를 초과하거나 저장하기에는 너무 깁니다.

Braze는 개별 세그먼트 필터를 최대 10,000바이트로 제한하며, 이는 10,000개의 영어 문자 또는 3,333개의 일본어 문자에 해당합니다. 개별 필터가 10,000바이트를 초과할 때마다 경고가 나타나며, 필터가 세그먼트 내에 있거나 캠페인 또는 캔버스에 직접 추가된 경우 모두 해당됩니다.

![10,000자를 초과하는 속성 값을 가진 사용자 정의 속성 필터에 대한 오류입니다.menu_item,

이 오류는 매우 드물게 발생하지만, 발생할 경우 일반적으로 사용자 ID 또는 이메일 주소 목록을 대상으로 하는 정규식 필터와 관련이 있습니다. 이 경우 필터를 CSV로 변환하기 위해 다음 단계를 따르십시오:

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

사용자 행동

사용자가 더 이상 세그먼트에 없습니다

사용자가 세그먼트를 생성하는 동안 사용할 수 없는 경우, 세그먼트 적격성을 결정하는 사용자 데이터는 사용자의 활동이나 이전에 상호 작용한 다른 캠페인 및 캔버스의 결과로 변경되었을 수 있습니다. 재적격이 활성화된 경우 고객 프로필에 수신된 캠페인의 최신 데이터가 표시됩니다.

내가 특정 앱을 필터링할 때 다른 앱의 사용자에게 정보가 표시됩니다

사용자는 여러 개의 앱을 가질 수 있으므로 세분화 페이지의 사용된 앱 섹션에서 특정 앱을 선택하면 적어도 해당 앱을 가진 사용자의 결과가 표시됩니다. 필터는 해당 앱만 사용하는 사용자에게는 결과를 제공하지 않습니다.

필터링

필터 옵션 변경

필터 옵션은 사용자 지정 속성을 위해 Braze에 전달하는 형식(데이터 유형)과 관련이 있습니다. Braze가 사용자 지정 속성에 대해 인식하는 데이터 유형을 검토하려면 데이터 설정 > 사용자 지정 속성으로 이동하세요.

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

대시보드에서 커스텀 속성의 데이터 유형을 변경하면 다른 형식으로 Braze에 전송된 데이터는 거부된다는 점에 유의하세요.

분석 및 보고

메시지 전송 또는 고유 수신자 캠페인 분석에서 세그먼트 수와 일치하지 않습니다.

캠페인 분석에서 메시지 발송 또는 고유 수신자 수가 세그먼트 필터 Has received message from campaign X의 사용자 수와 일치하지 않는 경우, 두 가지 가능한 이유가 있을 수 있습니다:

1. 사용자가 캠페인 시작 이후 보관되었거나 고아가 되었거나 삭제되었을 수 있습니다
   
   예를 들어, 1,000명의 사용자가 캠페인을 받고 같은 날 CSV 내보내기를 한다고 가정해 보겠습니다. 1,000명의 사용자가 보고됩니다. 다음 달 동안 1,000명의 사용자 중 50명이 삭제됩니다(예: users/delete 엔드포인트에 의해). 다른 CSV 내보내기를 하면 고유 수신자 수가 캠페인 분석에서 여전히 1,000명인 동안 950명의 사용자가 보고됩니다.
   
   다시 말해, 고유 수신자 메트릭은 증가된 수치인 반면, 세그먼터와 CSV 내보내기는 현재 존재하는 사용자의 수를 제공합니다.
   
   

2. 캠페인은 재진입 가능성이 설정되어 있어 사용자가 여러 번 캠페인에 다시 참여할 수 있습니다
   
   예를 들어, 이메일 캠페인의 재참여 가능 시간이 0분으로 설정되어 있는 경우(사용자가 오디언스 세그먼트 요구 사항을 충족하는 한 캠페인에 다시 참여할 수 있음), 캠페인이 한 달 이상 실행되고 있는 상황입니다. 보낸 메시지 수는 캠페인 분석에서 세그먼트의 수와 일치하지 않습니다. 이 필드는 중복 사용자에게 보낸 메시지를 포함하기 때문입니다.
   
   이것은 Braze가 고유 사용자를 고유 일일 수신자로 계산하거나 하루 동안 특정 메시지를 받은 사용자 수로 계산하기 때문입니다. 이것은 재자격성을 갖춘 사용자가 고유 수신자로 하루 동안만 지속되는 “고유” 창에서 한 번 이상 계산된다는 것을 의미합니다. 이로 인해 고유 일일 수신자 수가 CSV 내보내기의 고객 프로필 수보다 많아질 수 있습니다. CSV 파일에 있는 사용자 프로필은 진정으로 고유할 것입니다.

사용자가 한 앱에서만 세션을 기록했음에도 불구하고 두 앱에 할당됩니다.

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

첫 번째 시나리오는 app_id 필드가 /users/track 엔드포인트를 사용할 때 채워져 있는 경우입니다—특히 이벤트 또는 구매 객체를 사용할 때, 다음 예와 같이:

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"
    }
  ]
}

두 번째 시나리오는 app_id 필드가 푸시 티켓을 마이그레이션하기 위해 /users/track 엔드포인트를 사용할 때 채워져 있는 경우입니다, 다음 예와 같이:

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}"}
      ]
  }
]
}