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
  }
}
اسم الموقع القيمة الوصف Notes
accountId string رقم تعريف الحساب الذي ينتمي إليه هذا الفلتر.
advancedDetails object تفاصيل عن الفلتر من النوع "متقدم"
advancedDetails.caseSensitive boolean يشير هذا الحقل إلى ما إذا كانت تعبيرات الفلاتر حسّاسة لحالة الأحرف. قابل للكتابة
advancedDetails.extractA string تعبير يتم استخراجه من الحقل "أ". قابل للكتابة
advancedDetails.extractB string تعبير يتم استخراجه من الحقل "ب". قابل للكتابة
advancedDetails.fieldA string الحقل (أ). قابل للكتابة
advancedDetails.fieldAIndex integer فهرس السمة المخصصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_السمات. قابل للكتابة
advancedDetails.fieldARequired boolean يشير هذا الحقل إلى ما إذا كان الحقل A مطلوبًا للمطابقة. قابل للكتابة
advancedDetails.fieldB string الحقل (ب). قابل للكتابة
advancedDetails.fieldBIndex integer فهرس السمة المخصصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_السمات. قابل للكتابة
advancedDetails.fieldBRequired boolean تشير هذه السمة إلى ما إذا كان الحقل "ب" مطلوبًا للمطابقة. قابل للكتابة
advancedDetails.outputConstructor string التعبير المستخدم لإنشاء قيمة المخرجات. قابل للكتابة
advancedDetails.outputToField string حقل الإخراج قابل للكتابة
advancedDetails.outputToFieldIndex integer فهرس السمة المخصصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_السمات. قابل للكتابة
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_CITY،
    • TRANSACTION_AFFILIATION (المتجر أو الموقع الجغرافي للطلب)،
    • ITEM_NAME،
    • ITEM_CODE،
    • ITEM_VARIATION،
    • TRANSACTION_ID،
    • TRANSACTION_CURRENCY_CODE،
    • PRODUCT_ACTION_TYPE،
  • الجمهور/المستخدمون
    • BROWSER،
    • BROWSER_VERSION,
    • BROWSER_SIZE،
    • المنصة
    • PLATFORM_VERSION
    • LANGUAGE،
    • SCREEN_RESOLUTION،
    • SCREEN_COLORS،
    • JAVA_optional (الحقل المنطقي)،
    • FLASH_VERSION،
    • GEO_SPEED (سرعة الاتصال)،
    • VISITOR_TYPE،
    • GEO_Organization (مؤسسة مزوّد خدمة الإنترنت)
    • GEO_DOMAIN،
    • GEO_IP_ADDRESS،
    • GEO_IP_VERSION,
  • الموقع
    • GEO_COUNTRY،
    • GEO_AREA،
    • 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_VERSION،
    • SCREEN،
    • 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_السمات. قابل للكتابة
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 تفاصيل عامل التصفية من النوع "تضمين".
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_CITY،
    • TRANSACTION_AFFILIATION (المتجر أو الموقع الجغرافي للطلب)،
    • ITEM_NAME،
    • ITEM_CODE،
    • ITEM_VARIATION،
    • TRANSACTION_ID،
    • TRANSACTION_CURRENCY_CODE،
    • PRODUCT_ACTION_TYPE،
  • الجمهور/المستخدمون
    • BROWSER،
    • BROWSER_VERSION,
    • BROWSER_SIZE،
    • المنصة
    • PLATFORM_VERSION
    • LANGUAGE،
    • SCREEN_RESOLUTION،
    • SCREEN_COLORS،
    • JAVA_optional (الحقل المنطقي)،
    • FLASH_VERSION،
    • GEO_SPEED (سرعة الاتصال)،
    • VISITOR_TYPE،
    • GEO_Organization (مؤسسة مزوّد خدمة الإنترنت)
    • GEO_DOMAIN،
    • GEO_IP_ADDRESS،
    • GEO_IP_VERSION,
  • الموقع
    • GEO_COUNTRY،
    • GEO_AREA،
    • 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_VERSION،
    • SCREEN،
    • 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_السمات. قابل للكتابة
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 فهرس السمة المخصصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_السمات. قابل للكتابة
name string اسم هذا الفلتر قابل للكتابة
parentLink.href string أدرِج رابطًا إلى الحساب الذي ينتمي إليه هذا الفلتر.
parentLink.type string القيمة هي "analytics#account".
searchAndReplaceDetails object تفاصيل الفلتر من النوع SEARCH_AND_REPLACE.
searchAndReplaceDetails.caseSensitive boolean تحدِّد هذه السياسة ما إذا كان الفلتر حسّاسًا لحالة الأحرف. قابل للكتابة
searchAndReplaceDetails.field string الحقل المطلوب استخدامه في الفلتر قابل للكتابة
searchAndReplaceDetails.fieldIndex integer فهرس السمة المخصصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_السمات. قابل للكتابة
searchAndReplaceDetails.replaceString string العبارة المطلوب استبدال عبارة البحث بها. قابل للكتابة
searchAndReplaceDetails.searchString string عبارة البحث. قابل للكتابة
type string نوع هذا الفلتر القيم المحتملة هي include وEXCLUDE وLOWERCASE وCASE وSEARCH_AND_REPLACE وADVANCED. قابل للكتابة
updated datetime الوقت الذي تم فيه إجراء آخر تعديل على هذا الفلتر
uppercaseDetails object تفاصيل عامل التصفية من النوع UPPER.
uppercaseDetails.field string الحقل المطلوب استخدامه في الفلتر قابل للكتابة
uppercaseDetails.fieldIndex integer فهرس السمة المخصصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_السمات. قابل للكتابة

الطُرق

حذف
حذف فلتر معيّن.
الحصول على
عرض الفلاتر التي يمكن للمستخدم الوصول إليها.
إدراج
إنشاء فلتر جديد.
list
عرض جميع الفلاتر لحساب
حزمة
يؤدي هذا الإجراء إلى تعديل فلتر حالي. تدعم هذه الطريقة دلالات التصحيح.
تعديل
يؤدي هذا الإجراء إلى تعديل فلتر حالي.