Philip Walton、Google アナリティクス デベロッパー プログラム エンジニア、2014 年 3 月
Google アナリティクス スプレッドシート アドオンを使用すると、Google アナリティクス ユーザーは Google スプレッドシート データにアクセスしやすくなり、視覚化、共有、操作も簡単に行えるようになります。
はじめに
Google アナリティクス スプレッドシート アドオンでは、Google アナリティクス API の機能と、Google スプレッドシートのデータ操作の機能を併せて利用することができます。このツールを使用すると、次のことを行えます。
- 複数のビューからデータをクエリしてレポートします。
- カスタム計算を計算して表示します。
- ビジュアリゼーションを作成してサードパーティのウェブサイトに埋め込む。
- レポートを自動作成および更新するようにスケジュール設定できます。
- Google スプレッドシートと共有機能を使用して、データとビジュアリゼーションを表示できるユーザーを指定できます。

動画チュートリアル
次の 2 つの動画では、アドオンをダウンロードしてインストールする方法と、自動的に更新されサードパーティのウェブサイトに埋め込めるダッシュボードの作成方法について説明します。
Google アナリティクス スプレッドシート アドオンのご紹介
Google アナリティクス スプレッドシート アドオンを使用してダッシュボードを作成する
アドオンのインストール
Google アナリティクス スプレッドシート アドオンを使用するには、まずこのアドオンをスプレッドシートに追加する必要があります。手順は次のとおりです。
- 新しい Google スプレッドシートを作成します(または既存のスプレッドシートを開きます)。
- メニューバーから [アドオン] > [アドオンを取得…] を選択します。
- アドオン ギャラリーから Google アナリティクス アドオンを探して選択します。
- アドオンの説明ページの右上の [+] をクリックして、スプレッドシートにこのアドオンを追加します。
- ダイアログが表示され、このアドオンに Google アナリティクス データへのアクセスを許可するよう求められます。[承認する] をクリックします。
- これでアドオンがインストールされました。[アドオン] メニューに、[Google Analytics](Google アナリティクス)サブメニューが表示されます。
レポートの作成
レポートは、手動で作成することも、アドオンのレポート作成ツールを使用して作成することもできます。 このツールを使用するには、メニューバーから [アドオン] を選択します。右側にサイドバーが表示され、Google アナリティクスのアカウント情報を簡単に検索したり、クエリ対象のディメンションと指標を選択したりできます。操作が完了したら、[Create Report](レポートを作成)ボタンをクリックします。「Report Configuration(レポート設定)」という名前のシート(既存シートがなければ作成されます)にレポート情報が表示されます。
追加のレポートを作成するには、上記の手順を繰り返しm。作成した各レポートでは、前のレポートの右側にデータを含む新しい列が追加されます。
レポート作成ツールが「Report Configuration」シートに入力した値を見ると、多くのセルが空白になっていますが、これは意図的なものです。このツールの目的は、作業を始めやすいように、すぐには知ることのできない情報を提供することです。残りのフィールドは、ご自身で入力してください。各フィールドの入力値についてご不明な点があれば、このドキュメントの最後にあるリファレンス セクションをご覧ください。
レポートの実行
作成したすべてのレポートを実行するには、メニューバーから [アドオン] > [Google Analytics](Google アナリティクス)> [Run Reports](レポートを実行)を選択します。
レポートを除外する
デフォルトでは、このアドオンは名前が付いているすべてのレポートを実行します。このため、レポートを削除することなく一時的に実行から除外したい場合には、名前の値が含まれるセルのテキストを削除してください。
出力シートを選択する
レポートを実行すると、Google アナリティクス API にリクエストが送信され、選択したシートに結果が出力されます。出力先のシートには、現在アクティブなスプレッドシート内のシートでも、別のスプレッドシート(そのスプレッドシートへの編集権限を持っている場合)でも利用可能です。別のスプレッドシートに結果を出力するには、そのスプレッドシートの URL をコピーして、[Spreadsheet URL](スプレッドシート URL)パラメータの右のセルに貼り付けてください。
レポートを自動的に実行するためのスケジュール設定
レポートを自動的に実行するには、メニューバーから [アドオン] > [Google Analytics](Google アナリティクス)> [Schedule Reports](レポートのスケジュール設定)を選択します。レポートのスケジュールを設定するダイアログが開き、スケジュール機能のオン / オフのや、レポートを実行する頻度を設定します。
スケジュール機能を有効にするには、[Enable reports to run automatically.](レポートの実行を有効にする)チェックボックスをオンにします。スケジュール機能を有効にすると、プルダウン メニューから時間や頻度を選択できるようになります。レポートは、毎時、毎日、毎週、または毎月実行できます。
スケジュール機能を無効にするには、[Enable reports to run automatically.](レポートの自動実行を有効にする)チェックボックスをオフにします。
一般的なユースケース
複数のビューからデータをクエリする
Google アナリティクスのウェブ インターフェースでは、一度に 1 つのビューのレポートや可視化データのみを確認できます。このアドオンを使用すれば、任意の数のビューでレポートを作成して、生成されたデータを任意の方法で使用できます。たとえば、iOS トラフィックを追跡するビューと Android トラフィックを追跡する別のビューがある場合、このアドオンを使用すると、両方のビューに対してレポートを作成して、同じスプレッドシート内で結果を並べて簡単に比較できます。
Google アナリティクス データを利用してカスタム計算を作成する
Google アナリティクス API では、あらゆるタイプのデータを収集し、さまざまなレポートの形式を提供していますが、時にはより具体的な計算が必要になる場合もあります。Google スプレッドシートにデータが格納されている場合、スプレッドシートに組み込まれているデータ操作機能を利用することができます。
組み込みのデータ視覚化機能を使用してマイレポートを作成する
Google スプレッドシートにデータが格納されていれば、Google が提供する視覚化ツールをすべて利用できます。特別な設定は必要ありません。さらに、Google スプレッドシートのチャートやグラフを外部サイトに埋め込めます。 つまり、Google アナリティクスのデータを可視化して独自のダッシュボードを簡単に作成し、任意の場所でホストでき、レポートを実行するたびにダッシュボードが自動的に更新されます。
どのユーザーに Google アナリティクス データの閲覧を許可するか管理する
Google アナリティクスのウェブサイトでは、一目で詳細なデータを把握することができて便利です。しかし、Google アナリティクス アカウントへのアクセス権を付与せずに、関係者にデータだけを表示したい場合もあるでしょう。
Google アナリティクス スプレッドシート アドオンを使えば、この問題を解消することができます。Google スプレッドシートには組み込まれた独自の許可システムを持っているため、新しいスプレッドシートを作成し、任意のユーザーにアクセス権を与え、そのスプレッドシートにレポートのデータを出力すれば完了です。
データやグラフを自動的に更新する
レポートを作成したり、サードパーティのウェブサイトにビジュアリゼーションを埋め込んだりすると、レポートをスケジュール設定して自動的に実行されるようにすることで、データを常に最新に保つことができます。
よくある質問
スケジュール設定したレポートが次にいつ実行されるか、どうすればわかりますか?
スケジュール設定したレポートは、まず、指定した期間内からランダムに選択された日時に実行されます。後続の実行は、同時に予測された間隔で行われ、選択した間隔でオフセットされます。たとえば、レポートを毎日午前 4 時から午前 5 時の間に実行するようにスケジュールした場合、最初の実行が午前 4 時 12 分に行われるため、その後のすべての実行も午前 4 時 12 分に実行されます。
スケジュール設定したレポートが指定した時間帯に実行されませんでした。何か問題があるのでしょうか?
レポートのスケジュール設定をするときには、スケジュールを設定してからスケジュール通りにレポートが実行されるまで、時間が十分あることを確認してください。予定時刻の初回発生に近すぎる場合は、次回の発生までレポートが延期される可能性があります。レポート実行まで、少なくとも 1 時間は空けることをおすすめします。
レポートごとに別のスケジュールを設定することはできますか?
スケジュール設定はすべてのレポートに適用されるか、レポートには適用されません。異なる間隔でさまざまなレポートをスケジュールする必要がある場合は、複数のスプレッドシートを使用できます。
レポートデータの形式が正しくないのはなぜですか?
Google アナリティクス Reporting API は、すべての値を米国形式で返します。スプレッドシートと異なる言語 / 地域が設定されている場合、Google スプレッドシートは変換を試行しますが、予期しない結果になることがあります。
この問題を回避するには、レポート スプレッドシートの言語 / 地域が「米国」に設定されていることを確認してください(スプレッドシートの言語 / 地域を変更する手順については、ドキュメント エディタのヘルプをご覧ください)。任意の地域形式に変換するために、優先する地域が設定された 2 つ目のスプレッドシートを作成し、IMPORTRANGE
関数を使用して、その新しいスプレッドシートにレポートデータをインポートできます。Google スプレッドシートでスプレッドシートをインポートする際に、言語 / 地域間で書式が正しく変換されます。
参考情報
アドオンについて質問したり、バグを報告したりするには、Google グループ google-analytics-spreadsheet-add-on にメッセージを送信します。質問が回答済みであるため、投稿する前にグループを検索してください。
構成パラメータのリファレンス
以下のセクションでは、必須パラメータ、オプション パラメータ、非表示パラメータについて説明します。
- 各レポートで必須パラメータを指定しないと、レポートはエラーになります。
- 省略可能なパラメータは必須ではありませんが、指定できます。
- 非表示パラメータは、ほとんどのレポートで不要な高度なオプションであり、デフォルトでは非表示になっています。このパラメータを使用するには、レポート設定のシートで 14 ~ 16 行目をもう一度非表示にしてください。
必須パラメータ
名前 | 説明 |
---|---|
Report Name(レポート名) | レポートの名前。また、レポートデータが書き込まれたシートの名前になります。 |
ビュー ID | Google アナリティクスのビューの ID。この値はレポート作成ツールまたは Google アナリティクス アカウント管理者で確認できます。 |
開始日 |
アナリティクス データの取得開始日。リクエストでは、開始日を YYYY-MM-DD 形式、または相対日付で指定できます(例: スプレッドシートの日付関数を使用して、この値をプログラムで指定することもできます。たとえば、次の式は前月の最終日を返します。 =EOMONTH(TODAY(), -1) |
終了日 |
アナリティクス データの取得の終了日。終了日は、YYYY-MM-DD のような終了日、または相対的な日付(例: スプレッドシートの日付関数を使用して、この値をプログラムで指定することもできます。たとえば、次の式は前月の最終日を返します。 =EOMONTH(TODAY(), -1) |
指標 |
クエリを実行する指標のリスト。指標は次の 2 つの形式のいずれかで指定できます。
たとえば、以下のすべてが Metrics パラメータの有効な値です。 ga:sessions,ga:bounces ga:sessions ga:bounces [{ "expression": "ga:sessions/ga:users", "alias": "Sessions per User", "formattingType": "FLOAT" }, { "expression": "ga:totalEvents/ga:pageviews", "alias": "Events per Pageview", "formattingType": "FLOAT" }] ほとんどのユースケースで、指標 ID のリストは Metrics パラメータを指定する最も簡単な方法です。ただし、前述の 3 番目の例の指標式など、Analytics Reporting API の高度な機能を利用するには、値を JSON として指定する必要があります。 ディメンションと指標の完全なリストについては、ディメンションと指標のリファレンスをご覧ください。 |
オプション パラメータ
名前 | 説明 |
---|---|
サイズ |
クエリを実行するディメンションのリスト。ディメンションは次の 2 つの形式のいずれかで指定できます。
たとえば、以下のすべてが Metrics パラメータの有効な値です。 ga:source,ga:deviceCategory ga:source ga:deviceCategory [{ "name": "ga:source" }, { "name": "ga:deviceCategory" }] ほとんどのケースでは、ディメンション ID のリストを指定することが、ディメンション パラメータを指定する最も簡単な方法です。 ディメンションと指標の完全なリストについては、ディメンションと指標のリファレンスをご覧ください。 |
注文 |
列(指標またはディメンション ID)と方向(昇順または降順)で並べ替える結果の並べ替え。順序は、次の 2 つの形式のいずれかで指定できます。
たとえば、以下のパラメータはすべて注文パラメータの有効な値です。 -ga:sessions,ga:eventLabel -ga:sessions ga:eventLabel [{ "fieldName": "ga:sessions", "sortOrder": "DESCENDING" }, { "fieldName": "ga:eventLabel", "sortOrder": "ASCENDING", "orderType": "DIMENSION_AS_INTEGER" }] ほとんどのユースケースでは、Order パラメータを指定する最も簡単な方法が従来の形式です。ただし、 |
フィルタ |
返される結果のセットを制限する条件。フィルタは次の 2 つの形式のいずれかで指定できます。
たとえば、Filters パラメータ パラメータの有効な値は次のうちどれですか。 ga:sessions>10;ga:country==United States { "metricFilterClauses": [{ "filters": [ { "metricName": "ga:totalEvents", "operator": "GREATER_THAN", "comparisonValue": "100" } ] }], "dimensionFilterClauses": [{ "operator": "AND", "filters": [ { "dimensionName": "ga:eventCategory", "operator": "EXACT", "expressions": ["Outbound Link"] } ], "filters": [ { "dimensionName": "ga:eventAction", "operator": "EXACT", "expressions": ["click"] } ] }] } ほとんどのユースケースでは、従来の形式が最もフィルタ パラメータを指定する方法です。ただし、高度なフィルタ処理(ディメンションに対して比較演算子を使用するなど)が必要な場合は、値を JSON として指定する必要があります。 |
セグメント |
クエリを適用するセッションまたはユーザーのセットを制限する条件。セグメントは、次の 2 つの形式のいずれかで指定できます。
たとえば、セグメント パラメータの有効な値は次のいずれかになります。 gaid::-1,sessions::condition::ga:city==New York gaid::-1, sessions::condition::ga:city==New York [{ "dynamicSegment": { "name": "New York Sessions", "sessionSegment": { "segmentFilters": [{ "simpleSegment": { "orFiltersForSegment": [{ "segmentFilterClauses":[{ "dimensionFilter": { "dimensionName": "ga:city", "expressions": ["New York"] } }] }] } }] } } }, { "dynamicSegment": { "name": "Non-referral Sessions", "sessionSegment": { "segmentFilters": [{ "simpleSegment": { "orFiltersForSegment": [{ "segmentFilterClauses": [{ "dimensionFilter": { "dimensionName": "ga:medium", "operator": "EXACT", "expressions": [ "referral" ] } }] }] }, "not": "True" }] } } }] ほとんどのユースケースでは、セグメント ID を指定する方法、または従来の定義形式を使用する方法が最も簡単です。ただし、高度なセグメント化が必要な場合(ディメンションで比較演算子を使用するなど)は、値を JSON として指定する必要があります。 |
上限 |
レポートに対して返される結果の最大数。このパラメータを空白のままにすると、すべての結果が返されます。 |
スプレッドシートの URL | 結果を出力する外部スプレッドシートの URL。デフォルトでは、結果は現在のスプレッドシートのシートに出力されます。この機能を使用するには、スプレッドシートでの編集権限が必要です。 |
レポートをスキップ |
このフィールドは、数式を使用してプログラムで設定できます。たとえば、次の式では、終了日の値(セル B5")が過去の日付になっているとレポートがスキップされます。 =IF(B5 < TODAY(), TRUE, FALSE) |
非表示のパラメータ
名前 | まとめ |
---|---|
レポートタイプ |
デフォルトで(または空白のままにすると)、このレポートは Analytics Reporting API v4 にクエリを送信します。Multi-ChannelFunnel Reporting API に対してクエリを実行するには、値を「mcf」に設定します。 MCF API を使用する場合は、MCF のディメンションと指標も使用する必要があります。また、他の機能(セグメントなど)は MCF レポートではご利用いただけません。 |
サンプリング レベル | 目的のレポートのサンプルサイズ。有効な値は「DEFAULT"」(空白のままにします)、「SMALL」または「LARGE」です。 |
リソースの割り当ての使用 |
リソースベースの割り当てシステムは、新しい割り当てシステムです。アナリティクス 360 の一部のアカウントで、Analytics Reporting API の使用時にサンプリングしきい値を引き上げられます。この機能にアクセスできる場合は、このパラメータを TRUE に設定することで有効にできます。 |
空の行を除外する |
このパラメータを使用すると、行内のすべての指標値がゼロの場合にレポートから行を除外できます。デフォルトの動作(または空白のままにした場合)では、すべての行が表示されます(推奨)。 なお、このパラメータは Analytics Reporting API v4 の |