الإعلانات والمخالفات
كائن الإعلان
Section titled “كائن الإعلان”الإعلان هو صورة إعلانية واحدة مميّزة داخل تطبيق واحد. معرّفه 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. |
source | sdk (أبلغ عنه SDK في تطبيقك) أو manual (رُفع في «جرّب سياستك»). |
sightings | عدد مرات ظهور الإعلان. وnotClassifiedSightings: كم منها جاء بعد نفاد الرصيد. |
classification.status | classified أو 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.status | unreviewed أو confirmed أو false_positive، ومعها الملاحظة، ومن راجع، ومتى. |
لا يكون الإعلان سليمًا إلا إذا كانت classification.status هي classified وكانت verdict.violates هي false.
عرض الإعلانات
Section titled “عرض الإعلانات”النطاق read:creatives (ومعه read:verdicts للأحكام ولخيارَي التصفية rule وminScore). الترتيب حسب lastSeenAt،
الأحدث أولًا.
| الاستعلام | معناه |
|---|---|
app | هذا التطبيق فقط. |
rule | الإعلانات التي تخالف هذه القاعدة فقط. يحتاج read:verdicts. |
network | شبكة الإعلانات هذه فقط. |
from, to | آخر ظهور في هذا اليوم أو بعده / في هذا اليوم أو قبله، بتوقيت UTC (YYYY-MM-DD). |
minScore | أعلى درجة بين القواعد تساوي هذه القيمة أو تزيد عليها (من 0 إلى 1). يحتاج read:verdicts. |
review | unreviewed أو confirmed أو false_positive أو any. |
source | sdk أو manual. |
cursor, limit | تقسيم النتائج إلى صفحات. limit من 1 إلى 200، والافتراضي 50. |
{ "creatives": [ { "id": "ad80px1:...", "...": "..." } ], "nextCursor": null }عرض المخالفات
Section titled “عرض المخالفات”النطاقان read:creatives وread:verdicts. الإعلانات التي يخالف أحدث حكم عليها قاعدة واحدة على الأقل. خيارات التصفية
والرد مثل /v1/creatives تمامًا، لكن review هنا افتراضيًا unreviewed. ولا تظهر في هذه القائمة أبدًا الإعلانات
التي لم تُفحص.
curl -s "https://api.ad80.dev/v1/violations?app=com.example.news&from=2026-10-01&limit=100" \ -H "Authorization: Bearer $AD80_API_KEY"import os, requests
r = requests.get( "https://api.ad80.dev/v1/violations", headers={"Authorization": f"Bearer {os.environ['AD80_API_KEY']}"}, params={"app": "com.example.news", "from": "2026-10-01", "limit": 100}, timeout=30,)r.raise_for_status()for c in r.json()["creatives"]: broken = [s["ruleId"] for s in c["verdict"]["scores"] if s["violates"]] print(c["id"], c["network"], broken)const params = new URLSearchParams({ app: 'com.example.news', from: '2026-10-01', limit: '100' });const res = await fetch(`https://api.ad80.dev/v1/violations?${params}`, { headers: { Authorization: `Bearer ${process.env.AD80_API_KEY}` },});const { creatives } = await res.json();for (const c of creatives) { const broken = c.verdict.scores.filter((s) => s.violates).map((s) => s.ruleId); console.log(c.id, c.network, broken);}قراءة إعلان واحد
Section titled “قراءة إعلان واحد”النطاق read:creatives. إعلان واحد، ومعه verdict.description إن توفّر. إذا ظهرت الصورة نفسها في أكثر من تطبيق
لديك، يرجع الإعلان الذي شوهد آخرًا؛ أضف ?app=<appId> لتختار التطبيق.
curl -s "https://api.ad80.dev/v1/creatives/ad80px1:3f5c...e9?app=com.example.news" \ -H "Authorization: Bearer $AD80_API_KEY"مراجعة إعلان
Section titled “مراجعة إعلان”النطاق write:policies. أكّد المخالفة، أو سجّل أنها «ليست مخالفة». يرجع الإعلان مع قيمة review الجديدة.
| الحقل | معناه |
|---|---|
label | مطلوب: confirmed أو false_positive. |
ruleIds | اختياري: القواعد التي ينطبق عليها هذا الحكم. إن لم ترسله: كل القواعد المخالَفة. |
note | اختياري، حتى 500 حرف. |
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"}'import os, requests
r = requests.post( "https://api.ad80.dev/v1/creatives/ad80px1:3f5c...e9/feedback", headers={"Authorization": f"Bearer {os.environ['AD80_API_KEY']}"}, params={"app": "com.example.news"}, json={"label": "confirmed", "ruleIds": ["no-alcohol"]}, timeout=30,)print(r.json()["review"])const res = await fetch( 'https://api.ad80.dev/v1/creatives/ad80px1:3f5c...e9/feedback?app=com.example.news', { method: 'POST', headers: { Authorization: `Bearer ${process.env.AD80_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ label: 'confirmed', ruleIds: ['no-alcohol'] }), },);console.log((await res.json()).review);المراجعة لا توقف أي شيء. هي تسجّل رأيك فقط، ونستفيد منها لنتحقق من جودة التقييم.