swads-video-product-analysis/examples/README.md

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:

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.