get_dashboard_snapshot
Return Adlyse’s latest dashboard snapshot: ABI score & band, waste breakdown, safe-budget-to-add, efficiency score, headline totals, and a recent-impact summary. Snapshots are pre-computed daily by the sync pipeline.
Omit ad_account_id for the organization-level aggregate across all connected accounts.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
ad_account_id | string? | no | null | Ad account id. Omit for the org-level aggregate |
as_of | string? | no | null | YYYY-MM-DD. Returns the latest snapshot on or before this date |
Returns#
json
{
"snapshot": {
"ad_account_id": "ad_acct_abc123",
"organization_id": "org_xyz",
"date": "2026-04-21",
"abi": {
"score": 72,
"band": "above baseline",
"confidence": "High",
"components": {
"efficiency": 0.82,
"waste_ratio": 0.12,
"scale_headroom": 0.80
}
},
"waste": {
"percent": 12.5,
"amount_micros": 5000000,
"amount_dollars": 5.00,
"breakdown": { "method": "rank_lost_is_estimate", "byPlatform": { } }
},
"safe_budget_to_add": {
"daily_micros": 10000000,
"daily_dollars": 10.00,
"note": "~$10/day additional budget at similar efficiency",
"details": { "method": "budget_lost_is_estimate", "byPlatform": { } }
},
"totals": {
"cost_micros": 100000000,
"cost_dollars": 100.00,
"impressions": 73500,
"clicks": 3570,
"conversions": 15.0,
"conversion_value": 19600.0,
"efficiency_score": 0.15
},
"recent_impact": { },
"computation_duration_ms": 34
},
"scope": "account",
"as_of": "2026-04-21",
"source": "adlyse.dashboard_compute@v1"
}| Field | Description |
|---|---|
snapshot.abi.score | 0–100 composite |
snapshot.abi.band | "above baseline" (≥70), "at baseline" (40–69), "below baseline" (<40) |
snapshot.abi.confidence | High / Medium / Low, based on data volume |
snapshot.abi.components | efficiency, waste_ratio, scale_headroom — each 0–1 |
snapshot.waste.breakdown.method | rank_lost_is_estimate, meta_cpa_outlier, mixed, insufficient_data, unsupported |
snapshot.safe_budget_to_add.note | Human-readable recommendation |
snapshot.recent_impact | Same shape as get_impact_analysis |
scope | "account" or "organization" |
as_of | Date of the returned snapshot |
See Dashboard for the full computation methodology.
Errors#
error_type | When |
|---|---|
auth_error | Missing / invalid API key |
not_found | Ad account not in your org, or no snapshot yet (account not synced) |
validation_error | as_of not a valid YYYY-MM-DD date |
Example#
Request:
json
{
"ad_account_id": "ad_acct_wNkoZfSpRtL8oCNVAveYHe3o"
}Response (excerpt):
json
{
"snapshot": {
"date": "2026-04-21",
"abi": { "score": 36, "band": "below baseline", "confidence": "Medium" },
"waste": { "percent": 28.5, "amount_dollars": 581.64 },
"safe_budget_to_add": { "daily_dollars": 0, "note": "Campaigns are not budget-constrained" }
},
"scope": "account",
"as_of": "2026-04-21",
"source": "adlyse.dashboard_compute@v1"
}See also#
get_impact_analysis— causal reasoning over recent changes- Dashboard — methodology and in-app view