apptvty 0.1.5 → 0.2.1

package/README.md

@@ -259,6 +259,21 @@ The `sponsored` field is present only when ads are enabled for your site and a m
 }
 ```
 
+---
+
+## Advertiser funding (X402)
+If you are an agent or company paying for ads, Apptvty supports autonomous pre-paid credits via USDC on Base.
+
+1. **Get the deposit address**: Run `npx apptvty init` or check the `platformDepositAddress` field in the `register()` response.
+2. **Send USDC**: Transfer the desired amount of USDC (Base network) to that address.
+3. **Sync your balance**: Call the wallet sync endpoint with your transaction hash:
+   ```bash
+   curl "https://api.apptvty.com/v1/wallet/sync?tx_hash=0x..."
+   ```
+   *Note: On-chain verification takes ~30-60 seconds.*
+
+---
+
 Response headers always include:
 - `Content-Type: application/json`
 - `Cache-Control: no-store`
@@ -278,25 +293,12 @@ const client = new ApptvtyClient({
   siteId: process.env.APPTVTY_SITE_ID!,
 });
 
-// 30-day overview
-const stats = await client.getSiteStats();
-console.log(`AI traffic: ${stats.ai_percentage}%`);
-
-// Recent activity (last hour)
-const { activity } = await client.getSiteActivity(20);
-activity.forEach(a => console.log(a.path, a.crawler_type, a.status_code));
-
-// Recent agent queries
-const { queries } = await client.getSiteQueries(10);
-
-// Crawler breakdown
-const { crawlers } = await client.getSiteCrawlers(7);
-
-// Daily stats
-const { stats: daily } = await client.getSiteDailyStats(30);
-
 // Wallet balance
 const wallet = await client.getSiteWallet();
+
+// Ad Campaign Insights (for advertisers)
+const insights = await client.getCampaignInsights('camp_123');
+console.log(`Top site: ${insights.top_publishers[0].domain}`);
 ```
 
 | Method | Returns |
@@ -307,6 +309,24 @@ const wallet = await client.getSiteWallet();
 | `getSiteQueries(limit?)` | Recent agent queries |
 | `getSiteCrawlers(days?)` | Crawler type breakdown |
 | `getSiteWallet()` | Balance, earnings, spend |
+| `getCampaignInsights(id)` | Ad performance (impressions per site, daily spend) |
+
+---
+
+## Local logs dashboard
+Deploy a localized analytics portal on your own domain using the framework-agnostic dashboard handler.
+
+### Next.js (App Router)
+```typescript
+// app/api/apptvty/logs/route.ts
+import { createNextjsDashboardHandler } from 'apptvty/nextjs';
+
+export const GET = createNextjsDashboardHandler({
+  apiKey: process.env.APPTVTY_API_KEY!,
+  siteId: process.env.APPTVTY_SITE_ID!,
+});
+```
+Your dashboard is now available at `https://yoursite.com/api/apptvty/logs`.
 
 ---