生データエクスポート機能は、ページビューまたはセッションレベルでContentsquareから生データをエクスポートし、他のツールで活用することを可能にします。エクスポートを作成、スケジュール、管理、実行することができます。ジョブをContentsquare コンソールを使用して行います。
この機能を使用すると、以下のデータをエクスポートできます:
完全なフィールド参照ドキュメントはこちらをご覧ください。
-
project_id, user_id
-
セッション（時間、期間、再生リンク、トランザクションなど）
-
ページ（URL、クエリ、時間、影響）
-
技術（OS、デバイス、ブラウザ、画面）
-
地理（言語、都市、国）
-
パフォーマンス（ロード時間、DOM時間）
-
イベント（クリック、タップ、スクロール、ホバー、カスタムなど）
- エラー（JSエラー、APIエラー、カスタムエラー）
生データエクスポートを使用して:
-
生データテーブル（ページビュー、セッション、ユーザー、セグメントなど）のエクスポートをスケジュールする
-
Contentsquareコンソールから直接エクスポートにアクセスする
-
データストアにデータを供給し、Contentsquareのリテンション期間を超えてデータを蓄積する。
ユースケースの例:
| 分析 | Contentsquareの生データを他のソースのデータとクロスリファレンスして、すべてのプラットフォーム（Adobe、Google）でエンドユーザーのタッチポイントを統一します。 |
| マーケティング | セグメントデータをマーケティングシステム（Salesforce、Adobe Oracle、Sap Hybris、Marketo、インサイダーなど）で活用して、ハイパーパーソナライズされた楽しい体験、エンゲージメント、コンバージョン、ロイヤルティを促進します。 |
| UX/UI | セグメントデータを活用してエンドユーザーの体験（フラストレーション/解約）を改善します。 |
| ビジネスインサイト | BIツール（Tableau、Power BI、Qlikview、Lookerなど）でデータを活用して、さらなる分析と視覚化を行います。 |
| データ分析 | CSデータをデータウェアハウスにプッシュして、分析を実行し、機械学習アルゴリズムに供給します。 |
| データ保持 | 契約されたCSデータ保持期間を超えてCSデータを維持します。 |
生データエクスポート機能にアクセスする
1. 設定アイコン > コンソール > データエクスポートタブに移動します。
2. データエクスポートタブには2つのセクションがあります：
- データエクスポート（デフォルト）：新しいエクスポートをスケジュールし、すでにスケジュールしたエクスポートを表示、編集、アクティベート、非アクティブ化、または削除します。
- 最近のエクスポート：データエクスポートの履歴を表示します。
データエクスポートジョブを作成する
1. Click on “+ データエクスポートを追加” をクリックし、一回限りのジョブまたは定期的なジョブを作成するかを選択します（プロセスの後半でデイリーまたは毎時のジョブを選択するオプションがあります）。
-
一度きりのジョブ: フォームを検証するとすぐに実行されます。
- 指定された日付範囲（最大7日間、契約上のデータ保持期間に制限）でデータを抽出できます。
- 完了した日しかクエリできません（つまり、現在の日をクエリすることはできません）。
- 定期的なエクスポートをスケジュール: デイリー（毎日1日の生データを抽出）または毎時（毎時1時間の生データを抽出）です。
2. エクスポートに名前を付け、スケジュールオプション、エンティティタイプ（ページビューまたはセッションレベル）、ファイル形式を選択します。
| ヘッダー付きCSV | 最初の行にフィールド名があるCSV |
| ヘッダーなしCSV | フィールド名がないCSV |
| JSON | 各行は独自のJSONオブジェクトで構成されています |
3. エクスポートするフィールドとセグメントを選択します。
- 抽出可能なフィールドは、選択したエンティティタイプ（ページビューまたはセッション）によって異なります。
4. データを抽出するデバイスを選択し、'作成'をクリックして確定します。作成されたデータエクスポートは「データエクスポート」リストに表示されます。
- “すべての訪問者”はデフォルトのセグメントが選択されており、すべてのセッションを抽出します。
- 複数のセグメントを選択した場合、選択したセグメントのいずれかに属するすべてのセッションがエクスポートされます。選択したセグメントのいずれにも属さないすべてのセッションはフィルタリングされ、エクスポートされません。
- データには、選択した各セグメントごとに1つのカラムがあり、セッションがセグメントに属する場合は1、属さない場合は0が値として表示されます。
- 4時間のギャップがあることに気付くかもしれませんが、これは4時間ごとに実行される定期的なジョブによるものです。このデフォルト設定はデータ収集を最適化し、レポートがすべての関連情報をキャプチャすることを保証します。
エクスポートの管理
「データエクスポート」には、構成されスケジュールされたエクスポートのリストが表示されます。エクスポートを表示、編集、削除、重複、スケジュールエクスポートを一時停止/アクティベートできます。
- 任意の行の「...」ボタンをクリックして、ドロップダウンメニューでこれらのオプションにアクセスします。
エクスポートされたファイルをダウンロード
エクスポートをダウンロードする方法は2つあります:
エクスポートされたファイルを手動でダウンロードするには、エクスポートのダウンロードボタンをクリックします。
プログラムでファイルをダウンロードするには、Raw Data APIを使用します。
- プログラムでファイルを取得することは、たとえば、毎日再発するジョブによって生成されたすべての新しいファイルを取得し（任意のクライアントアプリケーション、データウェアハウス、BIツールなどに供給するため）便利です。
よくある質問
誰がエクスポートを管理できますか？
Contentsquareの管理者役割のみが、コンソールからエクスポートジョブを作成および管理できます。
Contentsquareはエクスポートをどのくらいの期間保存しますか？
エクスポートおよび関連ファイルは、作成後7日間アクセス可能です。これにより、好みのツールに保存する時間が与えられます。
同時にいくつのジョブを実行できますか？
最大10の再発ジョブ（ジョブごとに1つのセグメント）が同時にアクティブであることができます。新しいジョブを作成する前に、デイリージョブを一時停止または削除する必要がある場合があります。最大1つの一時ジョブが同時に計算中であることができます。ただし、最大9つの一時ジョブをキューに入れることができます。キューに入れられたジョブは、現在の計算ジョブが完了するのを待って、順番にトリガーされます。
合計でいくつのジョブを持つことができますか？
インターフェースにリストされるジョブは100を超えることはできません（すべてのステータスを含む）。制限に達した場合は、新しいジョブを作成する前にいくつかのジョブを削除する必要があります。
どのくらいのデータをエクスポートできますか？
一時ジョブの場合、最大7日間のデータをエクスポートできます。
データの日はどのように定義されますか？
日付はUTCの真夜中から真夜中までの間に実行されます。エクスポートはタイムゾーンに依存しません（プラットフォーム上でユーザー固有です）。すべての日付と時刻はUTCであり、任意のアプリケーションで希望のタイムゾーンにコンバージョンできます。
エクスポートジョブはいつトリガーされますか？
エクスポートジョブは、完全なデータ収集を確保するために、エクスポートされる期間の終了から4時間後に開始されます。
例えば：
• デイリーエクスポートは、UTCの午前4時にトリガーされます。
• 時間単位のエクスポートの場合、午前6時から午前7時までデータをエクスポートする場合、ジョブは午前11時に開始されます。
一度きりのエクスポートの場合、最後の完全な日からのみデータをエクスポートできます。現在の日はエクスポートできません。
データはどれくらい新鮮ですか？
一度きりのエクスポートとデイリーエクスポートの場合、最後の完全な日のデータまでエクスポートできます。時間単位のジョブの場合、任意の時点で、最後の終了した時間から4時間を引いたデータまで利用可能です。
エクスポートが期待通りにダウンロードされない場合はどうなりますか？
生データエクスポートで発生する可能性のあるエラーは、UIに明確に表示されません。期待されるファイルが最近のエクスポートインターフェースにない場合、エラーが発生したことを意味し、再試行する必要があります。
モバイルイベントについてはどうなりますか？
モバイルイベントは、ファイルに保存するには複雑すぎて重すぎるため、まだエクスポートできません。
分析で正確な要素をターゲットにするにはどうすればよいですか？
ターゲットパスは、DOM構造に基づいてCS Targetsとして翻訳され、保存されます。正確な要素をターゲットにする必要がある場合は、ユニークなパスを特定するか、HTMLのid属性に依存する必要があります。
エクスポートに利用可能なセッションリプレイリンクにアクセスできないのはなぜですか？
リンクは、契約のセッションリプレイリテンション期間の範囲外である可能性があり、そのためアクセスできなくなっています。
このデータセットの主キーを見つけるにはどうすればよいですか？
セッションエクスポートの場合、キーはsession_idです。
閲覧数エクスポートの場合、キーはfields session_id + view_number
エクスポートジョブが時間単位で構成されている場合、なぜ時間のギャップがあるのですか？
定期ジョブは4時間ごとに実行されるように構成されており、効率的なデータ収集と処理のために最適化されたデフォルト設定です。この4時間の間隔は、キャプチャされたデータが包括的で最新であることを保証し、システムのパフォーマンスを維持します。作成日とレポートの日付範囲の間の4時間のギャップは、このデフォルト構成によるものです。各レポートは、初期の日付範囲から4時間後までに処理されたデータを反映しており、すべての関連情報が含まれることを保証します。