Punchh

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

이 통합은 Punchh에서 유지 관리합니다.

통합 정보

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

이점은 무엇인가요?

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

필수 조건

그 밖에 알아야 할 사항은?

통합 전

• Braze 통합을 활용할 때 두 개의 캠페인이 필요합니다. 하나는 Punchh에서, 다른 하나는 Braze에서 설정합니다. 예를 들어, 오퍼가 첨부된 캠페인을 보내는 경우 선물 캠페인은 Punchh 내에서 구성하고 알림은 Braze에서 보낼 수 있습니다.
• 게스트는 이미 Punchh와 Braze에 존재해야 합니다. Punchh는 이미 로열티 게스트가 아닌 고객을 필터링합니다.

중요 참고 사항

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

통합

Punchh는 다음 Punchh API 엔드포인트를 사용하여 Punchh 플랫폼에 외부 ID를 추가할 수 있도록 Braze 고객에게 여러 엔드포인트를 제공합니다. 외부 ID가 추가된 후 Punchh에서 어댑터를 생성하고 Braze 자격 증명을 제공한 다음 동기화할 이벤트를 선택합니다. 그런 다음 Punchh Segment ID를 가져와 Canvas 여정에서 고객 동기화를 트리거하는 Punchh 웹훅을 구축하는 데 사용할 수 있습니다.

Punchh user_id와 Braze external_id가 통합이 올바르게 동기화되려면 두 플랫폼 모두에서 사용 가능해야 합니다.

• Punchh에서 Braze로 전송되는 이벤트에는 Braze external_id가 식별자로 포함됩니다. Punchh가 external_source_id를 사용하도록 구성된 경우 해당 값이 Braze external_id로 설정됩니다. 그렇지 않으면 통합은 기본적으로 Punchh user_id를 Braze external_id로 설정합니다.
• Braze에서 Punchh로 웹훅을 보내려면 Braze 고객 프로필에서 Punchh user_id를 사용할 수 있어야 합니다. Punchh user_id를 Braze external_id로 사용하지 않는 경우 커스텀 속성 “punchh_user_id”로 설정해야 합니다.

1단계: 외부 ID 수집 엔드포인트 설정(선택 사항)

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

중요

external_source 및 external_source_id 필드 값은 Punchh에서 고유해야 하며 기존 프로필과 연결되어 있지 않아야 합니다.

1. 신규 Punchh 사용자
   external_source 및 external_source_id 필드를 사용하여 Punchh 가입 엔드포인트로 Punchh에 새 사용자를 생성합니다. Punchh는 다음 가입 엔드포인트 중 하나를 통해 사용자 프로필과 함께 외부 식별자를 보낼 수 있습니다:
   • Mobile Signup API
   • SSO Signup API
     
     
2. 기존 Punchh 사용자
   기존 Punchh 사용자의 external_source_id를 업데이트합니다. Punchh는 사용자 API 업데이트 엔드포인트를 통해 프로필에 외부 식별자를 추가할 수 있습니다:
   • Mobile User Update
   • SSO User Update
   • Dashboard User Update
     
     

• 사용자 가입 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"
    }
}'

참고

플랫폼 구성: Punchh에서 외부 식별자를 활성화하려면 Punchh 대시보드에서 Cockpit > Dashboard > External User Identifier로 이동합니다.

2단계: Punchh에서 Braze 어댑터 설정

동기화 가능한 이벤트

1. 게스트: 가입, 게스트 프로필 업데이트, 비활성화 또는 삭제 시 트리거됩니다.
2. 로열티 체크인: 로열티 거래 또는 영수증에서 바코드를 스캔하여 적립할 때 트리거됩니다.
3. 선물 체크인: 캠페인에서 포인트가 선물될 때 트리거됩니다.
4. 리뎀션: Punchh 쿠폰을 제외한 모든 리워드 리뎀션 시 트리거됩니다. 쿠폰은 발행 및 리뎀션을 포함하여 쿠폰 이벤트로 별도 전송됩니다.
5. 리워드: 캠페인에서 선물된 리워드, 활동, 포인트에서 리워드로의 전환 또는 관리자 선물에서 트리거됩니다.
6. 트랜잭션 알림: Punchh 시스템 내 사용자의 트랜잭션 활동(예: 포인트 만료) 시 트리거됩니다.
7. 마케팅 알림: 연관된 사용자 Segment에 대해 Punchh에서 다양한 캠페인 설정에 따라 트리거됩니다.

참고

이러한 사용 가능한 이벤트의 샘플 페이로드가 어떻게 보이는지에 대해서는 Punchh 설명서를 참조하세요.

이 어댑터를 설정하려면 Punchh 구현 매니저와 협력하세요.

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

1. Punchh 대시보드에서 Cockpit > Dashboard > Major Features > Enable Webhook Management로 이동하여 Enable Webhook Management를 토글합니다.
   
   
2. 다음으로, Settings > Webhooks Manager > Configurations > Show Adapters Tab으로 이동하여 Show Adapters Tab을 토글하여 어댑터를 활성화합니다.
   
   
3. Settings 탭 아래의 Webhooks Manager로 이동하여 Adapters 탭을 선택하고 Create Adapter를 클릭합니다.
   
   
   
   
4. 어댑터 이름, 설명, 관리자 이메일을 입력합니다. 어댑터로 Braze를 선택하고 Braze REST API 엔드포인트와 Braze API 키를 제공합니다.
   
   
5. 다음으로, 활성화할 사용 가능한 이벤트를 선택합니다. 이러한 이벤트 목록은 동기화 가능한 이벤트에서 확인할 수 있습니다.
   
   
   
   
6. Submit을 클릭하여 웹훅을 활성화합니다.

Braze에서 Punchh 웹훅 생성

Braze는 Punchh 커스텀 Segments를 활용하는 웹훅을 통해 Punchh Segment에 사용자를 추가할 수 있습니다.

1. Punchh에서 커스텀 Segment를 생성하고 아래와 같이 Punchh Segment 대시보드 URL에 있는 custom_segment_id를 기록합니다. 클래식 또는 베타 Segment 빌더를 모두 사용할 수 있습니다. 그러나 클래식은 결국 더 이상 사용되지 않으므로 베타를 권장합니다.
   
   Punchh 플랫폼에서 Guest > Segment > Custom List > New Custom List로 이동합니다.
   
   
   
   

2. 커스텀 Segment에 사용자를 추가하기 위한 Punchh 엔드포인트를 웹훅 URL로 사용하여 Braze에서 웹훅 캠페인을 생성합니다. 여기에서 URL에서 가져온 custom_segment_id와 user_id를 키-값 페어로 제공할 수 있습니다.
   
   
   
   

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

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

Braze에서 웹훅을 사용하는 방법에 대한 자세한 내용은 웹훅 만들기를 참조하세요.

활용 사례 캠페인

Campaign 및 Canvas 구성

트리거

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

트리거를 추가하면 Braze에서 생성된 이벤트 목록이 표시됩니다. 이벤트를 기록한 사용자에게 캠페인 또는 Canvas가 전송되도록 트리거할 이벤트를 선택합니다.

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

세분화

대부분의 경우, 이러한 이벤트를 트리거하는 사용자의 세분화가 Punchh 내에서 결정되기 때문에 Punchh 이벤트에 의해 트리거되는 Braze 캠페인과 Canvases를 “모든 사용자” 오디언스로 설정할 수 있습니다. 그러나 이벤트에 의해 트리거되는 Braze 메시징을 수신할 사용자의 오디언스를 추가로 세분화하려는 고객은 캠페인 작성기의 타겟 오디언스 섹션 또는 Canvas 작성기의 진입 오디언스에서 추가 필터와 Segments를 추가하여 이를 수행할 수 있습니다.

활용 사례

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