사용자에게 제품 추천하기

Braze REST API를 카탈로그 또는 연결된 콘텐츠와 함께 사용하여 메시지에 개인화된 제품 추천을 표시할 수 있습니다. 이 접근 방식을 사용하면 자체 추천 엔진을 Braze 메시징 생태계에 연결할 수 있으므로, 비기술 사용자도 각 추천과 관련된 콘텐츠와 메시징을 직접 관리할 수 있습니다.

이 접근 방식을 사용하면 다음을 수행할 수 있습니다:

• REST API를 사용하여 백엔드에서 고객 프로필에 제품 추천을 저장합니다.
• 카탈로그 또는 연결된 콘텐츠를 사용하여 발송 시점에 제품 메타데이터를 검색합니다.
• 이메일, 푸시, 인앱 메시지 등 모든 메시징 채널에서 개인화된 추천을 표시합니다.

필수 조건

이 가이드를 완료하려면 다음이 필요합니다:

1단계: 고객 프로필에 추천 저장

먼저, 추천 엔진에서 생성한 제품 추천을 Braze 고객 프로필에 커스텀 속성으로 저장합니다. 이렇게 하면 메시지 발송 시점에 각 사용자의 추천 제품을 참조할 수 있습니다.

1. 제품 ID나 선호 카테고리 등 저장할 추천 데이터를 결정합니다.
2. /users/track 엔드포인트를 사용하여 고객 프로필에 커스텀 속성으로 추천을 기록합니다.

요청 예시

1
2
3
POST YOUR_REST_ENDPOINT/users/track
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

YOUR_REST_ENDPOINT를 워크스페이스의 REST 엔드포인트 URL로 바꾸세요.

1
2
3
4
5
6
7
8
{
  "attributes": [
    {
      "external_id": "user123",
      "recommended_product_id": "1001"
    }
  ]
}

나중에 Liquid 템플릿에서 쉽게 참조할 수 있도록 의미 있는 속성 이름(예: recommended_product_id)을 사용하세요. 추천 엔진이 새로운 결과를 생성할 때마다 정기적으로 업데이트하여 추천의 정확성을 유지하세요.

2단계: 제품 메타데이터 검색

각 고객 프로필에 추천 식별자를 저장한 후, 메시지에 포함할 전체 제품 메타데이터(이름, 가격, 이미지 등)를 검색해야 합니다. 두 가지 옵션이 있습니다:

• 옵션 A: Braze 카탈로그 — 빠른 내장 조회를 위해 제품 정보를 Braze에 직접 저장합니다.
• 옵션 B: 연결된 콘텐츠 — 발송 시점에 외부 API에서 제품 정보를 가져옵니다.

옵션 A: Braze 카탈로그

제품 인벤토리로 카탈로그를 생성한 경우, Liquid를 사용하여 메시지에서 직접 항목을 조회할 수 있습니다. 전체 안내는 카탈로그 사용을 참조하세요.

특정 카탈로그 항목 추천

ID로 특정 제품을 참조하려면 catalog_items Liquid 태그를 사용합니다. 예를 들어, retail_products라는 카탈로그에서 제품 1001을 추천하려면:

1
2
3
4
5
6
{% catalog_items retail_products 1001 %}

We have a new item we think you'll like:
Category: {{ items[0].category }}
Name: {{ items[0].name }}
Price: ${{ items[0].price }}

여러 카탈로그 항목 추천

하나의 태그에서 여러 항목을 참조할 수도 있습니다. 예를 들어, 세 가지 제품을 소개하려면:

1
2
3
4
5
6
7
8
{% catalog_items retail_products 1001 1003 1005 %}

New items added in:
- {{ items[0].category }}
- {{ items[1].category }}
- {{ items[2].category }}

Visit our store to learn more!

사용자의 추천을 사용하여 항목 템플릿화

1단계의 커스텀 속성과 카탈로그 조회를 결합하여 각 사용자에게 맞는 추천을 개인화합니다:

1
2
3
4
{% catalog_items retail_products {{custom_attribute.${recommended_product_id}}} %}

Hi {{${first_name}}}, check out our pick for you:
{{ items[0].name }} — ${{ items[0].price }}

옵션 B: 연결된 콘텐츠

제품 메타데이터가 Braze 카탈로그가 아닌 외부 서비스에 있는 경우, 연결된 콘텐츠를 사용하여 발송 시점에 가져올 수 있습니다.

예를 들어, 내부 API가 ID로 제품 세부 정보를 반환하는 경우:

1
2
3
4
{% connected_content https://api.yourcompany.com/products/{{custom_attribute.${recommended_product_id}}} :save product %}

Hi {{${first_name}}}, we think you'll love:
{{ product.name }} — ${{ product.price }}

메시지에서 API 호출을 수행하는 방법에 대한 자세한 내용은 API 호출하기를 참조하세요.

3단계: 통합 확인

설정을 완료한 후 통합을 확인합니다:

1. /users/track 엔드포인트를 사용하여 자신의 고객 프로필에 테스트 추천을 기록합니다.
2. 카탈로그 또는 연결된 콘텐츠를 사용하여 추천 제품을 참조하는 테스트 메시지를 발송합니다.
3. 전달된 메시지에서 제품 세부 정보가 올바르게 렌더링되는지 확인합니다.
4. Braze 대시보드에서 캠페인 또는 캔버스 결과 페이지로 이동하여 발송이 기록되었는지 확인합니다.

고려 사항

• 추천 엔진이 새로운 결과를 생성할 때마다 커스텀 속성을 정기적으로 업데이트하여 추천 데이터의 정확성을 유지하세요.
• Braze 개인화 기능을 사용하여 제품 세부 정보와 함께 사용자별 데이터를 포함하는 등 메시지를 더욱 맞춤화하세요.
• Braze 대시보드에서 정의한 템플릿을 사용하여 백엔드에서 메시지를 트리거하려면 API 트리거 전달 사용을 고려하세요.