المسرد¶
كل مصطلح، منظوران. العمود الأيسر هو كيف يفكر مشتري الوسائط فيه. العمود الأيمن هو كيف يجده مهندس DevOps في النظام.
| المصطلح | تعريف مشتري الوسائط | تعريف DevOps / النظام |
|---|---|---|
| المقعد (Seat) | حساب مشتري على Google Authorized Buyers. تحدد نطاق تحليلك واستهدافك لكل مقعد. | buyer_account_id في Postgres. مخزّن في جدول seats. يتم المزامنة عبر GET /seats. |
| QPS | الاستعلامات في الثانية: الحد الأقصى لمعدل طلبات المزايدة التي تطلب من Google إرسالها. يتحكم Google في الحجم الفعلي بناءً على مستوى حسابك. | حد مُعَدّ لكل إعداد استهداف مسبق. المعدل الفعلي الوارد يُراقَب عبر مقاييس قمع RTB في rtb_daily. |
| الهدر (Waste) | QPS المُستهلَك بواسطة طلبات مزايدة يرفضها مزايدك (مناطق جغرافية خاطئة، أحجام خاطئة، لا يوجد تصميم إبداعي مطابق). أموال أُنفقت بلا مقابل. | (total_qps - bids_placed) / total_qps. يُحسب من تجميعات rtb_daily. مرئي في API القمع. |
| إعداد الاستهداف المسبق (Pretargeting config) | القواعد التي تتحكم في أي طلبات مزايدة تصل إلى مزايدك. تحصل على 10 لكل مقعد. يتحكم في المناطق الجغرافية والأحجام والتنسيقات والمنصات والناشرين. | كيان قابل للتعديل يتم مزامنته من Google AB API. مخزّن في pretargeting_configs. يُدار عبر /settings/pretargeting. اللقطات تمكّن التراجع. |
| القمع (Funnel) | التدرج من طلب المزايدة إلى الإنفاق: QPS -> مزايدات -> فوز -> مرات ظهور -> نقرات -> إنفاق. كل خطوة فيها تسرّب. | يُحسب من مقاييس rtb_daily. يُقدَّم عبر GET /analytics/rtb-funnel. الواجهة الأمامية تخزّنه مؤقتاً لمدة 30 دقيقة. |
| التصميم الإبداعي (Creative) | أصل إعلاني: صورة، فيديو، HTML، أو أصلي. له تنسيق وحجم وعنوان URL للوجهة وسجل أداء. | صف في جدول creatives. الصور المصغرة في تخزين الكائنات الثنائية. يتم المزامنة من Google AB API. الأداء من ربط rtb_daily. |
| الحملة (Campaign) | تجميع منطقي للتصاميم الإبداعية. يُستخدم لتنظيم التحليل وإعداد التقارير. | صف في جدول ai_campaigns. علاقة متعدد-إلى-متعدد مع التصاميم الإبداعية. يدعم التجميع التلقائي بالذكاء الاصطناعي. |
| بطاقة الإعداد (Config card) | لوحة واجهة المستخدم التي تعرض حالة إعداد الاستهداف المسبق، الحد الأقصى لـ QPS، المناطق الجغرافية، الأحجام، التنسيقات، والمنصات. | مكوّن React PretargetingConfigCard. البيانات من GET /settings/pretargeting-configs. |
| تحديث البيانات (Data freshness) | شبكة تعرض أي التواريخ تحتوي على بيانات مستوردة ("مستورد") مقابل فجوات ("مفقود") لكل نوع تقرير. | GET /uploads/data-freshness. يستخدم استعلامات generate_series + EXISTS على rtb_daily، rtb_bidstream، rtb_quality، rtb_bid_filtering. مهلة 30 ثانية. |
| الاستيراد (Import) | إدخال بيانات أداء CSV إلى Cat-Scan، إما عبر الرفع اليدوي أو الاستيراد التلقائي من Gmail. | يتم تحليل CSV والتحقق منه وإزالة التكرارات (عبر قيد فريد row_hash)، ثم الإدراج في الجداول المستهدفة. رفع مجزّأ للملفات أكبر من 5 ميغابايت. |
| التراجع (Rollback) | إرجاع تغيير إعداد الاستهداف المسبق إلى حالته السابقة. المعاينة بتشغيل تجريبي، ثم التأكيد. | استعادة اللقطة: يقرأ pretargeting_snapshots، يطبّق الفرق على Google AB API، يسجّل لقطة جديدة. POST /snapshots/rollback. |
| المحسّن / BYOM | نظام آلي يقيّم الشرائح ويقترح تغييرات على الإعدادات. يستخدم نموذجك الخارجي الخاص. | يتم استدعاء نقطة التقييم عبر HTTP POST. المقترحات مخزّنة في optimizer_proposals. دورة الحياة: تقييم -> اقتراح -> موافقة -> تطبيق. |
| إعداد سير العمل المسبق (Workflow preset) | آمن، متوازن، أو جريء. يتحكم في مدى جرأة مقترحات المحسّن. | معامل canary_profile لـ API التقييم والاقتراح. يؤثر على عتبات الثقة وحدود حجم التغيير. |
| CPM الفعلي (Effective CPM) | ما تدفعه فعلياً لكل ألف ظهور، مع مراعاة الهدر وتكلفة البنية التحتية. | يُحسب في OptimizerEconomicsService. يجمع بيانات الإنفاق من rtb_daily مع تكلفة الاستضافة المُعَدّة. |
| التحويل (Conversion) | إجراء قيّم من المستخدم (شراء، تسجيل) يُتتبَّع بعد الظهور. يُغذّى لتحسين الاستهداف. | حدث يُستوعب عبر البكسل (GET /conversions/pixel) أو webhook (POST /conversions/webhook). مخزّن في جداول التحويلات. مُتحقَّق منه بـ HMAC لخطافات الويب. |
| معدل الفوز (Win rate) | الفوز / المزايدات. مدى تنافسية مزايداتك في المزاد. | auction_wins / bids_placed من rtb_daily. |
| CTR | النقرات / مرات الظهور. مدى جاذبية تصاميمك الإبداعية. | clicks / impressions من rtb_daily. |
| بوابة فحص الصحة أثناء التشغيل (Runtime health gate) | (ليس مصطلحاً لمشتري الوسائط) | سير عمل CI v1-runtime-health-strict.yml. يشغّل فحوصات شاملة: صحة API، صحة البيانات، التحويلات، المحسّن، SLO لـ QPS. يعيد PASS/FAIL/BLOCKED لكل فحص. |
| فحص العقد (Contract check) | (ليس مصطلحاً لمشتري الوسائط) | scripts/contracts_check.py. يتحقق من عقود البيانات (قواعد غير قابلة للتفاوض من الاستيراد إلى مخرجات API). يُشغَّل بعد النشر. يحظر الإصدار عند الفشل. |
| Cloud SQL Proxy | (ليس مصطلحاً لمشتري الوسائط) | حاوية مرافقة توفر وصولاً مُصادَقاً إلى Cloud SQL Postgres. يجب أن تكون سليمة قبل بدء حاوية API. |
| ترويسة X-Email | (ليس مصطلحاً لمشتري الوسائط) | ترويسة HTTP يضبطها OAuth2 Proxy بعد مصادقة Google. يثق بها API عندما يكون OAUTH2_PROXY_ENABLED=true. يزيلها nginx للطلبات الخارجية. |