REST Resource: properties.audiences

{
  "name": string,
  "displayName": string,
  "description": string,
  "membershipDurationDays": integer,
  "adsPersonalizationEnabled": boolean,
  "eventTrigger": {
    object (AudienceEventTrigger)
  },
  "exclusionDurationMode": enum (AudienceExclusionDurationMode),
  "filterClauses": [
    {
      object (AudienceFilterClause)
    }
  ],
  "createTime": string
}

string

النتائج فقط. اسم المورد لمورد "الجمهور" هذا. التنسيق: المواقع/{propertyId}/audiences/{audienceId}

string

مطلوب. الاسم المعروض للجمهور.

string

مطلوب. وصف الجمهور.

integer

مطلوب. غير قابل للتغيير. المدة التي يجب أن يظل فيها المستخدم ضمن شريحة الجمهور. ولا يمكن ضبطه على أكثر من 540 يومًا.

boolean

النتائج فقط. يتم ضبطه تلقائيًا من خلال "إحصاءات Google" على "خطأ" إذا كان هذا الجمهور من النوع "إعلانات غير مخصّصة" وتم استبعاده من تخصيص الإعلانات.

object (AudienceEventTrigger)

اختياريّ. تحدِّد هذه السياسة حدثًا لتسجيله عند انضمام مستخدِم إلى الجمهور. وفي حال ترك هذه السياسة بدون ضبط، لا يتم تسجيل أي حدث عند انضمام مستخدِم إلى الجمهور.

enum (AudienceExclusionDurationMode)

غير قابل للتغيير. تحدِّد هذه السياسة مدة استمرار الاستثناء للمستخدمين الذين يستوفون فلتر الاستثناء. يتم تطبيقه على جميع عبارات فلتر "استبعاد" ويتم تجاهله عندما لا تكون هناك عبارة فلتر "استبعاد" في "الجمهور".

object (AudienceFilterClause)

مطلوب. غير قابل للتغيير. قائمة بدون ترتيب. عبارات التصفية التي تعرِّف الجمهور. سيتمّ ربط جميع العبارات معًا.

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه إنشاء شريحة الجمهور

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

{
  "eventName": string,
  "logCondition": enum (LogCondition)
}

string

مطلوب. اسم الحدث الذي سيتم تسجيله

enum (LogCondition)

مطلوب. حالات تسجيل الحدث

{
  "clauseType": enum (AudienceClauseType),

  // Union field filter can be only one of the following:
  "simpleFilter": {
    object (AudienceSimpleFilter)
  },
  "sequenceFilter": {
    object (AudienceSequenceFilter)
  }
  // End of list of possible types for union field filter.
}

enum (AudienceClauseType)

مطلوب. تحدِّد هذه السمة ما إذا كانت عبارة عن فلتر تضمين أو استثناء.

object (AudienceSimpleFilter)

فلتر بسيط يجب أن يستوفيه المستخدم ليصبح عضوًا في الجمهور

object (AudienceSequenceFilter)

الفلاتر التي يجب أن تحدث بترتيب معيّن ليكون المستخدم عضوًا في شريحة الجمهور.

{
  "scope": enum (AudienceFilterScope),
  "filterExpression": {
    object (AudienceFilterExpression)
  }
}

enum (AudienceFilterScope)

مطلوب. غير قابل للتغيير. تُحدِّد نطاق هذا الفلتر.

object (AudienceFilterExpression)

مطلوب. غير قابل للتغيير. تعبير منطقي لمكوّنات الجمهور أو المقياس أو فلاتر الأحداث

{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (AudienceFilterExpressionList)
  },
  "orGroup": {
    object (AudienceFilterExpressionList)
  },
  "notExpression": {
    object (AudienceFilterExpression)
  },
  "dimensionOrMetricFilter": {
    object (AudienceDimensionOrMetricFilter)
  },
  "eventFilter": {
    object (AudienceEventFilter)
  }
  // End of list of possible types for union field expr.
}

object (AudienceFilterExpressionList)

قائمة بالتعبيرات التي ستتم مطابقتها مع بعضها البعض. ولا يمكن أن تحتوي إلا على AudienceFilterExpressions مع orGroup. يجب ضبط هذا الخيار على AudienceFilterExpression ذات المستوى الأعلى.

object (AudienceFilterExpressionList)

قائمة بالتعبيرات المطلوب إجراءها باستخدام OR. لا يمكن أن يحتوي على AudienceFilterExpressions مع andGroup أو orGroup.

object (AudienceFilterExpression)

تعبير فلتر يجب عدم إضافته (على سبيل المثال، معكوس أو متكامل). ولا يمكن أن تتضمّن سوى السمة OrMetricFilter. لا يمكن ضبط هذا الخيار على AudienceFilterExpression ذات المستوى الأعلى.

object (AudienceDimensionOrMetricFilter)

فلتر على سمة أو مقياس واحد لا يمكن ضبط هذا الخيار على AudienceFilterExpression ذات المستوى الأعلى.

object (AudienceEventFilter)

لإنشاء فلتر يطابق حدثًا معيّنًا. لا يمكن ضبط هذا الخيار على AudienceFilterExpression ذات المستوى الأعلى.

{
  "filterExpressions": [
    {
      object (AudienceFilterExpression)
    }
  ]
}

object (AudienceFilterExpression)

قائمة بتعبيرات فلاتر الجمهور

{
  "fieldName": string,
  "atAnyPointInTime": boolean,
  "inAnyNDayPeriod": integer,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}

string

مطلوب. غير قابل للتغيير. اسم السمة أو اسم المقياس المطلوب فلترته إذا كان اسم الحقل يشير إلى سمة أو مقياس مخصّصَين، ستتم إضافة بادئة نطاق إلى مقدّمة اسم المقياس أو السمات المخصّصة. لمزيد من المعلومات عن بادئات النطاق أو السمات/المقاييس المخصّصة، يُرجى الرجوع إلى مستندات Google Analytics Data API.

boolean

اختياريّ. يشير إلى ما إذا كان هذا الفلتر بحاجة إلى تقييم ديناميكي أم لا. وفي حال ضبطها على "صحيح"، ينضم المستخدمون إلى "الجمهور" إذا استوفوا الشرط (التقييم الثابت). في حال ترك هذه السياسة بدون ضبط أو ضبطها على "خطأ"، سيكون تقييم المستخدِم لشريحة الجمهور ديناميكيًا. تتمّ إضافة مستخدِمين إلى شريحة جمهور عندما يستوفون الشروط وبعد ذلك تتمّ إزالتهم إن لم يعودوا مستوفين لها.

لا يمكن ضبط ذلك إلا عندما يكون نطاق الجمهور ACROSS_ALL_SESSIONS.

integer

اختياريّ. في حال ضبطها، تحدّد الفترة الزمنية لتقييم البيانات بعدد الأيام. وفي حال ترك هذه السياسة بدون ضبط، يتم تقييم بيانات الجمهور وفقًا لبيانات الفترة منذ الإنشاء (على سبيل المثال، فترة زمنية غير محدودة).

على سبيل المثال، في حال ضبط هذه القيمة على يوم واحد، لن يتم تقييم سوى بيانات اليوم الحالي. تشير النقطة المرجعية إلى اليوم الحالي عندما يتم ضبط atAnyPointInTime بدون ضبط أو على false.

ولا يمكن ضبطها إلا عندما يكون نطاق الجمهور ACROSS_ALL_SESSIONS ولا يمكن أن يكون أكبر من 60 يومًا.

object (StringFilter)

فلتر لسمة من نوع سلسلة تتطابق مع نمط معيّن.

object (InListFilter)

فلتر لبُعد سلسلة يتطابق مع قائمة خيارات معيّنة.

object (NumericFilter)

فلتر للقيم الرقمية أو الزمنية على سمة أو مقياس

object (BetweenFilter)

فلتر للقيم الرقمية أو الزمنية بين قيم معيّنة في سمة أو مقياس

{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}

enum (MatchType)

مطلوب. نوع المطابقة لفلتر السلسلة.

string

مطلوب. قيمة السلسلة المطلوب المطابقة معها.

boolean

اختياريّ. إذا كانت القيمة هي true، تكون المطابقة حسّاسة لحالة الأحرف. إذا كانت القيمة "false"، تكون المطابقة غير حسّاسة لحالة الأحرف.

{
  "values": [
    string
  ],
  "caseSensitive": boolean
}

string

مطلوب. قائمة قيم السلسلة المحتملة المطلوب المطابقة معها. يجب ألا يكون الحقل فارغًا.

boolean

اختياريّ. إذا كانت القيمة هي true، تكون المطابقة حسّاسة لحالة الأحرف. إذا كانت القيمة "false"، تكون المطابقة غير حسّاسة لحالة الأحرف.

{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}

enum (Operation)

مطلوب. العملية المطبقة على فلتر رقمي.

object (NumericValue)

مطلوب. القيمة الرقمية أو التاريخ للمطابقة معها.

{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}

string (int64 format)

قيمة عدد صحيح.

number

قيمة مزدوجة

{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}

object (NumericValue)

مطلوب. يبدأ بهذا الرقم، بشكل شامل.

object (NumericValue)

مطلوب. ينتهي بهذا الرقم، بشكل شامل.

{
  "eventName": string,
  "eventParameterFilterExpression": {
    object (AudienceFilterExpression)
  }
}

string

مطلوب. غير قابل للتغيير. اسم الحدث المطلوب المطابقة معه.

object (AudienceFilterExpression)

اختياريّ. في حال تحديد هذا الفلتر، يتطابق مع الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلاتر المَعلمات. لا يمكن ضبط AudienceEventFilter داخل تعبير فلتر المَعلمات (على سبيل المثال، لا يمكن استخدام فلاتر الأحداث المتداخلة). يجب أن تكون هذه المجموعة واحدة من البعد أو مجموعة من الأبعاد أو المقاييس / notExpression. لا يمكن استخدام AND من OR. وإضافةً إلى ذلك، إذا كانت تتضمّن فلترًا لـ "eventCount"، فسيتم مراعاة هذا الفلتر فقط؛ فسيتم تجاهل جميع عوامل التصفية الأخرى.

{
  "scope": enum (AudienceFilterScope),
  "sequenceMaximumDuration": string,
  "sequenceSteps": [
    {
      object (AudienceSequenceStep)
    }
  ]
}

enum (AudienceFilterScope)

مطلوب. غير قابل للتغيير. تُحدِّد نطاق هذا الفلتر.

string (Duration format)

اختياريّ. تُحدِّد الفترة الزمنية التي يجب أن يحدث فيها التسلسل بالكامل.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

object (AudienceSequenceStep)

مطلوب. تمثّل هذه السمة تسلسل خطوات مُرتبًا. ويجب أن يُكمل المستخدم كل خطوة للانضمام إلى فلتر التسلسل.

{
  "scope": enum (AudienceFilterScope),
  "immediatelyFollows": boolean,
  "constraintDuration": string,
  "filterExpression": {
    object (AudienceFilterExpression)
  }
}

enum (AudienceFilterScope)

مطلوب. غير قابل للتغيير. تُستخدَم لتحديد نطاق هذه الخطوة.

boolean

اختياريّ. إذا كانت القيمة هي true، يجب أن يكون الحدث الذي يلبي هذه الخطوة هو الحدث التالي بعد تحقيق الحدث للخطوة الأخيرة. في حال تم ترك هذه السياسة بدون ضبط أو تم ضبط السياسة على "خطأ"، ستتّبع هذه الخطوة الخطوة السابقة بشكل غير مباشر. على سبيل المثال، قد تكون هناك أحداث بين الخطوة السابقة وهذه الخطوة. ويتم تجاهله في الخطوة الأولى.

string (Duration format)

اختياريّ. عند الضبط، يجب استيفاء هذه الخطوة ضمن RestricttDuration في الخطوة السابقة (على سبيل المثال، t[i] - t[i-1] <= RestricttDuration). وإذا لم يتم ضبط السياسة، لن يكون هناك شرط للمدة (تكون المدة غير محدودة فعليًا). ويتم تجاهله في الخطوة الأولى.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

object (AudienceFilterExpression)

مطلوب. غير قابل للتغيير. تعبير منطقي لفلاتر الحدث أو المقياس أو سمة الجمهور في كل خطوة.