Reverse-proxy support

Tracking clicks via a reverse proxy

To avoid ad-blockers from blocking your click-tracking requests, we recommend setting up a reverse proxy. Depending on which backend framework you’re using, there are a few different ways to do this:

// next.config.js
module.exports = {
  async rewrites() {
    return [
      {
        source: "/_proxy/dub/track/:path",
        destination: "https://api.dub.co/track/:path",
      },
    ];
  },
};

// vercel.json
{
  "rewrites": [
    {
      "source": "/_proxy/dub/track/:path",
      "destination": "https://api.dub.co/track/:path"
    }
  ]
}

Once you’ve set up your reverse proxy, don’t forget to update the apiHost parameter in the <Analytics /> component to point to your proxy URL.

// include this script tag in your HTML Head tag
<script
  src="https://www.dubcdn.com/analytics/script.js"
  data-api-host="/_proxy/dub"
  data-domains='{"refer": "go.example.com"}'
  defer
></script>

import { Analytics as DubAnalytics } from "@dub/analytics/react";

export default function App() {
  return (
    <Layout>
      <DubAnalytics
        apiHost="/_proxy/dub" // the URL of your reverse proxy
        domainsConfig={{
          refer: "go.example.com", // the custom domain you're using on Dub for your short links
        }}
      />
      {/* Your app code here */}
    </Layout>
  );
}

Loading the script via a reverse proxy

To avoid ad-blockers from blocking the Dub Analytics script, it is recommended to use a reverse proxy. Depending on which backend framework you’re using, there are a few different ways to do this:

// next.config.js
module.exports = {
  async rewrites() {
    return [
      {
        source: "/_proxy/dub/script.js",
        destination: "https://www.dubcdn.com/analytics/script.js",
      },
    ];
  },
};

// vercel.json
{
  "rewrites": [
    {
      "source": "/_proxy/dub/script.js",
      "destination": "https://www.dubcdn.com/analytics/script.js"
    }
  ]
}

Once you’ve set up your reverse proxy, don’t forget to update the scriptProps.src parameter in the <Analytics /> component to point to your proxy URL.

// include this script tag in your HTML Head tag
<script
  src="/_proxy/dub/script.js" // pointing to your reverse proxy
  defer
></script>

import { Analytics as DubAnalytics } from "@dub/analytics/react";

export default function App() {
  return (
    <Layout>
      <DubAnalytics
        scriptProps={{
          src: "/_proxy/dub/script.js", // pointing to your reverse proxy
        }}
      />
      {/* Your app code here */}
    </Layout>
  );
}

DUB API

SDKs

DUB PARTNERS API

DUB LINKS API

Reverse-proxy support

Tracking clicks via a reverse proxy

Loading the script via a reverse proxy

​Tracking clicks via a reverse proxy

​Loading the script via a reverse proxy

Tracking clicks via a reverse proxy

Loading the script via a reverse proxy