google-analytics-api チュートリアル
google-analytics-apiを使い始める
サーチ…
備考
GoogleアナリティクスAPIを使用すると、Googleアナリティクス内のデータにアクセスできます。 Googleアナリティクスにデータを挿入する際に使用する測定プロトコルと混同しないでください。
Google Analytics APIは、servalの部分に分割されています。
GoogleアナリティクスレポートAPI
GoogleアナリティクスコアレポートAPI v3を使用すると、Googleアナリティクスのほとんどのレポートデータにアクセスできます。 Core Reporting APIを使用すると、次のことが可能になります。
- Googleアナリティクスのデータを表示するカスタムダッシュボードを作成します。
- 複雑なレポート作成タスクを自動化することで、時間を節約できます。
- Googleアナリティクスのデータを他のビジネスアプリケーションと統合します。
- Googleアナリティクスのデータを表示するカスタムダッシュボードを作成します。
GoogleアナリティクスレポートAPI V4は、Googleアナリティクスのレポートデータにアクセスするための最も高度なプログラム的な方法です。 Google Analytics Reporting APIを使用すると、次のことができます。
- Googleアナリティクスのデータを表示するカスタムダッシュボードを作成します。
- 複雑なレポート作成タスクを自動化することで、時間を節約できます。
- Googleアナリティクスのデータを他のビジネスアプリケーションと統合します。
- Googleアナリティクスのデータを表示するカスタムダッシュボードを作成します。
リアルタイムレポートAPIを使用すると、認証されたユーザーのリアルタイムデータ(ビューのリアルタイムアクティビティなど)を要求できます。 Real Time Reporting APIを使用すると、次のことができます。
- 有限の在庫を持つアイテムを見ているユーザーにとって、ページのアクティブな視聴者を表示し、緊急性を感じる。
- 上位10個のアクティブなページなどの最も人気のあるコンテンツを表示します。
- リアルタイムダッシュボードを作成して表示します。
- 有限の在庫を持つアイテムを見ているユーザーにとって、ページのアクティブな視聴者を表示し、緊急性を感じる。
制限付きベータ版のリアルタイムレポートAPIは、開発者向けのプレビューのみで利用できます。 登録してAPIにアクセスします。
マルチチャネルレポートAPIを使用すると、認証されたユーザーのマルチチャネルデータをリクエストできます。データはコンバージョン経路データから導出されます。コンバージョン経路データは、コンバージョンに至るまでの複数セッションにわたるさまざまなトラフィックソースとのユーザーインタラクションを示します。これにより、複数のマーケティングチャネルが経時的にコンバージョンにどのように影響するかを分析することができます。利用可能なデータの詳細については、マルチチャネルの概要について、マルチチャネルの概要についてをご覧ください。マルチチャネルレポートAPIを使用すると、次のことができます。
- マルチチャネルデータを使用してカスタムレポートを作成する。たとえば、上位コンバージョン経路データを使用して、コンバージョン経路内のインタラクションの相対的な位置などの属性をレポートできます。
- マルチチャネルデータをビジネスデータと統合する。たとえば、オンラインのコンバージョンデータとオフラインのセールスデータおよびメディア費用データを関連付けることで、マーケティングROIのより完全な図を得ることができます。
- 新しい環境でマルチチャネルの目標到達プロセスを表示する。たとえば、コンバージョンを推進する際に異なるマーケティングチャネルの価値を伝える視覚化やその他のデータのプレゼンテーションを作成できます。
- マルチチャネルデータを使用してカスタムレポートを作成する。たとえば、上位コンバージョン経路データを使用して、コンバージョン経路内のインタラクションの相対的な位置などの属性をレポートできます。
ヘルパー
Metadata APIは、GoogleアナリティクスレポートAPIに公開されている列(ディメンションと指標)のリストと属性を返します。返される属性には、UI名、説明、セグメントのサポートなどが含まれます。メタデータAPIを使用すると、次のことができます。
- 新しい列を自動的に発見する。
- GoogleアナリティクスのレポートAPIのすべてのディメンションと指標の属性にアクセスします。
- 新しい列を自動的に発見する。
注:これは、Core Reporting APIおよびReporting APIのメタデータのみを返します。リアルタイムメタデータではありません。
- Googleアナリティクスの埋め込みAPIは、数分でサードパーティのウェブサイトに簡単にダッシュボードを作成して埋め込むことができるJavaScriptライブラリです。これは、複雑なツールを構築するために一緒に働くプラグイン可能なコンポーネントのセットを提供し、同時に簡単で強力なものにします。
構成API
Analytics Management APIを使用すると、Googleアナリティクスの設定データにプログラムでアクセスできます。大規模または複雑なAnalyticsアカウントをより効率的に管理するためのアプリケーションを構築できます。多くのプロパティを持つ大企業は、アカウント設定を自動化できます。レポートアプリケーションを構築している場合でも、管理APIはアカウントをナビゲートするためのツールを提供します。 Googleアナリティクス管理APIを使用すると、次のことができます。
- ユーザーのすべてのアカウント、プロパティ、および表示情報を一覧表示します。
- プロパティ、ビュー、および目標を管理する。
- アカウント階層のユーザー権限を管理します。
- Core Reporting APIで使用するビューIDを取得します。
- どの目標がアクティブであるかを判断し、設定された名前にアクセスします。
- アナリティクスのプロパティとAdWordsアカウントのリンクを管理します。
- リマーケティングユーザーを管理する。
- ユーザーのすべてのアカウント、プロパティ、および表示情報を一覧表示します。
Webプロパティ、View(プロファイル)、およびGoalリソースの管理API(作成、更新、削除、パッチなど)の書き込み操作は、現在、 限定ベータ版の開発者プレビューとして利用できます。これらの機能の使用に興味がある場合は、ベータ版へのアクセスをリクエストしてください 。
- プロビジョニングAPIを使用すると、新しいGoogleアナリティクスアカウントを作成し、顧客の規模に合わせてGoogleアナリティクスを有効にすることができます。資格のあるサービスプロバイダや大規模なパートナーを対象としています。たとえば、新しいユーザーオンボーディングプロセスの一部としてプロビジョニングAPIを使用して、クライアント用の新しいGoogleアナリティクスアカウントを作成し、追加の管理APIリソースを使用してプログラムでアカウントを設定し、AdWordsにリンクすることができます。これは、すべて自分の管理インターフェースまたはレポートインターフェースから自動化して開始することができます。
プロビジョニングAPIは招待状のみで利用可能です。現在新しいプロジェクトは受け付けていません。
バージョン
現在、GoogleアナリティクスAPIの3つのバージョンが公開されています。
Core Reporting APIのGoogle Analytics V2バージョン2.4は、ほとんどがバージョン2.3と後方互換性があるXML専用APIです。 (レガシー)
Core Reporting API、管理API、MetaData API、その他多数のAPIを含むGoogle Analytics V3 。これらのAPIはJsonを返します。
GoogleアナリティクスV4は、現在のところレポートAPIのみを備えており、Googleアナリティクスからレポートデータを取得する最も高度な方法と考えられています。
GoogleアナリティクスAPIへのアクセス
HTTP PostまたはHTTP Getリクエストを処理できるプログラミング言語を使用して、GoogleアナリティクスAPIに技術的にアクセスできます。
つまり、Googleはこれを手助けする多数の公式標準クライアントライブラリを作成しています。選択したプログラミング言語に標準のクライアントライブラリを使用することは、自分で開発するよりはるかに簡単です。
OFFICAL Google Analytics APIをサポートするクライアントライブラリ:
- Google API PHPクライアントライブラリ - GitHub
- Google API .Netクライアントライブラリ - GitHub NuGet
- Google API Pythonクライアントライブラリ - GitHub
- Google API Javaクライアントライブラリ - リンク
- Google API Objective-Cライブラリ - GitHub
ここにはさらにライブラリがあります 。
前書き
GoogleアナリティクスAPIを使用すると、Googleアナリティクス内のデータにアクセスできます。 Googleアナリティクスにデータを挿入する際に使用する測定プロトコルと混同しないでください。
Google Analytics APIは、servalの部分に分割されています。
GoogleアナリティクスレポートAPI
GoogleアナリティクスコアレポートAPI v3を使用すると、Googleアナリティクスのほとんどのレポートデータにアクセスできます。 Core Reporting APIを使用すると、次のことが可能になります。
- Googleアナリティクスのデータを表示するカスタムダッシュボードを作成します。
- 複雑なレポート作成タスクを自動化することで、時間を節約できます。
- Googleアナリティクスのデータを他のビジネスアプリケーションと統合します。
- Googleアナリティクスのデータを表示するカスタムダッシュボードを作成します。
GoogleアナリティクスレポートAPI V4は、Googleアナリティクスのレポートデータにアクセスするための最も高度なプログラム的な方法です。 Google Analytics Reporting APIを使用すると、次のことができます。
- Googleアナリティクスのデータを表示するカスタムダッシュボードを作成します。
- 複雑なレポート作成タスクを自動化することで、時間を節約できます。
- Googleアナリティクスのデータを他のビジネスアプリケーションと統合します。
- Googleアナリティクスのデータを表示するカスタムダッシュボードを作成します。
リアルタイムレポートAPIを使用すると、認証されたユーザーのリアルタイムデータ(ビューのリアルタイムアクティビティなど)を要求できます。 Real Time Reporting APIを使用すると、次のことができます。
- 有限の在庫を持つアイテムを見ているユーザーにとって、ページのアクティブな視聴者を表示し、緊急性を感じる。
- 上位10個のアクティブなページなどの最も人気のあるコンテンツを表示します。
- リアルタイムダッシュボードを作成して表示します。
- 有限の在庫を持つアイテムを見ているユーザーにとって、ページのアクティブな視聴者を表示し、緊急性を感じる。
制限付きベータ版のリアルタイムレポートAPIは、開発者向けのプレビューのみで利用できます。 登録してAPIにアクセスします。
マルチチャネルレポートAPIを使用すると、認証されたユーザーのマルチチャネルデータをリクエストできます。データはコンバージョン経路データから導出されます。コンバージョン経路データは、コンバージョンに至るまでの複数セッションにわたるさまざまなトラフィックソースとのユーザーインタラクションを示します。これにより、複数のマーケティングチャネルが経時的にコンバージョンにどのように影響するかを分析することができます。利用可能なデータの詳細については、マルチチャネルの概要について、マルチチャネルの概要についてをご覧ください。マルチチャネルレポートAPIを使用すると、次のことができます。
- マルチチャネルデータを使用してカスタムレポートを作成する。たとえば、上位コンバージョン経路データを使用して、コンバージョン経路内のインタラクションの相対的な位置などの属性をレポートできます。
- マルチチャネルデータをビジネスデータと統合する。たとえば、オンラインのコンバージョンデータとオフラインのセールスデータおよびメディア費用データを関連付けることで、マーケティングROIのより完全な図を得ることができます。
- 新しい環境でマルチチャネルの目標到達プロセスを表示する。たとえば、コンバージョンを推進する際に異なるマーケティングチャネルの価値を伝える視覚化やその他のデータのプレゼンテーションを作成できます。
- マルチチャネルデータを使用してカスタムレポートを作成する。たとえば、上位コンバージョン経路データを使用して、コンバージョン経路内のインタラクションの相対的な位置などの属性をレポートできます。
ヘルパー
Metadata APIは、GoogleアナリティクスレポートAPIに公開されている列(ディメンションと指標)のリストと属性を返します。返される属性には、UI名、説明、セグメントのサポートなどが含まれます。メタデータAPIを使用すると、次のことができます。
- 新しい列を自動的に発見する。
- GoogleアナリティクスのレポートAPIのすべてのディメンションと指標の属性にアクセスします。
- 新しい列を自動的に発見する。
注:これは、Core Reporting APIおよびReporting APIのメタデータのみを返します。リアルタイムメタデータではありません。
- Googleアナリティクスの埋め込みAPIは、数分でサードパーティのウェブサイトに簡単にダッシュボードを作成して埋め込むことができるJavaScriptライブラリです。これは、複雑なツールを構築するために一緒に働くプラグイン可能なコンポーネントのセットを提供し、同時に簡単で強力なものにします。
構成API
Analytics Management APIを使用すると、Googleアナリティクスの設定データにプログラムでアクセスできます。大規模または複雑なAnalyticsアカウントをより効率的に管理するためのアプリケーションを構築できます。多くのプロパティを持つ大企業は、アカウント設定を自動化できます。レポートアプリケーションを構築している場合でも、管理APIはアカウントをナビゲートするためのツールを提供します。 Googleアナリティクス管理APIを使用すると、次のことができます。
- ユーザーのすべてのアカウント、プロパティ、および表示情報を一覧表示します。
- プロパティ、ビュー、および目標を管理する。
- アカウント階層のユーザー権限を管理します。
- Core Reporting APIで使用するビューIDを取得します。
- どの目標がアクティブであるかを判断し、設定された名前にアクセスします。
- アナリティクスのプロパティとAdWordsアカウントのリンクを管理します。
- リマーケティングユーザーを管理する。
- ユーザーのすべてのアカウント、プロパティ、および表示情報を一覧表示します。
Webプロパティ、View(プロファイル)、およびGoalリソースの管理API(作成、更新、削除、パッチなど)の書き込み操作は、現在、 限定ベータ版の開発者プレビューとして利用できます。これらの機能の使用に興味がある場合は、ベータ版へのアクセスをリクエストしてください 。
- プロビジョニングAPIを使用すると、新しいGoogleアナリティクスアカウントを作成し、顧客の規模に合わせてGoogleアナリティクスを有効にすることができます。資格のあるサービスプロバイダや大規模なパートナーを対象としています。たとえば、新しいユーザーオンボーディングプロセスの一部としてプロビジョニングAPIを使用して、クライアント用の新しいGoogleアナリティクスアカウントを作成し、追加の管理APIリソースを使用してプログラムでアカウントを設定し、AdWordsにリンクすることができます。これは、すべて自分の管理インターフェースまたはレポートインターフェースから自動化して開始することができます。
プロビジョニングAPIは招待状のみで利用可能です。現在新しいプロジェクトは受け付けていません。
Hello World Reporting API - 残り
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet?access_token={Access token from auth request}
{
"reportRequests":[
{
"viewId":"XXXX",
"dateRanges":[
{
"startDate":"2015-06-15",
"endDate":"2015-06-30"
}],
"metrics":[
{
"expression":"ga:sessions"
}],
"dimensions": [
{
"name":"ga:browser"
}]
}]
}