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.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["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. |"]]
