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

الأسئلة الشائعة

الأسئلة مصنّفة حسب الجمهور: [مشتري وسائط] لمشتري الوسائط ومديري الحملات، [DevOps] لمهندسي المنصات، [الجميع] للأسئلة المشتركة.

[مشتري وسائط] لماذا نسبة التغطية لديّ أقل من 100%؟

التغطية تقيس عدد خلايا التاريخ × نوع التقرير التي تحتوي على بيانات مقارنة بالعدد المتوقع. الأسباب الشائعة للفجوات:

  • لم يرسل Google تقريراً لذلك التاريخ (عطلة رسمية، تأخر في التصدير).
  • استيراد Gmail أخطأ البريد الإلكتروني (تحقق من حالة Gmail).
  • نوع تقرير معين غير متاح لمقعدك (مثلاً، بيانات الجودة قد لا تكون موجودة لجميع المشترين).

تحقق من شبكة تحديث البيانات على /import لمعرفة الخلايا المفقودة بالتحديد. راجع استيراد البيانات.

[مشتري وسائط] ما الفرق بين "الهدر" و"معدل الفوز المنخفض"؟

الهدر = طلبات مزايدة رفضها مزايدك دون مزايدة عليها. هذا QPS دفعت ثمنه لكن لم تستطع استخدامه على الإطلاق. أصلحه بالاستهداف المسبق.

معدل الفوز المنخفض = طلبات مزايدة زايد عليها مزايدك لكنه خسر المزاد. هذا يعني أن مزايداتك ليست تنافسية بما فيه الكفاية. أصلحه باستراتيجية المزايدة، وليس الاستهداف المسبق.

كلاهما يظهر في القمع لكنهما يتطلبان إجراءات مختلفة. راجع فهم قمع QPS الخاص بك.

[مشتري وسائط] هل يمكنني التراجع عن تغيير في الاستهداف المسبق؟

نعم. اذهب إلى /history، اعثر على التغيير، انقر "معاينة التراجع" لرؤية ما سيتم إرجاعه، ثم أكّد. التراجع نفسه يُسجَّل. راجع إعداد الاستهداف المسبق.

[مشتري وسائط] كم مرة يجب أن أعيد استيراد البيانات؟

يومياً. الاستيراد التلقائي من Gmail يتعامل مع هذا تلقائياً. إذا كنت تستورد يدوياً، افعل ذلك مرة واحدة يومياً بعد وصول التقارير. البيانات القديمة تعني قرارات قديمة.

[مشتري وسائط] ما الذي يغيّره المحسّن فعلياً؟

المحسّن يقترح تغييرات على إعدادات الاستهداف المسبق: إضافة أو إزالة مناطق جغرافية وأحجام وناشرين وغيرها. لا يطبّق التغييرات تلقائياً أبداً. أنت تراجع وتوافق على كل مقترح. راجع المحسّن.

[DevOps] لماذا فشلت بوابة فحص الصحة الصارم أثناء التشغيل؟

تحقق من سجلات سير العمل: gh run view <id> --log-failed. ابحث عن FAIL مقابل BLOCKED:

  • FAIL = شيء تعطّل. مهلة تحديث البيانات ومشاكل SET statement_timeout هي أسباب شائعة. راجع استكشاف الأخطاء وإصلاحها.
  • BLOCKED = تبعية مفقودة، ليست بالضرورة خطأ في الكود. أمثلة: لا توجد بيانات جودة لهذا المشتري، المقترح ليس له billing_id. قارن مع عمليات التشغيل السابقة للتمييز بين التراجعات والفجوات الموجودة مسبقاً.

[DevOps] لماذا نقطة تحديث البيانات بطيئة؟

الاستعلام يمسح rtb_daily (~84 مليون صف) وrtb_bidstream (~21 مليون صف). إذا تدهورت خطة الاستعلام إلى مسح تسلسلي بدلاً من استخدام فهارس (buyer_account_id, metric_date DESC)، فسيستغرق دقائق.

الإصلاح: تأكد من أن الاستعلامات تستخدم نمط generate_series + EXISTS (14 عملية بحث في الفهرس بدلاً من مسح الجدول بالكامل). راجع عمليات قاعدة البيانات.

[DevOps] كيف أتحقق من الإصدار المنشور؟

curl -sS https://scan.rtb.cat/api/health | jq -r '.git_sha,.version'

هذا يعيد SHA الخاص بـ git وعلامة الصورة. قارنه بسجل الإيداعات لديك.

[DevOps] كيف أنشر إصلاحاً؟

  1. ادفع إلى unified-platform
  2. انتظر نجاح build-and-push.yml
  3. شغّل deploy.yml عبر gh workflow run مع confirm=DEPLOY
  4. تحقق عبر /api/health

راجع النشر للإجراء الكامل.

[DevOps] المستخدمون عالقون في حلقة تسجيل دخول. ماذا أفعل؟

تحقق من Cloud SQL Proxy: sudo docker ps | grep cloudsql. إذا كان متوقفاً، أعد تشغيله، انتظر 10 ثوانٍ، ثم أعد تشغيل حاوية API. راجع استكشاف الأخطاء وإصلاحها للإجراء الكامل.

[الجميع] من أين تأتي بيانات Cat-Scan؟

تصديرات CSV من Google Authorized Buyers. لا توجد API للتقارير. تصل البيانات إما عبر رفع CSV يدوي أو استيراد تلقائي من Gmail. راجع استيراد البيانات.

[الجميع] هل من الآمن إعادة استيراد نفس ملف CSV؟

نعم. يتم تجزئة كل صف وإزالة التكرارات. إعادة الاستيراد لا تؤدي أبداً إلى العدّ المزدوج.

[الجميع] ما اللغات التي تدعمها واجهة المستخدم؟

الإنجليزية والهولندية والصينية (المبسّطة). محدد اللغة موجود في الشريط الجانبي.