トラブルシューティング
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このトピックでは、Engage SDKを使った統合時に最も一般的なエラーと解決策について説明します。
コンソールまたは端末のエラー
Engage.personalize() を起動した際に400件の悪いリクエストが発生する
このエラーは、アプリのユーザーの実験や体験を、Sitecore Personalizeに存在しないメールアドレスや他の識別子を使って返そうとすると発生します。エラーを修正するには、パーソナライズデータオブジェクトでSitecore Personalizeに存在する識別子を指定します。
401無許可
このエラーはclientKey属性の値が正しくない場合に発生します。エラーを修正するには、正しい クライアントキーに値を設定してください。
404号機が見つからない
この誤りは以下の場合に発生します:
- ブラウザIDはウェブブラウザ上でクッキーとして保存されていません。例えば、 cookieDomain の値が誤っている場合、アプリのユーザーがクッキーを拒否した場合、またはウェブブラウザがクッキーをブロックしている場合などに発生します。イベントを送信し、通話のパーソナライズを行うには、正しい クッキードメイン を使用し、ブラウザIDがウェブブラウザ上でクッキーとして保存されていることを確認してください。
- targetURL属性の値は、Stream APIの利用可能なURLとは異なるURLです。エラーを修正するには、正しいStream APIターゲットエンドポイントに値を設定してください。
クッキーは無効ドメインのため拒否されました
このエラーはcookieDomainの値が誤っている場合に発生します。エラーを修正するには、正しい クッキードメインに値を設定してください。
クロスオリジンリクエストがブロックされました
このエラーは、targetURL属性の値がストリームAPIの利用可能なURLと異なる場合に発生します。エラーを修正するには、正しいStream APIターゲットエンドポイントに値を設定してください。
イン・イン・エラー
IEエラーはEngage SDKの初期化に関連しています。Engage SDKが正常に動作するためには、これらのエラーを解決する必要があります。
コード
概要
注記
IE-0001
windowオブジェクトはサーバー側では利用できません。windowオブジェクトはクライアント側でのみ、かつ正しい実行コンテキストでのみ使用してください。
このエラーはサーバー上でEngage関数を呼び出すときに発生します。
windowオブジェクトが存在する場合は必ずEngage関数を呼び出してください。
IE-0002
サーバーからクッキーを取得できません。
サーバーからのクッキー設定の コードサンプル をご覧ください。
IE-0003
タイムアウトが超過しました。サーバーは指定された時間内に応答しませんでした。
このエラーは、 timeout パラメータで関数を呼び出した後、関数がサーバーにネットワークリクエストを送るのにサーバーが間に合わず応答しない場合に発生します。
timeoutを使う場合は、エラー処理にtry-catchブロックを使いましょう。
IE-0004
ブラウザのIDがサーバーから取得できなかったため、クッキーを設定できません。後で再度試すか、このエラーを処理するために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 必須です。
価値を 販売ポイントの名前に設定してください。
MV-0004
identifiers 必須です。
MV-0008
friendlyId 必須です。
MV-0009
pointOfSale 空っぽであるはずがない。
価値を 販売ポイントの名前に設定してください。
Sitecore Personalizeに現れないイベント
この問題は、イベントをSitecore Personalizeに送った際にブラウザのコンソールにエラーがなくても、pointOfSale属性の値が正しくない場合に発生します。
エラーを修正するために:
- スクリプト内で pointOfSale 属性を見つけてください。通常は設定オブジェクトかイベントデータオブジェクト、あるいはその両方にあります。
- すべての pointOfSale 属性に対して、販売 時点の正しい名前を指定します。
命令に関連するイベントは失敗していますSitecore Personalize
この問題は、ADD、CONFIRM、またはCHECKOUTイベントが誤って設定されている場合に発生します。
エラーを修正するために: