Add synthetic end-to-end example

2026-08-25 17:29:32 +08:00
parent 7d99bd9a23
commit b4f167c2e6
6 changed files with 160 additions and 0 deletions
@@ -0,0 +1,27 @@
+# Synthetic Script Daily Report example
+
+This example shows the complete artifact shape without using a real account, credentials, customer names, or live campaign data.
+
+## Files
+
+- `query.json` — synthetic `creative_breakdown` response. It deliberately includes one product-card row so the helper's video-only exclusion is observable.
+- `report-data.json` — deterministic output from the aggregation helper with `--top 2`.
+- `script-daily-report.html` — self-contained example report with exactly three cross-product scripts.
+- `script-daily-report.png` — rendered primary deliverable.
+
+## Reproduce the aggregation
+
+From the repository root:
+
+```bash
+python3 scripts/aggregate_video_products.py examples/query.json --top 2 > /tmp/swads-example-output.json
+diff -u examples/report-data.json /tmp/swads-example-output.json
+```
+
+An empty diff confirms that product-card delivery was excluded and the aggregate ratios were recomputed from numerators and denominators.
+
+## Expected interpretation
+
+- The demo pot has the stronger CTR and ROAS at useful but still limited scale; preserve its visible specification proof and test controlled variants.
+- The demo jug has positive attributed revenue, but the capacity/leak proof version has clicks without orders; strengthen proof and product-page alignment.
+- The three example scripts are derived from these synthetic patterns. Live reports must derive new scripts from the requested reporting window and must not copy these scripts by default.