Magento 外部連携システム要件リファレンス

このページで学べること

Magento 1 または 2 と最適に同期するためのシステム要件をご確認ください。Magento ストアの管理者は、システム仕様と構成に責任を負います。Klaviyo で動作するようにシステムが設定されていることを確認すると、スムーズな外部連携体験が可能になります。

2.4.0未満のMagento 2バージョンはサポートされていません。

API権限を設定する

既存のMagento 1外部連携の場合、SOAP APIユーザーにはすべてのリソースへの完全なアクセス権限が必要です。Resource AccessがAllに設定されていることを確認してください。

Magento 2の場合は、Klaviyo拡張機能をインストールして設定し、その後OAuthを設定して、要求されたAPI権限を承認してください。Magento 2外部連携ガイドに従ってMagentoでセットアップを完了し、Klaviyoで外部連携を有効にしてください。

必要なAPI権限がない場合、KlaviyoはMagentoストアのAPIと適切にやり取りできず、外部連携がストアからデータを取得できなくなります。

必要な API エンドポイントへのアクセスを有効にする

Klaviyo は特定のエンドポイントからデータをリクエストします。システム設定でこれらのエンドポイントへのアクセスを許可する必要があります。セキュリティ制御や URL リダイレクト ロジックが、Klaviyo によるこれらのエンドポイントへのアクセス性に与える影響を考慮してください。Klaviyo が想定される API エンドポイントにアクセスできない場合、Magento データの一部または全部を同期できず、アプリケーションにエラーのレポート作成が表示されます。

Magento 2の場合、ストアには外部からアクセス可能なホスト名が必要です。OAuth認証のためにKlaviyoが/oauth/token/requestと/oauth/token/accessにアクセスできるようにし、さらに/index.php/rest配下のREST APIにもアクセスできるようにしてください。認証に失敗した場合は、Magento 2トラブルシューティングガイドに従ってください。

すべての外向きの Klaviyo 外部連携トラフィックは、予測可能な静的 IP アドレスのセットの背後にあるため、このトラフィックが Klaviyo からのものであると高い確信を持てます；そのため、これらのアドレスを許可リストに追加することを推奨します。

履歴データ同期 API リクエストのシステム容量

外部連携を有効化すると、Klaviyo は顧客レコード、注文レコード、商品カタログを含む履歴データを同期するための API リクエストを自動的にキューに入れます。マーケターが可能な限り早くアカウント内でこのデータを使用できるようにするため、迅速に対応するよう努めています。また、同時実行数を制限し、再試行を適切に処理することで、責任を持って対応するよう努めています。ストアに大量の履歴データがある場合、リソース容量が限られている場合、または大量の API リクエストを行う他のアプリケーションがある場合は、インフラストラクチャが履歴データ同期をサポートできる状態であることを確認するため、Magento 管理者に相談することをおすすめします。管理者は、リソースを一時的に増やすか、オートスケーリングを適用することを検討してください。

SSL 証明書の有効性を確認する

SSL証明書は、ウェブサイトのIDをデジタル的に認証し、ウェブブラウザとウェブサーバー間の暗号化された接続を可能にします。ウェブサイトのSSL証明書は、そのサイトのオリジンサーバーでホストされています。有効なSSL証明書は、支払いを安全に受け付け、パスワードログインを保護し、ウェブフォームを保護するうえで不可欠です。SSLサーバーテストを使用して、ウェブサイトのSSL証明書を検証できます。

ウェブサイトのSSL証明書の有効期限が切れると、Magentoの外部連携が無効になる場合があります。この場合、ドメイン証明書と中間証明書をホスティングプロバイダー側で更新する必要があります。証明書の場所が不明な場合は、ホスティングプロバイダーに連絡してサポートを受けてください。

十分なサーバーメモリの割り当て

商品、商品画像、保存されたメール、静的コンテンツページ用のディスク容量は、PHPメモリとは別です。十分なディスク容量があっても、PHPがKlaviyoのAPIリクエストを処理するのに十分なメモリを持っているとは限りません。

Klaviyo 外部連携には 1 ギガバイト超のメモリ割り当てを推奨しますが、必須の最小値は 512 メガバイトです。サーバーが Klaviyo のリクエストに応答するための十分なリソースを割り当てられない場合、外部連携エラーが発生します。Klaviyo と Magento の外部連携は履歴データの同期から開始されるため、外部連携を有効化する前に、Magento とサーバーのメモリ設定を確認することをおすすめします。

Magentoウェブサーバーで使用されているPHP memory_limit設定を確認してください。PHPのデフォルト値は128メガバイトですが、ホスティング構成によって上書きできます。Magento管理者はphp.iniでこの設定を更新できます。Magento 2の場合は、AdobeのPHP設定ガイダンスにも従ってください。

同期にはUTCタイムスタンプを使用してください。

Klaviyoは、最近のMagentoデータをリクエストし、APIから返されるタイムスタンプを解釈するために、協定世界時（UTC）を使用します。タイムスタンプが正しくないと、同期中にレコードが見逃されたり、Klaviyoで誤った時間に表示されたりする可能性があります。

Magento管理者に依頼して、ストアのAPIから返されるタイムスタンプがUTCであることを確認してください。最近のレコードが欠落している、または時刻が正しく表示されない場合は、ストアのタイムゾーン設定を変更する前に、これらのタイムスタンプとサーバー設定を確認してください。

その他のリソース