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

このページで学べること

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

キャンペーン送信の警告

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

エラーをプレビューする

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

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

このエラーは、メッセージ内のどこかに無効な構文があることを意味します。エラーの原因を特定するには、メッセージの件名と本文コンテンツで、変数、タグ、または条件文（つまり、テンプレート内で波括弧 {} に囲まれているもの）について、Klaviyo のヘルプセンターのリソースに記載されている形式に従っていないものがないか確認してください。以下は、エラーを見つけるためのヒントです：

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

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

• 次の画像が見つかりませんでした: ... アップロードした zip ファイルに含まれていることを確認してください。
  すべての画像ソース パスのスペルが正しいこと、またアップロードした画像のファイル名と一致していることを確認してください。エラー メッセージに画像パスが指定されていない場合は、HTML ファイル内に空の background 属性（例: background=””）がないか確認してください。
• {% unsubscribe %} タグが必要です。
  このエラーを解消するには、メッセージフッターに Klaviyo 購読解除タグを追加してください。
• 残りを解析できませんでした：'XYZ' から 'Z'。
  このエラーは、タグ（{% %} で囲まれたもの）が 1 つ 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 の購読解除、設定の管理、またはウェブビューリンクをサポートしていません。
• 本文 Html Liquid 構文エラー：不明なタグ "Load"
  Shopify は Klaviyo の商品ブロック機能をサポートできません。Shopify の通知テンプレートに商品ブロックを追加し、そのテンプレートを Shopify にインポートすると、このエラーが表示されます。商品ブロックを削除し、テンプレートの HTML をエクスポートして、Shopify にインポートします。
• Body html Liquid syntax error: Unknown tag 'elsif'
  Body html Liquid syntax error: 'if' tag was never closed
  Body html Liquid syntax error: 'X' Tag Was Never Closed
  Klaviyo の Shopify 通知テンプレートの多くには条件付きステートメントが含まれており、顧客の注文ステータスに基づいてメッセージを動的にします。条件文の一部が削除されると、上記のようなエラーが表示されます。
  
  これを解決するには、Klaviyo でテンプレートを開き、条件文の残りの要素を削除します。次で始まるタグを検索します：
  • { % for item in...
  • {% endfor %}
  • {% if...
  • {% elsif...
  • {% else %}
  • {% endif%}