受众群体导出维度
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
对 Google Analytics Data API 的受众群体导出方法进行查询时支持的维度。与受众群体导出方法不同,核心报告方法(例如 RunReport
)接受的维度和指标是另一组。
维度
您可以在导出任何媒体资源的受众群体时请求以下维度。在受众群体导出响应中,为维度列在 AudienceDimension
资源的 name
字段中指定“API 名称”。
API 名称 |
界面名称 |
说明 |
deviceId |
设备 ID |
基于浏览器或移动应用的标识符,代表网站或移动应用的唯一身份假名用户。如需了解详情,请参阅设备 ID。 |
isAdsPersonalizationAllowed |
是否允许广告个性化 |
如果用户符合广告个性化条件,isAdsPersonalizationAllowed 会返回 true 。如果用户不符合广告个性化条件,isAdsPersonalizationAllowed 会返回 false 。 如果 Google Analytics 无法返回此用户是否符合广告个性化条件,则 isAdsPersonalizationAllowed 会返回 (not set) ;如果 isAdsPersonalizationAllowed 返回 (not set) ,用户可能符合个性化广告条件,也可能不符合。对于个性化广告,当 isAdsPersonalizationAllowed 为用户返回 (not set) 时,您应该视为返回 false ,因为在大多数情况下,某些 (not set) 行会包含不符合广告个性化条件的用户。 如果 isAdsPersonalizationAllowed 返回 false ,用户仍可用于非广告用例,例如 A/B 测试和数据探索。 |
isLimitedAdTracking |
是否启用了“限制广告跟踪” |
设备的“限制广告跟踪”设置。可能的值包括 true 、false 和 (not set) 。如果 Google Analytics 无法返回此设备的“限制广告跟踪”设置,则 isLimitedAdTracking 会返回 (not set) 。 |
userId |
用户 ID |
在代码植入中为此用户指定的用户 ID。如需了解详情,请参阅使用 User-ID 跨平台衡量活动。 如果启用了“收集用户提供的数据”功能,则可以在代码植入过程中将用户提供的数据与 User-ID 一起发送到 Google Analytics,以改进衡量效果。如需了解详情,请参阅“收集用户提供的数据”功能。无论您的媒体资源是否启用了用户提供的数据,userId 都会返回代码植入中指定的用户 ID。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\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. |"]]