カグア！

18/05/10 at 07:05 am　 カグア！ > API >

Google Analytics Data Export API リファレンス日本語訳

　

　かなり意訳ですが、Google Analytics Data Export APIを、
　自分用にまとめてみました。不適切なところありましたら、ご指摘いただけると
　助かります。また随時加筆修正加えていく予定です。

　１．ディメンション
　２．メトリクス
　３．サンプルソース（PHP版）
　４．参考リンク
　５．更新履歴

　

１．ディメンション（縦方向にずら〜っと並ぶ値）

　・ユーザー（システム系）
　　ga:isMobile　（モバイル）　ex)　Android
　　ga:operatingSystem　（OS）　ex)　iPhone
　　ga:operatingSystemVersion　（OSのバージョン）　ex)　XP　※携帯は機種名
　　ga:screenColors　（ディスプレイの色深度）　ex)　24-bit
　　ga:screenResolution　（解像度）　ex)　1024×738.
　　ga:browser　（ブラウザ）　ex)　Firefox
　　ga:browserVersion　（ブラウザーのバージョン）　ex)　2.0.0.14
　　ga:flashVersion　（FLASHのバージョン）　ex)　10.0 r45
　　ga:javaEnabled　（Javaが利用可能かどうか）　ex)　Yes
　　ga:language　（使用言語）　ex)　en-gb

　・ユーザー（地域系）
　　ga:latitude　（緯度）　ex)　35.6850
　　ga:longitude　（経度）　ex)　139.7510
　　ga:continent　（大陸）　ex)　Asia
　　ga:subContinent　（亜大陸）　ex)　Eastern Asia
　　ga:region　（地域）　ex)　New York
　　ga:country　（国）　ex)　Japan
　　ga:city　（都道府県）　ex)　Osaka

　・ユーザー（接続環境系）
　　ga:connectionSpeed　（接続速度）　ex)　DSL
　　ga:networkDomain　（訪問者ドメイン）　ex)　rikkyo.ac.jp　※企業名なども取得可能な場合も。
　　ga:networkLocation　（サービスプロバイダ）　ex)　ntt communications corporation
　　ga:hostname　（ホスト名）　ex)　www.kagua.biz

　・ユーザー（日にち系）
　　ga:date　（日付）　ex)　20100513
　　ga:year　（年）　ex)　2010
　　ga:month　（月）　ex)　01
　　ga:week　（週）　ex)　01
　　ga:day　（日にち）　ex)　01、31
　　ga:daysSinceLastVisit　（最終訪問日からの日数）　ex)　1
　　ga:hour　（アクセス時間）　ex)　24

　・ユーザー（セッションPV系）
　　ga:visitCount　（セッション数）　ex)　1
　　ga:pageDepth　（滞在中のページビュー）　ex)　1
　　ga:visitLength　（滞在時間）　ex)　100
　　ga:visitorType　（新規かリピーターか）　ex)　Returning Visitor
　　ga:userDefinedValue　（ユーザー定義）　ex)　定義内容

　・トラフィック
　　ga:medium　（媒体名）　ex)　organic、cpc
　　ga:referralPath　（リファラのURL）　ex)　/blog/1234/
　　ga:source　（リファラ）　ex)　google.co.jp
　　ga:keyword　（検索キーワード）　ex)　Google Analytics

　・コンテンツ（ページ）
　　ga:exitPagePath　（離脱ページ）　ex)　/info.html
　　ga:landingPagePath　（閲覧開始ページ）　ex)　/copr.html
　　ga:nextPagePath　（直後のページ）　ex)　/faq.html
　　ga:pagePath　（閲覧ページ）　ex)　/
　　ga:pageTitle　（ページタイトル）　ex)　よくあるご質問
　　ga:previousPagePath 　（前のページの集計）　ex)　/
　　ga:secondPagePath　（次のページの集計）　ex)　/faq.html

　・eコマース
　　ga:affiliation　（アフィリエイト）
　　ga:daysToTransaction　（購買までの日数）　ex)　01
　　ga:productCategory　（商品カテゴリー）　ex)　日用品
　　ga:productName　（商品名）　ex)　abc-1234
　　ga:productSku　（商品の最小単位）　ex)　M（サイズ等）
　　ga:transactionId　（処理ID）　ex)　123456789
　　ga:visitsToTransaction　（購入までのセッション数）　ex)　1　

　・サイト内検索
　　ga:searchCategory　（サイト内検索のカテゴリー）
　　ga:searchDestinationPage　（到達ページ）　ex)　/etc/follower1.html
　　ga:searchKeyword　（サイト内検索キーワード）　ex)　アドバンスセグメント
　　ga:searchKeywordRefinement　（再検索キーワード）　ex)　非同期トラッキング
　　ga:searchStartPage　（検索開始ページ）　ex)　/column/jinsei.html
　　ga:searchUsed　（利用状況）　ex)　Visits Without Site Search

　・カスタム変数
　　ga:customVarName(n)　（カスタム変数名）　ex)　id　※ga:customVarName1　と記述
　　ga:customVarValue(n)　（カスタム変数値）　ex)　100 ※ga:customVarValue1　と記述

　・イベントトラッキング
　　ga:eventCategory　（イベントカテゴリー名）　ex)　test
　　ga:eventAction　（イベントアクション名）　ex)　play
　　ga:eventLabel　（イベントラベル）　ex)　stop

　・アドワーズ
　　ga:campaign　（キャンペーン名）
　　ga:adContent　（広告文）　ex)　アナリティクス初級セミナー　※設定した広告タイトル
　　ga:adGroup　（広告グループ名）
　　ga:adSlot　（表示場所）　ex)　side　※検索画面の上（右）に表示されているか
　　ga:adSlotPosition　（表示順位）　ex)　3rd
　　ga:adwordsAdGroupId　（グループID）
　　ga:adwordsCampaignId　（キャンペーンID）
　　ga:adwordsCreativeId　（クリエイティブID）
　　ga:adwordsCriteriaId　（条件ID）
　　ga:adwordsCustomerId　（顧客ID）

　

２．メトリクス（横方向に「項目」として表示できる値）

　・ユーザー（システム系）
　　ga:bounces　（直帰数）
　　ga:entrances　（閲覧開始数）
　　ga:exits　（離脱数）
　　ga:newVisits　（新規ユーザー数）
　　ga:pageviews　（ページビュー）
　　ga:timeOnPage　（ページ滞在時間）　※秒で取得
　　ga:timeOnSite　（サイト滞在時間）　※秒で取得
　　ga:visitors　（ユニークユーザー数）
　　ga:visits　（セッション数）

　・コンバージョン
　　ga:goal(n)Completions　（コンバージョン完了数）　※ga:goal1Completions　と使用
　　ga:goalCompletionsAll　（総コンバージョン完了数）
　　ga:goal(n)Starts　（コンバージョン開始数）　ex)　※ga:goal1Starts　と使用
　　ga:goalStartsAll　（総コンバージョン開始数）
　　ga:goal(n)Value　（コンバージョン値）　ex)　※ga:goal1Value　と使用
　　ga:goalValueAll　（総コンバージョン値）

　・コンテンツ（ページ）
　　ga:uniquePageviews　（重複しないページビュー）　ex)　1

　・eコマース
　　ga:itemRevenue　（商品の合計）
　　ga:itemQuantity　（商品の個数）
　　ga:transactions　（決済回数）
　　ga:transactionRevenue　（総合計）
　　ga:transactionShipping　（送料）
　　ga:transactionTax　（税）
　　ga:uniquePurchases　（購入設定数）

　・サイト内検索
　　ga:searchDepth　（検索結果後のページビュー）
　　ga:searchDuration　（検索後の滞在時間）
　　ga:searchExits　（検索後の離脱数）
　　ga:searchRefinements　（再検索した回数）
　　ga:searchUniques　（セッションあたりの検索回数）
　　ga:searchVisits　（セッションあたりの合計検索回数）

　・アドワーズ
　　ga:adClicks　（クリック数）
　　ga:adCost　（キーワードごとの費用）
　　ga:CPC　（1クリックの費用）
　　ga:CPM　（表示にかかる費用）
　　ga:CTR　（クリック率）
　　ga:impressions　（表示数）

　・イベントトラッキング
　　ga:totalEvents　（総イベント発生回数）
　　ga:uniqueEvents　（イベント発生回数）
　　ga:eventValue　（イベント値）

　

３．Google Analytics API使用サンプル

　※Google Analytics ライブラリをDL後、同ディレクトリに置く

　Google Analytics API class for PHP | Ask About PHP

　下記サンプルコード：ダウンロード　gaapisample.zip

<?PHP

//言語や内部エンコーディングを指定
mb_language("japanese");
mb_internal_encoding("UTF-8");

//ライブラリ読み込み
include('googleanalytics.class.php');

//アカウント設定　例：プロファイルはga:9999999と表記
$ga = new GoogleAnalytics('メールアドレス','パスワード');
$ga->setProfile('ga:プロファイルＩＤ');

//日付指定　※-1や-31を変更
$today1 = mktime(0, 0, 0, date("m"), date("d")-1,  date("Y"));
$today2 = mktime(0, 0, 0, date("m"), date("d")-31,  date("Y"));
$g1 = date("Y-m-d", $today1);
$g2 = date("Y-m-d", $today2);
$ga->setDateRange($g2,$g1);

//インスタンス生成　※ga:〜を変更。組合せによっては取得不可、sortは並べ替え項目
$report = $ga->getReport( 
array('dimensions'=>urlencode('ga:keyword'),
        'metrics'=>urlencode('ga:visits,ga:pageviews'),
        'sort'=>'-ga:pageviews'
    )
);

//表示
echo "<html><head><meta content='text/html; charset=UTF-8' http-equiv='Content-Type'/>";
echo "</head><body>";
echo "キーワード：セッション数：ページビュー数<BR>- - - - - <BR>";

foreach( $report as $d => $m ){
 echo $d;
 foreach( $m as $a => $b ){
     echo " : ".$b;
 }
 echo "<BR>";
}

echo "</body></html>";
?>

　実行結果
　

　

４．API参考リンク

　Dimensions & Metrics Reference – Google Analytics – Google Code
　公式リファレンス

　Valid Query Combinations – Google Analytics – Google Code
　ディメンション＆メトリクス公式組み合わせリスト

　Google Analytics API データ取得ツール
　フォームに入力するだけでXML取得が出来ます。

　

更新履歴

　2010/5/18　18:22　表題に「Data Export API」を追加。
　（ryownetさんご指摘、ありがとうございます！）
　2010/5/18　18:20　更新履歴を追加。
　

　

こちらの記事もオススメです

• 想定外のトラブルはコンセプトに立ち返って判断〜GoogleアナリティクスAPIエンジニア取材　　
• エクセルでGA Data Export API 一覧、作りました　　
• Google AnalyticsのCookie &パラメーター 一覧　　
• Google Analytics のAPIエクスプローラー　　
• 飲食店の位置情報、口コミ関連APIまとめ　　
• 速報！有名TwitterクライアントがGAに対応　　
• 課長の教科書　　
• 複数プロファイルをデスクトップから管理する無料ソフト　　
• 自分のGoogle Analyticsを公開できるSeeTheStats　　
• 担当者に絶対見てもらえるアクセス解析　　
• 国産のGoogle Analytics APIツールが登場　　
• 国内初！eコマースサイトにGoogle Analytics APIを実装　　
• リリース間近！API利用のエクステンション、ミツエーリンクス　　
• モダンJavaScriptを無理なく学べる5冊+3　　
• ブラウザシェア推移をAPIでグラフ化する　　
• ナビゲーション一覧で10件以上見る方法　　
• ソースコードも公開、PerlでGoogle Analytics API　　
• カグア！の最近のニュース〜APIでPV表示に対応　　
• カグアメモリ開発その２〜オートラン機能の実装　　
• ウェブルさんと対談しました　　

当ブログは平日毎日更新しています。最新情報を便利に読めるRSS購読（無料、いつでも解除可能）が便利です。以下のアイコンでご希望のアイコンをクリックして下さい！