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

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

１．ディメンション
２．メトリクス
３．サンプルソース（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 アナリティクス 4 | NRIネットコム株式会社, 神崎健太

３．Google Analytics API使用サンプル

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

＞＞Google Analytics API class for PHP | Ask About PHP

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

//言語や内部エンコーディングを指定
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　更新履歴を追加。
　

・　・　・　・　・

＞＞安っ！アマゾンで半額以下になっている食品タイムセール
セール特設ページを見る