PAR Punchh 데이터 참조

학습 내용

PAR 펀치에서 클라비요로 동기화되는 데이터와 이를 볼 수 있는 위치에 대해 알아보세요. 여기에는 계정 활동, 보상, 체크인과 관련된 데이터가 포함됩니다.

아직 읽어보지 않았다면 이 글을 계속 진행하기 전에 PAR Punchh 시작하기 가이드를 읽고 통합에 대한 단계별 지침을 확인하세요.

데이터를 보는 방법

PAR Punchh 데이터를 보려면:

1. 왼쪽 탐색 사이드바에서 애널리틱스 드롭다운을 클릭합니다.
2. 메트릭을 선택합니다. 여기에서 계정의 모든 메트릭을 볼 수 있습니다. "PAR Punchh"라는 레이블이 붙은 지표는 PAR Punchh 연동에서 동기화된 모든 지표를 나타냅니다.
3. 검색창 옆에 있는 필터 선택기를 사용하여 이 보기를 필터링하여 PAR Punchh 메트릭을 확인하고 API를 선택합니다. 이렇게 하면 API에서 오는 모든 메트릭을 가져옵니다. PAR Punchh 지표에는 이와 같은 레이블이 표시됩니다.

계정 메트릭

PAR Punchh - 가입

이 이벤트는 고객이 PAR Punchh 로열티 프로그램에 가입할 때 발생합니다. 다음 기준에 따라 가입 이벤트를 필터링하고 타겟팅할 수 있습니다:

• 이메일 확인 URL
  이메일 확인 URL
• 마케팅 이메일 구독
  최종 사용자가 마케팅 이메일을 구독했는지 여부
• 마케팅 푸시 구독
  최종 사용자가 마케팅 푸시 알림을 구독했는지 여부
• SMS 구독
  최종 사용자가 SMS 서비스를 구독했는지 여부
• 이메일 마케팅용 프로필 구독
  클라비요에서 이메일 마케팅을 위한 프로필을 구독합니다.
• SMS 마케팅을 위한 프로필 구독
  클라비요에서 SMS 마케팅을 위한 프로필을 구독합니다.

PAR Punchh - 새 장치에서 로그인했습니다.

이 이벤트는 게스트가 다른 디바이스에서 로그인한 후 새 디바이스가 감지될 때 생성됩니다. 다음 기준에 따라 새 디바이스 이벤트를 필터링하고 타겟팅할 수 있습니다:

• deviceDetectedTime
  새 디바이스가 감지된 날짜 및 시간
• iPAddress
  사용자가 로그인한 새 디바이스의 IP 주소입니다.
• 새로운 디바이스 사용자 에이전트
  디바이스 정보를 제공하는 사용자 에이전트 문자열입니다.
• 비밀번호 링크 재설정
  비밀번호 링크 재설정
• 사용자명
  시스템에서 사용자를 식별하는 사용자 이름입니다.

PAR Punchh - 트리거된 비밀번호 재설정

이 이벤트는 게스트가 비밀번호 재설정을 시작할 때 생성됩니다. URL을 기준으로 비밀번호 재설정 이벤트를 필터링하고 대상을 지정할 수 있습니다.

• passwordResetURL
  비밀번호 재설정 URL

상환 지표

PAR 펀치 - 생성된 상환, 업데이트된 상환

이 이벤트는 고객이 교환을 생성하고 업데이트할 때 발생합니다. 다음 기준에 따라 교환 이벤트를 필터링하고 대상을 지정할 수 있습니다:

• 바코드
  주문에 대해 생성된 바코드
• 채널
  사용 채널(예: POS, 온라인 주문)
• 만료 날짜
  타임스탬프에 만료되는 교환 코드
• 위치 ID
  교환이 발생한 위치의 ID
• 위치 이름
  상환이 발생한 위치의 이름
• 추가 속성
  구성된 경우 상환 충족 키가 채워집니다.
• 관리자 ID
  교환 코드를 생성한 관리자의 ID
• 생성된 날짜
  타임스탬프에 생성된 교환 코드
• 만료된 날짜
  사용 코드가 타임스탬프에 만료되었습니다.
• 강제 메시지
  강제 상환 시 메시지
• 내부 추적 코드
  오퍼에 대해 생성된 리워드 추적 코드(예: 리워드, 교환 가능 또는 뱅킹 리워드)
• 교환 코드
  교환 코드
• 업데이트됨
  타임스탬프에 생성된 교환 코드
• 요청된 포인트
  주문에 사용하도록 요청된 포인트
• 교환 가능한 ID
  교환용 ID 
• 교환 가능한 이름
  교환 가능한 이름
• 상환 가능한 속성
• 사용 포인트
  주문에 사용된 포인트
• 리워드 코드 ID
  PAR 펀치가 오퍼에 대해 생성한 리워드 코드 ID(예: 리워드 또는 교환 가능 또는 뱅킹 리워드).
• 교환 코드 패스
• 교환 ID
  교환을 위해 PAR 펀치에서 생성된 고유 교환 ID입니다.
• 교환 상태
  교환 상태(예: 교환됨, 만료됨, 교환 가능, 양도됨, 강제 교환됨, 취소됨)
• 교환 유형
  상환 유형(예: 뱅크 리워드 상환, 상환 가능 상환, 상환, 리워드 상환)
• 리워드 ID
  리워드 사용 시 리워드 ID
• 스토어 번호
  상환이 발생한 위치의 매장 번호입니다.
• 전송된 ID
  전송 유형의 ID(예: 사회적 목적 캠페인의 경우 캠페인 ID)
• 유형으로 전송
  전송 유형(예: 사회적 대의 캠페인)
• 웹
  아이프레임을 통한 교환인지 여부

PAR 펀치 - 적용된 상환

이 이벤트는 교환이 적용될 때 생성됩니다. 다음 기준에 따라 적용된 사용 이벤트를 필터링하고 타겟팅할 수 있습니다: 

• 할인금액
  사용과 관련된 할인 금액
• 내부 추적 코드
  오퍼에 대해 생성된 리워드 추적 코드(예: 리워드, 교환 가능 또는 뱅킹 리워드)
• 위치 이름
  체크인 위치 이름
• 처리된 날짜
  상환이 처리된 타임스탬프입니다.
• 보상 이름
  보상 이름

체크인 지표

PAR 펀치 - 로열티 체크인, PAR 펀치 - 선물 체크인

이 이벤트는 사용자가 로열티 프로그램에 체크인하거나 특정 선물을 받을 때 발생합니다. 다음 기준에 따라 체크인 이벤트를 필터링하고 대상을 지정할 수 있습니다:

• 승인됨
  체크인 승인 상태
• 캠페인 ID
  PAR Punchh에서 생성된 캠페인 ID
• 캠페인 이름
  캠페인 이름
• 캠페인 유형
  캠페인 유형
• 채널
  체크인이 발생한 채널(예: POS, 온라인주문, 웹, 모바일)
• 체크인 ID
  파펀치에서 생성한 고유한 체크인 ID
• 체크인 유형
  온라인체크인, 포스체크인, 영수증이미지체크인, 바코드체크인, QR코드체크인, 포스컨솔체크인
• 적립 가능 금액
  주문의 적립 자격 조건에 따른 적립 가능 금액
• 비즈니스 첫 체크인
  비즈니스의 첫 체크인인지 여부를 나타냅니다.
• 위치에서 첫 체크인
  해당 위치의 첫 번째 체크인인지 여부를 나타냅니다.
• 선물 이유
  사용자에게 선물한 포인트의 선물 이유
• 유형별 선물
  선물 유형(예: 관리자, 체크인 등)
• 선물 유형
  선물 유형(예: 대량 선물하기, 피드백 답장, 게임 등)
• 항목
  메뉴 항목 개체
• 위치 ID
  PAR Punchh에서 생성된 위치 ID
• 위치 이름
  체크인 위치 이름
• 매뉴얼
• 적립 포인트
  주문 시 적립된 포인트
• 사용 포인트
  주문에 사용된 포인트
• PAR 펀치 키
  주문에 대해 생성된 고유한 PAR 펀치 키
• 영수증 금액
  주문에 대한 영수증 금액
• 교환 ID
  주문에서 교환이 완료된 경우 입력되는 교환 ID입니다.
• 스토어 번호
  위치의 스토어 번호
• 바코드
  주문에 대해 생성된 바코드
• 생성된 날짜
  PAR 펀치에서 체크인이 생성된 타임스탬프입니다.
• 만료 날짜
  체크인이 만료된 날짜입니다.
• 만료 날짜
  체크인이 만료되는 날짜입니다.
• 외부 UID
  트랜잭션에 대해 생성된 외부 UID
• 추천인 ID
  추천된 사용자의 첫 번째 체크인 ID입니다.
• 추천인 전체 이름
  추천 사용자의 이름
• 추천 사용자 ID
  추천 사용자의 ID
• 선물 받은 ID
  포인트를 선물한 관리자의 ID
• 선물용 ID
  선물 유형에 대한 ID
• 디코딩된 QR
  주문에 대해 생성된 QR 코드 값
• 거래 번호
  주문의 거래 번호
• 업데이트된 시점
  PAR Punchh에서 체크인 업데이트 시 TImestamp
• 수령 날짜
  주문 접수 날짜/시간
• 보류 중인 새로 고침
  보류 중인 포인트 구성에 따라 활성화됩니다.
• 확인되지 않은 영수증 금액
  수동 체크인(즉, 영수증 이미지 확인 기반)의 경우 입력되는 영수증_금액입니다.
• 새로 고침된 날짜
  체크인 새로 고침 타임스탬프
• 확인 횟수
  여러 검토자 또는 관리자가 체크인을 승인한 경우 이 횟수는 증가합니다(영수증 이미지 확인 기반 체크인에 해당).
• 체크인 확인 시점
  체크인 승인 타임스탬프(영수증 이미지 인증 기반 체크인에 적용 가능)
• 검토자 ID
  체크인을 확인하는 검토자의 관리자 ID(영수증 이미지 인증 기반 체크인에 해당)

PAR Punchh - POS 스캐너에서 체크인

이 이벤트는 POS 체크인 후에 생성됩니다. 포인트를 기준으로 이 체크인 이벤트를 필터링하고 타겟팅할 수 있습니다.

• 포인트
  체크인 시 적립되는 포인트

보상 지표

PAR 펀치 - 획득 보상

여기에는 PAR 펀치에서 트리거되는 사용자 보상 선물/발행 이벤트가 포함됩니다. 다음 기준에 따라 적립된 보상 이벤트를 필터링하고 타겟팅할 수 있습니다:

• 할인 채널
  보상을 사용할 수 있는 채널입니다. 가능한 값은 다음과 같습니다:
• "온라인 주문의 경우 온라인 전용"
• "오프라인 전용" POS용
• "모두" 모두
• 선물 이유
  사용자에게 선물한 보상 선물 이유
• 보상 이미지 URL
  보상을 묘사하는 이미지의 URL입니다.
• 만료 날짜
  보상이 만료되는 날짜/시간
• 상태
  상태에는 명예, 미상환, 생존, 사망, 만료가 포함됩니다.

PAR 펀치 - 리워드로 전환된 포인트

이 이벤트는 고객이 적립한 포인트가 리워드로 전환될 때 트리거됩니다. 다음 기준에 따라 전환된 포인트를 보상으로 전환 이벤트를 필터링하고 타겟팅할 수 있습니다:

• 은행 가치
  은행 보상의 가치
• 현재 뱅크 보상
  은행 보상의 현재 가치
• 보상

기타 메트릭

PAR Punchh - 마케팅 알림 수신

이 이벤트는 고객이 PAR 펀치에서 가입 캠페인에 자신의 정보를 제출하면 트리거됩니다. 다음 기준에 따라 수신된 마케팅 알림 이벤트를 필터링하고 타겟팅할 수 있습니다:

• 이벤트 유형
• 금액
  결제 금액
• 캠페인 ID
  업데이트된 캠페인의 ID
• 캠페인 이름
  업데이트된 캠페인의 이름
• 캠페인 유형
  캠페인 유형
• 챌린지 완료 단계
  챌린지 캠페인 완료 단계
• 챌린지 잔여 단계
  챌린지 캠페인 남은 단계
• 챌린지 총 걸음 수
  챌린지 캠페인 총 걸음 수
• 쿠폰코드
  쿠폰 코드
• 쿠폰 종료일
  쿠폰 유효기간 종료일
• 쿠폰선물값
  쿠폰 선물 보상 가치(금액/포인트 등)
• 쿠폰보상명
  쿠폰 선물 보상 이름
• 기부 유형
  기부 유형
• for추천
  추천 사용자의 이름
• 선물이유
  선물하는 이유/목적 메시지
• 선물받은 금액
  사용자에게 선물한 금액
• 항목기부
  기부 아이템
• 위치 이름
  체크인 위치 이름
• 포인트
  캠페인에서 제공하는 포인트
• rawReferralPoints
  캠페인 선물 가치
• 추천 포인트
  추천 포인트
• 보상 만료일
  리워드의 만료일
• rewardID
  리워드의 고유 ID
• 보상 이름
  보상 이름

PAR 펀치 - 완성된 카드

이 이벤트는 게스트의 로열티 카드가 완료되면 생성됩니다. 다음 기준에 따라 완료된 카드 이벤트를 필터링하고 타겟팅할 수 있습니다:

• 카드 완료
  단일 카드 완료를 위해 필요한 방문이 이루어졌는지 여부
• 첫 번째 카드 알림
  첫 번째 카드 완료 시 알림을 보낼지 여부
• 두 번째 카드 알림
  두 번째 카드 완료 시 알림을 보낼지 여부
• 이름
  보상 이름
• 설명
  앱에 표시되는 교환권에 대한 설명입니다.
• 할인 금액
  교환권과 관련된 할인 금액
• 할인 채널
  보상을 사용할 수 있는 채널입니다. 가능한 값은 다음과 같습니다:
• "온라인 주문의 경우 온라인 전용"
• "오프라인 전용" POS용
• "모두" 모두
• 만료 날짜
  교환권의 유효 기간입니다.
• 상환에 필요한 포인트
  특정 교환권을 교환하는 데 필요한 포인트 가치
• 교환 가능한 ID
  시스템에서 교환권을 식별하는 고유 ID입니다.
• 교환 만료일
  교환 가능한 쿠폰의 만료일
• 상태
  교환권 상태: 활성화됨, 비활성화됨, 초안, 만료됨
• 로열티 보상으로 적용 가능
  로열티 보상 상환으로 사용할 수 있는지 여부
• 생성된 날짜
  시스템에서 최종 사용자에 대한 교환권이 생성된 날짜와 시간입니다.
• 리워드 종료일과 함께 교환 코드 만료하기
  리워드 종료일과 함께 리워드 코드가 만료될지 여부
• 메타데이터
  교환 가능한 상품에 추가할 수 있는 메타 데이터입니다. 이는 서버에서 특정 데이터가 수신될 때 모바일 앱이 특정 동작을 수행하도록 프로그래밍하거나 비즈니스에서 원하는 대로 사용할 수 있습니다. 이는 PAR Punchh 대시보드에서 구성할 수 있으며 최대 길이는 255자입니다.
• 업데이트된 날짜
  시스템에서 최종 사용자에 대해 교환권이 업데이트된 날짜와 시간입니다.
• 교환 가능한 이미지 URL: 교환 가능한 이미지를 설명하기 위해 앱에 표시되는 이미지의 URL입니다.
• 상환 가능한 속성
  "상품", "음식 아이템" 등과 같은 속성이 특정 교환 대상에 추가되었습니다.

동기화된 게스트 데이터

클라비요는 PAR 펀치에서 동기화하는 메트릭 외에도 동기화하는 모든 고객에 대해 고유한 프로필을 생성합니다. 연락처 정보를 동기화할 때 각 클라비요 프로필에 추가될 수 있는 특정 사용자 지정 속성도 있습니다. 이러한 속성은 세그먼트와 흐름에서 사용할 수 있습니다. PAR Punchh에서 자동으로 동기화되는 프로퍼티는 다음과 같습니다:

• 이메일
• 전화번호
• 이름
• 성
• PAR 펀치 기념일
• 생일
• 즐겨찾는 스토어 번호
• 성별
• PAR 펀치 게스트 유형
• 파 펀치 합류 장소
• PAR Punchh 최근 활동 장소
• 기본 언어
• PAR 펀치 추천 코드
• PAR 펀치 가입 채널
• PAR Punchh 구독 취소 이유
• PAR Punchh 구독 취소 상태
• PAR 펀치 ID
• PAR Punchh 사용자 상태
• PAR 펀치 멤버십 레벨
• PAR 펀치 마지막 방문
• PAR 펀치 로열티 포인트
• PAR 펀치 총 크레딧
• PAR 펀치 평생 총 포인트
• PAR 펀치 총 포인트 크레딧
• PAR 펀치 총 방문 횟수
• PAR 펀치 비은행 포인트

이메일 동의는 펀치에서 클라비요로 동기화됩니다. Punchh의 SMS 동의는 동기화되지 않는다는 점에 유의하세요.