카탈로그 만들기

카탈로그를 만들려면 비사용자 데이터의 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 엔드포인트를 사용할 수 있습니다.

카탈로그 계층

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

카탈로그 저장

무료 버전

무료 버전의 카탈로그 저장 용량은 최대 100MB입니다. 100MB 미만인 경우 무제한으로 항목을 보유할 수 있습니다. 선택 항목은 스토리지에 기여합니다. 선택 항목이 복잡할수록 더 많은 스토리지를 차지하게 됩니다. 또한 CSV 카탈로그 데이터와 데이터스토어에 표시된 해당 데이터의 크기 불일치도 있을 수 있습니다.

카탈로그 프로

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