مرجع API رؤى المراسلات
بفضل API رؤى المراسلات يمكنك بطريقة برمجية استرداد المعلومات نفسها التي تظهر في علامة التبويب "رؤى الصفحة" في صفحتك على فيسبوك.
لمزيد من المعلومات حول API رؤى المراسلات وغيرها من التحليلات المتوفرة من منصة Messenger، راجِع Analytics.
لمزيد من المعلومات حول واجهة API رؤى الصفحة، بما في ذلك معلومات حول أدوات القياس الأخرى المتوفرة والأذونات المطلوبة، يُرجى الاطلاع على مستندات رؤى الصفحات أو مرجع كائنات الرؤى.
الأذونات
يلزم توفير رمز وصول الصفحة مع الإذن read_insights للتفاعل مع نقطة النهاية هذه.
مثال على الطلب
curl -X GET "https://graph.facebook.com/v2.8/me/insights/?metric=مثال على الاستجابة
{
"data": [
{
"name": "المعلمات
| المعلمة | الوصف |
|---|---|
| الأبعاد التي يتم تجميع الاستجابة بها. قد تكون |
| نطاق التاريخ النسبي والذي يمكن استخدامه بدلاً من |
| قائمة مفصولة بفاصلة تضم أدوات القياس التي يجب إرجاعها |
| التجميع المقدَّم ضمن نطاق منذ/حتى أو نطاق date_preset. تقدم قيمة |
| طابع UNIX الزمني لوقت بدء الحصول على أداة القياس |
| طابع UNIX الزمني لوقت انتهاء الحصول على أداة القياس |
أدوات القياس المتوفرة
تتوفر أدوات القياس التالية عبر API رؤى المراسلات:
metric الاسم | الوصف |
|---|---|
| عدد مرات اشتراك الحساب لتلقي رسائل تسويقية من نشاطك التجاري. إذا اشترك حساب في عدة مواضيع، فسيتم احتسابه مرة أخرى لكل موضوع. كيفية الاحتساب: تحسب أداة القياس هذه عدد مرات موافقة الحسابات على استلام الرسائل المتكررة ناقصًا عدد مرات إلغاء اشتراك الحسابات. قيم
أداة القياس هذه قيد التطوير. |
| عدد مرات تفاعل المستخدمين مع الرسائل على صفحة نشاطك التجاري، عن طريق الضغط على زر دعوة لاتخاذ إجراء. تتضمن أدوات القياس هذه بيانات من الرسائل التسويقية فقط. قيم
أداة القياس هذه قيد التطوير. |
| عدد الرسائل التي أرسلتها صفحة النشاط التجاري كرسالة إلى العميل. تتضمن أدوات القياس هذه بيانات من الرسائل التسويقية فقط. قيم
أداة القياس هذه قيد التطوير. |
| عدد الرسائل المقروءة مقسومًا على عدد الرسائل المرسلة بواسطة صفحتك. قد لا يتم تسجيل بعض مرات قراءة الرسائل، كما في حالة قيام أحد العملاء بإيقاف تشغيل مؤشرات قراءة الرسائل. تتضمن أدوات القياس هذه بيانات من الرسائل التسويقية فقط. قيم
أداة القياس هذه قيد التطوير. |
| عدد المرات التي قمت فيها بإنشاء طلب في المحادثات عبر الرسائل أو في التطبيقات أو مواقع الويب التابعة لجهات خارجية المستخدمة لإدارة المحادثات عبر الرسائل.
أداة القياس هذه قيد التطوير. |
| المبلغ المالي التقريبي الذي ربحته من الطلبات التي تم إنشاؤها من خلال محادثات المراسلات أو من خلال تطبيقات أو مواقع ويب الجهات الخارجية المستخدمة لإدارة محادثات المراسلات. قد تختلف الأرباح النهائية نتيجةً لتحويلات العملة.
أداة القياس هذه قيد التطوير. |
| عدد جهات التواصل عبر الرسائل مع طلب واحد على الأقل تم إنشاؤه.
أداة القياس هذه قيد التطوير. |
| عدد المحادثات مع الصفحة التي تم حظرها. |
| عدد محادثات المراسلة على Messenger التي بدأت مع أشخاص لم يراسلوا نشاطك التجاري من قبل. |
| عدد المحادثات من صفحتك التي تم الإبلاغ عنها من قِبَل الأشخاص لأسباب مثل المحتوى غير المهم أو الاحتيالي أو احتوائها على محتوى غير لائق. |
| عدد الأشخاص الذين يمكن لنشاطك التجاري إرسال رسائل إليهم. تعرض أداة القياس هذه عدد الأشخاص الذين أرسلوا رسالة إلى نشاطك التجاري على Messenger، دون تضمين الأشخاص الذين قاموا بحظر نشاطك التجاري أو أبلغوا عنه على Messenger. قد تكون هناك بعض القيود على قدرتك على إرسال رسائل إلى جهات التواصل، مثل القيود على عدد الرسائل التي يمكنك إرسالها خلال أُطر زمنية معينة. تشمل أداة القياس هذه أيضًا جهات التواصل التي تمت إضافتها منذ شهر أكتوبر 2016 عند توفُّر البيانات. |
خصائص الاستجابة
| الخاصية | الوصف |
|---|---|
| قائمة بكائنات أدوات القياس |
namestring (سلسلة) | اسم أداة القياس |
periodstring (سلسلة) | الفترة الزمنية التي تم خلالها تجميع البيانات |
valuesarray of objects (مصفوفة الكائنات) | قائمة البيانات الخاصة بأداة القياس |
valuearray of objects (مصفوفة الكائنات) | عدد أداة القياس المطلوبة في اليوم. بالنسبة لأدوات القياس المقسمة حسب النوع، سيتم إرجاع كائن يحتوي على أعداد لكل نوع. |
end_timeunix timestamp (طابع unix الزمني) | طابع UTC الزمني لوقت انتهاء أداة القياس. |
راجع أيضًا
- لمزيد من المعلومات حول استخدام API رؤى المراسلات، تفضَّل بزيارة دليل استخدام API رؤى المراسلات.