الجماهير المخصصة للتفاعل

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

يوضح هذا الدليل API من خلال استخدام جماهير التفاعل مع الصفحة كمثال. يعمل فيسبوك على تحديث جمهورك المخصص للتفاعلات مع الصفحة عن طريق إضافة أشخاص يتفاعلون مع صفحتك باستمرار. عندما تقوم بإنشاء هذا الجمهور لأول مرة، فيمكن لفيسبوك ملء هذا الجمهور تلقائيًا من خلال قائمة من الأشخاص الذين تفاعلوا مع صفحتك بالفعل خلال فترة الاحتفاظ المحددة.

إنشاء جمهور

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

لإنشاء جمهور يتضمن الأشخاص الذين تفاعلوا مع صفحتك استنادًا إلى الحدث page_engaged:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

المعلمات

تمثل الجماهير المخصصة للتفاعل نوعًا من أنواع الجماهير المخصصة. لمعرفة جميع الحقول المتوفرة، يمكنك الرجوع إلى مرجع الجمهور المخصص.

ملاحظة: بإمكان كل حساب إعلاني إنشاء 500 جمهور مخصص للتفاعل كحد أقصى.

قواعد التفاعل

يمكنك تحديد ما إذا أضاف فيسبوك شخصًا آخر إلى الجمهور المخصص أم لا من خلال قواعد الجمهور.

حدّد الحقلين type وid ضمن event_sources في القاعدة للإشارة إلى الحقلين type وid التابعين لكائن التفاعل. يستخدم الحقل id معرف كائن واحدًا أو مصفوفة من المعرفات من النوع ذاته.

هذه هي مصادر الأحداث ومعرفات كائنات التفاعل المقابلة المدعومة:

• page: معرف صفحة فيسبوك.
• lead: معرف نموذج بيانات العميل المحتمل.
• ig_lead_generation: معرف نموذج بيانات العميل المحتمل.
• canvas: معرف اللوحة.
• ig_business: معرف الملف الشخصي لنشاط تجاري على Instagram.
• shopping_page: معرف صفحة المتجر لديك على فيسبوك.
• shopping_ig: معرف المتجر على Instagram.
• ar_experience: تجربة فورية تستخدم تأثير الواقع المعزَّز.
• ar_effects: تأثر فيسبوك أو Instagram تملكه. لا يتضمن ذلك التأثيرات المستخدمة في الإعلانات.

تتكون كل قاعدة من معرف object_id واسم event_name.

الصفحات

قم بتعيين object_id على معرف صفحتك. ضمن event_name، استخدم أحد أحداث التفاعل التالية:

• page_engaged: الأشخاص الذين زاروا صفحتك أو تفاعلوا مع أي من إعلانات أو محتوى صفحتك، على فيسبوك أو Messenger. هذا هو أكثر أنواع التفاعل شمولاً ويتضمن جميع أنواع التفاعل الأخرى.
• page_visited: الأشخاص الذين زاروا صفحتك.
• page_liked: الأشخاص المعجبون حاليًا بصفحتك. (راجع التفاصيل حول الاحتفاظ والقواعد المتعلقة بتسجيلات الإعجاب بالصفحة)
• page_messaged: الأشخاص الذين أرسلوا رسالة إلى صفحتك.
• page_cta_clicked: الأشخاص الذين نقروا على أي زر من أزرار الدعوة لاتخاذ إجراء على صفحتك، (على سبيل المثال "اتصل بنا" أو "تسوق الآن").
• page_or_post_save: الأشخاص الذين قاموا بحفظ صفحتك أو أي من منشورات صفحتك.
• page_post_interaction: الأشخاص الذين تفاعلوا مع أي من منشورات صفحتك. تشتمل التفاعلات على ردود الفعل (مثل أعجبني أو أحببته أو هاهاها أو واااو أو أحزنني أو أغضبني) أو المشاركات أو التعليقات أو نقرات على الرابط أو تمريرات دوّارة.

إعلانات تجميع بيانات العملاء المحتملين

يجب تعيين object_id على FORM_ID، وتعيين rule لتتبع أحد أحداث إعلانات تجميع بيانات العملاء المحتملين التالية:

• lead_generation_submitted: جميع المستخدمين الذين أكملوا النموذج وأرسلوه.
• lead_generation_dropoff: جميع الأشخاص الذين أغلقوا النموذج دون إرساله. ربما قاموا بتعبئة أحد الحقول أو ربما لم يقوموا بذلك.
• lead_generation_opened: جميع الأشخاص الذين فتحوا نموذج إنشاء بيانات عميل محتمل بغض النظر عما إذا كانوا أرسلوا النموذج أم لا.

التجارب الفورية

قم بتعيين المعرف object_id إلى المعرف "CANVAS_ID". ويجب أن تتبع rule أحد الأحداث التالية:

• instant_shopping_document_open
• instant_shopping_document_pause
• instant_shopping_document_resume
• instant_shopping_document_close
• instant_shopping_did_scroll
• instant_shopping_element_click
• instant_shopping_element_impression

الملف الشخصي للنشاط التجاري على Instagram

يجب تعيين object_id على "INSTAGRAM_BUSINESS_PROFILE_ID"، ويجب أن تتبع rule أحد أحداث الملف الشخصي للنشاط التجاري على Instagram التالية:

• ig_business_profile_all: الأشخاص الذين زاروا الملف الشخصي لنشاطك التجاري على Instagram أو تفاعلوا مع أي من إعلانات أو محتويات الملف الشخصي لنشاطك التجاري على Instagram. هذا هو أكثر أنواع التفاعل شمولاً ويشتمل على جميع الأنواع الأخرى للتفاعل. يتضمن ig_business_profile_engaged وig_user_messaged_business وig_user_messaged_business.
• ig_business_profile_engaged: الأشخاص الذين تفاعلوا مع الملف الشخصي لنشاطك التجاري على Instagram أو تفاعلوا مع أي من إعلانات أو محتوى الملف الشخصي لنشاطك التجاري على Instagram.
• ig_user_messaged_business: الأشخاص الذين أرسلوا رسائل إلى الملف الشخصي لنشاطك التجاري على Instagram.
• ig_business_profile_visit: الأشخاص الذين زاروا الملف الشخصي لنشاطك التجاري على Instagram.
• ig_business_profile_ad_saved: الأشخاص الذين حفظوا محتوى أو إعلان عادي من الملف الشخصي لنشاطك التجاري على Instagram.
• ig_ad_like
• ig_ad_comment
• ig_ad_share
• ig_ad_save
• ig_ad_cta_click
• ig_ad_carousel_swipe
• ig_organic_like
• ig_organic_comment
• ig_organic_share
• ig_organic_save
• ig_organic_swipe
• ig_organic_carousel_swipe

التسوق

يجب أن تتبع قاعدة التفاعل مع التسوق أحد الأحداث التالية:

• VIEW_CONTENT: الأشخاص الذين شاهدوا صفحة تفاصيل المنتج لديك. ويتوفر هذا الخيار في جميع أنحاء العالم.
• ADD_TO_CART: الأشخاص الذين أضافوا منتجك إلى عربة التسوق لديهم. ويتوفر ذلك فقط للأنشطة التجارية التي تتيح إتمام الشراء، وفقط للمستهلكين داخل الولايات المتحدة.
• PURCHASE: الأشخاص الذين اشتروا منتجاتك. ويتوفر ذلك فقط للنشاط التجاري الذي يتيح إتمام الشراء، وفقط للمستهلكين داخل الولايات المتحدة.

لإنشاء قاعدة تضيف الأشخاص الذين شاهدوا منتجك:

curl -i -X POST
-F 'name="test_api"'\
-F 'rule= {
	"inclusions": {
		"operator": "or",
		"rules": [
			{
				"event_sources": [
					{
						"id": "<ID>",
						"type": "shopping_ig"
					}
				]
				"retention_seconds": <RETENTION_SECONDS>,
				"filter": {
					"operator": "and",
					"filters": [
						{
						"field":"event",
						"operator":"eq",
						"value": "VIEW_CONTENT"
						}
					]
				}
			}
		]
	}
}
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

الواقع المعزّز

يمكن أن تحتوي الجماهير المخصصة للتفاعل الواقع المعزّز على جزأين: تجربة الواقع المعزز وتأثير الواقع المعزز.

• بالنسبة إلى تجربة الواقع المعزَّز للجمهور المخصص للتفاعل، قم بتعيين object_id على معرف حاوية بيانات إعلانات الواقع المعزَّز وبالنسبة إلى حقل event_name استخدم ar_camera_open أو camera_cta_click.
• بالنسبة إلى تجربة الواقع المعزَّز للجمهور المخصص للتفاعل، قم بتعيين object_id على معرف تأثير الواقع المعزَّز واستخدم ar_effect_open للحقل event_name.

الحد الأقصى لأيام الاحتفاظ

بالنسبة للمتطلبات القانونية والمتطلبات المتعلقة بالخصوصية، نسمح بحد أقصى مختلف لأيام الاحتفاظ لكل نوع من أنواع مصادر الأحداث:

• إعلانات تجميع بيانات العملاء المحتملين: 90 يومًا
• الملف الشخصي للنشاط التجاري على Instagram: 730 يومًا
• الصفحة: 730 يومًا

  • ملحوظة: لا يوجد احتفاظ بجمهور تسجيلات الإعجاب بالصفحة
• التجارب الفورية المعروفة سابقًا باسم اللوحة: 730 يومًا
• التسوق: 365 يومًا. تتوفر البيانات منذ أبريل 2020.
• الواقع المعزَّز: 365 يومًا

قواعد التفاعل مع قسم الاستبعاد

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

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

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       },
       "exclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_cta_clicked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

لمزيد من المعلومات، راجع الجماهير المخصصة من موقع الويب لديك.

القواعد المتعددة

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

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 },
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

الصفحات المتعددة

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

فيما يلي مثال على جمهور يتضمن جميع الأشخاص الذين زاروا صفحة واحدة على الأقل من ثلاث صفحات:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               },
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

للحصول على تفاصيل حول الجماهير المخصصة، راجع مرجع الجمهور المخصص.

الاحتفاظ بتسجيلات الإعجاب بالصفحة والقواعد

لا يمكن الاحتفاظ بتسجيلات الإعجاب بالصفحة (retention_seconds=0). كما يتعذر دمج قواعد تسجيلات الإعجاب بالصفحة مع أحداث الصفحة الأخرى.

فيما يلي مثال على إنشاء جمهور تسجيلات الإعجاب بالصفحة:

curl -X POST \
  -F 'name="Page Likes Audience Name"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 0,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_liked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences