오픈 로열티

오픈 로열티는 고객 충성도 및 보상 프로그램을 구축하고 관리할 수 있는 클라우드 기반 로열티 프로그램 플랫폼입니다. Braze와 오픈 로열티 데이터 통합은 포인트 잔액, 등급 변경, 만료 경고와 같은 로열티 데이터를 실시간으로 Braze에 직접 동기화합니다. 이를 통해 사용자의 로열티 상태가 변경되면 개인화된 메시지(이메일, 푸시, SMS)를 트리거할 수 있습니다.

이 통합은 오픈 로열티에 의해 유지됩니다.

통합 정보

이 통합은 Braze 데이터 변환을 사용하여 Open Loyalty에서 웹훅을 캡처하고 이를 Braze 고객 프로필에 매핑합니다.

• 실시간 업데이트: 로열티 이벤트(포인트 획득, 티어 업그레이드)를 Braze에 푸시합니다.
• 개인화: Braze 템플릿에서 로열티 속성(현재 잔액, 다음 티어 이름)을 사용하세요.
• 양방향: Braze 고객 참여 데이터를 기반으로 오픈 로열티 고객 커스텀 속성을 업데이트합니다.

사용 사례

이 통합에는 다음과 같은 데이터 흐름이 포함됩니다:

1. 이벤트를 Braze에 동기화하기(인바운드): 데이터 포인트 변경, 등급 업그레이드 또는 리워드 사용을 추적하려면 Open 로열티에서 Braze로 데이터를 전송하세요. 데이터 변환은 이 데이터를 사용자 이벤트로 변환합니다.
2. 오픈 로열티 회원(아웃바운드) 수정하기: ‘VIP’ 라벨을 추가하거나 커스텀 속성을 업데이트하는 등 Braze의 사용자 행동에 따라 Open Loyalty에서 회원 데이터를 자동으로 업데이트합니다.

필수 조건

시작하기 전에 다음이 필요합니다:

Integration

기본 통합은 데이터 변환을 사용하여 오픈 로열티 웹훅 이벤트를 Braze에 동기화합니다.

1단계: Braze에서 웹훅 URL 생성하기

먼저 Braze에서 데이터 변환을 생성하여 데이터를 수신하기 위한 고유 URL을 생성합니다.

1. Braze에서 데이터 설정 > 데이터 변환을 엽니다.
2. 변환 만들기를 클릭합니다.
3. 다음 입력란을 작성합니다:
   • 변환 이름: 설명이 포함된 이름(예: “로열티 포인트 업데이트 이벤트 열기”)을 입력합니다.
   • 대상을 선택합니다: POST를 선택합니다: Track users.
4. 변환 만들기를 클릭합니다.
5. 오른쪽에서 웹훅 URL을 찾아 복사를 클릭합니다.

2단계: 오픈 로열티에서 웹훅 구독 만들기

로열티 오픈에 방금 생성한 URL로 특정 이벤트를 보내도록 지시합니다.

1. 오픈 로열티 관리자 패널에 로그인합니다.
2. 일반 > 웹훅으로 이동합니다.
3. 새 웹훅 추가를 클릭하고 구독을 구성합니다:
   • 이벤트 이름: 추적하려는 이벤트를 선택합니다(예: AvailablePointsAmountChanged, CustomerLevelChanged, 또는 CampaignEffectWasApplied).
   • URL: 1단계의 Braze 간 웹훅 URL을 붙여넣습니다.
   • 다음 헤더를 추가합니다:
     • Content-Type: application/json
     • User-Agent: partner-OpenLoyalty
4. 웹훅 구독을 저장합니다.

3단계: 데이터 변환 구성하기

들어오는 오픈 로열티 페이로드를 Braze 프로퍼티에 매핑하는 자바스크립트 로직을 작성하세요.

1. Braze에서 1단계에서 만든 데이터 변환을 엽니다.
2. 로열티 열기에서 이벤트를 트리거하여(예: 회원의 포인트 변경 또는 티어 할당) 웹훅 세부 정보 창에 샘플 페이로드를 생성합니다.
3. 변환 코드 편집기에서 들어오는 데이터를 매핑하는 스크립트를 작성합니다. 다음 예시를 참고하세요:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// 1. Parse the incoming Open Loyalty payload
const data = payload.data;

// 2. Construct the Braze API body
let brazecall = {
  "events": [
    {
      // CRITICAL: Map the identifier (e.g., loyaltyCardNumber -> external_id)
      "external_id": data.customer.loyaltyCardNumber,
     
      // Define the Event Name (what you see in Braze)
      "name": "Loyalty Event Triggered",
     
      // timestamp
      "time": new Date().toISOString(),
     
      // Map specific properties you want to use in emails/segments
      "properties": {
        "event_type": payload.type, // for example, 'AvailablePointsAmountChanged'
        "new_balance": data.amount,
        "change_amount": data.amountChange,
        "tier_name": data.tier ? data.tier.name : null
      }
    }
  ]
};

return brazecall;

4. 유효성 검사를 클릭하여 코드가 샘플 페이로드에 대해 실행되는지 확인한 다음 활성화를 클릭합니다.

Braze로 오픈 로열티 사용하기

인바운드 통합을 완료한 후 아웃바운드 업데이트를 구성하여 Braze 동작에 따라 오픈 로열티 회원을 수정합니다.

1단계: Braze 간 웹훅 캠페인 구성하기

이 프로세스는 Braze 간 웹훅을 사용하여 PATCH 요청을 오픈 로열티 회원 API로 전송합니다(예: “VIP” 레이블 추가).

1. Braze에서 새 웹훅 캠페인을 만들거나 캔버스 내에서 웹훅을 사용합니다.
2. 웹훅 작성을 클릭합니다.
3. Webhook URL: 오픈 로열티 인스턴스, 테넌트 ID, 사용자 ID에 대한 Braze Liquid 변수를 사용하여 URL을 구성합니다.

   • 형식:

     https://<YOUR_OL_INSTANCE>/api/<TENANT_ID>/member/loyaltyCardNumber={{${user_id}}}

4. 다음 입력란을 작성합니다:
   • 요청 방법: PATCH
   • Request Headers:
     • Content-Type: application/json
     • X-AUTH-TOKEN: <YOUR_PERMANENT_TOKEN>
     • User-Agent: Braze
5. Request Body: Raw text 를 선택하고 페이로드를 붙여넣습니다:

1
2
3
4
5
6
7
8
9
10
{
  "customer": {
    "labels": [
      {
        "key": "braze_vip_segment",
        "value": "optedIn"
      }
    ]
  }
}

2단계: 트리거 구성하기

1. 전달 또는 입력 일정 탭으로 이동합니다.
2. 다음 입력란을 작성합니다:
   • 전달 방법: 액션 기반.
   • 트리거: 관련 트리거를 정의합니다(예: 사용자가 Braze에서 특정 세그먼트를 입력하는 경우).
   • 시작: 캠페인을 활성화합니다.

문제 해결

인바운드 이벤트 확인

데이터 변환이 활성화되면 데이터가 Braze에 커스텀 이벤트로 표시됩니다. 커스텀 이벤트 수행 트리거가 있는 캠페인을 생성하고 정의한 이벤트(예: Loyalty Event Triggered)를 사용할 수 있는지 확인하여 이를 확인합니다.

아웃바운드 웹훅 확인

Braze에서 메시지 활동 로그를 확인하여 웹훅이 200 OK 상태를 반환했는지 확인하세요.

• 401 오류: 오픈 로열티 API 토큰을 확인하세요.
• 404 오류: Braze의 사용자 ID는 오픈 로열티에 존재하지 않습니다.