Filters

مجموعة الفلاتر هي مجموعة من مصادر الفلاتر، يصف كل منها فلترًا يمكن تطبيقه على ملف شخصي.

للحصول على قائمة بطرق هذا المورد، راجع نهاية هذه الصفحة.

تمثيلات موارد

نموذج JSON لفلتر حساب في "إحصاءات Google".

{
  "id": string,
  "kind": "analytics#filter",
  "selfLink": string,
  "accountId": string,
  "name": string,
  "type": string,
  "created": datetime,
  "updated": datetime,
  "parentLink": {
    "type": "analytics#account",
    "href": string
  },
  "includeDetails": {
    "kind": "analytics#filterExpression",
    "field": string,
    "matchType": string,
    "expressionValue": string,
    "caseSensitive": boolean,
    "fieldIndex": integer
  },
  "excludeDetails": {
    "kind": "analytics#filterExpression",
    "field": string,
    "matchType": string,
    "expressionValue": string,
    "caseSensitive": boolean,
    "fieldIndex": integer
  },
  "lowercaseDetails": {
    "field": string,
    "fieldIndex": integer
  },
  "uppercaseDetails": {
    "field": string,
    "fieldIndex": integer
  },
  "searchAndReplaceDetails": {
    "field": string,
    "fieldIndex": integer,
    "searchString": string,
    "replaceString": string,
    "caseSensitive": boolean
  },
  "advancedDetails": {
    "fieldA": string,
    "fieldAIndex": integer,
    "extractA": string,
    "fieldB": string,
    "fieldBIndex": integer,
    "extractB": string,
    "outputToField": string,
    "outputToFieldIndex": integer,
    "outputConstructor": string,
    "fieldARequired": boolean,
    "fieldBRequired": boolean,
    "overrideOutputField": boolean,
    "caseSensitive": boolean
  }
}

اسم الموقع	القيمة	الوصف	ملاحظات
accountId	string	رقم تعريف الحساب الذي ينتمي إليه هذا الفلتر.
advancedDetails	object	تفاصيل الفلتر من النوع "متقدم"
advancedDetails.caseSensitive	boolean	تشير هذه الخاصية إلى ما إذا كانت تعبيرات الفلاتر حساسة لحالة الأحرف.	قابل للكتابة
advancedDetails.extractA	string	التعبير المطلوب استخراجه من الحقل "أ".	قابل للكتابة
advancedDetails.extractB	string	التعبير المطلوب استخراجه من الحقل "ب".	قابل للكتابة
advancedDetails.fieldA	string	الحقل (أ)	قابل للكتابة
advancedDetails.fieldAIndex	integer	فهرس البُعد المخصّص. مطلوبة إذا كان الحقل "المكوّن المخصّص".	قابل للكتابة
advancedDetails.fieldARequired	boolean	تشير إلى ما إذا كان الحقل "أ" مطلوبًا للمطابقة.	قابل للكتابة
advancedDetails.fieldB	string	الحقل (ب).	قابل للكتابة
advancedDetails.fieldBIndex	integer	فهرس البُعد المخصّص. مطلوبة إذا كان الحقل "المكوّن المخصّص".	قابل للكتابة
advancedDetails.fieldBRequired	boolean	تشير إلى ما إذا كان الحقل "ب" مطلوبًا للمطابقة أم لا.	قابل للكتابة
advancedDetails.outputConstructor	string	التعبير المستخدَم لإنشاء قيمة الناتج.	قابل للكتابة
advancedDetails.outputToField	string	حقل الناتج	قابل للكتابة
advancedDetails.outputToFieldIndex	integer	فهرس البُعد المخصّص. مطلوبة إذا كان الحقل "المكوّن المخصّص".	قابل للكتابة
advancedDetails.overrideOutputField	boolean	تشير هذه السمة إلى ما إذا كان يجب إلغاء القيمة الحالية لحقل الناتج، إن توفّرت، من خلال التعبير الناتج.	قابل للكتابة
created	datetime	وقت إنشاء هذا الفلتر
excludeDetails	nested object	تفاصيل الفلتر من النوع "استبعاد".
excludeDetails.caseSensitive	boolean	يتم تحديد ما إذا كان الفلتر حسّاسًا لحالة الأحرف.	قابل للكتابة
excludeDetails.expressionValue	string	فلترة قيمة التعبير	قابل للكتابة
excludeDetails.field	string	حقل للفلترة. القيم المتاحة: المحتوى وعدد الزيارات PAGE_REQUEST_URI، PAGE_HOSTNAME، PAGE_TITLE، إحالة Cost_DATA_URI (عنوان URL المستهدف للحملة)، HIT_TYPE، INTERNAL_SEARCH_TERM، INTERNAL_SEARCH_TYPE، SOURCE_PROPERTY_tracking_ID، الحملة أو المجموعة الإعلانية CAMPAIGN_SOURCE، CAMPAIGN_MEDIUM، CAMPAIGN_NAME، CAMPAIGN_AD_GROUP، CAMPAIGN_TERM، CAMPAIGN_CONTENT، CAMPAIGN_CODE، CAMPAIGN_REFERRAL_PATH، التجارة الإلكترونية TRANSACTION_COUNTRY، TRANSACTION_REGION، TRANSACTION_ITY، TRANSACTION_AFFILIATION (الموقع الجغرافي للمتجر أو الطلب) ITEM_NAME، ITEM_CODE، ITEM_VARIATION، TRANSACTION_ID، TRANSACTION_CURRENCY_CODE، PRODUCT_ACTION_TYPE، الجمهور/المستخدمون متصفّح BROWSER_Version، BROWSER_SIZE، النظام الأساسي PLATFORM_Version اللغة، SCREEN_RESOLUTION، SCREEN_COLORS، JAVA_ENABLED (حقل منطقي)، FLASH_DESCRIPTION، Geo_SPEED (سرعة الاتصال) VISITOR_TYPE، Geo_ORGANIZATION (مؤسسة مزوّد خدمة الإنترنت)، Geo_DOMAIN، Geo_IP_ADDRESS، Geo_IP_Version، الموقع الجغرافي Geo_COUNTRY، Geo_REGION، Geo_city، الحدث EVENT_CATEGORY، EVENT_ACTION، EVENT_LABEL، غير ذلك CUSTOM_FIELD_1، CUSTOM_FIELD_2، USER_DEFINED_VALUE، التطبيق APP_ID، APP_INSTALLER_ID، APP_NAME، APP_DESCRIPTION، الشاشة، IS_APP (حقل منطقي)، IS_FATAL_EXCEPTION (حقل منطقي)، EXCEPTION_DESCRIPTION، أجهزة الجوّال IS_MOBILE (حقل منطقي، متوقّف). استخدام DEVICE_CATEGORY=mobile)، IS_TABLET (حقل منطقي، متوقف. استخدم DEVICE_CATEGORY=tablet)، DEVICE_CATEGORY، MOBILE_HAS_QWERTY_KEYBOARD (حقل منطقي)، MOBILE_HAS_NFC_SUPPORT (حقل منطقي)، MOBILE_HAS_CELLULAR_Radio (حقل منطقي)، MOBILE_HAS_WIFI_SUPPORT (حقل منطقي)، MOBILE_BRAND_NAME، MOBILE_MODEL_NAME، MOBILE_MARKETING_NAME، MOBILE_POINTING_method، الشبكات الاجتماعية SOCIAL_Network، SOCIAL_ACTION، SOCIAL_ACTION_TARGET،	قابل للكتابة
excludeDetails.fieldIndex	integer	فهرس البُعد المخصّص. اضبط فقط إذا كان الحقل هو CUSTOM_DIMENSION.	قابل للكتابة
excludeDetails.kind	string	قيمة النوع لتعبير الفلتر
excludeDetails.matchType	string	نوع المطابقة لهذا الفلتر. القيم الممكنة هي BEGINS_WITH أو EQUAL أو ENDS_WITH أو CONTAINS أو MATCHES. يمكن أن تستخدم الفلاتر GEO_DOMAIN أو GEO_IP_ADDRESS أو PAGE_REQUEST_URI أو PAGE_HOSTNAME أي نوع مطابقة؛ ويجب أن تستخدم جميع الفلاتر الأخرى MATCHES.	قابل للكتابة
id	string	رقم تعريف الفلتر
includeDetails	nested object	تفاصيل الفلتر من النوع INCLUDE.
includeDetails.caseSensitive	boolean	يتم تحديد ما إذا كان الفلتر حسّاسًا لحالة الأحرف.	قابل للكتابة
includeDetails.expressionValue	string	فلترة قيمة التعبير	قابل للكتابة
includeDetails.field	string	حقل للفلترة. القيم المتاحة: المحتوى وعدد الزيارات PAGE_REQUEST_URI، PAGE_HOSTNAME، PAGE_TITLE، إحالة Cost_DATA_URI (عنوان URL المستهدف للحملة)، HIT_TYPE، INTERNAL_SEARCH_TERM، INTERNAL_SEARCH_TYPE، SOURCE_PROPERTY_tracking_ID، الحملة أو المجموعة الإعلانية CAMPAIGN_SOURCE، CAMPAIGN_MEDIUM، CAMPAIGN_NAME، CAMPAIGN_AD_GROUP، CAMPAIGN_TERM، CAMPAIGN_CONTENT، CAMPAIGN_CODE، CAMPAIGN_REFERRAL_PATH، التجارة الإلكترونية TRANSACTION_COUNTRY، TRANSACTION_REGION، TRANSACTION_ITY، TRANSACTION_AFFILIATION (الموقع الجغرافي للمتجر أو الطلب) ITEM_NAME، ITEM_CODE، ITEM_VARIATION، TRANSACTION_ID، TRANSACTION_CURRENCY_CODE، PRODUCT_ACTION_TYPE، الجمهور/المستخدمون متصفّح BROWSER_Version، BROWSER_SIZE، النظام الأساسي PLATFORM_Version اللغة، SCREEN_RESOLUTION، SCREEN_COLORS، JAVA_ENABLED (حقل منطقي)، FLASH_DESCRIPTION، Geo_SPEED (سرعة الاتصال) VISITOR_TYPE، Geo_ORGANIZATION (مؤسسة مزوّد خدمة الإنترنت)، Geo_DOMAIN، Geo_IP_ADDRESS، Geo_IP_Version، الموقع الجغرافي Geo_COUNTRY، Geo_REGION، Geo_city، الحدث EVENT_CATEGORY، EVENT_ACTION، EVENT_LABEL، غير ذلك CUSTOM_FIELD_1، CUSTOM_FIELD_2، USER_DEFINED_VALUE، التطبيق APP_ID، APP_INSTALLER_ID، APP_NAME، APP_DESCRIPTION، الشاشة، IS_APP (حقل منطقي)، IS_FATAL_EXCEPTION (حقل منطقي)، EXCEPTION_DESCRIPTION، أجهزة الجوّال IS_MOBILE (حقل منطقي، متوقّف). استخدام DEVICE_CATEGORY=mobile)، IS_TABLET (حقل منطقي، متوقف. استخدم DEVICE_CATEGORY=tablet)، DEVICE_CATEGORY، MOBILE_HAS_QWERTY_KEYBOARD (حقل منطقي)، MOBILE_HAS_NFC_SUPPORT (حقل منطقي)، MOBILE_HAS_CELLULAR_Radio (حقل منطقي)، MOBILE_HAS_WIFI_SUPPORT (حقل منطقي)، MOBILE_BRAND_NAME، MOBILE_MODEL_NAME، MOBILE_MARKETING_NAME، MOBILE_POINTING_method، الشبكات الاجتماعية SOCIAL_Network، SOCIAL_ACTION، SOCIAL_ACTION_TARGET،	قابل للكتابة
includeDetails.fieldIndex	integer	فهرس البُعد المخصّص. اضبط فقط إذا كان الحقل هو CUSTOM_DIMENSION.	قابل للكتابة
includeDetails.kind	string	قيمة النوع لتعبير الفلتر
includeDetails.matchType	string	نوع المطابقة لهذا الفلتر. القيم الممكنة هي BEGINS_WITH أو EQUAL أو ENDS_WITH أو CONTAINS أو MATCHES. يمكن أن تستخدم الفلاتر GEO_DOMAIN أو GEO_IP_ADDRESS أو PAGE_REQUEST_URI أو PAGE_HOSTNAME أي نوع مطابقة؛ ويجب أن تستخدم جميع الفلاتر الأخرى MATCHES.	قابل للكتابة
kind	string	نوع المورد لفلتر "إحصاءات Google".
lowercaseDetails	object	تفاصيل الفلتر من النوع LOWER.
lowercaseDetails.field	string	حقل لاستخدامه في الفلتر.	قابل للكتابة
lowercaseDetails.fieldIndex	integer	فهرس البُعد المخصّص. مطلوبة إذا كان الحقل "المكوّن المخصّص".	قابل للكتابة
name	string	اسم هذا الفلتر.	قابل للكتابة
parentLink	object	الرابط الرئيسي لهذا الفلتر. يشير إلى الحساب الذي ينتمي إليه هذا الفلتر.
parentLink.href	string	رابط إلى الحساب الذي ينتمي إليه هذا الفلتر
parentLink.type	string	القيمة هي "analytics;account#account".
searchAndReplaceDetails	object	تفاصيل الفلتر من النوع SEARCH_AND_REPLACE.
searchAndReplaceDetails.caseSensitive	boolean	يتم تحديد ما إذا كان الفلتر حسّاسًا لحالة الأحرف.	قابل للكتابة
searchAndReplaceDetails.field	string	حقل لاستخدامه في الفلتر.	قابل للكتابة
searchAndReplaceDetails.fieldIndex	integer	فهرس البُعد المخصّص. مطلوبة إذا كان الحقل "المكوّن المخصّص".	قابل للكتابة
searchAndReplaceDetails.replaceString	string	العبارة المطلوب استخدامها بدلاً من عبارة البحث.	قابل للكتابة
searchAndReplaceDetails.searchString	string	مصطلح البحث.	قابل للكتابة
selfLink	string	رابط لهذا الفلتر
type	string	نوع هذا الفلتر القيم الممكنة هي INCLUDE وEXCLUDE وLOWERCASE وfCASE وSEARCH_AND_REPLACE وADVANCED.	قابل للكتابة
updated	datetime	وقت آخر تعديل لهذا الفلتر
uppercaseDetails	object	تفاصيل الفلتر من النوع PRE.
uppercaseDetails.field	string	حقل لاستخدامه في الفلتر.	قابل للكتابة
uppercaseDetails.fieldIndex	integer	فهرس البُعد المخصّص. مطلوبة إذا كان الحقل "المكوّن المخصّص".	قابل للكتابة

الطُرق

حذف

حذف فلتر.

الحصول

يعرض فلاتر يمكن للمستخدم الوصول إليها.

إدراج

أنشئ فلترًا جديدًا.

list

سرد جميع الفلاتر لأحد الحسابات

رمز تصحيح

عدّل فلترًا حاليًا. تتيح هذه الطريقة دلالات التصحيح.

تحديث

عدّل فلترًا حاليًا.