--- title: "トラブルシューティング" slug: "troubleshooting" abstract: "エンゲージSDK Sitecoreに関するよくあるエラーとその修正方法(Sitecore PersonalizeストリームAPI)。" --- # トラブルシューティング このトピックでは、Engage SDKを使った統合時に最も一般的なエラーと解決策について説明します。 ## コンソールまたは端末のエラー ### Engage.personalize() を起動した際に400件の悪いリクエストが発生する このエラーは、アプリのユーザーの実験や体験を、Sitecore Personalizeに存在しないメールアドレスや他の識別子を使って返そうとすると発生します。エラーを修正するには、[パーソナライズデータオブジェクト](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/personalization-data-object.html "Personalization data object")でSitecore Personalizeに存在する識別子を指定します。 ### 401無許可 このエラーはclientKey属性の値が正しくない場合に発生します。エラーを修正するには、正しい [クライアントキー](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950058068 "Client key")に値を設定してください。 ### 404号機が見つからない この誤りは以下の場合に発生します: - ブラウザIDはウェブブラウザ上でクッキーとして保存されていません。例えば、 cookieDomain の値が誤っている場合、アプリのユーザーがクッキーを拒否した場合、またはウェブブラウザがクッキーをブロックしている場合などに発生します。イベントを送信し、通話のパーソナライズを行うには、正しい [クッキードメイン](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950201916 "Cookie domain (optional)") を使用し、ブラウザIDがウェブブラウザ上でクッキーとして保存されていることを確認してください。 - targetURL属性の値は、Stream APIの利用可能なURLとは異なるURLです。エラーを修正するには、正しい[Stream APIターゲットエンドポイント](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950147122 "Stream API target endpoint")に値を設定してください。 ### クッキーは無効ドメインのため拒否されました このエラーはcookieDomainの値が誤っている場合に発生します。エラーを修正するには、正しい [クッキードメイン](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950201916 "Cookie domain (optional)")に値を設定してください。 ### クロスオリジンリクエストがブロックされました このエラーは、targetURL属性の値がストリームAPIの利用可能なURLと異なる場合に発生します。エラーを修正するには、正しい[Stream APIターゲットエンドポイント](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950147122 "Stream API target endpoint")に値を設定してください。 ### イン・イン・エラー IEエラーはEngage SDKの初期化に関連しています。Engage SDKが正常に動作するためには、これらのエラーを解決する必要があります。 コード 概要 注記 IE-0001 windowオブジェクトはサーバー側では利用できません。windowオブジェクトはクライアント側でのみ、かつ正しい実行コンテキストでのみ使用してください。 このエラーはサーバー上でEngage関数を呼び出すときに発生します。 windowオブジェクトが存在する場合は必ずEngage関数を呼び出してください。 IE-0002 サーバーからクッキーを取得できません。 サーバーからのクッキー設定の [コードサンプル](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/integrate-engage-sdk-nextjs-server-side.html) をご覧ください。 IE-0003 タイムアウトが超過しました。サーバーは指定された時間内に応答しませんでした。 このエラーは、 timeout パラメータで関数を呼び出した後、関数がサーバーにネットワークリクエストを送るのにサーバーが間に合わず応答しない場合に発生します。 timeoutを使う場合は、エラー処理にtry-catchブロックを使いましょう。 IE-0004 ブラウザのIDがサーバーから取得できなかったため、クッキーを設定できません。後で再度試すか、このエラーを処理するためにtry-catchブロックを使ってください。 このエラーは、ネットワークの問題がある場合や [、Engage.initServer.handleCookie(req, res)](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/engage-initserver-handlecookie.html) 関数が動作しているときにSitecore Personalizeサーバーがダウンしているときに発生することがあります。 initServer.handleCookie()関数を使うときは、エラーを処理するためにtry-catchブロックを使うべきです。 ### IVエラー IVエラーは、イベントデータ内の誤った値や誤ったフォーマットのオブジェクトに関連しています。 コード 概要 注記 IV-0001 targetURLの誤った値。値を設定して有効なURL文字列にしてください。 正しい [Stream APIターゲットエンドポイント](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950147122)に値を設定してください。 IV-0002 dobの誤った値。 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)に従って値をフォーマットしてください。 [正しくフォーマットされたデータの例を参照してください。](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/event-data-object.html) IV-0003 emailの値が誤りです。有効なメールアドレスに値を設定します。 IV-0004 expiryDateの誤った値。 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)に従って値をフォーマットしてください。 IV-0005 このイベントは最大で {{max}} 属性をサポートします。属性の数を減らします。 IV-0006 タイムアウトパラメータの値が誤りです。値を 0より大きい整数に設定してください。 N/A ### MVエラー MVエラーはイベントデータの欠損値に関連しています。 コード 概要 注記 MV-0001 clientKey 必須です。 値を [クライアントキー](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950058068)に設定してください。 MV-0002 targetURL 必須です。 正しい [Stream APIターゲットエンドポイント](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950147122)に値を設定してください。 MV-0003 pointOfSale 必須です。 価値を [販売ポイントの名前](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538)に設定してください。 MV-0004 identifiers 必須です。 [正しくフォーマットされたデータの例を参照してください。](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/event-data-object.html) MV-0008 friendlyId 必須です。 [正しくフォーマットされたデータの例を参照してください。](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/personalization-data-object.html) MV-0009 pointOfSale 空っぽであるはずがない。 価値を [販売ポイントの名前](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538)に設定してください。 ## Sitecore Personalizeに現れないイベント この問題は、イベントをSitecore Personalizeに送った際にブラウザのコンソールにエラーがなくても、pointOfSale属性の値が正しくない場合に発生します。 エラーを修正するために: 1. スクリプト内で pointOfSale 属性を見つけてください。通常は設定オブジェクトかイベントデータオブジェクト、あるいはその両方にあります。 2. すべての pointOfSale 属性に対して、販売 [時点](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538 "Name of point of sale")の正しい名前を指定します。 ## 命令に関連するイベントは失敗していますSitecore Personalize この問題は、ADD、CONFIRM、またはCHECKOUTイベントが誤って設定されている場合に発生します。 エラーを修正するために: - [ADD](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/add-event.html "ADD event")、[CONFIRM、](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/confirm-event.html "CONFIRM event")[CHECKOUT](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/checkout-event.html "CHECKOUT event")のイベントデータオブジェクトが正しくフォーマットされていることを確認してください。 - イベントを [正しい順序で](https://doc.sitecore.com/personalize/ja/developers/api/integrating-with-sitecore-personalize/understanding-integration-details/sending-orders-using-the-engage-sdk.html "Sending orders using the Engage SDK")送信するようにしてください。 - CONFIRMイベントデータオブジェクトの[product](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/confirm-event.html "CONFIRM event")配列に含まれる各アイテムID、製品アイテムIDが[product.item\_id](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/add-event.html "ADD event")で指定されているADDイベントデータオブジェクトが先に存在しなければなりません。 [例を挙げてください](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/sitecore-engage-sdk-reference/add-event.html#UUID-7b1ee50b-d9c6-3bc4-d87e-9603187d3190_example-idm4559219305961633573933574595 "Example 25. Product item IDs in ADD and in CONFIRM events")。