トラブルシューティング

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

このトピックでは、Engage SDKを使用して統合する際の最も一般的なエラーと解決策について説明します。

コンソールまたはターミナルのエラー

400 Bad Request when running Engage.personalize() (Engage.personalize() の実行時に無効なリクエストが出ます)

このエラーは、Sitecore Personalizeに存在しないメールアドレスやその他の識別子を使用して、アプリのユーザーに対してテストやエクスペリエンスを返そうとしている場合に発生します。このエラーを修正するには、パーソナライゼーションデータオブジェクトで、Sitecore Personalizeに存在する識別子を指定します。

401権限なし

このエラーは、clientKey属性の値が正しくない場合に発生します。エラーを修正するには、値を正しいクライアントキーに設定します。

404見つかりませんでした

このエラーは、次の場合に発生します。

ブラウザIDは、WebブラウザにCookieとして保存されませんでした。これは、cookieDomainの値が正しくない場合、アプリのユーザーがCookieを拒否した場合、WebブラウザーがCookieをブロックしているなどです。イベントを送信してパーソナライゼーションを呼び出すには、正しいCookieドメインを使用し、ブラウザー IDがWebブラウザーにCookieとして保存されていることを確認してください。
targetURL属性の値が、Stream APIの使用可能なURLのURLと一致していません。エラーを修正するには、値を正しいStream APIターゲットエンドポイントに設定します。

無効なドメインのためにCookieが拒否されました

このエラーは、cookieDomainの値が正しくない場合に発生します。エラーを修正するには、値を正しいCookieドメインに設定します。

クロスオリジンリクエストがブロックされました

このエラーは、targetURL属性の値がStream APIで使用可能なURLと異なる場合に発生します。エラーを修正するには、値を正しいStream APIターゲットエンドポイントに設定します。

IEエラー

IEエラーは、Engage SDKの初期化に関連しています。 Engage SDKが正しく機能するためには、これらのエラーを解決する必要があります。

コード	形容	メモ
IE-0001	windowオブジェクトはサーバー側では使用できません。windowオブジェクトは、クライアント側で、正しい実行コンテキストでのみ使用します。	このエラーは、サーバー上のEngage関数を呼び出すときに発生する可能性があります。 windowオブジェクトが存在する場所でEngage関数を呼び出すようにしてください。
IE-0002	サーバーからCookieを取得できません。	サーバーからCookieを設定するためのコードサンプルを参照してください。
IE-0003	タイムアウトを超えました。サーバーは割り当てられた時間内に応答しませんでした。	このエラーは、timeoutパラメーターを使用して関数を呼び出し、その関数がサーバーにネットワーク要求を行ったが、サーバーが時間内に応答しない場合に発生します。 timeoutを使用する場合は、try-catchブロックを使用してエラーを処理します。
IE-0004	ブラウザIDをサーバーから取得できなかったため、Cookieを設定できません。後で再試行するか、try-catchブロックを使用してこのエラーを処理します。	このエラーは、ネットワークに問題がある場合、またはEngage.initServer.handleCookie(req, res) 関数が実行されているときにSitecore Personalizeサーバーがダウンしている場合に発生する可能性があります。 initServer.handleCookie() 関数を使用する場合は、try-catchブロックを使用してエラーを処理する必要があります。

IVエラー

IVエラーは、イベントデータ内の誤った値と誤ってフォーマットされたオブジェクトに関連しています。

コード	形容	手記
IV-0001	targetURLの値が正しくありません。値を有効なURL文字列に設定します。	値を正しいStream APIターゲットエンドポイントに設定します。
IV-0002	dobの値が正しくありません。 ISO 8601に従って値を書式設定します。	正しくフォーマットされたデータの例を参照してください。
IV-0003	emailの値が正しくありません。値を有効なメールアドレスに設定します。
IV-0004	expiryDateの値が正しくありません。 ISO 8601に従って値を書式設定します。
IV-0005	このイベントは、最大 {{max}} 属性をサポートします。属性の数を減らします。
IV-0006	タイムアウト・パラメータの値が正しくありません。値を0以上の整数に設定します。	N/A

MVエラー

MVエラーは、イベントデータの欠損値に関連しています。

コード	形容	手記
MV-0001	clientKeyが必要です。	値をクライアントキーに設定します。
MV-0002	targetURLが必要です。	値を正しいStream APIターゲットエンドポイントに設定します。
MV-0003	pointOfSaleが必要です。	値をPOSの名前に設定します。
MV-0004	identifiersが必要です。	正しくフォーマットされたデータの例を参照してください。
MV-0008	friendlyIdが必要です。	正しくフォーマットされたデータの例を参照してください。
MV-0009	pointOfSale空にすることはできません。	値をPOSの名前に設定します。

に表示されないイベント Sitecore Personalize

この問題は、Sitecore Personalizeにイベントを送信し、Webブラウザーコンソールにエラーが含まれていないが、pointOfSale属性の値が正しくない場合に発生します。

エラーを修正するには:

スクリプトで、pointOfSale属性を見つけます。通常、それらは設定オブジェクトまたはイベントデータオブジェクトのいずれか、あるいはその両方にあります。
すべてのpointOfSale属性に対して、販売時点管理の正しい名前を指定します。

注文に関連するイベントが失敗しています Sitecore Personalize

この問題は、ADD、CONFIRM、またはCHECKOUTイベントが正しく設定されていない場合に発生します。

エラーを修正するには:

ADD、CONFIRM、およびCHECKOUTイベントのイベント・データ・オブジェクトが正しくフォーマットされていることを確認してください。
イベントが正しい順序で送信されていることを確認してください。
CONFIRMイベント・データ・オブジェクトのproduct配列内のオブジェクトに含まれる各アイテムID、製品アイテムIDがproduct.item_idで指定されている先行するADDイベント・データ・オブジェクトが存在する必要があります。

例を参照してください。

この記事を改善するための提案がある場合は、お知らせください!