날짜 범위로 카탈로그 항목 필터링

이 예제에서는 가상의 티켓 마켓플레이스가 카탈로그 셀렉션과 Liquid 날짜 표현식을 사용하여 발송 시점으로부터 향후 7일 이내에 예정된 이벤트만 소비자에게 이메일로 보내는 방법을 보여줍니다. 롤링 시간 필터가 적용된 셀렉션을 생성한 다음, 일치하는 카탈로그 항목을 Campaign 또는 Canvas 메시지에 렌더링합니다.

이 예제 소개

가상의 티켓 마켓플레이스인 MovieCanon은 이메일 Campaign에 시간적으로 관련 있는 콘서트와 공연만 표시하기 위해 이 패턴을 사용합니다.

이 패턴은 두 가지 Braze 기능을 함께 사용합니다:

• 전송 시점에 롤링 시간 범위를 계산하는 Liquid 스니펫을 값으로 사용하는 time 필드 필터가 포함된 카탈로그 셀렉션
• 메시지 본문에서 일치하는 카탈로그 행을 렌더링하는 {% catalog_selection_items %} Liquid 태그

고려 사항

• 필터링할 날짜/시간 열에는 문자열 필드가 아닌 카탈로그 time 필드를 생성하세요. 값은 2026-06-20T19:30:00Z와 같은 ISO 8601 형식으로 저장하세요. 지원되는 유형에 대해서는 지원되는 데이터 유형을 참조하세요.
• before 및 after 연산자는 엄격한 비교를 사용합니다. 경계 타임스탬프와 정확히 동일한 이벤트는 제외될 수 있습니다. 전송 시간에 기간을 시작해야 하는 경우 전체 타임스탬프를 사용하세요. 날짜만 포함된 YYYY-MM-DD 값은 해당 날짜의 UTC 자정으로 변환됩니다.
• 선택 필터의 Liquid는 전송 시점에 평가됩니다. 'now' 변수는 메시지가 렌더링되는 시점을 반영하며, 일반적으로 UTC 기준입니다. 결과 기간이 시간대에 관계없이 의도와 일치하는지 확인하세요.
• 연결된 콘텐츠, Content Blocks, 카탈로그 태그 및 abort_message는 카탈로그 선택 필터 값에서 지원되지 않습니다. 필터에 허용되지 않는 태그가 포함된 경우, 선택은 오류를 발생시키지 않고 항목을 반환하지 않습니다.
• 선택당 최대 10개의 필터를 추가하고 최대 50개의 항목을 반환할 수 있습니다. 'now'에 추가하는 초 값을 변경하여 7일 기간을 조정할 수 있습니다(604800 = 7일 × 하루 86400초).
• 카탈로그 선택 결과 배열은 0부터 인덱싱됩니다(items[0]이 첫 번째 항목).
• 프로덕션 오디언스에게 전송하기 전에 프로덕션 워크스페이스 외부에서 필터 Liquid, 메시지 Liquid 및 중단 로직을 테스트하세요.

설정

이 예제에서는 다음 필드를 가진 live_events라는 카탈로그를 사용한다고 가정합니다:

유사한 카탈로그가 아직 없다면, 카탈로그를 생성하고 이벤트 데이터를 업로드하거나 동기화하세요.

1단계: 카탈로그 셀렉션 만들기

1. 데이터 설정 > 카탈로그로 이동하여 live_events 카탈로그를 선택합니다.
2. 셀렉션 탭을 열고 셀렉션 만들기를 선택합니다.
3. 셀렉션 이름을 seven_day_window로 지정하고, “향후 7일 이내에 발생하는 이벤트”와 같은 선택적 설명을 추가합니다.
4. 반환할 최대 이벤트 수에 대한 결과 제한을 설정합니다(최대 50개).
5. 아직 저장하지 마세요. 다음 단계에서 날짜 필터를 추가합니다.

2단계: 상한 필터 추가

event_date_time 필드에 필터를 추가합니다:

필터 값 필드에 이 Liquid 스니펫을 입력합니다. 이 스니펫은 발송 시점으로부터 7일 후의 타임스탬프를 계산합니다:

1

{% assign seven_days = 'now' | date: '%s' | plus: 604800 %}{{ seven_days | date: "%Y-%m-%dT%H:%M:%SZ" }}

이렇게 하면 해당 타임스탬프 이전의 이벤트만 포함되도록 윈도우의 상한이 설정됩니다.

3단계: 하한 필터 추가

동일한 필드에 두 번째 필터를 추가합니다:

하한에 대해 이 Liquid 스니펫을 입력합니다. 현재 발송 시간을 사용하여 이미 시작된 이벤트는 제외됩니다:

1

{{ 'now' | date: "%Y-%m-%dT%H:%M:%SZ" }}

두 필터를 함께 사용하면 event_date_time이 현재 발송 시간 이후이고 발송 시간으로부터 7일 이전인 카탈로그 항목이 반환됩니다. 셀렉션 만들기를 선택하여 저장합니다.

4단계: 메시지에서 셀렉션 참조

Campaign 또는 Canvas 메시지에서 셀렉션의 항목을 가져오는 Liquid를 삽입합니다. 개인화 추가(카탈로그 항목 > 셀렉션 사용)를 사용하거나 태그를 직접 붙여넣을 수 있습니다:

1
2
3
4
5
6
7
8

{% catalog_selection_items live_events seven_day_window %}
Here are some upcoming events:

{{ items[0].event_name }} — ${{ items[0].ticket_price }}
{{ items[0].city }} · {{ items[0].venue }}

{{ items[1].event_name }} — ${{ items[1].ticket_price }}
{{ items[1].city }} · {{ items[1].venue }}

가변적인 수의 결과를 렌더링해야 하는 경우 하드코딩된 배열 인덱스를 루프로 대체하세요.

5단계: 빈 결과 처리

셀렉션에 일치하는 카탈로그 항목이 없으면 items 배열이 비어 있고 태그된 블록은 아무것도 렌더링하지 않습니다. 발송을 건너뛰거나 대체 문구를 표시하려면 태그를 조건문으로 감싸세요:

1
2
3
4
5
6
7

{% catalog_selection_items live_events seven_day_window %}
{% if items.size == 0 %}
{% abort_message('Catalog selection returned 0 items') %}
{% endif %}

Here are some upcoming events:
{{ items[0].event_name }}

자세한 내용은 메시지 중단을 참조하세요.

관련 문서

• 카탈로그 만들기
• 선택 항목
• Campaigns에서 카탈로그 사용하기
• Liquid date 필터
• Liquid 사용 사례 라이브러리