本記事は Pleasanter(プリザンター) Advent Calendar 2020 十日目の記事です。

はじめに

この記事は、12月7日に公開した Googleフォームの回答内容をプリザンターに登録してみるの続編のようなものです。
表題の通り、今回はGoogle Apps Scriptを使ってGoogle Analyticsとプリザンターを連携させるわけですが、ほとんど使いまわしです。言うなれば、エコです。

今回はプリザンターのAPIを使用しますので、Pleasanter.netのフリープラン、ライトプランではお試し頂けません。
お試し環境を持っていない場合は、デモサイトをご利用ください。メールアドレスを登録するだけですぐにお使いいただけます。
プリザンターのデモサイト

もちろん、OSS版をお使いいただいている方はそちらでお試しください。
プリザンターのダウンロード

プリザンターにテーブルを作る

まずは記録テーブルを作りましょう。
「テーブルの管理」「エディタ」で以下のように項目を有効化します。

項目名称	種別
タイトル	Title
ユーザ	NumA
セッション	NumB
ページビュー	NumC

ついでに、APIキーを発行し、メモはせずに暗記してください。全集中です。
ユーザーマニュアル：APIキーの作成

Google様に感謝

Analyticsにログインしているブラウザで以下にアクセスしてください。
https://ga-dev-tools.appspot.com/query-explorer/

GASでAnalyticsに値を取りに行く際に必要となるidsも表示されているのでメモはせずに暗記してください。
metricsでは、どの項目を取得するか指定する際のパラメータが表示されます。
今回はシンプルに「ユーザ数」「セッション」「ページビュー」をプリザンターに登録したいと思います。

続いて、スクリプトエディタで、AnalyticsのAPIを使えるように設定します。
スクリプトエディタの「リソース」→「Googleの拡張サービス」から「Google Analytics API」を「ON」にします。

前回同様、IDなどはプロパティストアに格納しておきます。
「ファイル」→「プロジェクトのプロパティ」→「スクリプトのプロパティ」に以下のように登録します。

プロパティ	値
API_KEY	プリザンターで発行したAPIキー
API_URL	リクエストを投げるURL
ids	Google Analytics

コードは以下のような感じです。

function SendPleasanter() {

    let date = new Date();
    let year = date.getFullYear();
    let month = date.getMonth() + 1;
    let day = date.getDate();
    let title = year + '/' + month + '/' + day + '：' + 'Pleasanter.org';

    var gaData = getGaData('yesterday', 'yesterday');
    Logger.log(gaData);

    var data = {
        "ApiVersion": 1.1,
        "ApiKey": PropertiesService.getScriptProperties().getProperty('API_KEY'),
        "Title": title,
        "NumHash": {
            "NumA" : gaData[0][0],
            "NumB" : gaData[0][1],
            "NumC" : gaData[0][2]
        }
    };

    const api_url = PropertiesService.getScriptProperties().getProperty('API_URL');

    var options = {
        'method': 'post',
        'contentType': 'application/json',
        'payload': JSON.stringify(data)
    };

    var response = UrlFetchApp.fetch(api_url, options);
    Logger.log(api_url, options);
}

function getGaData(startDate, endDate) {
    var gaData = Analytics.Data.Ga.get(
        PropertiesService.getScriptProperties().getProperty('ids'),
        startDate, endDate, 
        'ga:users, ga:sessions, ga:pageviews' 
    ).rows;

    return gaData;
}

Googleフォームとの連携と違って、スクリプトエディタから実行できますので、試してみましょう。

登録できました！
控えめなページビューでお恥ずかしい限りです。

とりあえず、これで昨日のページビューなどをAnalyticsから取得し、プリザンターに登録することができました。ただ、これを毎日手動でやるのも面倒なので、フォーム連携でも使ったトリガーを設定して自動化します。

これで毎日午後1時〜2時の間で自動的にスクリプトが走って、プリザンターに情報が登録されます。
素晴らしい！

おわりに

いやあ、Google Apps Script、本当に便利。
Analytics APIも非常にシンプルにアクセスできるので、思ったより簡単に出来てしまいました。
ドキュメントが豊富なのもありがたいところです。
GASを使うことでもっとプリザンターを便利に使える予感が青天井で有頂天で絶好調です。

Analyticsのデータをプリザンターに集積してMetabaseで視覚化、というのも面白そうですよね。
プリザンターをデータハブとして、様々なサービスと連携させることで、可能性は無限大です。宇宙です。
もっとプリザンターをいろいろなものと連携させてみたい欲求も無限大です。全集中です。

GASを使ってAnalyticsのデータを毎日自動でプリザンターに登録する。

はじめに

プリザンターにテーブルを作る

Google様に感謝

おわりに