The previous Search Ads 360 Reporting API is decommissioned. You can now create your reports using thenew Search Ads 360 Reporting API.
Note that thegetandgetByCustomerIdmethods in the Search Ads 360 Conversion API are being deprecated in Q3 2025. To continue accessing conversion data, you must create a report using theconversion resourceusing the new Search Ads 360 Reporting API. See more detailshere.
Conversion: insertStay organized with collectionsSave and categorize content based on your preferences.
Page Summary
Inserts a batch of new conversions into DoubleClick Search using the provided Conversion resource and requires authorization with thedoubleclicksearchscope.
Each conversion requires a unique ID, timestamp, and segmentation type (e.g., FLOODLIGHT).
Successful requests return a Conversion resource in the response body.
The API allows insertion of both offline and online conversions, with specific ID handling for each.
Developers can test the method using the provided APIs Explorer or the standalone Explorer.
Inserts a batch of new conversions into DoubleClick Search.Try it now.
Request
HTTP request
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization
This request requires authorization with the following scope:
In the request body, supply aConversion resourcewith the following properties:
Property name
Value
Description
Notes
Required Properties
conversion[].conversionId
string
For offline conversions, advertisers provide this ID. Advertisers can specify any ID that is meaningful to them. Each conversion in a request must specify a unique ID, and the combination of ID and timestamp must be unique amongst all conversions within the advertiser. For online conversions, DS copies thedsConversionIdorfloodlightOrderIdinto this property depending on the advertiser's Floodlight instructions.
conversion[].conversionTimestamp
unsigned long
The time at which the conversion took place, in epoch millis UTC.
conversion[].segmentationType
string
The segmentation type of this conversion (for example,FLOODLIGHT).
Acceptable values are:
"FLOODLIGHT"
Response
If successful, this method returns aConversion resourcein the response body.
Try it!
Use the APIs Explorer below to call this method on live data and see the response.
Alternatively, try thestandalone
Explorer.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-09 UTC."],[],["This outlines how to insert new conversions into DoubleClick Search using a POST request to the specified endpoint. Authorization with the `https://www.googleapis.com/auth/doubleclicksearch` scope is required. The request body should include a Conversion resource containing properties like `conversionId` (unique identifier), `conversionTimestamp` (time of conversion in UTC), and `segmentationType` (e.g., `FLOODLIGHT`). Successful requests return a Conversion resource in the response body.\n"]]
