# IdleFlow

IdleFlow is a B2B ad network for AI wait time. AI app publishers install one
JavaScript SDK tag, IdleFlow detects loading/thinking states, advertisers buy
verified five-second impressions with max CPM and campaign budget, and
publishers keep 70% of verified revenue.

## Key URLs

- Home: /
- Publisher portal: /publisher.html
- Advertiser portal: /advertise.html
- Developer docs: /docs.html
- SDK test page: /sdk-test.html
- Privacy: /privacy.html
- Publisher terms: /legal/terms-publishers.html
- Advertiser terms: /legal/terms-advertisers.html
- SDK license: /legal/sdk-eula.html

## Publisher SDK Quickstart

```html
<script async
  src="https://YOUR_DOMAIN/sdk/publisher.js"
  data-publisher-id="pub_yourid"
  data-app-id="app_yourapp">
</script>
```

Manual loading-state API:

```js
window.idleflow.signalBusy(true);
window.idleflow.signalBusy(false);
```

Test mode:

```html
<script async src="/sdk/publisher.js" data-publisher-id="test" data-mode="test"></script>
```

## Public API Shape

- `GET /v1/market` returns live market stats.
- `POST /v1/market/estimate` estimates daily impressions for targeting.
- `GET /v1/ads/sdk?publisherId=...&appId=...` returns SDK ad decisions.
- `POST /v1/events` ingests SDK impression/click events.

Authenticated publisher and advertiser dashboard APIs use Firebase Auth ID
tokens in the `Authorization: Bearer <token>` header.