Skip to content

Punchhによる動的コード生成

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

この統合はPunchhによって管理されています。

統合について

PunchhクーポンフレームワークとBrazeを使用すると、以下のシナリオを実現できます。

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

動的クーポンコード生成の統合

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

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

Punchhでクーポンキャンペーンを作成するためのフォーム。

ステップ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 %}

以下を置き換えてください。

プレースホルダー 説明
DYNAMIC_COUPON_GENERATION_TOKEN 動的クーポン生成トークン。
CAMPAIGN_ID Campaign ID。

ステップ3：クーポンコードをメッセージ本文に追加する

Punchh Webページへのリンク

PunchhがホストするWebページにリンクするには、先ほど作成した動的生成URLに{{jwt}}を追加します。リンクは以下のようになります。

1

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

ユーザーがクーポンURLをクリックすると、PunchhがホストするWebページにリダイレクトされ、生成されたクーポンが表示されます。

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

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

クーポンコード画像タグのレンダリング出力。

エラーメッセージ
New Stuff!