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

الإعلانات والمخالفات

الإعلان هو صورة إعلانية واحدة مميّزة داخل تطبيق واحد. معرّفه id هو بصمة محتواه: ad80px1: ثم 64 حرفًا ست عشريًا.

{
"id": "ad80px1:3f5c...e9",
"contentHash": "ad80px1:3f5c...e9",
"appId": "com.example.news",
"width": 960,
"height": 150,
"imageUrl": "https://api.ad80.dev/v1/images/12/ad80px1:3f5c...e9?exp=1761660000&sig=...",
"imageUrlExpiresAt": "2026-10-28T14:00:00Z",
"network": "meta",
"placement": "MainActivity/banner_top",
"adFormat": null,
"responseId": "AbCdEf123...",
"source": "sdk",
"firstSeenAt": "2026-10-27T18:20:05Z",
"lastSeenAt": "2026-10-28T09:12:44Z",
"sightings": 37,
"notClassifiedSightings": 0,
"classification": { "status": "classified", "message": null },
"verdict": {
"state": "OK",
"policyVersion": 3,
"violates": true,
"scores": [
{ "ruleId": "no-alcohol", "score": 0.93, "violates": true },
{ "ruleId": "no-gambling", "score": 0.04, "violates": false }
],
"reason": "no-alcohol: a glass of beer and a beer brand logo",
"description": "A banner showing a glass of beer with a brand logo and the text ...",
"scoredAt": "2026-10-27T18:20:31Z"
},
"review": { "status": "unreviewed", "note": null, "by": null, "at": null }
}
الحقلمعناه
imageUrl, imageUrlExpiresAtرابط موقّع قصير العمر إلى صورة PNG، ويكون null ما دامت الصورة لم تصل بعد. اقرأ روابط الصور الموقّعة.
networkمعرّف شبكة الإعلانات التي عرضت الإعلان (اقرأ شبكات الإعلانات)، أو null.
placementمعرّف مكان العرض كما أبلغ عنه SDK، أو null.
responseIdمعرّف الاستجابة في AdMob، إن أمكن التقاطه.
adFormatمحجوز للمستقبل، وقيمته حاليًا دائمًا null.
sourcesdk (أبلغ عنه SDK في تطبيقك) أو manual (رُفع في «جرّب سياستك»).
sightingsعدد مرات ظهور الإعلان. وnotClassifiedSightings: كم منها جاء بعد نفاد الرصيد.
classification.statusclassified أو pending أو error أو not_classified_quota. مع not_classified_quota تكون قيمة message هي "Not classified: monthly allowance reached" ولا يوجد حكم، فلا تعتبر هذا الإعلان سليمًا أبدًا.
verdictلا يظهر إلا مع النطاق read:verdicts وبعد الفحص. state: OK أو ERROR أو SKIPPED_BLANK (صورة فارغة). تكون violates بقيمة null حين تكون state هي ERROR. reason هو التفسير الخاص بالقواعد المخالَفة، وdescription (في نقطة نهاية الإعلان الواحد) وصف لما ظهر في الصورة.
review.statusunreviewed أو confirmed أو false_positive، ومعها الملاحظة، ومن راجع، ومتى.

لا يكون الإعلان سليمًا إلا إذا كانت classification.status هي classified وكانت verdict.violates هي false.

GET /v1/creatives

النطاق read:creatives (ومعه read:verdicts للأحكام ولخيارَي التصفية rule وminScore). الترتيب حسب lastSeenAt، الأحدث أولًا.

الاستعلاممعناه
appهذا التطبيق فقط.
ruleالإعلانات التي تخالف هذه القاعدة فقط. يحتاج read:verdicts.
networkشبكة الإعلانات هذه فقط.
from, toآخر ظهور في هذا اليوم أو بعده / في هذا اليوم أو قبله، بتوقيت UTC (YYYY-MM-DD).
minScoreأعلى درجة بين القواعد تساوي هذه القيمة أو تزيد عليها (من 0 إلى 1). يحتاج read:verdicts.
reviewunreviewed أو confirmed أو false_positive أو any.
sourcesdk أو manual.
cursor, limitتقسيم النتائج إلى صفحات. limit من 1 إلى 200، والافتراضي 50.
{ "creatives": [ { "id": "ad80px1:...", "...": "..." } ], "nextCursor": null }
GET /v1/violations

النطاقان read:creatives وread:verdicts. الإعلانات التي يخالف أحدث حكم عليها قاعدة واحدة على الأقل. خيارات التصفية والرد مثل /v1/creatives تمامًا، لكن review هنا افتراضيًا unreviewed. ولا تظهر في هذه القائمة أبدًا الإعلانات التي لم تُفحص.

Terminal window
curl -s "https://api.ad80.dev/v1/violations?app=com.example.news&from=2026-10-01&limit=100" \
-H "Authorization: Bearer $AD80_API_KEY"
GET /v1/creatives/{id}

النطاق read:creatives. إعلان واحد، ومعه verdict.description إن توفّر. إذا ظهرت الصورة نفسها في أكثر من تطبيق لديك، يرجع الإعلان الذي شوهد آخرًا؛ أضف ?app=<appId> لتختار التطبيق.

Terminal window
curl -s "https://api.ad80.dev/v1/creatives/ad80px1:3f5c...e9?app=com.example.news" \
-H "Authorization: Bearer $AD80_API_KEY"
POST /v1/creatives/{id}/feedback

النطاق write:policies. أكّد المخالفة، أو سجّل أنها «ليست مخالفة». يرجع الإعلان مع قيمة review الجديدة.

الحقلمعناه
labelمطلوب: confirmed أو false_positive.
ruleIdsاختياري: القواعد التي ينطبق عليها هذا الحكم. إن لم ترسله: كل القواعد المخالَفة.
noteاختياري، حتى 500 حرف.
Terminal window
curl -s -X POST "https://api.ad80.dev/v1/creatives/ad80px1:3f5c...e9/feedback?app=com.example.news" \
-H "Authorization: Bearer $AD80_API_KEY" -H "Content-Type: application/json" \
-d '{"label": "false_positive", "note": "Non-alcoholic malt drink"}'

المراجعة لا توقف أي شيء. هي تسجّل رأيك فقط، ونستفيد منها لنتحقق من جودة التقييم.