ZEzernio
Conversions

List conversion actions

Changed on

Lists the conversion actions in a Google Ads account, with the website tag snippets to install where available.

Lists Google Ads conversion actions on the resolved customer, all types by default. Each action's tagSnippets (global site tag + event snippet) is included when Google has them for that action's type, e.g. WEBPAGE. Google-only; other platforms return 501. Requires the Ads add-on.

adAccountId (alias customerId) is optional: when omitted, it is resolved from the connection's accessible Google Ads customers, and the call fails with 400 when more than one is accessible (pass adAccountId to disambiguate).

The list itself is cached for the quota window (1 hour fresh, up to 7 days last-good; the cache key does not vary on type). The response carries cachedAt and stale, set when a quota-exhausted call falls back to the last-good copy instead of a live read.

get/v1/ads/conversions/actions

Request

  • Base URL
    https://zernio.com/api
  • Auth
    HTTP bearer

Query parameters

accountIdstring required

SocialAccount _id (must be a googleads account).

adAccountIdstring

Platform ad account ID (Google customer ID, digits only). Resolved automatically when the connection has exactly one accessible customer.

customerIdstring

Alias of adAccountId, kept for existing callers

typestring

Filter by Google's ConversionActionType enum (e.g. WEBPAGE, UPLOAD_CLICKS).

Response

The resolved customer and its conversion actions.

customerIdstring

The Google Ads customer id the actions were read from.

cachedAtstring date-time nullable

When this list was fetched from Google. Null when it was never served from cache.

staleboolean

True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.

Changes

  • d568bb00ed73Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 98e9f11e6b3aRevision changes
    • info

      added the non-success response with the status