変更履歴

Google Analytics API の公式なお知らせを受け取るには、 Google Analytics API Notify Group

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

API サーバーエラーが、プロジェクトごと、プロジェクトごとに 10,000 件まで 自動的に通知されます。これには、 500 または 200 以外のコードを含むレスポンスが返されます。エラーの例 使用できず、互換性のないディメンションと指標の組み合わせが使用され、 確認できます。

この上限を超えると、それ以降そのプロパティへの API 呼び出しが増加します 関連付けられた Google Cloud プロジェクトに対して、15 分間、 終了します。

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:

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、ディスプレイ&ビデオ 360、検索広告 360 の統合 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 のディメンションとMetrics Explorer: 包括的な互換性に関する情報を確認できます。

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 アルファ版に追加

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

この機能を使うと、オーディエンス リストをオーディエンスとして メンバーシップの変更。繰り返しオーディエンス リストを使用すると、 最新のオーディエンスメンバーシップの結果で 提供されます

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

properties.audienceLists.exportSheet を追加しました メソッドを Data API v1 アルファ版に追加します。これにより、オーディエンス リストを 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 ディメンションを追加

2023 年 8 月 15 日 currencyCode ディメンションと itemDiscountAmount 指標を追加しました。

  • currencyCode: 該当通貨の現地通貨コード（ISO 4217 規格に基づく） イベントで取り上げました。例: 「USD」または「GBP」を入力します。

  • itemDiscountAmount e コマース イベントにおけるアイテムの割引の金銭的価値。 この指標は、「割引」によってタグ内に入力されます指定します。

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

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

  • isAdsPersonalizationAllowed 広告のパーソナライズが許可されているかどうか。 ユーザーが広告のパーソナライズの対象かどうか isAdsPersonalizationAllowed は true を返します。ユーザーが 広告のパーソナライズの対象（isAdsPersonalizationAllowed） false を返します。

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

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

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

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

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

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

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 アイテムリストの位置。リスト内のアイテム（販売している商品など）の位置。このディメンションは、「インデックス」によってタグ設定されますパラメータに指定する必要があります。

  • itemLocationID アイテムの地域 ID。商品アイテムに関連付けられた場所（実店舗の所在地など）。関連する商品アイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。このフィールドは、「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 割り当てが削除されます。

  • 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 メソッドが追加されました。 カスタマイズされたファネル レポートを返す 最大 50%オフです

  • この方法は、データを収集する目的でアルファ版の安定性で導入されます。 構文と機能に関するフィードバックを送信することが義務付けられています。次の Google Analytics Data API のファネル レポートのフィードバック この 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 初回購入者の平均数 新規ユーザーあたり

  • 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: ユーザーを最初に獲得したトラフィックの発生元。 このフィールドが「Manual」を返すことには依存しないでください。トラフィックに UTMこのフィールドは、返された「Manual」から更新され、復路 '(未設定)'をご覧ください

  • sessionTrafficOrigin: セッションのキャンペーンのトラフィックの発生元。 このフィールドが「Manual」を返すことには依存しないでください。トラフィックに UTMこのフィールドは、返された「Manual」から更新され、復路 '(未設定)'をご覧ください

  • trafficOrigin コンバージョン イベントのキャンペーンのトラフィックの発生元。 このフィールドが「Manual」を返すことには依存しないでください。トラフィックに UTMこのフィールドは、返された「Manual」から更新され、復路 '(未設定)'をご覧ください

2021 年 9 月 7 日 checkCompatibility メソッドを API に追加しました。

checkCompatibility メソッドでは、レポート リクエストに追加できるディメンションと指標のリストを取得し、 互換性を維持します。

2021 年 7 月 21 日 リアルタイム レポートに関する変更

次のコマンドを使用して、読み取るイベントデータの分単位の範囲を指定できるようになりました。 minuteRanges runRealtimeReport のパラメータ メソッドを呼び出します。

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 が含まれます。 確認しましょう

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

2021 年 4 月 9 日 Google アナリティクス Data API v1 ベータ版がリリースされました。

  • API エンドポイントが https://analyticsdata.googleapis.com/v1beta に更新されました。

  • runReport さん、runPivotReport さん、batchRunReports さん、batchRunPivotReports さん メソッドが property の Google アナリティクス 4 プロパティの ID を受け取れるようになりました パラメータを使用して、リクエスト本文の entity フィールドではなく URL パスを指定します。

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

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

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

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

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

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

プロパティが登録するカスタム指標ごとに、3 つの API 指標のバリアント: 合計、平均、 あります。

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

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

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

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

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

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

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

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

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

使用状況とともに更新されたクライアント ライブラリ アーティファクト 手順とコードサンプル。

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

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

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

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

カスタム ディメンションについては、API スキーマのドキュメントをご覧ください。 提供します今回の更新には、イベント スコープのカスタム ディメンションとカスタム指標が ユーザースコープのカスタムディメンションもあります