Google AdsVersion: v3

Get conversion by ID

GET/ad-publishing/google/conversions/{conversionId}

Retrieve a specific Google Ads conversion action by ID

Authorizations

Authorizationstringheaderrequired

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

Scope:adPublishing.readonly

Auth methods:OAuthPrivate Integration

Token type:Sub-Account Token

Request

Headers

Versionstringrequired

API Version

Available optionsv3

Example:v3

Path Parameters

conversionIdstringrequired

Conversion identifier

Example:123456789

Query Parameters

locationIdstringrequired

Location identifier

Example:HChooFuiyPpVYzeJ4HMe

Response

application/json

The conversion action, including removed ones

idstringrequired

Google Ads conversion action id

Example:7142742902

resourceNamestringrequired

Google Ads resource name

Example:customers/6776452901/conversionActions/7142742902

namestringrequired

Conversion action name

Example:Offline purchase

statusstringrequired

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

Example:ENABLED

typestringrequired

Conversion action type

Available optionsUPLOAD_CLICKSUPLOAD_CALLSWEBPAGELEAD_FORM_SUBMITAD_CALL

Example:UPLOAD_CLICKS

categorystringrequired

Conversion action category

Available optionsDEFAULTPAGE_VIEWPURCHASESIGNUPLEADDOWNLOADADD_TO_CARTBEGIN_CHECKOUTSUBSCRIBE_PAIDPHONE_CALL_LEADIMPORTED_LEADSUBMIT_LEAD_FORM

Example:PURCHASE

valueSettingsobjectrequired

Value configuration

countingTypestringrequired

How conversions are counted per click

Available optionsONE_PER_CLICKMANY_PER_CLICK

Example:MANY_PER_CLICK

attributionModelSettingsobjectrequired

Attribution configuration

includeInConversionsMetricbooleanrequired

Whether this action feeds the Conversions reporting metric

Example:true

clickThroughLookbackWindowDaysstringrequired

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

Example:90

viewThroughLookbackWindowDaysstringrequired

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

Example:1