Skip to content

연결된 오디언스 객체

연결된 오디언스 개체는 메시징의 오디언스를 식별합니다. 예를 들어 커스텀 속성 배열을 사용하여 사용자가 즐겨찾기를 지정한 모든 카테고리와 TV 프로그램을 추적하는 경우, 연결된 오디언스를 사용하면 각 프로그램에 대해 세그먼트를 설정할 필요 없이 새 에피소드가 공개될 때마다 해당 프로그램을 즐겨찾기한 모든 사용자에게 푸시 알림이나 이메일을 자동으로 보낼 수 있습니다.

이 개체는 단일 연결된 대상 필터 또는 AND 또는 OR 연산자를 사용하는 논리 표현식의 여러 연결된 대상 필터로 구성됩니다.

다중 필터 예시:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "AND":
    [
      Connected Audience Filter,
      {
        "OR" :
          [
            Connected Audience Filter,
            Connected Audience Filter
          ]
      },
      Connected Audience Filter
    ]
}

연결된 오디언스 필터

여러 커스텀 속성 필터를 ANDOR 연산자와 결합하면 연결된 오디언스 필터가 생성됩니다.

사용자 지정 속성 필터

이 필터를 사용하면 사용자의 사용자 지정 속성을 기반으로 세분화할 수 있습니다. 이러한 필터에는 최대 3개의 필드가 포함됩니다:

1
2
3
4
5
6
7
8
{
  "custom_attribute":
    {
      "custom_attribute_name": (String) the name of the custom attribute to filter on,
      "comparison": (String) one of the allowed comparisons to make against the provided value,
      "value": (String, Numeric, Boolean) the value to be compared using the provided comparison
    }
}

데이터 유형별 비교 허용

사용자 지정 속성의 데이터 유형에 따라 지정된 필터에 유효한 비교가 결정됩니다.

속성 비교 시 주의 사항

사용자 지정 속성 예제

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  "custom_attribute":
    {
      "custom_attribute_name": "eye_color",
      "comparison": "equals",
      "value": "blue"
    }
}

{
  "custom_attribute":
  {
    "custom_attribute_name": "favorite_foods",
    "comparison": "includes_value",
    "value": "pizza"
  }
}

{
  "custom_attribute":
  {
    "custom_attribute_name": "last_purchase_time",
    "comparison": "less_than_x_days_ago",
    "value": 2
  }
}

푸시 구독 필터

이 필터를 사용하면 사용자의 푸시 구독 상태를 기준으로 세분화할 수 있습니다.

필터 본문

1
2
3
4
5
6
7
{
  "push_subscription_status":
  {
    "comparison": (String) one of the following allowed comparisons,
    "value": (String) one of the following allowed values
  }
}
  • 허용된 비교: is, is_not
  • 허용되는 값입니다: opted_in, subscribed, unsubscribed

이메일 구독 필터

이 필터를 사용하면 사용자의 이메일 구독 상태를 기준으로 세분화할 수 있습니다.

필터 본문

1
2
3
4
5
6
7
{
  "email_subscription_status":
  {
    "comparison": (String) one of the following allowed comparisons,
    "value": (String) one of the following allowed values
  }
}
  • 허용된 비교: is, is_not
  • 허용되는 값입니다: opted_in, subscribed, unsubscribed

마지막으로 사용한 앱 필터

이 필터를 사용하면 사용자가 마지막으로 앱을 사용한 시간을 기준으로 세그먼트를 세분화할 수 있습니다. 이 필터에는 두 개의 필드가 포함되어 있습니다:

필터 본문

1
2
3
4
5
6
7
{
  "last_used_app":
  {
    "comparison": (String) one of the allowed comparisons listed,
    "value": (String) the value to be compared using the provided comparison
  }
}
  • 허용된 비교: after, before
  • 허용되는 값: 날짜/시간(ISO 8601 문자열)

고려 사항

연결된 오디언스는 기본 속성, 사용자 지정 이벤트, 세그먼트 또는 메시지 참여 이벤트를 기준으로 사용자를 필터링할 수 없습니다. 이러한 필터를 사용하려면 오디언스 세그먼트에 통합한 다음 /messages/send 엔드포인트의 segment_id 파라미터에 해당 세그먼트를 지정하는 것이 좋습니다. 다른 엔드포인트를 사용할 때는 먼저 API 트리거 캠페인이나 Braze 대시보드의 캔버스에 세그먼트를 추가해야 합니다.

New Stuff!