جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
سمات تصدير الجمهور
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
السمات المتوافقة مع طلبات البحث في طُرق تصدير شرائح الجمهور في Analytics Data API
تقبل طرق إعداد التقارير الأساسية (RunReport
على سبيل المثال) مجموعة مختلفة من السمات والمقاييس
مقارنةً بأساليب تصدير شرائح الجمهور.
الأبعاد
يمكن طلب السمات التالية في عمليات تصدير شرائح الجمهور لأيّ موقع.
حدِّد "اسم واجهة برمجة التطبيقات" في حقل name لمورد
AudienceDimension
لعمود السمة في استجابة
تصدير الجمهور.
| اسم واجهة برمجة التطبيقات |
اسم واجهة المستخدم |
الوصف |
deviceId |
رقم تعريف الجهاز |
رقم تعريف متصفّح أو معرِّف مستند إلى تطبيق متوافق مع الأجهزة الجوّالة لمستخدِم فريد مجهول في موقع إلكتروني أو تطبيق متوافق مع الأجهزة الجوّالة. لمزيد من المعلومات، يُرجى الاطّلاع على رقم تعريف الجهاز. |
isAdsPersonalizationAllowed |
هل يُسمح بتخصيص الإعلانات؟ |
إذا كان المستخدِم مؤهَّلاً لتخصيص الإعلانات، يعرِض الحقل isAdsPersonalizationAllow القيمة true. إذا لم يكن المستخدِم مؤهَّلاً لتخصيص الإعلانات، يعرِض الحقل isAdsPersonalizationAllow القيمة false.
يعرِض الحقل isAdsPersonalizationAllowed القيمة (not set) إذا تعذّر على "إحصاءات Google" عرض ما إذا كان هذا المستخدِم مؤهَّلاً لتخصيص الإعلانات. بالنسبة إلى المستخدِمين الذين يعرِض الحقل isAdsPersonalizationAllowed القيمة (not set) بشأنهم، قد يكونون مؤهَّلين لعرض الإعلانات المخصّصة أو لا. بالنسبة إلى الإعلانات المخصّصة، يجب التعامل مع المستخدِمين الذين يعرض الحقل isAdsPersonalizationAllowed القيمة (not set) بشأنهم مثل الذين يعرض isAdsPersonalizationAllow القيمة false بشأنهم لأنّ بعض صفوف القيمة (not set) ستتضمّن بصفة عامة مستخدِمين غير مؤهَّلين لتخصيص الإعلانات.
إنّ بيانات المستخدمين الذين يعرض الحقل isAdsPersonalizationAllowed القيمة false بشأنهم لا يزال بالإمكان استخدامها في حالات الاستخدام غير الإعلانية مثل اختبار A/B واستكشافات البيانات. |
isLimitedAdTracking |
تتبُّع الإعلانات محدود |
إعداد "الحدّ من التتبُّع الإعلاني" في الجهاز. تشمل القيم المحتملة ما يلي: true وfalse و(not set). يعرض الحقل isLimitedAdTracking القيمة (not set) إذا لم تتمكّن "إحصاءات Google" من عرض قيمة الإعداد "تقييد التتبّع الإعلاني" على هذا الجهاز. |
userId |
رقم تعريف المستخدم |
رقم تعريف المستخدِم المحدّد لهذا المستخدِم في وضع العلامات. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة قياس النشاط على مختلف المنصّات باستخدام User-ID.
في حال تفعيل ميزة "جمع البيانات المقدَّمة من المستخدِم"، يمكن إرسال البيانات المقدَّمة من المستخدِم مع User-ID إلى "إحصاءات Google" في عملية وضع العلامات لتحسين عملية القياس. لمزيد من المعلومات، يُرجى الاطّلاع على جمع البيانات المقدَّمة من المستخدِم. بغض النظر عمّا إذا كانت البيانات المقدَّمة من المستخدِم مفعّلة لموقعك، تعرض userId رقم تعريف المستخدِم المحدّد في وضع العلامات. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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. |"]]
