카탈로그 만들기

카탈로그를 만들려면 비사용자 데이터의 CSV 파일을 Braze로 가져와야 합니다. 그러면 해당 정보에 액세스하여 메시지를 더욱 풍부하게 만들 수 있습니다. 모든 유형의 데이터를 카탈로그로 가져올 수 있습니다. 이 데이터는 일반적으로 전자상거래 비즈니스의 제품 정보나 교육 제공업체의 강좌 정보와 같은 회사의 일종의 메타데이터입니다.

카탈로그의 일반적인 사용 사례는 다음과 같습니다:

• 제품
• 서비스
• 음식
• 예정된 이벤트
• 음악
• 패키지

이 정보를 가져온 후에는 Liquid를 통해 사용자 지정 속성이나 사용자 지정 이벤트 속성에 액세스하는 것과 비슷한 방식으로 메시지에서 해당 정보에 액세스할 수 있습니다.

CSV 파일 준비하기

카탈로그를 생성하기 전에 선호하는 카탈로그 생성 방법을 업로드하는 경우 CSV 파일을 준비해야 합니다.

CSV 파일 가이드라인

CSV 파일을 만들 때 다음 가이드라인을 참고하세요. CSV 파일의 첫 번째 열은 id 의 헤더여야 하며 각 항목의 id 은 고유해야 합니다. 다른 모든 열 이름은 고유해야 합니다. 또한 카탈로그 CSV 파일에는 다음과 같은 제한 사항이 적용됩니다:

• 최대 1,000개 필드(열)
• 최대 250자의 필드(열) 이름
• 회사 전체에 걸쳐 모든 CSV 파일을 합쳐 최대 100MB(무료)
• 최대 CSV 파일 크기 2GB(Pro)
• 최대 필드 값(셀) 5,000자
• id 및 헤더 값에는 문자, 숫자, 하이픈, 밑줄만 사용할 수 있습니다.

또한 CSV 파일의 모든 텍스트 서식을 소문자로 지정하는 것이 좋습니다. 다음 단계에서 CSV 파일을 성공적으로 업로드하려면 UTF-8 형식을 사용하여 CSV 파일을 인코딩하고 있는지 확인하세요.

방법 선택

카탈로그를 만들려면 데이터 설정 > 카탈로그로 이동합니다.

새 카탈로그 만들기를 클릭한 다음 CSV 업로드 또는 브라우저에서 만들기를 선택합니다.

방법 1: CSV 업로드

1. 파일을 업로드 영역으로 끌어다 놓거나 CSV 업로드를 클릭하고 파일을 선택합니다.
   
   
   
2. 각 열에 대해 부울, 숫자, 문자열 또는 시간 중 하나의 데이터 유형을 선택합니다.
   
   
   
3. 카탈로그에 이름을 지정합니다. 카탈로그 이름에 대한 다음 요구 사항을 염두에 두세요:
   • 고유해야 합니다.
   • 최대 250자
   • 숫자, 문자, 하이픈, 밑줄만 포함할 수 있습니다.
     
     
4. (선택 사항) 카탈로그에 대한 설명을 추가합니다.
5. 카탈로그 프로세스를 클릭하여 카탈로그를 생성합니다.

카탈로그 이름에 템플릿을 사용할 수도 있습니다. 예를 들어 다음을 사용할 수 있습니다:

1
2
3
4
{% assign language = "content_spanish" %}

{% catalog_items language fall_campaign %}
{{ items[0].body }}

브라우저에서 카탈로그 생성을 선택한 후 CSV 파일을 업데이트할 수도 있습니다. 카탈로그 업데이트 > CSV 업로드를 클릭한 다음 카탈로그의 항목을 업데이트, 추가 또는 삭제할지 여부를 선택합니다.

방법 2: 브라우저에서 만들기

1. 카탈로그의 이름을 입력합니다. 카탈로그 이름에 대한 다음 요구 사항을 염두에 두세요:
   • 고유해야 합니다.
   • 최대 250자
   • 숫자, 문자, 하이픈, 밑줄만 포함할 수 있습니다.
     
     
     
2. (선택 사항) 카탈로그에 대한 설명을 입력합니다.
3. 목록 카탈로그 페이지에서 방금 생성한 카탈로그를 선택하여 카탈로그를 업데이트합니다.
4. 카탈로그 업데이트 > 필드 추가를 클릭하여 필드를 추가합니다. 그런 다음 필드 이름을 입력하고 드롭다운을 사용하여 데이터 유형을 선택합니다. 필요에 따라 반복합니다.
   
   
   
5. 카탈로그 업데이트 > 항목 추가를 클릭하여 이전에 추가한 필드를 기반으로 정보를 입력하여 카탈로그에 항목을 추가합니다. 그런 다음 항목 저장 또는 저장 후 다른 항목 추가를 클릭하여 항목을 계속 추가합니다.
   

브라우저에서 카탈로그 생성을 선택한 후 CSV 파일을 업로드할 수도 있습니다.

튜토리얼: CSV 파일에서 카탈로그 만들기

이 튜토리얼에서는 두 개의 게임과 해당 게임 비용, 이미지 링크가 나열된 카탈로그를 사용합니다.

CSV 파일을 업로드하여 카탈로그를 생성합니다. id, title, price, image_link 의 데이터 유형은 각각 문자열, 문자열, 숫자, 문자열입니다.

다음으로 이 카탈로그의 이름을 “games_catalog”로 지정하고 카탈로그 처리 버튼을 클릭합니다. 그러면 Braze는 카탈로그를 생성하기 전에 카탈로그에 오류가 있는지 확인합니다.

카탈로그가 생성된 후에는 이 이름을 편집할 수 없다는 점에 유의하세요. 카탈로그를 삭제하고 동일한 카탈로그 이름을 사용하여 업데이트된 버전을 다시 업로드할 수 있습니다.

카탈로그를 생성한 후에는 캠페인에서 카탈로그를 참조할 수 있습니다.

API를 통한 카탈로그 관리

더 많은 카탈로그를 구축할 때 목록 카탈로그 엔드포인트를 사용하여 워크스페이스에 있는 카탈로그 목록을 반환할 수도 있습니다.

카탈로그 항목 관리

카탈로그를 관리하는 것 외에도 비동기 및 동기 엔드포인트를 사용하여 카탈로그 항목을 관리할 수도 있습니다. 여기에는 카탈로그 항목을 편집 및 삭제하고 카탈로그 항목 세부 정보를 나열하는 기능이 포함됩니다.

예를 들어 개별 카탈로그 항목을 편집하려는 경우 /catalogs/catalog_name/items/item_id 엔드포인트를 사용할 수 있습니다.

추가 사용 사례

여러 항목

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

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

![][6]{: style=”max-width:70%” }

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

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 1234 %}
{% 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 venue-list venue_selection %} 
{% 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 %}

이 시나리오에서는 catalog_items 대신 catalog_selection_items 을 사용합니다. 이는 venue-list 이 카탈로그 이름이고 venue_selection 이 선택 항목이기 때문에 선택 항목에서 항목을 가져오는 것입니다.

이미지 사용

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

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

1
2
3
{% catalog_items Games 1234 %}

{{ items[0].image_link }}

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

카탈로그 항목 템플릿 지정

템플릿을 사용하여 사용자 지정 속성을 기반으로 카탈로그 항목을 동적으로 가져올 수도 있습니다. 예를 들어 사용자가 카탈로그의 게임 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 문을 사용하여 빈 배열의 경우를 고려하는 등의 오류 처리를 포함할 것을 권장합니다.

카탈로그 엔드포인트를 활용하여 증가하는 데이터와 정보를 관리할 수 있습니다. 여기에는 카탈로그 항목을 생성, 편집, 삭제하고 카탈로그 항목 세부 정보를 나열하는 기능이 포함됩니다.

예를 들어 카탈로그 만들기 엔드포인트를 사용하여 카탈로그를 만들 수 있습니다. 더 많은 카탈로그를 구축할 때 목록 카탈로그 엔드포인트를 사용하여 워크스페이스에 있는 카탈로그 목록을 반환할 수도 있습니다.

카탈로그를 관리하는 것 외에도 비동기 및 동기 엔드포인트를 사용하여 카탈로그 항목을 관리할 수도 있습니다. 여기에는 카탈로그 항목을 편집 및 삭제하고 카탈로그 항목 세부 정보를 나열하는 기능이 포함됩니다. 예를 들어 개별 카탈로그 항목을 편집하려는 경우 /catalogs/catalog_name/items/item_id 엔드포인트를 사용할 수 있습니다.

카탈로그 계층

다음 표에서는 무료 버전과 프로 버전의 카탈로그의 차이점을 설명합니다:

카탈로그 저장

무료 버전

무료 버전의 카탈로그 저장 용량은 최대 100MB입니다. 100MB 미만인 경우 무제한으로 항목을 보유할 수 있습니다. 선택 항목은 저장 공간에 기여합니다. 선택 항목이 복잡할수록 더 많은 저장 공간을 차지하게 됩니다.

카탈로그 프로

회사 수준에서 Catalogs Pro의 최대 저장 용량은 카탈로그 데이터의 크기에 따라 결정됩니다. 저장소 크기 옵션은 다음과 같습니다: 5GB, 10GB 또는 15GB. 각 요금제에는 무료 버전의 저장 용량(100MB)이 포함되어 있습니다.