تحدد قواعد الجماهير ما إذا كان شخص ما قد أضاف جمهورك المخصص. يتم تطبيق القواعد إما على عنوان URL للمُحيل أو أحداث وبيانات معينة.
قدِّم قواعدك في صورة سلاسل مشفرة باستخدام JSON ومصممة على النحو الآتي:
استخدم قواعد الجماهير لأنواع الجماهير المختلفة، بما في ذلك الجماهير المخصصة لمواقع الويب والجماهير المخصصة لتطبيقات الهواتف المحمولة والجماهير المخصصة للعمل دون اتصال. بالنسبة إلى الجماهير المخصصة للتفاعل، راجع الجماهير المخصصة للتفاعل.
rules
في inclusions
أو exclusions
.لتحديد إحدى قواعد الجماهير، يجب اتباع البنية التالية:
rule: { "inclusions": <RULE_SET>, "exclusions": <RULE_SET>, }
الاسم | الوصف |
---|---|
النوع: String (سلسلة) | مطلوب. سلسلة JSON الخاصة بمجموعة القواعد والتي تحدد التضمين. راجع بنية مجموعة القواعد. |
النوع: String (سلسلة) | مطلوب. سلسلة JSON الخاصة بمجموعة القواعد والتي تحدد الاستبعاد. راجع بنية مجموعة القواعد. |
اتبع هذه البنية لكل مجموعة قواعد:
{ "operator" : <BOOLEAN_OPERATOR>, "rules" : <JSON_RULE>, }
الاسم | الوصف |
---|---|
النوع: string (السلسلة) | مطلوب.
|
النوع: string (السلسلة) | مطلوب. سلسلة قواعد JSON (مصفوفة القواعد). راجع بنية قواعد التضمين والاستبعاد. |
اتبع هذه البنية لكل قاعدة تضمين أو استبعاد:
{ "event_sources" : <EVENT_SOURCE_DEFINITION>, "retention_seconds" : <SECONDS>, "filter" : <FILTER>, "aggregation" : <AGGREGATION>, }
يُعد كل من aggregation
وretention_seconds
حقلين قابلين للتعديل. ومع ذلك فإن تعديل الحقلين aggregation
وretention_seconds
لا يؤدي إلى مسح الجمهور. وسيظل فقط الأشخاص الذين يطابقون التجميع/القاعدة القديمة منضمين للجمهور حتى تنتهي المدة المحددة.
الاسم | الوصف |
---|---|
النوع: String (سلسلة) | مطلوب. كائن JSON يحتوي على
يمكن إضافة المزيد من مصادر الأحداث إلى |
النوع: Integer (عدد صحيح) | مطلوب. يجب أن يكون العدد الصحيح (بالثواني) لنافذة الاحتفاظ بالجمهور أقل من |
النوع: String (سلسلة) | مطلوب. سلسلة JSON الخاصة بقواعد الفلتر. راجع الفلاتر. |
النوع: Integer (عدد صحيح) | اختياري. سلسلة JSON لدوال التجميع. راجع دوال التجميع. |
تتبع الفلترة هذا التنسيق العام:
"filter" : { "operator": <BOOLEAN_OPERATOR>, "filters": <FILTER_SET>, }
الاسم | الوصف |
---|---|
النوع: string (السلسلة) | مطلوب.
|
النوع: string (السلسلة) | مطلوب. مصفوفة كائنات JSON الخاصة بقواعد الفلترة. راجع بنية قواعد الفلترة. |
{ "field": <FIELD>, "operator": <COMPARISON_OPERATOR>, "value": <VALUE>, }
الاسم | الوصف |
---|---|
النوع: String (سلسلة) | مطلوب.
|
النوع: String (سلسلة) | مطلوب.
إذا تم تعيين |
النوع: String (سلسلة) | مطلوب. إذا تم تعيين السمة |
يمكنك إنشاء جماهير مخصصة استنادًا إلى معدل التكرار وقوة السلوك باستخدام aggregation
في حقل قاعدة الجمهور. ومن خلال هذا، نحدد دالة تجميع، على سبيل المثال:
"aggregation" : { "type":"count", "operator":">", "value":1 }
الاسم | الوصف |
---|---|
النوع: String (سلسلة) | مطلوب. نوع دالة التجميع.
|
| مطلوب من أنواع معيّنة من دوال التجميع. |
النوع: String (سلسلة) | اختياري.
|
النوع: String (سلسلة) | مطلوب. ما لم يكن النوع هو المعلمة التي يتم تطبيق دالة التجميع عليها. |
النوع: String (سلسلة) | مطلوب.
|
النوع: String (سلسلة) | مطلوب. القيمة المتوقعة للمعلمة. |
على سبيل المثال:
"aggregation" : { "type":"count", "operator":">", "value":1 }
عامل التشغيل | الوصف |
---|---|
| صحيح إذا كانت قيمة معلمة الحدث أكبر من القيمة المحددة. |
| صحيح إذا كانت قيمة معلمة الحدث أكبر من أو تساوي القيمة المحددة. |
| صحيح إذا كانت قيمة معلمة الحدث أقل من القيمة المحددة. |
| صحيح إذا كانت قيمة معلمة الحدث أقل من أو تساوي القيمة المحددة. |
| صحيح إذا كانت قيمة معلمة الحدث تساوي القيمة المحددة. ملاحظة: هذا مكافئ لعدم تحديد أي عامل تشغيل مطلقًا؛ بمعنى أن "'x' : { 'eq' : 'y' }" هو نفسه "'x' : 'y' }. |
| صحيح إذا كانت قيمة معلمة الحدث لا تساوي القيمة المحددة. |
| صحيح إذا كانت قيمة معلمة الحدث، كسلسلة، تحتوي على السلسلة المحددة. القيمة "shoe12345" تستوفي 'contains' إذا كانت القيمة المحددة هي 'shoe'. |
| صحيح إذا كانت قيمة معلمة الحدث، كسلسلة، لا تحتوي على السلسلة المحددة. القيمة "shoe12345" تستوفي 'not_contains' إذا كانت القيمة المحددة هي 'purse'. |
| يحتوي على، غير حساس بالنسبة لحالة الأحرف |
| لا يحتوي على، غير حساس بالنسبة لحالة الأحرف |
| صحيح إذا كانت قيمة معلمة الحدث تطابق أي سلاسل في مصفوفة معينة. |
| صحيح إذا كانت قيمة معلمة الحدث لا تطابق أي سلاسل في مصفوفة محددة. |
| 'is_any'، غير حساس بالنسبة لحالة الأحرف. |
| 'is_not_any'، غير حساس بالنسبة لحالة الأحرف |
| صحيح إذا كانت قيمة معلمة الحدث تبدأ بالسلسلة المحددة |
| "starts_with"، غير حساس بالنسبة لحالة الأحرف |
| يطابق تعبيرًا عاديًا مثل \"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" } ] } ] } } ] } }
راجع الجماهير المخصصة لتطبيقات الهواتف المحمولة، مثال لقواعد الجماهير المخصصة.
تحتوي القواعد على عوامل التشغيل والبيانات أو الأحداث التالية:
عوامل التشغيل | نوع الفلتر |
---|---|
| يحتوي على سلسلة فرعية، غير حساس بالنسبة لحالة الأحرف |
| لا يحتوي على سلسلة فرعية، غير حساس بالنسبة لحالة الأحرف |
| يحتوي على سلسلة فرعية، حساس بالنسبة لحالة الأحرف |
| لا يحتوي على سلسلة فرعية، حساس بالنسبة لحالة الأحرف |
| يساوي، حساس بالنسبة لحالة الأحرف |
| لا يساوي، حساس بالنسبة لحالة الأحرف |
| أقل من، حقول رقمية فقط |
| أقل من أو يساوي، حقول رقمية فقط |
| أكبر من، حقول رقمية فقط |
| أكبر من أو يساوي، حقول رقمية فقط |
| يطابق تعبيرًا عاديًا مثل |
البيانات | البيانات التي تتم فلترتها |
---|---|
| عنوان URL لموقع تمت زيارته تم تجاوزه بالكامل |
| نطاق الموقع الذي تمت زيارته |
| مسار الموقع الذي تمت زيارته، بدون النطاق |
| اسم البيكسل |
| الجهاز الذي تمكن من الوصول إلى الموقع:
|
أي حقل | أي حقل تمت إضافته إلى |
أدخل كل قاعدة في شكل سلسلة مشفرة بـ JSON.