Conversions

Update a conversion action's settings

Changed on

Changes a Google Ads conversion action's settings, such as primary or secondary, counting, value and lookback windows, or removes or restores it.

Updates a Google Ads conversion action in one mutate, each field sent written on its own update mask leaf so omitted fields keep their value. Send at least one field.

primaryForGoal sets primary_for_goal: a primary action counts toward its goal's bidding and the Conversions column; a secondary one is observation-only (All conversions). countingType, category, the value settings (defaultValue, defaultCurrency, alwaysUseDefaultValue) and the click-through / view-through lookback windows map to the same-named conversion_action fields.

status: REMOVED removes the action (Google keeps it, with its history, as REMOVED) and must be sent alone; status: ENABLED restores a removed action. Google refuses HIDDEN on website actions, so it is not offered.

patch/v1/ads/conversions/actions/{actionId}

Request

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

Path parameters

actionIdstring required

Google conversion action id

Request body

accountIdstring required

Zernio SocialAccount id (Google Ads)

adAccountIdstring

Google customer id. Required when the connection has multiple customers.

customerIdstring

Alias of adAccountId

namestring
status'ENABLED' | 'REMOVED'

REMOVED removes the action and must be sent alone; ENABLED restores a removed one.

defaultValuenumber
alwaysUseDefaultValueboolean
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.

Response

Action updated

customerIdstring

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

    • 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 non-success response with the status