Punchh를 활용한 동적 코드 생성

쿠폰 코드는 단일 사용자가 사용할 수 있는 고유 코드입니다(단일 또는 다중 사용). Punchh 프레임워크는 모바일 앱 또는 POS(판매 시점) 시스템에서 처리할 수 있는 쿠폰 코드를 생성합니다.

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

통합 정보

Punchh 쿠폰 프레임워크와 Braze를 사용하면 다음과 같은 시나리오를 구현할 수 있습니다:

• 게스트가 이메일에서 쿠폰 생성 링크를 클릭할 때 쿠폰 코드 생성: 쿠폰 코드가 동적으로 생성되어 웹 페이지에 표시됩니다.
• 게스트가 이메일을 열 때 쿠폰 코드 생성: 쿠폰 코드가 동적으로 생성되어 이메일 내 이미지로 표시됩니다.

동적 쿠폰 코드 생성 통합

1단계: 쿠폰 Campaign 생성

1. Punchh 쿠폰 Campaign을 사용하여 다음 이미지와 같이 동적 생성 쿠폰 Campaign을 생성합니다.
2. Punchh 쿠폰 프레임워크가 동적 쿠폰 생성을 활성화하기 위해 다음 매개변수를 생성합니다:
   • 동적 쿠폰 생성 토큰: 암호화를 위해 시스템에서 생성된 보안 토큰입니다.
   • 동적 쿠폰 생성 URL: 이 URL은 비즈니스 요구 사항에 따라 이메일에 링크 또는 이미지로 삽입됩니다.

2단계: 서명 생성 및 URL 구성

JWT.IO 라이브러리는 JSON 웹 토큰을 디코딩, 검증 및 생성합니다. 이는 두 당사자 간에 클레임을 안전하게 표현하기 위한 개방형 산업 표준 RFC 7519 메서드입니다.

다음 ClaimType 이름을 사용하여 게스트와 쿠폰의 고유성을 보장할 수 있습니다:

• campaign_id: 시스템에서 생성된 Punchh Campaign ID를 나타냅니다.
• email: 사용자의 이메일 주소를 나타냅니다.
• first_name: 사용자의 이름을 캡처합니다.
• last_name: 사용자의 성을 캡처합니다.

Punchh 동적 쿠폰 코드 API를 사용하려면 JWT 토큰을 구성해야 합니다. 사용하려는 채널의 메시지 본문에 다음 Liquid 템플릿을 Braze 대시보드에 추가하세요:

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
{% assign header = '{"alg":"HS256","typ":"JWT"}' | base64_encode | replace: '=', '' | replace: '+', '-' | replace: '/', '_' %}

{% capture payload_raw %}

{
  "campaign_id": "CAMPAIGN_ID",
  "email": "{{${email_address}}}",
  "first_name": "{{${first_name}}}",
  "last_name": "{{${last_name}}}"
}

{% endcapture %}

{% assign payload = payload_raw | replace: ' ', '' | replace: '\n', '' | base64_encode | replace: '=', '' | replace: '+', '-' | replace: '/', '_' %}

{% assign unsigned_token = header | append: "." | append: payload %}

{% assign secret = "DYNAMIC_COUPON_GENERATION_TOKEN" %}

{% assign signature_raw = unsigned_token | hmac_sha256_base64: secret %}

{% assign signature = signature_raw | replace: '=', '' | replace: '+', '-' | replace: '/', '_' %}

{% assign jwt = unsigned_token | append: "." | append: signature %}

다음을 교체하세요:

3단계: 메시지 본문에 쿠폰 코드 추가

Punchh 웹 페이지로 연결

Punchh에서 호스팅하는 웹 페이지로 연결하려면 이전에 생성한 동적 생성 URL에 {{jwt}}를 추가하세요. 링크는 다음과 유사해야 합니다:

1
https://fakebrandz.punchh.com/request_coupons/7xY3bL9jRfZ1pA6mc8qD2eS4vT5wX?sign={{jwt}}

사용자가 쿠폰 URL을 클릭하면 Punchh에서 호스팅하는 웹 페이지로 리디렉션되며, 생성된 쿠폰이 표시됩니다.

JSON을 통해 일반 텍스트로 코드 추출

JSON 응답을 반환하려면 이전에 생성한 동적 생성 URL에 {{jwt}}를 추가한 다음, URL 문자열에서 토큰 뒤에 .json을 추가하세요. 링크는 다음과 유사해야 합니다:

1
https://fakebrandz.punchh.com/request_coupons/7xY3bL9jRfZ1pA6mc8qD2eS4vT5wX.json?sign={{jwt}}

그런 다음 연결된 콘텐츠를 활용하여 모든 메시지 본문에 일반 텍스트로 코드를 삽입할 수 있습니다. 예를 들어:

1
2
{% connected_content https://fakebrandz.punchh.com/request_coupons/7xY3bL9jRfZ1pA6mc8qD2eS4vT5wX.json?sign={{jwt}} :save punchh_coupon %}
{{punchh_coupon.coupon}}

이메일 콘텐츠 내 이미지에 연결

쿠폰 코드를 이미지 내에 연결하려면:

1. 이전에 생성한 동적 생성 URL에 {{jwt}}를 추가합니다.
2. URL 문자열에서 토큰 뒤에 .png를 추가합니다.
3. HTML <img> 태그에 링크를 삽입합니다.

• 입력 예시
• 출력 예시

1
<img src="https://fakebrandz.punchh.com/request_coupons/7xY3bL9jRfZ1pA6mc8qD2eS4vT5wX.png?sign={{jwt}}">

오류 메시지