PassKit

PassKit을 사용하면 Apple Wallet 및 Google Pay 패스를 고객 경험에 통합하여 모바일 도달 범위를 확장할 수 있습니다. 디지털 쿠폰, 로열티 카드, 멤버십 카드, 티켓 등을 쉽게 생성, 관리, 배포하고 성능을 분석할 수 있으며, 고객이 별도의 앱을 설치할 필요가 없습니다.

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

통합 정보

Braze와 Passkit 통합을 사용하면 커스텀 Apple Wallet 및 Google Pay 패스를 즉시 전달하여 온라인 캠페인의 인게이지먼트를 높이고 측정할 수 있습니다. 그런 다음 사용량을 분석하고 실시간으로 조정하여 위치 기반 메시지와 개인화된 동적 업데이트를 고객의 모바일 월렛에 트리거함으로써 매장 내 트래픽을 늘릴 수 있습니다.

전제 조건

통합

고객의 모바일 지갑 경험을 더욱 풍부하게 만들기 위해, PassKit 대시보드 내에서 Braze /users/track 엔드포인트를 통해 Braze로 데이터를 전달할 수 있습니다.

PassKit에서 공유할 수 있는 데이터 예시는 다음과 같습니다:

• 패스 생성: 고객이 패스 링크를 클릭하고 패스가 처음 표시될 때.
• 패스 설치: 고객이 패스를 추가하고 지갑 앱에 저장할 때.
• 패스 업데이트: 패스가 업데이트될 때.
• 패스 삭제: 고객이 지갑 앱에서 패스를 삭제할 때.

데이터가 Braze로 전달되면, 오디언스를 구축하고 Liquid를 통해 콘텐츠를 개인화하며, 이러한 작업이 수행된 후 Campaigns 또는 Canvases를 트리거할 수 있습니다.

Passkit을 Braze에 연결하기

PassKit에서 데이터를 전달하려면 Braze 외부 ID를 PassKit의 externalId로 설정했는지 확인하세요.

1. PassKit 패스 프로젝트 또는 프로그램의 Settings에서 Integrations 아래에 있는 Braze 탭에서 Connect를 클릭합니다.
   
   
   
2. Braze API 키, 엔드포인트 URL을 입력하고 커넥터 이름을 지정합니다.
   
   
3. Enable Integration을 토글하고 Braze에서 메시지를 트리거하거나 개인화하는 데 사용할 이벤트를 선택합니다.
   

SmartPass 링크를 사용하여 패스 생성하기

Braze 내에서 SmartPass 링크를 설정하여 고객이 Android 또는 iOS에 패스를 설치할 수 있는 고유 URL을 생성할 수 있습니다. 이를 위해 Braze 콘텐츠 블록에서 호출할 수 있는 암호화된 SmartPass 데이터 페이로드를 정의해야 합니다. 이 콘텐츠 블록은 향후 패스와 쿠폰에 재사용할 수 있습니다. 통합 과정에서 다음 항목이 사용됩니다:

• PassKit URL: PassKit URL은 PassKit 프로그램에 대한 고유 URL입니다.
  각 프로그램에는 고유 URL이 있으며, PassKit 프로그램 또는 프로젝트의 Distribution 탭에서 찾을 수 있습니다. (예: https://pub1.pskt.io/c/ww0jir)
  
  
• PassKit 시크릿: URL과 함께 이 프로그램의 PassKit 키가 필요합니다.
  PassKit URL과 같은 페이지에서 찾을 수 있습니다.
  
  
• 프로그램(또는 프로젝트) ID: SmartPass URL을 생성하려면 PassKit 프로그램 ID가 필요합니다.
  프로젝트 또는 프로그램의 Settings 탭에서 찾을 수 있습니다.

암호화된 SmartPass 링크 생성에 대한 자세한 내용은 이 PassKit 문서를 확인하세요.

1단계: 패스 데이터 페이로드 정의하기

먼저 쿠폰 또는 멤버 페이로드를 정의해야 합니다.

페이로드에 포함할 수 있는 다양한 구성 요소가 있지만, 여기서는 주의해야 할 두 가지 중요한 항목을 소개합니다:

사용 가능한 필드의 전체 목록, 유형 및 유용한 설명은 PassKit GitHub 설명서를 참조하세요.

페이로드 예시

1
2
3
4
5
6
7
8

{
  "members.member.externalId": "{{${user_id}}}",
  "members.member.points": "100",
  "members.tier.name": "current_customer",
  "person.displayName": "{{${first_name}}} {{${last_name}}}",
  "person.externalId": "{{${user_id}}}",
  "universal.expiryDate": "{{ "now" | date: "%s" | plus: 31622400 | date: "%FT%TZ" }}"
}

2단계: 정의되지 않은 페이로드 변수 생성 및 인코딩하기

Braze 대시보드에서 Content > Content Block으로 이동하여 새 콘텐츠 블록을 생성하고 이름을 지정합니다.

Create Content Block을 선택하여 시작합니다.

다음으로, Content Block Liquid Tag를 정의해야 합니다. 이 콘텐츠 블록을 저장한 후 메시지를 작성할 때 이 Liquid 태그를 참조할 수 있습니다. 이 예시에서는 Liquid 태그를 {{content_blocks.${passKit_SmartPass_url}}}로 지정했습니다.

이 콘텐츠 블록 내에서는 페이로드를 직접 포함하지 않고, {{passData}} 변수에서 참조합니다. 콘텐츠 블록에 추가해야 하는 첫 번째 코드 스니펫은 {{passData}} 변수의 Base64 인코딩을 캡처합니다.

1

{% capture base64JsonPayload %}{{passDatapassData|base64_encode}}{% endcapture %}

3단계: SHA1 HMAC 해시를 사용하여 암호화 서명 생성하기

다음으로, 프로젝트 URL과 페이로드의 SHA1 HMAC 해시를 사용하여 암호화 서명을 생성합니다.

콘텐츠 블록에 추가해야 하는 두 번째 코드 스니펫은 해싱에 사용할 URL을 캡처합니다.

1

{% capture url %}{{projectUrl}}?data={{base64JsonPayload}}{% endcapture %}

다음으로, 이 해시와 Project Secret을 사용하여 서명을 생성해야 합니다. 이는 세 번째 코드 스니펫을 포함하여 수행할 수 있습니다:

1

{% capture sig %}{{url | hmac_sha1: "Project_Secret"}}{% endcapture %}

마지막으로, 다섯 번째 코드 스니펫을 사용하여 전체 URL에 서명을 추가합니다:

1

{% capture longURL %}{{projectUrl}}?data={{base64JsonPayload}}&sig={{sig}}{% endcapture %}

4단계: URL 출력하기

마지막으로, 최종 URL을 호출하여 메시지 내에 SmartPass URL이 출력되도록 합니다.

1

{{longURL}}

이 시점에서 다음과 같은 콘텐츠 블록이 생성됩니다:

1
2
3
4
5
6
7
8
9

{% capture base64JsonPayload %}{{passData|base64_encode}}{% endcapture %}

{% capture url %}{{projectUrl}}?data={{base64JsonPayload}}{% endcapture %}

{% capture sig %}{{url | hmac_sha1: "Project_Secret"}}{% endcapture %}

{% capture longURL %}{{projectUrl}}?data={{base64JsonPayload}}&sig={{sig}}&utm_source=braze&utm_campaign={{campaign.${name}}}{% endcapture %}{% capture longURL %}{{longURL | url_encode}}{% endcapture %}

{{longURL}}

이 예시에서는 이러한 설치의 소스를 Braze 및 이 Campaign으로 추적하기 위해 UTM 파라미터가 추가되었습니다.

팁

페이지를 떠나기 전에 콘텐츠 블록을 저장하세요.

5단계: 모든 것을 조합하기

이 콘텐츠 블록이 생성되면 향후 다시 재사용할 수 있습니다.

예시 콘텐츠 블록에 정의되지 않은 두 개의 변수가 남아 있음을 알 수 있습니다.
{{passData}} - 1단계에서 정의한 JSON 패스 데이터 페이로드
{{projectUrl}} - PassKit 프로젝트의 배포 탭에서 찾을 수 있는 프로젝트 또는 프로그램의 URL.

이것은 의도적인 결정이며 콘텐츠 블록의 재사용성을 지원합니다. 이러한 변수는 콘텐츠 블록 내에서 생성되는 것이 아니라 참조만 되므로, 콘텐츠 블록을 다시 만들지 않고도 변수를 변경할 수 있습니다.

예를 들어, 로열티 프로그램에서 소개 오퍼를 변경하여 더 많은 초기 포인트를 포함하고 싶거나, 보조 멤버 카드 또는 쿠폰을 생성하고 싶을 수 있습니다. 이러한 시나리오에서는 서로 다른 PassKit projectURL 또는 서로 다른 패스 페이로드가 필요하며, 이를 Braze에서 Campaign별로 정의합니다.

메시지 본문 작성하기

메시지 본문에서 이 두 변수를 캡처한 다음 콘텐츠 블록을 호출해야 합니다. 1단계에서 축소된 JSON 페이로드를 캡처합니다:

프로젝트 URL 할당하기

1

{% assign projectUrl = "https://pub1.pskt.io/c/ww0jir" %}

JSON 캡처하기

1

{% capture passData %}{"members.member.externalId": "{{${user_id}}}","members.member.points": "100","members.tier.name": "current_customer","person.displayName": "{{${first_name}}} {{${last_name}}}","person.externalId": "{{${user_id}}}","universal.expiryDate": "{{ "now" | date: "%s" | plus: 31622400 | date: "%FT%TZ" }}"}{% endcapture %}

방금 만든 콘텐츠 블록 참조하기

1

{{content_block.${passkit_SmartPass_url}}}

메시지 본문은 다음과 같이 표시되어야 합니다:

샘플의 출력 URL은 다음과 같습니다:

출력 URL은 길 수 있습니다. 이는 모든 패스 데이터를 포함하고 URL 수정을 통한 데이터 무결성 보장 및 변조 방지를 위해 최고 수준의 보안을 통합하기 때문입니다. SMS를 사용하여 이 URL을 배포하는 경우, bit.ly와 같은 링크 단축 프로세스를 통해 처리할 수 있습니다. 이는 bit.ly 엔드포인트에 대한 연결된 콘텐츠 호출을 통해 수행할 수 있습니다.

PassKit 웹훅을 사용하여 패스 업데이트

Braze 내에서 웹훅 Campaign 또는 Canvas 내의 웹훅을 설정하여 사용자의 행동에 따라 기존 패스를 업데이트할 수 있습니다. 유용한 PassKit 엔드포인트에 대한 자세한 내용은 다음 링크를 확인하세요.

• 회원 프로젝트
• 쿠폰 프로젝트
• 항공편 프로젝트

페이로드 매개변수

시작하기 전에 PassKit에 대한 생성 및 업데이트 웹훅에 포함할 수 있는 일반적인 JSON 페이로드 매개변수를 확인하세요.

1단계: Braze 웹훅 템플릿 생성

향후 Campaign 또는 Canvases에서 사용할 PassKit 웹훅 템플릿을 만들려면, Braze 대시보드의 템플릿 및 미디어 섹션으로 이동하세요. 일회성 PassKit 웹훅 Campaign을 만들거나 기존 템플릿을 사용하려면, 새 Campaign을 만들 때 Braze에서 웹훅을 선택하세요.

PassKit 웹훅 템플릿을 선택하면 다음과 같은 내용이 표시됩니다:

• 웹훅 URL: https://api-pub1.passkit.io/coupon/singleUse/coupon
• 요청 본문: Raw Text

요청 헤더 및 메서드

PassKit은 base 64로 인코딩된 PassKit API 키를 포함하는 인증을 위한 HTTP Header가 필요합니다. 다음은 이미 키-값 페어로 템플릿에 포함되어 있지만, 설정 탭에서 <PASSKIT_LONG_LIVED_TOKEN>을 PassKit 토큰으로 교체해야 합니다. 토큰을 검색하려면 PassKit 프로젝트/프로그램으로 이동한 후 Settings > Integrations > Long Lived Token으로 이동하세요.

• HTTP 메서드: PUT
• 요청 헤더:
  • Authorization: Bearer <PASSKIT_LONG_LIVED_TOKEN>
  • Content-Type: application/json

요청 본문

웹훅을 설정하려면, 사용 사례에 필요한 페이로드 매개변수를 포함하여 요청 본문 내에 새 이벤트 세부 정보를 입력하세요:

1
2
3
4
5

{
  "externalId": "{{${user_id}}}",
  "campaignId": " 2xa1lRy8dBz4eEElBfmIz8",
  "expiryDate": "2020-05-10T00:00:00Z"
}

2단계: 요청 미리보기

원시 텍스트에 적용 가능한 Braze 태그가 있으면 자동으로 강조 표시됩니다.

미리보기 패널에서 요청을 미리 보거나 테스트 탭으로 이동하여 임의의 사용자, 기존 사용자를 선택하거나 직접 커스텀하여 웹훅을 테스트할 수 있습니다.

중요

페이지를 떠나기 전에 템플릿을 저장하세요!
업데이트된 웹훅 템플릿은 새 웹훅 Campaign을 만들 때 저장된 웹훅 템플릿 목록에서 찾을 수 있습니다.

연결된 콘텐츠를 통한 패스 세부 정보 검색

패스를 생성하고 업데이트하는 것 외에도, Braze 연결된 콘텐츠를 통해 사용자의 패스 메타데이터를 검색하여 메시징 캠페인에 개인화된 패스 세부 정보를 포함할 수 있습니다.

PassKit 연결된 콘텐츠 호출

1
2
3

{% connected_content  https://api-pub1.passkit.io/coupon/singleUse/coupon/externalId/{{${user_id}}} :headers {"Authorization": "Bearer <PASSKIT_LONG_LIVED_TOKEN>","Content-Type": "application/json"} :save passes %}

{{passes.status}}

Liquid 응답 예시

• passes redemptiondetails
• passes status

1
2
3
4
5
6
7
8
9
10
11

{
    "redemptionDate": null,
    "redemptionCode": "",
    "lat": 0,
    "lon": 0,
    "alt": 0,
    "redemptionSource": "",
    "redemptionReference": "",
    "transactionReference": "",
    "transactionAmount": 0
}

1

UNREDEEMED