変更履歴

Google Analytics API に関する正式なお知らせを受け取るには、Google Analytics API Notify Group にご登録ください。

2024 年 6 月 28 日「プロジェクトごと、プロパティごとのクライアント エラー数」の割り当てを追加

プロジェクトごと、プロパティごと、15 分間に許可される API サーバーエラーは 10,000 件までです。これには、500 または 200 以外のコードでレスポンスが返されるすべてのリクエストが含まれます。この割り当てが適用されるエラーの例: 互換性のないディメンションと指標の組み合わせを使用したすべての認証エラー。

この上限を超えると、そのプロパティへの以降の API 呼び出しは、15 分間の期間が終了するまで、関連する Google Cloud プロジェクトで一時的にブロックされます。

2024 年 5 月 14 日 比較機能を追加

比較を使用すると、データのサブセットを並べて評価できます。

Data API v1beta のコアレポート メソッドは、comparisons フィールドをサポートするように更新されています。このフィールドを追加すると、リクエストする比較の構成を指定できます。

リクエストでは、リクエストに dimensionFilter 式を指定して基本的な比較を指定することも、comparison フィールドに比較のリソース名を指定して保存済み比較を使用することもできます。

getMetadata メソッドが更新され、comparisons レスポンス フィールドのプロパティで使用できる保存済み比較がすべて一覧表示されます。

リクエストで少なくとも 1 つの比較が指定されている場合、レスポンスには各比較を識別する comparison 列が含まれます。

現在、保存済みの比較は Google アナリティクスの UI でのみ作成できます。

2024 年 5 月 8 日 非同期レポート機能のレポートタスクが 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 年 3 月 25 日 メイン チャネル グループ、手動トラフィック ソース、統合固有のディメンションを追加しました。

プライマリ チャネル グループ、手動のトラフィック ソース、CM360、DV360、SA360 の統合固有のディメンションが Data API スキーマに追加されました。

オーディエンス ディメンション:

• audienceId オーディエンス ID。オーディエンスの数値識別子。

メインのチャネル グループのディメンション:

• firstUserPrimaryChannelGroup 最初のユーザーのメインのチャネル グループ

• primaryChannelGroup メインのチャネル グループ

• sessionPrimaryChannelGroup セッションのメインのチャネル グループ

手動トラフィック ソースのディメンション:

• manualCampaignId 手動キャンペーン ID

• manualCampaignName 手動キャンペーン名

• manualCreativeFormat 手動のクリエイティブ フォーマット

• manualMarketingTactic 手動マーケティング戦術

• manualMedium 手動メディア

• manualSource 手動参照元

• manualSourceMedium 手動参照元 / メディア

• manualSourcePlatform 手動参照元プラットフォーム

• firstUserManualCampaignId ユーザーの最初の手動キャンペーンの ID

• firstUserManualCampaignName ユーザーの最初の手動キャンペーン名

• firstUserManualCreativeFormat ユーザーの最初の手動クリエイティブ フォーマット

• firstUserManualMarketingTactic ユーザーの最初の手動マーケティング戦術

• firstUserManualMedium ユーザーの最初の手動メディア

• firstUserManualSource ユーザーの最初の手動参照元

• firstUserManualSourceMedium ユーザーの最初の手動参照元 / メディア

• firstUserManualSourcePlatform ユーザーの最初の手動参照元プラットフォーム

• sessionManualCampaignId セッションの手動キャンペーン ID

• sessionManualCampaignName セッションの手動キャンペーン名

• sessionManualCreativeFormat セッションの手動クリエイティブ フォーマット

• sessionManualMarketingTactic セッションの手動マーケティング戦術

• sessionManualMedium セッションの手動メディア

• sessionManualSource セッションの手動参照元

• sessionManualSourceMedium セッションの手動参照元 / メディア

• sessionManualSourcePlatform セッションの手動参照元プラットフォーム

キャンペーン マネージャー 360（CM360）の統合に関するディメンション:

• cm360AccountId CM360 アカウント ID

• cm360AccountName CM360 アカウント名

• cm360AdvertiserId CM360 広告主 ID

• cm360AdvertiserName CM360 広告主名

• cm360CampaignId 個の CM360 キャンペーン ID

• cm360CampaignName CM360 キャンペーン名

• cm360CreativeFormat CM360 クリエイティブ フォーマット

• cm360CreativeId CM360 クリエイティブ ID

• cm360CreativeName CM360 クリエイティブ名

• cm360CreativeType CM360 クリエイティブ タイプ

• cm360CreativeTypeId CM360 クリエイティブ タイプ ID

• cm360CreativeVersion CM360 クリエイティブ バージョン

• cm360Medium CM360 メディア

• cm360PlacementCostStructure CM360 プレースメントの課金形態

• cm360PlacementId CM360 プレースメント ID

• cm360PlacementName CM360 プレースメント名

• cm360RenderingId CM360 レンダリング ID

• cm360SiteId CM360 サイト ID

• cm360SiteName CM360 サイト名

• cm360Source CM360 参照元

• cm360SourceMedium CM360 参照元 / メディア

• firstUserCm360AccountId 最初のユーザーの CM360 アカウント ID

• firstUserCm360AccountName 最初のユーザーの CM360 アカウント名

• firstUserCm360AdvertiserId 最初のユーザーの CM360 広告主 ID

• firstUserCm360AdvertiserName 最初のユーザーの CM360 広告主名

• firstUserCm360CampaignId 最初のユーザーの CM360 キャンペーン ID

• firstUserCm360CampaignName 最初のユーザーの CM360 キャンペーン名

• firstUserCm360CreativeFormat 最初のユーザーの CM360 クリエイティブ フォーマット

• firstUserCm360CreativeId 最初のユーザーの CM360 クリエイティブ ID

• firstUserCm360CreativeName 最初のユーザーの CM360 クリエイティブ名

• firstUserCm360CreativeType 最初のユーザーの CM360 クリエイティブ タイプ

• firstUserCm360CreativeTypeId 最初のユーザーの CM360 クリエイティブ タイプ ID

• firstUserCm360CreativeVersion 最初のユーザーの CM360 クリエイティブ バージョン

• firstUserCm360Medium 最初のユーザーの CM360 メディア

• firstUserCm360PlacementCostStructure 最初のユーザーの CM360 プレースメントの課金形態

• firstUserCm360PlacementId 最初のユーザーの CM360 プレースメント ID

• firstUserCm360PlacementName 最初のユーザーの CM360 プレースメント名

• firstUserCm360RenderingId 最初のユーザーの CM360 レンダリング ID

• firstUserCm360SiteId 最初のユーザーの CM360 サイト ID

• firstUserCm360SiteName 最初のユーザーの CM360 サイト名

• firstUserCm360Source 最初のユーザーの CM360 参照元

• firstUserCm360SourceMedium 最初のユーザーの CM360 参照元 / メディア

• sessionCm360AccountId セッションの CM360 アカウント ID

• sessionCm360AccountName セッションの CM360 アカウント名

• sessionCm360AdvertiserId セッションの CM360 広告主 ID

• sessionCm360AdvertiserName セッションの CM360 広告主名

• sessionCm360CampaignId セッションの CM360 キャンペーン ID

• sessionCm360CampaignName セッションの CM360 キャンペーン名

• sessionCm360CreativeFormat セッションの CM360 クリエイティブ フォーマット

• sessionCm360CreativeId セッションの CM360 クリエイティブ ID

• sessionCm360CreativeName セッションの CM360 クリエイティブ名

• sessionCm360CreativeType セッションの CM360 クリエイティブ タイプ

• sessionCm360CreativeTypeId セッションの CM360 クリエイティブ タイプ ID

• sessionCm360CreativeVersion セッションの CM360 クリエイティブ バージョン

• sessionCm360Medium セッションの CM360 メディア

• sessionCm360PlacementCostStructure セッションの CM360 プレースメントの課金形態

• sessionCm360PlacementId セッションの CM360 プレースメント ID

• sessionCm360PlacementName セッションの CM360 プレースメント名

• sessionCm360RenderingId セッションの CM360 レンダリング ID

• sessionCm360SiteId セッションの CM360 サイト ID

• sessionCm360SiteName セッションの CM360 サイト名

• sessionCm360Source セッションの CM360 参照元

• sessionCm360SourceMedium セッションの CM360 参照元 / メディア

Google ディスプレイ &ビデオ 360（DV360）の統合ディメンション:

• dv360AdvertiserId ディスプレイ&ビデオ 360 広告主 ID

• dv360AdvertiserName ディスプレイ&ビデオ 360 広告主名

• dv360CampaignId 個のディスプレイ&ビデオ 360 キャンペーン ID

• dv360CampaignName 個のディスプレイ&ビデオ 360 キャンペーン名

• dv360CreativeFormat ディスプレイ&ビデオ 360 クリエイティブ フォーマット

• dv360CreativeId ディスプレイ&ビデオ 360 クリエイティブ ID

• dv360CreativeName 個のディスプレイ&ビデオ 360 クリエイティブ名

• dv360ExchangeId 個のディスプレイ&ビデオ 360 エクスチェンジ ID

• dv360ExchangeName 個のディスプレイ&ビデオ 360 エクスチェンジ名

• dv360InsertionOrderId 個のディスプレイ&ビデオ 360 広告掲載オーダー ID

• dv360InsertionOrderName 個のディスプレイ&ビデオ 360 広告掲載オーダー名

• dv360LineItemId 個のディスプレイ&ビデオ 360 広告申込情報 ID

• dv360LineItemName 個のディスプレイ&ビデオ 360 広告申込情報名

• dv360Medium 個のディスプレイ&ビデオ 360 メディア

• dv360PartnerId ディスプレイ&ビデオ 360 パートナー ID

• dv360PartnerName 個のディスプレイ&ビデオ 360 パートナー名

• dv360Source 個のディスプレイ&ビデオ 360 参照元

• dv360SourceMedium ディスプレイ&ビデオ 360 参照元 / メディア

• firstUserDv360AdvertiserId 最初のユーザーのディスプレイ&ビデオ 360 広告主 ID

• firstUserDv360AdvertiserName 最初のユーザーのディスプレイ&ビデオ 360 広告主名

• firstUserDv360CampaignId 最初のユーザーのディスプレイ&ビデオ 360 キャンペーン ID

• firstUserDv360CampaignName 最初のユーザーのディスプレイ&ビデオ 360 キャンペーン名

• firstUserDv360CreativeFormat 最初のユーザーのディスプレイ&ビデオ 360 クリエイティブ フォーマット

• firstUserDv360CreativeId 最初のユーザーのディスプレイ&ビデオ 360 クリエイティブ ID

• firstUserDv360CreativeName 最初のユーザーのディスプレイ&ビデオ 360 クリエイティブ名

• firstUserDv360ExchangeId 最初のユーザーのディスプレイ&ビデオ 360 エクスチェンジ ID

• firstUserDv360ExchangeName 最初のユーザーのディスプレイ&ビデオ 360 エクスチェンジ名

• firstUserDv360InsertionOrderId 最初のユーザーのディスプレイ&ビデオ 360 広告掲載オーダー ID

• firstUserDv360InsertionOrderName 最初のユーザーのディスプレイ&ビデオ 360 広告掲載オーダー名

• firstUserDv360LineItemId 最初のユーザーのディスプレイ&ビデオ 360 広告申込情報 ID

• firstUserDv360LinteItemName 最初のユーザーのディスプレイ&ビデオ 360 広告申込情報名

• firstUserDv360Medium 最初のユーザーのディスプレイ&ビデオ 360 メディア

• firstUserDv360PartnerId 最初のユーザーのディスプレイ&ビデオ 360 パートナー ID

• firstUserDv360PartnerName 最初のユーザーのディスプレイ&ビデオ 360 パートナー名

• firstUserDv360Source 最初のユーザーのディスプレイ&ビデオ 360 参照元

• firstUserDv360SourceMedium 最初のユーザーのディスプレイ&ビデオ 360 参照元 / メディア

• sessionDv360AdvertiserId セッションのディスプレイ&ビデオ 360 広告主 ID

• sessionDv360AdvertiserName セッションのディスプレイ&ビデオ 360 広告主名

• sessionDv360CampaignId セッションのディスプレイ&ビデオ 360 キャンペーン ID

• sessionDv360CampaignName セッションのディスプレイ&ビデオ 360 キャンペーン名

• sessionDv360CreativeFormat セッションのディスプレイ&ビデオ 360 クリエイティブ フォーマット

• sessionDv360CreativeId セッションのディスプレイ&ビデオ 360 クリエイティブ ID

• sessionDv360CreativeName セッションのディスプレイ&ビデオ 360 クリエイティブ名

• sessionDv360ExchangeId セッションのディスプレイ&ビデオ 360 エクスチェンジ ID

• sessionDv360ExchangeName セッションのディスプレイ&ビデオ 360 エクスチェンジ名

• sessionDv360InsertionOrderId セッションのディスプレイ&ビデオ 360 広告掲載オーダー ID

• sessionDv360InsertionOrderName セッションのディスプレイ&ビデオ 360 広告掲載オーダー名

• sessionDv360LineItemId セッションのディスプレイ&ビデオ 360 広告申込情報 ID

• sessionDv360LineItemName セッションのディスプレイ&ビデオ 360 広告申込情報名

• sessionDv360Medium 個のセッションのディスプレイ&ビデオ 360 メディア

• sessionDv360PartnerId セッションのディスプレイ&ビデオ 360 パートナー ID

• sessionDv360PartnerName セッションのディスプレイ&ビデオ 360 パートナー名

• sessionDv360Source 個のセッションのディスプレイ&ビデオ 360 参照元

• sessionDv360SourceMedium セッションのディスプレイ&ビデオ 360 参照元 / メディア

Google 検索広告 360（SA360）の統合ディメンション:

• firstUserSa360AdGroupId 最初のユーザー: 検索広告 360 広告グループ ID

• firstUserSa360AdGroupName 最初のユーザー: 検索広告 360 広告グループ名

• firstUserSa360CampaignId 最初のユーザー: 検索広告 360 キャンペーン ID

• firstUserSa360CampaignName 最初のユーザーの検索広告 360 キャンペーン

• firstUserSa360CreativeFormat 最初のユーザーの SA360 クリエイティブ フォーマット

• firstUserSa360EngineAccountId 最初のユーザー: 検索広告 360 エンジン アカウント ID

• firstUserSa360EngineAccountName 最初のユーザー: 検索広告 360 エンジン アカウント名

• firstUserSa360EngineAccountType 最初のユーザーの SA360 エンジン アカウントの種類

• firstUserSa360KeywordText 最初のユーザー: 検索広告 360 のキーワード テキスト

• firstUserSa360ManagerAccountId 最初のユーザー: 検索広告 360 MCC アカウント ID

• firstUserSa360ManagerAccountName 最初のユーザー: 検索広告 360 MCC アカウント名

• firstUserSa360Medium 最初のユーザーの検索広告 360 メディア

• firstUserSa360Query 最初のユーザーの SA360 クエリ

• firstUserSa360Source 最初のユーザーの SA360 参照元

• firstUserSa360SourceMedium 最初のユーザー: 検索広告 360 参照元 / メディア

• sa360AdGroupId 検索広告 360 広告グループ ID

• sa360CampaignId 検索広告 360 キャンペーン ID

• sa360AdGroupName 個の検索広告 360 広告グループ名

• sa360CampaignName 個の検索広告 360 キャンペーン

• sa360CreativeFormat SA360 クリエイティブ フォーマット

• sa360EngineAccountId SA360 エンジン アカウント ID

• sa360EngineAccountName SA360 エンジン アカウント名

• sa360EngineAccountType SA360 エンジン アカウントの種類

• sa360KeywordText SA360 のキーワード テキスト

• sa360ManagerAccountId 検索広告 360 クライアント センター（MCC）アカウント ID

• sa360ManagerAccountName 検索広告 360 MCC アカウント名

• sa360Medium 検索広告 360 のメディア

• sa360Query 件の SA360 クエリ

• sa360Source 検索広告 360 参照元

• sa360SourceMedium 検索広告 360 参照元 / メディア

• sessionSa360AdGroupId セッション: 検索広告 360 広告グループ ID

• sessionSa360CampaignId セッションの SA360 キャンペーン ID

• sessionSa360ManagerAccountId セッション: 検索広告 360 MCC アカウント ID

• sessionSa360ManagerAccountName セッション: 検索広告 360 MCC アカウント名

• sessionSa360SourceMedium セッションの SA360 参照元 / メディア

2024 年 3 月 6 日 オーディエンスのエクスポートで非アクティブ ユーザーのオーディエンスをサポート

オーディエンスのエクスポート機能では、非アクティブ ユーザーのオーディエンスのエクスポートが改善されました。 ユーザーが対象イベントなしでオーディエンスに参加します。たとえば、ユーザーが 7 日間ウェブサイトにアクセスしないことで、オーディエンスに登録できます。非アクティブ ユーザー オーディエンスには、「7 日間の非アクティブ購入者」、「7 日間の非アクティブ ユーザー」、「7 日間の未通知ユーザー」などがあります。オーディエンスの候補について詳しくは、オーディエンスの候補をご覧ください。

2024 年 2 月 28 日 オーディエンスのエクスポートでは、タグで指定したユーザー ID が返されます。

プロパ��ィでユーザー提供データが有効になっている場合でも、オーディエンスのエクスポートではタグで指定したユーザー ID が返されるようになりました。ユーザー提供データの収集を有効にすると、タグでユーザー提供データと User-ID が Google アナリティクスに送信されるため、測定の精度が向上します。詳しくは、ユーザー提供データの収集をご覧ください。

2024-01-30 Data API v1 アルファ版で、オーディエンス リストと繰り返しオーディエンス リストの Webhook 通知のサポート。

AudienceList.webhookNotification フィールドと RecurringAudienceList.webhookNotification フィールドは、オーディエンス リスト（properties.audienceLists.create を使用）または繰り返しオーディエンス リスト（properties.recurringAudienceLists.create を使用）の作成時に指定できます。

この機能を使用すると、オーディエンス リストが利用可能になったときに、Webhook 通知を非同期で受信できます。

2024 年 1 月 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 ベータ版に次のメソッドを追加しました。

• properties.audienceExports.create

• properties.audienceExports.get

• properties.audienceExports.list

• properties.audienceExports.query

2023 年 11 月 28 日 レスポンスの報告に samplingMetadatas を追加

samplingMetadatas を ResponseMetaData に追加しました。このコレクションには、結果がサンプリングされたリクエストの期間ごとに SampleMetadata が含まれます。Google アナリティクスでは、基数の上限によってデータ品質が低下することが予想される場合にのみ、サンプリングが適用されます。

2023 年 11 月 28 日 オーディエンス リストの定期的なエクスポート機能を Data API v1 アルファ版に追加

Data API v1 アルファ版に properties.recurringAudienceLists.create、properties.recurringAudienceLists.create、properties.recurringAudienceLists.list の各メソッドを追加しました。

この機能を使うと、オーディエンス メンバーシップの変化に応じてオーディエンス リストを毎日作成できます。繰り返しオーディエンスリストを使用することで 最新のオーディエンスメンバーシップ結果で作業できます

2023 年 11 月 8 日 オーディエンス リストのスプレッドシートへのエクスポート機能を Data API v1 アルファ版に追加

Data API v1 アルファ版に properties.audienceLists.exportSheet メソッドが追加され、オーディエンス リストを Google スプレッドシートにエクスポートできるようになりました。

2023 年 10 月 13 日 有効期間が 1 日のオーディエンスのサポートを追加

有効期間が 1 日のオーディエンスが、オーディエンス リストのエクスポート機能でサポートされるようになりました。

2023 年 9 月 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 年 8 月 15 日 currencyCode ディメンションと itemDiscountAmount 指標を追加しました。

• currencyCode: e コマース イベントの現地通貨コード（ISO 4217 規格に基づく）。（「USD」、「GBP」など）。

• itemDiscountAmount: e コマース イベントにおけるアイテムの割引の金銭的価値。この指標は、「discount」アイテム パラメータによるタグ付けで入力されます。

詳しくは、Data API レポート スキーマをご���ください。

2023 年 8 月 10 日 オーディエンス リストのエクスポート スキーマに isAdsPersonalizationAllowed ディメンションを追加

• isAdsPersonalizationAllowed 広告のパーソナライズが許可されているかどうか。 ユーザーが広告のパーソナライズの対象である場合、isAdsPersonalizationAllowed は true を返します。ユーザーが広告のパーソナライズの対象とならない場合、isAdsPersonalizationAllowed は false を返します。

  詳しくは、オーディエンス リストのディメンションをご覧ください。

2023 年 7 月 10 日 オーディエンス リスト

Data API v1 アルファ版にオーディエンス リストのサポートが追加されました。オーディエンス リストには、オーディエンス リストの作成時にオーディエンスに含まれるユーザーのスナップショットが含まれます。

Data API v1 アルファ版には、次のメソッドが追加されています。

• properties.audienceLists.create

• properties.audienceLists.get

• properties.audienceLists.list

• properties.audienceLists.query

2023 年 5 月 19 日 カスタム チャネル グループ

Data API にカスタム チャネル グループのサポートが追加されました。

2023-05-11 トークンの割り当ての変更。

Data API の割り当てシステムが更新され、より正確な料金を設定できるようになりました。

リクエストごとに課金されるトークンの数は、割り当ての変更に合わせて更新され、シンプルなレポートクエリの数が増えるように再調整されていますが、大規模な日付のレポートでは、クォータ トークンが大幅に増加します。

この変更後も、一部のリクエストの費用は変わりませんが、より複雑なクエリについては料金が著しく増加します。たとえば、6 か月を超えるデータをリクエストすると、1,000 以上のクォータ トークンが課金されます。

標準プロパティ

割り当て名	以前の上限	新しい上限
プロパティごとの 1 日あたりのコアトークン数	25,000	200,000
プロパティごとのコアトークン数（1 時間あたり）	5,000	40,000
1 プロジェクト、各プロパティ、1 時間あたりのコアトークン数	1,750	14,000
プロパティごとの 1 日あたりのリアルタイム トークン数	25,000	200,000
プロパティごとの 1 時間あたりのリアルタイム トークン数	5,000	40,000
1 プロジェクト、各プロパティ、1 時間あたりのリアルタイム トークン数	1,750	14,000
プロパティごとの 1 日あたりのファネル トークン数	25,000	200,000
プロパティごとの 1 時間あたりのトークンの目標到達プロセス	5,000	40,000
ファネル トークン数（プロジェクトごと、プロパティごと、1 時間あたり）	1,750	14,000

アナリティクス 360 のプロパティ

割り当て名	以前の上限	新しい上限
プロパティごとの 1 日あたりのコアトークン数	250,000	2,000,000
プロパティごとのコアトークン数（1 時間あたり）	50,000	400,000
1 プロジェクト、各プロパティ、1 時間あたりのコアトークン数	17,500 人	14 万
プロパティごとの 1 日あたりのリアルタイム トークン数	250,000	2,000,000
プロパティごとの 1 時間あたりのリアルタイム トークン数	50,000	400,000
1 プロジェクト、各プロパティ、1 時間あたりのリアルタイム トークン数	17,500 人	14 万
プロパティごとの 1 日あたりのファネル トークン数	250,000	2,000,000
プロパティごとの 1 時間あたりのトークンの目標到達プロセス	50,000	400,000
ファネル トークン数（プロジェクトごと、プロパティごと、1 時間あたり）	17,500 人	14 万

2023 年 3 月 2 日 日付ディメンションを追加しました。

• dayOfWeekName 曜日の名前。英語の曜日。このディメンションには、Sunday、Monday などの値があります。

• isoWeek ISO 週（年間）。ISO 週番号。毎週月曜日が始まります。詳しくは https://en.wikipedia.org/wiki/ISO_week_date をご覧ください。値の例: 01、02、53。

• ISO 年は isoYear です。イベントの ISO 年。詳しくは https://en.wikipedia.org/wiki/ISO_week_date をご覧ください。値の例: 2022、2023。

• isoYearIsoWeek 年の ISO 週。isoWeek と isoYear を組み合わせた値。値の例: 201652、201701。

• 月（yearMonth 年）。year と month を組み合わせた値。値の例としては、202212、202301 などがあります。

• yearWeek 年の週。year と week を組み合わせた値。値の例としては、202253、202301 などがあります。

2023 年 2 月 27 日 e コマースのディメンションを追加しました。

• itemListPosition アイテムリストの位置。リスト内のアイテム（販売している商品など）の位置。このディメンションは、items 配列の「index」パラメータによってタグ付けされます。

• itemLocationID アイテムの地域 ID。商品アイテムに関連付けられた場所（実店舗の所在地など）。関連する商品アイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。このフィールドは、items 配列の「location_id」パラメータによるタグ付けの際に入力されます。

• itemPromotionCreativeSlot アイテム プロモーションのクリエイティブ スロット。商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。このディメンションは、イベント単位または商品アイテム単位で creative_slot パラメータでタグ付けで指定できます。パラメータがイベント単位と商品アイテム単位の両方で指定されている場合は、商品アイテム単位のパラメータが使用されます。

2023 年 2 月 21 日「ランディング ページ + クエリ文字列」ディメンションを追加しました。

• landingPagePlusQueryString ランディング ページ + クエリ文字列。セッションの最初のページビューに関連付けられたページ階層とクエリ文字列。

このフィールドは、サポートが終了した landingPage ディメンションに代わるもので、2023 年 5 月 14 日にクエリ文字列を返さないように更新されます。

2023 年 1 月 28 日「ユーザーあたりの表示回数」と「スクロールしたユーザー」の指標を追加しました。

• ユーザーあたり screenPageViewsPerUser 回。アクティブ ユーザー 1 人あたりのユーザーが閲覧したアプリの画面またはウェブページの数。同じページやスクリーンが繰り返し表示された場合も集計されます(screen_view + page_view events) / active users.

• スクロールしたユーザー: scrolledUsers 人。ページを 90% 以上下にスクロールしたユニーク ユーザーの数。

2023 年 1 月 23 日「大陸」と「大陸 ID」のディメンションを追加しました。

• continent 大陸。ユーザー アクションが発生した大陸。たとえば、Americas や Asia などです。

• continentId 大陸 ID。ユーザー アクションが発生した大陸の地域 ID（IP アドレスから取得）。

2023 年 1 月 23 日「テストデータのフィルタ ID」ディメンションを追加しました。

• testDataFilterId テストデータのフィルタ ID。テスト状態のデータフィルタの数値識別子。データフィルタを使用すると、イベント パラメータ値に基づいて、レポートのイベントデータを追加または除外できます。詳しくは、https://support.google.com/analytics/answer/10108813 をご覧ください。

2022 年 10 月 18 日 Google 広告の指標を追加しました。

• 広告のクリック: 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 日に、以下の互換性を破る変更が行われます。

1. itemName などのアイテム スコープのディメンションは、eventCount などのイベント スコープの指標と互換性がありません。アイテム スコープのディメンションは、アイテム スコープの指標（itemRevenue など）、ユーザーベースの指標（activeUsers など）、セッション ベースの指標（sessions など）と引き続き互換性があります。

2. source などのアトリビューション ディメンションは、eventCount などの一部のイベント スコープの指標と互換性がありません。アトリビューションのディメンションは、引き続きアトリビューション可能な指標（conversions など）、ユーザーベースの指標（activeUsers など）、セッション ベースの指標（sessions など）と引き続き互換性があります。

3. 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 年 8 月 3 日 セッション スコープの検索広告 360 ディメンションを追加しました。

• sessionSa360AdGroupName セッションの SA360 広告グループ名。このセッションにつながった検索広告 360 の広告グループ名。

• sessionSa360CampaignNameセッションの SA360 キャンペーン。このセッションにつながった検索広告 360 のキャンペーン名。

• sessionSa360CreativeFormatセッションの SA360 クリエイティブ フォーマット。このセッションにつながった検索広告 360 のクリエイティブのタイプ。（「レスポンシブ検索広告」、「拡張テキスト広告」など）。

• sessionSa360EngineAccountId セッションの SA360 エンジン アカウント ID。このセッションにつながった検索広告 360 のエンジン アカウントの ID。

• sessionSa360EngineAccountName セッションの SA360 エンジン アカウント名。このセッションにつながった検索広告 360 のエンジン アカウントの名前。

• sessionSa360EngineAccountType セッションの SA360 エンジン アカウントの種類。このセッションにつながった検索広告 360 のエンジン アカウントのタイプ。（「Google 広告」、「Bing」、「バイドゥ」など）。

• sessionSa360Keyword セッションの SA360 キーワード テキスト。このセッションにつながった検索広告 360 の検索エンジン キーワード。

• sessionSa360Medium セッションの SA360 メディア。このセッションにつながった検索広告 360 の検索エンジン キーワード。例: 「cpc」

• sessionSa360Query セッションの SA360 クエリ。このセッションにつながった検索広告 360 の検索クエリ。

• sessionSa360Source セッションの SA360 参照元。このセッションにつながった検索広告 360 からのトラフィックのソース。（「example.com」、「google」など）。

• sessionCampaignId、sessionCampaignName のディメンションで検索広告 360 キャンペーンがサポートされるようになりました。

2022 年 7 月 11 日 コンバージョン率の指標を追加しました。

コンバージョン率

• sessionConversionRate コンバージョン イベントがトリガーされたセッションの割合。

• userConversionRate コンバージョン イベントをトリガーしたユーザーの割合。

1 回のコンバージョンに対するコンバージョン率の指標

• sessionConversionRate:event_name 特定のコンバージョン イベントがトリガーされたセッションの割合。

• userConversionRate:event_name 特定のコンバージョン イベントをトリガーしたユーザーの割合。

2022 年 5 月 5 日 アルファ版チャンネルにファネル レポート機能を追加しました。

• v1alpha バージョンの API に runFunnelReport メソッドが追加されました。このメソッドは、Google アナリティクスのイベントデータのカスタマイズされた目標到達プロセス レポートを返します。

• このメソッドは、ベータ版に入る前に構文と機能に関するフィードバックを収集することを目的としています。この API に関するフィードバックがございましたら、Google Analytics Data API の目標到達プロセス レポートに関するフィードバックにご記入ください。

2022 年 2 月 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: 新規ユーザー 1 人あたりの初回購入者の平均数。

• DAU / MAU は dauPerMau です。30 日間のアクティブ ユーザーのうち、1 日のアクティブ ユーザーでもあるローリング割合。

• dauPerWau DAU / WAU。7 日間のアクティブ ユーザーのうち、1 日間のアクティブ ユーザーでもあるもののローリングの割合。

• wauPerMau WAU / MAU。30 日間のアクティブ ユーザーのうち、7 日間のアクティブ ユーザーでもあるローリング割合。

• purchaserConversionRate 1 回以上の購入取引を行ったアクティブ ユーザーの割合。

• transactionsPerPurchaser 購入ユーザーごとのトランザクション数。

Google 広告の広告キャンペーン

• firstUserGoogleAdsCampaignType: ユーザーを最初に獲得した Google 広告キャンペーンのキャンペーン タイプ。

• googleAdsCampaignType: コンバージョン イベントに関連付けられた Google 広告キャンペーンのキャンペーン タイプ。

• sessionGoogleAdsCampaignType: このセッションにつながった Google 広告の広告キャンペーンのキャンペーン タイプ。

2021 年 9 月 7 日 新しい日時ディメンションを追加しました。

• dateHourMinute: 日付、時間、分を組み合わせた値（YYYYMMDDHHMM 形式）。

• minute: イベントがログに記録された時刻の 2 桁で表した分。

• nthMinute: 期間が開始してからの経過分（分）。

2021 年 9 月 7 日 イベント パラメータによって入力された新しいディメンションを追加しました。

• achievementId: イベントのゲームにおける実績 ID。

• character: イベントのゲーム内プレーヤー キャラクター。

• fileExtension: ダウンロードしたファイルの拡張子。

• fileName: ダウンロードされたファイルのページパス。

• groupId: イベントのゲーム内におけるプレーヤー グループ ID。

• linkClasses: アウトバ��ンド リンクの HTML クラス属性。

• 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 年 6 月 10 日 API スキーマの変更。

• Data API リアルタイム スキーマに追加された minutesAgo ディメンション。runRealtimeReport メソッドに対するクエリで使用できます。このディメンションには、イベントが収集された時間（分）が含まれます。00 は現在の分、01 は直前の分を表します。

• Data API スキーマに googleAdsCreativeId ディメンションを追加しました。このディメンションには、コンバージョン イベントに起因する Google 広告クリエイティブの ID が含まれます。

• Data API スキーマに sessionGoogleAdsCreativeId ディメンションを追加しました。このディメンションには、ウェブサイトまたはアプリでのセッションにつながった Google 広告クリエイティブの ID が含まれます。

• Data API スキーマで firstUserCreativeId ディメンションの名前が firstUserGoogleAdsCreativeId に変更されました。このディメンションには、ユーザーを最初に獲得した Google 広告クリエイティブの ID が含まれます。

2021 年 4 月 9 日 Google アナリティクス 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:batchRunReports
  

• API クライアント ライブラリは、新しい API エンドポイントを使用するように更新されています。

2021 年 2 月 19 日 ページ分けの変更。

• デフォルトのレポート レスポンス サイズが、イベントデータ 10 行から 10,000 行に増加しました。

• すべての行の取得を試行することを示すために使用されていた "limit" : -1 値が、RunReportRequest でサポートされなくなりました。

• limit フィールドの最大値は 100000 に設定されています。100,000 を超える行を含むレポートを取得するには、ページ分割を使用します。

2021 年 2 月 8 日 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 年 2 月 8 日 新しいキャンペーン ディメンションを追加しました。

新しいキャンペーン ディメンション campaignId、campaignName、googleAdsAccountName、googleAdsAdGroupId、googleAdsAdGroupName、googleAdsAdNetworkType、source、trafficOrigin が API スキーマに追加されました。

2021-02-08 dayOfWeek、week ディメンションの変更。

• dayOfWeek ディメンションの値が、1 ではなく 0 から始まるようになりました。

• week ディメンションの値が 01 で始まり、01 ～ 53 の 2 桁の数値を返すようになりました。週の始まりは日曜日です。1 月 1 日は常に 01 週目になります。

2021 年 1 月 28 日 カスタム指標の集計バリアントを追加しました。

プロパティが登録したカスタム指標ごとに、合計、平均、カウントという 3 つの API 指標のバリアントが作成されます。

2021 年 1 月 28 日 新��い日時ディメンションを追加しました。

hour、nthHour、nthYear、dateHour という新しいディメンションが API スキーマに追加されました。

2021 年 1 月 28 日 Data API により、クエリごとに課金されるクォータ トークンが削減されました。

Data API により、クエリごとに課金されるクォータ トークンが削減されました。1 時間あたりと 1 日あたりのプロパティ割り当てトークンの割り当て上限は変更されません。

2020 年 11 月 9 日 メソッド getUniversalMetadata を削除しました。

メソッド getUniversalMetadata が削除されました。getMetadata を使用してください。API リクエストあたりの最大期間である 1 年間は削除されました。

2020 年 11 月 2 日 リアルタイム レポート メソッドを追加しました。

例については、リアルタイム レポートを作成するをご覧ください。REST リファレンス ドキュメントについては、runRealtimeReport をご覧ください。

2020 年 10 月 19 日 クライアント ライブラリのアーティファクトを更新。

クライアント ライブラリのアーティファクトが更新され、使用手順とコードサンプルが追加されました。

2020 年 10 月 13 日 アプリ + ウェブ プロパティの名称が Google アナリティクス 4（GA4）に変更されました。

2020 年 10 月 8 日 getMetadata メソッドを API に追加しました。

getMetadata メソッドは、指定された GA4 プロパティ ID で利用可能なカスタム ディメンションとカスタム指標、およびユニバーサル メタデータを返します。

2020 年 10 月 8 日 レポートでカスタム ディメンションとカスタム指標をご利用いただけるようになりました。

カスタム ディメンションとカスタム指標については、API スキーマのドキュメントをご覧ください。このアップデートには、イベント スコープのカスタム ディメンションとカスタム指標、およびユーザー スコープのカスタム ディメンションが追加されています。