ZEzernio
Conversions

Create conversion action

Changed on

Creates a Google Ads conversion action: a website one counted by a tag on your site, or one counted from the conversions you send to Zernio.

  • type: WEBPAGE creates a website action and returns it with the tag snippets to install, read back after creation since Google never returns them on the create response itself.
  • type: UPLOAD_CLICKS creates an action for the conversions sent with POST /v1/events, the same action POST /v1/ads/conversions/destinations creates. It is secondary unless primaryForGoal: true.

The category defaults to DEFAULT. A name already used by another action returns Google's error.

Clears the cached list that GET on this resource would otherwise keep serving. Google-only; other platforms return 501. Requires the Ads add-on.

post/v1/ads/conversions/actions

Request

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

Request body

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

namestring required
type'WEBPAGE' | 'UPLOAD_CLICKS' required

WEBPAGE for a website tag, UPLOAD_CLICKS for the conversions you send to Zernio.

defaultValuenumber

Default conversion value used when an event doesn't carry its own value.

alwaysUseDefaultValueboolean

When true, always use defaultValue and ignore any value sent with the event. Defaults to true when defaultValue is set.

category'DEFAULT' | 'PAGE_VIEW' | 'PURCHASE' | 'SIGNUP' | 'DOWNLOAD' | 'ADD_TO_CART' | 'BEGIN_CHECKOUT' | 'SUBSCRIBE_PAID' | 'PHONE_CALL_LEAD' | 'IMPORTED_LEAD' | 'SUBMIT_LEAD_FORM' | 'BOOK_APPOINTMENT' | 'REQUEST_QUOTE' | 'GET_DIRECTIONS' | 'OUTBOUND_CLICK' | 'CONTACT' | 'ENGAGEMENT' | 'STORE_VISIT' | 'STORE_SALE' | 'QUALIFIED_LEAD' | 'CONVERTED_LEAD'

conversion_action.category. Defaults to DEFAULT on create.

countingType'ONE_PER_CLICK' | 'MANY_PER_CLICK'

ONE_PER_CLICK counts one conversion per ad click (leads); MANY_PER_CLICK counts every one (purchases).

defaultCurrencystring

ISO 4217 currency of defaultValue (value_settings.default_currency_code).

clickThroughLookbackWindowDaysinteger

Days after an ad click a conversion still counts.

viewThroughLookbackWindowDaysinteger

Days after an ad view a view-through conversion still counts.

primaryForGoalboolean

true = primary (counts toward bidding when its goal is biddable), false = secondary. Defaults to secondary for UPLOAD_CLICKS.

Response

The created conversion action, with its tag snippets.

Changes

  • 34f8dbff5e0dRevision changes
    • info

      added the new UPLOAD_CLICKS enum value to the request property

  • 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