Skip to main content
Google AdsVersion: v3

Upsert conversion

PUT/ad-publishing/google/conversions

Create or update a Google Ads conversion action

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Body

application/json
locationIdstringrequired

Location identifier

Example:loc_abc123
conversionIdstring

Conversion identifier

Example:conv_456
namestringrequired

Conversion name

Example:Purchase Conversion
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
Example:UPLOAD_CLICKS
categorystringrequired

Conversion action category

Available optionsDEFAULTPAGE_VIEWPURCHASESIGNUPLEADDOWNLOADADD_TO_CARTBEGIN_CHECKOUTSUBSCRIBE_PAIDPHONE_CALL_LEADIMPORTED_LEADSUBMIT_LEAD_FORM
Example:PURCHASE
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
Example:ONE_PER_CLICK
attributionModelstringrequired

Attribution model used to credit conversions

Available optionsGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVENGOOGLE_ADS_LAST_CLICK
Example:GOOGLE_ADS_LAST_CLICK
clickThroughWindownumberrequired

Click-through conversion window in days

Example:30

Response

application/json

Resource name of the created or updated conversion action

resourceNamestringrequired

Resource name of the created or updated record

Example:customers/6776452901/conversionActions/7142718149