変更履歴

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

2024 年 10 月 20 日 EmptyFilter ディメンション フィルタの種類を追加しました

EmptyFilter ディメンション フィルタを使用すると、空の値と比較するフィルタ条件を作成できます。

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 に、次のレポートタスク操作メソッドが追加されました。

• 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 繰り返しフィールドに、非推奨の 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

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

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

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

• firstUserSa360KeywordText ユーザーの最初の SA360 のキーワード テキスト

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

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

• firstUserSa360Medium ユーザーの最初の SA360 のメディア

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

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

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

• sa360AdGroupId SA360 広告グループ ID

• sa360CampaignId SA360 キャンペーン ID

• sa360AdGroupName SA360 広告グループ名

• sa360CampaignName SA360 キャンペーン

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

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

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

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

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

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

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

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

• properties.audienceExports.create

• properties.audienceExports.get

• properties.audienceExports.list

• properties.audienceExports.query

2023-11-28 レポート レスポンスに samplingMetadatas を追加しました

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

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

Data API v1 アルファ版に 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 ディメンションを追加しました

• isLimitedAdTracking デバイスの広告トラッキング制限の設定です。有効な値は true、false、(not set) です。

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

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-07-10 オーディエンス リスト

Data API v1 alpha にオーディエンス リストのサポートが追加されました。オーディエンス リストには、オーディエンス リストの作成時点でのオーディエンス内のユーザーのスナップショットが含まれます。

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

• properties.audienceLists.create

• properties.audienceLists.get

• properties.audienceLists.list

• properties.audienceLists.query

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

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

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

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

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

この変更後、一部のリクエストの料金は変わりませんが、複雑なクエリの料金は大幅に増加します。たとえば、6 か月を超えるデータのリクエストでは、1,000 個以上の割り当てトークンが課金される場合があります。

標準プロパティ

割り当て名	古い上限	新しい上限
プロパティごとに 1 日あたりのコアトークン数	25,000	200,000
同一プロパティで 1 時間あたりのコアトークン数	5,000	40,000
同一プロジェクト・同一プロパティで 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 日あたりのコアトークン数	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-03-02 日付ディメンションを追加しました。

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

• isoWeek 年の ISO 週。ISO 週番号。1 週間は月曜日から始まります。詳しくは、https://en.wikipedia.org/wiki/ISO_week_date をご覧ください。値の例としては、01、02、53 などがあります。

• isoYear ISO 年。イベントの ISO 年。詳しくは、https://en.wikipedia.org/wiki/ISO_week_date をご覧ください。値の例としては、2022 や 2023 などがあります。

• isoYearIsoWeek ISO 年の 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 ユーザーあたりの視聴回数。アクティブ ユーザーあたりのユーザーが閲覧したアプリの画面またはウェブページの数。同じページやスクリーンが繰り返し表示された場合も集計されます(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。テスト状態のデータフィルタの数値 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 セッションの検索広告 360 キャンペーン。このセッションにつながった検索広告 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 セッションの検索広告 360 参照元。このセッションにつながった検索広告 360 からのトラフィックの参照元。例:「example.com」、「google」

• sessionCampaignId ディメンションと sessionCampaignName ディメンションが検索広告 360 キャンペーンに対応しました。

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

コンバージョン率

• sessionConversionRate コンバージョン イベントが発生したセッションの割合。

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

1 件のコンバージョンのコンバージョン率の指標

• 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 日のアクティブ ユーザーでもある割合（1 日ごとのローリング平均）。

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

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

• 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 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 を使用するトラフィックに対して、このフィールドが「手動」を返すことを前提としないでください。このフィールドは、今後の機能リリースに向けて「手動」から「(not set)」に更新されます。

• sessionTrafficOrigin セッションのキャンペーンのトラフィックの発生元。UTM を使用するトラフィックに対して、このフィールドが「手動」を返すことを前提としないでください。このフィールドは、今後の機能リリースに向けて「手動」から「(not set)」に更新されます。

• trafficOrigin コンバージョン イベントのキャンペーンのトラフィックの発生元。UTM を使用するトラフィックに対して、このフィールドが「手動」を返すことを前提としないでください。このフィールドは、今後の機能リリースに向けて「手動」から「(not set)」に更新されます。

2021-09-07 API に checkCompatibility メソッドを追加しました。

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-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 に設定されています。10 万行を超えるレポートを取得するには、ページネーションを使用します。

2021-02-08 新しい e コマースのディメンションと指標。

API スキーマに、新しい e コマースのディメンションと指標が追加されました。

ディメンション: 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-01-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 API に getMetadata メソッドが追加されました。

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

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

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