トラブルシューティング

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

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

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

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

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 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が必要です。	値をPOSの名前に設定します。
MV-0004	identifiersが必要です。	正しくフォーマットされたデータの例を参照してください。
MV-0009	pointOfSale空にすることはできません。	値をPOSの名前に設定します。

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

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

エラーを修正するには:

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

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

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

エラーを修正するには:

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

例を参照してください。

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