Try the MCP server for Google Analytics. Install from
GitHub, and see the
announcement for more details.
Audience Export Dimensions
Stay organized with collections
Save and categorize content based on your preferences.
The dimensions supported in queries to the Audience Export methods of the Analytics Data API.
The Core Reporting methods (RunReport
for example) accept a different set of Dimensions & Metrics
than the Audience Export methods.
Dimensions
The following dimensions can be requested in audience exports for any property.
Specify the "API Name" in an
AudienceDimension
resource's name field for a column of the dimension in the audience export
response.
| API Name |
UI Name |
Description |
deviceId |
Device ID |
A browser-based or mobile-app-based identifier for a unique, pseudonymous website or mobile app user. To learn more, see Device ID. |
isAdsPersonalizationAllowed |
Is ads personalization allowed |
If a user is eligible for ads personalization, isAdsPersonalizationAllowed returns true. If a user is not eligible for ads personalization, isAdsPersonalizationAllowed returns false.
isAdsPersonalizationAllowed returns (not set) if Google Analytics can't return whether this user is eligible for ads personalization; users where isAdsPersonalizationAllowed returns (not set) may or may not be eligible for personalized ads. For personalized ads, you should treat users where isAdsPersonalizationAllowed = (not set) as isAdsPersonalizationAllowed = false because, in the most general case, some of the (not set) rows will include users that are not eligible for ads personalization.
Users where isAdsPersonalizationAllowed = false can still be used for non-advertising use cases like A/B testing & data explorations. |
isLimitedAdTracking |
Is limited ad tracking |
The device's Limit Ad Tracking setting. Possible values include: true, false, and (not set). isLimitedAdTracking returns (not set) if Google Analytics can't return this device's Limit Ad Tracking setting. |
userId |
User ID |
The User ID specified for this user in tagging. To learn more, see Measure activity across platforms with User-ID.
If user-provided data collection is turned on, user-provided data along with User-ID can be sent to Google Analytics in tagging to improve measurement. To learn more, see user-provided data collection. Regardless of whether user-provided data is turned on for your property, userId returns the User ID specified in tagging. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-10 UTC.
[null,null,["Last updated 2025-03-10 UTC."],[[["\u003cp\u003eThe Analytics Data API's Audience Export methods use a specific set of dimensions for querying data, differing from the Core Reporting methods.\u003c/p\u003e\n"],["\u003cp\u003eAudience exports support dimensions such as Device ID, Ads Personalization status, Limited Ad Tracking status, and User ID for any Google Analytics property.\u003c/p\u003e\n"],["\u003cp\u003eThese dimensions provide insights into user characteristics, privacy settings, and identifiers for analysis and audience creation.\u003c/p\u003e\n"],["\u003cp\u003eYou can include these dimensions in your audience export requests by specifying their API names within the \u003ccode\u003eAudienceDimension\u003c/code\u003e resource.\u003c/p\u003e\n"]]],["Audience Export methods in the Analytics Data API support specific dimensions for queries, distinct from Core Reporting methods. These dimensions, specified by their API Name, include `deviceId`, a unique user identifier; `isAdsPersonalizationAllowed`, indicating a user's eligibility for personalized ads; `isLimitedAdTracking`, reflecting the device's ad tracking settings; and `userId`, the user ID defined in tagging. Each dimension's API Name is used in the `AudienceDimension` resource to retrieve corresponding data.\n"],null,["# Audience Export Dimensions\n\nThe dimensions supported in queries to the [Audience Export methods](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/create) of the Analytics Data API.\nThe Core Reporting methods ([`RunReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport)\nfor example) accept a different set of [Dimensions \\& Metrics](/analytics/devguides/reporting/data/v1/api-schema)\nthan the Audience Export methods.\n\nDimensions\n----------\n\nThe following dimensions can be requested in audience exports for any property.\nSpecify the \"API Name\" in an\n[`AudienceDimension`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports#AudienceDimension)\nresource's `name` field for a column of the dimension in the audience export\nresponse.\n\n| API Name | UI Name | Description |\n|-------------------------------|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `deviceId` | Device ID | A browser-based or mobile-app-based identifier for a unique, pseudonymous website or mobile app user. To learn more, see [Device ID](//support.google.com/analytics/answer/9356035). |\n| `isAdsPersonalizationAllowed` | Is ads personalization allowed | If a user is eligible for ads personalization, isAdsPersonalizationAllowed returns `true`. If a user is not eligible for ads personalization, isAdsPersonalizationAllowed returns `false`. isAdsPersonalizationAllowed returns `(not set)` if Google Analytics can't return whether this user is eligible for ads personalization; users where isAdsPersonalizationAllowed returns `(not set)` may or may not be eligible for personalized ads. For personalized ads, you should treat users where isAdsPersonalizationAllowed = `(not set)` as isAdsPersonalizationAllowed = `false` because, in the most general case, some of the `(not set)` rows will include users that are not eligible for ads personalization. Users where isAdsPersonalizationAllowed = `false` can still be used for non-advertising use cases like A/B testing \\& data explorations. |\n| `isLimitedAdTracking` | Is limited ad tracking | The device's Limit Ad Tracking setting. Possible values include: `true`, `false`, and `(not set)`. isLimitedAdTracking returns `(not set)` if Google Analytics can't return this device's Limit Ad Tracking setting. |\n| `userId` | User ID | The User ID specified for this user in tagging. To learn more, see [Measure activity across platforms with User-ID](//support.google.com/analytics/answer/9213390). If user-provided data collection is turned on, user-provided data along with User-ID can be sent to Google Analytics in tagging to improve measurement. To learn more, see [user-provided data collection](//support.google.com/analytics/answer/14077171). Regardless of whether user-provided data is turned on for your property, `userId` returns the User ID specified in tagging. |"]]
