> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkrunner.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Web to App

> Run Google web-to-app campaigns and attribute installs from Search, Display, and Performance Max ads through your website.

## Overview

Google Web to App lets you run Search, Display, or Performance Max campaigns that drive app installs through the web. Your ad's Final URL is your Linkrunner domain: Google appends the click parameters to it automatically, Linkrunner records the click, sends mobile users into your app or its store listing, and forwards desktop users to your website. No code on your website is required.

**Works for both Android and iOS apps.**

## How It Works

1. A user clicks your Google ad. The ad's Final URL is your Linkrunner domain.
2. Google automatically appends the click IDs (`gclid`, `wbraid`, `gbraid`) and your Final URL suffix parameters to that URL.
3. Linkrunner records the click with all parameters. No code runs on your website.
4. Mobile users see a lightweight redirect page that opens your app if installed, or takes them to the App Store / Play Store. Desktop users are forwarded to your website with the parameters preserved.
5. When the app is opened after install, Linkrunner attributes it to the campaign.

## Connect your Google Ads account

Connecting your Google Ads account lets Linkrunner sync your campaigns and spend, and send in-app conversions back to Google so it can optimize your web-to-app campaigns.

Go to [Integrations → Google Ads](https://dashboard.linkrunner.io/dashboard/integrations/google-ads), click **Add Google Account**, and choose how to connect:

* **Google App Ads**: campaign sync and spend reporting.
* **Google Web to App Ads**: everything above, plus permission to upload in-app conversions to your Google Ads conversion actions. Choose this for web-to-app so Google can optimize Search and Performance Max campaigns on real in-app events.

Click **Google Web to App Ads** for this setup, then sign in with a Google account that has access to your Google Ads account and approve the requested permissions.

<img src="https://mintcdn.com/linkrunner-01ef8e08/w949srciNMunAc6s/images/google_ads/web-to-app/google-web-to-app-connect-option.png?fit=max&auto=format&n=w949srciNMunAc6s&q=85&s=711bc16c97cb3a4517f79e25feae0e35" alt="Google Ads Add Google Account dropdown with the Google Web to App Ads option" width="440" height="264" data-path="images/google_ads/web-to-app/google-web-to-app-connect-option.png" />

<Note>
  Google may show **Google hasn't verified this app** while Linkrunner's Data
  Manager permission is under Google verification. It is safe to continue when
  you started the login from Linkrunner. Click **Advanced** if needed, then
  click **Go to Linkrunner (unsafe)**.
</Note>

<img src="https://mintcdn.com/linkrunner-01ef8e08/w949srciNMunAc6s/images/google_ads/web-to-app/google-unverified-app-warning.png?fit=max&auto=format&n=w949srciNMunAc6s&q=85&s=e5f3e22e24e7ce3c712a9b0ef0c3575a" alt="Google unverified app warning with the Go to Linkrunner unsafe link highlighted" width="1552" height="1076" data-path="images/google_ads/web-to-app/google-unverified-app-warning.png" />

<Note>
  Web to App Ads asks for one extra Google permission (Data Manager) so
  Linkrunner can send conversions to your account. If you connected with App Ads
  earlier, the **Web to App** column on the Account Integration tab shows a
  reconnect option. Click it and sign in with **Google Web to App Ads**.
</Note>

## Setup

<Steps titleSize="h3">
  <Step title="Enable auto-tagging in Google Ads" id="enable-auto-tagging">
    Auto-tagging is a Google Ads account setting that appends a `gclid` (and `wbraid` / `gbraid` on iOS) to every ad click URL. Linkrunner depends on these click IDs for attribution. Without auto-tagging, no click IDs are appended and attribution cannot work.

    To verify or enable auto-tagging:

    1. Open [Google Ads](https://ads.google.com) and go to **Admin → Account settings**
    2. Find the **Auto-tagging** section
    3. Make sure **Tag the URL that people click through from my ad** is checked
    4. Click **Save**

           <img src="https://mintcdn.com/linkrunner-01ef8e08/w949srciNMunAc6s/images/google_ads/web-to-app/google-auto-tagging-account-settings.png?fit=max&auto=format&n=w949srciNMunAc6s&q=85&s=13ee4b35fda0c8389c64cedb7cb5a7c1" alt="Google Ads account settings with auto-tagging enabled" width="3018" height="1060" data-path="images/google_ads/web-to-app/google-auto-tagging-account-settings.png" />

    <Warning>
      Auto-tagging must be on before you run any web-to-app traffic. ValueTrack
      macros (such as `{campaignid}`) do not include click IDs. Click IDs come
      exclusively from auto-tagging.
    </Warning>
  </Step>

  <Step title="Add your Linkrunner domain" id="add-your-linkrunner-domain">
    Linkrunner uses your custom subdomain as the final destination URL. If you have not set one up yet, go to [Settings → Domains](https://dashboard.linkrunner.io/settings?s=domains) and add a subdomain.

    For full instructions on configuring the CNAME record, see the [Subdomain Setup guide](/features/subdomain-setup).

    Once your subdomain is active (CNAME verified and SSL active), you are ready for the next step. You can also find a ready-to-paste Final URL suffix template under [Integrations → Google Ads → Web to App](https://dashboard.linkrunner.io/dashboard/integrations/google-ads?tab=web_to_app). The domain picker there pre-fills your subdomain so you can copy the template directly.
  </Step>

  <Step title="Set the Final URL suffix in Google Ads" id="set-the-final-url-suffix">
    The Final URL suffix is appended to every landing page URL in your campaign. Set it at the account or campaign level in Google Ads.

    Use this template, keeping the ValueTrack macros exactly as shown:

    ```
    utm_source=google&utm_medium=cpc&gad_campaignid={campaignid}&adset_id={adgroupid}&ad_id={creative}&utm_term={keyword}&network={network}&device={device}
    ```

    Google substitutes the `{...}` macros with real values at delivery time. `gad_campaignid` is what Linkrunner uses to look up and auto-create the campaign. `adset_id` and `ad_id` are the same parameter names Linkrunner reads for Meta Web to App, and they feed the ad group and ad level breakdowns in your dashboard. `utm_term`, `network`, and `device` are standard reporting parameters carried along for future use.

    **To set the suffix at the account level:**

    1. Go to [Google Ads](https://ads.google.com) → **Admin → Account settings**
    2. Open **Tracking**
    3. Paste the template above into **Final URL suffix**
    4. Click **Save**

           <img src="https://mintcdn.com/linkrunner-01ef8e08/w949srciNMunAc6s/images/google_ads/web-to-app/final-url-suffix-account-settings.png?fit=max&auto=format&n=w949srciNMunAc6s&q=85&s=9011518caf1bcaa5fe128dc1b0b1f531" alt="Google Ads account settings showing the Tracking section with the Final URL suffix field" width="2000" height="938" data-path="images/google_ads/web-to-app/final-url-suffix-account-settings.png" />

    **To set it at the campaign level:**

    1. Open the campaign → **Settings**
    2. Expand **Additional settings**
    3. Open **Campaign URL options**
    4. Paste the template above into **Final URL suffix**
    5. Click **Save**

    <Note>
      A ready-to-paste version of this suffix (with your subdomain pre-filled) is
      available under [Integrations → Google Ads → Web to
      App](https://dashboard.linkrunner.io/dashboard/integrations/google-ads?tab=web_to_app).
      Pick the destination domain there and copy the suffix directly.
    </Note>

    <Warning>
      Set the Final URL suffix at the **account** or **campaign** level. If you only
      set it at the ad level you risk missing coverage when new ads are added to the
      campaign.
    </Warning>
  </Step>

  <Step title="Use your Linkrunner domain as the ad's Final URL" id="set-the-ads-final-url">
    Set the **Final URL** of your ads to your Linkrunner domain:

    ```
    https://<your-linkrunner-domain>/
    ```

    Grab your exact Final URL from [Integrations → Google Ads → Web to App](https://dashboard.linkrunner.io/dashboard/integrations/google-ads?tab=web_to_app) in the dashboard. Pick your destination domain there and use the **Copy** button to copy the ready-to-paste Final URL (the Final URL suffix from the previous step is on the same screen).

    <img src="https://mintcdn.com/linkrunner-01ef8e08/w949srciNMunAc6s/images/google_ads/web-to-app/web-to-app-setup.png?fit=max&auto=format&n=w949srciNMunAc6s&q=85&s=ccaf85857713df0269b265bae4eeadd0" alt="Linkrunner dashboard Web to App tab with the destination domain picker, the Final URL suffix, and the Final URL, each with a Copy button" width="2128" height="1250" data-path="images/google_ads/web-to-app/web-to-app-setup.png" />

    That is the entire website-side setup: there is none. Google appends the click IDs and your suffix parameters to this URL automatically, and Linkrunner handles the rest.

    * **Mobile users** see a lightweight redirect page that opens your app if it is installed, or takes them to the App Store / Play Store.
    * **Desktop users** are forwarded to your website with all parameters preserved.

    Because your Linkrunner domain is a subdomain of your website's domain, it satisfies Google's display URL requirements.

    <Note>
      Prefer to land users on your website first? Point the ad at your site as
      usual, then make your Download button link to the same Linkrunner URL with
      the full query string forwarded, for example
      `"https://<your-linkrunner-domain>/" + window.location.search`. Without that
      forwarding the click IDs never reach Linkrunner.
    </Note>
  </Step>
</Steps>

## Create Your First Campaign in Google Ads

Use this flow when you are creating a new Google Web to App campaign from scratch. Complete the account-level setup above first so auto-tagging, your Final URL suffix, and your Linkrunner domain are ready before traffic starts.

<Steps titleSize="h3">
  <Step title="Choose a campaign objective" id="choose-campaign-objective">
    In Google Ads, click **New campaign**. On **What's your campaign objective?**, select **Create a campaign without guidance**.

    <img src="https://mintcdn.com/linkrunner-01ef8e08/w949srciNMunAc6s/images/google_ads/web-to-app/campaign-objective-without-guidance.png?fit=max&auto=format&n=w949srciNMunAc6s&q=85&s=f9ab70b6bad23b05c7e253f0e5d34cc6" alt="Google Ads campaign objective screen with Create a campaign without guidance selected" width="1125" height="591" data-path="images/google_ads/web-to-app/campaign-objective-without-guidance.png" />
  </Step>

  <Step title="Select Performance Max" id="select-performance-max">
    On **Select a campaign type**, choose **Performance Max**.

    <img src="https://mintcdn.com/linkrunner-01ef8e08/w949srciNMunAc6s/images/google_ads/web-to-app/campaign-type-performance-max.png?fit=max&auto=format&n=w949srciNMunAc6s&q=85&s=b3da63d9dd4d22781fcafb37c2902bf1" alt="Google Ads campaign type screen with Performance Max selected" width="1121" height="535" data-path="images/google_ads/web-to-app/campaign-type-performance-max.png" />
  </Step>

  <Step title="Select your conversion goals" id="select-conversion-goals">
    Pick the conversion goals this campaign should optimize for (for example **Sign-ups** or **Purchases**). These are the Google goals your mapped conversion actions belong to, so the campaign bids toward real in-app outcomes, not just installs.

    <img src="https://mintcdn.com/linkrunner-01ef8e08/w949srciNMunAc6s/images/google_ads/web-to-app/campaign-conversion-goals.png?fit=max&auto=format&n=w949srciNMunAc6s&q=85&s=60a3039b967af4176b38183f0b63ba44" alt="Google Ads screen for selecting conversion goals for campaign performance optimisation" width="1014" height="431" data-path="images/google_ads/web-to-app/campaign-conversion-goals.png" />
  </Step>

  <Step title="Add your destination link" id="add-destination-link">
    When Google asks **Where should people go after clicking your ads?**, enter your Linkrunner domain as the destination URL:

    ```
    https://<your-linkrunner-domain>/
    ```

    Grab the exact URL from [Integrations → Google Ads → Web to App](https://dashboard.linkrunner.io/dashboard/integrations/google-ads?tab=web_to_app) using the **Copy** button. Do not paste the Final URL suffix in this field. Keep the suffix in **Tracking → Final URL suffix** at the account or campaign level.

    <img src="https://mintcdn.com/linkrunner-01ef8e08/w949srciNMunAc6s/images/google_ads/web-to-app/campaign-destination-link.png?fit=max&auto=format&n=w949srciNMunAc6s&q=85&s=eeebaf89537b62f5c15a80a514b764d9" alt="Google Ads screen asking where people should go after clicking your ads, with the destination URL field" width="1019" height="278" data-path="images/google_ads/web-to-app/campaign-destination-link.png" />
  </Step>
</Steps>

## Send in-app conversions to Google

After installs are attributed, Linkrunner can upload in-app conversions (such as purchases or sign-ups) back to Google Ads. Google uses them to optimize your Search and Performance Max campaigns on real outcomes, not just installs.

This requires connecting with **Google Web to App Ads** so Linkrunner has permission to send conversions.

<Steps titleSize="h3">
  <Step title="Map an event to a conversion action">
    Go to [Integrations → Google Ads → Web to App](https://dashboard.linkrunner.io/dashboard/integrations/google-ads?tab=web_to_app) and scroll to the **conversion actions** section. It lists your Google event mappings; for each event you want to send (for example `purchase` or `sign_up`), pick a Google conversion action in the **Conversion action** column. If an event is not listed, add it under the **Event Mapping** tab first.

    <img src="https://mintcdn.com/linkrunner-01ef8e08/w949srciNMunAc6s/images/google_ads/web-to-app/web-to-app-conversion-actions.png?fit=max&auto=format&n=w949srciNMunAc6s&q=85&s=01a170a3e15d12e35b5d555f600a928f" alt="Web to App conversion actions table mapping each of your events to a Google conversion action, with a Goal column" width="2128" height="854" data-path="images/google_ads/web-to-app/web-to-app-conversion-actions.png" />

    If you do not have one yet, choose **Create new**, give it a name and a **Goal** (Sign-up, Purchase, and so on), and Linkrunner creates the conversion action in your Google Ads account under that goal and maps it in one step.

    <img src="https://mintcdn.com/linkrunner-01ef8e08/w949srciNMunAc6s/images/google_ads/web-to-app/web-to-app-create-conversion-action.png?fit=max&auto=format&n=w949srciNMunAc6s&q=85&s=9630d6b3e4d044652fc20054a4b03a31" alt="Create Google conversion action dialog with a name field and a Goal selector" width="1184" height="776" data-path="images/google_ads/web-to-app/web-to-app-create-conversion-action.png" />
  </Step>

  <Step title="Set its goal">
    Each conversion action belongs to a Google **goal** (Sign-up, Purchase, and so on), which decides how Google groups and optimizes it. Set or change it in the **Goal** column of the same table, and Linkrunner updates it in your Google Ads account, so you do not need to edit it there. A new action you create uses the goal you picked.
  </Step>

  <Step title="Mark it primary in Google Ads">
    Setting the goal files the action under the right goal, but Google decides whether a goal drives bidding. In Google Ads, open **Goals → Conversions**, open the goal, and make sure the action is a **Primary** action (not Secondary) for the campaigns you want to optimize. Linkrunner sets the goal; you choose which goals your campaigns bid toward.
  </Step>

  <Step title="Confirm conversions arrive">
    Run real traffic and confirm conversions appear against the conversion action in Google Ads. Uploads happen after attribution and can take a few hours to show.
  </Step>
</Steps>

<Note>
  If your project has more than one connected Google account, use the account
  selector at the top of the conversion actions section to choose which
  account's conversion actions you are mapping. Conversion actions are specific
  to each Google Ads account.
</Note>

## Click IDs: gclid, wbraid, and gbraid

Google appends different click IDs depending on the platform and tracking context. They land on your Linkrunner domain automatically; you never handle them yourself.

| Parameter | When it appears                                                                                                            |
| --------- | -------------------------------------------------------------------------------------------------------------------------- |
| `gclid`   | Most clicks. Present on Android and on iOS website-page clicks (often alongside `wbraid`).                                 |
| `wbraid`  | iOS clicks from a website landing page (Safari / browser-based flow). Arrives together with `gclid` when both are present. |
| `gbraid`  | iOS clicks where Google routes directly into an app destination (app-destination ID). Less common in web-to-app flows.     |

All three arrive automatically because the ad's Final URL is your Linkrunner domain. Linkrunner captures whichever IDs Google appends.

## Implementation Checklist

* [ ] Auto-tagging is enabled in Google Ads account settings
* [ ] Linkrunner subdomain is active (CNAME verified, SSL active)
* [ ] Final URL suffix is set at the account or campaign level
* [ ] Ad Final URL points at your Linkrunner domain (or your site's Download button forwards the full query string to it)
* [ ] End-to-end test: click a test ad, install the app, confirm attribution appears in the Linkrunner dashboard
* [ ] Google Ads account connected under Integrations → Google Ads using **Google Web to App Ads** to enable conversion uploads
* [ ] (Optional) Key events mapped to Google conversion actions under Web to App (with a goal set), and marked as Primary in Google Ads

## Troubleshooting

### Campaign not appearing in the Linkrunner dashboard

Linkrunner auto-creates a campaign on the first click that carries a valid `gad_campaignid` in the URL. If no campaign appears:

* Confirm the Final URL suffix includes `gad_campaignid={campaignid}` with the exact macro syntax.
* Verify the suffix is saved at the account or campaign level (not just at the ad level).
* Check that your Linkrunner subdomain is active (CNAME verified and SSL active).
* Click a test ad and inspect the URL you land on: `gad_campaignid` should be present on the Linkrunner domain URL.

### No installs attributed

* Confirm the ad's Final URL is your Linkrunner domain. If you link from your own website instead, confirm the Download button forwards the full query string to it.
* Check that the Linkrunner SDK is initialised in your app and calling the attribution endpoint on first open.

### Click IDs missing (gclid / wbraid / gbraid not on the click URL)

* This almost always means auto-tagging is off. Go to **Google Ads → Admin → Account settings → Auto-tagging** and confirm it is enabled.
* ValueTrack macros cannot substitute click IDs. Auto-tagging is the only source of `gclid`, `wbraid`, and `gbraid`.

### Spend not visible in reports

* Confirm your Google Ads account is connected under [Integrations → Google Ads](https://dashboard.linkrunner.io/dashboard/integrations/google-ads).
* Allow up to a few hours for the first spend data to appear after campaign launch.
* Make sure the campaign running in Google Ads matches the connected account.

### In-app conversions not reaching Google Ads

* Confirm the **Web to App** column under [Integrations → Google Ads](https://dashboard.linkrunner.io/dashboard/integrations/google-ads) shows enabled. If it shows reconnect, click it and sign in with **Google Web to App Ads**. The regular App Ads connection cannot upload conversions.
* Confirm the event is mapped to a conversion action under [Web to App](https://dashboard.linkrunner.io/dashboard/integrations/google-ads?tab=web_to_app).
* Make sure the conversion action is enabled in Google Ads and set as a goal for the campaign.
* Uploads happen after attribution and can take a few hours to appear in Google Ads.

***

**Need help?** Contact [support@linkrunner.io](mailto:support@linkrunner.io)