الحصول على إحصاءات المنشور والتعليقات

يُرجع ما تُبلّغ عنه المنصة بشأن منشور واحد سبق نشره على قناة واحدة: مقاييس التفاعل معه والتعليقات المتروكة عليه.

حالة استخدام: لوحة تفاعل لكل منشور. عندما يفتح عميل منشورًا سبق نشره في واجهة المستخدم لديك، استدعِ GET /social/posts/{postId} للحصول على قائمة القنوات، ثم استدعِ نقطة النهاية هذه مرة واحدة لكل قناة باستخدام id الخاص بتلك القناة. حلّل insights، واعرض المقاييس التي تتعرف عليها، وتجاهل الباقي — بهذه الطريقة، لن تؤدي إضافة المنصة لحقل إلى تعطّل صفحتك أبدًا.

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

ملاحظات.

• socialConnectedChannelId مطلوب، وهو id الخاص بالاتصال من اتصالات العلامة التجارية — وليس referenceId الخاص بالمنصة. يقتصر نطاق الإحصاءات دائمًا على قناة واحدة، لأن الأرقام تأتي من واجهة API الخاصة بتلك المنصة.
• يجب أن تنتمي القناة إلى العلامة التجارية نفسها التي ينتمي إليها المنشور. يؤدي إقران منشور باتصال تابع لعلامة تجارية أخرى إلى إرجاع SY95052.
• الإحصاءات متاحة للمنشورات التي نُشرت فقط. المنشور الذي لا يزال في حالة SCHEDULED، أو الذي فشل نشره على هذه القناة، يُرجع حمولات بيانات فارغة بدلًا من خطأ، لذا تحقّق من connectedChannels[].status في المنشور قبل استخلاص الاستنتاجات.
• تعتمد حداثة المقاييس على تحديث المنصة لها، وهو ما يعني في معظم المنصات تأخرًا يتراوح من دقائق إلى بضع ساعات بعد النشر. استعلم دوريًا وفق مؤقّت بدلًا من توقّع ظهور الأرقام فور تغيّر connectedChannels[].status إلى SUCCESS.
• يقتصر عدد التعليقات على ما تُرجعه المنصة في صفحة واحدة؛ ولا تجلب نقطة النهاية هذه صفحات إضافية بعدها.