Google SpeadsheetからGoogle Analyticsのデータを自動的に取得し、定期レポートを送る方法

## やりたいことの整理
- Google SpreadsheetにGoogle Analyticsのデータを**自動的に**取得する
- Google Spreadsheet内、ないしGoogle Apps Scriptでグラフを描画しメールでレポートを送る


## 調べたこと
### Google Analytics Add-onを使う方法
Google Analytics Add-on(以下、Addon)はSpreadsheetのAdd-onタブから簡単にインストールが可能です。
UIを使って手軽に必要な情報を取得できて大変便利ですが、GASの便利機能であるTriggerに対応していないため、
今回の目的には合致しません....

自動化しなてくても大丈夫、という用途であればこちらが解説が詳しいです。
[Google Drive スプレッドシートアドオン「Google Analytics」を試してみた](http://www.infoscoop.org/blogjp/2014/04/25/google-drive-%E3%82%B9%E3%83%97%E3%83%AC%E3%83%83%E3%83%89%E3%82%B7%E3%83%BC%E3%83%88%E3%82%A2%E3%83%89%E3%82%AA%E3%83%B3%E3%80%8Cgoogle-analytics%E3%80%8D%E3%82%92%E8%A9%A6%E3%81%97%E3%81%A6%E3%81%BF/)


### Magic Scriptを利用する方法
いろいろ調べていて無理なのかなと思いそうなタイミングで、こちらを発見しました。
Add-OnがGoogleから公式で提供されるまでデファクトスタンダードとして利用されていたMagic Scriptを利用する方法です。

調べる中で存在はしっていたのですが以前の記事を読むと、SpreadsheetのTools>Script Galleryからインストールする方法が説明されていてこちらが現在利用できないため取得が無理かとおもっていたのですが、そのソース自体を公開していらっしゃる方がおり、こちらを直接インストールすることでこちらが利用可能になるようです。

[Magic Script](https://script.google.com/macros/d/1POUQtyxElq40z48sMY3vZz_ABc2tKCwnJ4YwDFCeYaRetjrGKRwwSn6k/edit?usp=drive_web)

こちらをコピーして頂き、ScriptEditorの画面から貼り付けて頂ければ大丈夫です。
具体的な手順ですが、

- 新規のスプレッドシートを作成する こちらの[URL](http://spreadsheets.google.com/ccc?new&hl=en)から新規ファイルを作成可能です
- 「Tools」を選択しScript Editorを開く
- File > New > Script Filesを選択し、適当にMagic.gsを作成する
- Magic Scriptの内容をはりつける

- 上部メニューから「Resources」>「Advanced Google Services」を選択
- 「Google Analyics」を有効にする
- Google Developer Consoleのリンクをクリックしこちらも有効化する
 
![Untitled project 2014-08-22 午後05-23-18 2014-08-22 午後05-23-48.jpg](https://qiita-image-store.s3.amazonaws.com/0/13161/f3ee946a-c88c-96cc-71f2-cedb609e1d21.jpeg)

![Google Developers Console 2014-08-22 午後05-25-09 2014-08-22 午後05-25-17.jpg](https://qiita-image-store.s3.amazonaws.com/0/13161/ff9473bd-09f5-39f9-7109-b6cf48204334.jpeg)

- 一旦プロジェクトを保存する(Ctrl+s or ⌘ + s)

# Magic Scriptの基本的な使いかた
## 1. シートの再読み込み
まずは作成したスプレッドシートをリロードします。こうすることでMagic.gsの中にonOpenイベントが発生し、シート上部のメニューに
**Google Analytics**というメニューが追加されます。
![Untitled spreadsheet - Google Sheets 2014-08-22 午後07-15-16 2014-08-22 午後07-15-20.jpg](https://qiita-image-store.s3.amazonaws.com/0/13161/164f5282-5715-8e97-d472-35a01eb642eb.jpeg)

## 2. GAアカウント、プロパティIDの確認
Google Analyticsメニューの中から「Find Your Profile ID / ids Parameter」というメニューを選択すると、
権限のあるGAアカウント(サイト)や紐付いているプロパティが確認できます。
![Untitled spreadsheet - Google Sheets 2014-08-22 午後07-16-48 2014-08-22 午後07-16-57.jpg](https://qiita-image-store.s3.amazonaws.com/0/13161/af238c41-4f0f-8e08-5689-16000f34b4e2.jpeg)
こちらで、今回のシートで使用したいサイト、プロパティについて
- Ids
という項目をメモしておいてください。


## 3. Coreレポートの作成
同じGAメニュー内から、「Create Core Report」の作成を選択してください。
これにより、「gaconfig」というシートが追加され以下のように項目が記入されるかと思います。
![Untitled spreadsheet - Google Sheets 2014-08-22 午後07-22-15 2014-08-22 午後07-22-16.jpg](https://qiita-image-store.s3.amazonaws.com/0/13161/13d2ad9e-ef06-b823-ef68-00e06bd3686c.jpeg)

こちらのidsの欄に先ほどメモしておいたidを記入してください。

## 4. 取得データの設定
- 取得期間: start-date,end-date,last-n-days
一旦テスト用に、last-n-daysに90とかを記入しておきましょう。他は空欄で結構です。


- 取得数値: metrics
こちらの[レファレンス](https://developers.google.com/analytics/devguides/reporting/core/dimsmets)を参照しましょう。
今回は一旦「ga:visits」としておきましょう。

- 分類軸: dimensions
metricsを分類する軸、を指定します。こちらも先ほどのレファレンスから確認可能です。
今回はためしに「ga:date,ga:visitorType」としておきましょう。日付ごと、訪問者の分類(新規/既存)で分類してみます。

- sort
- filters
- segment
- start-index
- max-results
- sheet-name
この当たりは詳しくはドキュメントを確認してみてください。

## 5. データの取得
Analyticsメニューから「Get Data」を押すと、query1に指定した名称でシートが追加され、
データが格納されます。

![Analytics_test - Google Sheets 2014-08-22 午後08-07-18 2014-08-22 午後08-07-18.jpg](https://qiita-image-store.s3.amazonaws.com/0/13161/d84b0475-18d2-ed4c-3d1a-964f15030ed2.jpeg)
※データは適当です。


# Magic Scriptの自動実行
## 1.getData関数をトリガーに設定する方法
「Get Data」を毎時自動的に実行するだけであれば、こんな感じで設定しておくだけで実行自体はされる。
![magic 2014-08-22 午後08-28-49 2014-08-22 午後08-29-02.jpg](https://qiita-image-store.s3.amazonaws.com/0/13161/ae3b9a97-5d3d-19f6-d94a-f6e4957683bc.jpeg)
![magic 2014-08-22 午後08-31-28 2014-08-22 午後08-31-29.jpg](https://qiita-image-store.s3.amazonaws.com/0/13161/46f3d98c-8b0e-89ca-c378-3dc28b4a0d56.jpeg)

## 2. 
書いてる途中....


## 参考
http://marketing-sphere.blogspot.jp/2014/07/google-analyticsaddonmagic-script.html