sales-klaviyo

Klaviyo プラットフォームのヘルプ

Flows や Campaigns から Segmentation、Predictive Analytics、マルチチャネルメッセージング（メール、SMS、WhatsApp、RCS、プッシュ通知）、Forms、Reviews、Catalogs、Coupons、Reporting、Templates、Customer Hub、Klaviyo Data Platform（CDP）まで、Klaviyo プラットフォームに関する質問に対応します。Klaviyo は、eコマースに特化した AI ファーストの B2C CRM およびマーケティングオートメーションプラットフォームです。2012 年に Andrew Bialecki と Ed Hallen が創業し、2023 年に IPO を実施しました（NYSE: KVYO）。193K 以上のブランドに利用され、顧客プロフィールは 73 億件に上ります。

ステップ 1 — コンテキストの収集

references/learnings.md が存在する場合は、蓄積された情報を確認するため、最初に読みます。

ユーザーに以下を尋ねます。

1. Klaviyo のどの分野についてサポートが必要ですか？

   • A) Flows — ビジュアルオートメーションビルダー（ウェルカム、カート放棄、購入後、休眠顧客の呼び戻し、閲覧放棄、カスタム）
   • B) Campaigns — 単発／予約配信、A/B テスト、Smart Send Time
   • C) Segmentation — リアルタイムの行動ベースのセグメント、予測属性、カスタムプロパティ
   • D) Predictive Analytics — 予測 CLV、次回注文日、解約リスク、支出階層
   • E) マルチチャネル — メール、SMS/MMS、WhatsApp、RCS、モバイルプッシュ通知
   • F) Forms — リスト拡大のためのポップアップ、フライアウト、埋め込みフォーム、複数ステップフォーム
   • G) Reviews — 商品レビューの収集、AI による返信、表示ウィジェット
   • H) Klaviyo Data Platform（KDP）— 統合プロフィール、連携、イベント処理
   • I) 高度な KDP — リバース ETL、カスタムオブジェクト、高度な Webhook、データウェアハウスの同期
   • J) AI Agents — Marketing Agent（キャンペーン生成）、Customer Agent（サポート自動化）
   • K) Catalogs / Coupons — 商品カタログの同期、パーソナライズされたおすすめ、再入荷通知、クーポンコード
   • L) Reporting — 売上のアトリビューション、キャンペーン／フロー分析、ベンチマーク、カスタムダッシュボード
   • M) Templates — ドラッグ＆ドロップエディター、動的ブロック、モバイル対応デザイン
   • N) Customer Hub — セルフサービスのポータル（注文追跡、FAQ、サポート）
   • O) API / Integrations — REST API、Webhook、Shopify 連携、サードパーティコネクター
   • P) Account / Billing — プラン、料金、プロフィールベースの課金
   • Q) その他 — 内容を説明してください

2. あなたの役割は何ですか？

   • A) eコマースの運営者／ストアオーナー
   • B) メール／ライフサイクルマーケター
   • C) 開発者／エンジニア
   • D) 代理店／フリーランサー
   • E) グロース／マーケティングマネージャー
   • F) その他

3. 何を達成しようとしていますか？（具体的な目標や質問を説明してください）

ユーザーのリクエストにこれらの情報の大半がすでに含まれている場合は、該当するステップに進んでください。 妥当な前提を明示したうえで、可能な限り適切な回答を最初に提示し、最後に最も重要な確認質問を 1～2 個だけ尋ねます。すべての情報を集めるまで回答を保留しないでください。

注：ユーザーに専門的なスキルが必要な場合は、なぜそのスキルのほうが適しているかを簡潔に説明し、そちらに案内します。

ステップ 2 — 案内するか、直接回答する

リクエストが専門スキルに該当する場合は、以下のように案内します。

• 一般的なメールマーケティング戦略／ベストプラクティス -> /sales-email-marketing
• プラットフォーム横断のメール到達性（Klaviyo 固有ではないもの） -> /sales-deliverability
• メール開封／クリックのトラッキング戦略 -> /sales-email-tracking
• ミドルウェアを使った Klaviyo と他のツールの接続 -> /sales-integration
• チェックアウトの最適化（カート／チェックアウトの UX） -> /sales-checkout
• Customer.io 固有の質問 -> /sales-customerio
• Mailchimp 固有の質問 -> /sales-mailchimp

それ以外の場合は、以下の参考情報を使い、プラットフォームに関する知識に基づいて直接回答します。

ステップ 3 — Klaviyo プラットフォームの参考情報

詳細なモジュールのドキュメント、料金、連携、データモデルについては references/platform-guide.md を読んでください。

プラットフォームガイドの詳細は不要です。ユーザー固有の状況に集中してください。

ステップ 4 — 実行可能なガイダンス

ユーザーの具体的な質問に基づいて：

1. カート放棄フローの構築：

   1. Flows > Create Flow に移動し、「Abandoned Cart」テンプレートを選択します（または、最初から作成します）。
   2. トリガーを設定します。「Checkout Started」イベント（Shopify/BigCommerce から同期）または「Added to Cart」イベントを選択します。
   3. 時間遅延を追加します。最初のメールは通常1〜4時間後に設定します（遅延を短くすると、より多くのカートを回収できますが、まだ買い物中のお客様に不快感を与える可能性があります）。
   4. 条件分岐を追加します。フローのトリガー後に「Placed Order」イベントが発生したか確認します。発生している場合は、すでに購入に至っているためスキップします。
   5. 最初のメールステップを追加します。イベントの item プロパティを使用して、カートに残された商品を表示する動的な商品ブロックを含めます。
   6. 割引を提供する場合は、固有のクーポンコードを挿入します（Coupons > generate unique codes を選択し、コードの共有を防ぎます）。
   7. 2回目の時間遅延（24時間）を追加し、より緊急性を高めるか、割引を案内する2通目のメールを送信します。
   8. 必要に応じて、SMS 配信に同意した登録者を対象に、2通目のメールの後に SMS ステップを追加します。SMS は開封率が高く、時間制限のあるカート回収に適しています。
   9. フローの分析データを確認します。各ステップのコンバージョン率、フローに起因する売上、配信停止率を確認します。

2. 予測属性を使用したリアルタイムセグメントの設定：

   1. Lists & Segments > Create Segment に移動します。
   2. セグメントビルダーで条件を追加します。行動条件（過去90日間に注文）と予測属性（予測 CLV が高い、解約リスクが中または高）を組み合わせます。
   3. AND/OR ロジックを使用してターゲットオーディエンスを定義します。例：「Placed Order が2回以上 AND Predicted CLV が High AND Churn Risk が Medium」。
   4. セグメントをプレビューし、想定したプロフィールが含まれていることを確認します。
   5. セグメントはリアルタイムで更新されます。プロフィールが条件に一致したり、一致しなくなったりすると、自動的にセグメントに追加または除外されます。
   6. セグメントをキャンペーンのオーディエンス、フローのトリガー条件、またはフロー内の条件分岐に使用します。

3. Shopify-Klaviyo インテグレーションの設定：

   1. Klaviyo で Integrations > Add Integration > Shopify に移動します。
   2. Shopify ストアの URL を入力し、接続を承認します。
   3. Klaviyo は顧客（プロフィールとして）、注文（「Placed Order」イベントとして）、商品（カタログアイテムとして）、カート（「Added to Cart」/「Checkout Started」イベントとして）を同期します。
   4. サイト上のトラッキングを有効にします。Klaviyo の JavaScript スニペットが Shopify テーマに追加され、閲覧行動（「Viewed Product」、「Active on Site」）が追跡されます。
   5. データが連携されていることを確認します。Klaviyo の Metrics を確認し、Shopify のイベントが表示されていることを確かめます。
   6. Shopify のデータを活用する主要なフローを設定します。カート放棄（「Checkout Started」トリガー）、購入後（「Placed Order」トリガー）、閲覧後の離脱（「Viewed Product」トリガー）、再入荷（カタログ同期）。
   7. フローで固有のクーポンコードを使用する場合は、Shopify のクーポン同期を有効にします。

4. メールと併用する SMS の設定：

   1. Email + SMS プラン（月額35ドルから）を利用していることを確認します。
   2. SMS のコンプライアンス設定を完了します。ブランドを10DLC（米国）に登録し、フリーダイヤル番号またはショートコード番号を設定して、配信可能時間を設定します。
   3. SMS の同意取得を設定します。登録フォームに SMS オプトインのステップを追加します（複数ステップのフォームが最適です。まずメールアドレスを取得し、その後 SMS 配信への同意を取得します）。
   4. チャネル横断型のフローを構築します。既存のフローにメールステップの後の SMS ステップを追加します。例：24時間後もメールが開封されていない場合に SMS を送信します。
   5. チャネルごとの設定を尊重します。SMS ステップの前に条件分岐を使用し、SMS 配信への同意を確認します。
   6. SMS 固有の指標を確認します。配信率、クリック率、配信停止率、SMS あたりの売上を確認します。

5. Klaviyo API を使用したカスタムデータの同期：

   1. Klaviyo でプライベート API キーを生成します：Account > Settings > API Keys > Create Private API Key
   2. 適切なスコープを設定します。インテグレーションに必要なスコープのみを付与してください（profiles の読み取り／書き込み、events の書き込みなど）。
   3. すべてのリクエストで JSON:API 形式を使用します。データを {"data": {"type": "...", "attributes": {...}}} の構造でラップしてください。
   4. プロファイルをアップサートします：POST /api/profiles/ — Klaviyo はメールアドレスまたは電話番号で照合し、既存の場合は更新、新規の場合は作成します。
   5. イベントをトラッキングします：POST /api/events/ — メトリック名、プロファイル識別子、プロパティ、タイムスタンプを渡します。
   6. レート制限に対処します：HTTP 429 レスポンスを受け取ったときに、指数バックオフを実装してください。
   7. リストエンドポイントではカーソルベースのページネーションを使用します。レスポンスに含まれる links.next URL をたどってください。

注意点

調査に基づくベストエフォートの情報です。特に、プランによって利用が制限される機能やインテグレーション固有の注意点は古くなっている可能性があるため、確認してください。

1. プロファイルベースの課金では、メールを送信したプロファイルだけでなく、アクティブなプロファイルがすべてカウントされます（2025年2月の変更）。 メールを一度も送信しない大量のインポート済みリストも、プロファイル上限と課金ティアの対象になります。連絡する予定のないプロファイルは、定期的に抑制または削除してください。メールを送信したプロファイルのみがカウントされていた以前のモデルからの大きな変更です。
2. Advanced KDP（カスタムオブジェクト、リバース ETL、高度な Webhook）はエンタープライズ専用の料金設定です。標準プランで利用できるとは限りません。 カスタムオブジェクト、データウェアハウスとの同期、データ変換、システムレベルの Webhook などの機能には、個別のエンタープライズ料金が設定された Advanced KDP ティアが必要です。標準の Email プランと Email + SMS プランには、これらの機能は含まれません。
3. フロー Webhook とシステム Webhook は別物です。フロー Webhook はフローのアクションステップとして起動し、システム Webhook（Advanced KDP）はあらゆるイベントで起動します。 ほとんどのアカウントで利用できるのは、フローステップ内の POST アクションであるフロー Webhook のみです。メールイベント（event:klaviyo.opened_email、event:klaviyo.clicked_email、event:klaviyo.bounced_email）、レビューイベント、同意イベントで起動するシステム Webhook は、HMAC-SHA256 署名（署名は Klaviyo-Signature ヘッダー内。Klaviyo-Webhook-Signature ではありません。アカウントあたり最大 10 個の Webhook、シークレットキーは 16 文字以上）が付与される Advanced KDP の機能です。インテグレーションを計画する際に、この 2 つを混同しないでください。
4. SMS には個別のコンプライアンス設定（米国の TCPA／10DLC、キャリア登録）が必要です。Email + SMS プランを利用しているからといって、SMS をすぐに使用できるとは限りません。 SMS を送信する前に、ブランドを登録し、電話番号を確認して、配信制限時間を設定し、キャリアの要件を遵守する必要があります。この登録手続きは、キャリアの承認にかかる期間によって数日から数週間かかる場合があります。
5. 予測分析には十分なデータ（通常、500 件以上の注文と 180 日以上の履歴）が必要です。新しいストアではすぐに予測結果が表示されません。 予測 CLV、チャーンリスク、次回注文日、性別予測などの機能では、Klaviyo のモデルが結果を生成する前に、意味のある量の注文履歴データが必要です。ストアを開設したばかりの場合や、最近 Klaviyo に移行した場合は、十分なデータが蓄積されるまで待つ必要があります。

• 自己改善：ここに記載されていないことがわかった場合は、今日の日付を付けて references/learnings.md に追記してください。

ステップ 5 — 関連スキル

• /sales-email-marketing — 複数のツールを活用したオプトインメールマーケティング戦略
• /sales-deliverability — プラットフォームを横断したメール到達率の向上（SPF/DKIM/DMARC、ウォームアップ、受信トレイへの配信）
• /sales-email-tracking — メールエンゲージメントの追跡戦略
• /sales-integration — Klaviyo を CRM、データウェアハウス、その他のツールに接続
• /sales-checkout — チェックアウトの最適化（Klaviyo は e コマースのチェックアウトフローと連携します）
• /sales-customerio — Customer.io プラットフォームのサポート（行動に基づく自動化における Klaviyo の主な競合サービス）
• /sales-mailchimp — Mailchimp プラットフォームのサポート（メールマーケティングにおける Klaviyo の主な競合サービス）
• /sales-do — どのスキルを使えばよいかわかりませんか？ルーターがあらゆる営業目標に適したスキルを選びます。インストール：npx skills add sales-skills/sales --skill sales-do

例

例 1：SMS フォールバックを含むカート放棄フローの構築

ユーザーの発言：「Shopify ストアで、カート放棄からの回復フローを Klaviyo に設定したいです。SMS も含めるべきですか？」 スキルの動作：Shopify で「Checkout Started」イベントが同期されていることを確認し、そのイベントをトリガーとするフローを構築します。最初に条件分岐を設け、コンバージョンしたユーザー（「Placed Order」）を除外します。2 時間後に、動的な商品ブロックと CTA を含むメール 1 を送信し、24 時間後に、緊急性を訴える文面と固有の 10％割引クーポンを含むメール 2 を送信します。その後、SMS の同意状況で分岐し、同意済みのプロフィールにはさらに 12 時間後にリマインダー SMS を送信します。ステップごとのコンバージョンを監視し、AOV に応じて遅延時間を調整することを推奨します。 結果：まずメールで売上を回復し、メールを開封しなかったユーザーには SMS を送る、複数タッチポイント・マルチチャネルのカート放棄フローを構築します。悪用を防ぐため、クーポンコードは個別に発行します

例 2：SMS 同意の取得を含むウェルカムシリーズ

ユーザーの発言：「まずメールアドレスを取得し、その後 SMS のオプトインを尋ねて、一連のオンボーディングメールを送るウェルカムフローが必要です。」 スキルの動作：2 段階の登録フォームを設計します（1 段階目はメールアドレスと特典、2 段階目は電話番号と、価値が明確に伝わる SMS の同意）。「Subscribed to List」をトリガーとするウェルカムフローを設定します。メール 1（即時）で割引を案内し、配信頻度の目安を伝えます。24 時間後の SMS 同意状況による分岐で、オプトインしたユーザーにウェルカム SMS を送信します。その後もメールシリーズを継続し（3 日目にベストセラー、5 日目にソーシャルプルーフ、7 日目にパーソナライズされたおすすめ商品）、14 日目に、購入がなければ最後のリマインダーを送る分岐を設けます。 結果：メールと SMS の両方のリストを拡大し、一貫性のあるオンボーディング体験を提供して、初回購入のコンバージョンを促すウェルカムシリーズを構築します

例 3：解約防止のための予測セグメント

ユーザーの発言：「リピーターが離脱するケースが多くあります。Klaviyo で解約前にそうした顧客を特定し、再エンゲージできますか？」 スキルの動作：予測分析に十分なデータがあるか（注文数 500 件以上、期間 180 日以上）を確認します。条件を満たさない場合は、行動に基づく代替手段を推奨します。「Predicted CLV High AND Churn Risk Medium/High」というセグメントを作成し、セグメントへの登録をトリガーとするウィンバックフローを設定します。メール 1（0 日目）では過去の購入履歴に基づくおすすめ商品を添えた個別のチェックインを送り、メール 2（4 日目）では新着商品や再入荷商品を案内し、メール 3（8 日目）では限定特典を提供します。その後、SMS の分岐で期間限定オファーを送ります。自動化だけに頼らず、根本原因を探るためにセグメントの規模を確認することを推奨します。 結果：解約リスクのある高価値顧客を自動的に特定し、離脱する前にパーソナライズされた複数タッチポイントのシーケンスで再エンゲージする、先回り型の解約防止システムを構築します

トラブルシューティング

プロフィールに予測分析が表示されない

症状：予測属性（CLV、解約リスク、次回注文日）がプロフィールビューで空欄または利用不可と表示され、セグメントで使用できません 原因：Klaviyo の予測モデルでは、一定量以上の過去データが必要です。通常、注文数が 500 件以上で、注文履歴が 180 日以上必要です。新しいストア、最近移行したアカウント、注文数の少ないストアでは、予測の生成に十分なデータがありません。 解決策：Metrics > Placed Order で注文数を確認し、合計件数と期間をチェックしてください。しきい値に達していない場合は、データの収集を続けてください。最小要件を満たすと、予測が自動的に表示されます。それまでは、行動に基づくセグメントを代替として作成してください。「Placed Order が 2 回以上あり、過去 90 日間に Placed Order がない」は、解約リスクの近似として使えます。十分なデータがあるにもかかわらず予測が表示されない場合は、Klaviyo サポートにお問い合わせください。アカウント設定やデータ品質の問題により、予測の生成が遅れることがあります。

すでにコンバージョンした顧客にフローメールが送信される

症状：顧客がすでに購入を完了した後に、カート放棄または閲覧放棄メールを受信します 原因：フローに、顧客がトリガーイベント以降に目的のアクション（例：「Placed Order」）を完了したかどうかを確認する条件分岐またはフローフィルターがありません。この確認がないと、トリガーからメールの送信予定時刻までの間に顧客がコンバージョンしていても、フローの送信が続きます。 解決策：フローの各メールステップの直前に、条件分岐を追加してください。「このフローの開始後に、Placed Order を 1 回以上実行したことがある」という条件を設定します。条件が true の場合は、退出先（またはお礼の経路）に振り分けてください。さらに、トリガーレベルでフローフィルターを設定します。「このフローの開始後に Placed Order を実行していない」というフィルターは、各ステップの前に再評価されます。精度を最大限に高めるには、トリガーレベルのフローフィルターと各ステップの条件分岐の両方を使用してください。

SMS メッセージの配信に失敗する、またはキューに滞留する

症状：フロー／キャンペーンの分析画面で SMS メッセージが「queued」または「failed」と表示され、受信者にテキストメッセージが届きません 原因：最も多い原因は、SMS のコンプライアンス設定が完了していないことです。ブランドが 10DLC 登録（米国）を完了していない、電話番号が認証されていない、配信停止時間帯により送信がブロックされている、または受信者の電話番号が無効か固定電話である、といったケースがあります。適切な登録がない場合、宣伝とみなされるメッセージが携帯電話会社によってブロックされることもあります。 解決策：Klaviyo Settings > SMS で SMS の設定状況を確認してください。10DLC 登録（米国）が承認済みであること、送信番号が有効であること、配信停止時間帯が正しく設定されていることを確認します。個別の配信失敗については、プロフィールの電話番号の形式を確認してください（国番号が必要です。例：米国の場合は +1）。キャンペーン／フローの分析画面で SMS のエラーコードを確認し、具体的な失敗理由を特定してください。携帯電話会社によってメッセージがフィルタリングされている場合は、10DLC 登録が完了していること、およびメッセージの内容が携帯電話会社のガイドラインに準拠していることを確認してください（すべて大文字の使用や誤解を招く内容を避け、配信停止方法を記載します）。

Klaviyo のポップアップ／フォームが Chrome では起動せず、Safari では動作する

症状：Klaviyo の登録用ポップアップまたはフライアウトが Chrome（特にシークレットモード）で起動しなくなる一方、Safari では引き続き動作します。送信率が突然低下し、BFCM のようなトラフィックの多い期間の後に気づくことがよくあります。フォームは正しく設定されており、Klaviyo では「Live」と表示されています。 原因：ページ上で klaviyo.js スクリプトが重複して読み込まれています。複数の Shopify アプリやテーマのスニペットがそれぞれ独自の Klaviyo 統合スクリプトを挿入している場合によく発生します（ブラウザーの Network タブで klaviyo.js?company_id= のリクエストが複数ないか確認してください）。重複によって競合状態が発生し、フォーム SDK が二重に初期化されます。Chrome はスクリプトの実行順序がより厳密なため、重複スクリプトの処理が比較的寛容な Safari よりも、この問題が表面化しやすくなります。 解決方法：Chrome DevTools でサイトを開き、Network タブで「klaviyo」をフィルターして、klaviyo.js が複数回読み込まれていないか確認します。複数回読み込まれている場合：（1）Shopify のテーマコード（Layout と Snippets のファイル）で klaviyo.js または company_id のすべての参照を検索し、重複しているスニペットを削除します。Klaviyo の公式統合によって追加されたものだけを残してください。（2）インストール済みの Shopify アプリを確認します。一部のメール／マーケティングアプリは、Klaviyo のネイティブ統合とは別に独自の Klaviyo スクリプトを挿入します。疑わしいアプリを一度に 1 つずつ無効にしてテストしてください。（3）重複を削除したら、サイトのキャッシュ（および CDN／エッジキャッシュ）を消去し、シークレットウィンドウで klaviyo.js のリクエストが 1 回だけ発生することを確認してください。重複が見つからない場合は、Console タブで Klaviyo のフォーム SDK の初期化を妨げる JavaScript エラーがないか確認します。テーマの JavaScript の競合や Content Security Policy ヘッダーも、Chrome でポップアップが表示されない原因になることがあります。

Shopify 統合に「Action Required」と表示され、再接続にも失敗する

症状：Klaviyo の Shopify 統合に「Action Required」と表示されます。統合をクリックすると「Enabled」と表示されていますが、バナーは消えません。Shopify から Klaviyo アプリを削除して再インストールしたり、Klaviyo で統合を無効にしてから再度有効にしたりしても問題は解決しません。再接続を試みる際に、ストアに「Sorry this store is currently not available」と表示されることがあります。 原因：Klaviyo と Shopify 間の OAuth ハンドシェイクが壊れています。通常、Shopify の請求に関する問題（支払い失敗、トライアル期限切れ、プラン変更）、Shopify ストアの凍結、または Shopify 管理者権限の変更後に発生します。既存の OAuth トークンは無効になりますが、トークンが無効であっても設定レコード自体は存在するため、Klaviyo の統合ページには「Enabled」と表示されたままになります。 解決方法：（1）まず、Shopify ストアが有効な状態か確認します。Shopify 管理画面にログインし、請求の保留、ストアの凍結通知、期限切れのトライアルがないことを確認してください。まず Shopify 側の問題を解決します。（2）Klaviyo で、Integrations > Shopify に移動し、統合を完全に削除します（無効にするだけでなく、削除してください）。（3）Klaviyo と Shopify の両方からログアウトして Cookie を消去するか、シークレットブラウザーを使用します。（4）Klaviyo の Integrations タブ（Integrations > Add Integration > Shopify）から再接続を開始します。Shopify App Store から開始しないでください。Klaviyo から開始するフローであれば、OAuth の許可を正しく処理できます。（5）Shopify から権限の確認を求められたら、OAuth 認証フローを最後まで完了します。（6）再接続後、Metrics で最近の Shopify イベント（Placed Order、Checkout Started）を確認し、プロフィール数が更新されていることを確かめて、データが同期されているか確認します。