tag:google.com,changelog:analyticsGoogle Analytics - Changelog - All2019-12-10T08:00:00:-0800Google AnalyticsCore Reporting API - Release 2019-12-10 (December 10, 2019)tag:google.com,changelog:analytics-reporting-core#release-2019-12-102019-12-10T08:00:00:+0000
<p>The User Activity API is updated to correctly handle requests containing User ID specification.</p>
<ul>
<li>The User Activity API has been updated to correctly handle the case when userId field was populated with a User ID and userType field was set to USER_ID. User Activity API requests containing a User ID resulted in an error prior to the fix.</li>
</ul>
User Deletion API - Release 2019-09 (September 16, 2019)tag:google.com,changelog:analytics-config-userdeletion#release-2019-09-162019-09-16T08:00:00:+0000
<p>This release contains changes to userDeletionRequest resource.</p>
<ul>
<li>propertyId field added to userDeletionRequest resource.</li>
<li>firebaseProjectId field of userDeletionRequest resource is deprecated. Usage of propertyId field is recommended instead.</li>
</ul>
Core Reporting API - Release 2019-03-19 (March 19, 2019)tag:google.com,changelog:analytics-reporting-core#release-2019-03-192019-03-19T08:00:00:+0000
<p>This is the initial release of the User Activity API</p>
<ul>
<li>The User Activity API allows you to retrieve all of the data associated with a single user– specifically, a single Client ID or User ID– over a given date range. Visit the <a href="/analytics/devguides/reporting/core/v4/user-reporting">User Activity API Guide</a> for more details.</li>
</ul>
Management API - Release 2018-07-17 (July 17, 2018)tag:google.com,changelog:analytics-config-mgmt#release-2018-07-172018-07-17T08:00:00:+0000
<h2 id="hashclientid_method_added_to_the_management_api">hashClientId method added to the Management API</h2>
<p>The <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/clientId">hashClientId</a> method provides the hash of the given Client ID, which can be found in certain exported data formats, such as in <a href="https://support.google.com/analytics/answer/3437618">Google Analytics data exported to BigQuery</a>.</p>
Management API - Release 2018-05-11 (May 11, 2018)tag:google.com,changelog:analytics-config-mgmt#release-2018-05-112018-05-11T08:00:00:+0000
<h2 id="user_data_retention_settings_in_the_management_api">User data retention settings in the Management API</h2>
<p>It is now possible to programmatically configure the user data retention settings using new ‘dataRetentionTtl’ and ‘dataRetentionResetOnNewActivity’ fields added to the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/webproperties#resource">WebProperty resource</a>.</p>
User Deletion API - Release 2018-05 (May 10, 2018)tag:google.com,changelog:analytics-config-userdeletion#release-2018-05-102018-05-10T08:00:00:+0000
<p>This is the initial release of the User Deletion API:</p>
<ul>
<li>The User Deletion API allows a Google Analytics customer to delete data for a given end user from a project or web property. User Deletion requests can be made using either Firebase projects or Google Analytics properties. Visit the <a href="https://developers.google.com/analytics/devguides/config/userdeletion/v3/">User Deletion API Overview</a> for more details.</li>
</ul>
Management API - Release 2018-02-22 (February 22, 2018)tag:google.com,changelog:analytics-config-mgmt#release-2018-02-222018-02-22T08:00:00:+0000
<h2 id="write_operations_in_the_management_api">Write operations in the Management API</h2>
<p>Write operations in the Management API (e.g. create, update, delete, patch) for Web Property, View (Profile), and Goal resources no longer need to be on the access control list. The default daily limit for all Write operations in the Management API is 50 writes/day. See <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/limits-quotas#write_requests">Limits and Quotas</a> page for more information.</p>
Core Reporting API - Release 2018-01-23 (January 23, 2018)tag:google.com,changelog:analytics-reporting-core#release-2018-01-232018-01-23T08:00:00:+0000
<p>With this release, the <a href="https://developers.google.com/analytics/devguides/reporting/core/v4/resource-based-quota">Resource Based Quota system</a> for the Google Analytics Reporting API v4 is available to all Analytics 360 (Premium) customers.</p>
Real Time Reporting API - Release 2017-11-29 (November 29, 2017)tag:google.com,changelog:analytics-reporting-realtime#release-2017-11-292017-11-29T08:00:00:+0000
<p>This release introduces changes to the <a href="https://developers.google.com/analytics/devguides/reporting/realtime/v3/limits-quotas">Analytics Real Time API quotas and limits</a>.</p>
<p><a href="https://developers.google.com/analytics/devguides/reporting/realtime/v3/">Analytics Real Time Reporting API</a> calls used to contribute to the 10,000 calls per <strong>view (profile)</strong> per day limit on par with other Analytics API calls. Now, Analytics Real Time Reporting API calls are accounted separately, which means it is possible to make 10,000 calls per day per <strong>view (profile)</strong> using the Analytics Real Time Reporting API <strong>AND</strong> make another 10,000 calls per day per <strong>view (profile)</strong> using any other Analytics APIs. See the <a href="https://developers.google.com/analytics/devguides/reporting/realtime/v3/limits-quotas">Limits and Quotas</a> page for more info.</p>
<p>This change provides more granular and fail-safe approach to managing quotas, so that frequent calls using the Analytics Real Time Reporting API would not accidentally block all other Analytics API calls for the rest of the day for an individual profile.</p>
Core Reporting API - Release 2017-11-29 (November 29, 2017)tag:google.com,changelog:analytics-reporting-core#release-2017-11-292017-11-29T08:00:00:+0000
<p>This release increases the maximum number rows returned in the Analytics Reporting API v4 resultset.</p>
<p>The maximum number of rows returned in the <a href="https://developers.google.com/analytics/devguides/reporting/core/v4/rest/v4/reports/batchGet#ReportData">Analytics Reporting API v4 ReportData</a> object is increased from 10,000 to 100,000.</p>
Core Reporting API - Release 2017-10-31 (October 31, 2017)tag:google.com,changelog:analytics-reporting-core#release-2017-10-312017-10-31T08:00:00:+0000
<p>This release adds a preview of the <a href="https://developers.google.com/analytics/devguides/reporting/core/v4/resource-based-quota">Resource Based Quota system</a> for the Google Analytics Reporting API v4, which allows using higher sampling thresholds for Analytics 360 (Premium) customers.</p>
Web Tracking (analytics.js) - Release 2017-09-21 (September 21, 2017)tag:google.com,changelog:analytics-collection-analyticsjs#release-2017-09-212017-09-21T08:00:00:+0000
<p>Added “android-app://” URLs as a valid referral source.</p>
Web Tracking (analytics.js) - Release 2017-07-12 (July 12, 2017)tag:google.com,changelog:analytics-collection-analyticsjs#release-2017-07-122017-07-12T08:00:00:+0000
<p>This release adds the new <a href="https://developers.google.com/analytics/devguides/collection/analyticsjs/tasks#overview">customTask</a> task.</p>
Core Reporting API - Release 2017-06-02 (June 2, 2017)tag:google.com,changelog:analytics-reporting-core#release-2017-06-022017-06-02T08:00:00:+0000
<p>This release deprecates the <a href="https://support.google.com/analytics/answer/6223409">Related Products</a> feature and the associated dimensions and metrics; review the <a href="https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions. Review the <a href="https://developers.google.com/analytics/devguides/reporting/metadata/v3/data-deprecation#remove">Data Deprecation Policy</a> for details on data removal:</p>
<h2 id="related_products">Related products</h2>
<p>This release deprecates the following dimensions and metrics:</p>
<ul>
<li><code>ga:correlationModelId</code></li>
<li><code>ga:queryProductId</code></li>
<li><code>ga:queryProductName</code></li>
<li><code>ga:queryProductVariation</code></li>
<li><code>ga:relatedProductId</code></li>
<li><code>ga:relatedProductName</code></li>
<li><code>ga:relatedProductVariation</code></li>
<li><code>ga:correlationScore</code></li>
<li><code>ga:queryProductQuantity</code></li>
<li><code>ga:relatedProductQuantity</code></li>
</ul>
Management API - Release 2017-04-19 (April 19, 2017)tag:google.com,changelog:analytics-config-mgmt#release-2017-04-192017-04-19T08:00:00:+0000
<h2 id="remarketing_audience__optimize_support">Remarketing Audience - Optimize support</h2>
<p>This release adds support for <a href="https://www.google.com/analytics/optimize/">Google Optimize</a>, <code>OPTIMIZE</code> as a linked ad account type. See the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/remarketingAudience#linkedAdAccounts.type">Remarketing Audience reference docs</a> and the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/remarketing">Remarketing Audience developer guide</a> for details.</p>
Core Reporting API - Release 2017-04-11 (April 11, 2017)tag:google.com,changelog:analytics-reporting-core#release-2017-04-112017-04-11T08:00:00:+0000
<p>This release adds a new dimension to the API; review the <a href="https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions. This release also removes several deprecated dimensions and metrics; review the <a href="https://developers.google.com/analytics/devguides/reporting/core/v4/data-deprecation">Data Deprecation Policy for Google Analytics APIs</a> to understand the full process of data removal.</p>
<h2 id="time">Time</h2>
<ul>
<li>New dimension <code>ga:dateHourMinute</code>, which combines <code>ga:date</code>, <code>ga:hour</code>, and <code>ga:minute</code>.</li>
</ul>
<h2 id="data_removal">Data removal</h2>
<p>This release removes the following deprecated dimensions and metrics:</p>
<ul>
<li><code>ga:socialactivities</code></li>
<li><code>ga:socialactivityaction</code></li>
<li><code>ga:socialactivitydisplayname</code></li>
<li><code>ga:socialactivityendorsingurl</code></li>
<li><code>ga:socialactivitynetworkaction</code></li>
<li><code>ga:socialactivitypost</code></li>
<li><code>ga:socialactivitytagssummary</code></li>
<li><code>ga:socialactivitytimestamp</code></li>
<li><code>ga:socialactivityuserhandle</code></li>
<li><code>ga:socialactivityuserphotourl</code></li>
<li><code>ga:socialactivityuserprofileurl</code></li>
<li><code>ga:socialinteractionspervisit</code></li>
</ul>
Management API - Release 2017-03-23 (March 23, 2017)tag:google.com,changelog:analytics-config-mgmt#release-2017-03-232017-03-23T08:00:00:+0000
<h3 id="remarketing_audience">Remarketing Audience</h3>
<p>This release adds the <code>DELETE</code> verb to the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/remarketingAudience">Remarketing Audience</a> resource. See the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/remarketing">Remarketing Audience developer guide</a> for details.</p>
<ul>
<li><a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/remarketingAudience/delete">Remarketing Audience: delete</a> - deletes a remarketing audience.</li>
</ul>
Core Reporting API - Release 2017-03-08 (March 8, 2017)tag:google.com,changelog:analytics-reporting-core#release-2017-03-082017-03-08T08:00:00:+0000
<p>This release updates existing metrics and dimensions in the API. Review the <a href="https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h2 id="user_metrics">User metrics</h2>
<p>The calculation for <em>Users</em> and <em>Active Users</em> metrics has been updated to more efficiently count users. You may see a small change in your metrics. For more information please see <a href="https://support.google.com/analytics/answer/2992042">How users are identified for users metrics</a>.</p>
<h3 id="user_metrics_affected_by_calculation_update">User metrics affected by calculation update:</h3>
<ul>
<li><code>ga:users</code> - The total number of users for the requested time period.</li>
<li><code>ga:1dayusers</code> - Total number of 1-day active users for each day in the requested time period.</li>
<li><code>ga:7dayusers</code> - Total number of 7-day active users for each day in the requested time period.</li>
<li><code>ga:14dayusers</code> - Total number of 14-day active users for each day in the requested time period.</li>
<li><code>ga:30dayusers</code> - Total number of 30-day active users for each day in the requested time period.</li>
</ul>
<h2 id="unique_events">Unique Events</h2>
<p>We are nearing the end of the deprecation time period for <code>ga:uniqueEvents</code>. After March 26, 2017 the definition for <code>ga:uniqueEvents</code> will be updated and the private <code>ga:uniqueEventsTemporary</code> metric will be removed from the API. For more information, see <a href="https://support.google.com/analytics/answer/7084499">Unique Events help documents</a>.</p>
Core Reporting API - Release 2017-02-14 (February 14, 2017)tag:google.com,changelog:analytics-reporting-core#release-2017-02-142017-02-14T08:00:00:+0000
<p>This release adds a new dimension to the API, improves error messages, and starts enforcing the previously announced changes for AdSense dimensions and metrics.</p>
<h2 id="user_dimensions">User Dimensions</h2>
<ul>
<li>Dimension - <code>ga:userBucket</code> - For any given user, the User Bucket dimension (values 1 to 100) indicates the bucket to which the user has been assigned. See the <a href="https://support.google.com/analytics/answer/6155470">Test remarketing campaigns article</a> for details.</li>
</ul>
<h2 id="error_messages">Error messages</h2>
<p>Where previously the API would return an erroneous error message, <code>Unknown dimension(s):</code> or <code>Unknown metric(s):</code> when requesting data with conditions that have not been met, the API now returns the message: <code>Restricted metric(s): ... can only be queried under certain conditions.</code></p>
<h2 id="adsense_dimensions_and_metrics">AdSense dimensions and metrics</h2>
<p>Non-AdSense linked views will be restricted from querying for AdSense dimensions and metrics. Querying for these dimensions and metrics with a non-AdSense linked views will result in an error.</p>
Management API - Release 2017-02-09 (February 9, 2017)tag:google.com,changelog:analytics-config-mgmt#release-2017-02-092017-02-09T08:00:00:+0000
<h3 id="custom_metrics">Custom Metrics</h3>
<p>This is a bug fix release; it fixes the issue where creating a <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/customMetrics">Custom Metric</a> of type <code>TIME</code> failed when <code>min_value</code> was not set. Requests without a <code>min_value</code> now create a custom metric with a default <code>min_value</code> of <strong>0</strong>.</p>
Core Reporting API - Release 2017-01-11 (January 11, 2017)tag:google.com,changelog:analytics-reporting-core#release-2017-01-112017-01-11T08:00:00:+0000
<p>This is a bug fix release, which fixes an issue with AdSense dimensions and metrics, and announces a forthcoming change to these dimensions and metrics.</p>
<h2 id="adsense_dimensions_and_metrics">AdSense dimensions and metrics</h2>
<p>This release fixes an issue which started on 1/7/2017 in which querying for <a href="/analytics/devguides/reporting/core/dimsmets#view=detail&group=adsense">AdSense dimensions and metrics</a> would return an “Unknown Metric” error for non-AdSense linked views.</p>
<h3 id="coming_changes">Coming changes</h3>
<p>On or after 1/31/2017 non-AdSense linked views will be restricted from querying for AdSense dimensions and metrics. Querying for these dimensions and metrics with a non-AdSense linked views will result in an error.</p>
Core Reporting API - Release 2016-10-12 (October 12, 2016)tag:google.com,changelog:analytics-reporting-core#release-2016-10-122016-10-12T08:00:00:+0000
<p>This release adds the following new metric to the API. Review the <a href="https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h2 id="calculated_metrics">Calculated Metrics</h2>
<p>This release adds support for <a href="https://support.google.com/analytics/answer/6121409">calculated metrics</a>.</p>
<ul>
<li>Metric - <code>ga:calcMetric_<NAME></code> - The value of the requested calculated metric, where <code><NAME></code> refers to the user-defined name of the calculated metric. Note that the data type of <code>ga:calcMetric_<NAME></code> can be FLOAT, INTEGER, CURRENCY, TIME, or PERCENT. For details, see <a href="https://support.google.com/analytics/answer/6121409">About calculated metrics</a>.</li>
</ul>
Core Reporting API - Release 2016-09-26 (September 26, 2016)tag:google.com,changelog:analytics-reporting-core#release-2016-09-262016-09-26T08:00:00:+0000
<p>This release adds a new metric to the API. It also <a href="https://developers.google.com/analytics/devguides/reporting/core/v4/data-deprecation">deprecates</a> an existing metric. Review the <a href="https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h2 id="event_tracking">Event Tracking</h2>
<p>The definition of <code>ga:uniqueEvents</code> will change to more accurately reflect the number of unique events. To affect this change, we will technically deprecate the current <code>ga:uniqueEvents</code> metric in accordance with our <a href="https://developers.google.com/analytics/devguides/reporting/core/v4/data-deprecation">data deprecation policy</a>. If you would like to try out the new definition you can reference the private metric <code>ga:uniqueEventsTemporary</code>, which more accurately calculates the number of unique events. We will also be introducing a new metric <code>ga:uniqueDimensionCombinations</code> which keeps the current definition of <code>ga:uniqueEvents</code>. After the proper deprecation time period (approximately 6 months), the private metric <code>ga:uniqueEventsTemporary</code> will be removed and the original metric <code>ga:uniqueEvents</code> will correctly represent the number of unique events. For more information, see the <a href="https://support.google.com/analytics/answer/7084499">Unique Events help documents</a>.</p>
<h2 id="unique_events">Unique Events</h2>
<ul>
<li>Metric - <code>ga:uniqueEvents</code> - The definition of <code>ga:uniqueEvents</code> will change soon to more accurately reflect the number of unique events. Please use <code>ga:uniqueDimensionCombinations</code> instead if you want to retain the existing definition. For more information, see <a href="https://support.google.com/analytics/answer/7084499">Unique Events help documents</a>.</li>
<li>Metric - <code>ga:uniqueDimensionCombinations</code> - Unique Dimension Combinations counts the number of unique dimension-value combinations for each dimension in a report. This lets you build combined (concatenated) dimensions post-processing, which allows for more flexible reporting without having to update your tracking implementation or use additional custom-dimension slots. For more information, see <a href="https://support.google.com/analytics/answer/7084499">Unique Events help documents</a>.</li>
</ul>
<h2 id="transition_testing__private">Transition Testing – Private</h2>
<ul>
<li>Metric - <code>ga:uniqueEventsTemporary</code> - The number of unique events; this will be the new definition for <code>ga:uniqueEvents</code>. You can use this metric to understand the new definition prior to the change. Note this metric is <strong>private</strong> and will not show up in the <a href="https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a>.</li>
</ul>
iOS SDK - Release Version 3.17 (September 12, 2016)tag:google.com,changelog:analytics-collection-ios#release-2016-09-122016-09-12T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>iOS 10 compatibility and bug fixes.</li>
</ul>
iOS SDK - Release Version 3.16 (August 10, 2016)tag:google.com,changelog:analytics-collection-ios#release-2016-08-102016-08-10T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Crash fixes.</li>
</ul>
Core Reporting API - Release 2016-08-09 (August 9, 2016)tag:google.com,changelog:analytics-reporting-core#release-2016-08-092016-08-09T08:00:00:+0000
<p>This release adds new dimensions and metrics to the API. Review the <a href="https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h2 id="doubleclick_bid_manager">DoubleClick Bid Manager</h2>
<ul>
<li>Dimension - <code>ga:dbmClickAdvertiser</code> - DBM advertiser name of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmClickAdvertiserId</code> - DBM advertiser ID of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmClickCreativeId</code> - DBM creative ID of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmClickExchange</code> - DBM exchange name of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmClickExchangeId</code> - DBM exchange ID of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmClickInsertionOrder</code> - DBM insertion order name of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmClickInsertionOrderId</code> - DBM insertion order ID of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmClickLineItem</code> - DBM line item name of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmClickLineItemId</code> - DBM line item ID of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmClickSite</code> - DBM site name where the DBM creative was shown and clicked on for the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmClickSiteId</code> - DBM site ID where the DBM creative was shown and clicked on for the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmLastEventAdvertiser</code> - DBM advertiser name of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmLastEventAdvertiserId</code> - DBM advertiser ID of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmLastEventCreativeId</code> - DBM creative ID of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmLastEventExchange</code> - DBM exchange name of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmLastEventExchangeId</code> - DBM exchange ID of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmLastEventInsertionOrder</code> - DBM insertion order name of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmLastEventInsertionOrderId</code> - DBM insertion order ID of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmLastEventLineItem</code> - DBM line item name of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmLastEventLineItemId</code> - DBM line item ID of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmLastEventSite</code> - DBM site name where the DBM creative was shown and clicked on for the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Dimension - <code>ga:dbmLastEventSiteId</code> - DBM site ID where the DBM creative was shown and clicked on for the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM).</li>
<li>Metric - <code>ga:dbmCPA</code> - DBM Revenue eCPA (Analytics 360 only, requires integration with DBM).</li>
<li>Metric - <code>ga:dbmCPC</code> - DBM Revenue eCPC (Analytics 360 only, requires integration with DBM).</li>
<li>Metric - <code>ga:dbmCPM</code> - DBM Revenue eCPM (Analytics 360 only, requires integration with DBM).</li>
<li>Metric - <code>ga:dbmCTR</code> - DBM CTR (Analytics 360 only, requires integration with DBM).</li>
<li>Metric - <code>ga:dbmClicks</code> - DBM Total Clicks (Analytics 360 only, requires integration with DBM).</li>
<li>Metric - <code>ga:dbmConversions</code> - DBM Total Conversions (Analytics 360 only, requires integration with DBM).</li>
<li>Metric - <code>ga:dbmCost</code> - DBM Cost (Analytics 360 only, requires integration with DBM).</li>
<li>Metric - <code>ga:dbmImpressions</code> - DBM Total Impressions (Analytics 360 only, requires integration with DBM).</li>
<li>Metric - <code>ga:dbmROAS</code> - DBM ROAS (Analytics 360 only, requires integration with DBM).</li>
</ul>
<h2 id="doubleclick_search">DoubleClick Search</h2>
<ul>
<li>Dimension - <code>ga:dsAdGroup</code> - DS Ad Group (Analytics 360 only, requires integration with DS).</li>
<li>Dimension - <code>ga:dsAdGroupId</code> - DS Ad Group ID (Analytics 360 only, requires integration with DS).</li>
<li>Dimension - <code>ga:dsAdvertiser</code> - DS Advertiser (Analytics 360 only, requires integration with DS).</li>
<li>Dimension - <code>ga:dsAdvertiserId</code> - DS Advertiser ID (Analytics 360 only, requires integration with DS).</li>
<li>Dimension - <code>ga:dsAgency</code> - DS Agency (Analytics 360 only, requires integration with DS).</li>
<li>Dimension - <code>ga:dsAgencyId</code> - DS Agency ID (Analytics 360 only, requires integration with DS).</li>
<li>Dimension - <code>ga:dsCampaign</code> - DS Campaign (Analytics 360 only, requires integration with DS).</li>
<li>Dimension - <code>ga:dsCampaignId</code> - DS Campaign ID (Analytics 360 only, requires integration with DS).</li>
<li>Dimension - <code>ga:dsEngineAccount</code> - DS Engine Account (Analytics 360 only, requires integration with DS).</li>
<li>Dimension - <code>ga:dsEngineAccountId</code> - DS Engine Account ID (Analytics 360 only, requires integration with DS).</li>
<li>Dimension - <code>ga:dsKeyword</code> - DS Keyword (Analytics 360 only, requires integration with DS).</li>
<li>Dimension - <code>ga:dsKeywordId</code> - DS Keyword ID (Analytics 360 only, requires integration with DS).</li>
<li><code>ga:dsCPC</code> - DS Cost to advertiser per click (Analytics 360 only, requires integration with DS).</li>
<li><code>ga:dsCTR</code> - DS Click Through Rate (Analytics 360 only, requires integration with DS).</li>
<li><code>ga:dsClicks</code> - DS Clicks (Analytics 360 only, requires integration with DS).</li>
<li><code>ga:dsCost</code> - DS Cost (Analytics 360 only, requires integration with DS).</li>
<li><code>ga:dsImpressions</code> - DS Impressions (Analytics 360 only, requires integration with DS).</li>
<li><code>ga:dsProfit</code> - DS Profie (Analytics 360 only, requires integration with DS).</li>
<li><code>ga:dsReturnOnAdSpend</code> - DS Return On Ad Spend (Analytics 360 only, requires integration with DS).</li>
<li><code>ga:dsRevenuePerClick</code> - DS Revenue Per Click (Analytics 360 only, requires integration with DS).</li>
</ul>
Management API - Release 2016-08-09 (August 9, 2016)tag:google.com,changelog:analytics-config-mgmt#release-2016-08-092016-08-09T08:00:00:+0000
<h3 id="currencies">Currencies</h3>
<p>This is a bug fix release; it fixes an issue where a subset of currencies were supported in the <a href="https://analytics.google.com">Analytics web interface</a> but not in the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/profiles#currency">API</a>. This release adds support for the following currencies:</p>
<ul>
<li>UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL</li>
</ul>
<p>For more information see: - The <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/profiles#currency">Views (profiles) reference</a>. - The <a href="https://support.google.com/analytics/answer/6205902">Currency reference</a> help center article.</p>
Management API - Release 2016-08-08 (August 8, 2016)tag:google.com,changelog:analytics-config-mgmt#release-2016-08-082016-08-08T08:00:00:+0000
<p>This release adds Remarketing Audiences to the Management API.</p>
<h2 id="remarketing_audieces">Remarketing Audieces</h2>
<p>The Management API allows you to <code>create</code>, <code>get</code>, <code>list</code>, <code>update</code> and <code>patch</code> remarketing audiences for a Google Analytics property. To learn more about how remarketing audiences work, see the <a href="https://support.google.com/analytics/answer/2611268">About Remarketing Audiences in Analytics</a> help center article.</p>
<ul>
<li><a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/remarketing">Remarketing Audience Developer Guide</a></li>
<li><a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/remarketingAudience">Remarketing Audiences Reference</a></li>
</ul>
Multi-Channel Funnels Reporting API - Release 2016-07-14 (July 14, 2016)tag:google.com,changelog:analytics-reporting-mcf#release-2016-07-142016-07-14T08:00:00:+0000
<p>This release adds a new dimension to the API. Check the <a href="
//developers.google.com/analytics/devguides/reporting/mcf/dimsmets/">Dimensions and metrics Reference</a> for the complete list of definitions.</p>
<h3 id="transaction_id">Transaction ID</h3>
<ul>
<li>dimension - <code>mcf:transactionId</code> - The transaction ID, supplied by the ecommerce tracking method, for the purchase in the shopping cart.</li>
</ul>
Core Reporting API - Release 2016-07-14 (July 14, 2016)tag:google.com,changelog:analytics-reporting-core#release-2016-07-142016-07-14T08:00:00:+0000
<p>This release adds a new dimension to the API. This release also adds certain restrictions on the combination of dimensions that can be querried together. Review the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h2 id="geo_network">Geo Network</h2>
<ul>
<li>Dimension - <code>ga:continentId</code> - Users’ continent ID, derived from users’ IP addresses or Geographical IDs.</li>
</ul>
<h2 id="restrictions">Restrictions</h2>
<p>The following dimensions in the following groups cannot be querried with dimensions in the other groups:</p>
<ul>
<li>Visit Shopping Info Group
<ul>
<li><code>ga:checkoutOptions</code></li>
<li><code>ga:shoppingStage</code></li>
</ul>
</li>
<li>GWO Experiment Group
<ul>
<li><code>ga:experimentVariant</code></li>
<li><code>ga:experimentId</code></li>
</ul>
</li>
<li>Interest Group
<ul>
<li><code>ga:interestOtherCategory</code></li>
</ul>
</li>
<li>In Market Interest Group
<ul>
<li><code>ga:interestInMarketCategory</code></li>
</ul>
</li>
<li>Internal Promotion Group:
<ul>
<li><code>ga:internalPromotionCreative</code></li>
<li><code>ga:internalPromotionId</code></li>
<li><code>ga:internalPromotionName</code></li>
<li><code>ga:internalPromotionPosition</code></li>
</ul>
</li>
<li>Branding Interest Group:
<ul>
<li><code>ga:interestAffinityCategory</code></li>
</ul>
</li>
</ul>
Core Reporting API - Release 2016-07-08 (July 8, 2016)tag:google.com,changelog:analytics-reporting-core#release-2016-07-082016-07-08T08:00:00:+0000
<p>This release introduces new limits and quotas. See the <a href="/analytics/devguides/reporting/core/v4/limits-quotas">Limits and Quotas</a> documentation for details.</p>
<h3 id="reporting_errors">Reporting Errors</h3>
<p>This release begins enforcing limits on failed (<code>5XX</code>) <a href="/analytics/devguides/reporting/core/v4/limits-quotas#reporting_errors">reporting requests</a>.</p>
<ul>
<li>10 failed requests per project per profile per hour.</li>
<li>50 failed requests per project per profile per day.</li>
</ul>
<h3 id="pivot_limits">Pivot limits</h3>
<p>This release begins enforcing limits on pivot requests:</p>
<ul>
<li>A report request can now have a maximum of 2 <a href="/analytics/devguides/reporting/core/v4/rest/v4/reports/batchGet#ReportRequest.FIELDS.pivots">pivots</a>.</li>
<li>A pivot can have a maximum of 4 <a href="/analytics/devguides/reporting/core/v4/rest/v4/reports/batchGet#Pivot.FIELDS.dimensions">dimensions</a>.</li>
<li>Pivot <a href="/analytics/devguides/reporting/core/v4/rest/v4/reports/batchGet#Pivot.FIELDS.dimensions">dimensions</a> are part of the restriction on the total number of dimensions allowed in the request.</li>
<li>Pivot <a href="/analytics/devguides/reporting/core/v4/rest/v4/reports/batchGet#Pivot.FIELDS.metrics">metrics</a> are part of the restriction on the total number of metrics allowed in the request.</li>
</ul>
Core Reporting API - Release 2016-06-17 (June 17, 2016)tag:google.com,changelog:analytics-reporting-core#release-2016-06-172016-06-17T08:00:00:+0000
<p>This release adds new dimensions and metrics to the API. Review the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="geo_network">Geo Network</h3>
<ul>
<li>Dimension - <code>ga:metroId</code> - The three digit Designated Market Area (DMA) code from where traffic arrived, derived from users’ IP addresses or Geographical IDs.</li>
</ul>
<h3 id="doubleclick_for_publishers">DoubleClick for Publishers</h3>
<ul>
<li>Metric - <code>ga:dfpImpressions</code> - A DFP ad impression is reported whenever an individual ad is displayed on the website. For example, if a page with two ad units is viewed once, we’ll display two impressions (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:dfpCoverage</code> - Coverage is the percentage of ad requests that returned at least one ad. Generally, coverage can help identify sites where the DFP account isn’t able to provide targeted ads. (Ad Impressions / Total Ad Requests) * 100 (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:dfpMonetizedPageviews</code> - This measures the total number of pageviews on the property that were shown with an ad from the linked DFP account. Note that a single page can have multiple ad units (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:dfpImpressionsPerSession</code> - The ratio of DFP ad impressions to Analytics sessions (Ad Impressions / Analytics Sessions) (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:dfpViewableImpressionsPercent</code> - The percentage of viewable ad impressions. An impression is considered a viewable impression when it has appeared within users’ browsers and has the opportunity to be seen (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:dfpClicks</code> - The number of times DFP ads were clicked on the site (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:dfpCTR</code> - The percentage of pageviews that resulted in a click on an DFP ad (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:dfpRevenue</code> - DFP revenue is an estimate of the total ad revenue based on served impressions (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:dfpRevenuePer1000Sessions</code> - The total estimated revenue from DFP ads per 1,000 Analytics sessions. Note that this metric is based on sessions to the site, not on ad impressions (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:dfpECPM</code> - The effective cost per thousand pageviews. It is the DFP revenue per 1,000 pageviews (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:backfillImpressions</code> - Backfill Impressions is the sum of all AdSense or Ad Exchance ad impressions served as backfill through DFP. An ad impression is reported whenever an individual ad is displayed on the website. For example, if a page with two ad units is viewed once, we’ll display two impressions (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:backfillCoverage</code> - Backfill Coverage is the percentage of backfill ad requests that returned at least one ad. Generally, coverage can help identify sites where the publisher account isn’t able to provide targeted ads. (Ad Impressions / Total Ad Requests) * 100. If both AdSense and Ad Exchange are providing backfill ads, this metric is the weighted average of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:backfillMonetizedPageviews</code> - This measures the total number of pageviews on the property that were shown with at least one ad from the linked backfill account(s). Note that a single monetized pageview can include multiple ad impressions (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:backfillImpressionsPerSession</code> - The ratio of backfill ad impressions to Analytics sessions (Ad Impressions / Analytics Sessions). If both AdSense and Ad Exchange are providing backfill ads, this metric is the sum of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:backfillViewableImpressionsPercent</code> - The percentage of backfill ad impressions that were viewable. An impression is considered a viewable impression when it has appeared within the users’ browsers and had the opportunity to be seen. If AdSense and Ad Exchange are both providing backfill ads, this metric is the weighted average of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:backfillClicks</code> - The number of times backfill ads were clicked on the site. If AdSense and Ad Exchange are both providing backfill ads, this metric is the sum of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:backfillCTR</code> - The percentage of backfill impressions that resulted in a click on an ad. If AdSense and Ad Exchange are both providing backfill ads, this metric is the weighted average of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:backfillRevenue</code> - The total estimated revenue from backfill ads. If AdSense and Ad Exchange are both providing backfill ads, this metric is the sum of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:backfillRevenuePer1000Sessions</code> - The total estimated revenue from backfill ads per 1,000 Analytics sessions. Note that this metric is based on sessions to the site and not ad impressions. If both AdSense and Ad Exchange are providing backfill ads, this metric is the sum of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
<li>Metric - <code>ga:backfillECPM</code> - The effective cost per thousand pageviews. It is the DFP Backfill Revenue per 1,000 pageviews. If both AdSense and Ad Exchange are providing backfill ads, this metric is the sum of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled).“</li>
</ul>
Core Reporting API - Release 2016-05-18 (May 18, 2016)tag:google.com,changelog:analytics-reporting-core#release-2016-05-182016-05-18T08:00:00:+0000
<p>This is a bug fix release, which fixes an issue with segments and sampling.</p>
<h3 id="segments">Segments</h3>
<p>This release fixes an issue which would cause a subset of requests with the <strong>All Users</strong> <a href="/analytics/devguides/reporting/core/v4/basics#segment_id">segment</a> (<code>gaid::-1</code>) to be undercounted in the <a href="/analytics/devguides/reporting/core/v3/">Core Reporting API V3</a> and to be split into two segments in the <a href="/analytics/devguides/reporting/core/v4/">Analytics Reporting API V4</a>.</p>
<h3 id="sampling">Sampling</h3>
<p>This release fixes an issue where a subset of requests from <a href="https://support.google.com/analytics/answer/2774517">custom tables</a> would return <a href="/analytics/devguides/reporting/core/v4/basics#sampling">sampled data</a>.</p>
Core Reporting API - Release 2016-04-29 (April 29, 2016)tag:google.com,changelog:analytics-reporting-core#release-2016-04-292016-04-29T08:00:00:+0000
<p>This is a bug fix release, which fixes an issue when making <a href="/analytics/devguides/reporting/core/v4/advanced#cohorts">Analytics Reporting API V4 cohort</a> requests.</p>
<h3 id="cohort_requests">Cohort requests</h3>
<p>Cohort requests can now ask for all <a href="/analytics/devguides/reporting/core/v4/advanced#dimensions">cohort dimensions</a>; previously the API would return an error when requesting for <code>ga:acquisition...</code> dimensions.</p>
<h3 id="lifetime_value_request_ltv">Lifetime value request LTV</h3>
<p>Please note that <a href="/analytics/devguides/reporting/core/v4/advanced#lifetime_value_ltv">lifetime value requests</a> can generate <a href="https://support.google.com/analytics/answer/6182550">lifetime Value reports</a> for <a href="https://support.google.com/analytics/answer/2649553#WebVersusAppViews">app views</a> only.</p>
Metadata API - Release 2016-04-08 (April 8, 2016)tag:google.com,changelog:analytics-reporting-metadata#release-2016-04-082016-04-08T08:00:00:+0000
<p>This release adds a new attribute <code>addedInApiVersion</code>.</p>
<h3 id="added_in_api_version">Added in API Version</h3>
<ul>
<li>The <code>addedInApiVersion</code> is a numeric attribute which can be used to check whether a column can be used in a reporting API of a specified version; see the <a href="
https://developers.google.com/analytics/devguides/reporting/metadata/v3/devguide#api-version">Metadata API - Developer Guide</a> for details.</li>
</ul>
Core Reporting API - Release 2016-04-08 (April 8, 2016)tag:google.com,changelog:analytics-reporting-core#release-2016-04-082016-04-08T08:00:00:+0000
<p>This release announces a new version of the API, the <a href="
https://developers.google.com/analytics/devguides/reporting/core/v4/">Analytics Reporting API V4</a>. This new API is the most advanced programmatic method to access report data in Google Analytics.</p>
<h4 id="key_features">Key Features</h4>
<p>Google Analytics is built upon a powerful data reporting infrastructure. The API gives developers access to the power of the Google Analytics platform. Some key features in the Analytics Reporting API V4 include the following:</p>
<ul>
<li>Metric Expressions - The API allows you to request not only the built-in metrics but also mathematical metric expressions. For example goal completions per number of sessions can be expressed in the request as <code>ga:goal1completions/ga:sessions</code>.</li>
<li>Multiple date ranges - Support for requesting two date ranges, allowing you to compare data for two periods in a single request.</li>
<li>Cohorts and Lifetime value - The API has a rich vocabulary to request Cohort and Lifetime value reports.</li>
<li>Multiple segments - You can now request multiple segments in a single request.</li>
</ul>
<h4 id="getting_started">Getting Started</h4>
<p>See the <a href="
https://developers.google.com/analytics/devguides/reporting/core/v4/#next-steps">developer documention</a> for all the details on getting started with the API.</p>
<h4 id="quota_policy">Quota Policy</h4>
<p>The Analytics Reporting API V4 comes with its own <a href="
https://developers.google.com/analytics/devguides/reporting/core/v4/limits-quotas#analytics_reporting_api_v4">quotas and limits</a>; as this is a new API, these limits and quotas are subject to be changed.</p>
<h4 id="migration">Migration</h4>
<p>Along with a <a href="
https://developers.google.com/analytics/devguides/reporting/core/v4/migration">migration guide</a>, we also make a <a href="
https://developers.google.com/analytics/devguides/reporting/core/v4/migration#python_migration">Python compatibility library</a> available on <a href="https://github.com/googleanalytics/gav4-python">Github</a>.</p>
<h4 id="dimensions_and_metrics">Dimensions and Metrics</h4>
<p>This release also adds a set of dimensions and metrics specifically for Analytics Reporting API V4. See the <a href="developers.google.com/analytics/devguides/reporting/core/dimsmets">dimensions and metrics explorer</a> for the full list definitions.</p>
<ul>
<li>
<p>Dimension - <code>ga:cohort</code> - Name of the cohort a user belongs to based on the cohorts definition. Depending on how cohorts are defined, a user can belong to multiple cohorts, similar to how a user can belong to multiple segments.</p>
</li>
<li>
<p>Dimension - <code>ga:cohortNthDay</code> - 0-based day offset relative to the cohort definition date. For example, if a cohort is defined with the first visit date as 2015-09-01, then for the date 2015-09-04, ga:cohortNthDay will be 3.</p>
</li>
<li>
<p><code>ga:cohortNthMonth</code> - 0-based month offset relative to the cohort definition date.</p>
</li>
<li>
<p>Dimension - <code>ga:cohortNthWeek</code> - 0-based week offset relative to the cohort definition date.</p>
</li>
<li>
<p>Dimension - <code>ga:acquisitionTrafficChannel</code> - Traffic channel through which the user was acquired. It is extracted from the first session of the user. Traffic channel is computed based on the default channel grouping rules (at view level if available) at the time of user acquisition.</p>
</li>
<li>
<p>Dimension - <code>ga:acquisitionSource</code> - The source through which the user was acquired. Derived from the first session of the user.</p>
</li>
<li>
<p>Dimension - <code>ga:acquisitionMedium</code> - The medium through which the user was acquired. Derived from the first session of the user.</p>
</li>
<li>
<p>Dimension - <code>ga:acquisitionSourceMedium</code> - The combined value of ga:userAcquisitionSource and ga:acquisitionMedium.</p>
</li>
<li>
<p>Dimension - <code>ga:acquisitionCampaign</code> The campaign through which the user was acquired. Derived from the first session of the user.</p>
</li>
<li>
<p>Metric - <code>ga:cohortActiveUsers</code> - This metric is relevant in the context of the 0-based offset dimensions (<code>ga:cohortNthDay</code>, <code>ga:cohortNthWeek</code>, or <code>ga:cohortNthMonth</code>). It indicates number of users in the cohort who are active in the time window corresponding to the cohort nth day/week/month. For example, for <code>ga:cohortNthWeek = 1</code>, number of users (in the cohort) who are active in the second week. If a request does not have any of <code>ga:cohortNthDay</code>, <code>ga:cohortNthWeek</code>, or <code>ga:cohortNthMonth</code>, this metric will have the same value as <code>ga:cohortTotalUsers</code>.</p>
</li>
<li>
<p>Metric - <code>ga:cohortTotalUsers</code> - Number of users belonging to the cohort, also known as cohort size.</p>
</li>
<li>
<p>Metric - <code>ga:cohortAppviewsPerUser</code> - App views per user for a cohort.</p>
</li>
<li>
<p>Metric - <code>ga:cohortGoalCompletionsPerUser</code> - Goal completions per user for a cohort.</p>
</li>
<li>
<p>Metric - <code>ga:cohortPageviewsPerUser</code> - Pageviews per user for a cohort.</p>
</li>
<li>
<p>Metric - <code>ga:cohortRetentionRate</code> - Cohort retention rate.</p>
</li>
<li>
<p>Metric - <code>ga:cohortRevenuePerUser</code> - Revenue per user for a cohort.</p>
</li>
<li>
<p>Metric - <code>ga:cohortVisitDurationPerUser</code> - Session duration per user for a cohort.</p>
</li>
<li>
<p>Metric - <code>ga:cohortSessionsPerUser</code> - Sessions per user for a cohort.</p>
</li>
<li>
<p>Metric - <code>ga:cohortTotalUsersWithLifetimeCriteria</code> - This is relevant in the context of a request which has the dimensions <code>ga:acquisitionTrafficChannel</code>, <code>ga:acquisitionSource</code>, <code>ga:acquisitionMedium</code>, or <code>ga:acquisitionCampaign</code>. It represents the number of users in the cohorts who are acquired through the current channel, source, medium, or campaign. For example, for <code>ga:acquisitionTrafficChannel=Direct</code>, it represents the number users in the cohort, who were acquired directly. If none of the mentioned dimensions are present, then its value is equal to <code>ga:cohortTotalUsers</code>.</p>
</li>
<li>
<p>Metric - <code>ga:cohortAppviewsPerUserWithLifetimeCriteria</code> - App views per user for the acquisition dimension for a cohort.</p>
</li>
<li>
<p>Metric - <code>ga:cohortGoalCompletionsPerUserWithLifetimeCriteria</code> - Goal completions per user for the acquisition dimension for a cohort.</p>
</li>
<li>
<p>Metric - <code>ga:cohortPageviewsPerUserWithLifetimeCriteria</code> - Pageviews per user for the acquisition dimension for a cohort.</p>
</li>
<li>
<p>Metric - <code>ga:cohortRevenuePerUserWithLifetimeCriteria</code> - Revenue per user for the acquisition dimension for a cohort.</p>
</li>
<li>
<p>Metric - <code>ga:cohortSessionsPerUserWithLifetimeCriteria</code> - Session duration per user for the acquisition dimension for a cohort.</p>
</li>
</ul>
Core Reporting API - Release 2016-03-30 (March 30, 2016)tag:google.com,changelog:analytics-reporting-core#release-2016-03-302016-03-30T08:00:00:+0000
<p>The Social Data Hub dimensions and metrics have been deprecated and will only report on historical data starting after <strong>April 30th, 2016</strong>; after this date no new data will appear. As per the <a href="
https://developers.google.com/analytics/devguides/reporting/metadata/v3/data-deprecation#remove">Data Deprecation Policy</a>, these dimensions and metrics will be removed after <strong>September 30th, 2016</strong>.</p>
<p>Review the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="social_activities">Social Activities</h3>
<p>These dimensions and metrics have been deprecated and will be removed after <strong>September 30th, 2016</strong>. Review the <a href="https://developers.google.com/analytics/devguides/reporting/metadata/v3/data-deprecation#remove">Data Deprecation Policy</a> for details on data removal:</p>
<ul>
<li>Dimension - <code>ga:socialActivityEndorsingUrl</code> - For a social data hub activity, this is the URL of the social activity (e.g., the Google+ post URL, the blog comment URL, etc.).</li>
<li>Dimension - <code>ga:socialActivityDisplayName</code> - For a social data hub activity, this is the title of the social activity posted by the social network users.</li>
<li>Dimension - <code>ga:socialActivityPost</code> - For a social data hub activity, this is the content of the social activity (e.g., the content of a message posted in Google+) posted by social network users.</li>
<li>Dimension - <code>ga:socialActivityTimestamp</code> - For a social data hub activity, this is the time when the social activity occurred on the social network.</li>
<li>Dimension - <code>ga:socialActivityUserHandle</code> - For a social data hub activity, this is the social network handle (e.g., name or ID) of users who initiated the social activity.“</li>
<li>Dimension - <code>ga:socialActivityUserPhotoUrl</code> - For a social data hub activity, this is the URL of the photo associated with users’ social network profiles.“</li>
<li>Dimension - <code>ga:socialActivityUserProfileUrl</code> - For a social data hub activity, this is the URL of the associated users’ social network profiles.</li>
<li>Dimension - <code>ga:socialActivityTagsSummary</code> - For a social data hub activity, this is a comma-separated set of tags associated with the social activity.“</li>
<li>Dimension - <code>ga:socialActivityAction</code> - For a social data hub activity, this represents the type of social action (e.g., vote, comment, +1, etc.) associated with the activity.</li>
<li>Dimension - <code>ga:socialActivityNetworkAction</code> - For a social data hub activity, this is the type of social action and the social network where the activity originated.</li>
<li>Dimension - <code>ga:socialActivityContentUrl</code> - For a social data hub activity, this is the URL shared by the associated social network users.</li>
<li>Metric - <code>ga:socialActivities</code> - Total number of activities where a content URL was shared or mentioned on a social data hub partner network.</li>
</ul>
Management API - Release 2016-03-11 (March 11, 2016)tag:google.com,changelog:analytics-config-mgmt#release-2016-03-112016-03-11T08:00:00:+0000
<h3 id="starring">Starring</h3>
<p>This release adds the <code>starred</code> property to <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/accountSummaries#starred">Account Summaries</a>, <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/accounts#starred">Accounts</a>, <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/webproperties#starred">Web Properties</a>, and <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/profiles#starred">Views (Profiles)</a>.</p>
Management API - Release 2016-02-25 (February 25, 2016)tag:google.com,changelog:analytics-config-mgmt#release-2016-02-252016-02-25T08:00:00:+0000
<h3 id="error_rate_limiting">Error rate limiting</h3>
<p>It has always been our policy that developers should <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/errors#backoff">implement exponential backoff</a>, when handling <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/errors#500">500 or 503 responses</a>. Today we are introducing a <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/limits-quotas#write_error">rate limit on 500 and 503 errors</a> to enforce this policy.</p>
<ul>
<li>50 failed write requests per hour.</li>
</ul>
Core Reporting API - Release 2016-02-03 (February 3, 2016)tag:google.com,changelog:analytics-reporting-core#release-2016-02-032016-02-03T08:00:00:+0000
<p>This release adds a new dimension to the API. Review the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="platform_or_device">Platform or Device</h3>
<ul>
<li>Dimension - <code>ga:browserSize</code> - The viewport size of the users’ browsers. Browser size is a session scoped dimension which captures the initial dimensions of the viewport in pixels and is formatted as width X height. For example, 1920x960.</li>
</ul>
Management API - Release 2016-02-01 (February 1, 2016)tag:google.com,changelog:analytics-config-mgmt#release-2016-02-012016-02-01T08:00:00:+0000
<h3 id="unsampled_reports">Unsampled Reports</h3>
<p>The unsampled reports API no longer has a 100 reports per day limit. The API uses the same <a href="https://support.google.com/analytics/answer/2601061">per-property, per-day</a> token system as when creating an unsampled report through the web interface.</p>
Management API - Release 2016-01-26 (January 26, 2016)tag:google.com,changelog:analytics-config-mgmt#release-2016-01-262016-01-26T08:00:00:+0000
<h3 id="unsampled_reports">Unsampled Reports</h3>
<p>Unsampled reports that are not accessible to the current user will no longer have a download link inside the Management API response message. This behavior is now consistent with UI dashboard functionality where only report owners can see the download link for the generated document.</p>
Management API - Release 2015-12-17 (December 17, 2015)tag:google.com,changelog:analytics-config-mgmt#release-2015-12-172015-12-17T08:00:00:+0000
<h3 id="views_profiles">Views (Profiles)</h3>
<p>This release adds the <code>botFilteringEnabled</code> property to the view (profile) resource. This property indicates whether bot filtering is enabled for a view (profile). See the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/profiles#botFilteringEnabled">View (Profiles) Reference docs</a> for details.</p>
<h3 id="unsampled_reports">Unsampled Reports</h3>
<p>This release add the <code>delete</code> method to unsampled reports. See the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/unsampledReports/delete">Unsampled Reports Delete Reference docs</a> for details.</p>
iOS SDK - Release Version 3.15 (November 23, 2015)tag:google.com,changelog:analytics-collection-ios#release-2015-11-232015-11-23T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>No change.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Fixed <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=772">an issue</a> which would cause a crash when running the unit tests.</li>
</ul>
Management API - Release 2015-11-17 (November 17, 2015)tag:google.com,changelog:analytics-config-mgmt#release-2015-11-172015-11-17T08:00:00:+0000
<h3 id="segments">Segments</h3>
<p>This is a bug fix release. This release fixes an issue which would cause segments with currency values in the definition to appear incorrectly when calling the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/segments/list">segments list method</a>.</p>
Core Reporting API - Release 2015-11-16 (November 16, 2015)tag:google.com,changelog:analytics-reporting-core#release-2015-11-162015-11-16T08:00:00:+0000
<p>This release adds a new parameter to the API.</p>
<h3 id="include_empty_rows">Include Empty Rows</h3>
<ul>
<li>This release adds the new optional parameter <code>include-empty-rows</code>, which when set to <code>false</code> rows without data will be omitted from the response. The default value is <code>true</code>, which is a non breaking change, and as such should not require a code update. See the <a href="
https://developers.google.com/analytics/devguides/reporting/core/v3/reference">Core Reporting API reference documentation</a> for details.</li>
</ul>
iOS SDK - Release Version 3.14 (October 23, 2015)tag:google.com,changelog:analytics-collection-ios#release-2015-10-232015-10-23T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Added support for bitcode.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Added support for bitcode.</li>
</ul>
Core Reporting API - Release 2015-10-06 (October 6, 2015)tag:google.com,changelog:analytics-reporting-core#release-2015-10-062015-10-06T08:00:00:+0000
<p>This release adds new metrics to the API. Review the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="user">User</h3>
<ul>
<li>Metric - <code>ga:1dayUsers</code> - Total number of 1-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension in order to query this metric. For the given date the returned value will be the total unique users for the 1 day period ending on the given date.</li>
<li>Metric - <code>ga:7dayUsers</code> - Total number of 7-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension in order to query this metric. For the given date the returned value will be the total unique users for the 7 day period ending on the given date.</li>
<li>Metric - <code>ga:14dayUsers</code> - Total number of 14-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension in order to query this metric. For the given date the returned value will be the total unique users for the 14 day period ending on the given date.</li>
<li>Metric - <code>ga:30dayUsers</code> - Total number of 30-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension in order to query this metric. For the given date the returned value will be the total unique users for the 30 day period ending on the given date.</li>
</ul>
Management API - Release 2015-10-06 (October 6, 2015)tag:google.com,changelog:analytics-config-mgmt#release-2015-10-062015-10-06T08:00:00:+0000
<h3 id="segments">Segments</h3>
<p>This is a bug fix release. This release fixes an issue which would cause users with private segments pinned to multiple views (profiles) to get a <code>500</code> error response when calling the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/segments/list">segments list method</a>.</p>
Core Reporting API - Release 2015-09-11 (September 11, 2015)tag:google.com,changelog:analytics-reporting-core#release-2015-09-112015-09-11T08:00:00:+0000
<p>This release adds new metrics to the API. Review the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="doubleclick_ad_exchange_adx">DoubleClick Ad Exchange (AdX)</h3>
<ul>
<li>Metric - <code>ga:adxCTR</code> - The percentage of pageviews that resulted in a click on an AdX ad.</li>
<li>Metric - <code>ga:adxClicks</code> - The number of times AdX ads were clicked on your site.</li>
<li>Metric - <code>ga:adxCoverage</code> - Coverage is the percentage of ad requests that returned at least one ad. Generally, coverage can help you identify sites where your AdX account isn’t able to provide targeted ads. (Ad Impressions / Total Ad Requests) * 100</li>
<li>Metric - <code>ga:adxECPM</code> - The effective cost per thousand pageviews. It is your AdX Revenue per 1000 pageviews.</li>
<li>Metric - <code>ga:adxImpressions</code> - An AdX ad impression is reported whenever an individual ad is displayed on your website. For example, if a page with two ad units is viewed once, we’ll display two impressions.</li>
<li>Metric - <code>ga:adxImpressionsPerSession</code> - The ratio of AdX ad impressions to Analytics sessions (Ad Impressions / Analytics Sessions).</li>
<li>Metric - <code>ga:adxMonetizedPageviews</code> - Monetized Pageviews measures the total number of pageviews on your property that were shown with an ad from your linked AdX account. Note: A single page can have multiple ad units.</li>
<li>Metric - <code>ga:adxRevenue</code> - The total estimated revenue from AdX ads.</li>
<li>Metric - <code>ga:adxRevenuePer1000Sessions</code> - The total estimated revenue from AdX ads per 1000 Analytics sessions. Note that this metric is based on sessions to your site and not ad impressions.</li>
<li>Metric - <code>ga:adxViewableImpressionsPercent</code> - The percentage of ad impressions that were viewable. An impression is considered a viewable impression when it has appeared within a user’s browser and had the opportunity to be seen.</li>
</ul>
Provisioning API - Release 2015-09 (September 10, 2015)tag:google.com,changelog:analytics-config-provisioning#release-2015-09-102015-09-10T08:00:00:+0000
<p>This release adds an additional parameter to the <a href="
https://developers.google.com/analytics/devguides/config/provisioning/v3/devguide#technical-tos-flow-url">Provisioning API TOS URL</a>:</p>
<ul>
<li>The addition of the URL parameter, <code>provisioningSignup=false</code>, fixes an issue which occurs when provisioning a Google Analytics account for a user without any Google Analytics accounts. Developers should update their code to add this parameter to the TOS URL.</li>
</ul>
Management API - Release 2015-09-03 (September 3, 2015)tag:google.com,changelog:analytics-config-mgmt#release-2015-09-032015-09-03T08:00:00:+0000
<h3 id="batching">Batching</h3>
<p>With this release, in addition to general <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/batching">batching support</a>, we have added special support for the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtUserPermissions#batching">User Permissions API</a>. Batched User Permissions requests will see significant performance gains and reduced quota usage.</p>
Management API - Release 2015-08-06 (August 6, 2015)tag:google.com,changelog:analytics-config-mgmt#release-2015-08-062015-08-06T08:00:00:+0000
<h3 id="views_profiles">Views (Profiles)</h3>
<p>With this release the View (Profile) <code>currency</code> property will now default to <em>USD</em> if not set during an <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/profiles/insert">insert</a> operation. Also <code>get</code> and <code>list</code> operations will return <em>USD</em> on Views (Profiles) that were previously created without a <code>currency</code> property.</p>
<ul>
<li>
<p>Please see the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtProfileGuide">View (Profile) developer guide</a> for details on using View (Profiles) in the Management API.</p>
</li>
<li>
<p>Please see the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/profiles">View (Profiles) reference</a> for the complete list of parameters for the View (Profile) resource.</p>
</li>
</ul>
Core Reporting API - Release 2015-07-23 (July 23, 2015)tag:google.com,changelog:analytics-reporting-core#release-2015-07-232015-07-23T08:00:00:+0000
<p>This release deprecates existing dimensions or metrics. Review the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="deprecated_dimensions">Deprecated Dimensions</h3>
<p>These dimensions have been deprecated. Review the <a href="https://developers.google.com/analytics/devguides/reporting/metadata/v3/data-deprecation#remove">Data Deprecation Policy</a> for details on data removal:</p>
<ul>
<li>Dimension - <code>ga:adSlotPosition</code> - Use <code>ga:adSlot</code> instead.</li>
<li>Dimension - <code>ga:nextPagePath</code> - Use <code>ga:pagePath</code> instead.</li>
<li>Dimension - <code>ga:nextContentGroupXX</code> - Use <code>ga:contentGroupXX</code> instead.</li>
</ul>
iOS SDK - Release Version 3.13 (July 21, 2015)tag:google.com,changelog:analytics-collection-ios#release-2015-07-212015-07-21T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Fixed an issue which caused crashes when using setCampaignParametersFromUrl. <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=636">Issue 636</a>.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>No change.</li>
</ul>
Management API - Release 2015-05-28 (May 28, 2015)tag:google.com,changelog:analytics-config-mgmt#release-2015-05-282015-05-28T08:00:00:+0000
<h3 id="filters">Filters</h3>
<p>This release marks the final removal of the deprecated filter fields <code>IS_MOBILE</code> and <code>IS_TABLET</code>, which should be replaced with <code>DEVICE_CATEGORY=mobile</code> and <code>DEVICE_CATEGORY=tablet</code>. Insert, update and patch requests which set the filter fields to use <code>IS_MOBILE</code> and <code>IS_TABLET</code> will return an error.</p>
<ul>
<li>
<p>Please see the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtFilterGuide">Filter developer guide</a> for details on using filters in the Management API.</p>
</li>
<li>
<p>Please see the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/filters">Filters reference</a> for the complete list of parameters for the Filter resource.</p>
</li>
</ul>
iOS SDK - Release Version 3.12 (May 11, 2015)tag:google.com,changelog:analytics-collection-ios#release-2015-05-112015-05-11T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>No change.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Fixed a class name conflict. <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=631">Issue 631</a>.</li>
</ul>
Core Reporting API - Release 2015-05-06 (May 6, 2015)tag:google.com,changelog:analytics-reporting-core#release-2015-05-062015-05-06T08:00:00:+0000
<p>This release adds a new dimension to the API. Review <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of dimensions and metrics.</p>
<h3 id="adwords">Adwords</h3>
<ul>
<li>Dimension - <code>ga:adQueryWordCount</code> - The number of words in the search query.</li>
</ul>
Management API - Release 2015-05-05 (May 5, 2015)tag:google.com,changelog:analytics-config-mgmt#release-2015-05-052015-05-05T08:00:00:+0000
<h3 id="filters">Filters</h3>
<p>This release adds support to use a custom dimension for a filter field by adding a <code>fieldIndex</code> property to all the filter details sections. For example it is now possible to set the filter expression with a <code>"field": "CUSTOM_DIMENSION"</code> and the <code>"fieldIndex": "1"</code> to have the filter work on the first custom dimension.</p>
<ul>
<li>
<p>Please see the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtFilterGuide">Filter developer guide</a> for details on using filters in the Management API.</p>
</li>
<li>
<p>Please see the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/filters">Filters reference</a> for complete list of parameters for the Filter resource.</p>
</li>
</ul>
<h3 id="goals">Goals</h3>
<p>This release also fixes an issue when creating a goal with <code>"comparisonValue": "0"</code> would fail.</p>
<ul>
<li>
<p>Please see the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtGoalGuide">Goal developer guide</a> for details on using goals in the Management API.</p>
</li>
<li>
<p>Please see the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/goals">Goals reference</a> for complete list of parameters for the Goal resource.</p>
</li>
</ul>
Android SDK - Release Version 4.5 - Google Play Services 7.3 (May 1, 2015)tag:google.com,changelog:analytics-collection-android#release-2015-05-012015-05-01T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Added support for background dispatching on non-Google Play Devices.</li>
<li>Deprecated Analytics Logger/LogLevel. Analytics is now using Android logging instead. To enable debug logging run <code>adb shell setprop log.tag.GAv4 DEBUG</code>.</li>
<li>Refactoring to improve data delivery and install campaign attribution.</li>
<li>Campaign parsing bug fixed. <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=596">Issue 596</a>.</li>
<li>Unhandled app exceptions during the first seconds of the Analytics initialization are correctly reported. <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=443">Issue 443</a>.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>No changes.</li>
</ul>
iOS SDK - Release Version 3.11 (April 30, 2015)tag:google.com,changelog:analytics-collection-ios#release-2015-04-302015-04-30T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Report screen resolution using nativeBounds on iOS 8.0 and newer. This addresses <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=504">Issue 504</a>.</li>
<li>Added support for click-related campaign parameters.</li>
<li>Report iOS hardware model in addition to the device OS version. This addresses <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=408">Issue 408</a>.</li>
<li>Report iAd install attribution on iOS 7.1 and newer. This requires the iAd framework.</li>
<li>Added deprecation warning for the appview hit type.</li>
<li>sqlite3 is now a required library.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Fixed a nil string crash in TAGDispatcher.</li>
</ul>
Web Tracking (analytics.js) - Release 2015-04-13 (April 13, 2015)tag:google.com,changelog:analytics-collection-analyticsjs#release-2015-04-132015-04-13T08:00:00:+0000
<p>This release contains the addition of a new field. Review the <a href="
https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference">Field Reference</a> for the complete list of fields.</p>
<h3 id="transport">Transport</h3>
<ul>
<li>The <a href="
https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#transport">transport</a> field allows you to set the mechanism with which hits will be sent.</li>
</ul>
<h3 id="other_changes">Other Changes</h3>
<ul>
<li>The <code>useBeacon</code> option is deprecated.</li>
<li>Bug fixes</li>
</ul>
Android SDK - Release Version 4.0.6 - Google Play Services 7.0 (March 19, 2015)tag:google.com,changelog:analytics-collection-android#release-2015-03-192015-03-19T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Fixed <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=440">Issue 440: CampaignTrackingService NullPointerException</a></li>
<li>Fixed <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=552">Issue 552: GoogleAnalytics.getInstance() is blocking</a></li>
<li>Fixed <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=564">Issue 564: Analytics auto activity reporting throws UnsupportedOperationException</a></li>
<li>Minor bug fixes.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Minor bug fixes.</li>
</ul>
Management API - Release 2015-03-13 (March 13, 2015)tag:google.com,changelog:analytics-config-mgmt#release-2015-03-132015-03-13T08:00:00:+0000
<p>This release marks the final turndown and removal of the <code>dailyUpload</code> resouce. The <code>dailyUpload</code> resource was officially deprecated on June 20, 2014; all cost data import should now be done using the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/uploads">uploads resource</a>.</p>
<ul>
<li>Please see the <a href="https://developers.google.com/analytics/devguides/reporting/core/v3/data-deprecation">Data Deprecation Policy</a> for more details on the Google Analytics API’s deprecation process.</li>
<li>See the <a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtDataImport">Data Import Developer Guide</a> for details on how to use to import data into Google Analytics.</li>
</ul>
Core Reporting API - Release 2015-02-20 (February 20, 2015)tag:google.com,changelog:analytics-reporting-core#release-2015-02-202015-02-20T08:00:00:+0000
<p>This release adds new dimensions to the API. Review <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of dimensions and metrics.</p>
<h3 id="platform_or_device">Platform or Device</h3>
<ul>
<li>Dimension - <code>ga:dataSource</code> - The data source of a hit. Hits sent from ga.js and analytics.js are reported as “web”; hits sent from the mobile SDKs are reported as “app”. These values can be overridden.</li>
</ul>
<h3 id="internal_search">Internal Search</h3>
<ul>
<li>Dimension - <code>ga:searchAfterDestinationPage</code> - The page that the user visited after performing an internal search on your site.</li>
</ul>
Android SDK - Release Version 4.0.5 - Google Play Services 6.7 (February 17, 2015)tag:google.com,changelog:analytics-collection-android#release-2015-02-172015-02-17T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Minor bug fixes.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Fixed race condition bug related to <a href="
https://productforums.google.com/d/topic/tag-manager/NOlng117_2g/discussion">How to avoid TagManager “IllegalStateException: Results have already been set”</a>.</li>
</ul>
Real Time Reporting API - Release 2015-02-12 (February 12, 2015)tag:google.com,changelog:analytics-reporting-realtime#release-2015-02-122015-02-12T08:00:00:+0000
<p>This is a bug fix release:</p>
<ul>
<li>This release fixes an <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=427">issue</a> in enforcing the filtering constraints in the Real Time Reporting API query. Requests with <code>rt:activeUsers</code> and a filter on an event level dimension would result in a error with a <code>badRequest</code> reason and a message stating <code>OR operator not supported for a hit level filter</code>. Visit the <a href="
https://developers.google.com/analytics/devguides/reporting/realtime/v3/devguide#constraints">Real Time Reporting API Developer Guide</a> for more details on query constraints.</li>
</ul>
Measurement Protocol - Release 2015-01-30 (January 30, 2015)tag:google.com,changelog:analytics-collection-protocol#release-2015-01-302015-01-30T08:00:00:+0000
<p>This release adds a new hit parameter. Review the <a href="
https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters">Parameter Reference</a> for the complete list of parameters.</p>
<h3 id="data_source">Data Source</h3>
<ul>
<li>The <code>ds</code> <a href="
https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#ds">Data Source</a> parameter allows you to set the data source of a hit.</li>
</ul>
Web Tracking (analytics.js) - Release 2015-01-30 (January 30, 2015)tag:google.com,changelog:analytics-collection-analyticsjs#release-2015-01-302015-01-30T08:00:00:+0000
<p>This release contains the addition of a new field. Review the <a href="
https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference">Field Reference</a> for the complete list of fields.</p>
<h3 id="data_source">Data Source</h3>
<ul>
<li>The <a href="
https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#dataSource">Data Source</a> field allows you to set the data source of a hit.</li>
</ul>
Measurement Protocol - Release 2015-01-29 (January 29, 2015)tag:google.com,changelog:analytics-collection-protocol#release-2015-01-292015-01-29T08:00:00:+0000
<p>This release adds a new hit parameter. Review the <a href="
https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters">Parameter Reference</a> for the complete list of parameters.</p>
<h3 id="geographical_override">Geographical Override</h3>
<ul>
<li>The <code>geoid</code> <a href="
https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#geoid">Geographical Override</a> allows you to explicitly set the geographical location of the user.</li>
</ul>
Management API - Release 2015-01-23 (January 23, 2015)tag:google.com,changelog:analytics-config-mgmt#release-2015-01-232015-01-23T08:00:00:+0000
<p>This release adds two new collections to the Management API, Custom Dimensions and Custom Metrics.</p>
<h3 id="custom_dimensions_and_metrics">Custom Dimensions and Metrics</h3>
<p>It is now possible to create, list, get, patch, and update Custom Dimensions and Metrics with the Management API.</p>
<ul>
<li><a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtDimsMets">Custom Dimensions and Metrics Developer Guide</a></li>
<li><a href="https://developers.google.com/analytics/devguides/platform/customdimsmets">Custom Dimensions and Metrics Feature Reference</a></li>
<li><a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/customDimensions">Custom Dimensions Reference</a></li>
<li><a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/customMetrics">Custom Metrics Reference</a></li>
</ul>
Core Reporting API - Release 2015-01-21 (January 21, 2015)tag:google.com,changelog:analytics-reporting-core#release-2015-01-212015-01-21T08:00:00:+0000
<p>This release adds new dimensions and metrics to the API and deprecates two existing metrics. Review the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="ecommerce">ECommerce</h3>
<ul>
<li>Metric - <code>ga:transactionsPerUser</code> - The total number of transactions divided by total number of users.</li>
<li>Metric - <code>ga:revenuePerUser</code> - The total sale revenue provided in the transaction excluding shipping and tax divided by total number of users.</li>
</ul>
<h3 id="user">User</h3>
<ul>
<li>Metric - <code>ga:sessionsPerUser</code> - The total number of sessions divided by the total number of users.</li>
</ul>
<h3 id="geo_network">Geo Network</h3>
<ul>
<li>Dimension - <code>ga:cityId</code> - The city IDs of users, derived from IP addresses or Geographical IDs.</li>
<li>Dimension - <code>ga:countryIsoCode</code> - The country ISO code of users, derived from IP addresses or Geographical IDs. Values are given as an ISO-3166-1 alpha-2 code.</li>
<li>Dimension - <code>ga:regionId</code> - The region ID of users, derived from IP addresses or Geographical IDs. In the U.S., a region is a state, such as New York.</li>
<li>Dimension - <code>ga:regionIsoCode</code> - The region ISO code of users, derived from IP addresses or Geographical IDs. Values are given as an ISO-3166-2 code.</li>
<li>Dimension - <code>ga:subContinentCode</code> - The sub-continent code of users, derived from IP addresses or Geographical IDs. For example, Polynesia or Northern Europe. Values are given as a UN M.49 code.</li>
</ul>
<h3 id="doubleclick_campaign_manager">DoubleClick Campaign Manager</h3>
<ul>
<li>Metric - <code>ga:dcmROAS</code> - DCM Return On Ad Spend (ROAS) (premium only).</li>
</ul>
<h3 id="depricated_metrics">Depricated Metrics</h3>
<p>These metrics have been deprecated. Review the <a href="https://developers.google.com/analytics/devguides/reporting/metadata/v3/data-deprecation#remove">Data Deprecation Policy</a> for details on data removal: + Metric - <code>ga:dcmROI</code> - Use <code>ga:dcmROAS</code> instead. + Metric - <code>ga:dcmMargen</code> - Use <code>ga:dcmROAS</code> instead.</p>
Management API - Release 2015-01-08 (January 8, 2015)tag:google.com,changelog:analytics-config-mgmt#release-2015-01-082015-01-08T08:00:00:+0000
<p>The <code>list</code> method response for all collections now include an empty list for the <code>items</code> property when the collection contains no resources. Previously the <code>items</code> property would be omitted from the response. See the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/">API Reference</a> for complete details on queries and responses for Google Analytics configuration data.</p>
Management API - Release 2014-12-16 (December 16, 2014)tag:google.com,changelog:analytics-config-mgmt#release-2014-12-162014-12-16T08:00:00:+0000
<h4 id="bug_fixes">Bug Fixes</h4>
<ul>
<li>Fix for <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=467">Issue 467</a> - The <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/segments">segments collection</a> now returns segments that use the <code>dateOfSession</code> syntax.</li>
</ul>
Android SDK - Release Version 4.0.4 - Google Play Services 6.5 (November 24, 2014)tag:google.com,changelog:analytics-collection-android#release-2014-11-242014-11-24T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Improvements for exception tracking related to <a href="
https://code.google.com/p/analytics-issues/issues/detail?id=443">Issue 443: Google Play Services does not submit exceptions</a>.</li>
<li>Minor bug fixes.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>No changes to Google Tag Manager.</li>
</ul>
Management API - Release 2014-11-20 (November 20, 2014)tag:google.com,changelog:analytics-config-mgmt#release-2014-11-202014-11-20T08:00:00:+0000
<p>This release introduces a new scope for the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtAuthorization#scopes">Google Analytics Management API</a>. - <code>analytics.manage.users.readonly</code> - View Google analytics user permissions.</p>
Management API - Release 2014-11-05 (November 5, 2014)tag:google.com,changelog:analytics-config-mgmt#release-2014-11-052014-11-05T08:00:00:+0000
<p>A new <code>DEVICE_CATEGORY</code> <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/filters">filters</a> field has been added and <code>IS_MOBILE</code> and <code>IS_TABLET</code> are now deprecated. Use <code>DEVICE_CATEGORY=mobile</code> and <code>DEVICE_CATEGORY=tablet</code>.</p>
iOS SDK - Release Version 3.10 (November 5, 2014)tag:google.com,changelog:analytics-collection-ios#release-2014-11-052014-11-05T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Fixed an issue which prevented all beacons from being sent when dispatching beacons.</li>
<li>Updated CuteAnimals sample application to demonstrate how to dispatch when the app goes into the background.</li>
<li>Added support for additional Enhanced Ecommerce fields.</li>
<li>Removed warning messages about GAIHit and GAIProperty classes missing when compiling against iOS SDK 8.0; those classes were removed.</li>
<li>Dispatching beacons is now more efficient, with multiple beacons being dispatched in a single HTTPS request.</li>
<li>Requests will be compressed to save on data plan usage under certain circumstances.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Deprecate TAGContainerFuture based openContainerWithId. Using this API on iOS8 results in errors if the get is called during some phases of the UIAppDelegate lifecycle.</li>
<li>Added support for custom metrics and custom dimensions to Enhanced Ecommerce for the Google Universal Analytics tag.</li>
<li>Fixed a bug which required products for Enhanced Ecommerce actions that have optional products.</li>
<li>Support Advertising ID Features for the Google Universal Analytics tag.</li>
<li>Updated CuteAnimals sample application to demonstrate how to send data when the app is going into the background.</li>
</ul>
Management API - Release 2014-10-29 (October 29, 2014)tag:google.com,changelog:analytics-config-mgmt#release-2014-10-292014-10-29T08:00:00:+0000
<p>The <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/profiles">View (Profile)</a> resource now includes an <code>enhancedECommerceTracking</code> property that indicates whether Enhanced Ecommerce is enabled (<code>true</code>) or disabled (<code>false</code>).</p>
Core Reporting API - Release 2014-10-09 (October 9, 2014)tag:google.com,changelog:analytics-reporting-core#release-2014-10-092014-10-09T08:00:00:+0000
<p>This release adds a new metric to the API and deprecates two existing metrics. Check the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="adwords">AdWords</h3>
<ul>
<li>Metric - <code>ga:ROAS</code> - Return On Ad Spend (ROAS) is the total transaction revenue and goal value divided by derived advertising cost.</li>
</ul>
<h3 id="deprecated_dimensions_and_metrics">Deprecated Dimensions and Metrics</h3>
<p>These dimensions and metrics have been deprecated. Review the <a href="https://developers.google.com/analytics/devguides/reporting/metadata/v3/data-deprecation#remove">Data Deprecation Policy</a> for details on data removal: + Metric - <code>ga:ROI</code> - Use <code>ga:ROAS</code> instead. + Metric - <code>ga:margin</code> - Use <code>ga:ROAS</code> instead.</p>
Real Time Reporting API - Release 2014-10-01 (October 1, 2014)tag:google.com,changelog:analytics-reporting-realtime#release-2014-10-012014-10-01T08:00:00:+0000
<p>This release includes a new dimension. Review the <a href="
https://developers.google.com/analytics/devguides/reporting/realtime/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h4 id="time">Time</h4>
<ul>
<li>Dimension - <code>rt:minutesAgo</code> - The number of minutes ago a hit occurred.</li>
</ul>
Core Reporting API - Release 2014-10-01 (October 1, 2014)tag:google.com,changelog:analytics-reporting-core#release-2014-10-012014-10-01T08:00:00:+0000
<p>This release adds new metrics to the API. Check the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="adsense">AdSense</h3>
<ul>
<li>Metric - <code>ga:adsenseCoverage</code> - The percentage of ad requests that returned at least one ad.</li>
<li>Metric - <code>ga:adsenseViewableImpressionPercent</code> - The percentage of impressions that were viewable.</li>
</ul>
Android SDK - Release Version 4.0.3 - Google Play Services 6.1 (September 25, 2014)tag:google.com,changelog:analytics-collection-android#release-2014-09-252014-09-25T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Minor bug fixes.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Support for enhanced ecommerce has been added. See the <a href="
https://developers.google.com/tag-manager/android/v4/enhanced-ecommerce">Enhanced Ecommerce Developer Guide</a> for details.</li>
</ul>
Web Tracking (analytics.js) - Release 2014-09-02 (September 2, 2014)tag:google.com,changelog:analytics-collection-analyticsjs#release-2014-09-022014-09-02T08:00:00:+0000
<ul>
<li>Hits can now be sent using <a href="https://developer.mozilla.org/en-US/docs/Web/API/navigator.sendBeacon"><code>navigator.sendBeacon</code></a> (in supported browsers) by passing the <a href="https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#useBeacon"><code>useBeacon</code></a> parameter.</li>
<li>The cookie set by the <a href="https://developers.google.com/analytics/devguides/collection/analyticsjs/display-features">display features</a> plugin has been renamed from <code>_dc</code> to <code>_gat</code>.</li>
</ul>
Multi-Channel Funnels Reporting API - Release 2014-08-25 (August 25, 2014)tag:google.com,changelog:analytics-reporting-mcf#release-2014-08-252014-08-25T08:00:00:+0000
<p>This release adds new dimensions and metrics to the API. Check the <a href="
//developers.google.com/analytics/devguides/reporting/mcf/dimsmets/">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="conversion_paths">Conversion Paths</h3>
<ul>
<li>dimension - <code>mcf:dcmAd</code> - DCM ad name of the DCM event (impression or click) matching the Google Analytics conversion.</li>
<li>dimension - <code>mcf:dcmAdPath</code> - The path to conversion where interactions on the path are represented by DCM ads.</li>
<li>dimension - <code>mcf:dcmAdType</code> - DCM ad type name of the DCM event (impression or click) matching the Google Analytics conversion.</li>
<li>dimension - <code>mcf:dcmAdvertiser</code> - DCM advertiser name of the DCM event (impression or click) matching the Google Analytics conversion.</li>
<li>dimension - <code>mcf:dcmAdvertiserPath</code> - The path to conversion where interactions on the path are represented by DCM advertisers.</li>
<li>dimension - <code>mcf:dcmCampaign</code> - DCM campaign name of the DCM event (impression or click) matching the Google Analytics conversion.</li>
<li>dimension - <code>mcf:dcmCampaignPath</code> - The path to conversion where interactions on the path are represented by DCM campaigns.</li>
<li>dimension - <code>mcf:dcmCreative</code> - DCM creative name of the DCM event (impression or click) matching the Google Analytics conversion.</li>
<li>dimension - <code>mcf:dcmCreativePath</code> - The path to conversion where interactions on the path are represented by DCM creatives.</li>
<li>dimension - <code>mcf:dcmCreativeVersion</code> - DCM creative version of the DCM event (impression or click) matching the Google Analytics conversion.</li>
<li>dimension - <code>mcf:dcmCreativeVersionPath</code> - The path to conversion where interactions on the path are represented by DCM creative versions.</li>
<li>dimension - <code>mcf:dcmNetwork</code> - The network used.</li>
<li>dimension - <code>mcf:dcmPlacement</code> - DCM site placement name of the DCM event (impression or click) matching the Google Analytics conversion.</li>
<li>dimension - <code>mcf:dcmPlacementPath</code> - The path to conversion where interactions on the path are represented by DCM placements.</li>
<li>dimension - <code>mcf:dcmSite</code> - DCM site name where the DCM creative was shown for the DCM event (impression or click) matching the Google Analytics conversion.</li>
<li>dimension - <code>mcf:dcmSitePath</code> - The path to conversion where interactions on the path are represented by DCM sites.</li>
<li>metric - <code>mcf:firstImpressionConversions</code> - The number of conversions for which a DCM campaign impression was the first conversion interaction in a 30-day lookback window. This dimension includes both goal completions and transactions.</li>
<li>metric - <code>mcf:firstImpressionValue</code> - The value of conversions for which a DCM campaign campaign impression was the first conversion interaction in a 30-day lookback window. This dimension includes both goal completions and transactions.</li>
<li>metric - <code>mcf:impressionAssistedConversions</code> - The number of conversions for which a DCM campaign impression appeared on the conversion path, but was not the final conversion interaction. This dimension includes both goal completions and transactions.</li>
<li>metric - <code>mcf:impressionAssistedValue</code> - The value of conversions for which a DCM campaign campaign impression appeared on the conversion path, but was not the final conversion interaction. This dimension includes both goal completions and transactions.</li>
</ul>
Core Reporting API - Release 2014-08-25 (August 25, 2014)tag:google.com,changelog:analytics-reporting-core#release-2014-08-252014-08-25T08:00:00:+0000
<p>This release includes the addition of a new session metric, a new traffic sources dimension, and new DoubleClick Campaign Manager dimensions and metrics.</p>
<h3 id="dimensions_and_metrics">Dimensions and Metrics</h3>
<p>Review the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h4 id="session">Session</h4>
<ul>
<li>Metric - <code>ga:hits</code> - Total number of hits sent to Google Analytics. This metric sums all hit types (e.g. pageview, event, timing, etc.)</li>
</ul>
<h4 id="traffic_sources">Traffic Sources</h4>
<ul>
<li>Dimension - <code>ga:campaignCode</code> - When using manual campaign tracking, the value of the utm_id campaign tracking parameter.</li>
</ul>
<h4 id="doubleclick_campaign_manager">DoubleClick Campaign Manager</h4>
<ul>
<li>Dimension - <code>ga:dcmClickAd</code> - DCM ad name of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickAdId</code> - DCM ad ID of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickAdType</code> - DCM ad type name of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickAdTypeId</code> - DCM ad type ID of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickAdvertiser</code> - DCM advertiser name of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickAdvertiserId</code> - DCM advertiser ID of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickCampaign</code> - DCM campaign name of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickCampaignId</code> - DCM campaign ID of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickCreative</code> - DCM creative name of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickCreativeId</code> - DCM creative ID of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickCreativeType</code> - DCM creative type name of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickCreativeTypeId</code> - DCM creative type ID of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickCreativeVersion</code> - DCM creative version of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickRenderingId</code> - DCM rendering ID of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickSite</code> - Site name where the DCM creative was shown and clicked on for the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickSiteId</code> - DCM site ID where the DCM creative was shown and clicked on for the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickSitePlacement</code> - DCM site placement name of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickSitePlacementId</code> - DCM site placement ID of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmClickSpotId</code> - DCM Floodlight configuration ID of the DCM click matching the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmFloodlightActivity</code> - DCM Floodlight activity name associated with the floodlight conversion (premium only).</li>
<li>Dimension - <code>ga:dcmFloodlightActivityAndGroup</code> - DCM Floodlight activity name and group name associated with the floodlight conversion (premium only).</li>
<li>Dimension - <code>ga:dcmFloodlightActivityGroup</code> - DCM Floodlight activity group name associated with the floodlight conversion (premium only).</li>
<li>Dimension - <code>ga:dcmFloodlightActivityGroupId</code> - DCM Floodlight activity group ID associated with the floodlight conversion (premium only).</li>
<li>Dimension - <code>ga:dcmFloodlightActivityId</code> - DCM Floodlight activity ID associated with the floodlight conversion (premium only).</li>
<li>Dimension - <code>ga:dcmFloodlightAdvertiserId</code> - DCM Floodlight advertiser ID associated with the floodlight conversion (premium only).</li>
<li>Dimension - <code>ga:dcmFloodlightSpotId</code> - DCM Floodlight configuration ID associated with the floodlight conversion (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventAd</code> - DCM ad name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventAdId</code> - DCM ad ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventAdType</code> - DCM ad type name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventAdTypeId</code> - DCM ad type ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventAdvertiser</code> - DCM advertiser name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventAdvertiserId</code> - DCM advertiser ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventAttributionType</code> - There are two possible values (ClickThrough and ViewThrough). If the last DCM event associated with the Google Analytics session was a click, then the value will be ClickThrough. If the last DCM event associated with the Google Analytics session was an ad impression, then the value will be ViewThrough (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventCampaign</code> - DCM campaign name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventCampaignId</code> - DCM campaign ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventCreative</code> - DCM creative name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventCreativeId</code> - DCM creative ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventCreativeType</code> - DCM creative type name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventCreativeTypeId</code> - DCM creative type ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventCreativeVersion</code> - DCM creative version of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventRenderingId</code> - DCM rendering ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventSite</code> - Site name where the DCM creative was shown and clicked on for the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventSiteId</code> - DCM site ID where the DCM creative was shown and clicked on for the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventSitePlacement</code> - DCM site placement name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventSitePlacementId</code> - DCM site placement ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Dimension - <code>ga:dcmLastEventSpotId</code> - DCM Floodlight configuration ID of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (premium only).</li>
<li>Metric - <code>ga:dcmFloodlightQuantity</code> - The number of DCM Floodlight conversions (premium only).</li>
<li>Metric - <code>dcmFloodlightRevenue</code> - DCM Floodlight revenue (premium only).</li>
</ul>
iOS SDK - Release Version 3.09 (July 31, 2014)tag:google.com,changelog:analytics-collection-ios#release-2014-07-312014-07-31T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>No changes.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Enhanced Ecommerce support has been added to the Google Universal Analytics Tag.</li>
<li>New <code>dispatch</code> and <code>dispatchWithCompletionHandler</code> methods have been added to the TAGManager class.</li>
</ul>
Core Reporting API - Release 2014-07-14 (July 14, 2014)tag:google.com,changelog:analytics-reporting-core#release-2014-07-142014-07-14T08:00:00:+0000
<p>This release includes the addition of the new content grouping dimensions and metrics.</p>
<h3 id="dimensions_and_metrics">Dimensions and Metrics</h3>
<p>Review the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h4 id="content_grouping">Content Grouping</h4>
<ul>
<li>Dimension - <code>ga:landingContentGroupXX</code> - The first matching content group in a user’s session.</li>
<li>Dimension - <code>ga:nextContentGroupXX</code> - Refers to content group that was visited after another content group.</li>
<li>Dimension - <code>ga:contentGroupXX</code> - Content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/url regex match, or predefined rules.</li>
<li>Dimension - <code>ga:previousContentGroupXX</code> - Refers to content group that was visited before another content group.</li>
<li>Metric - <code>ga:contentGroupUniqueViewsXX</code> - The number of different (unique) pages within a session for the specified content group. This takes into account both the pagePath and pageTitle to determine uniqueness.</li>
</ul>
Android SDK - Release Version 4.0.2 - Google Play Services 5.0 (July 1, 2014)tag:google.com,changelog:analytics-collection-android#release-2014-07-012014-07-01T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Support for enhanced ecommerce has been added. See the <a href="
https://developers.google.com/analytics/devguides/collection/android/v4/enhanced-ecommerce">Enhanced Ecommerce Developer Guide</a> for details.</li>
<li>The client ID will now reset every time the advertising ID is changed.</li>
<li>Advertising ID collection is off by default.</li>
<li>Added programmatic APIs for exception reporting.</li>
<li>Bug fixes in documentation.</li>
<li>Minor bug fixes.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>No changes to Google Tag Manager.</li>
</ul>
iOS SDK - Release Version 3.08 (June 25, 2014)tag:google.com,changelog:analytics-collection-ios#release-2014-06-252014-06-25T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>The SDK will now collect IDFA and the advertiser tracking enabled flag if the library libAdIdAccess.a (provided as part of the SDK) is included in the application and the <code>allowIDFACollection</code> property is set to true on the tracker.</li>
<li>Enhanced Ecommerce support has been added.</li>
<li>Added screenview hit type to replace appview hit type.</li>
<li>A hit id parameter is now added to each hit. It is changed every time an appview, screenview or pageview hit is generated.</li>
<li>ClientId will now be reset every time the IDFA value is changes. This only happens when IDFA is collected in a tracker.</li>
<li>A new <code>dispatchWithCompletionHandler</code> method has been added to the GAI class.</li>
<li>Fixed an issue where the SDK could send a beacon without a clientId or with an empty clientId.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>No changes</li>
</ul>
Web Tracking (analytics.js) - Release 2014-06-25 (June 25, 2014)tag:google.com,changelog:analytics-collection-analyticsjs#release-2014-06-252014-06-25T08:00:00:+0000
<ul>
<li>Hits that do not contain a valid tracking id are now dropped.</li>
<li>Added support for <a href="
https://developers.google.com/analytics/devguides/collection/analyticsjs/cross-domain#autolink">Regular Expressions in Cross Domain linking plugin</a>.</li>
</ul>
Web Tracking (ga.js) - Release 2014-06-25 (June 25, 2014)tag:google.com,changelog:analytics-collection-gajs#release-2014-06-252014-06-25T08:00:00:+0000
<ul>
<li>Hits that do not contain a valid tracking id are now dropped.</li>
</ul>
Management API - Release 2014-06 (June 20, 2014)tag:google.com,changelog:analytics-config-mgmt#release-2014-06-202014-06-20T08:00:00:+0000
<p>This release includes new data import types and the deprecation of the <code>dailyUpload</code> resource.</p>
<h3 id="data_import">Data Import</h3>
<p>See the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtDataImport">Data Import Developer Guide</a> for details how to use the Management API to import data to your Google Analytics account.</p>
<h4 id="uploads">Uploads</h4>
<ul>
<li>The <code>upload</code> resource now supports the following upload types:
<ul>
<li>Campaign Data</li>
<li>Content Data</li>
<li>Cost Data</li>
<li>Product Data</li>
<li>Refund Data</li>
<li>User Data</li>
</ul>
</li>
<li>The <code>upload</code> resource has a new <a href="
https://developers.google.com/analytics/solutions/cost-data-migration"><code>migrateDataImport</code></a> method to migrate existing Cost Data <code>customDataSources</code>.</li>
</ul>
<h4 id="daily_uploads_deprecation">Daily Uploads Deprecation</h4>
<ul>
<li>The <code>dailyUpload</code> resource is now deprecated! see the <a href="
https://developers.google.com/analytics/solutions/articles/cost-data-migration">Migration Guide</a> for details on migrating to use the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtDataImport.html">Data Import</a> feature.</li>
<li>The <code>dailyUpload</code> resource will continue to work for six more months, at which point any remaining <code>customDataSources</code> with <code>uploadType</code> property set to <code>analytics#dailyUploads</code> will be automatically migrated and only work with the <code>upload</code> resource.</li>
<li>Current users of the <code>dailyUpload</code> resource should update their code and migrate to use the Upload resource as soon as possible.</li>
</ul>
Core Reporting API - Release 2014-06-12 (June 12, 2014)tag:google.com,changelog:analytics-reporting-core#release-2014-06-122014-06-12T08:00:00:+0000
<p>This release includes a new <code>dateOfSession</code> condition for <a href="
https://developers.google.com/analytics/devguides/reporting/core/v3/segments">Segments</a> and the addition of new Enhanced Ecommerce dimensions and metrics.</p>
<h3 id="segments">Segments</h3>
<p>Segments now support a new <code>dateOfSession</code> condition which can restrict a segment to a group of users who have initiated a session within a certain date range. See the <a href="
https://developers.google.com/analytics/devguides/reporting/core/v3/segments#dateOfSession-conditions">Segments Developer Guide</a> for details.</p>
<h3 id="dimensions_and_metrics">Dimensions and Metrics</h3>
<p>Review the <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions for <a href="
https://developers.google.com/analytics/devguides/reporting/core/dimsmets#view=detail&group=ecommerce">Enhanced Ecommerce</a>.</p>
<h4 id="enhanced_ecommerce">Enhanced Ecommerce</h4>
<ul>
<li>Dimension - <code>ga:internalPromotionCreative</code> - The creative content designed for a promotion.</li>
<li>Dimension - <code>ga:internalPromotionId</code> - The ID you are using for the promotion.</li>
<li>Dimension - <code>ga:internalPromotionName</code> - The name of the promotion.</li>
<li>Dimension - <code>ga:internalPromotionPosition</code> - The position of the promotion on the web page or application screen.</li>
<li>Dimension - <code>ga:orderCouponCode</code> - Code for the order-level coupon.</li>
<li>Dimension - <code>ga:productBrand</code> - The brand name under which the product is sold.</li>
<li>Dimension - <code>ga:productCategoryHierarchy</code> - The hierarchical category in which the product is classified (Enhanced Ecommerce).</li>
<li>Dimension - <code>ga:productCategoryLevelXX</code> - Level (1-5) in the product category hierarchy, starting from the top.</li>
<li>Dimension - <code>ga:productCouponCode</code> - Code for the product-level coupon.</li>
<li>Dimension - <code>ga:productListName</code> - The name of the product list in which the product appears.</li>
<li>Dimension - <code>ga:productListPosition</code> - The position of the product in the product list.</li>
<li>Dimension - <code>ga:productVariant</code> - The specific variation of a product, e.g., XS, S, M, L for size or Red, Blue, Green, Black for color.</li>
<li>Dimension - <code>ga:checkoutOptions</code> - User options specified during the checkout process, e.g., FedEx, DHL, UPS for delivery options or Visa, MasterCard, AmEx for payment options. This dimension should be used along with Shopping Stage.</li>
<li>Dimension - <code>ga:shoppingStage</code> - Various stages of the shopping experience that users completed in a session, e.g., PRODUCT_VIEW, ADD_TO_CART, CHECKOUT, etc.</li>
<li>Metric - <code>ga:internalPromotionCTR</code> - The rate at which users clicked through to view the internal promotion (number of clicks / number of times promotion appeared).</li>
<li>Metric - <code>ga:internalPromotionClicks</code> - The number of clicks on an internal promotion.</li>
<li>Metric - <code>ga:internalPromotionViews</code> - The number of views of an internal promotion.</li>
<li>Metric - <code>ga:localProductRefundAmount</code> - Refund amount for a given product in the local currency.</li>
<li>Metric - <code>ga:localRefundAmount</code> - Total refund amount for the transaction in the local currency.</li>
<li>Metric - <code>ga:productAddsToCart</code> - Number of times the product was added to the shopping cart.</li>
<li>Metric - <code>ga:productCheckouts</code> - Number of times the product was included in the check-out process.</li>
<li>Metric - <code>ga:productDetailViews</code> - Number of times users viewed the product-detail page.</li>
<li>Metric - <code>ga:productListClicks</code> - Number of times users clicked the product when it appeared in the product list.</li>
<li>Metric - <code>ga:productListViews</code> - Number of times the product appeared in a product list.</li>
<li>Metric - <code>ga:productListCTR</code> - The rate at which users clicked through on the product in a product list.</li>
<li>Metric - <code>ga:productRefunds</code> - Number of times a refund was issued for the product.</li>
<li>Metric - <code>ga:productRefundAmount</code> - Total refund amount associated with the product.</li>
<li>Metric - <code>ga:productRemovesFromCart</code> - Number of times the product was removed from shopping carts.</li>
<li>Metric - <code>ga:productRevenuePerPurchase</code> - Average product revenue per purchase (commonly used with Product Coupon Code).</li>
<li>Metric - <code>ga:buyToDetailRate</code> - Unique purchases divided by views of product detail pages.</li>
<li>Metric - <code>ga:cartToDetailRate</code> - Product adds divided by views of product details.</li>
<li>Metric - <code>ga:quantityAddedToCart</code> - Number of product units added to cart.</li>
<li>Metric - <code>ga:quantityCheckedOut</code> - Number of product units included in check out.</li>
<li>Metric - <code>ga:quantityRefunded</code> - Number of product units refunded.</li>
<li>Metric - <code>ga:quantityRemovedFromCart</code> - Number of product units removed from cart.</li>
<li>Metric - <code>ga:refundAmount</code> - Currency amount refunded for a transaction.</li>
<li>Metric - <code>ga:totalRefunds</code> - Number of refunds that have been issued.</li>
</ul>
Core Reporting API - Release 2014-06-04 (June 4, 2014)tag:google.com,changelog:analytics-reporting-core#release-2014-06-042014-06-04T08:00:00:+0000
<p>This release includes a bug fix for column header names as well as the addition of new dimensions and metrics.</p>
<h3 id="dimensions_and_metrics">Dimensions and Metrics</h3>
<p>Review the <a href="
https//developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h4 id="system">System</h4>
<ul>
<li>Dimension - <code>ga:sourcePropertyDisplayName</code> - Source property display name of roll-up properties. This is valid only for roll-up properties.</li>
<li>Dimension - <code>ga:sourcePropertyTrackingId</code> - Source property tracking ID of roll-up properties. This is valid only for roll-up properties</li>
</ul>
<h4 id="channel_grouping">Channel Grouping</h4>
<ul>
<li>Dimension - <code>ga:channelGrouping</code> - The default channel grouping that is shared within the View (Profile).</li>
</ul>
<h4 id="related_products">Related Products</h4>
<ul>
<li>Dimension - <code>ga:correlationModelId</code> - Correlation Model ID for related products.</li>
<li>Dimension - <code>ga:queryProductId</code> - ID of the product being queried.</li>
<li>Dimension - <code>ga:queryProductName</code> - Name of the product being queried.</li>
<li>Dimension - <code>ga:queryProductVariation</code> - Variation of the product being queried.</li>
<li>Dimension - <code>ga:relatedProductId</code> - ID of the related product.</li>
<li>Dimension - <code>ga:relatedProductName</code> - Name of the related product.</li>
<li>Dimension - <code>ga:relatedProductVariation</code> - Variation of the related product.</li>
<li>Metric - <code>ga:correlationScore</code> - Correlation Score for related products.</li>
<li>Metric - <code>ga:queryProductQuantity</code> - Quantity of the product being queried.</li>
<li>Metric - <code>ga:relatedProductQuantity</code> - Quantity of the related product.</li>
</ul>
<h3 id="header_column_name_correction">Header column name correction</h3>
<ul>
<li>There was a bug in the 2014-04-16 release; if you queried for a deprecated dimension or metric, the API would return column headers with the replacement dimension or metric. Now it correctly returns the same dimension or metric name used in the request.</li>
</ul>
Metadata API - Release 2014-06-03 (June 3, 2014)tag:google.com,changelog:analytics-reporting-metadata#release-2014-06-032014-06-03T08:00:00:+0000
<p>This release includes a naming convention change for the <code>uiName</code> attribute.</p>
<h3 id="uiname_change">uiName Change</h3>
<ul>
<li>The uiName attribute for templatized columns now uses <code>XX</code> to represent the numeric index instead of <code>1</code>. For example, <code>Goal 1 Value</code> is now <code>Goal XX Value</code>.</li>
</ul>
Embed API - Release 2014-05 (May 28, 2014)tag:google.com,changelog:analytics-reporting-embed#release-2014-05-282014-05-28T08:00:00:+0000
<p>This is the initial release of the Embed API:</p>
<ul>
<li>The Google Analytics Embed API is a JavaScript library that allows you to easily create and embed a dashboard on a 3rd party website in a matter of minutes. Visit the <a href="
https://developers.google.com/analytics/devguides/reporting/embed/v1/">Embed API Overview</a> for more details.</li>
<li>Includes components: auth, view selector, data, and data chart.</li>
</ul>
Provisioning API - Release 2014-05 (May 28, 2014)tag:google.com,changelog:analytics-config-provisioning#release-2014-05-282014-05-28T08:00:00:+0000
<p>This is the initial release of the Provisioning API:</p>
<ul>
<li>The Provisioning API can be used to programmatically create new Google Analytics accounts. This API is invite-only and intended for qualified service providers and large partners. Visit the <a href="
https://developers.google.com/analytics/devguides/config/provisioning/v3/">Provisioning API Overview</a> for more details.</li>
</ul>
Management API - Release 2014-05 (May 28, 2014)tag:google.com,changelog:analytics-config-mgmt#release-2014-05-282014-05-28T08:00:00:+0000
<p>This release adds two new configuration APIs.</p>
<h4 id="adwords_links">AdWords Links</h4>
<ul>
<li>
<p>AdWords Links in the Management API allows you to create, list, get, update, patch, and delete links between Google AdWords accounts and Google Analytics properties and manage which Views (Profiles) are linked to Adwords data.</p>
<ul>
<li><a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtAdWordsLinksGuide">AdWords Links Developer Guide</a></li>
<li><a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/webPropertyAdWordsLinks">AdWords Links API Reference</a></li>
</ul>
</li>
</ul>
<h4 id="filters">Filters</h4>
<ul>
<li>
<p>Filters in the Management API allows you to create, list, get, update, patch, and delete filters for your Google Analytics account. Profile Filter Links allow you to create, list, get, update, patch, and delete links between Filters and Views (Profiles).</p>
<ul>
<li><a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtFilterGuide">Filters Developer Guide</a></li>
<li><a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/filters">Filters API Reference</a></li>
<li><a href="https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/profileFilterLinks">Profile Filter Links API Reference</a></li>
</ul>
</li>
</ul>
Management API - Release 2014-05-27 (May 27, 2014)tag:google.com,changelog:analytics-config-mgmt#release-2014-05-272014-05-27T08:00:00:+0000
<h3 id="unsampled_reports_management_api">Unsampled Reports: Management API</h3>
<p>A new resource is being added to the Management API called <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/unsampledReports">Unsampled Reports</a>. Unsampled reports are Google Analytics (GA) reports that have been generated using unsampled data. Unsampled reports are currently only available to GA Premium users. </p>
<ul>
<li>See the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtUnsampledReports.html">Developer Guide</a></li>
</ul>
Measurement Protocol - Release 2014-05-12 (May 12, 2014)tag:google.com,changelog:analytics-collection-protocol#release-2014-05-122014-05-12T08:00:00:+0000
<ul>
<li>
<p>Updated the list of supported organic sources.</p>
<ul>
<li><strong>Removed</strong>: Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.</li>
<li><strong>Added/Updated</strong>: Baidu, DOCOMO, Onet, Centrum, Sogou, Tut.By, Globo, Ukr.net, So.com, au one.</li>
</ul>
</li>
</ul>
Web Tracking (analytics.js) - Release 2014-05-12 (May 12, 2014)tag:google.com,changelog:analytics-collection-analyticsjs#release-2014-05-122014-05-12T08:00:00:+0000
<ul>
<li>
<p>Updated the list of supported organic sources.</p>
<ul>
<li><strong>Removed</strong>: Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.</li>
<li><strong>Added/Updated</strong>: Baidu, DOCOMO, Onet, Centrum, Sogou, Tut.By, Globo, Ukr.net, So.com, au one.</li>
</ul>
</li>
</ul>
iOS SDK - Release Version 3.07 (May 9, 2014)tag:google.com,changelog:analytics-collection-ios#release-2014-05-092014-05-09T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>Added User Id field.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Fixed a bug in Id for Advertising Macro so that it can correctly return identifier for advertiser (IDFA) if available.</li>
<li>Fixed an issue so users can use <code>NSNumber</code> for ecommerce data.</li>
</ul>
Metadata API - Release 2014-04-16 (April 16, 2014)tag:google.com,changelog:analytics-reporting-metadata#release-2014-04-162014-04-16T08:00:00:+0000
<p>This release includes the deprecation of the <code>appUiName</code> attribute. Review the <a href="https://developers.google.com/analytics/devguides/reporting/metadata/v3/data-deprecation#remove-attribute">Data Deprecation Policy</a> for details on attribute removal:</p>
<h3 id="appuiname_deprecation">appUiName Deprecation</h3>
<ul>
<li>The <code>appUiName</code> has been deprecated. It is no longer required in the Metadata API because UI names for web and app views (profiles) have been unified. You should remove any code that uses the <code>appUiName</code> attribute and only use the <code>uiName</code> attribute.</li>
</ul>
Real Time Reporting API - Release 2014-04-16 (April 16, 2014)tag:google.com,changelog:analytics-reporting-realtime#release-2014-04-162014-04-16T08:00:00:+0000
<p>This release includes the renaming of dimensions and metrics. Review the <a href="
//developers.google.com/analytics/devguides/reporting/realtime/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="renamed_dimensions_and_metrics">Renamed Dimensions and Metrics</h3>
<p>The following dimensions and metrics have been renamed. Review the <a href="https://developers.google.com/analytics/devguides/reporting/metadata/v3/data-deprecation#rename">Data Deprecation Policy</a> for details on data renaming:</p>
<h4 id="user">User</h4>
<ul>
<li>Dimension - <code>rt:visitorType</code> - Use <code>rt:userType</code> instead.</li>
<li>Metric - <code>rt:activeVisitors</code> - Use <code>rt:activeUsers</code> instead.</li>
</ul>
Core Reporting API - Release 2014-04-16 (April 16, 2014)tag:google.com,changelog:analytics-reporting-core#release-2014-04-162014-04-16T08:00:00:+0000
<p>This release includes the addition and renaming of dimensions and metrics. Review the <a href="
//developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="new_dimensions_and_metrics">New Dimensions and Metrics</h3>
<p>The following dimensions have been added to the Core Reporting API:</p>
<h4 id="adwords">AdWords</h4>
<ul>
<li>Dimension - <code>ga:isTrueViewVideoAd</code> - <code>Yes</code> or <code>No</code> - Indicates whether the ad is an AdWords TrueView video ad.</li>
</ul>
<h4 id="time">Time</h4>
<ul>
<li>Dimension - <code>ga:nthHour</code> - Index for each hour in the specified date range. Index for the first hour of first day (i.e., start-date) in the date range is 0, 1 for the next hour, and so on.</li>
</ul>
<h3 id="renamed_dimensions_and_metrics">Renamed Dimensions and Metrics</h3>
<p>All <strong>visitor</strong> and <strong>visit</strong> based dimensions and metrics have been renamed to instead use <strong>user</strong> and <strong>session</strong> respectively.</p>
<p>The following dimensions and metrics have been renamed. Review the <a href="https://developers.google.com/analytics/devguides/reporting/metadata/v3/data-deprecation#rename">Data Deprecation Policy</a> for details on data renaming:</p>
<h4 id="audience">Audience</h4>
<ul>
<li>Dimension - <code>ga:visitorAgeBracket</code> - Use <code>ga:userAgeBracket</code> instead.</li>
<li>Dimension - <code>ga:visitorGender</code> - Use <code>ga:userGender</code> instead.</li>
</ul>
<h4 id="ecommerce">Ecommerce</h4>
<ul>
<li>Metric - <code>ga:transactionRevenuePerVisit</code> - Use <code>ga:transactionRevenuePerSession</code> instead.</li>
<li>Metric - <code>ga:transactionsPerVisit</code> - Use <code>ga:transactionsPerSession</code> instead.</li>
</ul>
<h4 id="event_tracking">Event Tracking</h4>
<ul>
<li>Metric - <code>ga:eventsPerVisitWithEvent</code> - Use <code>ga:eventsPerSessionWithEvent</code> instead.</li>
<li>Metric - <code>ga:visitsWithEvent</code> - Use <code>ga:sessionsWithEvent</code> instead.</li>
</ul>
<h4 id="goal_conversions">Goal Conversions</h4>
<ul>
<li>Metric - <code>ga:goalValuePerVisit</code> - Use <code>ga:goalValuePerSession</code> instead.</li>
</ul>
<h4 id="internal_search">Internal Search</h4>
<ul>
<li>Metric - <code>ga:percentVisitsWithSearch</code> - Use <code>ga:percentSessionsWithSearch</code> instead.</li>
<li>Metric - <code>ga:searchVisits</code> - Use <code>ga:searchSessions</code> instead.</li>
</ul>
<h4 id="page_tracking">Page Tracking</h4>
<ul>
<li>Metric - <code>ga:pageviewsPerVisit</code> - Use <code>ga:pageviewsPerSession</code> instead.</li>
</ul>
<h4 id="session">Session</h4>
<ul>
<li>Dimension - <code>ga:visitLength</code> - Use <code>ga:sessionDurationBucket</code> instead.</li>
<li>Metric - <code>ga:avgTimeOnSite</code> - Use <code>ga:avgSessionDuration</code> instead.</li>
<li>Metric - <code>ga:timeOnSite</code> - Use <code>ga:sessionDuration</code> instead.</li>
<li>Metric - <code>ga:visitBounceRate</code> - Use <code>ga:bounceRate</code> instead.</li>
<li>Metric - <code>ga:visits</code> - Use <code>ga:sessions</code> instead.</li>
</ul>
<h4 id="social_interactions">Social Interactions</h4>
<ul>
<li>Dimension - <code>ga:socialInteractionNetworkActionVisit</code> - Use <code>ga:socialInteractionNetworkActionSession</code> instead.</li>
<li>Metric - <code>ga:socialInteractionsPerVisit</code> - Use <code>ga:socialInteractionsPerSession</code> instead.</li>
</ul>
<h4 id="user">User</h4>
<ul>
<li>Dimension - <code>ga:daysSinceLastVisit</code> - Use <code>ga:daysSinceLastSession</code> instead.</li>
<li>Dimension - <code>ga:visitCount</code> - Use <code>ga:sessionCount</code> instead.</li>
<li>Dimension - <code>ga:visitorType</code> - Use <code>ga:userType</code> instead.</li>
<li>Dimension - <code>ga:visitsToTransaction</code> - Use <code>ga:sessionsToTransaction</code> instead.</li>
<li>Metric - <code>ga:newVisits</code> - Use <code>ga:newUsers</code> instead.</li>
<li>Metric - <code>ga:percentNewVisits</code> - Use <code>ga:percentNewSessions</code> instead.</li>
<li>Metric - <code>ga:visitors</code> - Use <code>ga:users</code> instead.</li>
</ul>
Measurement Protocol - Release 2014-04-16 (April 16, 2014)tag:google.com,changelog:analytics-collection-protocol#release-2014-04-162014-04-16T08:00:00:+0000
<p>This release contains the replacement of the <code>appview</code> hit type and the addition and renaming of parameters. Review the <a href="
https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters">Parameter Reference</a> for the complete list of parameters.</p>
<h3 id="appview_replacement">appview Replacement</h3>
<ul>
<li>The <code>appview</code> <a href="
https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#hit">hit type</a> has been replaced with <code>screenview</code>. Update your app tracking code as soon as possible to use <code>screenview</code> instead of <code>appview</code>.</li>
</ul>
<h3 id="new_parameters">New Parameters</h3>
<ul>
<li><a href="
https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#aid">Application ID</a> - Application identifier.</li>
<li><a href="
https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#aiid">Application Installer ID</a> - Application installer identifier.</li>
</ul>
<h3 id="parameter_rename">Parameter Rename</h3>
<ul>
<li><strong>Content Description</strong> has been renamed to <a href="
https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#cd">Screen Name</a>. The query parameter name, <code>cd</code>, will remain the same.</li>
</ul>
Web Tracking (analytics.js) - Release 2014-04-16 (April 16, 2014)tag:google.com,changelog:analytics-collection-analyticsjs#release-2014-05-092014-05-09T08:00:00:+0000
<p>This release contains the replacement of the <code>appview</code> hit type and the addition of new fields. Review the <a href="
https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference">Field Reference</a> for the complete list of fields.</p>
<h3 id="appview_replacement">appview Replacement</h3>
<ul>
<li>The <code>appview</code> <a href="
https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#hit">hit type</a> has been replaced with <code>screenview</code>. Update your app tracking code as soon as possible to use <code>screenview</code> instead of <code>appview</code>.</li>
</ul>
<h3 id="new_fields">New Fields</h3>
<ul>
<li><a href="
https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#screenName">Screen Name</a> - The name of the page/screen. When not set it defaults to the page URL (web) or Id of the screen (app).</li>
<li><a href="
https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#appId">Application ID</a> - Application identifier.</li>
<li><a href="
https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#appInstallerId">Application Installer ID</a> - Application installer identifier.</li>
</ul>
<h3 id="other_changes">Other Changes</h3>
<ul>
<li>Improved debug output.</li>
<li>Fixed various prerendering bugs.</li>
<li>Added support for unprefixed prerendering apis. Prerendering now works in IE11 in addition to Chrome.</li>
<li>Other minor bug fixes in linker support.</li>
</ul>
Web Tracking (ga.js) - Release 2014-04-16 (April 16, 2014)tag:google.com,changelog:analytics-collection-gajs#release-2014-05-092014-05-09T08:00:00:+0000
<ul>
<li>Yahoo secure search is now correctly classified as an organic source.</li>
<li>Added support for unprefixed prerendering apis. Prerendering now works in IE11 in addition to Chrome.</li>
</ul>
Core Reporting API - Release 2014-04-11 (April 11, 2014)tag:google.com,changelog:analytics-reporting-core#release-2014-04-112014-04-11T08:00:00:+0000
<h3 id="segments_core_reporting_api_v24__v30">Segments: Core Reporting API v2.4 & v3.0</h3>
<p>New segments support in the Core Reporting API.</p>
<ul>
<li>The <code>segment</code> parameter now supports user and sequence segments. <strong>User level</strong> and <strong>session level</strong> segments created in the web interface can be queried with the <code>segment</code> parameter.</li>
<li>A new syntax for dynamic segments is available to use with the <code>segment</code> parameter. For details see the <a href="
https://developers.google.com/analytics/devguides/reporting/core/v3/segments">Segments Dev Guide</a></li>
<li>The <code>dynamic::</code> prefix has been deprecated. It is recommended that you <a href="
https://developers.google.com//analytics/devguides/reporting/core/v3/segments#legacy-migration">migrate</a> to the new syntax as soon as possible.</li>
</ul>
Management API - Release 2014-04-11 (April 11, 2014)tag:google.com,changelog:analytics-config-mgmt#release-2014-04-112014-04-11T08:00:00:+0000
<h3 id="segments_management_api_v24__v30">Segments: Management API v2.4 & v3.0</h3>
<p>The following changes have been made to the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/segments">Segments Collection</a>:</p>
<ul>
<li>User and sequence segments are now supported in the API.</li>
<li>The Segments Collection now returns all built-in and custom <strong>session level</strong> and <strong>user level</strong> segments.</li>
<li>The <code>definition</code> property for segments will now use the new segments syntax. This includes definitions for existing <strong>session level</strong> segments which will change from <code>definition: "<definition>"</code> to <code>definition: "sessions::condition::<definition>"</code>.</li>
<li>A new <code>type</code> property has been added to the <a href="
/analytics/devguides/config/mgmt/v3/mgmtReference/management/segments">Segment</a> resource to indicate whether a segment is <code>CUSTOM</code> (i.e. created by a user in the web interface) or <code>BUILT_IN</code> (i.e. provided by Google Analytics).</li>
</ul>
<h3 id="experiments">Experiments</h3>
<p>The following AdSense metrics can now be used as optimization objectives:</p>
<ul>
<li><code>ga:adsenseAdsClicks</code> — The number of times AdSense ads on your site were clicked.</li>
<li><code>ga:adsenseAdsViewed</code> — The number of AdSense ads viewed. Multiple ads can be displayed within an Ad Unit.</li>
<li><code>ga:adsenseRevenue</code> — The total revenue from AdSense ads.</li>
</ul>
Web Tracking (analytics.js) - Release 2014-04 (April 2, 2014)tag:google.com,changelog:analytics-collection-analyticsjs#release-2014-04-022014-04-02T08:00:00:+0000
<ul>
<li>Added the ability to override <a href="https://developers.google.com/analytics/devguides/collection/analyticsjs/user-id">User ID parameter</a>.</li>
</ul>
Management API - Release 2014-03-25 (March 25, 2014)tag:google.com,changelog:analytics-config-mgmt#release-2014-03-252014-03-25T08:00:00:+0000
<h4 id="new_account_summaries_collection">New Account Summaries Collection</h4>
<ul>
<li>The <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/accountSummaries">AccountSummaries</a> collection has been added to the Management API. It provides a summary of information for each account, property, and view (profile) an authorized user has access to in a single and fast request. See the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtAccountSummariesGuide">Account Summaries Developer Guide</a> for details.</li>
</ul>
Android SDK - Release Version 4 (March 25, 2014)tag:google.com,changelog:analytics-collection-android#release-2014-03-252014-03-25T08:00:00:+0000
<h3 id="google_analytics_and_google_tag_manager">Google Analytics and Google Tag Manager</h3>
<ul>
<li>The Google Analytics and Google Tag Manager SDKs are now part of the <a href="
http://android-developers.blogspot.com/2014/03/google-play-services-43.html">Google Play Services SDK 4.3</a> .</li>
<li>This does not require devices to have Google Play Services installed. When Google Play Services is not available the SDK will automatically fall back to local dispatching.</li>
<li>For details on how to get started see <a href="
https://developers.google.com/tag-manager/android/v4/">Google Tag Manager SDK v4 for Android</a> and <a href="
https://developers.google.com/analytics/devguides/collection/android/v4/">Google Analytics SDK v4 for Android</a></li>
</ul>
Real Time Reporting API - Release 2014-03 (March 20, 2014)tag:google.com,changelog:analytics-reporting-realtime#release-2014-03-202014-03-20T08:00:00:+0000
<h3 id="_prefix_deprecated"><code>ga:</code> Prefix Deprecated</h3>
<p>The <code>ga:</code> prefix has been deprecated for all Real Time Dimensions and Metrics and has been replaced by the new <code>rt:</code> prefix. API requests that use the <code>ga:</code> prefix will continue to work for 6 months, after which an error will be returned.</p>
<h3 id="new_dimensions_and_metrics">New Dimensions and Metrics</h3>
<p>This update adds new dimensions and metrics to the Real Time Reporting API. Check the <a href="
https://developers.google.com/analytics/devguides/reporting/realtime/dimsmets/">Dimensions and Metrics Reference</a> for the complete list.</p>
<h4 id="event_tracking">Event Tracking</h4>
<ul>
<li>Dimension - <code>rt:eventAction</code> - the action of the event.</li>
<li>Dimension - <code>rt:eventCategory</code> - the category of the event.</li>
<li>Dimension - <code>rt:eventLabel</code> - the label of the event.</li>
<li>Dimension - <code>rt:totalEvents</code> - the total number of events for the profile, across all categories.</li>
</ul>
<h4 id="goal_tracking">Goal Tracking</h4>
<ul>
<li>Dimension - <code>rt:goalId</code> - a string corresponding to the goal ID.</li>
<li>Metric - <code>rt:goalXXValue</code> - the total numeric value for the requested goal number, where XX is a number between 1 and 20.</li>
<li>Metric - <code>rt:goalValueAll</code> - the total numeric value for all goals defined for your profile.</li>
<li>Metric - <code>rt:goalXXCompletions</code> - the total number of completions for the requested goal number, where XX is a number between 1 and 20.</li>
<li>Metric - <code>rt:goalCompletionsAll</code> - the total number of completions for all goals defined for your profile.</li>
</ul>
<h4 id="page_tracking">Page Tracking</h4>
<ul>
<li>Metric - <code>rt:pageViews</code> - the total number of page views.</li>
</ul>
<h4 id="app_tracking">App Tracking</h4>
<ul>
<li>Metric - <code>rt:screenViews</code> - the total number of screen views.</li>
</ul>
iOS SDK - Release Version 3.06 (March 18, 2014)tag:google.com,changelog:analytics-collection-ios#release-2014-05-092014-05-09T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>SDK will now populate the Application Id parameter (<code>&aid</code>) by default.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Added support for Google Analytics Content Experiments Macro.</li>
</ul>
Android SDK - Release Version 3.02 (March 18, 2014)tag:google.com,changelog:analytics-collection-android#release-2014-03-182014-03-18T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>No changes to Google Analytics.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Added support for Google Analytics Content Experiments Macro.</li>
</ul>
iOS SDK - Release Version 3.03c (February 19, 2014)tag:google.com,changelog:analytics-collection-ios#release-2014-02-192014-02-19T08:00:00:+0000
<p>This release contains:</p>
<h3 id="google_analytics">Google Analytics</h3>
<ul>
<li>No changes to Google Analytics directly. GA users should note that Google Tag Manager no longer has a dependency on <code>AdSupport.framework</code> by default. This may help resolve <a href="https://code.google.com/p/analytics-issues/issues/detail?id=387">Issue 387</a>.</li>
</ul>
<h3 id="google_tag_manager">Google Tag Manager</h3>
<ul>
<li>Functions that call <code>AdSupport.framework</code> API are broken out into a separate library, <code>libAdIdAccess.a</code>. Apps need to link with that library to have access to the advertising identifier (IDFA) string and advertiser tracking enabled flag.</li>
</ul>
Multi-Channel Funnels Reporting API - Release 2014-02-14 (February 14, 2014)tag:google.com,changelog:analytics-reporting-mcf#release-2014-02-142014-02-14T08:00:00:+0000
<p>This release adds new dimensions and metrics to the API. Check the <a href="
//developers.google.com/analytics/devguides/reporting/mcf/dimsmets/">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="conversion_paths">Conversion Paths</h3>
<ul>
<li>Dimension - <code>mcf:adwordsCustomerIDPath</code> - Sequence of AdWords customer ID along conversion paths.</li>
</ul>
<h3 id="interactions">Interactions</h3>
<ul>
<li>Dimension - <code>mcf:adwordsCustomerID</code> - Corresponds to AdWords API <code>Customer.id</code>.</li>
</ul>
Web Tracking (analytics.js) - Release 2014-02 (February 11, 2014)tag:google.com,changelog:analytics-collection-analyticsjs#release-2014-02-112014-02-11T08:00:00:+0000
<ul>
<li><a href="https://developers.google.com/analytics/devguides/collection/analyticsjs/cross-domain#linkerparam">Linker parameters</a> are no longer ignored when navigating across domains at different zoom levels in Firefox.</li>
<li>Fixed a problem where <a href="https://support.google.com/analytics/answer/2558811">In-Page Analytics</a> would fail to load for certain URLs.</li>
<li>Improvements to debug mode output.</li>
</ul>
Web Tracking (ga.js) - Release 2014-02 (February 11, 2014)tag:google.com,changelog:analytics-collection-gajs#release-2014-02-112014-02-11T08:00:00:+0000
<ul>
<li>Maintenance release.</li>
</ul>
iOS SDK - Release Version 3.03a (February 5, 2014)tag:google.com,changelog:analytics-collection-ios#release-2014-02-052014-02-05T08:00:00:+0000
<p>This release contains: * Removed need for <code>AdSupport.framework</code>. * Removed unused code.</p>
iOS SDK - Release Version 3.03 (January 14, 2014)tag:google.com,changelog:analytics-collection-ios#release-2014-01-142014-01-14T08:00:00:+0000
<p>This release contains: * Added support for 64-bit iOS 7.0 SDK. * Removed <code>libGoogleAnalytics_debug.a</code>, it’s part of the <code>libGoogleAnalyticsServices.a</code> library. * Cleaned up CuteAnimals build file for Google Analytics.</p>
Multi-Channel Funnels Reporting API - Release 2013-12-12 (December 12, 2013)tag:google.com,changelog:analytics-reporting-mcf#release-2013-12-122013-12-12T08:00:00:+0000
<p>This release adds new dimensions and metrics to the API. Check the <a href="
//developers.google.com/analytics/devguides/reporting/mcf/dimsmets/">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="conversion_paths">Conversion Paths</h3>
<ul>
<li>Dimension - <code>mcf:adwordsAdGroupIDPath</code> - Sequence of AdWords ad group ID along conversion paths.</li>
<li>Dimension - <code>mcf:adwordsCampaignIDPath</code> - Sequence of AdWords campaign ID along conversion paths.</li>
<li>Dimension - <code>mcf:adwordsCreativeIDPath</code> - Sequence of AdWords creative ID along conversion paths.</li>
<li>Dimension - <code>mcf:adwordsCriteriaIDPath</code> - Sequence of AdWords criteria ID along conversion paths.</li>
</ul>
<h3 id="interactions">Interactions</h3>
<ul>
<li>Dimension - <code>mcf:adwordsAdGroupID</code> - Corresponds to AdWords API <code>AdGroup.id</code>.</li>
<li>Dimension - <code>mcf:adwordsCampaignID</code> - Corresponds to AdWords API <code>Campaign.id</code>.</li>
<li>Dimension - <code>mcf:adwordsCreativeID</code> - Corresponds to AdWords API <code>Ad.id</code>.</li>
<li>Dimension - <code>mcf:adwordsCriteriaID</code> - Corresponds to AdWords API <code>Criterion.id</code>.</li>
</ul>
Core Reporting API - Release 2013-12-12 (December 12, 2013)tag:google.com,changelog:analytics-reporting-core#release-2013-12-122013-12-12T08:00:00:+0000
<p>This release includes a new <a href="https://developers.google.com/chart/interactive/docs/datatables_dataviews">Data Table</a> response format and the addition and deprecation of dimensions and metrics (Review the <a href="
//developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions).</p>
<h3 id="data_table_output">Data Table Output</h3>
<p>To make it easier to render your Google Analytics data using Google Charts visualizations, the API can optionally return a Data Table object in the response.</p>
<ul>
<li>An optional <code>output</code> query parameter has been added to the API. It can be used to select the output format of Analytics data in the response, which is JSON by default. If set to <code>datatable</code>, a <code>dataTable</code> property that contains a <a href="https://developers.google.com/chart/interactive/docs/datatables_dataviews">Data Table</a> object is included in the response. This object can be used directly with <a href="https://developers.google.com/chart">Google Charts</a>. See the <a href="https://developers.google.com//analytics/devguides/reporting/core/v3/reference#output">Core Reporting API reference</a> for details.</li>
</ul>
<h3 id="new_dimensions_and_metrics">New Dimensions and Metrics</h3>
<p>The following dimensions and metrics have been added to the Core Reporting API:</p>
<h4 id="time">Time</h4>
<ul>
<li>Dimension - <code>ga:minute</code> - Returns the minute in the hour. The possible values are between <code>00</code> and <code>59</code>.</li>
<li>Dimension - <code>ga:nthMinute</code> - Index for each minute in the specified date range. Index for the first minute of first day (i.e., start-date) in the date range is <code>0</code>, <code>1</code> for the next minute, and so on.</li>
</ul>
<h4 id="audience">Audience</h4>
<ul>
<li>Dimension - <code>ga:visitorAgeBracket</code> - Age bracket of visitor.</li>
<li>Dimension - <code>ga:visitorGender</code> - Gender of visitor.</li>
<li>Dimension - <code>ga:interestAffinityCategory</code> - Indicates that users are more likely to be interested in learning about the specified category.</li>
<li>Dimension - <code>ga:interestInMarketCategory</code> - Indicates that users are more likely to be ready to purchase products or services in the specified category.</li>
<li>Dimension - <code>ga:interestOtherCategory</code> - Indicates that users are more likely to be interested in learning about the specified category, and more likely to be ready to purchase.</li>
</ul>
<h3 id="dimensions_and_metrics_allowed_in_segments">Dimensions and Metrics Allowed In Segments</h3>
<p>These dimensions and metrics can now be used in segments:</p>
<ul>
<li>Dimension - <code>ga:sourceMedium</code> - Combined values of <code>ga:source</code> and <code>ga:medium</code>.</li>
<li>Metric - <code>ga:localItemRevenue</code> - Product revenue in local currency.</li>
</ul>
<h3 id="deprecated_dimensions_and_metrics">Deprecated Dimensions and Metrics</h3>
<p>These dimensions and metrics have been deprecated. Review the <a href="https://developers.google.com/analytics/devguides/reporting/metadata/v3/data-deprecation#remove">Data Deprecation Policy</a> for details on data removal:</p>
<ul>
<li>Dimension - <code>ga:isMobile</code> - Use <code>ga:deviceCategory</code> instead (e.g., <code>ga:deviceCategory==mobile</code>).</li>
<li>Dimension - <code>ga:isTablet</code> - Use <code>ga:deviceCategory</code> instead (e.g., <code>ga:deviceCategory==tablet</code>).</li>
<li>Metric - <code>ga:entranceBounceRate</code> - Use <code>ga:visitBounceRate</code> instead.</li>
</ul>
Management API - Release 2013-12-12 (December 12, 2013)tag:google.com,changelog:analytics-config-mgmt#release-2013-12-122013-12-12T08:00:00:+0000
<p>The following changes have been made to default segments due to the <a href="https://developers.google.com/analytics/devguides/reporting/core/v3/changelog">deprecation</a> of the <code>ga:isMobile</code> and <code>ga:isTablet</code> dimensions:</p>
<ul>
<li>Segment <code>gaid::-11</code> has been renamed from <strong>Mobile Traffic</strong> to <strong>Mobile and Tablet Traffic</strong>. The definition for this segment has been changed from <code>ga:isMobile==Yes</code> to <code>ga:deviceCategory==mobile,ga:deviceCategory==tablet</code>. Note that <code>ga:isMobile</code> included tablet traffic, which is reflected in the new definition. If you only want mobile traffic, excluding tablet, then switch to the new <strong>Mobile Traffic</strong> segment (<code>gaid::-14</code>).</li>
<li>Segment <code>gaid::-13</code> definition has changed from <code>ga:isTablet==Yes</code> to <code>ga:deviceCategory==tablet</code>. This continues to represent <strong>Tablet Traffic</strong>.</li>
<li>Segment <code>gaid::-14</code> has been added. The name of the segment is <strong>Mobile Traffic</strong> and the definition is <code>ga:deviceCategory==mobile</code>.</li>
</ul>
Web Tracking (analytics.js) - Release 2013-11 (November 22, 2013)tag:google.com,changelog:analytics-collection-analyticsjs#release-2013-11-222013-11-22T08:00:00:+0000
<ul>
<li>Maintenance release.</li>
</ul>
Web Tracking (ga.js) - Release 2013-11 (November 22, 2013)tag:google.com,changelog:analytics-collection-gajs#release-2013-11-222013-11-22T08:00:00:+0000
<ul>
<li>Improvements to support <a href="https://developers.google.com/analytics/devguides/collection/upgrade/">Universal Analytics upgrades</a> on sites that use multiple trackers.</li>
</ul>
Web Tracking (analytics.js) - Release 2013-11 (November 7, 2013)tag:google.com,changelog:analytics-collection-analyticsjs#release-2013-11-072013-11-07T08:00:00:+0000
<ul>
<li>Added <a href="https://developers.google.com/analytics/devguides/collection/analyticsjs/domains#auto">Automatic Cookie Domain Configuration</a></li>
<li>Added <a href="https://developers.google.com/analytics/devguides/collection/analyticsjs/cross-domain#autoforms">Cross-Domain Auto Linking for Forms</a></li>
<li>Bug fixes</li>
</ul>
Core Reporting API - Release 2013-10-28 (October 28, 2013)tag:google.com,changelog:analytics-reporting-core#release-2013-10-282013-10-28T08:00:00:+0000
<p>This release adds new dimensions and metrics to the API. Check the <a href="
//developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="adsense">Adsense</h3>
<ul>
<li>
<p>Access to Adsense data has been added:</p>
<ul>
<li>Met - <code>ga:adsenseRevenue</code> - The total revenue from AdSense ads.</li>
<li>Met - <code>ga:adsenseAdUnitsViewed</code> - The number of AdSense ad units viewed. An Ad unit is a set of ads displayed as a result of one piece of the AdSense ad code. Details: <a href="
https://support.google.com/adsense/answer/32715">https://support.google.com/adsense/answer/32715</a>.</li>
<li>Met - <code>ga:adsenseAdsViewed</code> - The number of AdSense ads viewed. Multiple ads can be displayed within an Ad Unit.</li>
<li>Met - <code>ga:adsenseAdsClicks</code> - The number of times AdSense ads on your site were clicked.</li>
<li>Met - <code>ga:adsensePageImpressions</code> - The number of pageviews during which an AdSense ad was displayed. A page impression can have multiple Ad Units.</li>
<li>Met - <code>ga:adsenseCTR</code> - The percentage of page impressions that resulted in a click on an AdSense ad. (<code>ga:adsenseAdsClicks/ga:adsensePageImpressions</code>)</li>
<li>Met - <code>ga:adsenseECPM</code> - The estimated cost per thousand page impressions. It is your AdSense Revenue per 1000 page impressions. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000).</li>
<li>Met - <code>ga:adsenseExits</code> - The number of sessions that ended due to a user clicking on an AdSense ad.</li>
</ul>
</li>
</ul>
<h3 id="time">Time</h3>
<ul>
<li>Dim - <code>ga:isoYear</code> - The ISO year of the visit. Details: <a href="http://en.wikipedia.org/wiki/ISO_week_date">http://en.wikipedia.org/wiki/ISO_week_date</a>. <code>ga:isoYear</code> should only be used with <code>ga:isoWeek</code> since <code>ga:week</code> represents gregorian calendar.</li>
<li>Dim - <code>ga:isoYearIsoWeek</code> - Combined values of <code>ga:isoYear</code> and <code>ga:isoWeek</code>.</li>
</ul>
<h3 id="adwords">Adwords</h3>
<ul>
<li>
<p>This data is found in Adwords reports:</p>
<ul>
<li>Dim - <code>ga:adKeywordMatchType</code> - The match types applied to your keywords (Phrase, Exact, Broad). Details: <a href="https://support.google.com/adwords/answer/2472708">Understanding the Search terms report</a>.</li>
</ul>
</li>
</ul>
Management API - Release 2013-10-28 (October 28, 2013)tag:google.com,changelog:analytics-config-mgmt#release-2013-10-282013-10-28T08:00:00:+0000
<p>Bug Fixes:</p>
<ul>
<li>Timezone information for views (profiles) has been fixed. <strong>Details</strong>: Before this fix, in certain cases when listing view (profiles) in the Management API, incorrect timezone information for a view (profile) was returned. Now timezone information for views (profiles) is consistent with what is set in the Google Analytics admin interface.</li>
</ul>
iOS SDK - Release Version 3.02 (October 18, 2013)tag:google.com,changelog:analytics-collection-ios#release-2013-10-182013-10-18T08:00:00:+0000
<p>This release contains: * Fixed conflict with protocol buffer SDK. * Fixed linker error when code stripping was enabled.</p>
Multi-Channel Funnels Reporting API - Release 2013-10-14 (October 14, 2013)tag:google.com,changelog:analytics-reporting-mcf#release-2013-10-142013-10-14T08:00:00:+0000
<h4 id="new_sample_size_control_and_relative_dates_features">New Sample Size Control and Relative Dates Features</h4>
<h5 id="relative_dates">Relative Dates</h5>
<ul>
<li>Support for relative dates has been added to the MCF Reporting API. <code>today</code>, <code>yesterday</code>, and <code>NdaysAgo</code> are now valid values for the <code>start-date</code> and <code>end-date</code> query parameters.</li>
<li>Using these values will automatically determine the date range based on the current date at the time the query is made, and on the timezone of the view (profile) specified in the query. See the <a href="
https://developers.google.com/analytics/devguides/reporting/mcf/v3/reference#startDate">API Reference</a> for additional details.</li>
</ul>
<h5 id="sampling_level">Sampling Level</h5>
<ul>
<li>A new parameter, <code>samplingLevel</code>, has been introduced that allows you to set the sampling level (i.e. the number of visits used to calculate the result) for a reporting query. Allowed values are: <code>DEFAULT</code>, <code>FASTER</code>, and <code>HIGHER_PRECISION</code>.</li>
<li>2 new fields have been added to the API Response: <code>sampleSize</code> and <code>sampleSpace</code>. You can use these values to calculate the percentage of visits that were used for a sampled response.</li>
<li>See the <a href="
https://developers.google.com/analytics/devguides/reporting/mcf/v3/reference#samplingLevel">API Reference</a> and <a href="
https://developers.google.com/analytics/devguides/reporting/mcf/v3/reference#sampling">Sampling</a> for additional details.</li>
</ul>
Core Reporting API - Release 2013-10-14 (October 14, 2013)tag:google.com,changelog:analytics-reporting-core#release-2013-10-142013-10-14T08:00:00:+0000
<h4 id="new_sample_size_control_and_relative_dates_features">New Sample Size Control and Relative Dates Features</h4>
<h5 id="relative_dates">Relative Dates</h5>
<ul>
<li>Support for relative dates has been added to the Core Reporting API. <code>today</code>, <code>yesterday</code>, and <code>NdaysAgo</code> are now valid values for the <code>start-date</code> and <code>end-date</code> query parameters.</li>
<li>Using these values will automatically determine the date range based on the current date at the time the query is made, and on the timezone of the view (profile) specified in the query. See the <a href="
https://developers.google.com/analytics/devguides/reporting/core/v3/reference#startDate">API Reference</a> for additional details.</li>
</ul>
<h5 id="sampling_level">Sampling Level</h5>
<ul>
<li>A new parameter, <code>samplingLevel</code>, has been introduced that allows you to set the sampling level (i.e. the number of visits used to calculate the result) for a reporting query. Allowed values are: <code>DEFAULT</code>, <code>FASTER</code>, and <code>HIGHER_PRECISION</code>.</li>
<li>2 new fields have been added to the API Response: <code>sampleSize</code> and <code>sampleSpace</code>. You can use these values to calculate the percentage of visits that were used for a sampled response.</li>
<li>See the <a href="
https://developers.google.com/analytics/devguides/reporting/core/v3/reference#samplingLevel">API Reference</a> and <a href="
https://developers.google.com/analytics/devguides/reporting/core/v3/reference#sampling">Sampling</a> for additional details.</li>
</ul>
Android SDK - Release Version 2.0beta6 (October 11, 2013)tag:google.com,changelog:analytics-collection-android#release-2013-10-112013-10-11T08:00:00:+0000
<p>This release contains: * Sixth beta release. * Made change required to avoid a runtime exception when an app targeting KitKat (API Level 19) uses the SDK.</p>
Android SDK - Release Version 3.01 (October 11, 2013)tag:google.com,changelog:analytics-collection-android#release-2013-10-112013-10-11T08:00:00:+0000
<p>This release contains: * Second release of version 3.0. * Made change required to avoid a runtime exception when an app targeting KitKat (API Level 19) uses the SDK.</p>
Management API - Release 2013-10-04 (October 4, 2013)tag:google.com,changelog:analytics-config-mgmt#release-2013-10-042013-10-04T08:00:00:+0000
<h4 id="uploads_dimension_widening">Uploads (Dimension Widening)</h4>
<ul>
<li>The new <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/uploads">Uploads</a> resource enables uploading of Dimension Widening data. See the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtUploads">Data Import (Uploads) Developer Guide</a> for details.</li>
</ul>
Management API - Release 2013-10-03 (October 3, 2013)tag:google.com,changelog:analytics-config-mgmt#release-2013-10-032013-10-03T08:00:00:+0000
<p>This release introduces write operations for Web Property, View (Profile), and Goal resources and a set of 3 new resources that enable User Permissions management.</p>
<h4 id="account_setup_and_configuration_apis">Account Setup and Configuration APIs</h4>
<ul>
<li>Views (Profiles) can now be created, updated, patched, and deleted. Review the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/profiles">View (Profiles) reference</a> for details on the new methods.</li>
<li>Web Properties and Goals can now be created, updated, and patched. Review the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/webproperties">Web Properties reference</a> and <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/goals">Goals reference</a> for details on the new methods.</li>
<li>A single Web Property, View (Profile), or Goal can now be requested with the <code>get</code> method.</li>
<li>These features are currently available as a developer preview in limited beta. If you’re interested is signing up, <a href="
https://docs.google.com/forms/d/1xyjp6ca4YkGjh7TDi1Z3XyA3XHcRHkKzFentxzUrmPY/viewform">request access to the beta</a>.</li>
</ul>
<h4 id="user_permissions_in_the_management_api">User Permissions in the Management API</h4>
<ul>
<li>The new <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/accountUserLinks">accountUserLinks</a> resource enables the management of account permissions for users.</li>
<li>The new <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/webpropertyUserLinks">webpropertyUserLinks</a> resource enables the management of property permissions for users.</li>
<li>The new <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/accountUserLinks">profileUserLinks</a> resource enables the management of view (profile) permissions for users.</li>
<li>Permissions for an authorized user are now available as part of the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/accounts">Account</a>, <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/webproperties">Web Property</a> and <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/profiles">View (Profile)</a> resources.</li>
<li>A new scope has been introduced and is required to manage user permissions. <code>https://www.googleapis.com/auth/analytics.manage.users</code>.</li>
<li>See the <a href="
https://developers.google.com/analytics/devguides/config/mgmt/v3/mgmtUserPermissions">User Permissions Dev Guide</a> for additional details.</li>
</ul>
iOS SDK - Release Version 3.01 (September 20, 2013)tag:google.com,changelog:analytics-collection-ios#release-2013-09-202013-09-20T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Fixed link error when targeting iOS 7.0.</li>
</ul>
Metadata API - Release 2013-08 (August 20, 2013)tag:google.com,changelog:analytics-reporting-metadata#release-2013-08-202013-08-20T08:00:00:+0000
<p>This is the initial release of the Metadata API:</p>
<ul>
<li>The Metadata API returns information about the dimensions and metrics exposed in Google Analytics reporting APIs. The metadata returned includes attributes like UI name, description, advanced segments support, and more. By using the Metadata API, your applications can automatically stay up to date with the latest data on the dimensions and metrics available for reporting queries. Visit the <a href="
https://developers.google.com/analytics/devguides/reporting/metadata/v3/">Metadata API Overview</a> for more details.</li>
</ul>
iOS SDK - Release Version 3.0.0 (August 16, 2013)tag:google.com,changelog:analytics-collection-ios#release-2013-08-162013-08-16T08:00:00:+0000
<p>This release contains: * First release of version 3.0 * SDK API change to align with analytics.js. The <code>track<hittype></code> and <code>send<hittype></code> methods have been removed. Use <code>send</code> and the <code>GAIDictionaryBuilder</code> construct methods instead. * Most properties on the <code>GAITracker</code> protocol have been removed. Use <code>set</code> on the various fields instead. * All parameters set using the <code>set</code> method will be persisted. Previously, several parameters would only be set for the next send/track call. * <code>GAILogger</code> protocol is available for those wanting to implement their own custom logging for the SDK. * Minimium system requirements have changed. See Readme.txt for details. * All SDK activity (database and network access) is now done on a separate thread. * <code>clientId</code> can now be read. Call <code>[tracker get:kGAIClientId]</code>. Note that this call will block until the <code>clientId</code> can be read from the database. * SDK no longer uses <code>POST</code> unless the hit is larger than 2000 bytes. It will use <code>GET</code> instead. * SDK will no longer retry sending hits based off the HTTP response code.</p>
Android SDK - Release Version 3.0.0 (August 16, 2013)tag:google.com,changelog:analytics-collection-android#release-2013-08-162013-08-16T08:00:00:+0000
<p>This release contains: * First release of version 3.0 * SDK API rewritten to more closely align with analytics.js. See javadoc and https://developers.google.com/analytics/devguides/collection/android/v3/ for details. * All <code>track<hittype></code> and <code>send<hittype></code> methods removed. Instead, you can use the send method and the corresponding construct methods in the <code>MapBuilder</code> class to send hits. See the class <code>Fields</code> for a list of constants you can use to build hits using <code>set</code> and <code>send</code>. * Many of the various properties have also been removed, including <code>useHttps</code>, <code>anonymizeIp</code>, etc. You can set/reset those properties using the <code>set</code> command. * <code>EasyTracker</code> now extends <code>Tracker</code>. There is no need to call <code>EasyTracker.getTracker</code> to make tracking calls directly. * The SDK no longer sets the session control flag to start on startup. Developers are now responsible for determining if a new session is needed. Note that EasyTracker still handles session management as before. * The SDK now supports a custom logging class. See <code>Logger</code> in the javadoc for details. * <code>dryRun</code> mode has been added. * <code>clientId</code> can now be read. Simply call <code>tracker.get(Fields.CLIENT_ID)</code>. This call will block until the <code>clientId</code> has been loaded from the persistent store. * The SDK will no longer retry hits based on the HTTP response code.</p>
Real Time Reporting API - Release 2013-08 (August 1, 2013)tag:google.com,changelog:analytics-reporting-realtime#release-2013-08-012013-08-01T08:00:00:+0000
<p>This is the initial release of the Real Time Reporting API in limited beta:</p>
<ul>
<li>The Real Time Reporting API allows you to report on activity occurring on your property right now. You can use the Real Time reporting API to query for dimensions and metrics in order to build customer facing web widgets and dashboards. Visit the <a href="
https://developers.google.com/analytics/devguides/reporting/realtime/v3/">Real Time Reporting API Overview</a> for more details.</li>
</ul>
Core Reporting API - Release 2013-07-22 (July 23, 2013)tag:google.com,changelog:analytics-reporting-core#release-2013-07-232013-07-23T08:00:00:+0000
<h4 id="bug_fixes">Bug Fixes</h4>
<ul>
<li>The <code>ga:adwordsCustomerID</code> now correctly returns the 10-digit AdWords Customer ID corresponding to the AdWords API <a href="
//developers.google.com/adwords/api/docs/reference/v201306/CustomerService.Customer#customerId">AccountInfo.customerId</a>. This fix makes it possible to join Analytics data with multiple AdWords accounts.</li>
</ul>
Core Reporting API - Release 2013-07-15 (July 16, 2013)tag:google.com,changelog:analytics-reporting-core#release-2013-07-162013-07-16T08:00:00:+0000
<p>As part of the <a href="
http://analytics.blogspot.com/2013/07/re-imagining-segmentation-in-analytics.html">new segments launch</a>, we will be rolling out the following changes to the Core Reporting API.</p>
<ul>
<li>The <code>segment</code> parameter now supports the new alphanumeric ID for custom advanced segments, which is returned in the Management API <a href="
//developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/segments">Segments collection</a>.</li>
<li>The current numeric IDs for custom segments are now under deprecation. These legacy IDs will continue to be supported for 6 months. We recommend applications that save user segment IDs to switch to the new alphanumeric IDs. Once the deprecation period is over, any queries with the old numeric IDs will return an error.</li>
<li>Currently, only the <strong>visit level</strong> segments created in the web interface will be queryable through the <code>segment</code> parameter.</li>
<li>The existing default segments with negative numeric IDs will not be affected. However, the new default segments are currently not supported.</li>
</ul>
Management API - Release 2013-07-15 (July 16, 2013)tag:google.com,changelog:analytics-config-mgmt#release-2013-07-162013-07-16T08:00:00:+0000
<p>As part of the <a href="
http://analytics.blogspot.com/2013/07/re-imagining-segmentation-in-analytics.html">new segments launch</a>, we will be rolling out the following changes to the <a href="
//developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/segments">Segments Collection</a>:</p>
<ul>
<li>All Segment IDs will be changed from positive integers to alphanumeric strings. If you have saved users’ Segment IDs, we recommend you update them to use the new IDs.</li>
<li>The Segments Collection will only return the existing <strong>visit level</strong> segments. The new visitor, cohort, and sequence segments are currently not supported in the API.</li>
<li>The Segments Collection will continue to return the existing default segments with the same negative numeric IDs, however, the new default segments are currently not supported.</li>
</ul>
Core Reporting API - Release 2013-07-09 (July 9, 2013)tag:google.com,changelog:analytics-reporting-core#release-2013-07-092013-07-09T08:00:00:+0000
<p>This release adds new dimensions and metrics to the API. Check the <a href="
//developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for the complete list of definitions.</p>
<h3 id="app_tracking">App Tracking</h3>
<ul>
<li>This data is found in App profile reports:
<ul>
<li>Dim - <code>ga:appId</code> - The id of the application.</li>
<li>Dim - <code>ga:appInstallerId</code> - ID of the installer (e.g., Google Play Store) from which the app was downloaded. By default, the app installer id is set based on the <code>PackageManager#getInstallerPackageName</code> method.</li>
<li>Dim - <code>ga:appName</code> - The name of the application.</li>
<li>Dim - <code>ga:appVersion</code> - The version of the application.</li>
<li>Dim - <code>ga:exitScreenName</code> - The name of the screen when the user exited the application.</li>
<li>Dim - <code>ga:landingScreenName</code> - The name of the first screen viewed.</li>
<li>Dim - <code>ga:screenDepth</code> - The number of screenviews per session reported as a string. Can be useful for historgrams.</li>
<li>Dim - <code>ga:screenName</code> - The name of the screen.</li>
<li>Met - <code>ga:avgScreenviewDuration</code> - The average amount of time users spent on a screen in seconds.</li>
<li>Met - <code>ga:timeOnScreen</code> - The time spent viewing the current screen.</li>
<li>Met - <code>ga:screenviews</code> - The total number of screen views. Use this instead of <code>ga:appviews</code>.</li>
<li>Met - <code>ga:uniqueScreenviews</code> - The number of different (unique) <code>ga:screenviews</code> within a session. Use this instead of <code>ga:uniqueAppviews</code>.</li>
<li>Met - <code>ga:screenviewsPerSession</code> - The average number of <code>ga:screenviews</code> per session. Use this intead of <code>ga:appviewsPerVisit</code>.</li>
</ul>
</li>
</ul>
<h4 id="deprecated">Deprecated</h4>
<p>The following metrics have been deprecated. Use the new metric name instead.</p>
<ul>
<li>Met - <code>ga:appviews</code> - Use <code>ga:screenviews</code> instead.</li>
<li>Met - <code>ga:uniqueAppviews</code> - Use <code>ga:uniqueScreenviews</code> instead.</li>
<li>Met - <code>ga:appviewsPerVisit</code> - Use <code>ga:screenviewsPerSession</code> instead.</li>
</ul>
<h3 id="custom_variables_or_columns">Custom Variables or Columns</h3>
<ul>
<li>
<p>Access to custom dimension and metrics:</p>
<ul>
<li>Dim - <code>ga:dimensionXX</code> - The name of the requested custom dimension, where <code>XX</code> refers the number/index of the custom dimension.</li>
<li>Met - <code>ga:metricXX</code> - The name of the requested custom metric, where <code>XX</code> refers the number/index of the custom metric.</li>
</ul>
</li>
</ul>
<h4 id="documentation_changes">Documentation Changes</h4>
<p>The following Custom Variable dimension and metric have been renamed. This is a documentation change only, it will not require you to update your queries.</p>
<ul>
<li><code>ga:customVarName(n)</code> → <code>ga:customVarNameXX</code></li>
<li><code>ga:customVarValue(n)</code> → <code>ga:customVarValueXX</code></li>
</ul>
<h3 id="ecommerce">Ecommerce</h3>
<ul>
<li>Dim - <code>ga:currencyCode</code> - The local currency code of the transaction based on ISO 4217 standard.</li>
<li>Met - <code>ga:localItemRevenue</code> - Product revenue in local currency.</li>
<li>Met - <code>ga:localTransactionRevenue</code> - Transaction revenue in local currency.</li>
<li>Met - <code>ga:localTransactionShipping</code> - Transaction shipping cost in local currency.</li>
<li>Met - <code>ga:localTransactionTax</code> - Transaction tax in local currency.</li>
</ul>
<h3 id="exceptions">Exceptions</h3>
<ul>
<li>This data comes from exception tracking.
<ul>
<li>Dim - <code>ga:exceptionDescription</code> - The description for the exception.</li>
<li>Met - <code>ga:exceptionsPerScreenview</code> - The number of exceptions thrown divided by the number of screenviews.</li>
<li>Met - <code>ga:fatalExceptionsPerScreenview</code> - The number of fatal exceptions thrown divided by the number of screenviews.</li>
</ul>
</li>
</ul>
<h3 id="goal_conversions">Goal Conversions</h3>
<ul>
<li>Dim - <code>ga:goalCompletionLocation</code> - The page path or screen name that matched any destination type goal completion.</li>
<li>Dim - <code>ga:goalPreviousStep1</code> - The page path or screen name that matched any destination type goal, one step prior to the goal completion location.</li>
<li>Dim - <code>ga:goalPreviousStep2</code> - The page path or screen name that matched any destination type goal, two steps prior to the goal completion location.</li>
<li>Dim - <code>ga:goalPreviousStep3</code> - The page path or screen name that matched any destination type goal, three steps prior to the goal completion location.</li>
</ul>
<h4 id="documentation_changes_2">Documentation Changes</h4>
<p>The following Goal Conversions dimension and metrics have been renamed. This is a documentation change only, it will not require you to update your queries.</p>
<ul>
<li><code>ga:goal(n)AbandonRate</code> → <code>ga:goalXXAbandonRate</code></li>
<li><code>ga:goal(n)Abandons</code> → <code>ga:goalXXAbandons</code></li>
<li><code>ga:goal(n)Completions</code> → <code>ga:goalXXCompletions</code></li>
<li><code>ga:goal(n)ConversionRate</code> → <code>ga:goalXXConversionRate</code></li>
<li><code>ga:goal(n)Starts</code> → <code>ga:goalXXStarts</code></li>
<li><code>ga:goal(n)Value</code> → <code>ga:goalXXValue</code></li>
<li><code>ga:searchGoal(n)ConversionRate</code> → <code>ga:searchGoalXXConversionRate</code></li>
</ul>
<h3 id="internal_search">Internal Search</h3>
<ul>
<li>Met - <code>ga:percentSearchRefinements</code> - The percentage of number of times a refinement (i.e., transition) occurs between internal search keywords within a session.</li>
</ul>
<h3 id="page_tracking">Page Tracking</h3>
<ul>
<li>Met - <code>ga:pageValue</code> - The average value of this page or set of pages. Page Value is ((Transaction Revenue + Total Goal Value) divided by Unique Pageviews for the page or set of pages).</li>
</ul>
<h3 id="platform_or_device">Platform or Device</h3>
<ul>
<li>
<p>This data is derived from the HTTP User-Agent string.</p>
<ul>
<li>Dim - <code>ga:deviceCategory</code> - The type of device: Desktop, Tablet, or Mobile.</li>
<li>Dim - <code>ga:isTablet</code> - Indicates tablet visitors. The possible values are <code>Yes</code> or <code>No</code>.</li>
<li>Dim - <code>ga:mobileDeviceMarketingName</code> - Marketing name used for mobile device.</li>
</ul>
</li>
</ul>
<h3 id="social_interactions">Social Interactions</h3>
<ul>
<li>
<p>This data comes from onsite social interaction tracking.</p>
<ul>
<li>Dim - <code>ga:socialEngagementType</code> - Engagement type. Possible values are <code>Socially Engaged</code> or <code>Not Socially Engaged</code>.</li>
</ul>
</li>
</ul>
<h3 id="time">Time</h3>
<ul>
<li>Dim - <code>ga:dateHour</code> - Combined values of <code>ga:date</code> and <code>ga:hour</code>.</li>
<li>Dim - <code>ga:dayOfWeekName</code> - The name of the day of the week (in English).</li>
<li>Dim - <code>ga:isoWeek</code> - The ISO week number, where each week starts with a Monday. Details: <a href="
http://en.wikipedia.org/wiki/ISO_week_date">http://en.wikipedia.org/wiki/ISO_week_date</a>.</li>
<li>Dim - <code>ga:yearMonth</code> - Combined values of <code>ga:year</code> and <code>ga:month</code>.</li>
<li>Dim - <code>ga:yearWeek</code> - Combined values of <code>ga:year</code> and <code>ga:week</code>.</li>
</ul>
<h3 id="traffic_sources">Traffic Sources</h3>
<ul>
<li>Dim - <code>ga:fullReferrer</code> - The full referring URL including the hostname and path.</li>
<li>Dim - <code>ga:sourceMedium</code> - The combined values of <code>ga:source</code> and <code>ga:medium</code>.</li>
</ul>
Management API - Release 2013-06-05 (June 5, 2013)tag:google.com,changelog:analytics-config-mgmt#release-2013-06-052013-06-05T08:00:00:+0000
<p>This release adds 2 new properties to the <a href="
//developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/
management/webproperties">Webproperty resource</a>:</p>
<ul>
<li><code>profileCount</code> - Returns profile count for a property. This allows you to filter properties that don’t have any profiles (i.e., profileCount = 0).</li>
<li><code>industryVertical</code> - Returns the industry vertical/category selected for a property.</li>
</ul>
<p>Bug Fixes:</p>
<ul>
<li>The <code>eCommerceTracking</code> property of the <a href="
//developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/
management/profiles">Profile resource</a> is now consistent with Ecommerce settings in the admin section of the web interface. Returns <code>true</code> when Ecommerce tracking is enabled, and <code>false</code> if not.</li>
</ul>
Management API - Release 2013-05-08 (May 8, 2013)tag:google.com,changelog:analytics-config-mgmt#release-2013-05-082013-05-08T08:00:00:+0000
<ul>
<li>The <a href="
//developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/
management/webproperties">Webproperty resource</a> now includes a <code>level</code> property to indicate whether the web property is <code>PREMIUM</code> or <code>STANDARD</code>.</li>
</ul>
Android SDK - Release Version 2.0beta5 (April 10, 2013)tag:google.com,changelog:analytics-collection-android#release-2013-04-102013-04-10T08:00:00:+0000
<p>This release contains: * Fifth beta release. * EasyTracker exception parsing bug fix. When <code>ga_reportUncaughtExceptions</code> flag is set, we were not initializing the exception parser, and as a result not parsing the location of an uncaught exception. With this fix, the crash and exception reports will report the location of uncaught exceptions when <code>ga_reportUncaughtExceptions</code> is set to true.</p>
Core Reporting API - Release 2013-04-04 (April 4, 2013)tag:google.com,changelog:analytics-reporting-core#release-2013-04-042013-04-04T08:00:00:+0000
<ul>
<li>This release adds 2 new <a href="
//developers.google.com/analytics/devguides/reporting/core/dimsmets/experiments">experiments metrics</a>: - <code>ga:experimentId</code> - <code>ga:experimentVariant</code></li>
</ul>
Management API - Release 2013-04-04 (April 4, 2013)tag:google.com,changelog:analytics-config-mgmt#release-2013-04-042013-04-04T08:00:00:+0000
<ul>
<li>A new endpoint has been added to the Management API v3 to access and modify <a href="
//developers.google.com/analytics/devguides/config/mgmt/v3/mgmtExperimentsGuide">Experiments</a> resources.</li>
</ul>
Measurement Protocol - Release 2013-03 (March 22, 2013)tag:google.com,changelog:analytics-collection-protocol#release-2013-03-222013-03-22T08:00:00:+0000
<p>Today we launched the new <a href="
//developers.google.com/analytics/devguides/collection/protocol/v1/">Measurement Protocol</a> into Public Beta.</p>
Web Tracking (analytics.js) - Release 2013-03 (March 22, 2013)tag:google.com,changelog:analytics-collection-analyticsjs#release-2013-03-222013-03-22T08:00:00:+0000
<p>Today we launched the new <a href="
//developers.google.com/analytics/devguides/collection/analyticsjs/">analytics.js collection library</a> into Open Beta.</p>
Web Tracking (ga.js) - Release 2013-02 (February 13, 2013)tag:google.com,changelog:analytics-collection-gajs#release-2013-02-132013-02-13T08:00:00:+0000
<p>The following changes have been pushed to the latest version of the tracking code:</p>
<ul>
<li>Added support for specifying local currencies with <code>_set</code>, e.g. <code>gaq.push(['_set', 'currencyCode', 'EUR'])</code></li>
</ul>
Core Reporting API - Release 2013-01-31 (January 31, 2013)tag:google.com,changelog:analytics-reporting-core#release-2013-01-312013-01-31T08:00:00:+0000
<ul>
<li>This release adds 5 new site speed metrics:
<ul>
<li><code>ga:domInteractiveTime</code></li>
<li><code>ga:avgDomInteractiveTime</code></li>
<li><code>ga:domContentLoadedTime</code></li>
<li><code>ga:avgDomContentLoadedTime</code></li>
<li><code>ga:domLatencyMetricsSample</code></li>
</ul>
</li>
</ul>
Core Reporting API - Release 2013-01-14 (January 14, 2013)tag:google.com,changelog:analytics-reporting-core#release-2013-01-142013-01-14T08:00:00:+0000
<ul>
<li>This release adds a new default segment for Tablet Traffic, <code>gaid::-13</code>.</li>
</ul>
Management API - Release 2013-01-14 (January 14, 2013)tag:google.com,changelog:analytics-config-mgmt#release-2013-01-142013-01-14T08:00:00:+0000
<ul>
<li>The <a href='//developers.google.com/analytics/devguides/config/mgmt/v3/mgmtReference/management/profiles'>Profile resource</a> now includes a <code>type</code> property to identify whether a profile is configured for a Web site or App. The two possible values are: <code>WEB</code> or <code>APP</code>.</li>
</ul>
iOS SDK - Release Version 2.0beta4 (January 8, 2013)tag:google.com,changelog:analytics-collection-ios#release-2013-01-082013-01-08T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Change default appVersion to the value in <code>CFBundleShortVersionString</code> instead of <code>CFBundleVersionKey</code>.</li>
<li>Use HTTPS as the default protocol instead of HTTP.</li>
<li>Track methods changed to Send (e.g. <code>trackView</code> now called <code>sendView</code>).</li>
<li>Some minor bug fixes.</li>
</ul>
Android SDK - Release Version 2.0beta4 (January 8, 2013)tag:google.com,changelog:analytics-collection-android#release-2013-02-132013-02-13T08:00:00:+0000
<p>This release contains: * Fourth beta release. * The SDK will now respect the sample rate setting. If you previously set the sample rate to other than 100% you will now see a corresponding decrease in some of your Analytics metrics compared with beta 3. * Changed track methods to send (e.g. <code>trackView</code> now called <code>sendView</code>). * Added local currency support via <code>Transaction.setCurrencyCode</code> * Use HTTPS by default instead of HTTP. * SDK will not attempt to dispatch hits if there is no network connectivity. * Avoid ANRs while attempting to handle install campaign data. * Removed <code>TrackedActivity</code> classes from the SDK. * Move SDK initialization off the main UI Thread. * Improve the SDK’s ability to recover from a corrupted SQLite database. * Several other crashes and bugs fixed.</p>
iOS SDK - Release Version 2.0beta3 iOS6 Update (September 26, 2012)tag:google.com,changelog:analytics-collection-ios#release-2012-09-262012-09-26T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Added armv7s architecture to libGoogleAnalytics.a.</li>
<li>Removed armv6 architecture from libGoogleAnalytics.a.</li>
</ul>
Core Reporting API - Release 2012-09 (September 18, 2012)tag:google.com,changelog:analytics-reporting-core#release-2012-09-182012-09-18T08:00:00:+0000
<p>This release adds new dimensions and metrics to the API. Check the <a href="https://developers.google.com/analytics/devguides/reporting/core/dimsmets">Dimensions and Metrics Reference</a> for definitions.</p>
<h3 id="app_tracking">App Tracking</h3>
<ul>
<li>This data is found in Mobile App tracking SDK reports:
<ul>
<li>Met - <code>ga:uniqueAppviews</code> - The number of app views per session.</li>
<li>Met - <code>'ga:appviews</code> - The total number of app views.</li>
<li>Met - <code>ga:appviewsPerVisit</code> - The average number of app views per session.</li>
</ul>
</li>
</ul>
<h3 id="traffic_sources">Traffic Sources</h3>
<ul>
<li>Dim - <code>ga:socialNetwork</code> - A string representing the social network name. This can be related to the referring social network for traffic sources, or to the social network for social data hub activities. E.g. Google+, Blogger, reddit, etc.</li>
<li>Dim - <code>ga:hasSocialSourceReferral</code> - Indicates visits that arrived to the site from a social source (i.e. A social network such as Google+, Facebook, Twitter, etc.). The possible values are Yes or No, where the first letter must be capitalized.</li>
</ul>
<h3 id="social_activities">Social Activities</h3>
<ul>
<li>This data comes from offsite activity imported from Social Data Hub partners.
<ul>
<li>Dim - <code>ga:socialActivityDisplayName</code> - For a social data hub activity, this string represents the title of the social activity posted by the social network user.</li>
<li>Dim - <code>ga:socialActivityEndorsingUrl</code> - For a social data hub activity, this string represents the URL of the social activity (e.g. the Google+ post URL, the blog comment URL, etc.)</li>
<li>Dim - <code>ga:socialActivityPost</code> - For a social data hub activity, this string represents the content of the social activity posted by the social network user (e.g. The message content of a Google+ post)</li>
<li>Dim - <code>ga:socialActivityTimestamp</code> - For a social data hub activity, this string represents when the social activity occurred on the social network.</li>
<li>Dim - <code>ga:socialActivityUserPhotoUrl</code> - For a social data hub activity, this string represents the URL of the photo associated with the user’s social network profile.</li>
<li>Dim - <code>ga:socialActivityUserProfileUrl</code> - For a social data hub activity, this string represents the URL of the associated user’s social network profile.</li>
<li>Dim - <code>ga:socialActivityContentUrl</code> - For a social data hub activity, this string represents the URL shared by the associated social network user.</li>
<li>Dim - <code>ga:socialActivityTagsSummary</code> - For a social data hub activity, this is a comma-separated set of tags associated with the social activity.</li>
<li>Dim - <code>ga:socialActivityUserHandle</code> - For a social data hub activity, this string represents the social network handle (i.e. name) of the user who initiated the social activity.</li>
<li>Dim - <code>ga:socialActivityAction</code> - For a social data hub activity, this string represents the type of social action associated with the activity (e.g. vote, comment, +1, etc.).</li>
<li>Dim - <code>ga:socialActivityNetworkAction</code> - For a social data hub activity, this string represents the type of social action and the social network where the activity originated.</li>
<li>Met - <code>ga:socialActivities</code> - The count of activities where a content URL was shared/mentioned on a social data hub partner network.</li>
</ul>
</li>
</ul>
<h3 id="social_interactions">Social Interactions</h3>
<ul>
<li>This data comes from onsite social interaction tracking.
<ul>
<li>Dim - <code>ga:socialInteractionAction</code> - For social interactions, a string representing the social action being tracked (e.g. +1, like, bookmark)</li>
<li>Dim - <code>ga:socialInteractionNetwork</code> - For social interactions, a string representing the social network being tracked (e.g. Google, Facebook, Twitter, LinkedIn)</li>
<li>Dim - <code>ga:socialInteractionNetworkAction</code> - For social interactions, a string representing the concatenation of the <code>ga:socialInteractionNetwork</code> and <code>ga:socialInteractionAction</code> being tracked (e.g. Google: +1, Facebook: like)</li>
<li>Dim - <code>ga:socialInteractionTarget</code> - For social interactions, a string representing the URL (or resource) which receives the social network action.</li>
<li>Met - <code>ga:socialInteractions</code> - The total number of social interactions on your site.</li>
<li>Met - <code>ga:uniqueSocialInteractions</code> - The total number of unique social interactions on your site. Based on the the value pair <code>ga:socialInteractionNetwork</code> and <code>ga:socialInteractionAction</code></li>
<li>Met - <code>ga:socialInteractionsPerVisit</code> - <code>ga:socialInteractions</code> / <code>ga:uniqueSocialInteractions</code>. The average number of social interactions per visit to your site.</li>
</ul>
</li>
</ul>
<h3 id="geo__network">Geo / Network</h3>
<ul>
<li>Dim - <code>ga:metro</code> - The Designated Market Area (DMA) from where traffic originated.</li>
</ul>
<h3 id="page_tracking">Page Tracking</h3>
<ul>
<li>Dim - <code>ga:pagePathLevel1</code> - This dimension rolls up all the pagePaths in the first hierarchical level in pagePath.</li>
<li>Dim - <code>ga:pagePathLevel2</code> - This dimension rolls up all the pagePaths in the second hierarchical level in pagePath.</li>
<li>Dim - <code>ga:pagePathLevel3</code> - This dimension rolls up all the pagePaths in the third hierarchical level in pagePath.</li>
<li>Dim - <code>ga:pagePathLevel4</code> - This dimension rolls up all the pagePaths in the fourth hierarchical level in pagePath. All the additional levels in the pagePath hierarchy are also rolled up in this dimension.</li>
</ul>
<h3 id="exception_tracking">Exception Tracking</h3>
<ul>
<li>
<p>This data come from exception tracking data.</p>
<ul>
<li>Met - <code>ga:exceptions</code> - The number of exceptions that were sent to Google Analytics.</li>
<li>Met - <code>ga:fatalExceptions</code> - The number of exceptions where isFatal is set to true.</li>
</ul>
</li>
</ul>
<h3 id="user_timings">User Timings</h3>
<ul>
<li>
<p>This data comes from user timing data.</p>
<ul>
<li>Dim - <code>ga:userTimingCategory</code> - A string for categorizing all user timing variables into logical groups for easier reporting purposes.</li>
<li>Dim - <code>ga:userTimingLabel</code> - A string to indicate the name of the action of the resource being tracked.</li>
<li>Dim - <code>ga:userTimingVariable</code> - A string that can be used to add flexibility in visualizing user timings in the reports.</li>
<li>Dim - <code>ga:userTimingValue</code> The number of milliseconds in elapsed time sent to Google Analytics.</li>
<li>Met - <code>ga:userTimingSample</code> - The number of samples that were sent.</li>
<li>Met - <code>ga:avgUserTimingValue</code> - The average user timing value. <code>ga:userTimiingValue</code> / <code>ga:userTimiingSample</code>.</li>
</ul>
</li>
</ul>
<h3 id="device__platform">Device / Platform</h3>
<ul>
<li>This data comes from the user agent of the collected data.
<ul>
<li>Dim - <code>ga:mobileDeviceBranding</code> - Mobile manufacturer or branded name (examples: Samsung, HTC, Verizon, T-Mobile).</li>
<li>Dim - <code>ga:mobileDeviceModel</code> - Mobile device model (example: Nexus S)</li>
<li>Dim - <code>ga:mobileInputSelector</code> - Selector used on the mobile device (examples: touchscreen, joystick, click-wheel, stylus)</li>
<li><code>Dim - ga:mobileDeviceInfo</code> - The branding, model, and marketing name used to identify the mobile device.</li>
</ul>
</li>
</ul>
iOS SDK - Release Version 1.5.1 (September 18, 2012)tag:google.com,changelog:analytics-collection-ios#release-2012-09-182012-09-18T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>
<p>Bug Fixes:</p>
<ul>
<li>Remove NoThumb version of library.</li>
<li>Drop support for armv6.</li>
</ul>
</li>
<li>
<p>New Features:</p>
<ul>
<li>Add support for armv7s (for iPhone5).</li>
</ul>
</li>
</ul>
Android SDK - Release Version 1.5.1 (September 18, 2012)tag:google.com,changelog:analytics-collection-android#release-2012-09-182012-09-18T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Bug Fixes:
<ul>
<li>Fix migration from pre-1.5 SDK CVs to 1.5 SDK custom variables.</li>
<li>Honor user’s background data restrictions setting.</li>
</ul>
</li>
</ul>
iOS SDK - Release Version 1.5 (September 17, 2012)tag:google.com,changelog:analytics-collection-ios#release-2012-09-172012-09-17T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Bug Fixes:
<ul>
<li>GANTrackerDelegate protocol methods are now optional.</li>
<li>Events now include the last tracked page view (utmp).</li>
</ul>
</li>
<li>New Features:
<ul>
<li>Support for up to 50 custom variables (Note: this feature is available for Google Analytics Premium users only).</li>
<li>Updated BasicExample example app.</li>
</ul>
</li>
</ul>
Android SDK - Release Version 1.5 (September 17, 2012)tag:google.com,changelog:analytics-collection-android#release-2012-09-172012-09-17T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>
<p>Bug Fixes:</p>
<ul>
<li>Fix memory leak.</li>
<li>Events now include the last tracked page view (<code>utmp</code>).</li>
</ul>
</li>
<li>
<p>New Features:</p>
<ul>
<li>Support 50 custom variables (Note: this feature is available to Google Analytics Premium users only).</li>
</ul>
</li>
</ul>
iOS SDK - Release Version 2.0beta3 (August 21, 2012)tag:google.com,changelog:analytics-collection-ios#release-2012-08-212012-08-21T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Added social tracking method to <code>GAITracker</code>:
<ul>
<li><code>trackSocial:withAction:withTarget:</code></li>
</ul>
</li>
<li>Timing method signature changed to:
<ul>
<li><code>trackTiming:withValue:withName:withLabel:</code></li>
</ul>
</li>
<li>Manual construction and dispatch methods added to GAITracker:
<ul>
<li><code>set:value:</code></li>
<li><code>get:</code></li>
<li><code>send:params:</code></li>
</ul>
</li>
<li>Custom dimension setter methods added to GAITracker:
<ul>
<li><code>setCustom:dimension:</code></li>
<li><code>setCustom:metric:</code></li>
</ul>
</li>
<li>Architecture of data store refactored to prevent reported <code>CoreData</code> issues.</li>
</ul>
Android SDK - Release Version 2.0beta3 (August 21, 2012)tag:google.com,changelog:analytics-collection-android#release-2012-08-212012-08-21T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Added support for custom dimensions and metrics.</li>
<li>Added support for social interaction tracking.</li>
<li>Made <code>StandardExceptionParser</code> class public</li>
<li>Fixed occasional crashes during initialization of the SDK.</li>
<li>Fixed <code>INSTALL_REFERRER</code> broadcasts being ignored on some devices.</li>
<li>Fixed <code>ConcurrentModificationExceptions</code> in <code>GoogleTracker</code> class.</li>
<li>Other bugfixes and enhancements</li>
</ul>
Multi-Channel Funnels Reporting API - Release 2012-08 (August 1, 2012)tag:google.com,changelog:analytics-reporting-mcf#release-2012-08-012012-08-01T08:00:00:+0000
<p>This is the initial release of the Multi-Channel Funnels Reporting API:</p>
<ul>
<li>This new API enables you to request Multi-Channel Funnels data for an authenticated user. Data is derived from conversion path data, which shows user interactions with various traffic sources over multiple visits prior to converting. This allows you to analyze how multiple marketing channels influence conversions over time. For more details on what data is available and how to use the API see <a href="https://developers.google.com/analytics/devguides/reporting/mcf/v3/">Multi-Channel Funnels Reporting API</a>.</li>
</ul>
iOS SDK - Release Version 2.0beta2 (June 27, 2012)tag:google.com,changelog:analytics-collection-ios#release-2012-06-272012-06-27T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Updated to latest wire format.</li>
<li><code>sampleRate</code> changed to double-precision float.</li>
<li>Excessive tracking is throttled.</li>
<li>Undispatched tracking information is deleted when opt-out is enabled.</li>
<li>Undispatched tracking information older than 30 days will be deleted.</li>
<li>Enhancements to hit dispatcher.</li>
<li>Rather than periodically retry, the dispatcher will use the Reachability API when connectivity is lost to get notified when connectivity is reestablished.</li>
<li>Updated example app.</li>
<li>Other bugfixes and enhancements.</li>
</ul>
Android SDK - Release Version 2.0beta2 (June 21, 2012)tag:google.com,changelog:analytics-collection-android#release-2012-06-212012-06-21T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Simplified EasyTracker interface.</li>
<li>Control of dispatching moved to a new class, <code>GAServiceManager</code>.</li>
<li>Updated to latest wire format.</li>
<li><code>sampleRate</code> changed to double.</li>
<li>Excessive tracking is throttled.</li>
<li>Undispatched tracking information is deleted when opt-out is enabled.</li>
<li>Undispatched tracking information older than 30 days will be deleted.</li>
<li>Other bugfixes and enhancements.</li>
</ul>
Core Reporting API - Release 2012-05 (May 31, 2012)tag:google.com,changelog:analytics-reporting-core#release-2012-05-312012-05-31T08:00:00:+0000
<h4 id="bug_fixes">Bug Fixes</h4>
<ul>
<li>The API now correctly handles UTF-8 characters in a filter or dynamic segment.</li>
</ul>
iOS SDK - Release Version 2.0beta1 (May 25, 2012)tag:google.com,changelog:analytics-collection-ios#release-2012-05-252012-05-25T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Added uncaught exception handling facility.</li>
<li>Removed <code>dispatchEnabled</code> property from <code>GAI</code>.</li>
<li>Added <code>defaultTracker</code> property to <code>GAI</code>.</li>
<li>Added <code>close</code> method to <code>GAITracker</code>.</li>
<li>Added timing tracking method to <code>GAITracker</code>.</li>
<li>Added <code>trackView</code> method to <code>GAITracker</code> which takes no argument.</li>
<li>Transaction item field names updated.</li>
<li>Updated to latest wire format.</li>
<li>Event value is interpreted as a 64-bit integer.</li>
<li>ARMV6 code generation switched from THUMB to ARM.</li>
</ul>
Android SDK - Release Version 2.0beta1 (May 25, 2012)tag:google.com,changelog:analytics-collection-android#release-2012-05-252012-05-25T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li><code>startSession</code> method has been removed. Use <code>setStartSession</code> instead.</li>
<li>Added <code>ga_sessionTimeout</code> parameter to EasyTracker.</li>
<li>Implemented power save mode.</li>
<li>Added <code>trackView</code> method to <code>GAITracker</code> which takes no argument.</li>
<li>Fixed a bug that prevented exception parameters from being sent on hits.</li>
<li>Hits that can’t be read from the database are discarded instead of permanently blocking all hits from being dispatched.</li>
<li>Updated to latest wire format.</li>
<li>Implemented timing hit type.</li>
<li>Implemented Ecommerce hit types (transaction and item).</li>
</ul>
Core Reporting API - Release 2012-05 (May 24, 2012)tag:google.com,changelog:analytics-reporting-core#release-2012-05-242012-05-24T08:00:00:+0000
<p>This release enables Google Analytics premium accounts to access up to 50 custom variables.</p>
Web Tracking (ga.js) - Release 2012-02 (February 24, 2012)tag:google.com,changelog:analytics-collection-gajs#release-2012-02-242012-02-24T08:00:00:+0000
<p>The following changes have been pushed to the latest version of the tracking code:</p>
<ul>
<li>The maximum allowed site speed sample rate (<code>_setSiteSpeedSampleRate</code>) has been increased from 10% to 100%.</li>
<li>The <code>_setAccount</code> method now trims any leading and trailing spaces.</li>
</ul>
Core Reporting API - Release 2012-02 (February 14, 2012)tag:google.com,changelog:analytics-reporting-core#release-2012-02-142012-02-14T08:00:00:+0000
<p>This release fixes 2 bugs:</p>
<h4 id="bug_fixes">Bug Fixes</h4>
<ul>
<li>
<p>Query filters that contain special characters inside regular expressions no longer return server errors.</p>
</li>
<li>
<p>Combining a metric filter with an advanced segment no longer returns an error.</p>
</li>
</ul>
Core Reporting API - Release 2012-02 (February 8, 2012)tag:google.com,changelog:analytics-reporting-core#release-2012-02-082012-02-08T08:00:00:+0000
<p>This release add new site speed metrics to the API.</p>
<h4 id="new_metrics">New Metrics</h4>
<ul>
<li>The following site speed metrics have been added:
<ul>
<li><code>ga:speedMetricsSample</code></li>
<li><code>ga:domainLookupTime</code></li>
<li><code>ga:pageDownloadTime</code></li>
<li><code>ga:redirectionTime</code></li>
<li><code>ga:serverConnectionTime</code></li>
<li><code>ga:serverResponseTime</code></li>
<li><code>ga:avgDomainLookupTime</code></li>
<li><code>ga:avgPageDownloadTime</code></li>
<li><code>ga:avgRedirectionTime</code></li>
<li><code>ga:avgServerConnectionTime</code></li>
<li><code>ga:avgServerResponseTime</code></li>
</ul>
</li>
</ul>
<p>Check the <a href="http://code.google.com/apis/analytics/docs/gdata/dimsmets/sitespeed.html">Dimensions and Metrics Reference</a> for definitions.</p>
<h4 id="api_version_23_deprecation_reminder">API Version 2.3 Deprecation Reminder</h4>
<ul>
<li>
<p>Version 2.3 of the Data Export API has been depreacted for 2 months. In roughly 4 more months we will shut down this service and only support the new Core Reporting API <a href="http://code.google.com/apis/analytics/docs/gdata/v3/gdataGettingStarted.html">version 3.0</a> and <a href="http://code.google.com/apis/analytics/docs/gdata/v2/gdataOverview.html">version 2.4</a>.</p>
</li>
<li>
<p>We highly recommend you migrate your applications to version 3.0.</p>
</li>
<li>
<p>In 4 months requests to the legacy version 2.3 XML data feed will be forwarded to version 2.4 and return a version 2.4 XML response. At that point, all version 2.4 quota policies will apply to the version 2.3 requests.</p>
</li>
<li>
<p>All requests for version 2.3 JSON or the Google Data JavaScript client library that uses version 2.3 JSON output, will return <code>404</code> status codes.</p>
</li>
<li>
<p>To get full quota, both version 3.0 and version 2.4 require you to register your application in the <a href="https://code.google.com/apis/console">Google APIs Console</a> and use an API key (or OAuth 2.0 token) in each request.</p>
</li>
</ul>
Web Tracking (ga.js) - Release 2012-02 (February 1, 2012)tag:google.com,changelog:analytics-collection-gajs#release-2012-02-012012-02-01T08:00:00:+0000
<p>The following changes have been pushed to the latest version of the tracking code:</p>
<ul>
<li>Updated the list of organic search engines detected by default. Added ‘startsiden.no’, ‘rakuten.co.jp’, ‘biglobe.ne.jp’, and ‘goo.ne.jp’. Removed ‘search’ and added ‘conduit.com’, ‘babylon.com’, ‘search-results.com’, ‘avg.com’, ‘comcast.net’, and ‘incredimail.com’ all of which were previously attributed together as ‘search’.</li>
</ul>
Core Reporting API - Release 2012-01 (January 26, 2012)tag:google.com,changelog:analytics-reporting-core#release-2012-01-262012-01-26T08:00:00:+0000
<p>We fixed a small bug with <code>ga:visitLength</code>. This dimension now returns correct data.</p>
Management API - Release 2012-01 (January 26, 2012)tag:google.com,changelog:analytics-config-mgmt#release-2012-01-262012-01-26T08:00:00:+0000
<p>This release adds helpful error responses to the Management API.</p>
<ul>
<li>New error codes, reasons, and descriptions have been added to the body of API error responses. All the codes have been documented for both the versions - <a href='http://code.google.com/apis/analytics/docs/mgmt/v2/mgmtFeedReference.html#errorCodes'>Version 2.4</a> and <a href='http://code.google.com/apis/analytics/docs/mgmt/v3/mgmtReference.html#errors'>Version 3.0</a> - of the Management API.</li>
</ul>
Web Tracking (ga.js) - Release 2012-01 (January 26, 2012)tag:google.com,changelog:analytics-collection-gajs#release-2012-01-262012-01-26T08:00:00:+0000
<p>The following changes have been pushed to the latest version of the tracking code:</p>
<ul>
<li>The limit on custom variable length has been increased from 64 to 128 characters. Additionally, the length is now checked before URL encoding.</li>
<li>The rate limit for event hits has been relaxed. You can now send 10 hits with 1 additional hit per second (previously this was limited to 1 hit every 5 seconds). Note that the 500 hits per session limit still applies.</li>
<li><code>__utmv</code> cookies are now written with a different variable separator (caret instead of comma) to be compatible with RFCs. This should fix some of the issues related to cookie encoding issues seen by customers.</li>
</ul>
Core Reporting API - Release 2011-12 (December 5, 2011)tag:google.com,changelog:analytics-reporting-core#release-2011-12-052011-12-05T08:00:00:+0000
<p>This release effects all Google Analytics API developers. It announces two new versions of the API, requires applications to register, introduces a new quota policy, and it changes the API name to the Core Reporting API. Finally it deprecates the existing Data Export API version 2.3.</p>
<h4 id="version_30">Version 3.0</h4>
<ul>
<li>
<p>The Core Reporting API version 3.0 is the latest major version of our API and is not backwards compatible. All future development of the API will be done on this version.</p>
</li>
<li>
<p>New Features</p>
<ul>
<li>New JSON based output reduces the size of the response ~10x from the previous XML output.</li>
<li>New <a href='
http://code.google.com/apis/analytics/docs/gdata/v3/gdataLibraries.html'>
Google API client libraries</a> that support Java, JavaScript, Python, PHP, Ruby, and .Net.</li>
<li>Support for the <a href='http://code.google.com/apis/discovery/'>
Google Discovery API</a>.</li>
<li>Support for <a href='http://code.google.com/apis/accounts/docs/OAuth2.html'>OAuth 2.0</a> as the new, recommended way to authorize users.</li>
</ul>
</li>
<li>
<p>Updates</p>
<ul>
<li>New URL to make requests: <code>https://www.googleapis.com/analytics/v3/data/ga…</code>.</li>
<li>Registration and developers tokens required.</li>
<li>All requests for configuration data should be done through the <a href='http://code.google.com/apis/analytics/docs/mgmt/home.html'>
Management API</a>.</li>
</ul>
</li>
</ul>
<h4 id="version_24">Version 2.4</h4>
<ul>
<li>
<p>The Core Reporting API version 2.4 is a minor version upgrade that is mostly backwards compatible with the existing Data Export API version 2.3.</p>
</li>
<li>
<p>Updates</p>
<ul>
<li>New URL to make requests: <code>https://www.googleapis.com/analytics/v2.4/data…</code></li>
<li>Registration and developers tokens required.</li>
<li>XML output consistent with version 2.3, so the other existing Google Data client libraries will continue to work.</li>
<li>Error code for quota errors have changed from <code>503</code> to <code>403</code></li>
<li>JSON responses are not supported.</li>
<li>Google Data JavaScript client library not supported.</li>
<li>No Account Feed. All requests for configuration data should be done through the <a href='http://code.google.com/apis/analytics/docs/mgmt/home.html'>
Management API</a>.</li>
</ul>
</li>
</ul>
<h4 id="registration">Registration</h4>
<ul>
<li>
<p>All applications built using the Google Analytics API must be registered as a project through the <a href='https://code.google.com/apis/console'>
Google APIs Console</a>.</p>
</li>
<li>
<p>Each request to the API must include either a API key or for OAuth 2.0, a Client Id and Client Secret.</p>
</li>
</ul>
<h4 id="quota_policy">Quota Policy</h4>
<ul>
<li>
<p>The following quota applies to both Anlaytics APIs (Management API and Data Export API)</p>
<ul>
<li>50,000 requests per <strong>project</strong> per day</li>
<li>10 queries per second (QPS) per <strong>IP address</strong></li>
</ul>
</li>
<li>
<p>The following quota applies to the Data Export API</p>
<ul>
<li>10,000 requests per <strong>profile</strong> per day</li>
<li>10 concurrent requests per <strong>profile</strong></li>
</ul>
</li>
<li>
<p>For unregistered applications, we provide a very low grace quota to accommodate a small amount of testing.</p>
</li>
</ul>
<h4 id="deprecations">Deprecations</h4>
<ul>
<li>
<p>This release also announces the deprecation of Version 2.3 and the upcoming shut down of the Account Feed in the Data Export API. In 6 months:</p>
<ul>
<li>
<p>Requests to the version 2.3 XML data feed will be forwarded to version 2.4 and return a version 2.4 response. At that point, all version 2.4 quota policies will apply to the version 2.3 requests.</p>
</li>
<li>
<p>Requests to the version 2.3 JSON output will not be supported by the version 2.4 response and will return <code>404 Not Found</code> status codes. If you need a JSON response, upgrade to Version 3.0.</p>
</li>
<li>
<p>Requests to the Account Feed in the Data Export API will return <code>404 Not Found</code> status codes. All requests for configuration data should be done through the <a href='http://code.google.com/apis/analytics/docs/mgmt/home.html'>
Management API</a>.</p>
</li>
</ul>
</li>
</ul>
Management API - Release 2011-12 (December 5, 2011)tag:google.com,changelog:analytics-config-mgmt#release-2011-12-052011-12-05T08:00:00:+0000
<p>This release adds data, changes existing functionality and fixes a bug.</p>
<h4 id="new_data">New Data</h4>
<ul>
<li>The Advanced Segment collection now contains a <code>segmentId</code> field that can be used in the Data Export API <a href='http://code.google.com/apis/analytics/docs/gdata/v3/reference.html#segment'>
segment</a> parameter.</li>
</ul>
<h4 id="changes">Changes</h4>
<ul>
<li>
<p>The data type for <code>max-results</code> has been changed to <code>integer</code>.</p>
</li>
<li>
<p>The default and maximum value for <code>max-results</code> has been changed to 1000.</p>
</li>
</ul>
<h4 id="bug_fixes">Bug Fixes</h4>
<ul>
<li>Accounts, web properties, and profiles for Google Website Optimizer experiments are no longer included in their corresponding collections.</li>
</ul>
Android SDK - Release Version 1.4.2 (November 28, 2011)tag:google.com,changelog:analytics-collection-android#release-2011-11-282011-11-28T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>
<p>Documentation:</p>
<ul>
<li>The ReadMe.txt has been updated to point to the website for documentation.</li>
</ul>
</li>
</ul>
Android SDK - Release Version 1.4.1 (November 22, 2011)tag:google.com,changelog:analytics-collection-android#release-2011-11-222011-11-22T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Bug Fixes:
<ul>
<li>Fixed handling of Destination URL Autotracking from Google Play.</li>
<li>Allow the referrer parameter to <code>setReferrer</code> to be url-encoded.</li>
</ul>
</li>
</ul>
Web Tracking (ga.js) - Release 2011-11 (November 16, 2011)tag:google.com,changelog:analytics-collection-gajs#release-2011-11-162011-11-16T08:00:00:+0000
<p>Changes to Site Speed data collection:</p>
<ul>
<li>Site speed data is now automatically collected for all web properties at a 1% sample rate. The <code>_trackPageLoadTime</code> function, previously required to opt-in to site speed data collection, is now deprecated.</li>
<li>The default sample rate may be adjusted using the new <code>_setSiteSpeedSampleRate</code> function.</li>
<li>If a virtual path is used in the <code>_trackPageview</code> call, that path will now also be associated with any site speed data collected from that page.</li>
</ul>
iOS SDK - Release Version 1.4 (November 15, 2011)tag:google.com,changelog:analytics-collection-ios#release-2011-11-152011-11-15T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Bug Fixes:
<ul>
<li>Changed location of the database to from the Documents directory to the Library directory.</li>
<li>The SDK no longer throws <code>NSAsserts</code> for SQLite database errors.</li>
<li>Fixed crash when calling <code>trackPageview</code> with an empty string.</li>
<li>Fixed crashes when calling various <code>GANTracker</code> methods after <code>stopTracker</code> was called.</li>
<li>Fixed several memory leaks, including one calling trackPageview with a pageURL that begins with ‘/’.</li>
</ul>
</li>
<li>New Features:
<ul>
<li>Added <code>dispatchSynchronously</code> method.</li>
<li>Exposed several useful constants (see GANTracker.h).</li>
</ul>
</li>
</ul>
Android SDK - Release Version 1.4 (November 15, 2011)tag:google.com,changelog:analytics-collection-android#release-2011-11-152011-11-15T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Bug Fixes:
<ul>
<li>Trapped and handled several <code>SQLiteExceptions</code>.</li>
<li>Fixed <code>NullPointerException</code> in <code>stopSession</code> if called prior to calling <code>startNewSession</code>.</li>
<li>Fixed Out Of Memory errors on HTC Thunderbolt and Motorola Droid Bionic devices.</li>
<li>Eliminated unnecessary database access in the dispatch method.</li>
</ul>
</li>
</ul>
Web Tracking (ga.js) - Release 2011-10 (October 17, 2011)tag:google.com,changelog:analytics-collection-gajs#release-2011-10-172011-10-17T08:00:00:+0000
<p>This release contains the following new feature:</p>
<ul>
<li>Events can be marked as non-interaction by setting the new <code>opt_noninteraction</code> parameter of the <code>_trackEvent()</code> method to <code>true</code>. Marking an event as non-interaction indicates that hits from the tagged event will not impact bounce rate. For more information, see the <a href='http://code.google.com/apis/analytics/docs/gaJS/gaJSApiEventTracking.html'>ga.js reference</a>.</li>
</ul>
<p>This release contains the following bug fix:</p>
<ul>
<li>Fixed an issue where propagating the AdWords <code>gclid</code> URL parameter on internal site links could result in inflated paid visit counts.</li>
</ul>
Core Reporting API - Release 2011-09 (September 7, 2011)tag:google.com,changelog:analytics-reporting-core#release-2011-09-072011-09-07T08:00:00:+0000
<p>This release adds fresher AdWords data and more combinations for AdWords dimensions and metrics.</p>
<ul>
<li>
<p>AdWords data is now updated within an hour. Before the data was updated daily.</p>
</li>
<li>
<p>We’ve relaxed a number valid combinations restrictions with AdWords data.</p>
</li>
</ul>
<p>A few weeks ago we made a change to disallow API queries that asked for <code>ga:adGroup</code> or <code>ga:adContent</code> with <code>ga:impressions</code>, since this combination returned 0. With this change, this combination is now back and has been fixed to return correct data.</p>
iOS SDK - Release Version 1.3 (September 6, 2011)tag:google.com,changelog:analytics-collection-ios#release-2011-09-062011-09-06T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Bug Fixes:
<ul>
<li>Fixed bus error when attempting to set <code>dryRun</code> flag prior to starting the tracker.</li>
<li>Fixed bus error when attempting to pass <code>NULL</code> for error.</li>
<li>Use correct language in HTTP header.</li>
</ul>
</li>
<li>New Features:
<ul>
<li>Added <code>anonymizeIp</code> flag.</li>
<li>Added <code>sampleRate</code> parameter.</li>
<li>Added support for campaign referrals.</li>
</ul>
</li>
</ul>
Android SDK - Release Version 1.3.1 (September 6, 2011)tag:google.com,changelog:analytics-collection-android#release-2011-09-062011-09-06T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Bug Fixes:
<ul>
<li>Fixed bug in general campaign referral tracking.</li>
<li>Fixed <code>anonymizeIp</code> flag interfering with campaign tracking.</li>
</ul>
</li>
</ul>
Management API - Release 2011-08 (August 29, 2011)tag:google.com,changelog:analytics-config-mgmt#release-2011-08-292011-08-29T08:00:00:+0000
<p>This release adds two new versions of the API with many new features, and it deprecates the old version. The changes impact the way you request and handle data from the API.</p>
<h4 id="version_30">Version 3.0</h4>
<ul>
<li>
<p>This is the latest major version of our API and is not backwards compatible. All future development of the API will be done on this version.</p>
</li>
<li>
<p>New data</p>
<ul>
<li>Full representation of event goals</li>
<li>An internal web property ID that can be used to deep link into the GA user interface</li>
<li>Profile configurations for the default page and site search query parameters</li>
</ul>
</li>
<li>
<p>Changes</p>
<ul>
<li>A new <a href='http://code.google.com/apis/analytics/docs/mgmt/v3/mgmtGettingStarted.html#quota'>quota policy</a></li>
<li>Integration with the <a href='https://code.google.com/apis/console'>Google APIs Console</a> to manage API access and request more quota</li>
<li>Support for <a href='http://code.google.com/apis/accounts/docs/OAuth2.html'>OAuth 2.0</a> as the new, recommended way to authorize users</li>
<li>New URL to make requests: <code>https://www.googleapis.com/analytics/v3/management/…</code></li>
<li>More compact API response using JSON</li>
<li>New <a href='http://code.google.com/apis/analytics/docs/mgmt/v3/mgmtLibraries.html'>Google API client libraries</a> that support many more languages</li>
<li>Support for the <a href='http://code.google.com/apis/discovery/'>Google Discovery API</a></li>
</ul>
</li>
</ul>
<h4 id="version_24">Version 2.4</h4>
<ul>
<li>
<p>This is a minor version upgrade that is mostly backwards compatible with the existing Version 2.3.</p>
</li>
<li>
<p>Changes</p>
<ul>
<li>A new <a href='http://code.google.com/apis/analytics/docs/mgmt/v3/mgmtGettingStarted.html#quota'>quota policy</a></li>
<li>Integration with the <a href='https://code.google.com/apis/console'>Google APIs Console</a> to manage API access and request more quota</li>
<li>Continued support for existing authorization mechanisms and <a href='http://code.google.com/apis/accounts/docs/OAuth2.html'>OAuth 2.0</a></li>
<li>New URL to make requests: <code>https://www.googleapis.com/analytics/v2.4/management/…</code></li>
<li>Responses in XML only</li>
<li>No support for the Google Data JavaScript client library</li>
<li>XML output consistent with version 2.3, so the other existing Google Data client libraries will continue to work.</li>
</ul>
</li>
</ul>
<h4 id="deprecation">Deprecation</h4>
<ul>
<li>We are announcing the deprecation of the legacy version 2.3 of the Management API. It will continue to work for two months, after which all v2.3 requests will return a v2.4 response.</li>
</ul>
Web Tracking (ga.js) - Release 2011-08 (August 16, 2011)tag:google.com,changelog:analytics-collection-gajs#release-2011-08-162011-08-16T08:00:00:+0000
<p>This release fixes a bug which caused inflated numbers of visits and/or a decrease in the number of new visitors for some sites. The first effect primarily affected sites with organic traffic coupled with specific user behavior. The second effect was only on sites using an unsupported tracking configuration with multiple trackers.</p>
Core Reporting API - Release 2011-08 (August 11, 2011)tag:google.com,changelog:analytics-reporting-core#release-2011-08-112011-08-11T08:00:00:+0000
<p>This release fixes some invalid combinations of dimensions and metrics</p>
<h4 id="fixed_invalid_metricsdimensions_combinations">Fixed invalid metrics/dimensions combinations</h4>
<ul>
<li>
<p>Last month we announced some upcoming changes to the API to disallow some invalid queries in the data feed that do not return any data. We have now made those changes to the API, and the following combinations are now invalid:</p>
<ul>
<li>Product dimensions cannot be combined with transaction metrics.</li>
<li><code>ga:adContent</code> or <code>ga:adGroup</code> cannot be combined with <code>ga:impressions</code>.</li>
</ul>
<p>Instead of returning a response with 0 results, the API now returns 400 error code for all queries that ask for these combinations.</p>
</li>
</ul>
Web Tracking (ga.js) - Release 2011-08 (August 11, 2011)tag:google.com,changelog:analytics-collection-gajs#release-2011-08-112011-08-11T08:00:00:+0000
<p>Changes to session calculations:</p>
<ul>
<li>One campaign per session: If a new campaign is started during an existing session, the tracking script will now automatically start a new session. A new campaign will be triggered by a change to any of the following fields: campaign id, name, source, medium, term, content, or gclid.</li>
<li>The tracking script no longer starts a new session in the event that a user closes the browser.</li>
</ul>
<p>Changes to cross-domain tracking:</p>
<ul>
<li>The call to <code>_setAllowHash(false)</code> is no longer required when configuring cross-domain tracking. Pages that already include a call to <code>_setAllowHash(false)</code> will continue to work, but it is no longer required when setting up a new site.</li>
<li>The tracking script will now attempt to repair linker parameters that have been mangled by HTTP redirectors and browsers. Approximately 85% of linker values that are currently discarded due to encoding changes introduced by redirectors and browsers should now be successfully restored and accepted by the tracking script.</li>
</ul>
Android SDK - Release Version 1.3 (August 10, 2011)tag:google.com,changelog:analytics-collection-android#release-2011-08-102011-08-10T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Bug Fixes:
<ul>
<li>Fixed several issues in database handling.</li>
<li>Fixed exceptions while using custom variables.</li>
<li>Hold the application context instead of the context passed into it.</li>
<li>Removed the ability to accidently create phantom sessions.</li>
</ul>
</li>
<li>New Features:
<ul>
<li>Added the ability to set campaign referrals at any time</li>
<li>Added <code>sampleRate</code> flag</li>
<li>Added <code>anonymizeIp</code> flag</li>
</ul>
</li>
</ul>
Web Tracking (ga.js) - Release 2011-07 (July 26, 2011)tag:google.com,changelog:analytics-collection-gajs#release-2011-07-262011-07-26T08:00:00:+0000
<p>This release contains one new feature:</p>
<ul>
<li>The tracking code now postpones hits for prerendered pages until those pages are viewed by the user. If a prerendered page is never viewed, no hits are sent. This feature is only available to sites using the async tracking script. You can learn more about prerendering in <a href='http://googlewebmastercentral.blogspot.com/2011/06/announcing-instant-pages.html'>Google Webmaster Central Blog</a>.</li>
</ul>
Web Tracking (ga.js) - Release 2011-07 (July 14, 2011)tag:google.com,changelog:analytics-collection-gajs#release-2011-07-142011-07-14T08:00:00:+0000
<p>This release contains a variety of bug fixes and refactorings, and one new feature:</p>
<ul>
<li>Added social tracking support ( <a href='http://code.google.com/apis/analytics/docs/gaJS/gaJSApiSocialTracking.html'>_trackSocial</a> )</li>
</ul>
Core Reporting API - Release 2011-07 (July 11, 2011)tag:google.com,changelog:analytics-reporting-core#release-2011-07-112011-07-11T08:00:00:+0000
<p>This release deprecates the confidence interval value in metrics.</p>
<h4 id="deprecation_of_confidence_interval">Deprecation of Confidence Interval</h4>
<ul>
<li>
<p>If you haven’t already done so, please stop using confidence interval values for metrics. With this release, the Data Export API Data Feed returns 0.0 for all the confidence interval values. In a month or so, we will we will completely remove this attribute from all metric elements.</p>
<p>To determine if a response has been sampled, please use the containsSampledData field in the response.</p>
</li>
</ul>
iOS SDK - Release Version 1.2 (June 27, 2011)tag:google.com,changelog:analytics-collection-ios#release-2011-06-272011-06-27T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>Bug Fixes:
<ul>
<li>Fixed crash when using custom variables.</li>
<li>Fixed memory leaks when using custom variables.</li>
</ul>
</li>
<li>New Features:
<ul>
<li>Added support for Ecommerce hits.</li>
<li>Added <code>Debug</code> flag.</li>
<li>Added <code>DryRun</code> flag.</li>
<li>More descriptive error information on <code>SQLite3</code> failures</li>
</ul>
</li>
</ul>
Android SDK - Release Version 1.2 (June 27, 2011)tag:google.com,changelog:analytics-collection-android#release-2011-06-272011-06-27T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>
<p>Bug Fixes:</p>
<ul>
<li>Fixed badly formatted <code>userAgent</code> String.</li>
</ul>
</li>
<li>
<p>New Features:</p>
<ul>
<li>Added support for Ecommerce tracking</li>
<li>Added <code>debug</code> flag</li>
<li>Added <code>dryRun</code> flag</li>
</ul>
</li>
</ul>
Core Reporting API - Release 2011-05 (May 31, 2011)tag:google.com,changelog:analytics-reporting-core#release-2011-05-312011-05-31T08:00:00:+0000
<p>This release adds 3 new metrics and updates the return value of two.</p>
<h4 id="new_data_updates">New Data Updates</h4>
<ul>
<li>We added 3 new metrics dealing with site speed performance to the API:
<ul>
<li><code>ga:pageLoadSample</code></li>
<li><code>ga:pageLoadTime</code></li>
<li><code>ga:avgPageLoadTime</code></li>
</ul>
</li>
</ul>
<h4 id="metric_updates">Metric Updates</h4>
<ul>
<li>
<p>To specify currency values in filters, you must specify the actual value passed in from the tracking code, (e.g. 1 unit will now be specified as 1).</p>
</li>
<li>
<p><code>ga:CTR</code> now returns the actual percent (e.g. a value of 2% is returned as 2).</p>
</li>
</ul>
Web Tracking (ga.js) - Release 2011-05 (May 18, 2011)tag:google.com,changelog:analytics-collection-gajs#release-2011-05-182011-05-18T08:00:00:+0000
<p>This release contains the following bug fixes.</p>
<ul>
<li>Fixed a bug in cross domain tracking that caused incorrect encoding of campaign data in some cases.</li>
<li>Fixed a bug in cross domain tracking that caused cookies to be loaded from the URL more than once, causing incorrect cookies in some cases.</li>
<li>Fixed a bug in Custom Variables that caused some values to be encoded in reports.</li>
</ul>
Android SDK - Release Version 1.1 (May 4, 2011)tag:google.com,changelog:analytics-collection-android#release-2011-05-042011-05-04T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>
<p>Bug Fixes:</p>
<ul>
<li>Fixed improper encoding of spaces.</li>
<li><code>SQLiteExceptions</code> no longer cause apps to crash.</li>
</ul>
</li>
<li>
<p>New Features:</p>
<ul>
<li>Added support for custom variables</li>
</ul>
</li>
</ul>
Core Reporting API - Release 2011-04 (April 19, 2011)tag:google.com,changelog:analytics-reporting-core#release-2011-04-192011-04-19T08:00:00:+0000
<p>This release improves improves Data Feed performance and adds new data:</p>
<h4 id="performance_improvement">Performance Improvement</h4>
<ul>
<li>This release improves data feed latency by 30 to 35%.</li>
</ul>
<h4 id="new_data_updates">New Data Updates</h4>
<ul>
<li>We have updated the list of dimensions and metrics that are allowed in Advanced Segments. Please refer to the <a href="http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDataFeed.html#segment">updated list</a> to make sure that your requests are valid.</li>
</ul>
<h4 id="upcoming_changes">Upcoming Changes</h4>
<ul>
<li>
<p>Currently, you need to specify a currency filter value as micro units, (e.g 1 unit of currency is specified as 1000000). In the near future, you will need to specify the actual value passed in from the tracking code, (e.g. 1 unit will now be specified as 1).</p>
</li>
<li>
<p>Currently, <code>ga:CTR</code> is a <code>percent</code> and returns the value 0.02. In the near future this will change to return the actual percent (e.g. 2).</p>
</li>
</ul>
Web Tracking (ga.js) - Release 2011-04 (April 14, 2011)tag:google.com,changelog:analytics-collection-gajs#release-2011-04-142011-04-14T08:00:00:+0000
<p>This release contains regular maintenance including bug fixes and refactorings. There is no change to the public APIs or functionality.</p>
Web Tracking (ga.js) - Release 2011-03 (March 30, 2011)tag:google.com,changelog:analytics-collection-gajs#release-2011-03-302011-03-30T08:00:00:+0000
<p>This release contains updates and one new feature.</p>
<ul>
<li>
<p><code>POST</code> support:</p>
<ul>
<li>The tracking code can now send much larger tracking beacons. Traditionally, beacons have been sent via HTTP <code>GET</code> requests, which are limited to 2048 characters by some browsers and proxies. Requests over this limit were dropped and the data never reached Google Analytics. Starting with this release, requests longer than 2048 characters will be sent via HTTP <code>POST</code>, which has no such limit. The tracking code will now support beacons up to 8192 characters.</li>
</ul>
</li>
</ul>
Core Reporting API - Release 2011-03 (March 9, 2011)tag:google.com,changelog:analytics-reporting-core#release-2011-03-092011-03-09T08:00:00:+0000
<p>This release adds more data to the Data Feed:</p>
<h4 id="new_data_updates">New Data Updates</h4>
<ul>
<li>
<p>The following Time dimension has been added: <code>ga:dayOfWeek</code></p>
</li>
<li>
<p>The following Internal Search metric has been added: <code>ga:percentVisitsWithSearch</code></p>
</li>
<li>
<p>The following Event Tracking metrics have been added:</p>
<ul>
<li><code>ga:visitsWithEvent</code></li>
<li><code>ga:eventsPerVisitWithEvent</code></li>
</ul>
</li>
</ul>
<h4 id="upcoming_changes">Upcoming Changes</h4>
<p>Currently the API returns <code>401</code> status codes for for various authorization issues. Within the next couple of weeks, the <code>401</code> status will be used exclusively for invalid tokens, giving developers a way to error handle this particular exception.</p>
Web Tracking (ga.js) - Release 2011-02 (February 17, 2011)tag:google.com,changelog:analytics-collection-gajs#release-2011-02-172011-02-17T08:00:00:+0000
<p>This release contains the following bug fixes.</p>
<ul>
<li>Fixed a bug that prevented <code>_addIgnoredOrganic</code> and <code>_addIgnoredRef</code> from working properly on the first visit to a site.</li>
<li>Fixed an issue related to tracking code running across multiple iframes.</li>
</ul>
iOS SDK - Release Version 1.1 (February 11, 2011)tag:google.com,changelog:analytics-collection-ios#release-2011-02-112011-02-11T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>New Features:
<ul>
<li>Added support for custom variables.</li>
<li>Added NoThumb version of the library.</li>
</ul>
</li>
</ul>
Core Reporting API - Release 2011-01 (January 24, 2011)tag:google.com,changelog:analytics-reporting-core#release-2011-01-242011-01-24T08:00:00:+0000
<p>This release adds significantly more data to the Data Feed:</p>
<h4 id="new_data_updates">New Data Updates</h4>
<ul>
<li>
<p>The calculation of <code>ga:visitors</code> has been changed to return the number of unique visitors across the date range and now supports more dimension and metric combinations.</p>
</li>
<li>
<p>10 new AdWords dimensions have been added: <code>ga:adDistributionNetwork</code>, <code>ga:adMatchType</code>, <code>ga:adMatchedQuery</code>, <code>ga:adPlacementDomain</code>, <code>ga:adPlacementUrl</code>, <code>ga:adFormat</code>, <code>ga:adTargetingType</code>, <code>ga:adTargetingOption</code>, <code>ga:adDisplayUrl</code>, <code>ga:adDestinationUrl</code>.</p>
</li>
<li>
<p>The metric <code>ga:organicSearches</code> has been added to the campaign group.</p>
</li>
<li>
<p>The metric <code>ga:searchResultViews</code> has been added to the internal site search group.</p>
</li>
<li>
<p>3 new time-based dimensions have been added: <code>ga:nthDay</code>, <code>ga:nthWeek</code>, <code>ga:nthMonth</code>.</p>
</li>
<li>
<p>The groupings of dimensions and metrics have been changed to better reflect the features they represent.</p>
</li>
</ul>
<h4 id="new_calculated_metrics">New Calculated Metrics</h4>
<p>The following calculated metrics are derived from calculations using the base metrics. Note: Each name with <code>(n)</code> supports values 1-20.</p>
<ul>
<li>
<p>Goal Based: <code>ga:costPerConversion</code>, <code>ga:costPerGoalConversion</code>, <code>ga:costPerTransaction</code>, <code>ga:goal(n)AbandonRate</code>, <code>ga:goal(n)Abandons</code>, <code>ga:goal(n)ConversionRate</code>, <code>ga:goalAbandonRateAll</code>, <code>ga:goalAbandonsAll</code>, <code>ga:goalConversionRateAll</code>, <code>ga:goalValueAllPerSearch</code>, <code>ga:goalValuePerVisit</code>.</p>
</li>
<li>
<p>Content Based: <code>ga:entranceBounceRate</code>, <code>ga:visitBounceRate</code>, <code>ga:entranceRate</code>, <code>ga:exitRate</code>, <code>ga:pageviewsPerVisit</code>, <code>ga:avgTimeOnPage</code>, <code>ga:avgTimeOnSite</code>, <code>ga:avgEventValue</code>.</p>
</li>
<li>
<p>Internal Site Search Based: <code>ga:avgSearchDepth</code>, <code>ga:avgSearchDuration</code>, <code>ga:avgSearchResultViews</code>, <code>ga:searchGoalConversionRateAll</code>, <code>ga:searchGoal(n)ConversionRate</code>, <code>ga:searchExitRate</code>.</p>
</li>
<li>
<p>Ecommerce Based: <code>ga:itemsPerPurchase</code>, <code>ga:margin</code>, <code>ga:percentNewVisits</code>, <code>ga:revenuePerItem</code>, <code>ga:revenuePerTransaction</code>, <code>ga:ROI</code>, <code>ga:RPC</code>, <code>ga:totalValue</code>, <code>ga:transactionRevenuePerVisit</code>, <code>ga:transactionsPerVisit</code>.</p>
</li>
</ul>
Core Reporting API - Release 2010-11 (November 1, 2010)tag:google.com,changelog:analytics-reporting-core#release-2010-11-012010-11-01T08:00:00:+0000
<p>This release adds a new feature to the Data Feed:</p>
<h4 id="new_features">New Features</h4>
<ul>
<li>A new XML element has been added lets users know if the data has been sampled. <code><dxp:containsSampledData>true</dxp:containsSampledData></code>. This element will always return whether the data was sampled or not with either <code>true</code> or <code>false</code>. The Java and JavaScript libraries have also been updated with helper methods to access this element.</li>
</ul>
Web Tracking (ga.js) - Release 2010-10 (October 4, 2010)tag:google.com,changelog:analytics-collection-gajs#release-2010-10-042010-10-04T08:00:00:+0000
<p>This release contains regular maintenance including bug fixes and refactorings. There is no change to the public APIs or functionality.</p>
iOS SDK - Release Version 1.0 (August 30, 2010)tag:google.com,changelog:analytics-collection-ios#release-2010-08-302010-08-30T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>
<p>New Features:</p>
<ul>
<li>Added iOS4 support</li>
</ul>
</li>
</ul>
Core Reporting API - Release 2010-08 (August 23, 2010)tag:google.com,changelog:analytics-reporting-core#release-2010-08-232010-08-23T08:00:00:+0000
<p>This release fixes 2 bugs:</p>
<h4 id="bug_fixes">Bug Fixes</h4>
<ul>
<li>
<p>Previously adding an OR operator to a filter expression with a dimension (i.e., <code>ga:keyword==store,ga:keyword==bar</code>) could result in different values than if each filter was applied individually across multiple queries. This has been fixed and using the OR operator now returns consistent values.</p>
</li>
<li>
<p>Some of the API error messages for invalid filters have been updated to NOT include whether it was a dimension or metric filter that caused the error (though the actual offending filter expression will continue to be returned).</p>
</li>
</ul>
Management API - Release 2010-08 (August 18, 2010)tag:google.com,changelog:analytics-config-mgmt#release-2010-08-182010-08-18T08:00:00:+0000
<p>This is the beta release of the Google Analytics Management API!</p>
<h4 id="new_feeds">New Feeds</h4>
<ul>
<li>
<p>Five new feeds have been created to simplify accessing Google Analytics account configuration data:</p>
<ul>
<li><a href="http://code.google.com/apis/analytics/docs/mgmt/mgmtFeedReference.html#accountFeed">Account Feed</a></li>
<li><a href="http://code.google.com/apis/analytics/docs/mgmt/mgmtFeedReference.html#profileFeed">Web Property Feed</a></li>
<li><a href="http://code.google.com/apis/analytics/docs/mgmt/mgmtFeedReference.html#webPropertyFeed">Profile Feed</a></li>
<li><a href="http://code.google.com/apis/analytics/docs/mgmt/mgmtFeedReference.html#goalFeed">Goal Feed</a></li>
<li><a href="http://code.google.com/apis/analytics/docs/mgmt/mgmtFeedReference.html#advancedSegmentFeed">Advanced Segment Feed</a></li>
</ul>
</li>
</ul>
<h4 id="updated_client_libraries">Updated Client Libraries</h4>
<ul>
<li>The Management API is being released in the same library as the Google Analytics Data Export API. Both Google Data Java and JavaScript libraries have been updated. Each feed can be accessed by specifying the appropriate feed URI to the libraries <code>getManagementFeed()</code> method.</li>
</ul>
<h4 id="new_documentation">New Documentation</h4>
<ul>
<li>A new section of the Google Analytics developer docs has been created to describe how the <a href="http://code.google.com/apis/analytics/docs/mgmt/home.html">new Management API</a> works.</li>
</ul>
Core Reporting API - Release 2010-07 (July 26, 2010)tag:google.com,changelog:analytics-reporting-core#release-2010-07-262010-07-26T08:00:00:+0000
<p>This release fixes 3 bugs:</p>
<h4 id="bug_fixes">Bug Fixes</h4>
<ul>
<li>
<p>An encoding issue in the JavaScript Client Library has been fixed. <a href="http://code.google.com/p/analytics-issues/issues/detail?id=83">Analytics issue tracker</a></p>
</li>
<li>
<p>A bug that prevented the Account Feed to not return when a goal name, goal path, goal comparison value, or goal comparison type had been incorrectly set, has now been fixed.</p>
</li>
<li>
<p>It is invalid to OR a dimension and metric in the Data Feed query filter parameter. For example: <code>ga:source==google,ga:visits>5</code>. The error message for this invalid query has been updated to say: <code>Cannot OR dimension
filter(s) with metric filter</code>.</p>
</li>
</ul>
Core Reporting API - Release 2010-05 (May 4, 2010)tag:google.com,changelog:analytics-reporting-core#release-2010-05-042010-05-04T08:00:00:+0000
<p>This release adds new data and fixes a bug:</p>
<h4 id="new_features">New Features</h4>
<ul>
<li>
<p>The following 5 dimensions have been added in the new category <code>D8. Adwords</code>:</p>
<ul>
<li><code>ga:adwordsAdGroupId</code>: corresponds to the AdWords API <a href="http://code.google.com/apis/adwords/v2009/docs/reference/AdGroupService.AdGroup.html">AdGroup.id</a></li>
<li><code>ga:adwordsCampaignId</code>: corresponds to the AdWords API <a href="http://code.google.com/apis/adwords/v2009/docs/reference/CampaignService.Campaign.html">Campaign.id</a></li>
<li><code>ga:adwordsCreativeId</code>: corresponds to the AdWords API <a href="http://code.google.com/apis/adwords/v2009/docs/reference/AdGroupAdService.Ad.html">Ad.id</a></li>
<li><code>ga:adwordsCriteriaId</code>: corresponds to the AdWords API <a href="http://code.google.com/apis/adwords/v2009/docs/reference/AdGroupCriterionService.Criterion.html">Criterion.id</a></li>
<li><code>ga:adwordsCustomerId</code>: cooresponds to the AdWords API <a href="http://code.google.com/apis/adwords/docs/developer/AccountInfo.html">AccountInfo.customerId</a></li>
</ul>
</li>
</ul>
<h4 id="bug_fixes">Bug Fixes</h4>
<ul>
<li>We fixed an issue where the Account Feed would not return data if one of the profiles had a misconfigured goal or step.</li>
</ul>
Web Tracking (ga.js) - Release 2010-04 (April 20, 2010)tag:google.com,changelog:analytics-collection-gajs#release-2010-04-202010-04-20T08:00:00:+0000
<p>This release contains bug fixes and API cleanup.</p>
<ul>
<li>
<p>Bug fixes:</p>
<ul>
<li>Fixed event tracking bug. Calling <code>_trackEvent</code> no longer requires calling<code>_initData</code> or <code>_trackPageview</code> first.</li>
<li>Updated async snippet so that it can be placed in the head on any page without causing problems in IE 6 and 7. See the <a href="http://code.google.com/apis/analytics/docs/tracking/asyncTracking.html">Asynchronous Tracking Guide</a> for the new snippet. This update occured on 3/22/2010.</li>
<li>Expanded async syntax to support calling methods on the <code>_gat</code> object.</li>
</ul>
</li>
<li>
<p>Updated tracker initialization APIs to be consistent with async syntax. Also deprecated old functions.</p>
<ul>
<li>Added <code>_gat._createTracker(opt_account, opt_name)</code> function. Allows trackers to be named and later retrieved by their name.Use this instead of <code>_gat._getTracker(account)</code>.</li>
<li>Added <code>_gat._getTrackerByName(name)</code>. Retrieves the tracker with the given name.</li>
<li>Added <code>tracker._getName()</code>. Returns the name given to the tracker when it was created.</li>
<li>Deprecated <code>_gaq._createAsyncTracker(account, opt_name)</code>. Use <code>_gat._createTracker</code> instead.</li>
<li>Deprecated <code>_gaq._getAsyncTracker(name)</code>. Use <code>_gat._getTrackerByName</code> instead.</li>
</ul>
</li>
<li>
<p>See the <a href="http://code.google.com/apis/analytics/docs/gaJS/gaJSApi.html">Tracker Reference</a> for details on these API changes.</p>
</li>
</ul>
Core Reporting API - Release 2010-03 (March 22, 2010)tag:google.com,changelog:analytics-reporting-core#release-2010-03-222010-03-22T08:00:00:+0000
<p>This release adds a number of new features and fixes a bug:</p>
<h4 id="new_features">New Features</h4>
<ul>
<li>
<p>The iPhone Default Segment (gaid::-11) has been enhanced to now report on <strong>all mobile devices</strong>. The ID is the same as before (-11), but the name of the segment is now: <code>Mobile Traffic</code>.</p>
</li>
<li>
<p>The sampling rate used by the API is now the same as the web interface. This brings the data for sampled reports inline with the web interface and increases consistency between the two.</p>
</li>
<li>
<p>The quota policy has been updated in an effort to ensure that all users receive equitable access to resources. Please refer to our <a href="http://code.google.com/apis/analytics/docs/gdata/gdataDeveloperGuide.html#quota">quota policy documentation</a> for more details. The new policy is:</p>
<ul>
<li>A single web property may make a maximum of 10,000 requests per 24 hours.</li>
<li>An application can only make 10 requests in any given 1-second period.</li>
<li>An application can only have 4 pending requests at any given time.</li>
</ul>
</li>
<li>
<p>Some restrictions on dimension and metric combinations have been relaxed. <code>ga:nextPagePath</code> and <code>ga:previousPagePath</code> are now part of the <code>D3. Content</code> group. The <code>D8. Custom Variable</code> group is now called the <code>D6. Custom Variable</code> group. Please see the <a href="http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html">updated reference guide</a> for these new combinations.</p>
</li>
</ul>
<h4 id="bug_fixes">Bug Fixes</h4>
<ul>
<li>
<p>We fixed a bug on how the API reports the <code>confidenceInterval</code> value for metrics. Previously confidence intervals could have a value of either <code>INF</code> or a number from 0 to 1. Now all confidence intervals will have a value of either <code>INF</code> or a number greater than or equal to 0.</p>
</li>
<li>
<p><code>ga:itemQuantity</code> and <code>ga:uniquePurchases</code> were previously swapped and returned each other’s value. They are now fixed to return the correct data.</p>
</li>
</ul>
<h4 id="deprecation_of_dimensions_and_metrics_reminder">Deprecation of Dimensions and Metrics Reminder</h4>
<ul>
<li>If you haven’t done so already, please stop using the previously deprecated dimensions and metrics</li>
</ul>
Core Reporting API - Release 2009-12 (December 14, 2009)tag:google.com,changelog:analytics-reporting-core#release-2009-12-142009-12-14T08:00:00:+0000
<p>This release adds a number of new features:</p>
<h4 id="this_release_increments_the_major_version_number_to_2">This release increments the major version number to 2</h4>
<ul>
<li>
<p>Some features require the use of the latest client libraries. We officially support: <a href="http://code.google.com/apis/analytics/docs/gdata/2.0/gdataJava.html">Java</a> & <a href="http://code.google.com/apis/analytics/docs/gdata/2.0/gdataJavascript.html">Javascript</a>. 3rd party libraries might not be updated yet.</p>
<ul>
<li>Version 2 may be requested by adding the header <code>GData-Version: 2</code> to each account or data feed request Read the <a href="http://code.google.com/apis/analytics/docs/gdata/2.0/gdataProtocol.html#version">documentation</a> for more details.</li>
<li>A new XML namespace has been added to both account and data feeds: <br /> <code>xmlns:ga='http://schemas.google.com/ga/2009'</code></li>
</ul>
</li>
<li>
<p>The API now supports the Google Data protocol <a href="http://code.google.com/apis/gdata/docs/2.0/basics.html">version 2</a>.</p>
</li>
</ul>
<h4 id="advanced_segmentation_support">Advanced segmentation support</h4>
<ul>
<li>
<p>Dynamic segments query parameter:</p>
<ul>
<li><code>...&segment=dynamic::</code><em>expression</em></li>
<li>allows creation of advanced segments “on the fly.”</li>
<li>expression can be any dimension or metric and should follow the same syntax as filters.</li>
</ul>
</li>
<li>
<p>Default and custom segments query parameter:</p>
<ul>
<li><code>...&segment=gaid::</code><em>number</em></li>
<li>where number is an ID referencing an advanced segment defined in the Google Analytics Web Interface.</li>
<li>ID can be found in the account feed.</li>
</ul>
</li>
<li>
<p>The account feed describes segment data through the following XML elements and attributes:</p>
<ul>
<li><code><dxp:segment id='gaid::-3' name='Returning Visitors'></code></li>
<li><code><dxp:definition>ga:visitorType==Returning Visitor</dxp:definition></code></li>
</ul>
</li>
<li>
<p>The data feed also provides an XML element indicating whether a segment was applied in the API request.</p>
</li>
<li>
<p>More details on advanced segments in our <a href="http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDataFeed.html#segment">documentation</a>.</p>
</li>
</ul>
<h4 id="new_goal_data_available">New goal data available</h4>
<ul>
<li>
<p>Destination and engagement type goals available in the account feed:</p>
<ul>
<li><code><ga:goal active='true' name='Completing Order' number='1' value='10.0'></code></li>
<li><code><ga:destination expression='/purchaseComplete.html' matchType='regex'
step1Required='false' caseSensitive='false'></code></li>
<li><code><ga:step number='1' name='Login' path='/login.html'/></code></li>
<li><code><ga:engagement comparison='&gt;' thresholdValue='300' type='timeOnSite'/></code></li>
</ul>
</li>
<li>
<p>48 new goal metrics have been added for goals 5-20 which all follow the convention <code>goal(n)Completions</code>, where <code>(n)</code> is a number between 1 and 20.</p>
<ul>
<li><code>ga:goal(n)Completions</code></li>
<li><code>ga:goal(n)Starts</code></li>
<li><code>ga:goal(n)Value</code></li>
</ul>
</li>
<li>
<p><code>GoalCompletionAll</code>, <code>GoalStartsAll</code> and <code>GoalValueAll</code> have been updated to account for the new goal data.</p>
</li>
</ul>
<h4 id="new_custom_variable_data">New custom variable data</h4>
<ul>
<li>
<p>All custom variables ever collected by each profile have been added as a new XML element to the account feed:</p>
<ul>
<li><code><ga:customVariable index='1' name='category' scope='visitor'></code></li>
</ul>
</li>
<li>
<p>10 new dimensions have been added for custom variables. They follow the convention <code>customVar(n)</code> where <code>(n)</code> can be a number between 1 and 5.</p>
<ul>
<li><code>ga:customVarName(n)</code></li>
<li><code>ga:customVarValue(n)</code></li>
</ul>
</li>
</ul>
<h4 id="deprecated_dimensions__metrics_to_be_removed">Deprecated dimensions & metrics to be removed!</h4>
<ul>
<li>
<p>If you haven’t done so already, please stop using the previously deprecated dimensions and metrics. They will be removed soon and will return errors from our API if requested.</p>
<ul>
<li><code>ga:countOfVisits</code></li>
<li><code>ga:countOfVisitsToATransaction</code></li>
<li><code>ga:sourceMedium</code></li>
<li><code>ga:percentNewVisits</code></li>
</ul>
</li>
<li>
<p>The following dimensions have been renamed:</p>
<ul>
<li><code>ga:countOfVisits</code> is now <code>ga:visitCount</code></li>
<li><code>ga:countOfVisitsToATransaction</code> is now <code>ga:visitsToTransaction</code></li>
</ul>
</li>
</ul>
Web Tracking (ga.js) - Release 2009-12 (December 1, 2009)tag:google.com,changelog:analytics-collection-gajs#release-2009-12-012009-12-01T08:00:00:+0000
<p>This release contains updates to the default search engine list and new functions to control cookie timeouts. In addition, the asynchronous GA snippet is launched that reduces the ga.js latency impact on the page.</p>
<ul>
<li>
<p>Updated the default search engine list</p>
<ul>
<li>Added Naver, Eniro and Daum search engines.</li>
<li>Removed Looksmart, Gigablast, Club-internet, Netsprint, Intera, Nostrum and Ilse from the list.</li>
</ul>
</li>
<li>
<p>Added functions to control cookie expiration times for all stored cookies. Deprecated existing cookie timeout functions. See the <a href="gaJSApi.html">JS API documentation</a> for more details.</p>
<ul>
<li><code>_setVisitorCookieTimeout(cookieTimeoutMillis)</code> replaces the <code>_setCookiePersistence</code> function.</li>
<li><code>_setSessionCookieTimeout(cookieTimeoutMillis)</code> replaces the <code>_setSessionTimeout</code> function.</li>
<li><code>_setCampaignCookieTimeout(cookieTimeoutMillis)</code> replaces the <code>_setCookieTimeout</code> function.</li>
</ul>
</li>
<li>
<p>Launched asynchronous GA snippet. See <a href="../tracking/asyncTracking.html">documentation</a> on how to try it out.</p>
</li>
<li>
<p><code>_setVar</code> function is now deprecated. Custom Variables feature replaces <code>_setVar</code>. See <a href="../tracking/gaTrackingCustomVariables.html">documentation</a> for more details.</p>
</li>
</ul>
Web Tracking (ga.js) - Release 2009-11 (November 4, 2009)tag:google.com,changelog:analytics-collection-gajs#release-2009-11-042009-11-04T08:00:00:+0000
<p>This release contains:</p>
<ul>
<li>
<p>Added a new function to retrieve visitor level custom variables. See the <a href="gaJSApiBasicConfiguration.html#_gat.GA_Tracker_._getVisitorCustomVar">function documentation</a> for more details.</p>
<ul>
<li><code>_getVisitorCustomVar(index)</code></li>
</ul>
</li>
<li>
<p>Instead of waiting for window.onload, Site Overlay content is loaded as soon as ga.js is executed.</p>
</li>
</ul>
Web Tracking (ga.js) - Release 2009-10 (October 14, 2009)tag:google.com,changelog:analytics-collection-gajs#release-2009-10-142009-10-14T08:00:00:+0000
<p>This release contains a new feature:</p>
<ul>
<li>
<p>Added an optional boolean parameter to <code>_addOrganic</code> function to specify if new organic sources are added to the beginning or the end of the organic source list. See the <a href="gaJSApiSearchEngines.html">documentation</a> for more details.</p>
<ul>
<li><code>_addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)</code></li>
</ul>
</li>
</ul>
Web Tracking (ga.js) - Release 2009-09 (September 28, 2009)tag:google.com,changelog:analytics-collection-gajs#release-2009-09-282009-09-28T08:00:00:+0000
<p>This release contains regular maintenance for performance improvements and refactorings. There is no change to the public APIs or functionality.</p>
Core Reporting API - Release 2009-09 (September 18, 2009)tag:google.com,changelog:analytics-reporting-core#release-2009-09-182009-09-18T08:00:00:+0000
<p>This release adds new features and deprecates some old functionality:</p>
<ul>
<li>
<p>The following dimensions and metrics are now deprecated. We’ll be permanently removing them from our API in one month. Please make sure to update your code so your applications don’t break:</p>
<ul>
<li>ga:countOfVisits</li>
<li>ga:countOfVisitsToATransaction</li>
<li>ga:sourceMedium</li>
<li>ga:percentNewVisits</li>
</ul>
</li>
<li>
<p>The following Dimensions have been renamed:</p>
<ul>
<li>ga:countOfVisits is now ga:visitCount</li>
<li>ga:countOfVisitsToATransaction is now ga:visitsToTransaction</li>
</ul>
</li>
<li>
<p>All Event Tracking data is now exposed as 2 new groups:</p>
<p><strong>D7. Events</strong> (Dimensions) * ga:eventCategory * ga:eventAction * ga:eventLabel</p>
<p><strong>M7. Events</strong> (Metrics) * ga:eventValue * ga:totalEvents * ga:uniqueEvents</p>
</li>
<li>
<p>Overall site navigation data is is now exposed through the following dimensions:</p>
<p><strong>D6. Navigation</strong> * ga:previousPagePath * ga:nextPagePath</p>
</li>
<li>
<p>Landing page navigation is now exposed through the following dimensions:</p>
<p><strong>D3. Content</strong> * ga:landingPagePath * ga:secondPagePath</p>
</li>
<li>
<p>The maximum length of regular expressions in the Data Feed’s filter query parameter has been raised from 32 to 128 characters.</p>
</li>
<li>
<p>The Length of Visit report (found through the UI under Visitors -> Visitor Loyalty) is now exposed through the new dimension:</p>
<ul>
<li>ga:visitLength</li>
</ul>
</li>
</ul>
Web Tracking (ga.js) - Release 2009-08 (August 31, 2009)tag:google.com,changelog:analytics-collection-gajs#release-2009-08-312009-08-31T08:00:00:+0000
<p>This release contains multiple bug fixes and performance improvements:</p>
<ul>
<li>Proper encoding for search terms for organic searches, web page path info for (utmp), and user defined values when used with the linker feature (ie: <code>_link</code> and <code>_linkByPost</code> functions).</li>
<li>The search engine Rambler is added to the organic search list</li>
<li>Organic search parsing is corrected for search engine http://kvasir.no</li>
<li>New organic search engines defined by the user are now added to the top of the list</li>
<li>Removed deprecated <code>_trackEvent(action, label, value)</code> function and replaced it with <code>_trackEvent(category, action, label, value)</code></li>
<li>Referrer URLs are now stored as case sensitive. For example: www.domain.com/PaGe.HtMl will be reported with case information.</li>
<li>Added a 1200 character limitation to GASO token size.</li>
<li>New function was added to allow overriding the default timeouts for cookies: <code>_setCookiePersistence(timeout)</code></li>
</ul>
Core Reporting API - Release 2009-06 (June 30, 2009)tag:google.com,changelog:analytics-reporting-core#release-2009-06-302009-06-30T08:00:00:+0000
<p>This release updates the Google Analytics Data Export API as follows:</p>
<ul>
<li>
<p>Some restrictions on dimension and metric combinations have been relaxed. You can now query most content and visitor level dimensions together, for example <code>ga:pagePath</code> and <code>ga:source</code> is now a valid combination. Please see the updated reference guide for these new combinations: <a href="http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html">http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html</a></p>
</li>
<li>
<p>The total number of rows that can be asked for in one request has been increased to 10,000. The default number of rows returned is still 1,000, but can now be increased by setting the <code>max-results</code> query parameter.</p>
</li>
<li>
<p>The Account Feed now returns two new data elements for each Table ID (currency and timezone).<br /> <code><dxp:property name='ga:currency' value='USD'/></code><br /> <code><dxp:property name='ga:timezone' value='America/Los_Angeles'/></code></p>
</li>
<li>
<p>We’re now enforcing that data queries must include at least one valid metric.</p>
</li>
<li>
<p>All previous deprecation changes have taken effect.</p>
</li>
</ul>
Core Reporting API - Release 2009-05 (May 22, 2009)tag:google.com,changelog:analytics-reporting-core#release-2009-05-222009-05-22T08:00:00:+0000
<p>This release removes deprecated features from our private beta:</p>
<ul>
<li>
<p>The account feed requests will no longer support a username in them. Instead, it will only accept requests in the following format:<br /><code>https://www.google.com/analytics/feeds/accounts/default</code></p>
</li>
<li>
<p>The following metrics are being removed and will no longer work. Instead, we have provided instructions on how to calculate these values here: <a href="http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html">http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html</a></p>
<ul>
<li>ga:avgPageDuration</li>
<li>ga:avgPageviews</li>
<li>ga:avgSessionTime</li>
<li>ga:bounceRate</li>
<li>ga:exitRate</li>
<li>ga:costPerConversion</li>
<li>ga:costPerGoalConversion</li>
<li>ga:costPerTransaction</li>
<li>ga:revenuePerClick</li>
<li>ga:revenuePerTransaction</li>
<li>ga:revenuePerVisit</li>
<li>ga:abandonedFunnels1</li>
<li>ga:abandonedFunnels2</li>
<li>ga:abandonedFunnels3</li>
<li>ga:abandonedFunnels4</li>
<li>ga:goalConversionRate</li>
<li>ga:goalConversionRate1</li>
<li>ga:goalConversionRate2</li>
<li>ga:goalConversionRate3</li>
<li>ga:goalConversionRate4</li>
<li>ga:goalValuePerVisit</li>
</ul>
</li>
<li>
<p>The following dimensions and metrics have been renamed. The old names will no longer work. Please verify you are using the official names in our documentation here: <a href="http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html">http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html</a></p>
<p><strong>Dimensions</strong> * ga:subContinentRegion ⇒ ga:subContinent * ga:organization ⇒ ga:networkLocation * ga:domain ⇒ ga:networkDomain * ga:visitNumber ⇒ ga:countOfVisits * ga:platform ⇒ ga:operatingSystem * ga:platformVersion ⇒ ga:operatingSystemVersion * ga:content ⇒ ga:adContent * ga:requestUri ⇒ ga:pagePath * ga:requestUri1 ⇒ ga:landingPagePath * ga:requestUriLast ⇒ ga:exitPagePath * ga:internalSearchNext ⇒ ga:searchKeywordRefinement * ga:internalSearchKeyword ⇒ ga:searchKeyword * ga:internalSearchType ⇒ ga:searchCategory * ga:hasInternalSearch ⇒ ga:searchUsed * ga:requestUriFrom ⇒ ga:searchStartPage * ga:requestUriTo ⇒ ga:searchDestinationPage * ga:productCode ⇒ ga:productSku</p>
<p><strong>Metrics</strong> * ga:newVisitors ⇒ ga:newVisits * ga:pageDuration ⇒ ga:timeOnPage * ga:visitDuration ⇒ ga:timeOnSite * ga:cost ⇒ ga:adCost * ga:clicks ⇒ ga:adClicks * ga:clickThroughRate ⇒ ga:CTR * ga:costPerClick ⇒ ga:CPC * ga:costPerMilleImpressions ⇒ ga:CPM * ga:searchTransitions ⇒ ga:searchRefinements * ga:uniqueInternalSearches ⇒ ga:searchUniques * ga:visitsWithSearches ⇒ ga:searchVisits * ga:productPurchases ⇒ ga:itemQuantity * ga:productRevenue ⇒ ga:itemRevenue * ga:products ⇒ ga:uniquePurchases * ga:revenue ⇒ ga:transactionRevenue * ga:shipping ⇒ ga:transactionShipping * ga:tax ⇒ ga:transactionTax * ga:goalCompletions1 ⇒ ga:goal1Completions * ga:goalCompletions2 ⇒ ga:goal2Completions * ga:goalCompletions3 ⇒ ga:goal3Completions * ga:goalCompletions4 ⇒ ga:goal4Completions * ga:goalStarts1 ⇒ ga:goal1Starts * ga:goalStarts2 ⇒ ga:goal2Starts * ga:goalStarts3 ⇒ ga:goal3Starts * ga:goalStarts4 ⇒ ga:goal4Starts * ga:goalValue1 ⇒ ga:goal1Value * ga:goalValue2 ⇒ ga:goal2Value * ga:goalValue3 ⇒ ga:goal3Value * ga:goalValue4 ⇒ ga:goal4Value</p>
</li>
</ul>