Zernio
APIFor you
Zernio
APIFor you
API Reference

Automated Rules

Rules

List ad rulesGETCreate an ad rulePOSTGet an ad ruleGETUpdate an ad rulePATCHDelete an ad ruleDELETE

Preview and History

Preview an ad rulePOSTList an ad rule's runsGET
Dashboard
OverviewPlatformsAPI ReferenceResources
Automated Rules

List an ad rule's runs

Lists a rule's scheduled runs, newest first: what each run evaluated, matched and did.

PlatformsMetaGoogleTikTokLinkedInPinterestX
GET
/v1/ads/rules/{ruleId}/runs

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

ruleId*string

Query Parameters

limit?integer
Range1 <= value <= 100
Default20
skip?integer
Range0 <= value
Default0

Response Body

application/json

application/json

application/json

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adrules.listAdRuleRuns({  path: {    ruleId: 'rule_abc123',  },});console.log(data);
{  "runs": [    {      "id": "string",      "ranAt": "2019-08-24T14:15:22Z",      "outcome": "triggered",      "objectsEvaluated": 0,      "actedObjectIds": [        "string"      ],      "evaluation": {        "today": "2019-08-24",        "timezone": "string",        "timezoneAssumed": true,        "currency": "string",        "matched": [          {            "id": "string",            "name": "string",            "campaignId": "string",            "matched": true,            "conditions": [              {                "metric": "spend",                "window": "today",                "op": ">",                "value": 0,                "actual": 0,                "met": true              }            ]          }        ],        "actions": [          {            "objectId": "string",            "type": "pause",            "status": "done",            "reason": "string",            "previousDailyBudget": 0,            "newDailyBudget": 0          }        ]      },      "error": "string"    }  ]}
Was this page helpful?

Preview an ad rule

Evaluates a rule against current metrics and returns what it would match right now, without acting on anything, sending a webhook or starting a cooldown. Works on disabled rules.

List account conversion goals

Lists a Google Ads account's default conversion goals, which ones are used for bidding, and the conversion actions in each. Google Ads account-default conversion goals (CustomerConversionGoal), one per category and origin, with `biddable` (whether the goal is used for bidding and reported in the Conversions column) and the conversion actions that belong to it, each flagged `primaryForGoal` (primary) or not (secondary). Reads are cached for 10 minutes; when the shared Google quota is exhausted the last successful result is served with `stale: true`.