Punchhによる動的コード生成

クーポンコードとは、一人のユーザーが使用できるユニークなコードである（一回使用でも複数回使用でも）。Punchhフレームワークはクーポンコードを生成し、モバイルアプリ内やPOSシステムで処理することができる。

Punchhクーポン・フレームワークとBrazeを使えば、以下のようなシナリオが実現できる：

• ゲストがメール内のクーポン生成リンクをクリックすると、クーポンコードを生成する：クーポンコードは動的に生成され、ウェブページに表示される。
• ゲストがメールを開いたときにクーポンコードを生成する：クーポンコードは動的に生成され、メール内に画像として表示される。

動的なクーポンコード生成を統合する

ステップ1:クーポン・キャンペーンを作成する

1. Punchh クーポン・キャンペーンを使って、以下の画像のようにダイナミック・ジェネレーション・クーポン・キャンペーンを作成する。
2. Punchhクーポン・フレームワークは、ダイナミックなクーポン生成を可能にするために、以下のパラメーターを生成する：
   • 動的クーポン生成トークン：これは、暗号化のためにシステムが生成したセキュリティ・トークンである。
   • 動的クーポン生成URL：このURLは、ビジネスの要求に応じて、リンクまたは画像としてメールに埋め込まれる。

ステップ2:署名を生成し、URLを構築する

JWT.IO ライブラリは、JSONウェブトークンをデコード、検証、生成する。これは、2つの当事者間でクレームを安全に表現するための、オープンで業界標準のRFC 7519方式である。

次のClaimType の名前を使用して、ゲストとクーポンの一意性を確保できます。

• campaign_id: システム生成の Punchh キャンペーン ID を表します。
• email: ユーザーのメールアドレスを表します。
• first_name:ユーザーの名を取得します。
• last_name: ユーザーの姓を取得します。

Punchhのダイナミック・クーポン・コードAPIを使用するには、JWTトークンを構築する必要がある。Brazeダッシュボードの使用したいチャンネルのメッセージ本文に、以下のLiquidテンプレートを追加する：

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 Web ページへのリンク

Puncch がホストする Web ページにリンクするには、以前に作成した動的生成 URLに {{jwt}} を追加します。リンクは以下のようなものであるべきだ：

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

ユーザーがクーポンのURLをクリックすると、Punchがホストするウェブページにリダイレクトされ、そこで生成されたクーポンが表示される。

ユーザーがクーポンコードの生成に成功した後の確認メッセージの例。

JSON経由でコードをプレーンテキストとして抽出する

JSON 応答を返すには、以前に作成した動的生成 URL に{{jwt}} を追加し、URL 文字列のトークンの後に .json を追加します。リンクは以下のようなものであるべきだ：

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

その後、Connected Contentを活用して、コードをプレーンテキストとしてメッセージ本文に挿入することができる。以下に例を示します。

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}}">

エラーメッセージ