The previous Search Ads 360 Reporting API is decommissioned. You can now create your reports using thenew Search Ads 360 Reporting API.

Note that theget andgetByCustomerId methods 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 resource using the new Search Ads 360 Reporting API. See more detailshere.

The remainingSearch Ads 360 Conversion API functions will continue to be supported.

Upload Data About Conversions

  • Search Ads 360 reports a conversion when a customer completes a pre-defined action on an advertiser's website, such as purchasing an item or requesting information.

  • You can upload offline conversion data to Search Ads 360 to enhance reports, use in automated rules, or for bid strategy optimization.

  • Conversion values can be modified to account for factors like discounts, returns, or credits applied after a purchase.

  • The Search Ads 360 API allows you to get, insert, and update conversions, but it cannot be used to send personally identifiable information or for advertising targeting.

  • To attribute conversions, each conversion needs to specify the Search Ads 360 ID of an ad, keyword, and campaign, or utilize a click ID to track the click and attribute accordingly.

When a customer completes a pre-defined action on an advertiser's website, such as purchasing an item or requesting more information, Search Ads 360 reports aconversion.

Conversions for some advertisers start online and finish offline. For example, a consumer initiates research online for a purchase, clicks on an ad, and then telephones a call center to complete the purchase. Or a consumer with a smartphone taps a “call now” button in an ad and purchases an item over the telephone. For these conversions, Search Ads 360 will automatically have data about the online portion. If you want to provide data about the offline portion—to enhance reports, for use in automated rules, or for optimization in a bid strategy—you can upload it to Search Ads 360.

In some cases, you might need to modify the value of an existing conversion. For example, you might edit a conversion value to account for discounts that were applied after an online purchase was made (such as a mail-in-rebate), returns that occurred with a restocking fee, or credits that were applied after the purchase.

After you've set up your client app as described inMy First App (includingactivating the conversion service), you can send the following conversion-related requests to the Search Ads 360 API:

Insert

Adds new conversions.

Update

Modifies existing conversions.

Advertisers are prohibited from using the Search Ads 360 API to send personally identifiable information, as outlined by theTerms of Service for the API. Further, this API provides no ability to target advertising. The conversion data is used by advertisers to better manage and report on the amount they pay for advertising and the ROI they get from it.

Synchronous Requests

All conversion requests are synchronous. You can make parallel synchronous requests (up to your project's limit) in a single client.

Search Ads 360 IDs and Conversions

Because conversions need to be attributed to a specific campaign, ad, keyword, and optionally to a visit, each conversion specifies the Search Ads 360 ID of an ad, keyword, and campaign, along with the IDs of the parent objects in theSearch Ads 360 hierarchy. When you get, add, or update a conversion, you'll need to specify most of these IDs in the request.

Obtaining Search Ads 360 IDs

To find these IDs, do any of the following:

  • Use the Search Ads 360 UI todownload a report that contains IDs for the advertiser, engine accounts, campaigns, ad groups, keywords, and ads.

  • Add Search Ads 360 macros such asCampaignID andTrackerID to your landing page URLs. When a customer clicks an ad, each macro will instruct Search Ads 360 to pass its ID to the advertiser's landing page as URL parameter. You can retrieve these IDs from the advertiser's web logs and use them in yourConversion requests.

    Search Ads 360 provides a few different macros for sending keyword IDs to a landing page. To attribute conversions to a keyword, you'll need to add theTrackerID macro to the landing page URLs.

Click IDs

Aclick ID tracks a click on an ad, and you can use it to attribute a conversion to a specific visit instead of providing the entire hierarchy of IDs for Search Ads 360 objects. Search Ads 360 will use the click ID to find and attribute the appropriate keyword and ad.

Click IDs are case-sensitive, somake sure your web logs and tracking software do not change the case of the click ID.

Generating a Click ID

Either Search Ads 360 or Google Ads generates the click ID.

Ifauto-tagging is enabled in an Google Ads account, Google Ads generates a click ID when an ad is shown. As a result, if a user clicks on a particular ad impression multiple times, those clicks will be associated with only one click ID. Landing page visits for the exact same impression will share the same click ID.

Search Ads 360 can generate a click ID if you activate the conversion API service. If a click is redirected from Google Ads and Google Ads has already generated a click ID, Search Ads 360 uses the Google Ads ID instead of generating a new one. If a click is redirected from another type of supported engine, Search Ads 360 generates the ID.

Click ID Parameters

Each click ID consists of two parameters. For example:

gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds

Thegclid parameter contains a case-sensitive ID for the click. Search Ads 360 maintains the attribution information (such as keyword, ad, campaign, ad group) for each click ID generated.

Thegclsrc parameter indicates the source of the click ID. Currently, it can have one of the following values:

  • gclsrc=ds: the click ID was generated by Search Ads 360. In addition, the click was either on an engine other than Google, or the click was on Google but the Google Ads account is not using auto-tagging.

  • gclsrc=aw.ds: the click ID was generated by Google Ads that is using auto-tagging, and the click went through the Search Ads 360 clickserver.

  • gclsrc=: the parameter is empty if the click ID was generated by Google Ads, but the conversion API service was not enabled in Search Ads 360 when the click occurred.

Tip: We recommend you use the landing page of the website to keep track of the customer's offline contact information (such as phone number called) together with the click ID. When an offline conversion happens, the click ID can then be used to report the conversion back to Search Ads 360.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-08-28 UTC.