プロモーションコードの使用
キャンペーンやキャンバスでプロモーションコードを使用し、使用状況を確認する方法を説明します。
前提条件
プロモーションコードを使用する前に、プロモーションコードリストを作成する必要があります。
プロモーションコードの使用
メッセージでプロモーションコードを送信するには、以前に作成したプロモーションコードリストの横にあるスニペットをコピーを選択します。

コードスニペットを Braze のメッセージに貼り付け、Liquid を使用してリストからユニークなプロモーションコードを挿入します。そのコードは送信済みとしてマークされ、他のメッセージが同じコードを送信しないようになります。

キャンバスステップ間での使用
コードスニペットがマルチチャネルメッセージを含むキャンペーンまたはキャンバスで使用される場合、各ユーザーにユニークなコードが割り当てられます。プロモーションコードを参照する複数のステップを持つキャンバスでは、ユーザーが入るステップごとに新しいコードが割り当てられます。
キャンバスで1つのプロモーションコードを割り当て、ステップ間で再利用するには:
- 最初のステップ(ユーザーの更新)でプロモーションコードをカスタム属性として割り当てます。
- 後続のステップでは、新しいコードを生成する代わりに、Liquid を使用してそのカスタム属性を参照します。
ユーザーが複数のチャネルでコードの対象となる場合、各チャネルで同じコードが送信されます。例えば、メールとプッシュの両方でメッセージを受信する場合、同じコードが両方に送信されます。レポートにも単一のコードとして反映されます。
利用可能なプロモーションコードがない場合、コードに依存するテストメッセージまたはライブメッセージは送信されません。
アプリ内メッセージキャンペーン
アプリ内メッセージキャンペーンを作成した後、アプリ内メッセージの本文にプロモーションコードリストスニペットを挿入できます。アプリ内メッセージのプロモーションコードは、ユーザーがアプリ内メッセージの表示をトリガーした場合にのみ差し引かれ、使用されます。
テストメッセージ
テスト送信およびシードグループのメール送信では、別途リクエストしない限りプロモーションコードが消費されます。テスト送信やシードグループのメール送信でプロモーションコードが使用されないようにするには、Braze アカウントマネージャーに連絡してこの機能の動作を更新してください。
Currents でのメッセージエクストラとの使用
プロモーションコードとmessage_extras組み合わせることで、プロモーションコード情報をCurrentsに送信できる。プロモーションコードを変数に保存するには タグcaptureを使う。その後、その変数をmessage_extras で参照する。
1
2
3
4
5
{% capture code %}
{% promotion('puttshacktest2') %}
{% endcapture %}
Use {{code}} for an exclusive discount!
{% message_extras :key cardscode :value {{code}} %}
プロモーションコードをユーザープロファイルに保存する
後続のメッセージで同じプロモーションコードを参照するには、コードをカスタム属性としてユーザープロファイルに保存する必要があります。これは、メッセージステップの直前にユーザーの更新ステップを使用して、割引コードを「Promo Code」などのカスタム属性に割り当てることで実現できます。
まず、ユーザーの更新ステップの各フィールドに以下を選択します:
- 属性名: Promo Code
- アクション: 更新
- キー値: プロモーションコードの Liquid コードスニペット(例:
{% promotion('spring25') %})
次に、カスタム属性(この例では {{custom_attribute.${Promo Code}}})をメッセージに追加します。割引コードがテンプレートとして挿入されます。
プロモーションコードの使用状況を確認する
残りのコード数は、プロモーションコードページのプロモーションコードリストの残り列で確認できます。

このコード数は、既存のプロモーションコードリストページを再度開いたときにも確認できます。また、未使用のコードをCSVファイルとしてエクスポートすることもできます。

マルチチャネルおよびシングルチャネル送信
マルチチャネルおよび単一送信のキャンペーンやキャンバスでは、メッセージの Liquid で参照されるすべてのプロモーションコードは、メッセージが送信される前に差し引かれます。これにより以下が保証されます:
- マルチチャネルメッセージのチャネル間で同じプロモーションコードが使用されます。
- メッセージが失敗または中止された場合に、余分なプロモーションコードが使用されません。
ユーザーが1つのメッセージで参照される2つのプロモーションコードリストを持ち、そのメッセージが Liquid の条件分岐タグで分割されている場合でも、ユーザーがどの条件フローに進むかに関係なく、すべてのプロモーションコードが差し引かれます。
ユーザーが新しいキャンバスステップに入るか、キャンバスに再入場し、そのユーザーへのメッセージにプロモーションコードの Liquid スニペットが再度適用される場合、新しいプロモーションコードが使用されます。
例
以下の例では、プロモーションコードリスト vip-deal と regular-deal の両方が差し引かれます。Liquid は以下の通りです:
1
2
3
4
5
{% if user.is_vip %}
{% promotion('vip-deal') %}
{% else %}
{% promotion('regular-deal') %}
{% endif %}
Braze では、使用見込み数よりも多くのプロモーションコードをアップロードすることを推奨しています。プロモーションコードリストが期限切れになるか、プロモーションコードが不足した場合、後続のメッセージは中止されます。
Braze でのプロモーションコードの消費の仕組みを例えで説明します。
メッセージの送信を郵便局で手紙を送ることに例えてみましょう。手紙を窓口係に渡すと、窓口係はその手紙にクーポンを同封する必要があることに気づきます。窓口係はクーポンの束から最初の1枚を取り出し、封筒に入れます。窓口係は手紙を送りますが、何らかの理由で手紙が配達中に紛失してしまいます(クーポンも一緒に失われます)。
このシナリオでは、Braze が郵便窓口係であり、プロモーションコードがクーポンです。プロモーションコードの束から取り出された後は、Webhook の結果に関係なく、コードを取り戻すことはできません。