Get conversions

GET 
/ad-publishing/google/conversions

Retrieve Google Ads conversion actions for a location. The response shape is selected by type. When type is AD_MANAGER: without limit a plain array of full conversion actions, and with limit (max 100, default 100) a paginated { conversions, paging } envelope — pass pageToken (from paging.next) for the next batch. When type is omitted or AD_WORDS, a different, minimal snake_case projection is returned and limit, pageToken, startDate, endDate, conversionType and category are all ignored.

Request

Version stringrequired

API Version

Available options2021-07-28

locationId stringrequired

Location identifier

type string

Integration type

Available optionsAD_MANAGERAD_WORDS

conversionType string

Conversion action type to filter by

Available optionsUPLOAD_CLICKSUPLOAD_CALLSWEBPAGELEAD_FORM_SUBMIT

category string

Conversion action category to filter by

Available optionsDEFAULTPAGE_VIEWPURCHASESIGNUPLEADDOWNLOADADD_TO_CARTBEGIN_CHECKOUTSUBSCRIBE_PAIDPHONE_CALL_LEADIMPORTED_LEADSUBMIT_LEAD_FORM

startDate string

Filter start date

endDate string

Filter end date

limit string

Page size for a paginated fetch (max 100, defaults to 100). When set, the response is a { conversions, paging } envelope instead of a plain array. Applies to AD_MANAGER type only.

pageToken string

Opaque cursor for the next batch, taken from the previous response paging.next

application/json

Minimal array when type is omitted/AD_WORDS, a full array for AD_MANAGER, or a { conversions, paging } envelope for AD_MANAGER with limit

application/json

Schema

Schema

oneOf
• object[]
• object[]
• PaginatedGoogleConversionsDTO
Array [
conversion_action_idstringrequired
Google Ads conversion action id
conversion_namestringrequired
Conversion action name
conversion_sourcestringrequired
Always UPLOAD on this branch
]

Example (auto)

[
  {
    "conversion_action_id": "7086809727",
    "conversion_name": "Offline purchase",
    "conversion_source": "UPLOAD"
  }
]