Get conversion by ID

GET 
/ad-publishing/google/conversions/:conversionId

Retrieve a specific Google Ads conversion action by ID

Request

Version stringrequired

API Version

Available optionsv3

conversionId stringrequired

Conversion identifier

locationId stringrequired

Location identifier

application/json

The conversion action, including removed ones

application/json

Schema

Schema

idstringrequired

Google Ads conversion action id

resourceNamestringrequired

Google Ads resource name

namestringrequired

Conversion action name

statusstringrequired

Conversion action status. REMOVED actions are still readable by id.

typestringrequired
Conversion action type
Available optionsUPLOAD_CLICKSUPLOAD_CALLSWEBPAGELEAD_FORM_SUBMIT
categorystringrequired
Conversion action category
Available optionsDEFAULTPAGE_VIEWPURCHASESIGNUPLEADDOWNLOADADD_TO_CARTBEGIN_CHECKOUTSUBSCRIBE_PAIDPHONE_CALL_LEADIMPORTED_LEADSUBMIT_LEAD_FORM
valueSettingsobjectrequired

Value configuration

countingTypestringrequired
How conversions are counted per click
Available optionsONE_PER_CLICKMANY_PER_CLICK
attributionModelSettingsobjectrequired

Attribution configuration

includeInConversionsMetricbooleanrequired

Whether this action feeds the Conversions reporting metric

clickThroughLookbackWindowDaysstringrequired

Click-through lookback window in days, returned as a string

viewThroughLookbackWindowDaysstringrequired

View-through lookback window in days, returned as a string

Example (auto)

{
  "id": "7142742902",
  "resourceName": "customers/6776452901/conversionActions/7142742902",
  "name": "Offline purchase",
  "status": "ENABLED",
  "type": "UPLOAD_CLICKS",
  "category": "PURCHASE",
  "valueSettings": {
    "defaultValue": 0,
    "defaultCurrencyCode": "XXX",
    "alwaysUseDefaultValue": true
  },
  "countingType": "MANY_PER_CLICK",
  "attributionModelSettings": {
    "attributionModel": "GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN"
  },
  "includeInConversionsMetric": true,
  "clickThroughLookbackWindowDays": "90",
  "viewThroughLookbackWindowDays": "1"
}