Skip to content
Glossary · Advertising

Data Manager API

Google Data Manager API

How it works

A server sends events to the API, for example a lead or a won deal. Each event carries a click ID (gclid, gbraid or wbraid) or hashed contact data, plus time, value, currency, a transaction ID and consent information. Google assigns it to a conversion action in the Google Ads account. The API also takes audience lists, for example for Customer Match.

Besides Google Ads, it serves other products such as Display & Video 360 and Google Analytics. Google calls it the new standard for data integration with its advertising products and says new features will launch only there.

Why it matters

For Google Ads, the API is the way to report conversions from a server: including ones that never happen in the browser, like a deal in the CRM. The click ID and the data for enhanced conversions for leads travel in the same event. The more complete this data is, the better the bidding strategy can optimize for real customers instead of form submissions. TSO uses the Data Manager API for Google Ads and sends every conversion with the person's latest Google click, hashed contact data, value and the consent information from the visit.

Example

A real estate agent gets an inquiry from a search ad. Five weeks later the purchase contract is signed, and the commission is €12,000. The event "deal won" goes to the API with the gclid, the hashed email and €12,000 as its value. In Google Ads the value shows up for the campaign, and a bidding strategy like target ROAS can work with it.

Common mistakes

  • Wrong conversion action: server conversions need an action that accepts imported conversions. An action that only the tag fills isn't automatically the right target.
  • Consent always set to "granted": the consent information should reflect the visitor's actual choice.
  • Skipping the validation mode: the API can validate events without accepting them. That catches format errors before real data flows.

How TSO handles it

Related terms

From the term to clean measurement.

TSO connects ads with leads, deals and revenue and reports them back to the ad platforms.