Google アナリティクス API の公式発表を受け取るには、Google Analytics API Notify Group に登録してください。
2026-09-14 v1 alpha に会話型クエリのサポートを追加しました
自然言語クエリを使用して Google アナリティクス データを操作するための properties.chat メソッドを追加しました。
- リクエスト本文は、クエリ、前の会話を続行するためのオプションのセッション ID、オプションの
returnPropertyQuotaパラメータを受け入れます。 - レスポンスは、
ResponseBlockオブジェクト、セッション ID、プロパティ トークン割り当ての詳細(リクエストされた場合)をPropertyChatQuotaを使用して、構造化されたチャット レスポンス データを返します。 https://www.googleapis.com/auth/analytics.chatbot.readOAuth スコープは、properties.chatメソッドへの読み取りアクセス権を付与します。
2026-09-14 レポート レスポンスにデータ切り捨ての理由を追加
dataTruncationReasons フィールドを v1 ベータ版と v1 アルファ版の ResponseMetaData に追加しました。レポートのデータが切り捨てられると、このフィールドには、切り捨てタイプ、説明メッセージ、影響を受ける日付を含む DataTruncationReason オブジェクトのリストが含まれます。
2026-04-23 v1 アルファ版でコンバージョン レポートのサポートを追加
Data API v1 アルファ版の runReport メソッドを使用して、コンバージョン パフォーマンス レポートからデータを取得する機能を追加しました。これにより、Google アナリティクス管理画面の [広告] > [コンバージョン パフォーマンス] で利用可能な同じコンバージョン データにアクセスできます。
ConversionSpecフィールドをRunReportRequestに追加しました。これにより、conversionActions(コンバージョン アクション ID)を使用してコンバージョンをフィルタし、AttributionModel(DATA_DRIVENまたはLAST_CLICK)を選択できます。ResponseMetaDataにSectionフィールドを追加し、レポートのデータが標準レポート(SECTION_REPORT)とコンバージョン レポート(SECTION_ADVERTISING)のどちらから取得されたものかを識別できるようにしました。
Data API v1 アルファ版の getMetadata メソッドを更新し、コンバージョン レポートの情報を提供できるようにしました。
conversionsフィールドをレスポンスに追加しました。これにより、コンバージョン アクション ID を表示名にマッピングするConversionMetadataオブジェクトのリストが返されます。DimensionMetadataとMetricMetadataにsectionsフィールドを追加し、特定のフィールドが標準レポート、コンバージョン レポート、またはその両方に対応しているかどうかを識別できるようにしました。
2024-10-20 EmptyFilter ディメンション フィルタタイプを追加しました
EmptyFilter ディメンション フィルタを使用すると、空白の値と比較するフィルタ条件を作成できます。
reportTasks メソッドにサンプリング レベル機能を追加しました(2024 年 10 月 15 日)。
properties.runReportTask メソッドの samplingLevel フィールドを使用すると、レポートのサンプリング レベルを制御できます。
この機能により、Google アナリティクス 360 プロパティでは、サンプリング上限が 10 億イベントに引き上げられます。また、イベント数の多い非サンプリング結果に対して、サンプリング上限を UNSAMPLED に設定することもできます。
2024-09-18 プロパティの割り当てスナップショット機能を追加しました
properties.getPropertyQuotasSnapshot メソッドを使用すると、特定のプロパティのすべてのプロパティ割り当ての現在のスナップショットを、割り当てカテゴリ別に整理して取得できます。
2024 年 6 月 28 日 「同一プロジェクト・同一プロパティでのクライアント エラー数」クォータを追加しました。
15 分間にプロジェクトごと、プロパティごとに許容される API サーバーエラーの上限が 10,000 件になりました。これには、500 または 200 以外のコードを含むレスポンスを返すリクエストがすべて含まれます。この割り当てに該当するエラーの例としては、互換性のないディメンションと指標の組み合わせの使用、すべての認証エラーなどがあります。
この上限を超えると、15 分間のウィンドウが終了するまで、関連付けられた Google Cloud プロジェクトのそのプロパティに対する API 呼び出しが一時的にブロックされます。
2024-05-14 比較機能を追加
比較を使用すると、データのサブセットを並べて評価できます。
Data API v1beta のコア レポート メソッドが更新され、comparisons フィールドがサポートされるようになりました。このフィールドを指定すると、リクエストされた比較の構成が指定されます。
リクエストでは、リクエストに dimensionFilter 式を指定して基本的な比較を指定するか、comparison フィールドに比較のリソース名を指定して保存済みの比較を使用できます。
getMetadata メソッドが更新され、プロパティで使用可能な保存済みの比較がすべて comparisons レスポンス フィールドに一覧表示されるようになりました。
リクエストで 1 つ以上の比較が指定されている場合、レスポンスには各比較を識別する comparison 列が含まれます。
現在、保存済みの比較は Google アナリティクスの管理画面でのみ作成できます。
2024-05-08 Data API v1alpha に、非同期レポート機能であるレポートタスクを追加しました。
レポートタスクを使用すると、長時間実行される非同期リクエストを開始して、Google アナリティクスのイベントデータのカスタム レポートを作成できます。
Data API v1alpha に、次のレポートタスク操作メソッドが追加されました。
- properties.reportTasks.create
- properties.reportTasks.get
- properties.reportTasks.list
- properties.reportTasks.query
2024 年 5 月 6 日 キーイベントの新しいディメンション
キーイベントのディメンションと指標が利用可能になりました。
isConversionEvent ディメンションを使用するレポート リクエストを、代わりに isKeyEvent ディメンションを使用するように変更します。
次の表の非推奨の指標を使用するレポート リクエストを、代わりにキーイベント指標を使用するように変更します。
| サポートが終了した指標 | キーイベントの指標 |
|---|---|
advertiserAdCostPerConversion |
advertiserAdCostPerKeyEvent |
conversions |
keyEvents |
firstTimePurchaserConversionRate |
firstTimePurchaserRate |
purchaserConversionRate |
purchaserRate |
sessionConversionRate |
sessionKeyEventRate |
userConversionRate |
userKeyEventRate |
レポート リクエストで 1 つのキーイベントのキーイベント指標を使用している場合は、同様の変更を行います。
properties/getMetadata メソッドのレスポンスには、DimensionMetadata オブジェクトと MetricMetadata オブジェクトにキーイベントのディメンションと指標が導入されたことが反映されます。
apiName、uiName、descriptionには、キーイベントの API 名、UI 名、説明が含まれます。deprecatedApiNames繰り返しフィールドに、非推奨の変換 API 名のエントリがあります。
2024-03-25 メインのチャネル グループ、手動トラフィック ソース、統合固有のディメンションを追加しました。
メインのチャネル グループ、手動トラフィック ソース、CM360、ディスプレイ&ビデオ 360、検索広告 360 の統合固有のディメンションが Data API API スキーマに追加されました。
オーディエンス ディメンション:
audienceIdオーディエンス ID。オーディエンスの数値識別子。
メインのチャネル グループのディメンション:
firstUserPrimaryChannelGroupユーザーの最初のメインのチャネル グループprimaryChannelGroupメインのチャネル グループsessionPrimaryChannelGroupセッションのメインのチャネル グループ
手動トラフィック ソース ディメンション:
manualCampaignId手動キャンペーン IDmanualCampaignName手動キャンペーン名manualCreativeFormat手動のクリエイティブ フォーマットmanualMarketingTactic手動マーケティング戦術manualMedium手動のメディアmanualSource手動の参照元manualSourceMedium手動参照元 / メディアmanualSourcePlatform手動参照元プラットフォームfirstUserManualCampaignIdユーザーの最初の手動キャンペーンの IDfirstUserManualCampaignNameユーザーの最初の手動キャンペーン名firstUserManualCreativeFormatユーザーの最初の手動のクリエイティブ フォーマットfirstUserManualMarketingTacticユーザーの最初の手動マーケティング戦術firstUserManualMediumユーザーの最初の手動のメディアfirstUserManualSourceユーザーの最初の手動の参照元firstUserManualSourceMediumユーザーの最初の手動の参照元 / メディアfirstUserManualSourcePlatformユーザーの最初の手動参照元プラットフォームsessionManualCampaignIdセッションの手動キャンペーン IDsessionManualCampaignNameセッションの手動キャンペーン名sessionManualCreativeFormatセッションの手動クリエイティブ フォーマットsessionManualMarketingTacticセッションの手動マーケティング戦術sessionManualMediumセッションの手動メディアsessionManualSourceセッションの手動参照元sessionManualSourceMediumセッションの手動参照元 / メディアsessionManualSourcePlatformセッションの手動参照元プラットフォーム
キャンペーン マネージャー 360(CM360)の統合ディメンション:
cm360AccountIdCM360 アカウント IDcm360AccountNameCM360 アカウント名cm360AdvertiserIdCM360 広告主 IDcm360AdvertiserNameCM360 広告主名cm360CampaignIdCM360 キャンペーン IDcm360CampaignNameCM360 キャンペーン名cm360CreativeFormatCM360 クリエイティブ フォーマットcm360CreativeIdCM360 クリエイティブ IDcm360CreativeNameCM360 クリエイティブ名cm360CreativeTypeCM360 クリエイティブ タイプcm360CreativeTypeIdCM360 クリエイティブ タイプ IDcm360CreativeVersionCM360 クリエイティブ バージョンcm360MediumCM360 メディアcm360PlacementCostStructureCM360 プレースメントの課金形態cm360PlacementIdCM360 プレースメント IDcm360PlacementNameCM360 プレースメント名cm360RenderingIdCM360 レンダリング IDcm360SiteIdCM360 サイト IDcm360SiteNameCM360 サイト名cm360SourceCM360 参照元cm360SourceMediumCM360 参照元 / メディアfirstUserCm360AccountIdユーザーの最初の CM360 アカウント IDfirstUserCm360AccountNameユーザーの最初の CM360 アカウント名firstUserCm360AdvertiserIdユーザーの最初の CM360 広告主 IDfirstUserCm360AdvertiserNameユーザーの最初の CM360 広告主名firstUserCm360CampaignIdユーザーの最初の CM360 キャンペーン IDfirstUserCm360CampaignNameユーザーの最初の CM360 キャンペーン名firstUserCm360CreativeFormatユーザーの最初の CM360 クリエイティブ フォーマットfirstUserCm360CreativeIdユーザーの最初の CM360 クリエイティブ IDfirstUserCm360CreativeNameユーザーの最初の CM360 クリエイティブ名firstUserCm360CreativeTypeユーザーの最初の CM360 クリエイティブ タイプfirstUserCm360CreativeTypeIdユーザーの最初の CM360 クリエイティブ タイプ IDfirstUserCm360CreativeVersionユーザーの最初の CM360 クリエイティブ バージョンfirstUserCm360Mediumユーザーの最初の CM360 メディアfirstUserCm360PlacementCostStructureユーザーの最初の CM360 プレースメントの課金形態firstUserCm360PlacementIdユーザーの最初の CM360 プレースメント IDfirstUserCm360PlacementNameユーザーの最初の CM360 プレースメント名firstUserCm360RenderingIdユーザーの最初の CM360 レンダリング IDfirstUserCm360SiteIdユーザーの最初の CM360 サイト IDfirstUserCm360SiteNameユーザーの最初の CM360 サイト名firstUserCm360Sourceユーザーの最初の CM360 ソースfirstUserCm360SourceMediumユーザーの最初の CM360 参照元 / メディアsessionCm360AccountIdセッションの CM360 アカウント IDsessionCm360AccountNameセッションの CM360 アカウント名sessionCm360AdvertiserIdセッションの CM360 広告主 IDsessionCm360AdvertiserNameセッションの CM360 広告主名sessionCm360CampaignIdセッションの CM360 キャンペーン IDsessionCm360CampaignNameセッションの CM360 キャンペーン名sessionCm360CreativeFormatセッションの CM360 クリエイティブ フォーマットsessionCm360CreativeIdセッションの CM360 クリエイティブ IDsessionCm360CreativeNameセッションの CM360 クリエイティブ名sessionCm360CreativeTypeセッションの CM360 クリエイティブ タイプsessionCm360CreativeTypeIdセッションの CM360 クリエイティブ タイプ IDsessionCm360CreativeVersionセッションの CM360 クリエイティブ バージョンsessionCm360Mediumセッションの CM360 メディアsessionCm360PlacementCostStructureセッションの CM360 プレースメントの課金形態sessionCm360PlacementIdセッションの CM360 プレースメント IDsessionCm360PlacementNameセッションの CM360 プレースメント名sessionCm360RenderingIdセッションの CM360 レンダリング IDsessionCm360SiteIdセッションの CM360 サイト IDsessionCm360SiteNameセッションの CM360 サイト名sessionCm360Sourceセッションの CM360 参照元sessionCm360SourceMediumセッションの CM360 参照元 / メディア
Google ディスプレイ&ビデオ 360(DV360)の統合ディメンション:
dv360AdvertiserIdディスプレイ&ビデオ 360 広告主 IDdv360AdvertiserNameディスプレイ&ビデオ 360 広告主名dv360CampaignIdディスプレイ&ビデオ 360 キャンペーン IDdv360CampaignNameディスプレイ&ビデオ 360 キャンペーン名dv360CreativeFormatディスプレイ&ビデオ 360 クリエイティブ フォーマットdv360CreativeIdディスプレイ&ビデオ 360 クリエイティブ IDdv360CreativeNameディスプレイ&ビデオ 360 クリエイティブ名dv360ExchangeIdディスプレイ&ビデオ 360 エクスチェンジ IDdv360ExchangeNameディスプレイ&ビデオ 360 エクスチェンジ名dv360InsertionOrderIdディスプレイ&ビデオ 360 広告掲載オーダー IDdv360InsertionOrderNameディスプレイ&ビデオ 360 広告掲載オーダー名dv360LineItemIdディスプレイ&ビデオ 360 項目 IDdv360LineItemNameディスプレイ&ビデオ 360 広告申込情報名dv360Mediumディスプレイ&ビデオ 360 メディアdv360PartnerIdディスプレイ&ビデオ 360 パートナー IDdv360PartnerNameディスプレイ&ビデオ 360 パートナー名dv360Sourceディスプレイ&ビデオ 360 参照元dv360SourceMediumディスプレイ&ビデオ 360 参照元 / メディアfirstUserDv360AdvertiserIdユーザーの最初のディスプレイ&ビデオ 360 広告主 IDfirstUserDv360AdvertiserNameユーザーの最初のディスプレイ&ビデオ 360 広告主名firstUserDv360CampaignIdユーザーの最初のディスプレイ&ビデオ 360 キャンペーン IDfirstUserDv360CampaignNameユーザーの最初のディスプレイ&ビデオ 360 キャンペーン名firstUserDv360CreativeFormatユーザーの最初のディスプレイ&ビデオ 360 クリエイティブ フォーマットfirstUserDv360CreativeIdユーザーの最初のディスプレイ&ビデオ 360 クリエイティブ IDfirstUserDv360CreativeNameユーザーの最初のディスプレイ&ビデオ 360 クリエイティブ名firstUserDv360ExchangeIdユーザーの最初のディスプレイ&ビデオ 360 エクスチェンジ IDfirstUserDv360ExchangeNameユーザーの最初のディスプレイ&ビデオ 360 エクスチェンジ名firstUserDv360InsertionOrderIdユーザーの最初のディスプレイ&ビデオ 360 広告掲載オーダー IDfirstUserDv360InsertionOrderNameユーザーの最初のディスプレイ&ビデオ 360 広告掲載オーダー名firstUserDv360LineItemIdユーザーの最初のディスプレイ&ビデオ 360 項目 IDfirstUserDv360LinteItemNameユーザーの最初のディスプレイ&ビデオ 360 広告申込情報名firstUserDv360Mediumユーザーの最初のディスプレイ&ビデオ 360 メディアfirstUserDv360PartnerIdユーザーの最初のディスプレイ&ビデオ 360 パートナー IDfirstUserDv360PartnerNameユーザーの最初のディスプレイ&ビデオ 360 パートナー名firstUserDv360Sourceユーザーの最初のディスプレイ&ビデオ 360 参照元firstUserDv360SourceMediumユーザーの最初のディスプレイ&ビデオ 360 参照元 / メディアsessionDv360AdvertiserIdセッションのディスプレイ&ビデオ 360 広告主 IDsessionDv360AdvertiserNameセッションのディスプレイ&ビデオ 360 広告主名sessionDv360CampaignIdセッションのディスプレイ&ビデオ 360 キャンペーン IDsessionDv360CampaignNameセッションのディスプレイ&ビデオ 360 キャンペーン名sessionDv360CreativeFormatセッションのディスプレイ&ビデオ 360 クリエイティブ フォーマットsessionDv360CreativeIdセッションのディスプレイ&ビデオ 360 クリエイティブ IDsessionDv360CreativeNameセッションのディスプレイ&ビデオ 360 クリエイティブ名sessionDv360ExchangeIdセッションのディスプレイ&ビデオ 360 エクスチェンジ IDsessionDv360ExchangeNameセッションのディスプレイ&ビデオ 360 エクスチェンジ名sessionDv360InsertionOrderIdセッションのディスプレイ&ビデオ 360 広告掲載オーダー IDsessionDv360InsertionOrderNameセッションのディスプレイ&ビデオ 360 広告掲載オーダー名sessionDv360LineItemIdセッションのディスプレイ&ビデオ 360 項目 IDsessionDv360LineItemNameセッションのディスプレイ&ビデオ 360 広告申込情報名sessionDv360Mediumセッションのディスプレイ&ビデオ 360 メディアsessionDv360PartnerIdセッションのディスプレイ&ビデオ 360 パートナー IDsessionDv360PartnerNameセッションのディスプレイ&ビデオ 360 パートナー名sessionDv360Sourceセッションのディスプレイ&ビデオ 360 参照元sessionDv360SourceMediumセッションのディスプレイ&ビデオ 360 参照元 / メディア
Google 検索広告 360(SA360)の統合ディメンション:
firstUserSa360AdGroupIdユーザーの最初の検索広告 360 広告グループ IDfirstUserSa360AdGroupNameユーザーの最初の SA360 広告グループ名firstUserSa360CampaignIdユーザーの最初の検索広告 360 キャンペーン IDfirstUserSa360CampaignNameユーザーの最初の検索広告 360 キャンペーンfirstUserSa360CreativeFormatユーザーの最初の SA360 クリエイティブ フォーマットfirstUserSa360EngineAccountIdユーザーの最初の SA360 エンジン アカウント IDfirstUserSa360EngineAccountNameユーザーの最初の SA360 エンジン アカウント名firstUserSa360EngineAccountTypeユーザーの最初の SA360 エンジン アカウントの種類firstUserSa360KeywordTextユーザーの最初の SA360 のキーワード テキストfirstUserSa360ManagerAccountIdユーザーの最初の 検索広告 360 MCC アカウント IDfirstUserSa360ManagerAccountNameユーザーの最初の検索広告 360 マネージャー アカウント名firstUserSa360Mediumユーザーの最初の SA360 のメディアfirstUserSa360Queryユーザーの最初の SA360 のクエリfirstUserSa360Sourceユーザーの最初の SA360 の参照元firstUserSa360SourceMediumユーザーの最初の検索広告 360 参照元 / メディアsa360AdGroupId検索広告 360 広告グループ IDsa360CampaignIdSA360 キャンペーン IDsa360AdGroupNameSA360 広告グループ名sa360CampaignNameSA360 キャンペーンsa360CreativeFormatSA360 クリエイティブ フォーマットsa360EngineAccountIdSA360 エンジン アカウント IDsa360EngineAccountNameSA360 エンジン アカウント名sa360EngineAccountTypeSA360 エンジン アカウントの種類sa360KeywordTextSA360 のキーワード テキストsa360ManagerAccountId検索広告 360 MCC アカウント IDsa360ManagerAccountName検索広告 360 マネージャー アカウント名sa360Medium検索広告 360 メディアsa360Query検索広告 360 のクエリsa360SourceSA360 の参照元sa360SourceMedium検索広告 360 の参照元 / メディアsessionSa360AdGroupIdセッション: 検索広告 360 広告グループ IDsessionSa360CampaignIdセッションの SA360 キャンペーン IDsessionSa360ManagerAccountIdセッション: 検索広告 360 MCC アカウント IDsessionSa360ManagerAccountNameセッション: 検索広告 360 MCC アカウント名sessionSa360SourceMediumセッション: 検索広告 360 参照元 / メディア
2024 年 3 月 6 日 オーディエンスのエクスポートで、非アクティブ ユーザーのオーディエンスがサポートされるようになりました。
オーディエンス エクスポート機能は、非アクティブ ユーザーのオーディエンスのエクスポートをより適切にサポートします。ユーザーは、条件を満たすイベントがなくても、これらのオーディエンスに登録されます。たとえば、ユーザーが 7 日間ウェブサイトにアクセスしなかった場合、オーディエンスに登録されます。非アクティブ ユーザーのオーディエンスの例としては、「7 日間の非アクティブ購入者」、「7 日間の非アクティブ ユーザー」、「7 日間の未通知のユーザー」などがあります。これらのオーディエンスの候補について詳しくは、オーディエンスの候補をご覧ください。
2024-02-28 オーディエンス エクスポートで、タグ設定で指定されたユーザー ID が返されるようになりました。
オーディエンス エクスポートで、プロパティでユーザー提供データが有効になっている場合でも、タグ設定で指定されたユーザー ID が返されるようになりました。ユーザー提供データの収集が有効になっている場合、ユーザー提供データと User-ID をタグ設定で Google アナリティクスに送信して、測定の精度を高めることができます。詳しくは、ユーザー提供データの収集をご覧ください。
2024-01-30 Data API v1 alpha で、オーディエンス リスト、定期的なオーディエンス リストの Webhook 通知がサポートされるようになりました。
AudienceList.webhookNotification フィールドと RecurringAudienceList.webhookNotification フィールドは、オーディエンス リスト(properties.audienceLists.create を使用)または定期的なオーディエンス リスト(properties.recurringAudienceLists.create を使用)の作成時に指定できます。
この機能を使用すると、オーディエンス リストが利用可能になったときに Webhook 通知を非同期で受信できます。
2024-01-18 クエリ文字列または分コンポーネントを含むディメンションの互換性を改善しました。
クエリ文字列を含むディメンションが、ほとんどのフィールドと互換性を持つようになりました。pagePathPlusQueryString、unifiedPageScreen、pageLocation、fullPageUrl などのディメンションが、sessionSource、browser、city、landingPage などの多くの追加フィールドに対応するようになりました。
分コンポーネントを含むディメンションが、ほとんどのフィールドに対応するようになりました。minute、nthMinute、dateHourMinute などのディメンションは、同様の追加フィールドのセットと互換性を持つようになりました。
互換性に関する包括的な情報については、GA4 のディメンションと指標のリファレンスをご覧ください。
2023-12-13 カスタム アイテム スコープ パラメータ
アイテム スコープのカスタム ディメンションを、次の構文を使用して Analytics Data API クエリに含めることができるようになりました。
| 一般的な API 名 | 説明 |
|---|---|
| customItem:parameter_name | parameter_name のアイテム スコープのカスタム ディメンション |
詳細については、API のディメンションと指標をご覧ください。
2023 年 12 月 5 日 Data API v1 ベータ版で、オーディエンス リストをオーディエンス エクスポートとして利用できるようになりました
オーディエンス リスト機能の名前がオーディエンス エクスポートに変更され、Data API v1 ベータ版に追加されました。
Data API v1 ベータ版に次のメソッドを追加しました。
2023-11-28 レポート レスポンスに samplingMetadatas を追加しました
samplingMetadatas を ResponseMetaData に追加しました。このコレクションには、結果がサンプリングされたリクエストの期間ごとに SampleMetadata が含まれます。Google アナリティクスでは、基数の上限によってデータ品質が低下すると予想される場合にのみ、サンプリングが適用されます。
2023 年 11 月 28 日 Data API v1 アルファ版に、オーディエンス リストの定期的なエクスポート機能を追加
Data API v1 alpha に properties.recurringAudienceLists.create、properties.recurringAudienceLists.create、properties.recurringAudienceLists.list メソッドを追加しました。
この機能を使用すると、オーディエンス メンバーシップの変更に応じて、オーディエンス リストを毎日作成できます。オーディエンス リストを繰り返し作成することで、最新のオーディエンス メンバーシップの結果を確実に使用できます。
2023-10-13 有効期間が 1 日のオーディエンスのサポートを追加
オーディエンス リストのエクスポート機能で、有効期間が 1 日のオーディエンスがサポートされるようになりました。
2023-09-12 AudienceList のデフォルトの並べ替えルール
デフォルトでは、オーディエンス リストのエクスポート機能を使用して作成されたレポートは、Data API の他のレポート方法と同じ順序ルールに従います。順序は、最初の列で降順、2 番目の列で降順などになります。
この変更前は、次のようなレポートが届いていた可能性があります。
| deviceId | isAdsPersonalizationAllowed |
|---|---|
| ABC | true |
| DAC | false |
| ABC | false |
| AAA | true |
この変更後、次のレポートが届きます。
| deviceId | isAdsPersonalizationAllowed |
|---|---|
| AAA | true |
| ABC | false |
| ABC | true |
| DAC | false |
2023 年 8 月 15 日 オーディエンス リストのエクスポート スキーマに isLimitedAdTracking ディメンションを追加しました
isLimitedAdTrackingデバイスの広告のトラッキング制限の設定です。可能な値は、true、false、(not set)などです。詳しくは、オーディエンス リストのディメンションをご覧ください。
2023-08-15 currencyCode ディメンション、itemDiscountAmount 指標を追加
currencyCodee コマース イベントの現地通貨コード(ISO 4217 規格に基づく)。(「USD」や「GBP」など)。itemDiscountAmounte コマース イベントにおける商品アイテムの金銭的価値。この指標は、タグ設定の「discount」アイテム パラメータによって入力されます。
詳しくは、Data API レポート スキーマをご覧ください。
2023 年 8 月 10 日 オーディエンス リストのエクスポート スキーマに isAdsPersonalizationAllowed ディメンションを追加しました
isAdsPersonalizationAllowed広告のパーソナライズが許可されているかどうか。ユーザーが広告のパーソナライズの対象である場合、isAdsPersonalizationAllowedはtrueを返します。ユーザーが広告のパーソナライズの対象でない場合、isAdsPersonalizationAllowedはfalseを返します。詳しくは、オーディエンス リストのディメンションをご覧ください。
2023-07-10 オーディエンス リスト
Data API v1 アルファ版にオーディエンス リストのサポートが追加されました。オーディエンス リストには、オーディエンス リストの作成時点でのオーディエンス内のユーザーのスナップショットが含まれます。
Data API v1 アルファ版に次のメソッドが追加されました。
2023-05-19 カスタム チャネル グループ
Data API にカスタム チャネル グループのサポートが追加されました。
2023-05-11 トークンの割り当ての変更。
Data API の割り当てシステムが更新され、より正確な課金が可能になりました。
各リクエストに課金されるトークン数は、割り当ての変更に合わせて更新され、単純なレポートクエリをより多く実行できるように再調整されました。一方、大規模な日付レポートでは、割り当てトークンが大幅に多く課金されます。
この変更後、一部のリクエストの料金は変わりませんが、より複雑なクエリの料金は大幅に増加します。たとえば、6 か月を超えるデータをリクエストすると、1,000 個以上の割り当てトークンが課金されることがあります。
標準プロパティ
| 割り当て名 | 古い上限 | 新しい上限 |
|---|---|---|
| 1 日あたりのプロパティごとのコアトークン数 | 25,000 | 200,000 |
| 1 プロパティ、1 時間あたりのコアトークン数 | 5,000 | 40,000 |
| 同一プロジェクト・同一プロパティで 1 時間あたりのコアトークン数 | 1,750 | 14,000 |
| 1 日あたりのプロパティごとのリアルタイム トークン数 | 25,000 | 200,000 |
| 1 プロパティ、1 時間あたりのリアルタイム トークン数 | 5,000 | 40,000 |
| 同一プロジェクト・同一プロパティで 1 時間あたりのリアルタイム トークン数 | 1,750 | 14,000 |
| 1 プロパティ、1 日あたりのファネル トークン数 | 25,000 | 200,000 |
| 同一プロパティで 1 時間あたりのファネル トークン数 | 5,000 | 40,000 |
| 同一プロジェクト・同一プロパティで 1 時間あたりのファネル トークン数 | 1,750 | 14,000 |
アナリティクス 360 プロパティ
| 割り当て名 | 古い上限 | 新しい上限 |
|---|---|---|
| プロパティごと、1 日あたりのコアトークン数 | 250,000 | 2,000,000 |
| 1 プロパティ、1 時間あたりのコアトークン数 | 50,000 | 400,000 |
| 同一プロジェクト・同一プロパティで 1 時間あたりのコアトークン数 | 17,500 | 140,000 |
| 1 日あたりのプロパティごとのリアルタイム トークン数 | 250,000 | 2,000,000 |
| 1 プロパティ、1 時間あたりのリアルタイム トークン数 | 50,000 | 400,000 |
| 同一プロジェクト・同一プロパティで 1 時間あたりのリアルタイム トークン数 | 17,500 | 140,000 |
| 1 プロパティ、1 日あたりのファネル トークン数 | 250,000 | 2,000,000 |
| 同一プロパティで 1 時間あたりのファネル トークン数 | 50,000 | 400,000 |
| 同一プロジェクト・同一プロパティで 1 時間あたりのファネル トークン数 | 17,500 | 140,000 |
2023-03-02 日付ディメンションを追加しました。
dayOfWeekName曜日名。英語の曜日。このディメンションの値はSunday、Mondayなどです。isoWeekISO 週(年間)。ISO 週番号。各週は月曜日から始まります。詳しくは、https://en.wikipedia.org/wiki/ISO_week_date をご覧ください。値の例としては、01、02、53などがあります。isoYearISO 年。イベントの ISO 年。詳しくは、https://en.wikipedia.org/wiki/ISO_week_date をご覧ください。値の例としては、2022や2023などがあります。isoYearIsoWeekISO 年の ISO 週。isoWeekとisoYearの値を組み合わせたもの。値の例としては、201652や201701などがあります。yearMonth年月。yearとmonthの値を組み合わせたもの。値の例としては、202212や202301などがあります。yearWeek年の週。yearとweekの値を組み合わせたもの。値の例としては、202253や202301などがあります。
2023-02-27 e コマース ディメンションを追加しました。
itemListPosition: アイテムリスト位置。リスト内のアイテム(販売している商品など)の位置。このディメンションは、items 配列の「index」パラメータによってタグ設定で入力されます。itemLocationIDアイテムの地域 ID。商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。このフィールドは、items 配列の「location_id」パラメータによってタグ設定で入力されます。itemPromotionCreativeSlotアイテム プロモーションのクリエイティブ スロット。商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。このディメンションは、イベント単位またはアイテム単位のcreative_slotパラメータによってタグ設定で指定できます。パラメータがイベント単位とアイテム単位の両方で指定されている場合は、アイテム単位のパラメータが使用されます。
2023-02-21 「ランディング ページ + クエリ文字列」ディメンションを追加しました。
landingPagePlusQueryStringランディング ページ + クエリ文字列。セッションの最初のページビューに関連付けられたページパス + クエリ文字列。
このフィールドは、サポートが終了した landingPage ディメンションに代わるもので、2023 年 5 月 14 日にクエリ文字列を返さないように更新されます。
2023-01-28 「ユーザーあたりのビュー」、「スクロールしたユーザー」の指標を追加しました。
screenPageViewsPerUserユーザーあたりの視聴回数。アクティブ ユーザー 1 人あたりのユーザーが閲覧したアプリの画面またはウェブページの数。同じページやスクリーンが繰り返し表示された場合も集計されます(screen_view + page_view events) / active usersscrolledUsersスクロールしたユーザー数。ページを 90% 以上スクロールしたユニーク ユーザーの数。
2023-01-23 「大陸」、「大陸 ID」ディメンションを追加しました。
continent大陸。ユーザー アクションが発生した大陸。たとえば、AmericasやAsiaです。continentId大陸 ID。ユーザー アクションが発生した大陸の地域 ID(IP アドレスから取得)。
2023-01-23 「テストデータのフィルタ ID」ディメンションを追加しました。
testDataFilterIdテストデータのフィルタ ID。テスト状態のデータフィルタの数値識別子。データフィルタを使用すると、イベント パラメータ値に基づいて、レポートのイベントデータを追加または除外できます。詳しくは、https://support.google.com/analytics/answer/10108813 をご覧ください。
2022-10-18 広告の指標を追加しました。
advertiserAdClicks広告クリック。ユーザーが広告をクリックしてプロパティにアクセスした合計回数。advertiserAdCost広告費用。広告に支払った合計金額。advertiserAdCostPerClick広告のクリック単価。広告のクリック単価は、広告費用を広告クリック数で割った値で、CPC と略されることがよくあります。advertiserAdCostPerConversionコンバージョン単価。コンバージョン単価は、広告費用をコンバージョン数で割った値です。advertiserAdImpressions件の広告インプレッション。インプレッションの合計数。returnOnAdSpend広告費用対効果。広告費用対効果(ROAS)は、総収益を広告主の広告費用で割った値です。
2022-10-17 アイテム スコープの指標を追加しました。
itemsAddedToCart個の商品をカートに追加しました。カートに追加された 1 つのアイテムのユニット数。itemsCheckedOut個のアイテムが決済されました。1 つのアイテムでチェックアウトされたユニット数。itemsClickedInListリストでクリックされたアイテム数。1 つのアイテムのリストでクリックされたユニット数。itemsClickedInPromotionプロモーションでクリックされたアイテム数。1 つのアイテムのプロモーションでクリックされたユニット数。itemsViewed: アイテムを閲覧。1 つのアイテムで閲覧されたユニット数。itemsViewedInList: リストで閲覧されたアイテム数。1 つのアイテムのリストで閲覧されたユニット数。itemsViewedInPromotionプロモーションで閲覧されたアイテム数。1 つのアイテムのプロモーションで閲覧されたユニット数。
2022-09-13 スキーマの互換性の変更に関するお知らせ。
2022 年 12 月 1 日に、以下の互換性を破る変更が行われます。
itemNameなどのアイテム スコープのディメンションは、eventCountなどのイベント スコープの指標と互換性がなくなります。商品アイテム スコープのディメンションは、商品アイテム スコープの指標(itemRevenueなど)、ユーザーベースの指標(activeUsersなど)、セッション ベースの指標(sessionsなど)と引き続き互換性があります。sourceなどのアトリビューション ディメンションは、eventCountなどの一部のイベント スコープの指標と互換性がなくなります。アトリビューション ディメンションは、conversionsなどのアトリビューション可能な指標、activeUsersなどのユーザーベースの指標、sessionsなどのセッションベースの指標と引き続き互換性があります。pagePathPlusQueryStringなどのクエリ文字列を含むディメンションは、一部のディメンションと指標にのみ対応しています。
2022-09-01 割り当ての変更。
Requests per day、Requests Per Minute、Requests Per Minute Per Userの割り当てが Data API から削除されました。Tokens Per Project Per Property Per Hour割り当てが API に追加されました。各リクエストは、
Tokens Per Property Per HourとTokens Per Project Per Property Per Hourの両方の割り当てを消費します。新しい割り当ての詳細については、割り当てのドキュメントをご覧ください。
2022-08-03 セッション スコープの検索広告 360 ディメンションを追加しました。
sessionSa360AdGroupNameセッションの SA360 広告グループ名。このセッションにつながった検索広告 360 の広告グループ名。sessionSa360CampaignNameセッションの SA360 キャンペーン。このセッションにつながった検索広告 360 のキャンペーン名。sessionSa360CreativeFormatセッションの SA360 クリエイティブ フォーマット。このセッションにつながった検索広告 360 のクリエイティブのタイプ。たとえば、「レスポンシブ検索広告」や「拡張テキスト広告」などです。sessionSa360EngineAccountIdセッションの SA360 エンジン アカウント ID。このセッションにつながった SA360 のエンジン アカウントの ID。sessionSa360EngineAccountNameセッションの SA360 エンジン アカウント名。このセッションにつながった検索広告 360 のエンジン アカウントの名前。sessionSa360EngineAccountTypeセッションの SA360 エンジン アカウントの種類。このセッションにつながった検索広告 360 のエンジン アカウントの種類。(例: 「Google 広告」、「bing」、「baidu」)。sessionSa360Keywordセッションの SA360 のキーワード テキスト。このセッションにつながった検索広告 360 の検索エンジンのキーワード。sessionSa360Mediumセッションの SA360 メディア。このセッションにつながった検索広告 360 の検索エンジンのキーワード。(例: cpc)。sessionSa360Queryセッションの SA360 クエリ。このセッションにつながった検索広告 360 の検索語句。sessionSa360Sourceセッションの SA360 参照元。このセッションにつながった検索広告 360 からのトラフィックの参照元。例: 「example.com」、「google」。sessionCampaignId、sessionCampaignNameディメンションで検索広告 360 キャンペーンがサポートされるようになりました。
2022-07-11 コンバージョン率の指標を追加しました。
コンバージョン率
sessionConversionRateコンバージョン イベントが発生したセッションの割合。userConversionRateコンバージョン イベントをトリガーしたユーザーの割合。
sessionConversionRate:event_name特定のコンバージョン イベントが発生したセッションの割合。userConversionRate:event_name特定のコンバージョン イベントをトリガーしたユーザーの割合。
2022-05-05 アルファ チャンネルにファネル レポート機能を追加しました。
runFunnelReportメソッドが API の v1alpha バージョンに追加されました。このメソッドは、Google アナリティクスのイベントデータのカスタマイズされた目標到達プロセス レポートを返します。この方法は、ベータ版に入る前に構文や機能に関するフィードバックを収集する目的で、アルファ版(安定版)で導入されています。Google Analytics Data API の目標到達プロセス レポートのフィードバックに入力して、この API についてのフィードバックをお寄せください。
2022-02-16 新しいディメンションを追加しました。
手動のキーワードとコンテンツ
firstUserManualAdContentユーザーの最初の手動広告コンテンツ。ユーザーを最初に獲得した広告コンテンツ。utm_contentパラメータによってデータが入力されます。firstUserManualTermユーザーの最初の手動キーワード。ユーザーを最初に獲得したキーワード。utm_termパラメータによってデータが入力されます。manualAdContent手動広告コンテンツ。コンバージョン イベントへの貢献度が割り当てられた広告コンテンツ。utm_contentパラメータによってデータが入力されます。manualTerm手動キーワード。コンバージョン イベントへの貢献度が割り当てられたキーワード。utm_termパラメータによってデータが入力されます。sessionManualAdContentセッションの手動広告コンテンツ。セッションにつながった広告コンテンツ。utm_contentパラメータによってデータが入力されます。sessionManualTermセッションの手動キーワード。セッションにつながったキーワード。utm_termパラメータによってデータが入力されます。
クラッシュ分析
crashAffectedUsersクラッシュの影響を受けたユーザー。レポートのこの行でクラッシュをログに記録したユーザーの数。crashFreeUsersRateクラッシュの影響を受けていないユーザーの割合。
アプリ / ウェブ
averageSessionDurationユーザー セッションの平均継続時間(秒)。newVsReturning新規ユーザー / リピーター。screenPageViewsPerSessionセッションあたりのページビュー数。landingPageランディング ページ。セッションの最初のページビューに関連付けられたページパス + クエリ文字列。platformDeviceCategoryウェブサイトまたはモバイルアプリが実行されたプラットフォームとデバイスのタイプ。
モバイルアプリ
averagePurchaseRevenuePerUserユーザーあたりの平均購入収益額。firstTimePurchaserConversionRateアクティブ ユーザーのうちの初回購入者の割合。firstTimePurchasersPerNewUser新規ユーザーあたりの初回購入者の平均数。dauPerMauDAU / MAU。30 日間のアクティブ ユーザーのうち、1 日のアクティブ ユーザーでもある割合(ローリング平均)。dauPerWauDAU / WAU。7 日間のアクティブ ユーザーのうち、1 日のアクティブ ユーザーでもある割合(ローリング平均)。wauPerMauWAU / MAU。30 日間のアクティブ ユーザーのうち、7 日間のアクティブ ユーザーでもある割合(ローリング平均)。purchaserConversionRate1 回以上の購入取引を行ったアクティブ ユーザーの割合。transactionsPerPurchaser購入者あたりのトランザクション数。
Google 広告キャンペーン
firstUserGoogleAdsCampaignTypeユーザーを最初に獲得した Google 広告キャンペーンのキャンペーン タイプ。googleAdsCampaignTypeコンバージョン イベントに貢献した Google 広告の広告キャンペーンのキャンペーン タイプ。sessionGoogleAdsCampaignTypeこのセッションにつながった Google 広告キャンペーンのキャンペーン タイプ。
2021-09-07 新しい日付 / 時刻ディメンションを追加しました。
dateHourMinute日付、時間、分を組み合わせた値(YYYYMMDDHHMM 形式)。minuteイベントがログに記録された時刻の 2 桁の分。nthMinute期間が開始してからの経過分数。
2021-09-07 イベント パラメータによって入力される新しいディメンションを追加しました。
achievementIdイベントのゲーム内の実績 ID。characterイベントのゲーム内のプレーヤー キャラクター。fileExtension: ダウンロードしたファイルの拡張子。fileName: ダウンロードしたファイルのページパス。groupIdイベントのゲーム内のプレーヤー グループ ID。linkClassesアウトバウンド リンクの HTML class 属性。linkDomainアウトバウンド リンクのリンク先ドメイン。linkIdアウトバウンド リンクまたはファイル ダウンロード用の HTML id 属性。linkTextファイル ダウンロード用のリンクテキスト。linkUrlアウトバウンド リンクまたはファイル ダウンロード用の完全な URL。methodイベントがトリガーされた方法。outboundリンク先がプロパティのドメインに含まれないサイトの場合は、「true」を返します。pageLocation訪問したウェブページのプロトコル、ホスト名、ページパス、クエリ文字列。pageReferrerホスト名とパスを含む完全な参照 URL。percentScrolledユーザーがページをスクロールした割合(例: 「90」)。searchTermユーザーが検索したキーワード。videoProvider動画のソース(「YouTube」など)。videoTitle動画のタイトル。videoUrl動画の URL。visibleコンテンツが表示されている場合は「true」を返します。unifiedPagePathScreenイベントが記録されたページパス(ウェブ)またはスクリーン クラス(アプリ)。
2021-09-07 API スキーマの変更。
既存のディメンションの変更:
unifiedPageScreenウェブで生成されたイベントの場合、このディメンションは、イベントが記録されたページパスとクエリ文字列を返すようになりました。
今後の変更に関するお知らせ:
firstUserTrafficOriginユーザーを最初に獲得したトラフィックの参照元。 UTM を使用するトラフィックに対してこのフィールドが「Manual」を返すことに依存しないでください。このフィールドは、今後の機能リリースに向けて、「Manual」を返す状態から「(not set)」を返す状態に更新されます。sessionTrafficOriginセッションのキャンペーンのトラフィックの発生元。 UTM を使用するトラフィックに対してこのフィールドが「Manual」を返すことに依存しないでください。このフィールドは、今後の機能リリースに向けて、「Manual」を返す状態から「(not set)」を返す状態に更新されます。trafficOriginコンバージョン イベントのキャンペーンのトラフィックの発生元。 UTM を使用するトラフィックに対してこのフィールドが「Manual」を返すことに依存しないでください。このフィールドは、今後の機能リリースに向けて、「Manual」を返す状態から「(not set)」を返す状態に更新されます。
2021 年 9 月 7 日 checkCompatibility メソッドが API に追加されました。
checkCompatibility メソッドは、レポート リクエストに追加して互換性を維持できるディメンションと指標を一覧表示します。
2021 年 7 月 21 日 リアルタイム レポートの変更。
runRealtimeReport メソッドの minuteRanges パラメータを使用して、読み取るイベントデータの分範囲を指定できるようになりました。
2021 年 7 月 21 日 新しいチャネル グループのディメンション。
Data API レポート スキーマに新しいチャネル グループのディメンションが追加されました。
firstUserDefaultChannelGroupingユーザーの最初のデフォルト チャネル グループ。defaultChannelGroupingデフォルト チャネル グループ。
2021-06-10 API スキーマの変更。
minutesAgoディメンションが Data API のリアルタイム スキーマに追加され、runRealtimeReportメソッドへのクエリで使用できるようになりました。このディメンションには、イベントが収集された時点から何分経過したかが含まれます。00 は現在の分、01 は前の分を意味します。googleAdsCreativeIdディメンションが Data API スキーマに追加されました。このディメンションには、コンバージョン イベントに貢献した Google 広告クリエイティブの ID が含まれます。sessionGoogleAdsCreativeIdディメンションが Data API スキーマに追加されました。このディメンションには、ウェブサイトまたはアプリでのセッションにつながった Google 広告クリエイティブの ID が含まれます。Data API スキーマで
firstUserCreativeIdディメンションの名前がfirstUserGoogleAdsCreativeIdに変更されました。このディメンションには、ユーザーを最初に獲得した Google 広告クリエイティブの ID が含まれます。
2021 年 4 月 9 日 Google Analytics Data API v1 ベータ版がリリースされました。
API エンドポイントが
https://analyticsdata.googleapis.com/v1betaに更新されました。runReport、runPivotReport、batchRunReports、batchRunPivotReportsメソッドで、リクエスト本文のentityフィールドではなく、URL パスのpropertyパラメータで Google アナリティクス 4 プロパティの ID を指定できるようになりました。POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReportsAPI クライアント ライブラリが更新され、新しい API エンドポイントが使用されるようになりました。
2021-02-19 ページ分けの変更。
デフォルトのレポート レスポンス サイズが、イベントデータの 10 行から 10,000 行に増加しました。
すべての行を取得する試みを示すために使用されていた
"limit" : -1値は、RunReportRequest でサポートされなくなりました。limitフィールドの最大値は100000に設定されています。100,000 行を超えるレポートを取得するには、ページネーションを使用します。
2021-02-08 新しい e コマースのディメンションと指標。
新しい e コマースのディメンションと指標が API スキーマに追加されました。
ディメンション: adFormat、adSourceName、adUnitName、itemBrand、itemCategory、itemCategory2、itemCategory3、itemCategory4、itemCategory5 itemId、itemListId、itemListName、itemName、itemPromotionCreativeName、itemPromotionId、itemPromotionName、orderCoupon、transactionId。
指標: adUnitExposure、addToCarts、cartToViewRate、checkouts、ecommercePurchases、firstTimePurchasers、itemListClickThroughRate、itemListClicks、itemListViews、itemPromotionClickThroughRate、itemPromotionClicks、itemPromotionViews、itemPurchaseQuantity、itemRevenue、itemViews、publisherAdClicks、publisherAdImpressions、totalPurchasers。
2021-02-08 新しいキャンペーン ディメンションを追加しました。
API スキーマに新しいキャンペーン ディメンション(campaignId、campaignName、googleAdsAccountName、googleAdsAdGroupId、googleAdsAdGroupName、googleAdsAdNetworkType、source、trafficOrigin)が追加されました。
2021-02-08 dayOfWeek、week ディメンションの変更。
dayOfWeekディメンションの値が 1 ではなく 0 から始まるようになりました。weekディメンションの値は 01 で始まり、01 ~ 53 の 2 桁の数字を返します。各週の始まりは日曜日です。1 月 1 日は常に第 1 週になります。
2021-01-28 カスタム指標の集計バリアントを追加しました。
プロパティが登録するカスタム指標ごとに、合計、平均、カウントの 3 つの API 指標バリアントが作成されます。
2021-01-28 新しい日付 / 時刻ディメンションを追加しました。
API スキーマに、hour、nthHour、nthYear、dateHour の新しいディメンションが追加されました。
2021 年 1 月 28 日 Data API で、クエリごとに課金される割り当てトークンが削減されました。
Data API で、クエリごとに課金される割り当てトークンが削減されました。1 時間あたりおよび 1 日あたりのプロパティ割り当てトークンの割り当て上限は変更されていません。
2020-11-09 メソッド getUniversalMetadata が削除されました。
メソッド getUniversalMetadata が削除されました。getMetadata を使用してください。API リクエストあたりの最大期間(1 年)が削除されました。
2020-11-02 リアルタイム レポート メソッドを追加しました。
例についてはリアルタイム レポートの作成を、REST リファレンス ドキュメントについては runRealtimeReport をご覧ください。
2020-10-19 クライアント ライブラリ アーティファクトを更新しました。
クライアント ライブラリ アーティファクトが、使用手順とコードサンプルとともに更新されました。
2020 年 10 月 13 日 アプリ + ウェブ プロパティの名前が Google アナリティクス 4(GA4)に変更されました。
2020-10-08 getMetadata メソッドが API に追加されました。
getMetadata メソッドは、指定された GA4 プロパティ ID で使用可能なカスタム ディメンションとカスタム指標、およびユニバーサル メタデータを返します。
2020 年 10 月 8 日 カスタム ディメンションとカスタム指標がレポートで使用できるようになりました。
カスタム ディメンションとカスタム指標に関するドキュメントについては、API スキーマのドキュメントをご覧ください。この更新には、イベント スコープのカスタム ディメンションとカスタム指標、およびユーザー スコープのカスタム ディメンションが含まれます。