記事テンプレート

統合レポートについて

カスタマージャーニー最適化は毎日、接続されているシステムを評価し、データが正しく取得されていることを確認し、その結果をレポートにまとめます。このレポートでは、各インバウンドソースに対してどのようなデータがインポートされたのか、失敗があったのか、その日にデータがインポートされなかったのかなどの概要が表示されます。

統合レポートを購読する

統合レポートを受け取るには、クアルトリクス担当者に連絡し、レポートの送信設定を依頼する必要があります。担当者に連絡する際には、レポートを受け取る頻度や、レポートを受け取るべき人について、あなたの希望を伝えてください。

• 頻度：デフォルトでは、レポートは1日1回、太平洋標準時の午前0時に送信されます。レポートの送信頻度をカスタマイズして、異なる時間帯に送信したり、1日に複数回送信したりすることができます。
• 対象者：レポートを受け取るべき人のEメールアドレスを入力してください。現時点では、レポートは1つのメールアドレスへの送信にのみ対応しています。
  Qtip:組織内の複数の人にメールを送信したい場合は、ITチームと協力してレポートを受信する配信リストを設定することをお勧めします。リストを購読している人は誰でもレポートを受け取ることができる。
  QTip:レポートはクアルトリクス担当者にも送信されます。

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

各レポートには、その日にカスタマージャーニー最適化にインポートされたデータの概要を示す2つのテーブルが含まれています。レポートの上部には、注意を要する潜在的な問題に関する警告が記載されています。

警告

レポートの上部に黄色で警告が表示されます。警告に細心の注意を払い、その中でレポートされている問題が対処されていることを確認する必要がある。

よく出る警告は、ある統合について「過去24時間に0行の新しいデータがインポートされました」というものだ。この統合に新しいデータが期待されているにもかかわらず、新しいレコードがインポートされない場合は、接続の構成方法に問題がある可能性が高いです。接続が正しく設定され、データ概要に正しいエンティティがあることを再度確認してください。

表1

レポートの最初の表は、各接続ソースの概要を示しています。表の列は以下の通り：

• 統合：接続の名前 (「webhook」や「Sftp」など)。
• エンティティ名：接続からインポートされるエンティティの名前。コネクションの中には、複数のエンティティを持つものもある。
• 検証レコード：インポートされた検証レコードの数。
• 失敗したレコード数：インポートに失敗したレコード数。

表2

レポートの 2 番目の表には、各接続ソースの個々のフェッチ・ジョブに関する詳細が表示されます。表の列は以下の通り：

• 統合：接続の名前 (「webhook」や「Sftp」など)。
• エンティティ名：接続からインポートされるエンティティの名前。コネクションの中には、複数のエンティティを持つものもある。
• ランID：この特定のデータ取得ランのクアルトリクス内部ID。
• 日付：データ取得を開始した日時。
• ステータス：ランのステータス。値には以下が含まれる：
  • Completed_NR：ジョブは問題なく完了した。
  • Failed_NR: ジョブの完了に失敗しました。失敗の詳細については、失敗メッセージ欄を参照のこと。
• 失敗メッセージ：レコードのインポートに失敗した場合、失敗の理由。詳しくは「失敗メッセージの解決」を参照。

失敗メッセージの解決

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

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

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

<field name>’ の ‘<date value>’ が無効な日付形式であるため、処理できませんでした。

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

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

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

スキーママッピングの読み込みに失敗しました。

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