سرور MCP را برای Google Analytics امتحان کنید. از
GitHub نصب کنید و برای جزئیات بیشتر به
اطلاعیه مراجعه کنید.
ابعاد صادرات مخاطب
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ابعاد پشتیبانی شده در پرس و جوها به روش های Audience Export API Analytics Data. روش‌های گزارش اصلی (مثلاً RunReport ) مجموعه‌ای متفاوت از ابعاد و معیارها را نسبت به روش‌های صادرات مخاطب می‌پذیرند.
ابعاد
ابعاد زیر در صادرات مخاطب برای هر ملک قابل درخواست است. "نام API" را در قسمت name منبع AudienceDimension برای ستونی از بعد در پاسخ صادرات مخاطب مشخص کنید.
| نام API | نام رابط کاربری | توضیحات |
|---|
deviceId | شناسه دستگاه | یک شناسه مبتنی بر مرورگر یا مبتنی بر برنامه تلفن همراه برای یک وب سایت یا کاربر برنامه تلفن همراه منحصر به فرد با نام مستعار. برای کسب اطلاعات بیشتر، به شناسه دستگاه مراجعه کنید. |
isAdsPersonalizationAllowed | آیا شخصی سازی تبلیغات مجاز است؟ | اگر کاربری واجد شرایط شخصی‌سازی تبلیغات باشد، isAdsPersonalizationAllowed مقدار true را برمی‌گرداند. اگر کاربری برای شخصی‌سازی تبلیغات واجد شرایط نباشد، isAdsPersonalizationAllowed false را برمی‌گرداند.
isAdsPersonalizationAllowed برمی گرداند (not set) اگر Google Analytics نتواند برگرداند که آیا این کاربر واجد شرایط شخصی سازی تبلیغات است یا خیر. کاربرانی که در آنها isAdsPersonalizationAllowed برگردانده شده است (not set) ممکن است واجد شرایط تبلیغات شخصی شده باشند یا نباشند. برای تبلیغات شخصی‌شده، باید کاربرانی را که در آنها isAdsPersonalizationAllowed = (not set) را به عنوان isAdsPersonalizationAllowed = false در نظر بگیرید، زیرا در کلی‌ترین حالت، برخی از ردیف‌های (not set) شامل کاربرانی می‌شوند که برای شخصی‌سازی تبلیغات واجد شرایط نیستند.
کاربرانی که در آنها isAdsPersonalizationAllowed = false هنوز هم می توانند برای موارد استفاده غیر تبلیغاتی مانند آزمایش A/B و کاوش های داده استفاده شوند. |
isLimitedAdTracking | ردیابی تبلیغات محدود است | تنظیم محدودیت ردیابی آگهی دستگاه. مقادیر ممکن عبارتند از: true ، false و (not set) . اگر Google Analytics نتواند تنظیمات Limit Ad Tracking این دستگاه را برگرداند، isLimitedAdTracking برمی‌گرداند (not set) . |
userId | شناسه کاربری | شناسه کاربری که برای این کاربر در برچسب گذاری مشخص شده است. برای کسب اطلاعات بیشتر، به اندازه‌گیری فعالیت در پلتفرم‌ها با User-ID مراجعه کنید.
اگر جمع‌آوری داده‌های ارائه‌شده توسط کاربر روشن باشد، داده‌های ارائه‌شده توسط کاربر به همراه User-ID می‌توانند برای بهبود اندازه‌گیری به Google Analytics در برچسب‌گذاری ارسال شوند. برای کسب اطلاعات بیشتر، به جمع آوری داده های ارائه شده توسط کاربر مراجعه کنید. صرف نظر از اینکه داده های ارائه شده توسط کاربر برای دارایی شما روشن است یا خیر، userId شناسه کاربری مشخص شده در برچسب گذاری را برمی گرداند. |
،
ابعاد پشتیبانی شده در پرس و جوها به روش های Audience Export API Analytics Data. روش‌های گزارش اصلی (مثلاً RunReport ) مجموعه‌ای متفاوت از ابعاد و معیارها را نسبت به روش‌های صادرات مخاطب می‌پذیرند.
ابعاد
ابعاد زیر در صادرات مخاطب برای هر ملک قابل درخواست است. "نام API" را در قسمت name منبع AudienceDimension برای ستونی از بعد در پاسخ صادرات مخاطب مشخص کنید.
| نام API | نام رابط کاربری | توضیحات |
|---|
deviceId | شناسه دستگاه | یک شناسه مبتنی بر مرورگر یا مبتنی بر برنامه تلفن همراه برای یک وب سایت یا کاربر برنامه تلفن همراه منحصر به فرد با نام مستعار. برای کسب اطلاعات بیشتر، به شناسه دستگاه مراجعه کنید. |
isAdsPersonalizationAllowed | آیا شخصی سازی تبلیغات مجاز است؟ | اگر کاربری واجد شرایط شخصی‌سازی تبلیغات باشد، isAdsPersonalizationAllowed مقدار true را برمی‌گرداند. اگر کاربری برای شخصی‌سازی تبلیغات واجد شرایط نباشد، isAdsPersonalizationAllowed false را برمی‌گرداند.
isAdsPersonalizationAllowed برمی گرداند (not set) اگر Google Analytics نتواند برگرداند که آیا این کاربر واجد شرایط شخصی سازی تبلیغات است یا خیر. کاربرانی که در آنها isAdsPersonalizationAllowed برگردانده شده است (not set) ممکن است واجد شرایط تبلیغات شخصی شده باشند یا نباشند. برای تبلیغات شخصی‌شده، باید کاربرانی را که در آنها isAdsPersonalizationAllowed = (not set) را به عنوان isAdsPersonalizationAllowed = false در نظر بگیرید، زیرا در کلی‌ترین حالت، برخی از ردیف‌های (not set) شامل کاربرانی می‌شوند که برای شخصی‌سازی تبلیغات واجد شرایط نیستند.
کاربرانی که در آنها isAdsPersonalizationAllowed = false هنوز هم می توانند برای موارد استفاده غیر تبلیغاتی مانند آزمایش A/B و کاوش های داده استفاده شوند. |
isLimitedAdTracking | ردیابی تبلیغات محدود است | تنظیم محدودیت ردیابی آگهی دستگاه. مقادیر ممکن عبارتند از: true ، false و (not set) . اگر Google Analytics نتواند تنظیمات Limit Ad Tracking این دستگاه را برگرداند، isLimitedAdTracking برمی‌گرداند (not set) . |
userId | شناسه کاربری | شناسه کاربری که برای این کاربر در برچسب گذاری مشخص شده است. برای کسب اطلاعات بیشتر، به اندازه‌گیری فعالیت در پلتفرم‌ها با User-ID مراجعه کنید.
اگر جمع‌آوری داده‌های ارائه‌شده توسط کاربر روشن باشد، داده‌های ارائه‌شده توسط کاربر به همراه User-ID می‌توانند برای بهبود اندازه‌گیری به Google Analytics در برچسب‌گذاری ارسال شوند. برای کسب اطلاعات بیشتر، به جمع آوری داده های ارائه شده توسط کاربر مراجعه کنید. صرف نظر از اینکه داده های ارائه شده توسط کاربر برای دارایی شما روشن است یا خیر، userId شناسه کاربری مشخص شده در برچسب گذاری را برمی گرداند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
