قواعد الجماهير

تحدد قواعد الجماهير ما إذا كان شخص ما قد أضاف جمهورك المخصص. يتم تطبيق القواعد إما على عنوان URL للمُحيل أو أحداث وبيانات معينة.

قدِّم قواعدك في صورة سلاسل مشفرة باستخدام JSON ومصممة على النحو الآتي:

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

القيود

  • يمكن لكل جمهور تحديد 10 قواعد كحد أقصى في قاعدة الجمهور. يتضمن ذلك عدد rules في inclusions أو exclusions.
  • يمكن لكل قاعدة تحديد 100 فلتر كحد أقصى، معروفة كعُقد طرفية.

بنية قواعد الجماهير

لتحديد إحدى قواعد الجماهير، يجب اتباع البنية التالية:

rule: {
   "inclusions": <RULE_SET>,
   "exclusions": <RULE_SET>,
}

الحقول المتوفرة

الاسم الوصف

inclusions

النوع: String (سلسلة)

مطلوب.

سلسلة JSON الخاصة بمجموعة القواعد والتي تحدد التضمين. راجع بنية مجموعة القواعد.

exclusions

النوع: String (سلسلة)

مطلوب.

سلسلة JSON الخاصة بمجموعة القواعد والتي تحدد الاستبعاد. راجع بنية مجموعة القواعد.

بنية مجموعة القواعد

اتبع هذه البنية لكل مجموعة قواعد:

{
  "operator" : <BOOLEAN_OPERATOR>,
  "rules" : <JSON_RULE>,
}

الحقول المتوفرة

الاسم الوصف

operator

النوع: string (السلسلة)

مطلوب.

and أو or.

rules

النوع: string (السلسلة)

مطلوب.

سلسلة قواعد JSON (مصفوفة القواعد). راجع بنية قواعد التضمين والاستبعاد.

بنية قواعد التضمين والاستبعاد

اتبع هذه البنية لكل قاعدة تضمين أو استبعاد:

{
  "event_sources" : <EVENT_SOURCE_DEFINITION>, 
  "retention_seconds" : <SECONDS>,
  "filter" : <FILTER>,
  "aggregation" : <AGGREGATION>, 
}

يُعد كل من aggregation وretention_seconds حقلين قابلين للتعديل. ومع ذلك فإن تعديل الحقلين aggregation وretention_seconds لا يؤدي إلى مسح الجمهور. وسيظل فقط الأشخاص الذين يطابقون التجميع/القاعدة القديمة منضمين للجمهور حتى تنتهي المدة المحددة.

الحقول المتوفرة

الاسم الوصف

event_sources

النوع: String (سلسلة)

مطلوب.

كائن JSON يحتوي على id وtype.


يمكن إضافة المزيد من مصادر الأحداث إلى type باستخدام قائمة مفصولة بفواصل "store_visits,pixel,app".

retention_seconds

النوع: Integer (عدد صحيح)

مطلوب.

يجب أن يكون العدد الصحيح (بالثواني) لنافذة الاحتفاظ بالجمهور أقل من retention_days. الحد الأدنى=1؛ الحد الأقصى=365 يومًا

filter

النوع: String (سلسلة)

مطلوب.

سلسلة JSON الخاصة بقواعد الفلتر. راجع الفلاتر.

aggregation

النوع: Integer (عدد صحيح)

اختياري.

سلسلة JSON لدوال التجميع. راجع دوال التجميع.

الفلاتر

تتبع الفلترة هذا التنسيق العام:

"filter" : {
  "operator": <BOOLEAN_OPERATOR>,
  "filters": <FILTER_SET>,
  }

الحقول المتوفرة

الاسم الوصف

operator

النوع: string (السلسلة)

مطلوب.

and أو or

filters

النوع: string (السلسلة)

مطلوب.

مصفوفة كائنات JSON الخاصة بقواعد الفلترة. راجع بنية قواعد الفلترة.

بنية مجموعة الفلاتر

{
    "field": <FIELD>,
    "operator": <COMPARISON_OPERATOR>,
    "value": <VALUE>,
}

الحقول المتوفرة

الاسم الوصف

field

النوع: String (سلسلة)

مطلوب.


  • بالنسبة إلى الجماهير المخصصة لمواقع الويب، استخدم 'event' إذا كان الفلتر مستخدمًا لتحديد حدث. وتتوفر المعلمات التي تطابق الأحداث التي يتم إرسالها بواسطة البيكسل (على سبيل المثال 'ViewContent'، 'Purchase').
  • بالنسبة إلى الجماهير المخصصة لتطبيقات الهواتف المحمولة، استخدم 'event' إذا كان الفلتر مستخدمًا لتحديد حدث. المعلمات التي تطابق أحداث التطبيق التي يتم إرسالها بواسطة التطبيق؛ على سبيل المثال، "_appVersion" و"_value" وهكذا.

operator

النوع: String (سلسلة)

مطلوب.

  • =
  • !=
  • >=
  • >
  • <=
  • <
  • i_contains
  • i_not_contains
  • contains
  • not_contains
  • is_any
  • is_not_any
  • i_is_any
  • i_is_not_any
  • i_starts_with
  • starts_with
  • "regex_match"[INFO]

إذا تم تعيين field إلى event، فيجب استخدام =.

value

النوع: String (سلسلة)

مطلوب.

إذا تم تعيين السمة field إلى "event"، فيجب تعيين value إلى اسم حدث. استخدم واجهة API حدث التطبيق للاطلاع على أحداث ومعلمات التطبيق التي تم الإبلاغ عنها من قِبل التطبيق.

دوال التجميع

يمكنك إنشاء جماهير مخصصة استنادًا إلى معدل التكرار وقوة السلوك باستخدام aggregation في حقل قاعدة الجمهور. ومن خلال هذا، نحدد دالة تجميع، على سبيل المثال:

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

الحقول المتوفرة

الاسم الوصف

type

النوع: String (سلسلة)

مطلوب.

نوع دالة التجميع.

  • تتوفر الدوال الآتية للجماهير المخصصة لمواقع الويب: 'count' و'sum' و'avg' و'min' و'max' و'time_spent' و'last_event_time_field'.
  • تتوفر الدوال الآتية للجماهير المخصصة لتطبيقات الهواتف المحمولة: "count" و"sum" و"avg" و"min" و"max".

config

مطلوب من أنواع معيّنة من دوال التجميع.

method

النوع: String (سلسلة)

اختياري.

"absolute" الذي يعني إضافة الأشخاص الذين سجّلوا أحداثًا في النطاق المحدد، أو "percentile" الذي يعني إضافة الأشخاص من نطاق نسبة مئوية محدد. إذا حددت percentile، فمن المفترض ألا يكون عامل التشغيل سوى in_range أو not_in_range.

field

النوع: String (سلسلة)

مطلوب. ما لم يكن النوع هو count.

المعلمة التي يتم تطبيق دالة التجميع عليها.

operator

النوع: String (سلسلة)

مطلوب.

= و!= و>= و> و<= و< وin_range وnot_in_range

value

النوع: String (سلسلة)

مطلوب.

القيمة المتوقعة للمعلمة.

على سبيل المثال:

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

عوامل تشغيل المقارنة

عامل التشغيل الوصف

> أو gt

صحيح إذا كانت قيمة معلمة الحدث أكبر من القيمة المحددة.

>= أو gte

صحيح إذا كانت قيمة معلمة الحدث أكبر من أو تساوي القيمة المحددة.

< أو lt

صحيح إذا كانت قيمة معلمة الحدث أقل من القيمة المحددة.

<= أو lte

صحيح إذا كانت قيمة معلمة الحدث أقل من أو تساوي القيمة المحددة.

= أو eq

صحيح إذا كانت قيمة معلمة الحدث تساوي القيمة المحددة. ملاحظة: هذا مكافئ لعدم تحديد أي عامل تشغيل مطلقًا؛ بمعنى أن "'x' : { 'eq' : 'y' }" هو نفسه "'x' : 'y' }.

!= أو neq

صحيح إذا كانت قيمة معلمة الحدث لا تساوي القيمة المحددة.

contains

صحيح إذا كانت قيمة معلمة الحدث، كسلسلة، تحتوي على السلسلة المحددة. القيمة "shoe12345" تستوفي 'contains' إذا كانت القيمة المحددة هي 'shoe'.

not_contains

صحيح إذا كانت قيمة معلمة الحدث، كسلسلة، لا تحتوي على السلسلة المحددة. القيمة "shoe12345" تستوفي 'not_contains' إذا كانت القيمة المحددة هي 'purse'.

i_contains

يحتوي على، غير حساس بالنسبة لحالة الأحرف

i_not_contains

لا يحتوي على، غير حساس بالنسبة لحالة الأحرف

is_any

صحيح إذا كانت قيمة معلمة الحدث تطابق أي سلاسل في مصفوفة معينة.

is_not_any

صحيح إذا كانت قيمة معلمة الحدث لا تطابق أي سلاسل في مصفوفة محددة.

i_is_any

'is_any'، غير حساس بالنسبة لحالة الأحرف.

i_is_not_any

'is_not_any'، غير حساس بالنسبة لحالة الأحرف

starts_with

صحيح إذا كانت قيمة معلمة الحدث تبدأ بالسلسلة المحددة

i_starts_with

"starts_with"، غير حساس بالنسبة لحالة الأحرف

regex_match

يطابق تعبيرًا عاديًا مثل \"example\.com.*purchase$\". يتم دعم التدقيق النحوي PCRE تمامًا

أمثلة

الجماهير المخصصة لمواقع الويب

مطابقة جميع عناوين URL المرجعية التي تحتوي على السلسلة shoes (أحذية) في آخر 30 يومًا:

{
    "inclusions": {
        "operator": "or",
        "rules": [
            {
                "event_sources": [
                    {
                        "type": "pixel",
                        "id": "<PIXEL_ID>",
                    }
                ],
                "retention_seconds": 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "url",
                            "operator": "i_contains",
                            "value": "shoes"
                        }
                    ]
                },
            }
        ]
    }
}

مطابقة أحداث ViewContent التي يكون سعر الصنف فيها أكبر من أو يساوي 100 دولار أمريكي في آخر 30 يومًا. يجب استخدام هذه القاعدة في الحدث التالي:

_fbq.push([ 'track', 'ViewContent', { productId: 1234, category: 'Men > Shoes', price: 199 } ]);
{
    "inclusions": {
        "operator": "or",
        "rules": [
            {
                "event_sources": [
                    {
                        "type": "pixel",
                        "id": "<PIXEL_ID>"
                    }
                ],
                "retention_seconds": 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "eq",
                            "value": "ViewContent"
                        },
                        {
                            "operator": "or",
                            "filters": [
                                {
                                    "field": "price",
                                    "operator": ">=",
                                    "value": "100"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

الجماهير المخصصة لتطبيقات الهواتف المحمولة

راجع الجماهير المخصصة لتطبيقات الهواتف المحمولة، مثال لقواعد الجماهير المخصصة.

عوامل التشغيل والبيانات أو الأحداث

تحتوي القواعد على عوامل التشغيل والبيانات أو الأحداث التالية:

عوامل التشغيل نوع الفلتر

i_contains

يحتوي على سلسلة فرعية، غير حساس بالنسبة لحالة الأحرف

i_not_contains

لا يحتوي على سلسلة فرعية، غير حساس بالنسبة لحالة الأحرف

contains

يحتوي على سلسلة فرعية، حساس بالنسبة لحالة الأحرف

not_contains

لا يحتوي على سلسلة فرعية، حساس بالنسبة لحالة الأحرف

eq

يساوي، حساس بالنسبة لحالة الأحرف

neq

لا يساوي، حساس بالنسبة لحالة الأحرف

lt

أقل من، حقول رقمية فقط

lte

أقل من أو يساوي، حقول رقمية فقط

gt

أكبر من، حقول رقمية فقط

gte

أكبر من أو يساوي، حقول رقمية فقط

regex_match

يطابق تعبيرًا عاديًا مثل \"example\\.com.*purchase$\". يتم دعم التدقيق النحوي PCRE تمامًا

البيانات البيانات التي تتم فلترتها

url

عنوان URL لموقع تمت زيارته تم تجاوزه بالكامل

domain

نطاق الموقع الذي تمت زيارته

path

مسار الموقع الذي تمت زيارته، بدون النطاق

event

اسم البيكسل event، مثل 'ViewContent'

device_type

الجهاز الذي تمكن من الوصول إلى الموقع:

desktop

mobile_android_phone

mobile_android_tablet

mobile_ipad

mobile_ipod

mobile_iphone

mobile_tablet

mobile_windows_phone

أي حقل customData

أي حقل تمت إضافته إلى customData لعمليات تشغيل بيكسل، مثل productId، category، price

أدخل كل قاعدة في شكل سلسلة مشفرة بـ JSON.