Google Analytics API に関する公式のお知らせを参照するには、Google Analytics API Notify Group にご登録ください。
2024 年 3 月 25 日 メインのチャネル グループ、手動トラフィック ソース、統合固有のディメンションを追加しました。
Data API スキーマに、プライマリ チャネル グループ、手動トラフィック ソース、CM360、ディスプレイ&ビデオ 360、検索広告 360 の統合固有のディメンションが追加されました。
オーディエンスのディメンション:
audienceId
オーディエンス ID。オーディエンスの数値識別子。
メインのチャネル グループのディメンション:
firstUserPrimaryChannelGroup
最初のユーザーのメインのチャネル グループprimaryChannelGroup
メインのチャネル グループsessionPrimaryChannelGroup
セッションのメインのチャネル グループ
手動設定のトラフィック ソースのディメンション:
manualCampaignId
手動キャンペーン IDmanualCampaignName
手動キャンペーン名manualCreativeFormat
手動のクリエイティブ フォーマットmanualMarketingTactic
手動マーケティング戦術manualMedium
手動メディアmanualSource
手動参照元manualSourceMedium
手動参照元 / メディアmanualSourcePlatform
手動参照元プラットフォームfirstUserManualCampaignId
ユーザーの最初の手動キャンペーン IDfirstUserManualCampaignName
ユーザーの最初の手動キャンペーン名firstUserManualCreativeFormat
ユーザーの最初の手動クリエイティブ フォーマットfirstUserManualMarketingTactic
ユーザーの最初の手動マーケティング戦術firstUserManualMedium
ユーザーの最初の手動メディアfirstUserManualSource
ユーザーの最初の手動参照元firstUserManualSourceMedium
ユーザーの最初の手動参照元 / メディアfirstUserManualSourcePlatform
ユーザーの最初の手動参照元プラットフォームsessionManualCampaignId
セッションの手動キャンペーン IDsessionManualCampaignName
セッションの手動キャンペーン名sessionManualCreativeFormat
セッションの手動クリエイティブ フォーマットsessionManualMarketingTactic
セッションの手動マーケティング戦術sessionManualMedium
セッションの手動メディアセッションの手動参照元
sessionManualSource
件sessionManualSourceMedium
セッションの手動参照元 / メディアsessionManualSourcePlatform
セッションの手動参照元プラットフォーム
キャンペーン マネージャー 360(CM360)の統合ディメンション:
cm360AccountId
個の CM360 アカウント IDcm360AccountName
個の CM360 アカウント名cm360AdvertiserId
個の CM360 広告主 IDcm360AdvertiserName
個の CM360 広告主名cm360CampaignId
個の CM360 キャンペーン IDcm360CampaignName
個の CM360 キャンペーン名cm360CreativeFormat
CM360 クリエイティブ フォーマットcm360CreativeId
個の CM360 クリエイティブ IDcm360CreativeName
CM360 クリエイティブ名cm360CreativeType
個の CM360 クリエイティブ タイプcm360CreativeTypeId
個の CM360 クリエイティブ タイプ IDcm360CreativeVersion
個の CM360 クリエイティブ バージョンcm360Medium
個の CM360 メディアcm360PlacementCostStructure
CM360 プレースメントの課金形態cm360PlacementId
個の CM360 プレースメント IDcm360PlacementName
個の CM360 プレースメント名cm360RenderingId
個の CM360 レンダリング IDcm360SiteId
個の CM360 サイト IDcm360SiteName
CM360 サイト名cm360Source
個の CM360 ソースcm360SourceMedium
個の CM360 参照元 / メディアfirstUserCm360AccountId
最初のユーザーの CM360 アカウント IDfirstUserCm360AccountName
最初のユーザーの CM360 アカウント名firstUserCm360AdvertiserId
最初のユーザーの CM360 広告主 IDfirstUserCm360AdvertiserName
最初のユーザーの CM360 広告主名firstUserCm360CampaignId
最初のユーザーの CM360 キャンペーン IDfirstUserCm360CampaignName
最初のユーザーの CM360 キャンペーン名firstUserCm360CreativeFormat
最初のユーザーの CM360 クリエイティブ フォーマットfirstUserCm360CreativeId
最初のユーザーの CM360 クリエイティブ IDfirstUserCm360CreativeName
最初のユーザーの CM360 クリエイティブ名firstUserCm360CreativeType
最初のユーザーの CM360 クリエイティブ タイプfirstUserCm360CreativeTypeId
最初のユーザーの CM360 クリエイティブ タイプ IDfirstUserCm360CreativeVersion
最初のユーザーの CM360 クリエイティブ バージョンfirstUserCm360Medium
最初のユーザーの CM360 メディアfirstUserCm360PlacementCostStructure
最初のユーザーの CM360 プレースメントの課金形態firstUserCm360PlacementId
最初のユーザーの CM360 プレースメント IDfirstUserCm360PlacementName
最初のユーザーの CM360 プレースメント名firstUserCm360RenderingId
最初のユーザーの CM360 レンダリング IDfirstUserCm360SiteId
最初のユーザーの CM360 サイト IDfirstUserCm360SiteName
最初のユーザーの CM360 サイト名firstUserCm360Source
最初のユーザーの CM360 参照元firstUserCm360SourceMedium
最初のユーザーの CM360 参照元 / メディアsessionCm360AccountId
セッションの CM360 アカウント IDsessionCm360AccountName
セッションの CM360 アカウント名sessionCm360AdvertiserId
セッションの CM360 広告主 IDsessionCm360AdvertiserName
セッションの CM360 広告主名sessionCm360CampaignId
セッションの CM360 キャンペーン IDsessionCm360CampaignName
セッションの CM360 キャンペーン名sessionCm360CreativeFormat
セッションの CM360 クリエイティブ フォーマットsessionCm360CreativeId
セッションの CM360 クリエイティブ IDsessionCm360CreativeName
セッションの CM360 クリエイティブ名sessionCm360CreativeType
セッションの CM360 クリエイティブ タイプsessionCm360CreativeTypeId
セッションの CM360 クリエイティブ タイプ IDsessionCm360CreativeVersion
セッションの CM360 クリエイティブ バージョンsessionCm360Medium
セッションの CM360 メディアsessionCm360PlacementCostStructure
セッションの CM360 プレースメントの課金形態sessionCm360PlacementId
セッションの CM360 プレースメント IDsessionCm360PlacementName
セッションの CM360 プレースメント名sessionCm360RenderingId
セッションの CM360 レンダリング IDsessionCm360SiteId
セッションの CM360 サイト IDsessionCm360SiteName
セッションの CM360 サイト名sessionCm360Source
セッションの CM360 参照元sessionCm360SourceMedium
セッションの CM360 参照元 / メディア
Google ディスプレイ &ビデオ 360(DV360)の統合ディメンション:
dv360AdvertiserId
個のディスプレイ&ビデオ 360 広告主 IDdv360AdvertiserName
個のディスプレイ&ビデオ 360 広告主名dv360CampaignId
個のディスプレイ&ビデオ 360 キャンペーン IDdv360CampaignName
個のディスプレイ&ビデオ 360 キャンペーン名dv360CreativeFormat
ディスプレイ&ビデオ 360 クリエイティブ フォーマットdv360CreativeId
ディスプレイ&ビデオ 360 クリエイティブ IDdv360CreativeName
ディスプレイ&ビデオ 360 クリエイティブ名dv360ExchangeId
個のディスプレイ&ビデオ 360 エクスチェンジ IDdv360ExchangeName
個のディスプレイ&ビデオ 360 エクスチェンジ名dv360InsertionOrderId
個のディスプレイ&ビデオ 360 広告掲載オーダー IDdv360InsertionOrderName
個のディスプレイ&ビデオ 360 広告掲載オーダー名dv360LineItemId
個のディスプレイ&ビデオ 360 広告申込情報 IDdv360LineItemName
個のディスプレイ&ビデオ 360 広告申込情報名dv360Medium
個のディスプレイ&ビデオ 360 メディアdv360PartnerId
個のディスプレイ&ビデオ 360 パートナー IDdv360PartnerName
個のディスプレイ&ビデオ 360 パートナー名dv360Source
個のディスプレイ&ビデオ 360 参照元ディスプレイ&ビデオ 360 参照元 / メディア:
dv360SourceMedium
個firstUserDv360AdvertiserId
最初のユーザーのディスプレイ&ビデオ 360 広告主 IDfirstUserDv360AdvertiserName
最初のユーザーのディスプレイ&ビデオ 360 広告主名firstUserDv360CampaignId
最初のユーザーのディスプレイ&ビデオ 360 キャンペーン IDfirstUserDv360CampaignName
最初のユーザーのディスプレイ&ビデオ 360 キャンペーン名firstUserDv360CreativeFormat
最初のユーザーのディスプレイ&ビデオ 360 クリエイティブ フォーマットfirstUserDv360CreativeId
最初のユーザーのディスプレイ&ビデオ 360 クリエイティブ IDfirstUserDv360CreativeName
最初のユーザーのディスプレイ&ビデオ 360 クリエイティブ名firstUserDv360ExchangeId
最初のユーザーのディスプレイ&ビデオ 360 エクスチェンジ IDfirstUserDv360ExchangeName
最初のユーザーのディスプレイ&ビデオ 360 エクスチェンジ名firstUserDv360InsertionOrderId
最初のユーザーのディスプレイ&ビデオ 360 広告掲載オーダー IDfirstUserDv360InsertionOrderName
最初のユーザーのディスプレイ&ビデオ 360 広告掲載オーダー名firstUserDv360LineItemId
最初のユーザーのディスプレイ&ビデオ 360 広告申込情報 IDfirstUserDv360LinteItemName
最初のユーザーのディスプレイ&ビデオ 360 広告申込情報名firstUserDv360Medium
最初のユーザーのディスプレイ&ビデオ 360 メディアfirstUserDv360PartnerId
最初のユーザーのディスプレイ&ビデオ 360 パートナー IDfirstUserDv360PartnerName
最初のユーザーのディスプレイ&ビデオ 360 パートナー名firstUserDv360Source
最初のユーザーのディスプレイ&ビデオ 360 参照元firstUserDv360SourceMedium
最初のユーザーのディスプレイ&ビデオ 360 参照元 / メディアsessionDv360AdvertiserId
セッションのディスプレイ&ビデオ 360 広告主 IDsessionDv360AdvertiserName
セッションのディスプレイ&ビデオ 360 広告主名sessionDv360CampaignId
セッションのディスプレイ&ビデオ 360 キャンペーン IDsessionDv360CampaignName
セッションのディスプレイ&ビデオ 360 キャンペーン名sessionDv360CreativeFormat
セッションのディスプレイ&ビデオ 360 クリエイティブ フォーマットsessionDv360CreativeId
セッションのディスプレイ&ビデオ 360 クリエイティブ IDsessionDv360CreativeName
セッションのディスプレイ&ビデオ 360 クリエイティブ名sessionDv360ExchangeId
セッションのディスプレイ&ビデオ 360 エクスチェンジ IDsessionDv360ExchangeName
セッションのディスプレイ&ビデオ 360 エクスチェンジ名sessionDv360InsertionOrderId
セッションのディスプレイ&ビデオ 360 広告掲載オーダー IDsessionDv360InsertionOrderName
セッションのディスプレイ&ビデオ 360 広告掲載オーダー名sessionDv360LineItemId
セッションのディスプレイ&ビデオ 360 広告申込情報 IDsessionDv360LineItemName
セッションのディスプレイ&ビデオ 360 広告申込情報名セッションのディスプレイ&ビデオ 360 メディア:
sessionDv360Medium
個sessionDv360PartnerId
セッションのディスプレイ&ビデオ 360 パートナー IDsessionDv360PartnerName
セッションのディスプレイ&ビデオ 360 パートナー名sessionDv360Source
セッションのディスプレイ&ビデオ 360 参照元sessionDv360SourceMedium
セッションのディスプレイ&ビデオ 360 参照元 / メディア
Google 検索広告 360 の統合ディメンション:
firstUserSa360AdGroupId
最初のユーザー: 検索広告 360 広告グループ IDfirstUserSa360AdGroupName
最初のユーザーの検索広告 360 広告グループ名firstUserSa360CampaignId
最初のユーザー: 検索広告 360 キャンペーン IDfirstUserSa360CampaignName
最初のユーザーの検索広告 360 キャンペーンfirstUserSa360CreativeFormat
最初のユーザーの検索広告 360 クリエイティブ フォーマットfirstUserSa360EngineAccountId
最初のユーザー: 検索広告 360 エンジン アカウント IDfirstUserSa360EngineAccountName
最初のユーザー: SA360 エンジン アカウント名firstUserSa360EngineAccountType
最初のユーザーの SA360 エンジン アカウントの種類firstUserSa360KeywordText
最初のユーザー: 検索広告 360 のキーワード テキストfirstUserSa360ManagerAccountId
最初のユーザー: 検索広告 360 MCC アカウント IDfirstUserSa360ManagerAccountName
最初のユーザー: 検索広告 360 MCC アカウント名firstUserSa360Medium
最初のユーザー: 検索広告 360 のメディアfirstUserSa360Query
最初のユーザーの検索広告 360 クエリfirstUserSa360Source
最初のユーザーの検索広告 360 の参照元firstUserSa360SourceMedium
最初のユーザー: 検索広告 360 参照元 / メディアsa360AdGroupId
個の検索広告 360 広告グループ IDsa360CampaignId
個の検索広告 360 キャンペーン IDsa360AdGroupName
個の検索広告 360 広告グループ名sa360CampaignName
個の検索広告 360 キャンペーンsa360CreativeFormat
検索広告 360 クリエイティブ フォーマットsa360EngineAccountId
個の検索広告 360 エンジン アカウント IDsa360EngineAccountName
個の検索広告 360 エンジン アカウント名sa360EngineAccountType
個の検索広告 360 エンジン アカウントの種類sa360KeywordText
個の検索広告 360 キーワード テキストsa360ManagerAccountId
個の検索広告 360 クライアント センター(MCC)アカウント IDsa360ManagerAccountName
個の検索広告 360 クライアント センター(MCC)アカウント名検索広告 360 のメディア:
sa360Medium
個sa360Query
件の検索広告 360 クエリsa360Source
個の検索広告 360 の参照元sa360SourceMedium
個の検索広告 360 参照元 / メディアsessionSa360AdGroupId
セッションの SA360 広告グループ IDsessionSa360CampaignId
セッションの SA360 キャンペーン IDsessionSa360ManagerAccountId
セッション: 検索広告 360 MCC アカウント IDsessionSa360ManagerAccountName
セッション: 検索広告 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 ベータ版に次のメソッドを追加しました。
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 アルファ版に追加された次のメソッド:
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 つのアイテムのリスト内でクリックされたユニット数。 - プロモーションでクリックされたアイテム数:
itemsClickedInPromotion
1 つの商品アイテムのプロモーションでクリックされたユニット数。 itemsViewed
個のアイテムを閲覧しました。1 つのアイテムについて閲覧されたユニット数。itemsViewedInList
個のアイテムがリストで閲覧されました。1 つのアイテムについてリストに表示されたユニット数。itemsViewedInPromotion
プロモーションで閲覧されたアイテム。1 つの商品アイテムのプロモーションで閲覧されたユニット数。
2022 年 9 月 13 日 スキーマの互換性の変更に関するお知らせ。
2022 年 12 月 1 日より、以下の重要な変更が行われます。
itemName
などのアイテム スコープのディメンションは、eventCount
などのイベント スコープの指標と互換性がなくなります。アイテム スコープのディメンションは、itemRevenue
などのアイテム スコープの指標、activeUsers
などのユーザーベースの指標、sessions
などのセッション ベースの指標と引き続き互換性があります。source
などのアトリビューション ディメンションは、eventCount
などの一部のイベント スコープの指標と互換性がなくなります。アトリビューション ディメンションは、conversions
などのアトリビューション可能な指標、activeUsers
などのユーザーベースの指標、sessions
などのセッション ベースの指標と引き続き互換性があります。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
コンバージョン イベントをトリガーしたユーザーの割合。
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 スキーマのドキュメントをご覧ください。この更新には、イベント スコープのカスタム ディメンションおよびカスタム指標と、ユーザー スコープのカスタム ディメンションが含まれます。