この記事では、アナリティクスにアップロードするファイルの作成と形式の設定に関するヒントをいくつか紹介します。アップロード ファイルの形式を正しく設定しないと、エラーが起こる可能性があります。
この記事の内容:一般的な考慮事項
- データファイルは CSV(カンマ区切り)形式でアップロードする必要があります。
- CSV ファイルのヘッダーは、ターゲット データセットのスキーマと一致している必要があります。列の順序は、スキーマで指定された順序と一致している必要があり、すべての列名は、ディスプレイ名ではなく内部
ga.
ディメンションまたは指標名を使用する必要があります(「Source
」ではなく「ga:source
」など)。 - アップロードするデータは適切な形式にする必要があります。詳しくは下記をご覧ください。
アップロード ファイルを作成する
アップロード ファイルはさまざまな方法で作成することができますが、テキスト エディタを使用するか、スプレッドシート アプリケーションを使用する方法が簡単です。どのような方法で作成するにせよ、アップロード ファイルのヘッダーを作成するには、データセット スキーマが必要です。
スキーマを取得する
データセットを編集して [スキーマの取得] ボタンをクリックすると、データセットのスキーマをコピーまたはダウンロードできます。
データセット スキーマの取得方法:- Google アナリティクスにログインします。
- [管理] をクリックして、データをアップロードするプロパティに移動します。
- [プロパティ] 列で、データを保存するデータセットが含まれているプロパティを選択します。
- [データのインポート] をクリックします。
- インポート先のデータセットの名前をクリックします。
- [スキーマの取得] ボタン(ページ下部近く)をクリックすると、以下のダイアログが表示されます。
テキスト エディタを使用する
テキスト エディタを使用してアップロード ファイルを作成するには、新しいファイルの最初の行にスキーマをコピーして貼り付けます。このヘッダーの下に、1 行につき 1 件データを追加できます。必ず、プレーンテキスト ファイルを作成できるエディタを使用してください。Microsoft Word などのリッチテキスト エディタの使用は避けてください。使用する場合は、必ずファイル形式をプレーンテキスト(.txt)に指定します。リッチテキスト形式には追加の書式や制御文字が含まれているため、エラーが発生する可能性があります。
スプレッドシートを使用する
アップロード データにスプレッドシートを使用する場合は、上記の手順に従ってデータセット スキーマを取得してから、[スキーマのテンプレートをダウンロード] ボタンをクリックします。スキーマのヘッダーが [ダウンロード] ディレクトリにダウンロードされたら、任意のスプレッドシートでスキーマを開きます。スプレッドシートのインポート機能を使用して、アップロードするデータをインポートします。ファイルの準備が整ったら、スプレッドシート プログラムの [名前を付けて保存] または [エクスポート] 機能を使用し、出力形式に CSV を指定します。
アップロード データの形式を設定する
データ インポートでは、アップロード ファイルの各行に単一のヒット情報を含める必要があります。ヒットに含まれる個々のディメンションや指標は、カンマで区切ります。ファイルの各行の終わりには改行を挿入します。アップロードするデータの内容にカンマが含まれる場合は、そのデータを引用符で囲みます。コンテンツのエラーの最もよくある原因は、おそらくアップロードされたデータにおけるカンマ、二重引用符、改行といった文字の不適切な使用です。このため、データ インポートでこれらの記号がどのように解釈されるかを理解しておけば、問題を回避することができます。
カンマ
CSV ファイルでは、定義上、新しいセルの開始にカンマが使用されます。言い換えると、データのインポート時にエスケープ処理されていないカンマが表示された場合、新しい列のエントリが開始されたと見なされます。適切な形式のデータの例を以下に示します。
abc123,29.99,Blue,XXL def345,100,Red,M ghi678,1035.20,Green,S
この場合、データのインポート時に次の 4 つの列のデータが表示されます。
abc123 | 29.99 | Blue | XXL |
def345 | 100 | Red | M |
ghi678 | 1035.20 | Green | S |
では、次のように数値列の表示形式を通貨として設定(千の位ごとにカンマで区切る)したことで、データにカンマが 1 個追加されてしまった場合はどうなるでしょうか。
ghi678,"1,035.20",Green,S
このファイルをアップロードしようとすると、余分なカンマがあるため、データのインポート時に 5 つの列が表示され、次のようなアップロード表が生成されます。
abc123 | 29.99 | Blue | XXL | |
def345 | 100 | Red | M | |
ghi678 | 1 | 035.20 | Green | S |
さらに、次のようなエラー メッセージが表示されます。
「エラー: 列の数が一致しません」
二重引用符
二重引用符は、セルの値の「エスケープ処理」に使用できます。通常、セルの値にカンマが含まれている場合は、二重引用符でその値を囲みます。囲まれていないと、データのインポート時は、カンマが新しいセルの開始として解釈されます(上記参照)。
例:
ghi678,"1,035.20",Green,S
値「1,035.20」は、単一のセルとして処理されます(ただし、データのインポート時には通貨の値ではなく文字列として表示され{ます)。
二重引用符でセルをエスケープ処理する場合、その数は均等である必要があります。二重引用符の数が奇数の行があると、インポートは失敗し、次のようなメッセージが表示されます。
「エラー: 行 x の CSV フォーマットが無効です。」
改行
CSV ファイル内の改行は、新しい行の開始を示すために使用されます。たとえ二重引用符でエスケープ処理されていても、データのインポートはセル内の改行に対応していません。行内に不要な改行があると、その行か以降の行の 1 つのいずれかで列数のエラーが発生し、次のようなエラー メッセージが生成されます。
「エラー: 行の CSV フォーマットが無効です」