Stay organized with collectionsSave and categorize content based on your preferences.
The dimensions supported in queries to theAudience Export methodsof the Analytics Data API.
The Core Reporting methods (RunReportfor example) accept a different set ofDimensions & Metricsthan the Audience Export methods.
Dimensions
The following dimensions can be requested in audience exports for any property.
Specify the "API Name" in anAudienceDimensionresource'snamefield 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, seeDevice ID.
isAdsPersonalizationAllowed
Is ads personalization allowed
If a user is eligible for ads personalization, isAdsPersonalizationAllowed returnstrue. If a user is not eligible for ads personalization, isAdsPersonalizationAllowed returnsfalse.
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 =falsebecause, in the most general case, some of the(not set)rows will include users that are not eligible for ads personalization.
Users where isAdsPersonalizationAllowed =falsecan 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, seeuser-provided data collection. Regardless of whether user-provided data is turned on for your property,userIdreturns 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. |"]]
