تخطَّ إلى المحتوى

المفاهيم الأساسية

ستقابل هذه المصطلحات في لوحة المتابعة، وفي API، وفي بقية صفحات هذا الشرح. وتجدها كلها في مسرد المصطلحات مع أسمائها في API ومقابلاتها العربية في لوحة المتابعة.

المؤسسة هي حساب شركتك في AD80. ينضم إليها الأشخاص بدعوة، ولكل منهم أحد ثلاثة أدوار: مالك أو مشرف أو مُطّلع. انظر الأدوار والصلاحيات.

التطبيق هو تطبيق Android أو iOS واحد، يُعرف بمعرّف التطبيق: معرّف تطبيق Android (اسم الحزمة) أو معرّف الحزمة (bundle identifier) في iOS، مثل com.example.news. لكل تطبيق سياسة ومفاتيح رفع، والإعلانات التي رآها مستخدموه. ولكل مؤسسة أيضاً تطبيق خاص بصفحة «جرّب سياستك»، تنشئه لوحة المتابعة لك وتُبقيه خارج قوائم SDK.

الإعلان (creative) هو صورة إعلان واحدة مميزة. يتعرّف عليها AD80 من بصمة (hash) لمحتوى بكسلاتها (ad80px1: يليها 64 حرفاً ست عشرياً)، لذا فالصورة نفسها إذا ظهرت مرات كثيرة تبقى إعلاناً واحداً له مرات ظهور كثيرة. ولكل إعلان مصدر: وصل من SDK (sdk) أو رفعتَه أنت (manual، من «جرّب سياستك»).

القاعدة جملة واحدة تصف شيئاً لا تقبله، مثل «لا إعلانات تُظهر الخمور». لكل قاعدة معرّف قاعدة قصير (حروف أو أرقام أو نقطة أو شرطة أو شرطة سفلية، حتى 64 حرفاً)، واسم للعرض إن شئت. أما السياسة فهي قائمة القواعد لتطبيق واحد.

كل مرة تحفظ فيها سياسة تغيّرت، يُنشأ إصدار جديد (v1، v2، …). وحفظ القواعد نفسها دون تغيير لا ينشئ إصداراً جديداً. وكل درجة تذكر إصدار السياسة الذي قُيّمت به، فتعرف دائماً أي قواعد طُبّقت.

الفحص هو أن يقيّم AD80 إعلاناً واحداً مقابل سياسة. وحالته واحدة من هذه:

الحالةالمعنى
مفحوصيوجد حكم: كل قاعدة لها درجة.
الفحص جارٍينتظر التقييم.
تعذّر التقييمفشل الفحص.
لم يُفحص: نفد الرصيد الشهريحُسبت مرة الظهور ولم تُفحص، لأن رصيد الخطة الشهري من مرات الظهور المراقَبة نفد. ولا تظهر أبداً على أنها سليمة.

الحكم في الفحص يعطي كل قاعدة درجة بين 0 و1، ويقول هل خولفت القاعدة أم لا. ويتضمن أيضاً وصفاً قصيراً لما ظهر في الإعلان، وشرحاً لسبب مخالفة القاعدة.

إعلان يخالف أحدث حكم له قاعدة واحدة على الأقل. وتظهر المخالفات في المخالفات.

المراجعة: مخالفة مؤكدة أو «ليست مخالفة»

Section titled “المراجعة: مخالفة مؤكدة أو «ليست مخالفة»”

أنت تراجع المخالفة: تختار نعم، مخالفة إذا كان AD80 محقاً، أو ليست مخالفة إذا لم يكن كذلك. وحالة المراجعة إما لم تُراجَع أو مخالفة مؤكدة أو ليست مخالفة. وتُحفظ إجاباتك ملاحظاتٍ، ونستخدمها لنتحقق من جودة التقييم.

الحادثة تتابع إعلاناً مخالفاً واحداً أبلغ عنه SDK لديك، من أول مرة ظهر فيها حتى حلّها. ولها حالة: مفتوحة أو قيد المتابعة أو حُلّت أو أُغلقت دون إجراء، ومعها ملاحظات وسجل للحل.

مفتاح الرفع هو السر الذي يستخدمه SDK لإرسال الإعلانات إلى AD80. يبدأ بـad80_ik_، ويخص تطبيقاً واحداً، ولا يصلح إلا للرفع. تضعه في تطبيقك: في ملف البيان (manifest) على Android، وفي Info.plist على iOS. ويسميه API ingest key.

مفتاح API هو السر الذي تستخدمه نصوصك البرمجية وخوادمك لاستدعاء واجهة REST API. يبدأ بـad80_ck_، ويحمل نطاقات تحدّد ما يستطيع فعله. لا تضع مفتاح API داخل تطبيق أبداً.

مرات الظهور المراقَبة والفحوص اليدوية والإشعارات السريعة

Section titled “مرات الظهور المراقَبة والفحوص اليدوية والإشعارات السريعة”

هذه عدّادات الاستخدام الثلاثة في كل خطة، وتُحسب لكل شهر ميلادي (بتوقيت UTC):

  • مرات الظهور المراقَبة: مرات ظهور الإعلانات التي رصدها AD80 وعالجها عبر SDK لديك. والعدّاد يحسب مرات الظهور، لا الإعلانات المختلفة.
  • الفحوص اليدوية: الصور التي ترفعها أو تختارها من النماذج في «جرّب سياستك»، ومرات إعادة الفحص.
  • الإشعارات السريعة: التنبيهات التي تُرسل فوراً. وعندما ينفد الرصيد الشهري، تصلك التنبيهات اللاحقة في ملخص.