本ドキュメントでは、個人情報記録義務に基づいて保存されるファイルの保存場所・内容・閲覧方法について説明します。
Datahubをご利用のお客様は、本手順に従って保存データの確認およびエクスポートが可能です。

1. 保存ファイルの概要

保存されるファイルには、個人情報に該当する可能性のあるデータが含まれるため、厳重なアクセス管理を行っています。

• 保存場所
  Google Cloud Storage 上の以下のバケットに保存されます。

  qd-personal-info-record-${API_KEY}

• アクセス権限
  Datahub で提供しているお客様ごとの system account に対して、当該バケットへの read 権限 が付与されています。
  そのため、Datahubのジョブフローからこのファイルを参照できます。

• 保存形式
  各ジョブ実行ごとに、TXT 形式のファイルが複数生成されます。
  ファイルの文字コードは UTF-8 です。

• 保存期間
  保存されたファイルは 3年間 保持されます。

2. ディレクトリ構成とファイル命名規則

保存ファイルは以下のディレクトリ構成で格納されます。

${媒体}/${ジョブフローID}/${実行日}/
├── file_1.txt
├── file_2.txt
└── ...

• ${媒体}：データを送信する媒体（例：criteo_offline_conversion など。下記一覧を参照。）
• ${ジョブフローID}：Datahubで設定されたジョブフローのJobflow Id
• ${実行日}：ジョブが実行された日付（例：20251023）

ジョブ実行ごとに新しいファイルが生成されるため、更新頻度はジョブ実行頻度に依存します。
既存ファイルの上書き（洗い替え）は行われません。

3. 保存内容

保存されるファイルには、コネクタで抽出された全項目が含まれます。
データには以下のような形式の JSON オブジェクトが含まれます。

{
  "keys": [
    "conversion_time",
    "event_id",
    "identifiers_email",
    "number_items",
    "price_currency",
    "value",
    "contents_content_id",
    "contents_content_group_id",
    "contents_num_items"
  ],
  "values": {
    "conversion_time": "",
    "event_id": "",
    "identifiers_email": "test@test.com",
    "number_items": "",
    "price_currency": "",
    "value": "",
    "contents_content_id": "",
    "contents_content_group_id": "",
    "contents_num_items": "",
    "identifiers_twclid": ""
  }
}

保存されるデータは、お客様自身でハッシュ化したデータもしくはハッシュ化されていないデータのいずれかです。
（コネクタ設定により異なります）
※保存内容の構成は今後変更が入る可能性があります。

4. 保存データの閲覧方法

保存ファイルはDatahubのジョブフローを使ってDatahubのデータセットにインポートするジョブを作成することで、Datahub上で閲覧およびエクスポートが可能です。

4.1 ジョブフローの設定

以下の設定内容を参考に、ジョブフローを作成してください。

参考

ディレクトリ構成に使用される媒体名一覧