Ads Format Interstitial

Frequency Cap Logic

# apps/ads/services/targeting.py
from apps.ads.models import AdEvent

def check_interstitial_cap(*, user_id: int, daily_limit: int = 3) -> bool:
    """Return True if user can see another interstitial today."""
    today_count = AdEvent.objects.filter(
        user_id=user_id,
        event_type="impression",
        ad_format="interstitial",
        created_at__date=timezone.now().date(),
    ).count()
    return today_count < daily_limit

Anti-Patterns

• No skip button or instant-close — violates ad policies
• Interstitials on every page navigation — drives users away
• Showing interstitials on mobile viewports < 300px wide
• No frequency cap — same user sees interstitial repeatedly

Quality Gate

& .\.venv\Scripts\python.exe -m ruff check . --fix
& .\.venv\Scripts\python.exe -m ruff format .
& .\.venv\Scripts\python.exe manage.py check --settings=app.settings_dev