Skip to content

メッセージの中止

オプションとして、条件文内で abort_message("optional reason for aborting") Liquid メッセージタグを使用して、ユーザーへのメッセージ送信を防止できます。このリファレンス記事では、マーケティングキャンペーンでこの機能を使用する方法の例をいくつか紹介します。

abort_message() を使用したテスト送信

abort_message() は、条件を満たさないユーザーへの送信を停止します。メッセージはユーザーのプロファイルに表示されず、配信数やフリークエンシーキャップにもカウントされません。

テスト送信が届かない場合は、中止条件を満たすユーザーとしてプレビューし、テスト送信で現在のプレビューユーザーの属性で受信者の属性を上書きするを有効にしてください（または条件を満たすコンテンツテストグループのメンバーを追加してください）。

「Number Games Attended」= 0 の場合にメッセージを中止する

たとえば、試合に参加したことがない顧客にはメッセージを送信したくない場合を考えてみましょう。

1
2
3
4
5
6
7

{% if custom_attribute.${Number_Game_Attended} == 1 %}
Loved the game? Get 10% off your second one with code SAVE10.
{% elsif custom_attribute.${Number_Game Attended} > 1 %}
Love the games? Get 10% off your next one with code SAVE10.
{% else %}
{% abort_message() %}
{% endif %}

このメッセージは、試合に参加したことが確認されている顧客にのみ送信されます。

英語を話す顧客にのみメッセージを送信する

顧客の言語が英語の場合に一致する「if」文と、英語を話さない、またはプロファイルに言語が設定されていない人に対してメッセージを中止する「else」文を作成することで、英語を話す顧客にのみメッセージを送信できます。

1
2
3
4
5
6

{% if ${language} == 'en' %}
Send this message in English!
{% else %}
{% abort_message() %}
{% endif %}

デフォルトでは、Brazeはメッセージアクティビティログに汎用的なエラーメッセージを記録します。

1

{% abort_message %} called

また、かっこ内に文字列を含めることで、中止メッセージにメッセージアクティビティログへの記録内容を指定することもできます。

1

{% abort_message('language was nil') %}

開発者コンソールのメッセージエラーログ。中止メッセージとして「language was nil」が表示されています。

中止メッセージのクエリ

クエリビルダー、またはBrazeに接続されている独自のデータウェアハウスを使用して、Liquidロジックによってメッセージが中止されたときにトリガーされる特定の中止メッセージをクエリできます。

中止ロジックが評価されるタイミング

中止ロジックの評価タイミングは、メッセージチャネルによって異なります。

プッシュ、メール、SMS、Webhook、Content Cards

中止ロジックは、Brazeが配信のためにメッセージを処理する送信時に評価されます。

アプリ内メッセージ

中止ロジックは、テンプレート化されたアプリ内メッセージに対してのみ、メッセージが最初にデバイスに送信されたときではなく、アプリ内メッセージがトリガーされたとき（たとえば、ユーザーがトリガーイベントを実行したときやセッションを開始したとき）に評価されます。アプリ内メッセージはセッション開始時にSDKに配信され、ローカルにキャッシュされます。abort_message() 呼び出しを含むLiquidは、トリガー条件が満たされたときに実行されます。

高い中止率のトラブルシューティング

キャンペーンやキャンバスステップで多くのユーザーがエントリしたにもかかわらず送信数が少ない場合、または配信数が予想より低い場合、中止ロジックが一般的な原因です。特に、Liquidが評価時に欠落している属性、カタログデータ、またはリスト値を必要とする場合に発生します。

メッセージアクティビティログを確認する

  1. Brazeダッシュボードで、キャンペーンまたはキャンバスメッセージステップのメッセージアクティビティログを開きます。
  2. 中止関連のエントリをフィルタリングします。デフォルトでは、Brazeは {% abort_message %} called を記録します。abort_message() に理由の文字列を渡した場合は、そのテキストが代わりに表示されます。
  3. 中止が1つのチャネル（たとえばメールのみ）に集中しているか、同じキャンバス内の複数のチャネルにまたがっているかを確認します。

送信時の属性とLiquidを確認する

プッシュ、メール、SMS、Webhook、Content Cardsの場合、中止ロジックはBrazeが配信のためにメッセージを処理するときに実行されます。ユーザーがキャンバスにエントリしたときや、以前にトリガーイベントが発生したときではありません。

  • メッセージステップが実行される前に、必要なカスタム属性、イベントプロパティ、またはカタログフィールドがユーザーに設定されていることを確認します。
  • abort_message() を呼び出す前に、明示的なnilまたは空のチェックを追加します。値が欠落しているときに中止する else ブランチは、そのデータを持たないすべてのユーザーへの送信を停止します。
  • パーソナライゼーションがリスト、セグメント、またはConnected Contentのレスポンスに依存している場合、メッセージステップの実行時にそのデータが利用可能であることを確認します。リストのメンバーシップや下流のデータが準備される前に、ユーザーがキャンバスにエントリする可能性があります。

キャンバス固有の動作

キャンバスでメッセージステップが中止された場合、ユーザーはキャンバスから退出しません。代わりに、次のステップに進みます。中止は、そのメッセージステップの送信数にのみ影響します。

キャンバスの中止を診断する場合：

  • メッセージステップのエントリユーザー数と、同じステップの送信ユーザー数を比較します。
  • 1つのチャネルのみが中止される場合、そのステップのチャネル固有のLiquidまたは購読ステータスを確認します。
  • リストまたはカタログの更新後に中止が急増した場合、更新が完了する前にメッセージステップが実行されたかどうかを確認します。

プレビューとテスト送信で検証する

メッセージ作成画面で、影響を受ける受信者のプロファイルに一致するユーザーとしてプレビューします。テスト送信では、中止ロジックがプロファイルデータに依存している場合、現在のプレビューユーザーの属性で受信者の属性を上書きするを有効にしてください。

その他の中止の例については、中止メッセージのクエリを参照してください。

考慮事項

abort_message() Liquidメッセージタグは、ユーザーへのメッセージ送信を防止します。つまり、メッセージはユーザープロファイルに表示されず、配信数やフリークエンシーキャップにもカウントされません。
New Stuff!