メールテンプレートのエラーメッセージのトラブルシューティング

このページで学べること

メールテンプレートでエラーまたは警告が表示された場合は、メッセージを送信する前に解決する必要がある可能性があります。このリソースで発生しているエラー メッセージまたは警告を検索して、問題を解決するためのヒントを確認してください。

キャンペーン送信の警告

• メール内に、デフォルトのテキストが未変更のまま残っているブロック、または空の状態のブロックが # 件見つかりました。続ける前にメールを確認してください。
  この警告が表示された場合は、空のブロックまたはプレースホルダーコンテンツ（例：「これはテキスト ブロックです。編集するにはここをクリック...」）を探してください。テンプレート内で。テンプレートのデスクトップ版とモバイル版を確認してください。空のブロックまたはプレースホルダーコンテンツが見つからない場合は、自分宛てにプレビュー メッセージを送信し、デスクトップとモバイルの両方で確認してください。プレビューに問題がなければ、メッセージは安全に送信できるため、この警告は無視して構いません。
• メールコンテンツに問題がある可能性があります。メール内にリンクが含まれていないようです。メールにリンクを追加し忘れていませんか？
  この警告は、プレーンテキストメールまたはカスタムHTMLメールにリンクが含まれていない場合に表示されます。メッセージを確認し、行動喚起用のリンクを含め、すべてのコンテンツが追加されていることを確かめてください。メールに（購読解除リンク以外の）リンクを一切含めたくない場合は、この警告を無視できます。
• 購読解除リンク。このテンプレートには購読解除リンクがありません。Klaviyoがメール送信時に自動的に購読解除リンクを追加します。
  この警告は、メッセージに購読解除タグ（例：{% unsubscribe %}または{% unsubscribe_link %}）を追加していない場合に表示されます。メッセージにKlaviyoのデフォルトフッターが追加されないように、購読解除リンクを追加してください。

エラーをプレビューする

メッセージをプレビューする際に、次のエラーメッセージが表示される場合があります：

タグまたは変数なしで表示されるメッセージ
無効なテンプレートタグまたは変数を修正し、実際のプロファイルとイベントを含むメッセージをプレビューしてください。

このメッセージは、Klaviyoがテンプレートタグまたは変数をレンダリングできなかったことを意味します。エラーの原因を特定するには、メッセージの件名と本文コンテンツに含まれる変数、タグ、または条件付きステートメント（つまり、テンプレート内で{{ }} or {% %}で囲まれているもの）が、メッセージのパーソナライズ参照で説明されている形式に従っているかを確認してください。以下に、エラーの原因を特定するためのヒントを示します。

• メッセージのデスクトップ版とモバイル版の両方を確認してください。
• メッセージにユニーククーポンが含まれている場合は、クーポン名が正しいこと、およびクーポンがクーポンタブで設定されていることを確認してください。

問題を修正した後、テンプレートで使用しているデータを含むプロファイルまたはイベントで、メッセージをもう一度プレビューしてください。テストメールを送信する前に、変数が設定されていることを確認してください。

カスタム HTML テンプレート エラー

• 次の画像が見つかりませんでした：... アップロードしたzipファイルに含まれていることを確認してください。
  すべての画像ソースパスのスペルが正しいこと、およびアップロードした画像のファイル名と一致していることを確認してください。エラーメッセージに画像パスが表示されない場合は、HTMLファイルに空のbackground属性（例：background=""）がないか確認してください。空のbackground属性を削除し、修正後のHTMLファイルをもう一度アップロードしてください。
• {% unsubscribe %} タグが必要です。
  このエラーを解消するには、メッセージフッターに Klaviyo 購読解除タグを追加してください。
• 残りを解析できませんでした: 'XYZ'の'Z'。
  このエラーは、Klaviyoがテンプレート式の一部を読み取れなかったことを意味します。エラー内で引用されている式について、引用符の配置ミスや重複、プロパティ名内のスペース、またはフィルター構文の誤りがないか確認してください。問題は{{ }}変数または{% %}タグ内にある可能性があります。サポートされている構文と例については、メッセージパーソナライゼーションのリファレンスを参照してください。

カタログエラー

テンプレートで カタログ参照タグ を使用している場合、コード: __ のアイテムが見つかりません。削除された可能性があります。というエラーが発生することがあります。

このエラーが表示される場合、タグに含まれている商品IDを認識できないことを意味します。以下を確認してください：

• アイテム ID を含むイベントでプレビューしています（アイテム ID が動的にイベント データを参照する場合）。
• アイテムIDがイベントデータまたはプロファイルプロパティに由来する場合、参照は正しくフォーマットされています。
• タグ、イベントデータ、またはプロファイルプロパティ内のアイテムIDが、Klaviyoカタログ内のアイテムと一致しています。

Shopify テンプレート エラー

• Body html Liquid syntax error: Unknown tag 'unsubscribe'
  Body html Liquid syntax error: Unknown tag 'web_view'
  これらのエラーや同様のエラーは、Shopifyにエクスポートする前にKlaviyo固有のタグがテンプレートに追加されたことを意味します。Shopifyは、Klaviyoの購読解除、配信設定の管理、またはウェブビューリンクをサポートしていません。再度エクスポートする前に、Shopify通知テンプレートからそれらのKlaviyo固有のリンクを削除してください。
• 本文 Html Liquid 構文エラー：不明なタグ "Load"
  このエラーは、エクスポートされたHTMLにShopifyがサポートしていないKlaviyo固有のタグが含まれていることを示しています。Shopifyの通知テンプレートにKlaviyoの商品ブロックが含まれている場合は、それを削除し、テンプレートのHTMLをエクスポートして、Shopifyにインポートしてください。
• Body html Liquid構文エラー：不明なタグ'elsif'
  Body html Liquid構文エラー：'if'タグが閉じられていません
  Body html Liquid構文エラー：'X'タグが閉じられていません
  KlaviyoのShopify通知テンプレートの多くには条件文が含まれており、顧客の注文ステータスに基づいてメッセージを動的にします。また、注文内の商品に対してコンテンツを繰り返すループも含まれています。条件文またはループの一部が削除されると、上記のようなエラーが表示されることがあります。
  
  これを解決するには、Klaviyoでテンプレートを開き、不足しているタグを復元してください。各{% if ... %}には対応する{% endif %}が必要で、各{% for ... %}には対応する{% endfor %}が必要です。{% elsif ... %}と{% else %}は、対応する条件文の中に入れたままにしてください。意図的に条件文またはループを削除する場合は、その内容を含むブロック全体を削除し、一致しないタグや商品変数が残らないようにしてください。次の開始タグ、分岐タグ、終了タグを探してください：
  • {% for item in...
  • {% endfor %}
  • {% if...
  • {% elsif...
  • {% else %}
  • {% endif%}

変更を行った後、更新したテンプレートをエクスポートし、Shopifyにインポートしてください。保存する前に、Shopifyで通知をプレビューしてテストしてください。Shopify通知の変数はShopify内で反映されます。Klaviyoのプレビューではスタイル設定のみを確認できます。