AdBid
DocumentationGoogle Ads click tracking
AdBid Attribution

AdBid click tracking for Google Ads

AdBid Attribution records a click on a Google Ads ad and sends the visitor straight to the advertiser's landing page. The destination is always visible in the tracking URL, and the tracker never changes it.

Click tracker
Domain and transparency parameter
api.adbid.meredirect_url

Overview

The click tracker is part of AdBid Attribution. An advertiser puts the AdBid tracking template into the URL options of a Search, Performance Max or Demand Gen campaign. When a person clicks the ad, Google Ads calls the tracker with the click identifier and the campaign values; AdBid stores them and redirects to the landing page. When that person later converts, AdBid reports the conversion back to the same Google Ads account for the recorded click.

Tracking template

One template covers every campaign type. The configuration ID in the path identifies the advertiser's app, Google Ads account and landing page; it is generated by AdBid and is not a secret.

https://api.adbid.me/api/attribution/google/track/<configuration-id>/?gad_campaignid={campaignid}&adgroupid={adgroupid}&targetid={targetid}&keyword={keyword}&matchtype={matchtype}&adbid_ad_id={creative}&gclid={gclid}&gbraid={gbraid}&wbraid={wbraid}&device={device}&devicemodel={devicemodel}&network={network}&placement={placement}&target={target}&adposition={adposition}&feeditemid={feeditemid}&extensionid={extensionid}&loc_interest_ms={loc_interest_ms}&loc_physical_ms={loc_physical_ms}&redirect_url={lpurl}

Redirect behaviour

  • The next hop is the value of redirect_url. The tracker answers 302 Found with a Location header equal to that value, URL-decoded once. There is no other redirect target configured on the server.
  • The destination is never modified: no parameters are added, removed or rewritten, and no intermediate domain is used.
  • The destination is validated on the server. A redirect is issued only to the landing page the advertiser registered for this configuration (same host and path, HTTPS) or to Google's parallel tracking endpoint. Any other address gets 400 and no redirect, so the link cannot be used as an open redirect.
  • The same behaviour applies to every tracker URL; there is a single path.
  • The tracker sets no cookies and serves over HTTPS only.
https://api.adbid.me/api/attribution/google/track/<configuration-id>/?gclid=EAIaIQ…&redirect_url=https%3A%2F%2Fexample.org%2Foffer

→ 302 Found
  Location: https://example.org/offer

Parameters

The tracker reads only the parameters below. All of them belong to the AdBid template and are filled in by Google Ads ValueTrack. Advertisers cannot add their own key-value pairs to the tracker; their own parameters go into the Final URL or the Final URL suffix.

ParameterValueTrackMeaning
redirect_url{lpurl}Transparency parameter: the next hop. The visitor is redirected to exactly this address. Always the last parameter.
gclid, gbraid, wbraid{gclid}, {gbraid}, {wbraid}Google click identifiers, used to match a later conversion to the click.
gad_campaignid{campaignid}Campaign that served the ad.
adgroupid{adgroupid}Ad group (Search, Demand Gen).
assetgroupid{assetgroupid}Asset group (Performance Max).
adbid_ad_id{creative}Ad that was clicked.
targetid, keyword, matchtype{targetid}, {keyword}, {matchtype}Keyword or target that triggered the ad, and its match type.
device, devicemodel{device}, {devicemodel}Device type and model reported by Google Ads.
network, placement, target, adposition{network}, {placement}, {target}, {adposition}Network, placement and position of the ad.
feeditemid, extensionid{feeditemid}, {extensionid}Asset (extension) that was clicked.
loc_interest_ms, loc_physical_ms{loc_interest_ms}, {loc_physical_ms}Google Ads location criterion IDs of interest and of physical presence.

Data and privacy

For each click the tracker stores the values listed above and the time of the click. A click without a Google click identifier is redirected and not stored. The record is used to attribute conversions of the advertiser's own app or site to the campaign and to report them to that advertiser's Google Ads account. It is not sold and is not used to build advertising profiles. Details are in the Privacy Policy.

Setup

  1. In AdBid open Apps → your app → Attribution and connect the Google Ads account that serves the ads.
  2. Choose the landing page and switch on the events to report as conversions.
  3. Copy the tracking template and the Final URL suffix into Campaign URL options in Google Ads, or create the campaign in AdBid and they are set for you.
  4. Keep auto-tagging on in the Google Ads account.