ads
GET /v1/ads/connections/{connection_id}/scorecard
Did each automatic change do what it said? The 14-day scorecard (za-214).
Authentication
Send an API key as a bearer token. The key must carry the ads.view permission; a key without it is refused with 403, not 404.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X GET https://api.zinndigital.com/v1/ads/connections/{connection_id}/scorecard \
-H "Authorization: Bearer zdk_live_…"Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
Gated on ads.view. Every automatic change of the last 30 days, newest first (at most 500), read from the rows the daily scorecard stored (docs/1006 §42) — never a network call in the request. Each change states its expected effect when it is made (expected: the metric, the direction, the size it should move by, the harm that counts as worse, the 14-day window); 14 days on the scorecard measures the 14 days after against the 14 days before on its campaign — first-party outcomes where we have them (basis: first_party), else the ad network's own conversions (basis: google). Outcomes are thousandths, spend is micros of currency, change_bp is the move in the stated direction in basis points. verdict: pending (not due yet), better, same, worse, no_data (too little to say: never undone on noise), gone (undone before it was judged). A worse change's undo_state: proposed (one click on the findings list: suggestion_id), undone (automatic changes on for its kind), owner_lock, freeze (the campaign is learning a new bid strategy), standing (the organisation is not in good standing), not_undoable, failed, expired. A customer's change keeps its own 30-day Undo (change_id).
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
connection_id (path) | string | Yes | — |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
data | AdsScoreRow[] | Yes | — |
totals | object | Yes | — |
window_days | integer | Yes | — |
Errors this endpoint can return
401 · 403 · 404 · 429