変更履歴

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

2024 年 10 月 15 日 reportTasks メソッドにサンプリング レベルの機能を追加

properties.runReportTask メソッドの samplingLevel フィールドを使用して、レポートのサンプリング レベルを制御できます。

この機能により、Google アナリティクス 360 プロパティではサンプリング上限が 10 億件のイベントに引き上げられます。また、イベント数が非常に多い非サンプリング結果の場合は、サンプリング上限を UNSAMPLED に設定できます。

2024-09-18 プロパティの割り当てスナップショット機能を追加

properties.getPropertyQuotasSnapshot メソッドを使用すると、特定のプロパティの割り当てカテゴリ別に整理されたすべてのプロパティ割り当ての現在のスナップショットを取得できます。

2024-06-28 「同一プロジェクト・同一プロパティで発生するクライアント エラー数」のクォータを追加しました

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

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

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

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

Data API v1beta のコア レポート メソッドが更新され、comparisons フィールドがサポートされるようになりました。このフィールドには、リクエストされた比較の構成を指定します。

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

getMetadata メソッドが更新され、プロパティで使用可能な保存済みの比較をすべて comparisons レスポンス フィールドにリストするようにしました。

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

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

2024-05-08 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 繰り返しフィールドに、非推奨の conversion API 名のエントリがある。

2024 年 3 月 25 日 メインのチャネル グループ、手動トラフィック ソース、統合固有のディメンションを追加しました。

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

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

  • audienceId オーディエンス ID。オーディエンスの数値 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

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

  • 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 ユーザーの最初の SA360 エンジン アカウント ID

  • firstUserSa360EngineAccountName ユーザーの最初の SA360 エンジン アカウント名

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

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

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

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

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

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

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

  • firstUserSa360SourceMedium ユーザーの最初の SA360 参照元 / メディア

  • sa360AdGroupId SA360 広告グループ ID

  • sa360CampaignId SA360 キャンペーン ID

  • sa360AdGroupName SA360 広告グループ名

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

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

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

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

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

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

  • sa360ManagerAccountId 検索広告 360 マネージャー アカウント ID

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

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

  • sa360Query SA360 クエリ

  • sa360Source SA360 の参照元

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

  • sessionSa360AdGroupId セッションの SA360 広告グループ ID

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

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

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

  • sessionSa360SourceMedium セッションの検索広告 360 参照元 / メディア

2024 年 3 月 6 日 オーディエンスのエクスポートで無効なユーザーのオーディエンスをサポート。

オーディエンス エクスポート機能により、非アクティブなユーザーのオーディエンスのエクスポートがより適切にサポートされるようになりました。ユーザーは、対象となるイベントが発生しなくてもこれらのオーディエンスに入ります。たとえば、ウェブサイトに 7 日間アクセスしなかったユーザーがオーディエンスに入ることができます。非アクティブ ユーザー オーディエンスには、「7 日間の非アクティブ購入者」、「7 日間の非アクティブ ユーザー」、「7 日間の未通知ユーザー」などがあります。推奨されるオーディエンスについて詳しくは、推奨されるオーディエンスをご覧ください。

2024-02-28 オーディエンス エクスポートで、タグ設定で指定されたユーザー ID が返されるようになりました。

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

2024 年 1 月 30 日 Data API v1 アルファ版で、オーディエンス リストと定期的なオーディエンス リストの 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 を追加しました

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

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

Data API v1 alpha に properties.recurringAudienceLists.create、properties.recurringAudienceLists.create、properties.recurringAudienceLists.list の各メソッドを追加しました。

この機能を使用すると、オーディエンス メンバーシップが変更されるたびに、毎日オーディエンス リストを生成できます。繰り返しオーディエンス リストを使用すると、最新のオーディエンス メンバーシップの結果を使用できます。

2023-11-08 Data API v1 アルファ版に、オーディエンス リストをスプレッドシートにエクスポートする機能を追加しました

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

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 ディメンションを追加しました

2023-08-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 alpha にオーディエンス リストのサポートが追加されました。オーディエンス リストには、オーディエンス リストの作成時点でのオーディエンス内のユーザーのスナップショットが含まれます。

Data API v1 アルファ版に次のメソッドが追加されました。

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

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

2023 年 5 月 11 日 トークンの割り当ての変更。

Data API の割り当てシステムが更新され、より正確な課金が可能になりました。

各リクエストで課金されるトークン数は、割り当ての変更に沿って更新され、単純なレポート クエリをより多く実行できるように再調整されました。一方、大規模なデータレポートに対しては、割り当てトークンを大幅に多く課金します。

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

標準プロパティ

割り当て名 古い上限 新しい上限
1 プロパティあたり 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
1 日あたり 1 つの宿泊施設でのファネル トークン数 25,000 200,000
1 プロパティで 1 時間あたりのファネル トークン数 5,000 40,000
ファネル トークン数（プロジェクトごと、プロパティごと、1 時間あたり） 1,750 14,000

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

割り当て名 古い上限 新しい上限
1 プロパティあたり 1 日あたりのコアトークン 250,000 2,000,000
プロパティごとのコアトークン数（1 時間あたり） 50,000 400,000
同一プロジェクト・同一プロパティで 1 時間あたりのコアトークン数 17,500 人 140,000
1 日あたりのプロパティあたりのリアルタイム トークン数 250,000 2,000,000
同一プロパティで 1 時間あたりのリアルタイム トークン数 50,000 400,000
同一プロジェクト・同一プロパティで 1 時間あたりのリアルタイム トークン数 17,500 140,000
1 日あたり 1 つの宿泊施設でのファネル トークン数 250,000 2,000,000
1 プロパティで 1 時間あたりのファネル トークン数 50,000 400,000
同一プロジェクト・同一プロパティで 1 時間あたりのファネル トークン数 17,500 140,000

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

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

  • isoWeek ISO 週（年間）。ISO 週番号。1 週間は月曜日から始まります。詳しくは、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 ads」、「bing」、「baidu」）。

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

  • sessionSa360Medium セッションの検索広告 360 メディア。このセッションにつながった検索広告 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-05-05 アルファ版チャンネルにファネル レポート機能を追加しました。

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

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

  • dauPerWau DAU / WAU。7 日間のアクティブ ユーザーのうち、1 日のアクティブ ユーザーでもある割合（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-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 を使用するトラフィックに対して、このフィールドが「手動」を返すことを前提としないでください。このフィールドは、今後の機能リリースに向けて「手動」から「(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 スキーマの変更。

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

  • googleAdsCreativeId ディメンションを Data API スキーマに追加しました。このディメンションには、コンバージョン イベントへの貢献度が割り当てられた Google 広告クリエイティブの ID が含まれます。

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

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

2021-04-09 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:batchRunReports

  • API クライアント ライブラリは、新しい 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 年 1 月 28 日 新しい日付/時刻ディメンションを追加しました。

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

2021-01-28 Data API で、クエリごとに課金される割り当てトークンが削減されました。

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

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

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

2020-11-02 リアルタイム レポート メソッドを追加しました。

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

2020-10-19 クライアント ライブラリ アーティファクトを更新しました。

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

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

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

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

2020-10-08 レポートでカスタム ディメンションとカスタム指標を使用できるようになりました。

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