API رؤى المراسلات

يشرح هذا المستند كيفية الحصول على أدوات قياس الرسائل التي أرسلها نشاطك التجاري أو استلمها بشكل برمجي. API رؤى المراسلات هي ملحق لواجهة API رؤى الصفحة وتُتيح لك الحصول على المعلومات نفسها التي تظهر في علامة تبويب "رؤى الصفحة" لصفحتك على فيسبوك.

قبل البدء

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

• معرف الصفحة لصفحة فيسبوك التي تريد عرض أدوات القياس الخاصة بها

  • فيما يتعلق بمراسلة Instagram، سيتعين توفير صفحة فيسبوك مرتبطة بحساب Instagram الاحترافي
• رمز وصول صفحة
• الأذونات التالية:

  • pages_messaging
  • pages_read_engagement
  • pages_show_list
  • read_insights
• الوصول القياسي

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

• معرف الصفحة لصفحة فيسبوك التي تريد عرض أدوات القياس الخاصة بها

  • فيما يتعلق بمراسلة Instagram، سيتعين توفير صفحة فيسبوك مرتبطة بحساب Instagram الاحترافي
• رمز وصول الصفحة الذي يطلبه شخص يمكنه تنفيذ المهمة ANALYZE بالصفحة
• الأذونات التالية عبر تسجيل دخول فيسبوك:

  • pages_messaging
  • pages_read_engagement
  • pages_show_list
  • read_insights
• الوصول المتقدم

التقييدات

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

قراءة أدوات قياس الرؤى

لقراءة معلومات حول أداة قياس واحدة أو أكثر، أرسِل طلب GET إلى نقطة نهاية /PAGE-ID/insights يتضمن معلمة metric تم تعيينها لقائمة أدوات قياس المفصولة بفاصلة التي تريد الاطّلاع عليها.

عينة من الطلب

curl -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights
    ?metric=page_messages_new_conversations_unique,page_messages_blocked_conversations_unique 
    &access_token=PAGE-ACCESS-TOKEN"

عند نجاح العملية، سيتلقى تطبيقك استجابة JSON التالية:

{ 
  "data": [ 
    { 
      "name": "page_messages_new_conversations_unique", 
      "period": "day", 
      "values": [ 
        { 
          "value": "42", 
          "end_time": "1665175977" 
        }, 
      ]
    },
    { 
      "name": "page_messages_blocked_conversations_unique", 
      "period": "day", 
      "values": [ 
        { 
          "value": "0", 
          "end_time": "1665175977" 
        }, 
      ]
    } 
  ],
}

عينة من الطلب ضمن فترة زمنية إجمالية

يتناول المثال التالي إجمالي عدد المحادثات الفريدة الجديدة على مدار فترة زمنية محددة عن طريق تضمين المعلمة period المعينة إلى total_over_range مع النطاق الزمني المحدد بواسطة since ومعلمات until في استدعاء API.

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights/
    ?metric=page_messages_new_conversations_unique
    &since=UNIX-TIMESTAMP-START
    &until=UNIX-TIMESTAMP-STOP
    &period=total_over_range
    &access_token=PAGE-ACCESS-TOKEN"

عند النجاح، سيتلقى تطبيقك استجابة JSON التالية مع عدد المحادثات الفريدة الجديدة ونهاية النطاق الزمني:

{
  "data": [
    {
      "name": "page_messages_new_conversations_unique",
      "period": "total_over_range",
      "values": [
        {
          "value": 27
          "end_time": "1665175977"
        }
      ],
    }
  ]
}

عينة من طلب التقسيم

يتناول المثال التالي إجمالي عدد رموز الإشعارات المتكررة خلال فترة زمنية محددة ومصنفة حسب الموضوع والتكرار.

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights/
    ?metric=recurring_notifications_tokens   
    &since=UNIX-TIMESTAMP-START
    &until=UNIX-TIMESTAMP-STOP
    &period=total_over_range
    &breakdown=recurring_notifications_topic,recurring_notifications_frequency 
    &access_token=PAGE-ACCESS-TOKEN"

عند نجاح العملية، سيتلقى تطبيقك استجابة JSON التالية مع رموز مجمعة حسب الموضوع، "newproducts" و"10percentsale"، ومعدل تكرار الرسائل المتوفر لكل موضوع، "يومي" و"أسبوعي" و"شهري" لـ "newproducts" و"يومي" و"أسبوعيا" لـ "10percentsale":

{
  "data": [
    {
      "name": "recurring_notifications_tokens",
      "period": "total_over_range",
      "values": [ 
        {
          "value": 3,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "daily"
        },
        {
          "value": 15,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "weekly"
        },
        {
          "value": 8,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "monthly"
        },
        {
          "value": 17,
          "end_time": "1665175977",
          "recurring_notifications_topic": "10percentsale",
          "recurring_notifications_frequency": "daily"
        },
        {
          "value": 14,
          "end_time": "1665175977",
          "recurring_notifications_topic": "10percentsale",
          "recurring_notifications_frequency": "weekly"
        },
      ]
    }
  ]
}

معلمات الرؤى

أدوات القياس المتوفرة

تتوفر أدوات القياس التالية عبر API رؤى المراسلات:

تعرَّف على المزيد حول أدوات القياس قيد التطوير.

خصائص الاستجابة

يمكن إرجاع المعلومات التالية في مكالمة مع API الرؤى.

راجع أيضًا

• التعرف على المزيد حول رؤى الصفحات
• التعرف على المزيد حول مرجع كائنات الرؤى