ads
GET /v1/ads/connections/{connection_id}/account-checks
The house checks on this account, in figures (za-82, za-83, za-88, za-89).
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}/account-checks \
-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. What the daily audit's house checks concluded on the caller's own connection (docs/1006 §55), read from the rows it stored — never a network call in the request. maturity (za-82): the account's conversion rate as a Bayesian estimate (a prior of prior_clicks clicks at prior_rate, updated with the account's own ad-group clicks and conversions over window_days) and clicks_needed, the clicks a search term or keyword needs before "no conversion" is judged. shared_budgets (za-83): campaigns moved off a shared budget in the last window_days days (moved), shared budgets waiting for one click with automatic changes off (waiting, each with its suggestion_id on the findings list), and campaigns Google refused to move (refused). recommendations (za-88): Google's recommendations as our rules reviewed them — ignored (dismissed at Google), part (our own version is written instead), owner (the customer's to decide), accepted. self_audit (za-89): what the automatic changes of the last 28 days did — the audit's own negatives and what those searches cost before and since, each keyword it added and its figures since, and the changes the collision check refused this week. Money is micros of currency; conversions are thousandths.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
connection_id (path) | string | Yes | — |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
currency | string | Yes | — |
window_days | integer | Yes | — |
maturity | object | Yes | — |
shared_budgets | object | Yes | — |
recommendations | object | Yes | — |
self_audit | object | Yes | — |
reconcile | object | Yes | za-87 — the customer's outcomes of the window against Google's latest count of them. states splits the difference: processing = uploaded in the last two days (Google reports… |
Errors this endpoint can return
401 · 403 · 404 · 429