Zernio
APIFor you
Zernio
APIFor you
API Reference

Conversions API

List account conversion goalsGETList conversion actionsGETList associated campaignsGETList conversion destinationsGETList custom conversion goalsGETList event destinationsGETList stored eventsGETCreate website conversion actionPOSTCreate a conversion destinationPOSTCreate a custom conversion goalPOSTAdd an event destinationPOSTGet a conversion destinationGETGet attribution metricsGETGet Event Match QualityGETUpdate account conversion goalsPATCHUpdate a conversion action's settingsPATCHUpdate a conversion destinationPATCHUpdate a custom conversion goalPATCHDelete a conversion destinationDELETERemove an event destinationDELETEAssociate campaignsPOSTAdjust uploaded conversionsPOSTRemove associated campaignsDELETERemove a custom conversion goalDELETESend conversion eventsPOSTSend events to every destinationPOST
Dashboard
OverviewPlatformsAPI ReferenceResources
Conversions API

List stored events

Lists the conversion events stored for a profile by POST /v1/events, newest first. Personal data is never returned: hasEmail, hasPhone and hasExternalId only say whether the event carried that identifier. Events sent with testCode are not stored, so they never appear here.

Paginate with cursor: pass the nextCursor of the previous page until it comes back null.

GET
/v1/events

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

profileId*string
limit?integer
Range1 <= value <= 200
Default50
from?string

Only events at or after this time (ISO 8601, on the event time).

Formatdate-time
to?string

Only events before this time (ISO 8601, on the event time).

Formatdate-time
eventName?string

Only events with this name, such as Purchase.

cursor?string

nextCursor from the previous page.

Response Body

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.conversions.listEvents({  query: {    profileId: 'profile_abc123',  },});console.log(data);
{  "events": [    {      "eventId": "string",      "eventName": "string",      "eventTime": "2019-08-24T14:15:22Z",      "receivedAt": "2019-08-24T14:15:22Z",      "actionSource": "string",      "value": 0,      "currency": "string",      "sourceUrl": "string",      "utm": {        "source": "string",        "medium": "string",        "campaign": "string",        "content": "string"      },      "zrn": "string",      "clickIds": {        "gclid": "string",        "fbc": "string"      },      "destinationsSent": 0,      "hasEmail": true,      "hasPhone": true,      "hasExternalId": true,      "ad": {        "platform": "googleads",        "customerId": "string",        "campaignId": "string",        "adGroupId": "string",        "adSetId": "string",        "adId": "string"      }    }  ],  "nextCursor": "string"}
Was this page helpful?

List event destinations

Lists the ad platform destinations that receive events sent to `POST /v1/events`, for one profile or every profile you can access.

Create website conversion action

Creates a Google Ads website conversion action and returns the tag snippets to install on your site. Creates a `WEBPAGE` conversion action (category `DEFAULT`) and returns it with its tag snippets, read back after creation since Google never returns them on the create response itself. Invalidates the cached list `GET` on this resource would otherwise keep serving. Google-only; other platforms return `501`. Requires the Ads add-on.