.CSV のインポートとエクスポート

トラッキングプランを としてインポートおよびエクスポートします。CSV を使用して、Amplitude データでスキーマを一括変更できます。。CSVラウンドトリップはイベント、イベントプロパティ、ユーザープロパティをカバーしており、エンティティを1つずつ編集する代わりに、新しいイベントの計画、カテゴリと説明の編集、1回のアップロードでの変更の適用をサポートしています。

を使用します。CSVインポートは、一度に多くのイベントやプロパティにわたってスキーマを一括編集する必要がある場合に使用します。プログラムによるスキーマ変更、自動化されたスキーマ変更、またはスクリプト形式の変更については、代わりにタクソノミー API を使用してください。

イベントとイベントプロパティ

イベントとイベントプロパティをインポートまたはエクスポートするには、次の手順に従います。

1. [データ] に移動し、左側のペインにあるトラッキングプランの下にある [イベント] を選択します。

2. インポートするには、インポートアイコンを選択してインポートモーダルを開きます。

3. インポートファイルがアップロードできる状態で、イベントとイベントプロパティの期待されるスキーマに従っている場合は、 をドロップできます。CSVファイルを使用するか、[アップロード] を選択して、ローカルからファイルを選択します。そうでない場合は、テンプレートを選択してテンプレートをダウンロードしてください。インポート用に更新する CSV です。

   インポートされたイベントとイベントプロパティは、import という名前のブランチに表示されます。

4. インポートされた追跡計画の更新が正しいことを確認したら、変更内容をメインブランチにマージし直すことができます。

5. トラッキングプランからイベントとイベントプロパティをエクスポートするには、代わりにエクスポートアイコンを選択してください。

6. 表示されるエクスポートモーダルで、トラッキングプランのスキーマをダウンロードするか、 をダウンロードするかを選択します。CSVファイルテンプレート。次に、[ダウンロード] を選択します。

ダウンロード済み 。トラッキングプランのCSVファイルには、インポートに必要のない追加フィールドが含まれています。次のセクションでは、イベントとイベントプロパティを定義します。CSV インポートファイル構造と、エクスポートされたファイルに表示される追加の列。

イベントとイベントプロパティファイルスキーマ

イベントとイベントプロパティ 。CSV ファイルは、インポートを正常に実行するために特定のスキーマを必要とします。 以下の表は、エンティティタイプごとに必要なスキーマを示しています。 注意事項：

• ファイルのヘッダーには、リストされているすべてのフィールドが含まれている必要があります。
• フィールドの順序は任意ですが、インポートを成功させるには、名前と値のスペルと大文字が正確に一致している必要があります。
• 次のリストに示すように、一部のフィールドにはエンティティの種類に応じて値が必要なものがあります。

アクション

• 定義: 特定のエンティティに対して実行するアクション。
• 値:
  • Ignore：エンティティまたはそのサブプロパティに変更は加えられていません。
  • Remove： イベントとプロパティグループをトラッキングプランから削除できます。 削除値は個々のプロパティに影響を与えません。 イベントまたはプロパティグループを削除すると、関連するプロパティの関連付けが解除され、ライブプロパティのステータスが予期しない状態に変わります。 remove 値はエンティティを削除したり、取り込みを停止したりすることはありません。
  • <blank>: エンティティとそれに関連付けられたサブエンティティを作成または更新します。
• イベント、イベントプロパティ、プロパティグループ、およびプロパティグループプロパティの場合。

配列の最小項目数

• 定義: 配列プロパティ値型を持つプロパティの最小項目数
• イベントプロパティとプロパティグループプロパティの場合

配列の最大項目数

• 定義: 配列プロパティ値型を持つプロパティの最大項目数
• イベントプロパティとプロパティグループプロパティの場合

配列の固有項目

• 定義: 配列プロパティ値タイプに固有の項目があるかどうかを示します
• 値:
  • TRUE: 配列にはユニークな項目があります
  • <any>：配列にはユニークな項目がないと仮定します
• イベントプロパティとプロパティグループプロパティの場合

定数値

• 定義: const プロパティ値型を持つプロパティの Const 値
• イベントプロパティとプロパティグループプロパティの場合

列挙値

• 定義: 列挙型プロパティ値を持つプロパティの列挙型値
• フォーマット: 各列挙値をコンマで区切ります
• イベントプロパティとプロパティグループプロパティの場合

イベントアクティビティ

• 定義：イベントのアクティビティの説明。
• 値:
  • Active。
  • Inactive。 イベントを非アクティブとしてマークすることは、遡及的に即座に適用され、そのイベントはメAny Active Eventトリックから除外されます。
• イベント用。

イベントがドロップダウンから非表示になっている

• 定義: ドロップダウンでイベントの表示を設定する
• 値:
  • True: イベントはイベントドロップダウンで非表示になっています
  • False: イベントはイベントドロップダウンに表示されます
  • <blank>: 現在の値を保持します
• イベントの場合

ペルソナ結果から隠されたイベント

• 定義: ペルソナ結果でのイベントの可視性を設定する
• 値:
  • True: イベントはペルソナの結果から隠されています
  • False: イベントはペルソナ結果に表示されます
  • <blank>: 現在の値を保持します
• イベントの場合

パスファインダーから隠されているイベント

• 定義: パスファインダーでイベントの可視性を設定する
• 値:
  • True: イベントはパスファインダーから隠されています
  • False：イベントはパスファインダーに表示されます
  • <blank>: 現在の値を保持します
• イベントの場合

タイムラインから隠されたイベント

• 定義： タイムラインでイベントの表示を設定する
• 値:
  • True：イベントはタイムラインで非表示になっています
  • False：イベントはタイムラインに表示されます
  • <blank>: 現在の値を保持します
• イベントの場合

イベントカテゴリ

• 定義: イベントのカテゴリ
• イベントの場合

イベント表示名

• 定義: イベントのオプションの表示名にのみ適用可能
• イベントの場合

イベントプロパティ名

• 定義: プロパティの名前
• イベントプロパティとプロパティグループプロパティに必須

イベントソース

• 定義: イベントに関連付けられたソース
• イベントの場合

数値プロパティ値の最小値

• 定義: 数値プロパティ値型を持つプロパティの最小値
• イベントプロパティとプロパティグループプロパティの場合

数値プロパティ値の最大値

• 定義: 数値プロパティ値タイプを持つプロパティの最大値
• イベントプロパティとプロパティグループプロパティの場合

数値は整数です

• 定義： 数値プロパティ値タイプを持つプロパティが整数であるかどうかを示します
• 値:
  • True：プロパティは整数です
  • False または <blank>：プロパティは整数ではありません
• イベントプロパティとプロパティグループプロパティの場合

オブジェクトタイプ

• 定義： エンティティタイプ
• 値:
  • Event
  • Property Group
• イベントとプロパティ グループに必須

オブジェクト名

• 定義: イベントまたはプロパティグループの名前
• イベントとプロパティ グループに必須

オブジェクト所有者

• 定義： イベントまたはプロパティグループの所有者
• これをそのままにしておくと、イベントまたはプロパティ グループに所有者が存在する場合に所有者が<blank>削除されます

オブジェクトの説明

• 定義：エンティティの説明
• イベントおよびプロパティグループの場合

プロパティタイプ

• 定義: イベントに関連付けられたプロパティのタイプ
• 値:
  • Event Property
  • Event Property Group
• イベントに必要

プロパティ グループ名

• 定義: イベントに関連付けられているプロパティグループ
• イベントの場合

プロパティの説明

• 定義：プロパティの説明
• イベントプロパティとプロパティグループプロパティの場合

プロパティ値のタイプ

• 定義：イベントプロパティまたはプロパティグループプロパティの値の型
• 値:
  • string
  • number
  • boolean
  • any
  • enum
  • const
• イベントプロパティとプロパティグループプロパティの場合

プロパティが必要です

• 定義：プロパティの必要なステータスを示します
• 値:
  • True：プロパティが必要です
  • False または <blank>: プロパティはオプションです
• イベントプロパティとプロパティグループプロパティの場合

プロパティの可視性

• 定義: グラフでのプロパティの表示を設定する
• 値:
  • VISIBLE: プロパティはグラフに表示されます
  • HIDDEN: プロパティはグラフに隠されています
  • <blank>: 現在の値を保持します
• イベントプロパティのみ

プロパティは配列です

• 定義: プロパティが配列であるかどうかを示します
• 値:
  • True：プロパティは配列です
  • False または <blank>：プロパティは配列ではありません
• イベントプロパティとプロパティグループプロパティの場合

プロパティ正規表現

• 定義: 文字列プロパティ値型を持つプロパティの正規表現 (Regex) 値
• イベントプロパティとプロパティグループプロパティの場合

文字列プロパティ値の最小長さ

• 定義: 文字列プロパティ値型を持つプロパティの最小長
• イベントプロパティとプロパティグループプロパティの場合

文字列プロパティ値の最大長

• 定義: 文字列プロパティ値型を持つプロパティの最大長
• イベントプロパティとプロパティグループプロパティの場合

タグ

• 定義: イベントに関連付けられたタグ
• フォーマット: 各タグをコンマで区切ります
• イベントの場合

追加フィールド .イベントとイベントプロパティのCSVエクスポート

次のリストには、 にある追加フィールドが含まれています。トラッキングプランのイベントとイベントプロパティを CSV 形式でエクスポートできます。

アクション

• 定義: 特定のエンティティに対して実行するデフォルトのアクションです。 このフィールドはインポートテンプレート内に存在しますが、ダウンロードされたファイルにはデフォルト値が含まれています。
• 値:
  • Ignore：ユーザープロパティが予期せぬ状態であるか、ブロックされているか、削除されています。
  • <blank>: ユーザープロパティは計画中または稼働中です。
• イベント、イベントプロパティ、プロパティグループプロパティの場合

最初に確認されたイベント

• 定義：イベントが最初に検知された日付。
• フォーマット：mm/dd/yyyy
• イベントの場合

最後に確認されたイベント

• 定義: イベントが最後に発生した日付。
• フォーマット：mm/dd/yyyy
• イベントの場合

最初に確認されたプロパティ

• 定義：プロパティが最初に検知された日付。
• フォーマット：mm/dd/yyyy
• プロパティグループの場合

最後に確認されたプロパティ

• 定義：プロパティが最後に検知された日付。
• フォーマット：mm/dd/yyyy
• プロパティグループの場合

ユーザープロパティ

ユーザープロパティをインポートまたはエクスポートするには、次の手順に従います。

1. [データ] に移動し、左側のペインの [トラッキングプラン] の下にある [プロパティ] を選択します。 次に、[ユーザープロパティ] を選択します。
2. インポートアイコンを選択して、インポートモーダルを開きます。
3. インポートファイルがアップロードできる状態で、想定されるユーザープロパティスキーマに従っている場合は、ファイルをドラッグ＆ドロップできます。CSVファイルを使用するか、[アップロード] を選択して、ローカルからファイルを選択します。そうでない場合は、テンプレートを選択してテンプレートをダウンロードしてください。インポート用に更新する CSV です。

インポートされたイベントとイベントプロパティは、import という名前のブランチに表示されます。

4. インポートされた追跡計画の更新が正しいことを確認したら、変更内容をメインブランチにマージし直すことができます。
5. トラッキングプランからユーザープロパティをエクスポートするには、代わりにエクスポートアイコンを選択してください。
6. 表示されるエクスポートモーダルで、トラッキングプランのスキーマをダウンロードするか、 をダウンロードするかを選択します。CSVファイルテンプレート。次に、[ダウンロード] を選択します。

次のセクションでは、ユーザープロパティを定義します。CSV インポートファイル構造と、ユーザープロパティエクスポートに表示される追加の列。

ユーザープロパティファイルスキーマ

以下のリストは、ユーザープロパティに必要なスキーマを示しています。CSV ファイルのインポート。 注意事項：

• ファイルのヘッダーには、リストされているすべてのフィールドが含まれている必要があります。
• フィールドの順序は任意ですが、インポートを成功させるには、名前と値のスペルと大文字が正確に一致している必要があります。
• 一部のフィールドには、次のリストに示すように値が必要です。

アクション

• 定義: 特定のユーザープロパティに対して実行するアクション。
• 値:
  • Ignore: Amplitudeはユーザープロパティに変更を加えません。
  • Remove: Amplitudeはユーザープロパティをトラッキングプランから削除します。 削除された値はユーザープロパティを削除したり、その取り込みを停止したりすることはありません。
  • <blank>: ユーザープロパティが存在しない場合は作成します。ユーザープロパティが存在する場合には更新します。

配列の最小項目数

• 定義: 配列プロパティ値型を持つプロパティの最小項目数

配列の最大項目数

• 定義: 配列プロパティ値型を持つプロパティの最大項目数

配列の固有項目

• 定義: 配列プロパティ値タイプに固有の項目があるかどうかを示します
• 値:
  • TRUE: 配列にはユニークな項目があります
  • <any>：配列にはユニークな項目がないと仮定します

定数値

• 定義: const プロパティ値型を持つプロパティの Const 値

列挙値

• 定義: 列挙型プロパティ値を持つプロパティの列挙型値
• フォーマット: 各列挙値をコンマで区切ります

数値プロパティ値の最小値

• 定義: 数値プロパティ値型を持つプロパティの最小値

数値プロパティ値の最大値

• 定義: 数値プロパティ値タイプを持つプロパティの最大値

数値は整数です

• 定義： 数値プロパティ値タイプを持つプロパティが整数であるかどうかを示します
• 値:
  • True：プロパティは整数です
  • False または <blank>：プロパティは整数ではありません

プロパティタイプ

• 定義: ユーザー プロパティ タイプ
• 値: ユーザー プロパティ (必須)

プロパティ名

• 定義: ユーザープロパティの名前
• この値は必須です

プロパティの説明

• 定義：ユーザープロパティの説明

プロパティの可視性

• 定義: グラフでのプロパティの表示を設定する
• 値:
  • VISIBLE: プロパティはグラフに表示されます
  • HIDDEN: プロパティはグラフに隠されています
  • <blank>: 現在の値を保持します

プロパティ値のタイプ

• 定義：ユーザープロパティの値の型
• 値:
  • string
  • number
  • boolean
  • any
  • enum
  • const

プロパティは配列です

• 定義: プロパティが配列であるかどうかを示します
• 値:
  • True：プロパティは配列です
  • False または <blank>：プロパティは配列ではありません

プロパティ正規表現

• 定義: 文字列プロパティ値型を持つプロパティの正規表現 (Regex) 値

文字列プロパティ値の最小長さ

• 定義: 文字列プロパティ値型を持つプロパティの最小長

文字列プロパティ値の最大長

• 定義: 文字列プロパティ値型を持つプロパティの最大長

の追加フィールド。ユーザープロパティのCSVエクスポート

次のリストには、 にある追加フィールドが含まれています。トラッキングプランのユーザープロパティをCSV形式でエクスポートできます。

アクション

• 定義: 特定のエンティティに対して実行するデフォルトのアクションです。 このフィールドはインポートテンプレート内に存在しますが、ダウンロードされたファイルには自動的にデフォルト値が含まれます。
• 値:
  • Ignore: ユーザープロパティが予期しないか、ブロックされているか、削除されています。
  • <blank>: ユーザープロパティは計画中または稼働中です。

最初に確認されたプロパティ

• 定義：プロパティが最初に検知された日付。
• フォーマット:mm/dd/yyyy

最後に確認されたプロパティ

• 定義：プロパティが最後に検知された日付。
• フォーマット:mm/dd/yyyy

よくある質問

生のチャートまたはイベントデータのエクスポートオプション

これらの質問の答えはすべて同じです：

• チャートやイベントの生データをエクスポートするにはどうすればよいですか？
• チャートの結果ではなく、このチャートに含まれるイベントの生イベントデータをエクスポートできますか？
• をエクスポートするにはどうすればよいですか？特定のイベントの発生状況すべてを含む CSV を取得するにはどうすればよいですか?
• このチャートに引き込まれたデータはどのように表示できますか？
• 過去30日間に発生したこのイベントのすべてのインスタンスのイベントとユーザープロパティ値を表示できますか?

チャート用に選択した生データや、選択したイベント用にすべてのデータをエクスポートする方法はありません。 Amplitudeはアプリケーション内で大規模で複雑な分析を実行するように構築されているため、SQLのような方法でイベントデータを分離およびエクスポートすることはサポートされていません。 いくつかの代替手段：

• エクスポートAPI：イベントとそのイベントプロパティのすべての値をエクスポートするには、AmplitudeのエクスポートAPIを使用してください。 指定された時間範囲内のすべてのイベントをエクスポートし、JSON形式で返します。そこから、必要な特定のイベントを抽出することができます。データがエクスポート API のサイズ制限を超える場合は、代わりに Amazon S3 エクスポートを使用してください。
• Amazon S3 エクスポート: AmplitudeをAmazon S3と統合して、イベントデータをS3バケットにエクスポートできます。 この連携は、無料プランを含むすべてのアカウントで利用できます。Amazon S3 エクスポートを参照してください。

Amplitudeはどのようにしての構造を決定しますか？イベントセグメンテーションチャートからエクスポートする際のCSVファイルについてですか？

Amplitudeは、 を作成する際のガイドとして内訳データテーブルを使用します。CSVです。 Amplitudeは、 内の表の形式と構造を反映しています。CSVです。

なぜ ではないのですか。ユーザーまたはイベントプロパティの可能なすべての値を示す CSV ファイルが、なぜ表示されないのですか?

に表示される値の数には制限があります。CSVです。 制限はチャートごとに異なります。 「制限と割り当て」を参照してください。

ユーザープロパティの値がチャートと の間で異なるのはなぜですか？CSVエクスポートですか？

Microscope を使用してチャートからユーザーをダウンロードする場合、 。CSV には、ユーザーの最新のプロパティ値が含まれています。 このチャートは、イベント発生時のプロパティ値を返します。

の場合も同様です。CSV には、チャートのようにプロパティ値がリストされています： "none"。CSV は最新の値を示し、チャートはイベント発生時の値を示します。

エクスポートされた の先頭にスペース（タブ）があるのはなぜですか？CSVファイルとしてエクkスポートできます。

デフォルトでは、エクスポートされたファイルのセルに先頭のスペースが表示される場合があります。CSVです。 デフォルト値を変更するには：

1. 個人設定に移動します。
2. プロフィールへ移動します。
3. サイト設定で、「エクスポートから先頭のスペースを常に削除」を有効にします。

詳細については、「設定の管理」を参照してください。