統合レポート

統合レポートについて

毎日、カスタマージャーニーオプティマイザは、接続されているシステムをレビューしてデータが正しくフェッチされていることを確認し、その結果をレポートにまとめます。このレポートには、各受信ソースに対してインポートされたデータの概要が表示されます。これには、エラーがあったかどうか、またはその日にデータがインポートされなかったかどうかが含まれます。

統合レポートの購読

統合レポートを受け取るには、Qualtrics導入担当者に連絡し、送信するレポートを設定するよう依頼する必要があります。担当者に連絡する際は、レポートを受け取る頻度とレポートの受信者について希望します。

• 頻度: デフォルトでは、レポートは PST の午前 0 時に 1 日に 1 回送信されます。異なる時刻に、または 1 日に複数回送信するレポートの頻度をカスタマイズできます。
• オーディエンス: レポートを受信するユーザの電子メールアドレスを指定します。現時点では、レポートでは 1 つの電子メールアドレスへの送信のみがサポートされています。
  ヒント：組織の複数の人にメールを送信する場合は、ITチームと協力して、レポートを受信する配信リストを設定することをお勧めします。リストに登録しているユーザーはレポートを取得します。
  ヒント：このレポートは、クアルトリクスの導入担当者にも送信されます。

レポートに含まれるデータ

各レポートには、その日にカスタマージャーニーオプティマイザにインポートされたデータの概要を示す 2 つのテーブルが含まれています。レポートの上部には、注意が必要な可能性がある潜在的な問題に関する警告が含まれます。

警告

警告はレポートの上部に黄色で表示されます。警告に細心の注意を払い、報告された問題に対処する必要があります。

一般的な警告の 1 つは、特定の統合に対して “過去 24 時間以内にインポートされたデータの新規行が 0 行” です。この統合に対して新しいデータが予想されるが、新しいレコードがインポートされなかった場合は、接続の設定方法に問題がある可能性が高いです。接続が正しく設定されており、データ概要に正しいエンティティがあることを再確認します。

テーブル 1

レポートの最初のテーブルには、接続された各ソースの概要が表示されます。テーブルのカラムには、次のものがあります。

• 統合: 接続の名前 (“Webhook” や “SFTP” など)。
• エンティティ名: 接続からインポートされるエンティティの名前。一部の接続には、複数のエンティティがある場合があります。
• 有効なレコード: インポートされた有効なレコードの数。
• 失敗したレコード: インポートに失敗したレコードの数。

テーブル 2

レポートの 2 番目のテーブルには、接続された各ソースの個別のフェッチジョブに関する詳細が表示されます。テーブルのカラムには、次のものがあります。

• 統合: 接続の名前 (“Webhook” や “SFTP” など)。
• エンティティ名: 接続からインポートされるエンティティの名前。一部の接続には、複数のエンティティがある場合があります。
• 実行 ID: この特定のデータ取得実行の内部 Qualtrics ID。
• 日付: データフェッチが開始された日付と時刻。
• ステータス: 実行のステータス。次の値が含まれます。
  • Completed_NR: ジョブは問題なく完了しました。
  • Failed_NR: ジョブを完了できませんでした。失敗の詳細については、エラーメッセージ列を参照してください。
• 失敗メッセージ: レコードのインポートに失敗した場合、失敗の理由。詳細については、「エラーメッセージの解決」を参照してください。

エラーメッセージの解決

このセクションでは、一般的なエラーメッセージとその解決方法について説明します。

エンティティの設定済み一次キー ‘<field name> ‘ がレコードにありません

このエラーメッセージは、クアルトリクスにインポートしようとしたレコードに1次キーがないことを意味します。レコードのインポート時には、そのエンティティのデータスキーマで定義されている 1 次キーが必要です。

日付書式が無効なため、'<date value> ‘ の ‘<field name> ‘ を処理できませんでした

このエラーは、日付フィールドをクアルトリクスにインポートしようとしましたが、無効な日付形式のため失敗したことを意味します。フィールドを再確認し、日付が ISO-8601 形式であることを確認します。

‘<Data Type> ‘ はサポートされていないデータ型であるため、有効なデータ型に置き換える必要があります。

このエラーは、カスタマージャーニーオプティマイザでサポートされていないデータ型 (配列など) をインポートしようとすると表示されます。エンティティのデータスキーマで定義されているサポートされるデータ型になるように、フィールドを更新します。

スキーママッピング (Webhook) の読み取りに失敗しました

このエラーは、Webhook からレコードをインポートしようとすると表示されます。この問題を解決するには、Webhook ペイロードの “schemaFields” セクションを参照し、スキーマフィールド名が名前および大文字と小文字のクライアントフィールドと一致していることを確認します。また、フィールドに無効な文字が含まれていないことを確認します。