메시지에서 카탈로그 사용

카탈로그를 생성한 후, 리퀴드를 통해 Braze 캠페인에서 비사용자 데이터를 참조할 수 있습니다. Liquid가 지원되는 드래그 앤 드롭 편집기의 어느 곳에서나 모든 메시징 채널에서 카탈로그를 사용할 수 있습니다.

1단계: 개인화 유형 추가

선택한 메시지 작성기에서 더하기 아이콘을 선택하여 개인화 추가 모달을 열고 개인화 유형에 대한 카탈로그 항목을 선택합니다. 그런 다음 카탈로그 이름을 선택합니다. 이전 예제를 사용하여 ‘게임’ 카탈로그를 선택하겠습니다.

다음과 같은 Liquid 미리 보기를 즉시 확인할 수 있습니다:

1
{% catalog_items Games %}

2단계: 카탈로그 항목 선택

이제 카탈로그 항목을 추가할 차례입니다! 드롭다운을 사용하여 카탈로그 항목과 표시할 정보를 선택합니다. 이 정보는 카탈로그 생성에 사용된 업로드한 CSV 파일의 열에 해당합니다.

예를 들어, 테일즈 게임의 제목과 가격을 참조하려면 카탈로그 항목으로 테일즈(1234)용 id 을 선택하고 title 및 price 을 요청하여 정보를 표시할 수 있습니다.

1
2
3
{% catalog_items Games 1234 %}
 
Get {{ items[0].title }} for just {{ items[0].price }}!

이렇게 하면 다음과 같이 렌더링됩니다:

테일즈를 단 7.49달러에 만나보세요!

추가 사용 사례

여러 항목

하나의 메시지에 하나의 항목으로만 제한되지 않습니다! 개인화 추가 모달을 사용하여 표시할 추가 카탈로그 항목과 정보를 삽입하기만 하면 됩니다. 카탈로그 항목은 최대 3개까지만 추가할 수 있습니다.

이 예제에서는 카탈로그 항목에 세 가지 게임인 테일즈, 테슬라그라드, 아카라투스의 id 을 추가하고 표시할 정보에 title 을 선택합니다.

리퀴드 주변에 텍스트를 추가하여 메시지를 더욱 맞춤화할 수 있습니다:

1
2
Get the ultimate trio {% catalog_items games 1234 1235 1236 %}
{{ items[0].title }}, {{ items[1].title }}, and {{ items[2].title }} today!

그러면 다음과 같이 반환됩니다:

지금 테일즈, 테슬라그라드, 아카라투스의 궁극의 트리오를 만나보세요!

Liquid if 문 사용

카탈로그 항목을 사용하여 조건문을 만들 수 있습니다. 예를 들어 캠페인에서 특정 아이템이 선택되면 특정 메시지를 표시하도록 트리거할 수 있습니다.

이를 위해 다음과 같은 형식의 Liquid if 문을 사용합니다:

1
2
3
4
5
6
{% catalog_items Test-list %}
{% if {{items[0].first-item}} == true %}
Do this
{% else %}
Do that
{% endif %}

if 문을 사용하기 전에 카탈로그 목록을 선언해야 합니다. 위의 예에서 Test-list 은 카탈로그 목록입니다.

사용 사례: 액체 if 스니펫

이 시나리오에서는 사용자 지정 속성 venue_name 이 10자를 초과하거나 10자 미만인 경우 다른 메시지가 표시됩니다. venue_name 이 blank 인 경우 아무것도 표시되지 않습니다.

1
2
3
4
5
6
7
8
{% catalog_selection_items item-list selections %} 
{% if items[0].venue_name.size > 10 %}
Message if the venue name's size is more than 10 characters. 
{% elsif items[0].venue_name.size < 10 %}
Message if the venue name's size is less than 10 characters. 
{% else %} 
{% abort_message(no venue_name) %} 
{% endif %}

이미지 사용

카탈로그에서 이미지를 참조하여 메시징에 사용할 수도 있습니다. 이렇게 하려면 Liquid 필드에서 이미지에 catalogs 태그와 item 개체를 사용합니다.

예를 들어, 게임 카탈로그의 image_link 을 테일즈 프로모션 메시지에 추가하려면 카탈로그 항목 필드에 id 을 선택하고 표시할 정보 필드에 image_link 을 선택합니다. 이렇게 하면 이미지 필드에 다음 Liquid 태그가 추가됩니다:

1
2
3
{% catalog_items Games 1234 %}

{{ items[0].image_link }}

![이미지 필드에 사용되는 카탈로그 리퀴드 태그가 있는 콘텐츠 카드 작성기입니다.][3]

리퀴드가 렌더링되었을 때의 모습은 다음과 같습니다:

![카탈로그 Liquid 태그가 렌더링된 콘텐츠 카드 예시.][4]{: style=”max-width:50%” }

카탈로그 항목 템플릿 지정

템플릿을 사용하여 사용자 지정 속성을 기반으로 카탈로그 항목을 동적으로 가져올 수도 있습니다. 예를 들어 사용자가 카탈로그의 게임 ID 배열을 포함하는 사용자 지정 속성 wishlist 을 가지고 있다고 가정해 보겠습니다.

1
2
3
4
5
6
7
8
{
    "attributes": [
        {
            "external_id": "user_id",
            "wishlist": ["1234", "1235"]
        }
    ]
}

Liquid 템플릿을 사용하면 위시리스트 ID를 동적으로 가져와서 메시지에서 사용할 수 있습니다. 이렇게 하려면 [사용자 지정 속성에][10] 변수를 지정한 다음 개인화 추가 모달을 사용하여 배열에서 특정 항목을 가져옵니다.

예를 들어, 사용자에게 테일즈(카탈로그에서 사용자가 원했던 아이템)가 세일 중임을 알리기 위해 메시지 작성기에 다음을 추가할 수 있습니다:

1
2
3
4
{% assign wishlist = {{custom_attribute.${wishlist}}}%}
{% catalog_items Games {{ wishlist[0] }} %}

Get {{ items[0].title }} now, for just {{ items[0].price }}!

다음과 같이 표시됩니다:

지금 테일즈를 단 7.49달러에 만나보세요!

템플릿을 사용하면 개별 사용자 지정 속성, 이벤트 속성 또는 기타 템플릿 가능한 필드에 따라 각 사용자마다 다른 카탈로그 항목을 렌더링할 수 있습니다.

CSV 업로드하기

추가할 새 카탈로그 항목의 CSV를 업로드하거나 업데이트할 항목을 카탈로그화할 수 있습니다. 항목 목록을 삭제하려면 항목 ID의 CSV를 업로드하여 삭제할 수 있습니다.

액체 사용

카탈로그를 수동으로 구성하여 Liquid 로직을 구성할 수도 있습니다. 그러나 존재하지 않는 ID를 입력해도 Braze는 여전히 객체가 없는 항목 배열을 반환한다는 점에 유의하세요. 배열의 크기를 확인하고 if 문을 사용하여 빈 배열의 경우를 고려하는 등의 오류 처리를 포함할 것을 권장합니다.