يحتاج المحلّل إلى سطر واحد لكل منشور وعناوين أعمدة إنجليزية واضحة. قد يكون التصدير التلقائي من خدمة أخرى ذا بنية مختلفة: حوّله أولًا إلى القالب. لا يستنتج البرنامج معنى الأعمدة العشوائية.
مخطط الاستيراد
حقل name إلزامي، مع عمود واحد على الأقل من أعمدة القاعدة: followers أو views أو reach. ولتقرير المشاهدات يلزم وجود views بقيمة معروفة في سطر واحد على الأقل. الأعمدة الإضافية هي likes وcomments وshares وsaves. جميع العدّادات أعداد صحيحة وغير سالبة.
يمكن تنزيل مثال بسيط بصيغة CSV. عنوانه هو name,views,likes,comments. والسطران A,100,8,2 وB,120,10,3 يعنيان منشورين تعليميين. يجب وضع الاسم الذي يحتوي على فاصلة بين علامتي اقتباس مزدوجتين؛ وتُضاعف علامة الاقتباس داخل الحقل.
التصدير من الجدول
احفظ الملف بترميز UTF-8. تُدعم الفاصلة والفاصلة المنقوطة والمسافة الجدولية؛ ويجب أن تحتوي جميع الأسطر على العدد نفسه من الحقول. لا تُضِف علامة النسبة المئوية أو العملة أو كلمة «مشاهدات» داخل خلية رقمية. تُوصف الوحدات في منهجية التقرير.
الخلية الفارغة تعني قيمة غير معروفة. والصفر يعني غيابًا معروفًا للتفاعلات. لا تملأ العمود كله بالأصفار لمجرد أن الخدمة لم تصدّره. بالنسبة إلى تحليل CSV يسري حد 500 كيلوبايت و1 000 سطر بيانات؛ قسّم التقرير الكبير إلى فترات ذات معنى، لا إلى أجزاء عشوائية.
التحقق بعد الرفع
قارن عدد المنشورات وعدد الأسطر ذات المشاهدات المعروفة. انظر إلى أول منشور وآخر منشور في ملف CSV الأصلي، وإلى المتوسط والوسيط في التقرير. إذا بدا المؤشر غير متوقع، فارجع إلى الوحدات والفاصل وعمر المنشورات. يعرض الرسم البياني أول 30 سطر من الفترة B، إن أُضيفت، وإلا فمن الفترة A. وتُحسب المؤشرات الموجزة على كامل العينة. يحتوي التصدير على هذه الإجماليات؛ واحفظ أسطر المنشورات الأصلية بشكل منفصل.
يبقى الملف الأصلي في المتصفح. وهذا ليس اتصالًا مباشرًا بحساب Telegram ولا تأكيدًا لصحة الجدول. إذا كانت البيانات مأخوذة من إحصاءات إدارية، فاحفظ التاريخ ومصدر الوصول بشكل منفصل. واحذف من الأمثلة العامة بيانات العملاء والروابط الخاصة.
إذا أُعدّ لهذا العمل إعلان عام منفصل في Telegram، فيمكن التحقق من الشروط السارية للمشاهدات. يعمل المحلّل على ملف CSV الخاص بك ولا يؤكد مصدر النشاط. والنشاط المشترى لا يؤكد وجود اهتمام عضوي أو توصيات أو طلبات أو مبيعات.