トラブルシューティング
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このトピックでは、Engage SDKを使った統合時に最も一般的なエラーと解決策について説明します。
コンソールまたは端末のエラー
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 CDPサーバーがダウンしている場合に発生します。
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-0009
pointOfSale 空っぽであるはずがない。
価値を 販売ポイントの名前に設定してください。
Sitecore CDPに発生しないイベント
この問題は、イベントをSitecore CDPに送信してウェブブラウザのコンソールにエラーがなくても、pointOfSale属性の値が正しくない場合に発生します。
エラーを修正するために:
- スクリプトの中で pointOfSale 属性を見つけてください。通常、それらは設定オブジェクトかイベントデータオブジェクト、あるいはその両方にあります。
- すべての pointOfSale 属性に対して、販売 時点の正しい名前を指定します。
注文に関連するイベントがSitecore CDPで失敗しています
この問題は、ADD、CONFIRM、またはCHECKOUTイベントが誤って設定されている場合に発生します。
エラーを修正するために: