Magento 2.x（CE および EE）スタートガイド

このページで学べること

Klaviyo を Magento 2 CE または EE のストアと連携する方法をご覧ください。Magento に Klaviyo 拡張機能をインストールし、拡張機能を設定して OAuth をセットアップしてから、Klaviyo で外部連携を有効にする必要があります。このガイドでは、必要な外部連携手順のすべてに加え、履歴データの同期が成功したことを確認する方法について説明します。

始める前に

Klaviyo が外部連携に必要な API 呼び出しを行えるようにするには、Magento 2 サーバーに一般公開されているホスト名が必要です。ローカルでホストされている Magento 2 サーバーは、Klaviyo と完全に外部連携できません。

認証や設定関連の問題を最小限に抑えるため、ファイアウォールプロバイダーの許可リストに Klaviyo IP を追加することを強くお勧めします。詳しくは、Klaviyo 連携トラフィックの IP アドレスを許可リストに登録する方法をご覧ください。

Klaviyo の Magento 2 拡張機能は Composer を使用してインストールする必要があります。Composer を使用したインストールには、Magento 2 がホストされているサーバーへの SSH アクセス権を持つ IT 管理者が必要ですのでご注意ください。

Magento 2 に Klaviyo 拡張機能をインストールする

This content requires Functional cookies to be enabled.

Update Cookie Settings

1. Magento 2 サーバーにログインし、コマンドライン ツールから Magento アプリのルート ディレクトリに移動します。このガイドでは Terminal の出力例を示していますが、これらの手順は任意のコマンドライン ツールに合わせて変更できます。
2. 以下のコマンドを実行して、Packagist から Klaviyo 拡張機能の最新バージョンにアクセスします。Packagist は PHP コードライブラリのリポジトリであり、拡張機能の最新バージョンを簡単にインストールできます。
   composer require klaviyo/magento2-extension
3. 次のコマンドを実行して、ダウンロードしたばかりの Klaviyo 拡張機能を有効にしてください：
   php bin/magento module:enable Klaviyo_Reclaim  --clear-static-content

4. サンプル出力に表示されているとおり、追加のモジュールを有効にする必要があります。次のコマンドを実行して有効にしてください：
   php bin/magento setup:upgrade
5. 出力で Module 'Klaviyo_Reclaim' をスキャンして、Klaviyo モジュールが有効になっていて実行中であることを確認します。
6. Magento 2 ストア上の CSS と JS が引き続き正しく動作するようにするには、静的コンテンツのデプロイ コマンドを実行する必要があります。
   php bin/magento setup:static-content:deploy -f

7. これで、ブラウザから Magento の管理ダッシュボードに戻ることができます。

Composer 経由でのインストールが完了しました！設定手順については、次のセクションに進んでください。

Klaviyo 拡張機能を設定

ハウツー動画

This content requires Functional cookies to be enabled.

Update Cookie Settings

1. Klaviyo アカウントで、[API キー] タブに移動します。
2. 新しいタブで、Magento ストアの管理画面に移動します。
3. Settings で、Stores > Configuration をクリックします。
4. Klaviyo のドロップダウンから、[一般] をクリックします。
5. Klaviyo 拡張機能を有効にするをはいに設定します。
6. API キー タブから 6 桁の Klaviyo 公開 API キーをコピーし、Magento の該当するボックスに貼り付けます。
7. Klaviyo の API キー タブで新しいプライベートキーを生成し、Magento の該当するボックスに貼り付けてください。プライベート API キーで認証すると、Magento から Klaviyo にニュースレターの購読を同期できるようになります。

次のセクションでは OAuth を設定します。これにより、外部連携の他の要素も有効になります。

OAuth の設定

次に、OAuth 認証を有効にして、Klaviyo アカウントを Magento 2 拡張機能に安全に接続します。

1. Magento の [OAuth を設定] タブに移動します。
2. 外部連携には覚えやすい名前を付けてください。後でこの名前で見つける必要があります。
3. [Save Config] をクリックして続行します。
   

4. 左側のナビゲーションペインで[システム] を見つけ、 System トレイから[外部連携] を選択します。
5. 外部連携名を見つけて、[有効化] をクリックしてください。外部連携を有効化すると、アクセスの承認を求めるウィンドウが開きます。
   

6. [許可] をクリックして Klaviyo にリダイレクトし、そこで外部連携の設定を完了します。
   

7. 求められた場合は Klaviyo にサインインするか、アカウント名が正しいことを確認して、[外部連携] をクリックします。これにより、設定に使用した API キーに紐づく Klaviyo アカウントに Magento 2 の外部連携が追加されます。複数の Klaviyo アカウントにログインしていて正しいアカウントが表示されない場合は、他のセッションからログアウトしてください。
   

ウィンドウが自動的に閉じた場合、接続は成功しています。新しいブラウザのタブまたはウィンドウで Klaviyo アカウントを開き、[外部連携] タブを選択して、リスト内に Magento 2 があることを確認することでも成功を確認できます。

代わりに次のエラーが表示される場合は、最初のステップで使用した API キーが、現在ログインしているアカウントに対応していることを確認してください。

Magento と Klaviyo の接続を確立する際に、代わりにエラーのリストが表示された場合は、各エラーをクリックして原因の詳細を確認できます。

ニュースレターリストを設定する

次に、ニュースレターの購読者を同期するための Klaviyo リストを選択します。選択したリストには、Klaviyo のオプトイン設定または Magento 2 のオプトイン設定を使用するオプションもあります。

1. Magento で、[ニュースレター] をクリックします。
2. ドロップダウンから、Magento のサインアップフォームと同期する Klaviyo リストを選択します。
3. [設定を保存] をクリックします。

チェックアウト時に同意を有効にする

次に、チェックアウト時にメールと SMS の同意を有効にすることを選択できます。

チェックアウトで同意を有効にする場合は、チェックアウトでの同意が正しく機能するように、Webhook（以下）も有効にする必要があります。

1. 設定 ページで、Klaviyo の チェックアウト時の同意 に移動します。
   

2. メール同意とモバイル（SMS/WhatsApp）同意を収集するためのセクションが表示されます。これら 2 つは別々に扱われるため、メールのみ、SMS/WhatsApp のみ、またはその両方の同意を収集できます。SMS/WhatsApp とメールの両方の購読者を収集する場合は、メール用とは別のリストを SMS/WhatsApp 用に選択してください。これにより、同意は常に正しいチャネルに適切に関連付けられます。
   • 同意は、お客様が注文の確定を完了し、該当する場合はダブルオプトインにより購読を確認するまで（メールと SMS/WhatsApp の両方で）同期されません。
   • Magento 2 ストアにすでにログインしているユーザーの場合、デフォルトではチェックアウト時にメール同意チェックボックスは表示されない点にご注意ください。
3. メール の下で、 チェックアウト時に連絡先をメールマーケティングに購読させる に対して[はい] を選択します。
4. ニュースレターなど、購読者を同期するメールリストを選択します。
5. 使用するメールのオプトイン チェックボックス テキストを入力してください。
   

6. モバイル で、 テキストメッセージと WhatsApp の購読者を収集 の はい を選択します。
7. 同期先として使用する SMS/WhatsApp 連絡先のリストを選択してください。これらの設定の詳細については、チェックアウトで SMS および/または WhatsApp の同意を収集するためのガイドをご覧ください。
   

8. 並べ替え順序により、メールと SMS の同意チェックボックスの配置を変更できます。デフォルトでは、これらのチェックボックスはそれぞれ最初のメール入力欄と配送先の電話番号フィールドの下に表示されます。そのため、チェックアウトページを並べ替えていない場合は、並べ替え順序を変更する必要はありません。レイアウトを変更している場合は、それに応じて並べ替え順序を調整してください。
9. 完了したら、右上の [Save Config] をクリックします。

[Webhook] を有効にする

1. 管理者ダッシュボードから、[店舗] > [設定]に移動します。
2. Klaviyo をクリックし、Webhook タブを選択します。
3. Webhook シークレットを作成し、対応する [Webhook シークレット] フィールドに入力します。Webhook シークレットは、Klaviyo が検証に使用するキーです。このシークレットは任意の内容にできますが、安全な英数字の文字列を作成することをおすすめします。Magento はセキュリティ上の目的で Webhook シークレットをアスタリスクで非表示にするため、正しく入力されていることをよく確認してください。
   
   マルチストアの外部連携を使用している場合、このフィールドの Webhook シークレットはデフォルト設定に入力する必要があり、同じシークレットが各ストア設定の検証に使用されます。Webhook シークレットはデフォルト設定にのみ追加し、ストアごとに追加しないでください。

4. 有効にする Webhook の横で、ドロップダウンから [はい] を選択してください。Klaviyo がサポートする Webhook の詳細については、Magento 2 向け Webhook ガイドをご覧ください。
5. [設定を保存] をクリックします。

Klaviyo で Magento 2 外部連携を有効にする

ハウツー動画

This content requires Functional cookies to be enabled.

Update Cookie Settings

1. Klaviyo を開き、左側のナビゲーションから [外部連携] を選択します。リストで Magento 2 を見つけて選択します。
2. 次のページで、新しい Magento 2 の顧客を Klaviyo リストに追加するオプションが表示されます。チェックボックスをクリックして 新しい Magento 2 の顧客を Klaviyo リストに追加 を選択し、ドロップダウンからリストを選択します。この設定をオンにすると、顧客は選択したリストに追加されるだけで、マーケティング メッセージを購読することにはなりませんのでご注意ください。
   
   この設定で同期されるのは新しい顧客のみです。既存の顧客は、Magento リストから Klaviyo へ手動で移行する必要があります。

3. 次に、Magento 2 のどのストアビューを Klaviyo と同期するかを選択します。デフォルトでは、すべてのストアビューが Klaviyo と同期されます。この設定により、統合するストアを選択できます。Magento 2 で Multi-Source Inventory（MSI）を使用している場合は、特定の Magento 2 ストアビュー をオンにし、同期するストアを選択して、Klaviyo で在庫が正しく反映されるようにします。
4. 詳細 で、必要に応じて次の設定を有効にしてください：
   • 特別価格の設定
     この設定は、特定の日付範囲で任意に適用できる商品の特別販売価格を指します。この機能を使用する予定がある場合は有効にすることを強く推奨します。後から有効にする方が難しくなるためです。Use special price for product prices when applicable を有効にすると、商品ブロックは該当する場合に特別価格を表示します。動的な商品フィードを使用している場合、特別価格は送信時間に反映されます。カタログから商品を手動で選択する場合、特別価格は商品を選択すると反映されます。各商品について、同期されるメタデータフィールドは 4 つあります：
     • 価格
       （必須、float）商品の標準価格。
     • special_price
       （任意、float）これは商品の特別セール価格です。この価格が適用されている場合、取り消し線が付いた価格の横にこの special_price が表示されます。
     • special_from_date
       （任意、日付）special_price が有効になる開始日を指定します。
     • special_to_date
       （任意、date）special_price の適用が有効となる終了日を指定します。
   • カスタム メディア ルート URL
     この設定では、サイト画像のデフォルトのパスを変更できます。ウェブサイトとは異なる URL で商品画像をホストしている場合は、この設定を有効にします。
   • 定期的な注文同期を最近の注文に制限
     定期的な注文同期では、前回の定期同期以降に更新された注文を特定し、次回の同期に含めます。この設定により、注文が作成された日時に基づいて、どの注文を定期的な注文同期の対象にするかを制限できます。有効にすると、相対的な日付範囲を選択でき、その期間内に作成された更新済みの注文のみが次回の定期的な注文同期に含まれます。これにより、意味のない更新が発生した場合に、定期的な同期中に古い注文が再取得されるのを防ぐことができます。
5. [保存] をクリックします。

Magento 2 外部連携が正常に有効になりました！データは数分以内に Klaviyo へ同期され始めます。

最初の履歴データ同期が完了すると、Magento 2 外部連携は 30 分ごとに同期します。

Magento 2 外部連携と同期されたデータ

Klaviyo の Magento 2 外部連携は、Magento プラットフォームから主要な顧客情報を取得します。

以下は、Magento から同期するデータの一部です：

• 名、姓、所在地などの顧客情報。
• 購入された商品、商品画像、商品カテゴリ、適用された割引などを含む売上データおよび注文データ。
• フルフィルメント、返金、キャンセル済みの注文データ。
• ユーザーがウェブサイトにアクセスしたタイミングと閲覧したアイテム。ウェブトラッキングは拡張機能によって処理されます。

詳細については、Magento 2 データ リファレンスをご覧ください。

Magento の注文金額を単一通貨に換算する

Klaviyo は、Magento のすべての外貨を Klaviyo の 1 つの主要通貨にコンバージョンすることをサポートしています。この機能を有効にするには、サポートにお問い合わせください。これは、異なる通貨で取引を行う複数のストアがある場合に特に便利です。

この機能が有効になっている場合：

• Magento が注文データを Klaviyo に同期すると、コンバージョンが発生します。
• Klaviyo は order_currency_code が設定済みの global_currency_code と同じかどうかを確認します。同じでない場合、財務分析の正確性を確保するために、注文合計を注文通貨から指定されたグローバル通貨に換算します。なお、注文のラインアイテムは注文通貨コードのままで、換算されません。

拡張機能をアップグレード

Klaviyo Magento 2 拡張機能のアップグレードをお考えですか？上の [インストール] セクションに記載されている手順に従い、コマンドを実行して最新バージョンをインストールします。これにより現在のバージョンが上書きされ、アップデートが完了します。拡張機能を再設定したり、Klaviyo で外部連携を再度有効にしたりする必要はありません。

カタログを再同期する

Magento 2 カタログの完全な履歴再同期は、いつでも求めることができます。カタログを再同期すると、在庫やバリエーション関連の機能に関する Klaviyo の更新を活用しやすくなります。

カタログを再同期するには：

1. Klaviyo で、[外部連携] タブを選択します。
2. リストから Magento 2 の外部連携を選択します。
3. [データ] タブをクリックします。
4. カタログデータを同期の下で、[再同期]をクリックします。
   
   

その他のリソース