- المورد: الجمهور
- AudienceEventTrigger
- LogCondition
- AudienceExclusionDurationMode
- AudienceFilterClause
- AudienceSimpleFilter
- AudienceFilterScope
- AudienceFilterExpression
- AudienceFilterExpressionList
- AudienceDimensionOrMetricFilter
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- العملية
- NumericValue
- BetweenFilter
- AudienceEventFilter
- AudienceSequenceFilter
- AudienceSequenceStep
- AudienceClauseType
- الطُرق
المرجع: الجمهور
رسالة مرجع تمثّل شريحة جمهور على "إحصاءات Google 4"
تمثيل JSON |
---|
{ "name": string, "displayName": string, "description": string, "membershipDurationDays": integer, "adsPersonalizationEnabled": boolean, "eventTrigger": { object ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد لمورد "الجمهور" هذا. التنسيق: المواقع/{propertyId}/audiences/{audienceId} |
displayName |
مطلوب. الاسم المعروض للجمهور. |
description |
مطلوب. وصف الجمهور. |
membershipDurationDays |
مطلوب. غير قابل للتغيير. المدة التي يجب أن يظل فيها المستخدم ضمن شريحة الجمهور. ولا يمكن ضبطه على أكثر من 540 يومًا. |
adsPersonalizationEnabled |
النتائج فقط. يتم ضبطه تلقائيًا من خلال "إحصاءات Google" على "خطأ" إذا كان هذا الجمهور من النوع "إعلانات غير مخصّصة" وتم استبعاده من تخصيص الإعلانات. |
eventTrigger |
اختياريّ. تحدِّد هذه السياسة حدثًا لتسجيله عند انضمام مستخدِم إلى الجمهور. وفي حال ترك هذه السياسة بدون ضبط، لا يتم تسجيل أي حدث عند انضمام مستخدِم إلى الجمهور. |
exclusionDurationMode |
غير قابل للتغيير. لتحديد مدة استمرار الاستبعاد للمستخدمين الذين يستوفون فلتر الاستبعاد. يتم تطبيقه على جميع عبارات فلتر "استبعاد" ويتم تجاهله عندما لا تكون هناك عبارة فلتر "استبعاد" في "الجمهور". |
filterClauses[] |
مطلوب. غير قابل للتغيير. قائمة بدون ترتيب. عبارات التصفية التي تعرِّف الجمهور. سيتمّ ربط جميع العبارات معًا. |
createTime |
النتائج فقط. الوقت الذي تم فيه إنشاء شريحة الجمهور طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
AudienceEventTrigger
تحدِّد هذه السياسة حدثًا لتسجيله عند انضمام مستخدِم إلى الجمهور.
تمثيل JSON |
---|
{
"eventName": string,
"logCondition": enum ( |
الحقول | |
---|---|
eventName |
مطلوب. اسم الحدث الذي سيتم تسجيله |
logCondition |
مطلوب. حالات تسجيل الحدث |
LogCondition
تحدِّد هذه السياسة وقت تسجيل الحدث.
عمليات التعداد | |
---|---|
LOG_CONDITION_UNSPECIFIED |
لم يتم تحديد شرط السجلّ. |
AUDIENCE_JOINED |
يجب عدم تسجيل الحدث إلا عند انضمام مستخدِم. |
AUDIENCE_MEMBERSHIP_RENEWED |
يجب تسجيل الحدث كلما تم استيفاء شرط الجمهور، حتى إذا كان المستخدم عضوًا في شريحة الجمهور. |
AudienceExclusionDurationMode
لتحديد مدة استمرار الاستبعاد للمستخدمين الذين يستوفون فلتر الاستبعاد.
عمليات التعداد | |
---|---|
AUDIENCE_EXCLUSION_DURATION_MODE_UNSPECIFIED |
لم يتم تحديده. |
EXCLUDE_TEMPORARILY |
استبعاد المستخدِمين من الجمهور خلال الفترات التي يستوفون فيها عبارة الفلتر. |
EXCLUDE_PERMANENTLY |
استبعِد المستخدِمين من "الجمهور" إذا استوفوا عبارة الفلتر في أيّ وقت. |
AudienceFilterClause
عبارة لتحديد فلتر بسيط أو فلتر تسلسلي. يمكن أن يكون الفلتر شاملاً (على سبيل المثال، يتم تضمين المستخدمين الذين يستوفون عبارة الفلتر في "الجمهور") أو حصرية (على سبيل المثال، يتم استبعاد المستخدمين الذين يستوفون عبارة الفلتر من "الجمهور").
تمثيل JSON |
---|
{ "clauseType": enum ( |
الحقول | |
---|---|
clauseType |
مطلوب. تحدِّد هذه السمة ما إذا كانت عبارة عن فلتر تضمين أو استثناء. |
حقل الاتحاد يمكن أن يكون |
|
simpleFilter |
فلتر بسيط يجب أن يستوفيه المستخدم ليصبح عضوًا في شريحة الجمهور |
sequenceFilter |
الفلاتر التي يجب أن تحدث بترتيب معيّن ليكون المستخدم عضوًا في شريحة الجمهور. |
AudienceSimpleFilter
تحدِّد هذه السياسة فلترًا بسيطًا يجب أن يستوفيه المستخدم ليصبح عضوًا في شريحة الجمهور.
تمثيل JSON |
---|
{ "scope": enum ( |
الحقول | |
---|---|
scope |
مطلوب. غير قابل للتغيير. تُحدِّد نطاق هذا الفلتر. |
filterExpression |
مطلوب. غير قابل للتغيير. تعبير منطقي لمكوّنات الجمهور أو المقياس أو فلاتر الأحداث |
AudienceFilterScope
تُحدِّد كيفية تقييم أهلية المستخدِمين للانضمام إلى شريحة جمهور.
عمليات التعداد | |
---|---|
AUDIENCE_FILTER_SCOPE_UNSPECIFIED |
لم يتم تحديد النطاق. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_EVENT |
ينضم المستخدم إلى "الجمهور" في حال استيفاء شرط الفلتر ضمن حدث واحد. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_SESSION |
يمكن للمستخدم الانضمام إلى "الجمهور" في حال استيفاء شرط الفلتر خلال جلسة واحدة. |
AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS |
ينضم المستخدم إلى "الجمهور" في حال استيفاء شرط الفلتر من قِبل أي حدث في أي جلسة. |
AudienceFilterExpression
تعبير منطقي لمكوّنات الجمهور أو المقياس أو فلاتر الأحداث
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد expr . التعبير المطبّق على أحد الفلاتر يمكن أن يكون expr واحدًا فقط مما يلي: |
|
andGroup |
قائمة بالتعبيرات التي ستتم مطابقتها مع بعضها البعض. ولا يمكن أن تحتوي إلا على AudienceFilterExpressions مع orGroup. يجب ضبط هذا الخيار على AudienceFilterExpression ذات المستوى الأعلى. |
orGroup |
قائمة بالتعبيرات المطلوب إجراءها باستخدام OR. لا يمكن أن يحتوي على AudienceFilterExpressions مع andGroup أو orGroup. |
notExpression |
تعبير فلتر يجب عدم إضافته (على سبيل المثال، معكوس أو متكامل). ولا يمكن أن تتضمّن سوى السمة OrMetricFilter. لا يمكن ضبط هذا الخيار على AudienceFilterExpression ذات المستوى الأعلى. |
dimensionOrMetricFilter |
فلتر على سمة أو مقياس واحد لا يمكن ضبط هذا الخيار على AudienceFilterExpression ذات المستوى الأعلى. |
eventFilter |
لإنشاء فلتر يطابق حدثًا معيّنًا. لا يمكن ضبط هذا الخيار على AudienceFilterExpression ذات المستوى الأعلى. |
AudienceFilterExpressionList
قائمة بتعبيرات فلاتر الجمهور
تمثيل JSON |
---|
{
"filterExpressions": [
{
object ( |
الحقول | |
---|---|
filterExpressions[] |
قائمة بتعبيرات فلاتر الجمهور |
AudienceDimensionOrMetricFilter
فلتر معيّن لسمة أو مقياس واحد
تمثيل JSON |
---|
{ "fieldName": string, "atAnyPointInTime": boolean, "inAnyNDayPeriod": integer, // Union field |
الحقول | |
---|---|
fieldName |
مطلوب. غير قابل للتغيير. اسم السمة أو اسم المقياس المطلوب فلترته إذا كان اسم الحقل يشير إلى سمة أو مقياس مخصّصَين، ستتم إضافة بادئة نطاق إلى مقدّمة اسم المقياس أو السمات المخصّصة. لمزيد من المعلومات عن بادئات النطاق أو السمات/المقاييس المخصّصة، يُرجى الرجوع إلى مستندات Google Analytics Data API. |
atAnyPointInTime |
اختياريّ. يشير إلى ما إذا كان هذا الفلتر بحاجة إلى تقييم ديناميكي أم لا. وفي حال ضبطها على "صحيح"، ينضم المستخدمون إلى "الجمهور" إذا استوفوا الشرط (التقييم الثابت). في حال ترك هذه السياسة بدون ضبط أو ضبطها على "خطأ"، سيكون تقييم المستخدِم لشريحة الجمهور ديناميكيًا. تتمّ إضافة مستخدِمين إلى شريحة جمهور عندما يستوفون الشروط وبعد ذلك تتمّ إزالتهم إن لم يعودوا مستوفين لها. لا يمكن ضبط ذلك إلا عندما يكون نطاق الجمهور ACROSS_ALL_SESSIONS. |
inAnyNDayPeriod |
اختياريّ. في حال ضبطها، تحدّد الفترة الزمنية لتقييم البيانات بعدد الأيام. وفي حال ترك هذه السياسة بدون ضبط، يتم تقييم بيانات الجمهور وفقًا لبيانات الفترة منذ الإنشاء (على سبيل المثال، فترة زمنية غير محدودة). على سبيل المثال، في حال ضبط هذه السياسة على يوم واحد، لن يتم تقييم سوى بيانات اليوم الحالي. تشير النقطة المرجعية إلى اليوم الحالي عندما يتم ضبط atAnyPointInTime بدون ضبط أو على false. ولا يمكن ضبطها إلا عندما يكون نطاق الجمهور ACROSS_ALL_SESSIONS ولا يمكن أن يكون أكبر من 60 يومًا. |
حقل الاتحاد one_filter . أحد الفلاتر المذكورة أعلاه يمكن أن يكون one_filter واحدًا فقط مما يلي: |
|
stringFilter |
فلتر لسمة من نوع سلسلة تتطابق مع نمط معيّن. |
inListFilter |
فلتر لبُعد سلسلة يتطابق مع قائمة خيارات معيّنة. |
numericFilter |
فلتر للقيم الرقمية أو الزمنية على سمة أو مقياس |
betweenFilter |
فلتر للقيم الرقمية أو الزمنية بين قيم معيّنة في سمة أو مقياس |
StringFilter
فلتر لسمة من نوع سلسلة تتطابق مع نمط معيّن.
تمثيل JSON |
---|
{
"matchType": enum ( |
الحقول | |
---|---|
matchType |
مطلوب. نوع المطابقة لفلتر السلسلة. |
value |
مطلوب. قيمة السلسلة المطلوب المطابقة معها. |
caseSensitive |
اختياريّ. إذا كانت القيمة هي true، تكون المطابقة حسّاسة لحالة الأحرف. إذا كانت القيمة "false"، تكون المطابقة غير حسّاسة لحالة الأحرف. |
MatchType
نوع المطابقة لفلتر السلسلة.
عمليات التعداد | |
---|---|
MATCH_TYPE_UNSPECIFIED |
غير محدّد |
EXACT |
مطابقة تامة لقيمة السلسلة. |
BEGINS_WITH |
تبدأ بقيمة السلسلة. |
ENDS_WITH |
ينتهي بقيمة السلسلة. |
CONTAINS |
يحتوي على قيمة السلسلة. |
FULL_REGEXP |
يتطابق التعبير العادي الكامل مع قيمة السلسلة. |
InListFilter
فلتر لبُعد سلسلة يتطابق مع قائمة خيارات معيّنة.
تمثيل JSON |
---|
{ "values": [ string ], "caseSensitive": boolean } |
الحقول | |
---|---|
values[] |
مطلوب. قائمة قيم السلسلة المحتملة المطلوب المطابقة معها. يجب ألا يكون الحقل فارغًا. |
caseSensitive |
اختياريّ. إذا كانت القيمة هي true، تكون المطابقة حسّاسة لحالة الأحرف. إذا كانت القيمة "false"، تكون المطابقة غير حسّاسة لحالة الأحرف. |
NumericFilter
فلتر للقيم الرقمية أو الزمنية على سمة أو مقياس
تمثيل JSON |
---|
{ "operation": enum ( |
الحقول | |
---|---|
operation |
مطلوب. العملية المطبقة على فلتر رقمي. |
value |
مطلوب. القيمة الرقمية أو التاريخ المطلوب المطابقة معها. |
العملية
العملية المطبقة على فلتر رقمي.
عمليات التعداد | |
---|---|
OPERATION_UNSPECIFIED |
غير محدد |
EQUAL |
يساوي |
LESS_THAN |
أقل من. |
GREATER_THAN |
أكبر من. |
NumericValue
لتمثيل رقم.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد one_value . واحدة من قيمة عددية. يمكن أن يكون one_value واحدًا فقط مما يلي: |
|
int64Value |
قيمة عدد صحيح. |
doubleValue |
قيمة مزدوجة |
BetweenFilter
فلتر للقيم الرقمية أو الزمنية بين قيم معيّنة في سمة أو مقياس
تمثيل JSON |
---|
{ "fromValue": { object ( |
الحقول | |
---|---|
fromValue |
مطلوب. يبدأ بهذا الرقم (ضمنًا). |
toValue |
مطلوب. ينتهي بهذا الرقم، بشكل شامل. |
AudienceEventFilter
فلتر يطابق الأحداث لاسم حدث واحد في حال تحديد مَعلمة حدث، ستتطابق فقط المجموعة الفرعية من الأحداث التي تتطابق مع كلّ من اسم الحدث الفردي وتعبيرات فلتر المَعلمات مع فلتر الأحداث هذا.
تمثيل JSON |
---|
{
"eventName": string,
"eventParameterFilterExpression": {
object ( |
الحقول | |
---|---|
eventName |
مطلوب. غير قابل للتغيير. اسم الحدث المطلوب المطابقة معه. |
eventParameterFilterExpression |
اختياريّ. في حال تحديد هذا الفلتر، يتطابق مع الأحداث التي تتطابق مع اسم الحدث الفردي وتعبيرات فلاتر المَعلمات. لا يمكن ضبط AudienceEventFilter داخل تعبير فلتر المَعلمات (على سبيل المثال، لا يمكن استخدام فلاتر الأحداث المتداخلة). يجب أن تكون هذه المجموعة واحدة من البعد أو مجموعة من الأبعاد أو المقاييس / notExpression. لا يمكن استخدام AND من OR. وإضافةً إلى ذلك، إذا كانت تتضمّن فلترًا لـ "eventCount"، فسيتم مراعاة هذا الفلتر فقط؛ فسيتم تجاهل جميع عوامل التصفية الأخرى. |
AudienceSequenceFilter
يحدِّد الفلاتر التي يجب أن تحدث بترتيب معيّن ليصبح المستخدِم عضوًا في شريحة الجمهور.
تمثيل JSON |
---|
{ "scope": enum ( |
الحقول | |
---|---|
scope |
مطلوب. غير قابل للتغيير. تُحدِّد نطاق هذا الفلتر. |
sequenceMaximumDuration |
اختياريّ. تُحدِّد الفترة الزمنية التي يجب أن يحدث فيها التسلسل بالكامل. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
sequenceSteps[] |
مطلوب. تمثّل هذه السمة تسلسل خطوات مُرتبًا. ويجب أن يُكمل المستخدم كل خطوة للانضمام إلى فلتر التسلسل. |
AudienceSequenceStep
شرط يجب أن يحدث بترتيب الخطوات المحدّد حتى يتطابق هذا المستخدم مع التسلسل.
تمثيل JSON |
---|
{ "scope": enum ( |
الحقول | |
---|---|
scope |
مطلوب. غير قابل للتغيير. تُستخدَم لتحديد نطاق هذه الخطوة. |
immediatelyFollows |
اختياريّ. إذا كانت القيمة هي true، يجب أن يكون الحدث الذي يلبي هذه الخطوة هو الحدث التالي بعد تحقيق الحدث للخطوة الأخيرة. في حال تم ترك هذه السياسة بدون ضبط أو تم ضبط السياسة على "خطأ"، ستتّبع هذه الخطوة الخطوة السابقة بشكل غير مباشر. على سبيل المثال، قد تكون هناك أحداث بين الخطوة السابقة وهذه الخطوة. ويتم تجاهله في الخطوة الأولى. |
constraintDuration |
اختياريّ. عند الضبط، يجب استيفاء هذه الخطوة ضمن RestricttDuration في الخطوة السابقة (على سبيل المثال، t[i] - t[i-1] <= RestricttDuration). وإذا لم يتم ضبط السياسة، لن يكون هناك شرط للمدة (تكون المدة غير محدودة فعليًا). ويتم تجاهله في الخطوة الأولى. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بـ " |
filterExpression |
مطلوب. غير قابل للتغيير. تعبير منطقي لفلاتر الحدث أو المقياس أو سمة الجمهور في كل خطوة. |
AudienceClauseType
تحدِّد هذه السمة ما إذا كانت عبارة عن فلتر تضمين أو استثناء.
عمليات التعداد | |
---|---|
AUDIENCE_CLAUSE_TYPE_UNSPECIFIED |
نوع عبارة غير محدَّد |
INCLUDE |
سيتم تضمين المستخدِمين في "الجمهور" في حال استيفاء عبارة الفلتر. |
EXCLUDE |
سيتم استبعاد المستخدِمين من "الجمهور" في حال استيفاء عبارة الفلتر. |
الطُرق |
|
---|---|
|
أرشفة شريحة جمهور على أحد المواقع |
|
ينشئ شريحة جمهور. |
|
ابحث عن شريحة جمهور واحدة. |
|
يسرد شرائح الجمهور في أحد المواقع. |
|
تعديل شريحة جمهور على أحد المواقع. |