Punchh

Punchh는 업계 최고의 로열티 및 참여 플랫폼으로, 브랜드가 매장 내 및 디지털 방식으로 옴니채널 고객 로열티 프로그램을 제공할 수 있도록 합니다.

Braze와 Punchh 통합을 통해 두 플랫폼 간에 선물 및 로열티 목적으로 데이터를 동기화할 수 있습니다. Braze에 게시된 데이터는 세분화에 사용할 수 있으며 Braze 웹훅을 통해 사용자 데이터를 Punchh로 다시 동기화할 수 있습니다.

어떤 이점이 있나요?

• 실시간으로 Punchh에서 Braze로 로열티 데이터를 수집합니다.
• Braze의 강력한 오디언스 데이터를 활용하고 계층화하여 의미 있고 동적인 크로스채널 경험(앱, 모바일, 웹, 이메일 및 SMS)을 전달합니다.
  • 고객이 이메일을 열었습니까? 고객이 매장 근처에서 앱을 열었나요?
• Braze를 통해 전송되는 트랜잭션 이메일의 모양과 느낌을 표준화합니다.
• 진행하면서 A/B 테스트 및 최적화를 진행할 수 있는 여정을 생성합니다.

전제 조건

기타 고려사항

통합하기 전에

• Braze 통합을 활용할 때 Punchh와 Braze에서 각각 하나씩 두 개의 캠페인이 필요합니다. 예를 들어, 캠페인에 오퍼를 첨부하여 전송하는 경우, 기프트 캠페인은 Punchh 내에서 구성되며, Braze에서 알림을 전송할 수 있습니다.
• 게스트는 이미 Punchh 및 Braze에 존재해야 합니다. Punchh는 이미 로열티 고객이 아닌 고객을 필터링합니다.

중요한 참고 사항

• Punchh는 고객이 데이터 포인트 초과량을 방지하기 위해 Braze로의 기본 사용자 속성 전송을 비활성화할 수 있는 기능을 추가했습니다. 이것은 어댑터 설정 중에 구성됩니다.
• 반복 캠페인에서 커스텀 세그먼트를 사용하는 경우, 캠페인이 실행될 때마다 ID가 변경되므로 캠페인 ID 대신 캠페인 이름을 사용해야 합니다.
• 각 Punchh 기프트 캠페인 내에서 사용할 수 있는 커뮤니케이션 채널에는 리치 메시지, 푸시 알림, SMS 및 이메일이 포함됩니다.
• 사용자가 Braze에서 Punchh 커스텀 세그먼트로 전송된 후에는 제거할 수 없습니다. 새로운 게스트만 기존 커스텀 세그먼트에 추가할 수 있습니다. 기존 Punchh 커스텀 세그먼트에서 게스트를 제거해야 하는 경우, 사용자를 새 Punchh 커스텀 세그먼트로 보내기 위해 Braze에서 새로운 웹훅 캠페인을 생성해야 합니다.

통합

Punchh는 Braze 고객이 다음 Punchh API 엔드포인트를 사용하여 Punchh 플랫폼에 외부 ID를 추가할 수 있도록 여러 엔드포인트를 제공합니다. 외부 ID가 추가된 후 Punchh에서 어댑터를 생성하고 Braze 자격 증명을 제공한 다음, 동기화할 이벤트를 선택합니다. 다음으로, Punchh 세그먼트 ID를 사용하여 Punchh 웹훅을 빌드해 캔버스 여정에서 고객 동기화를 트리거할 수 있습니다.

Punchh user_id는 통합에 사용되기 위해 Braze 고객 프로필에 커스텀 속성 ‘punchh_user_id’로 추가되어야 합니다. 마찬가지로 Braze에서 사용되는 external_id는 Punchh 고객 프로필의 external_source_id 필드에 포함되어야 합니다.

1단계: 외부 ID 수집 엔드포인트 설정

Braze의 외부 ID는 신규 및 기존 Punchh 사용자에 대해 다음 엔드포인트를 사용하여 추가할 수 있습니다.

1. 새로운 Punchh 사용자
   external_source 및 external_source_id 필드를 사용하여 Punchh 가입 엔드포인트로 Punchh에 새 사용자를 생성합니다. Punchh는 다음 가입 엔드포인트 중 하나를 통해 고객 프로필과 함께 외부 식별자를 보낼 수 있도록 합니다:
   • 모바일 가입 API
   • SSO 가입 API
     
     
2. 기존 Punchh 사용자
   기존 Punchh 사용자에 대한 external_source_id를 업데이트합니다. Punchh는 사용자 API 업데이트 엔드포인트를 통해 프로필에 외부 식별자를 추가할 수 있습니다:
   • 모바일 사용자 업데이트
   • SSO 사용자 업데이트
   • 대시보드 사용자 업데이트
     
     

• 사용자 가입 api 예제
• 사용자 업데이트 api 예제

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
curl --location --request POST 'https://server_name_goes_here.punchh.com/api2/mobile/users' \
--header 'Content-Type: application/json' \
--header 'x-pch-digest: SIGNATURE' \
--header 'Accept-Timezone: Etc/UTC' \
--header 'Accept: application/json' \
--header 'Accept-Language: en' \
--data-raw '{
    "client":"CLIENT",
    "user" : {
      "email": "[email protected]",
      "password": "PASSWORD",
      "first_name":"FIRST_NAME",
      "last_name":"LAST_NAME",
      "terms_and_conditions":"true",
      "anniversary":"2014-02-02",
      "zip_code":"94497",
      "birthday":"2004-02-02",
      "external_source":"customer_id",
      "external_source_id":"111111111111111111"
      }
}'

1
2
3
4
5
6
7
8
9
10
11
12
13
curl --location --request PUT 'https://server_name_goes_here.punchh.com/api2/mobile/users' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Accept-Language: en' \
--header 'x-pch-digest: SIGNATURE' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--data-raw '{
    "client":"CLIENT",
    "user": {
        "external_source":"customer_id",
        "external_source_id":"111111111111111111"
    }
}'

2단계: Braze 어댑터 설정 in Punchh

동기화할 수 있는 이벤트

1. 손님: 가입, 게스트 프로필 업데이트, 비활성화 또는 삭제 시 트리거됨
2. 로열티 체크인: 영수증에서 바코드를 스캔하여 로열티 거래 또는 적립이 발생한 경우
3. 기프트 체크인: 캠페인에서 포인트가 기프트로 제공될 때 트리거됨
4. 사용: Punchh 쿠폰을 제외하고 리워드 사용 시 트리거됨(해당 쿠폰은 발급 및 사용과 같은 쿠폰 이벤트로 별도로 발송됨)
5. 리워드: 캠페인, 활동, 포인트에서 리워드로 전환 또는 관리자 기프트에서 기프트로 제공된 리워드로 트리거됨
6. 트랜잭션 알림: 펀치 시스템 내에서 사용자의 거래 활동(예: 포인트 만료)에 따라 트리거됨
7. 마케팅 Notifications: 연관된 사용자 세그먼트에 대해 Punchh에서 다양한 캠페인 설정을 기반으로 트리거됨

귀하의 Punchh 구현 매니저와 협력하여 이 어댑터를 설정하십시오.

Braze와 Punchh 통합을 설정하려면 다음을 수행하십시오:

1. Punchh 대시보드에서 Cockpit > 대시보드 > 주요 기능 > 웹훅 관리 활성화로 이동하여 웹훅 관리 활성화를 토글합니다.
   
   
2. 다음으로, 어댑터를 활성화하려면 설정 > 웹훅 매니저 > 구성 > 어댑터 탭 표시로 이동하여 어댑터 탭 표시를 토글하십시오.
   
   
3. 웹훅 매니저에서 설정 탭으로 이동하고, 어댑터 탭을 선택한 다음, 어댑터 생성을 클릭합니다.
   
   
   
   
4. 어댑터 이름, 설명 및 관리자 이메일을 입력하세요. Braze를 어댑터로 선택하고 Braze REST API 엔드포인트와 Braze API 키를 제공하세요.
   
   
5. 다음으로, 활성화하려는 사용 가능한 이벤트를 선택하십시오. 이러한 이벤트 목록은 동기화할 수 있는 이벤트에서 찾을 수 있습니다.
   
   
   
   
6. 제출을 클릭하여 웹훅을 활성화합니다.

Braze에서 Punchh 웹훅 만들기

Braze는 Punchh 커스텀 세그먼트를 활용하여 웹훅을 통해 사용자를 Punchh 세그먼트에 추가할 수 있습니다.

1. Punchh에서 커스텀 세그먼트를 만들고 아래에 표시된 대로 Punchh 세그먼트 대시보드 URL에 있는 custom_segment_id을(를) 기록하십시오. 클래식 또는 베타 세그먼트 빌더를 사용할 수 있습니다. 그러나 클래식은 결국 지원 중단될 예정이므로 베타가 권장됩니다.
   
   Punchh 플랫폼에서 Guest > 세그먼트 > 커스텀 목록 > 새 커스텀 목록으로 이동합니다.
   
   
   
   

2. 사용자를 커스텀 세그먼트에 웹훅 URL로 추가하는 경우 Braze에서 Punchh 엔드포인트를 사용하여 웹훅 캠페인을 생성합니다. 이때 URL에서 가져온 custom_segment_id 및 user_id를 키-값 페어로 제공할 수 있습니다.
   
   
   
   

3. 이 웹훅은 단일 캠페인으로 설정하거나 캔버스 내 단계로 설정할 수 있습니다. 또는 이 특정 Punchh 세그먼트에 사용자를 추가하는 웹훅이 여러 캠페인 또는 캔버스에서 사용될 경우 템플릿으로 설정할 수 있습니다.
   
   웹훅 내의 user_id 키는 Punchh 사용자 ID에 매핑됩니다. 이 식별자는 사용자를 Punchh 커스텀 세그먼트에 추가하기 위해 Braze에서 생성된 모든 웹훅에 추가되어야 합니다. punch_user_id 커스텀 속성은 Liquid를 사용하여 user_id 키의 값으로 동적으로 채워질 수 있습니다. 모든 템플릿 텍스트 필드의 오른쪽 상단에 있는 파란색 ‘더하기’ 아이콘을 사용하여 punchh_user_id 커스텀 속성 변수를 삽입할 수 있습니다.
   
   
   
   
   
   

4. 웹훅이 저장된 후에는 아래와 같이 사용자를 동기화하는 데 사용할 수 있습니다. 예를 들어, 이 Braze 웹훅 캠페인이 시작될 때 136명의 게스트가 Punch 커스텀 세그먼트에 추가됩니다.
   
   

웹훅이 Braze에서 사용되는 방법에 대한 자세한 내용은 웹훅 만들기을 확인하세요.

사용 사례 캠페인

캠페인 및 캔버스 구성

트리거링

Punchh 이벤트에 의해 Braze로 전송되는 Braze 메시징의 사용 사례는 보상 이벤트 또는 게스트 이벤트와 같은 액션 기반 캠페인 또는 관련 Punchh 이벤트에 의해 트리거되는 Canvases로 생성될 수 있습니다.

트리거를 추가하면 Braze에서 생성된 이벤트 목록이 표시됩니다. 이벤트를 기록한 사용자에게 전송할 캠페인 또는 캔버스를 트리거해야 하는 이벤트를 선택하세요.

속성 필터를 추가하여 트리거 이벤트를 추가로 필터링할 수 있습니다. 예를 들어, 메시지는 고객이 승인된 이벤트 속성이 true인 “checkins_gift” 이벤트를 트리거할 때만 트리거되어야 합니다. 이것은 모든 사용 사례에 적용되지 않을 수 있는 선택적 기능입니다.

세분화

많은 경우에, Punchh 이벤트에 의해 트리거되는 Braze 캠페인과 캔버스는 이러한 이벤트를 트리거하는 사용자의 세분화가 Punchh 내에서 결정되기 때문에 ‘모든 사용자’ 오디언스로 설정될 수 있습니다. 그러나 이벤트에 의해 트리거된 Braze 메시징을 받을 사용자 오디언스를 더욱 세분화하려는 고객은 캠페인 작성기의 타겟 오디언스 섹션 또는 캔버스 작성기의 엔트리 오디언스에 추가 필터와 세그먼트를 추가하여 이를 수행할 수 있습니다.

사용 사례

• 가입
• 대량 오퍼
• 반복 대량 오퍼
• 체크인 후 오퍼 알림
• 알림 없이 체크인 후 오퍼
• 기념일
• 리콜