変更履歴

Google Analytics API に関する公式のお知らせを参照するには、Google Analytics API Notify Group にご登録ください。

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

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

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

• 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 参照元

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

• 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 広告申込情報名

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

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

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

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

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

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

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

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

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

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

• firstUserSa360CreativeFormat 最初のユーザーの検索広告 360 クリエイティブ フォーマット

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

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

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

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

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

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

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

• firstUserSa360Query 最初のユーザーの検索広告 360 クエリ

• firstUserSa360Source 最初のユーザーの検索広告 360 の参照元

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

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

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

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

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

• sa360CreativeFormat 検索広告 360 クリエイティブ フォーマット

• sa360EngineAccountId 個の検索広告 360 エンジン アカウント ID

• sa360EngineAccountName 個の検索広告 360 エンジン アカウント名

• sa360EngineAccountType 個の検索広告 360 エンジン アカウントの種類

• sa360KeywordText 個の検索広告 360 キーワード テキスト

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

• sa360ManagerAccountName 個の検索広告 360 クライアント センター（MCC）アカウント名

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

• sa360Query 件の検索広告 360 クエリ

• sa360Source 個の検索広告 360 の参照元

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

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

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

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

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

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

2024 年 3 月 6 日 オーディエンスのエクスポートで非アクティブ ユーザーのオーディエンスがサポートされるようになりました。

オーディエンスのエクスポート機能では、非アクティブなユーザー オーディエンスのエクスポートがサポートされるようになりました。 ユーザーは、条件を満たすイベントなしでオーディエンスに登録できます。たとえば、ユーザーが 7 日間ウェブサイトにアクセスしなかった場合でも、オーディエンスに登録できます。非アクティブ ユーザー オーディエンスの例としては、「7 日間の非アクティブ購入者」、「7 日間の非アクティブ ユーザー」、「7 日間の未通知ユーザー」などがあります。オーディエンスの候補について詳しくは、オーディエンスの候補をご覧ください。

2024-02-28 オーディエンスをエクスポートすると、タグ付けで指定されたユーザー ID が返されます。

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

2024 年 1 月 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 のアイテム スコープのカスタム ディメンション

詳しくは、API のディメンションと指標をご覧ください。

2023-12-05 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-08 スプレッドシートへのオーディエンス リストのエクスポート機能を Data API v1 アルファ版に追加しました

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

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 年 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-07-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 年 5 月 11 日 トークンの割り当てが変更されます。

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

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

この変更後も、一部のリクエストに対する料金に変更はありませんが、より複雑なクエリに対する料金が著しく増加します。たとえば、6 か月を超えるデータに対するリクエストでは、1,000 以上のクォータ トークンが請求される可能性があります。

標準プロパティ

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

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

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

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

• 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 などがあります。

• ISO 年の 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 回視聴。ユーザーが閲覧したアプリの画面またはウェブページの数（アクティブ ユーザーあたり）。同じページやスクリーンが繰り返し表示された場合も集計されます(screen_view + page_view events) / active users.

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

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

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

• continentId 大陸 ID。ユーザー アクションが発生した大陸の地理的 ID で、IP アドレスから取得されます。

2023-01-23 「テストデータ フィルタ ID」ディメンションを追加しました。

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

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

• 広告のクリック数: advertiserAdClicks。ユーザーが広告をクリックしてプロパティにアクセスした合計回数。
• advertiserAdCost 広告費用。広告に支払った合計金額。
• advertiserAdCostPerClick 広告のクリック単価。広告のクリック単価は、広告費用を広告のクリック数で割った値であり、略クリック単価でよく表されます。
• advertiserAdCostPerConversionコンバージョン単価コンバージョン単価は、広告費用をコンバージョン数で割った値です。
• 広告のインプレッション advertiserAdImpressions 回。インプレッションの合計数。
• returnOnAdSpend広告費用対効果。広告費用対効果（ROAS）は、総収益を広告主様の広告費用で割った値です。

2022 年 10 月 17 日 アイテム スコープの指標を追加しました。

• itemsAddedToCart 個のアイテムがカートに追加されました。1 つの商品アイテムのカートに追加されたユニット数。
• itemsCheckedOut 個のアイテムのチェックアウトが完了しました。1 つの商品アイテムについて決済されたユニット数。
• リスト内でクリックされたアイテム: itemsClickedInList 個。1 つのアイテムのリスト内でクリックされたユニット数。
• プロモーションでクリックされたアイテム数: itemsClickedInPromotion1 つの商品アイテムのプロモーションでクリックされたユニット数。
• itemsViewed 個のアイテムを閲覧しました。1 つのアイテムについて閲覧されたユニット数。
• itemsViewedInList 個のアイテムがリストで閲覧されました。1 つのアイテムについてリストに表示されたユニット数。
• itemsViewedInPromotion プロモーションで閲覧されたアイテム。1 つの商品アイテムのプロモーションで閲覧されたユニット数。

2022 年 9 月 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 セッションの 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-05-05 アルファ チャネルにファネル レポート機能を追加しました。

• API の v1alpha バージョンに追加された runFunnelReport メソッド。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: 新規ユーザーあたりの初回購入者の平均数。

• dauPerMau DAU / MAU。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-09-07 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-04-09 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-09 メソッド getUniversalMetadata が削除されました。

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

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

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

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

クライアント ライブラリ アーティファクトが更新され、使用手順とコードサンプルを含む。

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

2020-10-08 getMetadata メソッドを API に追加しました。

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

2020 年 10 月 8 日 レポートでカスタム ディメンションとカスタム指標が利用可能になりました。

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