انتقل إلى المحتوى

الفصل 9: استيراد البيانات

الجمهور المستهدف: مشترو الوسائط، مديرو الحملات

يعتمد تحليل Cat-Scan كليًا على بيانات الأداء من Google Authorized Buyers. نظرًا لعدم توفير Google لـ Reporting API، تأتي جميع البيانات من تصدير ملفات CSV. يشرح هذا الفصل كيفية إدخال البيانات إلى Cat-Scan وكيفية التحقق من وصولها.

لماذا هذا مهم

بدون بيانات مُستورَدة، لا يملك Cat-Scan شيئًا لتحليله. يعتمد كل من قمع التحويل وعروض الهدر وأداء التصميمات الإبداعية والمُحسِّن على بيانات CSV حديثة. إذا كانت بياناتك قديمة، فإن قراراتك مبنية على معلومات متأخرة.

طريقتان لوصول البيانات

1. رفع CSV يدوي (/import)

اسحب وأفلت ملف CSV مُصدَّر من Google Authorized Buyers.

صفحة استيراد البيانات مع منطقة الرفع وشبكة الحداثة

سير العمل:

  1. صدّر التقرير من حسابك في Google Authorized Buyers.
  2. انتقل إلى /import في Cat-Scan.
  3. اسحب الملف إلى منطقة الإفلات (أو انقر للتصفح).
  4. يقوم Cat-Scan بالكشف التلقائي عن نوع التقرير ويعرض معاينة:
  5. الأعمدة المطلوبة مقابل الأعمدة الموجودة
  6. عدد الصفوف والنطاق الزمني
  7. أي أخطاء في التحقق
  8. راجع المعاينة. إذا كانت الأعمدة بحاجة إلى إعادة تعيين، استخدم محرر تعيين الأعمدة.
  9. انقر على استيراد.
  10. يعرض شريط التقدم حالة الرفع. تُرفع الملفات التي تزيد عن 5 ميغابايت في أجزاء تلقائيًا.
  11. تعرض النتائج: الصفوف المُستورَدة، التكرارات المُتخطّاة، الأخطاء إن وُجدت.

أنواع التقارير المكتشفة تلقائيًا:

النوع نمط اسم CSV ما يحتويه
bidsinauction catscan-report-* أداء RTB اليومي: الظهور، المزايدات، الفوز، الإنفاق
quality catscan-report-* (مقاييس الجودة) إشارات الجودة: القابلية للمشاهدة، الاحتيال، سلامة العلامة التجارية
pipeline-geo *-pipeline-geo-* التوزيع الجغرافي لتيار المزايدة
pipeline-publisher *-pipeline-publisher-* توزيع نطاقات الناشرين
bid-filtering *-bid-filtering-* أسباب تصفية المزايدات وأحجامها

2. الاستيراد التلقائي من Gmail

يمكن لـ Cat-Scan استيعاب التقارير تلقائيًا من حساب Gmail متصل.

  • يرسل Google Authorized Buyers تقارير يومية عبر البريد الإلكتروني.
  • يقرأ تكامل Gmail في Cat-Scan هذه الرسائل ويستورد مرفقات CSV تلقائيًا.
  • تحقق من الحالة في /settings/accounts > تبويب تقارير Gmail، أو عبر /gmail/status في API.

للتحقق من أن استيراد Gmail يعمل: - تحقق من لوحة حالة Gmail: يجب أن يكون last_reason هو running. - تحقق من عدد unread: عدد كبير من الرسائل غير المقروءة قد يشير إلى أن الاستيراد متوقف. - تحقق من سجل الاستيراد للإدخالات الأخيرة.

شبكة حداثة البيانات

تعرض شبكة حداثة البيانات (مرئية في /import ويستخدمها بوابة صحة وقت التشغيل) مصفوفة تاريخ × نوع تقرير:

              bidsinauction   quality   pipeline-geo   pipeline-publisher   bid-filtering
2026-03-02    imported        missing   imported       imported             imported
2026-03-01    imported        missing   imported       imported             imported
2026-02-28    imported        imported  imported       imported             imported
...
  • imported: يمتلك Cat-Scan بيانات لهذا التاريخ ونوع التقرير.
  • missing: لم تُعثر على بيانات. إما أن التقرير لم يُصدَّر، أو لم يصل عبر Gmail، أو فشل الاستيراد.

نسبة التغطية تُلخّص مدى اكتمال بياناتك عبر نافذة الاسترجاع. تستخدمها بوابة صحة وقت التشغيل لتحديد ما إذا كان النظام يعمل بشكل صحيح.

إزالة التكرارات

إعادة استيراد نفس ملف CSV (أو إعادة معالجة Gmail لنفس البريد الإلكتروني) لا تُضاعف حساب البيانات. يُحسب تجزئة لكل صف، وتُتخطّى التكرارات عند الإدراج. هذا يعني أنه من الآمن دائمًا إعادة الاستيراد.

سجل الاستيراد

يعرض جدول سجل الاستيراد في /import آخر 20 عملية استيراد:

  • الطابع الزمني
  • اسم الملف
  • عدد الصفوف
  • مُحفّز الاستيراد (رفع يدوي مقابل gmail-auto)
  • الحالة (مكتمل، فاشل، مكرر)

استكشاف الأخطاء وإصلاحها

المشكلة ما يجب التحقق منه
خلايا "missing" في شبكة الحداثة هل تم تصدير التقرير من Google في ذلك التاريخ؟ تحقق من Gmail بحثًا عن البريد الإلكتروني.
فشل الاستيراد بخطأ تحقق عدم تطابق الأعمدة. قارن جدول الأعمدة المطلوبة بملف CSV الخاص بك.
استيراد Gmail يعرض "stopped" تحقق من /settings/accounts > تبويب Gmail. قد تحتاج إلى إعادة التشغيل أو إعادة التفويض.
نسبة التغطية تنخفض التقارير تصل ولكن لتواريخ أقل من المتوقع. تحقق من جدول التصدير في Google AB.

مواضيع ذات صلة