Skip to main content
パーソナライゼーションの失敗は、MoEngage のデータセットに存在しないユーザー属性またはイベント属性を使用し、フォールバックを設定していない場合に発生します。

パーソナライゼーションエラー

パーソナライゼーションエラーは、Error breakdown テーブルの Failed to Send エラーカテゴリで確認できます。パーソナライゼーションエラーの Name 列にある See breakdown をクリックすると、パーソナライゼーションが失敗したユーザー数と失敗の理由の詳細を表示できます。 Personalization Failed.png Screenshot 2023-10-03 at 1.53.24 PM.png MOE_NOT_SEND タグを使用してカスタム Jinja エラーを設定すると、定義した配信条件を満たさなかった場合に、キャンペーンの分析ページのエラー内訳セクションに指定したメッセージが表示されます。 image (5).png

パーソナライゼーション失敗分析

Personalization failure analysis は、パーソナライゼーションの失敗を引き起こす特定の属性を特定するのに役立ち、その原因に関する詳細なインサイトを提供します。
パーソナライゼーションエラーは、次のカテゴリに分類できます。
Failed to Send の Personalization Failed カテゴリに表示される失敗数は、パーソナライゼーションが失敗したユーザーのユニーク数を示します。同じユーザーに複数の失敗が発生し、UI に表示される各失敗カテゴリでカウントされる場合があるため、この数は Personalization failure analysis ポップアップウィンドウに表示される数と異なる場合があります。たとえば、あるユーザーでユーザー属性とイベント属性の両方の失敗が発生した場合、分析ページではその両方のセクションの失敗数にカウントされます。一方、Personalization Failed セクションでは 1 としてカウントされます。
Personalization Failure Analysis.png

パーソナライゼーションの失敗

テンプレート通知とバックアップ通知の両方をパーソナライズしたものの、パーソナライゼーションのフォールバックを追加していないシナリオを考えてみましょう。この場合、テンプレートまたはバックアップのパーソナライゼーションが失敗すると、通知はどのユーザーにも送信されません。これは、テンプレートとバックアップが 1 つのペイロードの一部と見なされるためです。パーソナライゼーションのフォールバックが存在しないため、失敗した場合に MoEngage がユーザーに送信できる代替メッセージがありません。 この問題を回避するには、メッセージにパーソナライゼーションのバックアップを必ず追加してください。

内部エラー

MoEngage の内部システムはいくつかのエラーを生成します。これらは、すべてのプラットフォームに送信される Push メッセージに適用されます。

Jinja および HTML エディターの FAQ

動的に生成したテーブルが保存後に正しくレンダリングされないのはなぜですか?

HTML テーブルには厳密な構造階層があります: <table> > <tbody> > <tr> > <td>。Jinja の for ループが、完全な <tr>...</tr> 行を囲むのではなく、<table> または <tbody> の直下に配置されている場合、メールの HTML エディターはこれを無効なマークアップとして扱い、テンプレートの保存時に Jinja タグを移動または削除して自動修正します。 これが、保存後にバックエンドで Jinja が異なって見える理由であり、結果として得られるテーブルが期待どおりにレンダリングされない理由です。エディターはパーソナライゼーションを破損しているのではなく、無効と判断した HTML を「修正」しているのです。 正しいパターン: セルの内容だけでなく <tr> 行全体をループで囲み、ループを <tbody> 内に配置します。
{% for %} / {% endfor %} タグを、完全な <tr>...</tr> 行を囲まずに <table> または <tbody> の直下に配置しないでください。エディターは無効な位置に配置されたタグを移動または削除するため、動的テーブルが気付かないうちに壊れる可能性があります。
ループの詳細については、Jinja Templating Language を参照してください。

リッチエディターで Jinja の条件に TemplateSyntaxError が表示されるのはなぜですか?

スタイル付きのメールおよびプッシュテンプレートに使用されるリッチ(Froala)エディターは、Jinja 内に出現する > および < 比較演算子を HTML エンコードします(> は &gt; に、< は &lt; になります)。これにより、次のようなテンプレートエラーが発生します。
その結果、パーソナライゼーションのレンダリングが失敗します。 これは、リッチ/スタイル付きエディターで作成されたテンプレートにのみ影響します。基本(非リッチ)エディターやカスタム HTML/ソースビューではエンコード処理が行われないため、同じ Jinja が正しく動作します。 これを回避するには:
  • > / < を使用しないように条件を書き換えます。たとえば、代わりに != を使用します。
  • または、リッチエディターではなく、自動エンコードが適用されないカスタム HTML/ソースビューで Jinja を作成します。

キャンペーンの保存または送信時に “unexpected char u’$’” が返されるのはなぜですか?

キャンペーンの保存または送信時に Error in parsing jinja template format. Error unexpected char u'$' at ... のようなエラーが表示される場合、コンテンツ内のパーソナライゼーショントークンが URL エンコードされている可能性があります。URL エンコードにより、{{ 区切り文字は %7B%7B に、$ は %24 に置き換えられ、デコードすると Jinja が解析できない {{$ シーケンスになります。 これを解決するには: パーソナライゼーショントークンおよびそれを含むリンクは、エディターで提供されるトークンまたはマージタグを使用して、エンコードせずに挿入してください。手動で URL エンコードした値を HTML や href に貼り付けないでください。 詳細については、Jinja Templating Language を参照してください。