Upsert conversion

PUT 
/ad-publishing/google/conversions

Create or update a Google Ads conversion action

Request

Version stringrequired

API Version

Available optionsv3

application/json

application/json

Body

Bodyrequired

locationIdstringrequired

Location identifier

conversionIdstring

Conversion identifier

namestringrequired

Conversion name

typestringrequired
Conversion action type. Only UPLOAD_CLICKS is supported — the conversion list endpoint reads back UPLOAD_CLICKS actions only, so a conversion created with any other type would never be returned.
Available optionsUPLOAD_CLICKS
categorystringrequired
Conversion action category
Available optionsDEFAULTPAGE_VIEWPURCHASESIGNUPLEADDOWNLOADADD_TO_CARTBEGIN_CHECKOUTSUBSCRIBE_PAIDPHONE_CALL_LEADIMPORTED_LEADSUBMIT_LEAD_FORM
valueSettingsobjectrequired

Value settings that control how monetary value is attributed to conversions

countingTypestringrequired
How conversions are counted per interaction
Available optionsONE_PER_CLICKMANY_PER_CLICK
attributionModelstringrequired
Attribution model used to credit conversions
Available optionsGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVENGOOGLE_ADS_LAST_CLICK
clickThroughWindownumberrequired

Click-through conversion window in days

Example (auto)

{
  "locationId": "loc_abc123",
  "conversionId": "conv_456",
  "name": "Purchase Conversion",
  "type": "UPLOAD_CLICKS",
  "category": "PURCHASE",
  "valueSettings": {
    "defaultValue": "10.00",
    "defaultCurrencyCode": "USD",
    "alwaysUseDefaultValue": false
  },
  "countingType": "ONE_PER_CLICK",
  "attributionModel": "GOOGLE_ADS_LAST_CLICK",
  "clickThroughWindow": 30
}

application/json

Resource name of the created or updated conversion action

application/json

Schema

Schema

resourceNamestringrequired

Resource name of the created or updated record

Example (auto)

{
  "resourceName": "customers/6776452901/conversionActions/7142718149"
}