diff --git a/README.md b/README.md index a68de598..fcf20db5 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ - Dub is the open-source link attribution platform for modern marketing teams. + Dub Documentation Preview

dubinc/docs

@@ -19,5 +19,5 @@ npm i -g mintlify 2. In the root of the repository, run the following command: ``` -npm run dev +pnpm run dev ``` diff --git a/concepts/analytics/device.mdx b/concepts/analytics/device.mdx index 87df7cf3..8eeaed78 100644 --- a/concepts/analytics/device.mdx +++ b/concepts/analytics/device.mdx @@ -1,5 +1,6 @@ --- title: Device data +description: "Retrieve analytics data grouped by device type, browser, and operating system." og:title: "Dub Analytics API – Aggregating analytics by device" --- diff --git a/concepts/analytics/location.mdx b/concepts/analytics/location.mdx index 59bf60ae..0c3ffd19 100644 --- a/concepts/analytics/location.mdx +++ b/concepts/analytics/location.mdx @@ -1,5 +1,6 @@ --- title: Location data +description: "Retrieve analytics data grouped by country, city, continent, and region." og:title: "Dub Analytics API – Aggregating analytics by location" --- diff --git a/concepts/analytics/referrers.mdx b/concepts/analytics/referrers.mdx index 5dadc5f6..d7308d65 100644 --- a/concepts/analytics/referrers.mdx +++ b/concepts/analytics/referrers.mdx @@ -1,5 +1,6 @@ --- title: Referrers data +description: "Retrieve analytics data grouped by referrer domain and URL." og:title: "Dub Analytics API – Aggregating analytics by referrers" --- diff --git a/concepts/analytics/utm.mdx b/concepts/analytics/utm.mdx index e466f56e..e4b5e9dc 100644 --- a/concepts/analytics/utm.mdx +++ b/concepts/analytics/utm.mdx @@ -1,5 +1,6 @@ --- title: UTM data +description: "Retrieve analytics data grouped by UTM source, medium, campaign, term, and content." og:title: "Dub Analytics API – Aggregating analytics by UTM" --- diff --git a/conversions/leads/appwrite.mdx b/conversions/leads/appwrite.mdx index 297ff496..b001f8b3 100644 --- a/conversions/leads/appwrite.mdx +++ b/conversions/leads/appwrite.mdx @@ -240,11 +240,11 @@ Next, configure Appwrite to track lead conversion events during the sign up proc To learn more about how to track leads with Appwrite, check out the following example app: - See how to track new user sign-ups with Appwrite and the Dub SDK. + See how to track new user sign-ups with Appwrite and the Dub SDK diff --git a/conversions/leads/clerk.mdx b/conversions/leads/clerk.mdx index 83949fe9..5a5e3e39 100644 --- a/conversions/leads/clerk.mdx +++ b/conversions/leads/clerk.mdx @@ -240,11 +240,11 @@ Here's a quick summary of the steps: To learn more about how to track leads with Clerk, check out the following example app: - See how to track new user sign-ups with Clerk and the Dub SDK. + See how to track new user sign-ups with Clerk and the Dub SDK diff --git a/conversions/leads/client-side.mdx b/conversions/leads/client-side.mdx index dde05c0f..362ca8b1 100644 --- a/conversions/leads/client-side.mdx +++ b/conversions/leads/client-side.mdx @@ -1,7 +1,7 @@ --- title: Client-side tracking og:title: Client-side lead tracking with Dub -description: Learn how to track lead conversion events with Dub using client-side tracking +description: Learn how to track lead conversion events with Dub using client-side tracking. --- import LeadsIntro from "/snippets/leads-intro.mdx"; diff --git a/conversions/leads/deferred.mdx b/conversions/leads/deferred.mdx index 73c2d26e..dce6db40 100644 --- a/conversions/leads/deferred.mdx +++ b/conversions/leads/deferred.mdx @@ -1,6 +1,6 @@ --- title: Deferred lead tracking -description: Learn how to track a deferred lead conversion event with Dub +description: Learn how to track a deferred lead conversion event with Dub. --- import LeadsIntro from "/snippets/leads-intro.mdx"; diff --git a/conversions/leads/segment.mdx b/conversions/leads/segment.mdx index c94d9363..e24de922 100644 --- a/conversions/leads/segment.mdx +++ b/conversions/leads/segment.mdx @@ -140,11 +140,11 @@ Next, configure [Segment Dub (Actions)](https://app.segment.com/goto-my-workspac To learn more about how to track leads with Segment, check out the following example app: - Next.js app using Segment to track new user sign-ups. + Next.js app using Segment to track new user sign-ups diff --git a/conversions/leads/supabase.mdx b/conversions/leads/supabase.mdx index 93333106..ce77a4e1 100644 --- a/conversions/leads/supabase.mdx +++ b/conversions/leads/supabase.mdx @@ -144,12 +144,12 @@ export default async function handler( To learn more about how to track leads with Supabase, check out the following example app: Check out a real-world example of this in action – Extrapolate uses Supabase - Auth and Next.js App Router to track new user sign-ups. + Auth and Next.js App Router to track new user sign-ups diff --git a/conversions/quickstart.mdx b/conversions/quickstart.mdx index 121d386d..9519f468 100644 --- a/conversions/quickstart.mdx +++ b/conversions/quickstart.mdx @@ -10,6 +10,7 @@ import DubClientInstallVerify from "/snippets/dub-client-install-verify.mdx"; import InstallServerSdksTrackConversions from "/snippets/install-server-sdks-track-conversions.mdx"; import ViewConversions from "/snippets/view-conversions.mdx"; import DubConversionTrackingDemoApps from "/snippets/dub-conversion-tracking-demo-apps.mdx"; +import OpenAnalyticsSettings from "/snippets/open-analytics-settings.mdx"; Conversion tracking requires a [Business plan](https://dub.co/pricing) @@ -31,6 +32,10 @@ In this guide, we'll walk you through the steps to get started with conversion t +You'll also need to generate a publishable key and allowlist your site's domain to ensure client-side events are ingested by Dub. Navigate to your workspace's Analytics settings page to configure these options. + + + ## Step 2: Install the `@dub/analytics` client-side SDK Next, you'll need to install the [@dub/analytics client-side SDK](/sdks/client-side/introduction). @@ -59,6 +64,54 @@ Once you've enabled conversion tracking for your links, all your tracked convers +## Integration options + +Choose the integration method that best fits your stack to track leads and sales: + +### Payment integrations + + + + **Best for:** SaaS and subscription revenue tracking. Automatically track purchases, subscriptions, and refunds + + + **Best for:** E-commerce revenue tracking. Native app that automatically tracks all orders + + + +### Lead tracking + + + + **Best for:** Client-side lead event tracking. No-code setup for any platform + + + **Best for:** CRM lead tracking. Sync leads and deals directly to your CRM + + + +### Server-side SDKs + + + + TypeScript SDK for Node.js + + + Python SDK for server-side integration + + + Go SDK for backend services + + + PHP SDK for web applications + + + Ruby SDK for Rails and more + + + +Dub also offers **Mobile SDKs** ([Swift](/sdks/client-side/swift), [React Native](/sdks/client-side/react-native)) for native app conversion tracking, and **Auth framework integrations** ([Clerk](/conversions/leads/clerk), [Better Auth](/conversions/leads/better-auth), [Auth0](/conversions/leads/auth0)) to automatically track signups as lead events. + ## Example Apps diff --git a/conversions/sales/client-side.mdx b/conversions/sales/client-side.mdx index cc340a14..6126f6ae 100644 --- a/conversions/sales/client-side.mdx +++ b/conversions/sales/client-side.mdx @@ -1,7 +1,7 @@ --- title: Client-side tracking og:title: Client-side sale tracking with Dub -description: Learn how to track sales conversion events with Dub on the client-side +description: Learn how to track sales conversion events with Dub on the client-side. --- import SalesIntro from "/snippets/sales-intro.mdx"; diff --git a/conversions/sales/direct.mdx b/conversions/sales/direct.mdx index 45867a52..fae28e45 100644 --- a/conversions/sales/direct.mdx +++ b/conversions/sales/direct.mdx @@ -1,6 +1,6 @@ --- title: Direct sale tracking -description: Learn how to track sales without a prior lead event using Dub +description: Learn how to track sales without a prior lead event using Dub. --- import SalesIntro from "/snippets/sales-intro.mdx"; diff --git a/conversions/sales/introduction.mdx b/conversions/sales/introduction.mdx index e3c8f759..3ed9e759 100644 --- a/conversions/sales/introduction.mdx +++ b/conversions/sales/introduction.mdx @@ -2,7 +2,7 @@ title: Server-side tracking sidebarTitle: Server-side tracking (recommended) og:title: Server-side sale tracking with Dub -description: Learn how to track sales conversion events with Dub using server-side tracking +description: Learn how to track sales conversion events with Dub using server-side tracking. --- import SalesIntro from "/snippets/sales-intro.mdx"; diff --git a/conversions/sales/segment.mdx b/conversions/sales/segment.mdx index 1f968986..9bcc6f67 100644 --- a/conversions/sales/segment.mdx +++ b/conversions/sales/segment.mdx @@ -135,11 +135,11 @@ Next, configure [Segment Dub (Actions)](https://app.segment.com/goto-my-workspac To learn more about how to track sales with Segment, check out the following example app: - Next.js app using Segment to track sales. + Next.js app using Segment to track sales ## View conversion results diff --git a/conversions/sales/stripe.mdx b/conversions/sales/stripe.mdx index b006f2b3..4923567b 100644 --- a/conversions/sales/stripe.mdx +++ b/conversions/sales/stripe.mdx @@ -525,11 +525,11 @@ And that's it – you're all set! You can now sit back, relax, and watch your c - See the full example on GitHub. + See the full example on GitHub diff --git a/data-model.mdx b/data-model.mdx index dbb76ef2..c44e205f 100644 --- a/data-model.mdx +++ b/data-model.mdx @@ -1,33 +1,63 @@ --- title: Data model -description: "A quick overview of how Dub is structured." +description: "Understanding the core data models in Dub." --- -Whether you are using Dub's [API](/api-reference/introduction) or not, this page is a quick way to understand how Dub works. +Understanding the core data models is key to using the Dub API and platform effectively. All data in Dub belongs to a Workspace, which acts as the top-level container for your organization. -Within Dub, all data belongs to a [**Workspace**](#workspace). Within a workspace, you have: +This page provides a conceptual overview of the primary entities you'll interact with and how they relate to each other, whether you're using the [Dub dashboard](https://app.dub.co) or the [Dub API](/api-reference/introduction). -- [Links](#links) -- [Analytics](#analytics) -- [Partners](#partners) -- [Customers](#customers) -- [Tags](#tags) -- [Domains](#domains) +## Core Entities -When interacting with Dub's API, you'll also need to create a [workspace API key](/api-reference/tokens) to authenticate your requests. +The following table defines the primary data models in Dub: -## Links +| Entity | Description | +| -------------- | ---------------------------------------------------------------------------------------------------------------- | +| **Workspace** | The top-level container for all your data. Invite team members, manage roles, and configure billing here. | +| **Program** | A partner program you create with configurable reward rules, commission structures, and enrolled partners. | +| **Partner** | A user who joined a program. They receive a unique referral link and can earn commissions on conversions. | +| **Link** | A short link that redirects to a destination URL. Can be standalone or associated with a partner for tracking. | +| **Analytics** | Aggregated data about link performance including clicks, geographic location, devices, referrers, and UTMs. | +| **Customer** | An end-user who clicked a partner's link and converted (e.g., signed up or made a purchase). | +| **Commission** | A record of a successful conversion attributed to a partner, with a status (pending, approved, paid) and amount. | +| **Domain** | A custom domain for branded short links. Improves brand recognition and click-through rates. | +| **Tag** | A label to organize, filter, and group links for easier management and analytics segmentation. | -Links are the bread and butter of Dub. You can shorten any URL to a Dub link, which you can then share with your audience. Links can be [created](/api-reference/endpoint/create-a-link), [updated](/api-reference/endpoint/update-a-link), and [deleted](/api-reference/endpoint/delete-a-link) via the [Dub API](/api-reference/introduction) or the [Dub dashboard](https://app.dub.co). +## Entity Relationships -## Domains +The diagram below illustrates how these entities relate to one another: -On Dub, you can [add custom domains](https://dub.co/help/article/how-to-add-custom-domain) to create branded short links for better brand recognition. You can also [set a primary domain](https://dub.co/help/article/how-to-set-primary-domain) for it to be used as the default domain for new links (both via the API and the dashboard). + + Dub Data Model - Entity Relationship Diagram + -## Tags +## Key Relationships -Tags are a way to organize your links. You can [add tags to your links](https://dub.co/help/article/how-to-use-tags) to categorize them and make them easier to find. You can also [filter analytics by tags](https://dub.co/blog/introducing-tags#filtering-analytics-by-tags) to get a better understanding of how your campaigns are performing. +The relationships between entities follow a clear hierarchy: -## Workspace +1. **Workspace → Program**: A workspace can have multiple partner programs. Each program operates independently with its own reward rules and partners. -[Workspaces](https://dub.co/help/article/what-is-a-workspace) is the defacto way of organizing your links and working with your team on Dub. You can think of a Dub workspace like a workspace on Slack or Discord – it's a shared space where you can [invite your team members](https://dub.co/help/article/how-to-invite-teammates) to collaborate on links. +2. **Program → Partner**: Partners join a specific program. A single user could be a partner in multiple programs across different workspaces. + +3. **Partner → Link**: When a partner joins a program, they receive a unique referral link. This link is used to track all referrals back to that partner. + +4. **Link → Customer**: When a visitor clicks a partner's link and converts, they become a Customer. The customer is permanently associated with the referring link. + +5. **Customer → Commission**: Each qualifying action by a customer (e.g., a purchase) generates a Commission record for the partner who referred them. + +## Next Steps + +Now that you understand the data model, you can: + + + + Create your first partner program and start tracking referrals + + + Learn how to interact with these entities programmatically + + diff --git a/docs.json b/docs.json index 10d2698d..f05da8c7 100644 --- a/docs.json +++ b/docs.json @@ -18,7 +18,21 @@ "groups": [ { "group": "Getting Started", - "pages": ["introduction"] + "pages": [ + "introduction", + "platform-overview", + "data-model" + ] + }, + { + "group": "Dub Partners", + "pages": [ + "partners/quickstart", + "partners/program-setup", + "partners/how-attribution-works", + "partners/embedded-referrals", + "partners/link-based-discounts" + ] }, { "group": "Links", @@ -98,14 +112,6 @@ } ] }, - { - "group": "Dub Partners", - "pages": [ - "partners/quickstart", - "partners/embedded-referrals", - "partners/link-based-discounts" - ] - }, { "group": "Integrations", "pages": [ @@ -127,6 +133,182 @@ } ] }, + { + "tab": "Guides", + "groups": [ + { + "group": "Getting Started", + "pages": [ + "guides/getting-started/introduction", + "guides/getting-started/how-to-create-link", + "guides/getting-started/how-to-add-custom-domain", + "guides/getting-started/how-to-invite-teammates", + "guides/getting-started/how-to-change-default-workspace", + "guides/getting-started/how-to-import-csv", + "guides/getting-started/what-is-a-workspace" + ] + }, + { + "group": "Link Management", + "pages": [ + "guides/link-management/how-to-create-link", + "guides/link-management/dub-links-not-working", + "guides/link-management/custom-qr-codes", + "guides/link-management/device-targeting", + "guides/link-management/dub-link-builder", + "guides/link-management/geo-targeting", + "guides/link-management/how-noindex-works", + "guides/link-management/how-to-check-link-destination", + "guides/link-management/how-to-export-links", + "guides/link-management/link-cloaking", + "guides/link-management/link-comments", + "guides/link-management/password-protected-links", + "guides/link-management/how-to-use-tags", + "guides/link-management/bulk-link-actions", + "guides/link-management/how-to-create-utm-templates", + "guides/link-management/utm-builder", + "guides/link-management/link-expiration", + "guides/link-management/link-double-redirects", + "guides/link-management/parameter-passing", + "guides/link-management/custom-link-previews", + "guides/link-management/link-folders", + "guides/link-management/how-to-transfer-links", + "guides/link-management/ab-testing", + "guides/link-management/folders-rbac" + ] + }, + { + "group": "Analytics", + "pages": [ + "guides/analytics/dub-analytics", + "guides/analytics/dub-conversions", + "guides/analytics/filter-analytics-by-trigger", + "guides/analytics/how-to-export-analytics", + "guides/analytics/incorrect-analytics-geolocation-data", + "guides/analytics/real-time-events-stream", + "guides/analytics/tracking-internal-traffic", + "guides/analytics/filter-analytics-by-tags", + "guides/analytics/filter-analytics-by-utms", + "guides/analytics/dub-analytics-limits", + "guides/analytics/filter-analytics-by-folders", + "guides/analytics/share-analytics", + "guides/analytics/customer-insights" + ] + }, + { + "group": "Dub Partners", + "pages": [ + "guides/partners/dub-partners", + "guides/partners/how-to-set-up-bank-account", + "guides/partners/messaging-partners", + "guides/partners/program-landing-page", + "guides/partners/dual-sided-incentives", + "guides/partners/program-resources", + "guides/partners/partner-link-settings", + "guides/partners/inviting-partners", + "guides/partners/partner-commissions", + "guides/partners/program-analytics", + "guides/partners/email-campaigns", + "guides/partners/partner-groups", + "guides/partners/partner-payouts", + "guides/partners/fraud-detection", + "guides/partners/managing-program-partners", + "guides/partners/partner-rewards", + "guides/partners/program-bounties", + "guides/partners/program-application-form", + "guides/partners/program-applications" + ] + }, + { + "group": "Partnering with Programs", + "pages": [ + "guides/programs/receiving-payouts", + "guides/programs/partner-profile", + "guides/programs/navigating-partner-program", + "guides/programs/communicating-with-programs", + "guides/programs/partner-payout-invoice", + "guides/programs/commissions-payouts", + "guides/programs/partners-faq", + "guides/programs/managing-partner-teams", + "guides/programs/program-marketplace", + "guides/programs/merging-partner-accounts" + ] + }, + { + "group": "Custom Domains", + "pages": [ + "guides/custom-domains/how-to-add-custom-domain", + "guides/custom-domains/archiving-domains", + "guides/custom-domains/how-to-set-primary-domain", + "guides/custom-domains/how-to-use-dub-with-subpath", + "guides/custom-domains/setting-not-found-url", + "guides/custom-domains/troubleshooting-domains", + "guides/custom-domains/using-cloudflare-domains", + "guides/custom-domains/choosing-a-custom-domain", + "guides/custom-domains/custom-domain-deep-links", + "guides/custom-domains/default-dub-domains", + "guides/custom-domains/free-dot-link-domain", + "guides/custom-domains/how-to-transfer-domains", + "guides/custom-domains/using-proxies-on-custom-domains", + "guides/custom-domains/how-to-redirect-root-domain" + ] + }, + { + "group": "Workspace Management", + "pages": [ + "guides/workspaces/how-to-invite-teammates", + "guides/workspaces/what-is-a-workspace", + "guides/workspaces/how-to-download-invoice", + "guides/workspaces/how-to-change-billing-information", + "guides/workspaces/how-to-cancel-subscription", + "guides/workspaces/workspace-roles" + ] + }, + { + "group": "Migrating to Dub", + "pages": [ + { + "group": "Dub Partners", + "pages": [ + "guides/migrating/migrating-from-rewardful", + "guides/migrating/migrating-from-partnerstack", + "guides/migrating/migrating-from-firstpromoter", + "guides/migrating/migrating-from-tolt" + ] + }, + { + "group": "Dub Links", + "pages": [ + "guides/migrating/migrating-from-bitly", + "guides/migrating/migrating-from-rebrandly", + "guides/migrating/migrating-from-short" + ] + } + ] + }, + { + "group": "SAML SSO", + "pages": [ + "guides/saml-sso/okta-scim", + "guides/saml-sso/okta-saml", + "guides/saml-sso/google-saml", + "guides/saml-sso/azure-saml", + "guides/saml-sso/azure-scim" + ] + }, + { + "group": "API", + "pages": [ + "guides/api/create-links-programmatically", + "guides/api/build-analytics-dashboard", + "guides/api/track-conversions-with-api", + "guides/api/manage-partners-via-api", + "guides/api/generate-qr-codes", + "guides/api/sync-customers-with-crm" + ] + } + ] + }, { "tab": "APIs and SDKs", "groups": [ diff --git a/examples.mdx b/examples.mdx index 848614c1..dc53849f 100644 --- a/examples.mdx +++ b/examples.mdx @@ -24,7 +24,7 @@ With Dub's powerful [Analytics API](/api-reference/endpoint/retrieve-analytics), Mini link shortener built with the Dub Typescript SDK - Create code snippets, browse AI prompts, create extension icons and more. + Create code snippets, browse AI prompts, create extension icons and more diff --git a/guides/analytics/customer-insights.mdx b/guides/analytics/customer-insights.mdx new file mode 100644 index 00000000..9ff7df26 --- /dev/null +++ b/guides/analytics/customer-insights.mdx @@ -0,0 +1,6 @@ +--- +title: "Customer Insights" +description: "Learn about customer insights on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/dub-analytics-limits.mdx b/guides/analytics/dub-analytics-limits.mdx new file mode 100644 index 00000000..2923a5dc --- /dev/null +++ b/guides/analytics/dub-analytics-limits.mdx @@ -0,0 +1,6 @@ +--- +title: "Dub Analytics Limits" +description: "Learn about analytics limits and quotas on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/dub-analytics.mdx b/guides/analytics/dub-analytics.mdx new file mode 100644 index 00000000..69c042ce --- /dev/null +++ b/guides/analytics/dub-analytics.mdx @@ -0,0 +1,6 @@ +--- +title: "Dub Analytics" +description: "Learn about Dub analytics and how to track performance." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/dub-conversions.mdx b/guides/analytics/dub-conversions.mdx new file mode 100644 index 00000000..74cfcaad --- /dev/null +++ b/guides/analytics/dub-conversions.mdx @@ -0,0 +1,6 @@ +--- +title: "Dub Conversions" +description: "Learn about conversion tracking on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/filter-analytics-by-folders.mdx b/guides/analytics/filter-analytics-by-folders.mdx new file mode 100644 index 00000000..3eae18da --- /dev/null +++ b/guides/analytics/filter-analytics-by-folders.mdx @@ -0,0 +1,6 @@ +--- +title: "Filter Analytics by Folders" +description: "Learn how to filter analytics by folders on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/filter-analytics-by-tags.mdx b/guides/analytics/filter-analytics-by-tags.mdx new file mode 100644 index 00000000..fab16f0b --- /dev/null +++ b/guides/analytics/filter-analytics-by-tags.mdx @@ -0,0 +1,6 @@ +--- +title: "Filter Analytics by Tags" +description: "Learn how to filter analytics by tags on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/filter-analytics-by-trigger.mdx b/guides/analytics/filter-analytics-by-trigger.mdx new file mode 100644 index 00000000..986fa79c --- /dev/null +++ b/guides/analytics/filter-analytics-by-trigger.mdx @@ -0,0 +1,6 @@ +--- +title: "Filter Analytics by Trigger" +description: "Learn how to filter analytics by trigger on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/filter-analytics-by-utms.mdx b/guides/analytics/filter-analytics-by-utms.mdx new file mode 100644 index 00000000..083089d7 --- /dev/null +++ b/guides/analytics/filter-analytics-by-utms.mdx @@ -0,0 +1,6 @@ +--- +title: "Filter Analytics by UTMs" +description: "Learn how to filter analytics by UTM parameters on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/how-to-export-analytics.mdx b/guides/analytics/how-to-export-analytics.mdx new file mode 100644 index 00000000..7103bc0f --- /dev/null +++ b/guides/analytics/how-to-export-analytics.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Export Analytics" +description: "Learn how to export analytics data from Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/incorrect-analytics-geolocation-data.mdx b/guides/analytics/incorrect-analytics-geolocation-data.mdx new file mode 100644 index 00000000..15598a63 --- /dev/null +++ b/guides/analytics/incorrect-analytics-geolocation-data.mdx @@ -0,0 +1,6 @@ +--- +title: "Incorrect Analytics Geolocation Data" +description: "Learn about incorrect geolocation data in Dub analytics." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/real-time-events-stream.mdx b/guides/analytics/real-time-events-stream.mdx new file mode 100644 index 00000000..44a50560 --- /dev/null +++ b/guides/analytics/real-time-events-stream.mdx @@ -0,0 +1,6 @@ +--- +title: "Real-Time Events Stream" +description: "Learn about the real-time events stream on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/share-analytics.mdx b/guides/analytics/share-analytics.mdx new file mode 100644 index 00000000..d7bd4406 --- /dev/null +++ b/guides/analytics/share-analytics.mdx @@ -0,0 +1,6 @@ +--- +title: "Share Analytics" +description: "Learn how to share analytics on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/analytics/tracking-internal-traffic.mdx b/guides/analytics/tracking-internal-traffic.mdx new file mode 100644 index 00000000..b32c2b3e --- /dev/null +++ b/guides/analytics/tracking-internal-traffic.mdx @@ -0,0 +1,6 @@ +--- +title: "Tracking Internal Traffic" +description: "Learn how to track internal traffic on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/api/build-analytics-dashboard.mdx b/guides/api/build-analytics-dashboard.mdx new file mode 100644 index 00000000..fd984ad6 --- /dev/null +++ b/guides/api/build-analytics-dashboard.mdx @@ -0,0 +1,6 @@ +--- +title: "Build an Analytics Dashboard" +description: "Learn how to build an analytics dashboard with the Dub API." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/api/create-links-programmatically.mdx b/guides/api/create-links-programmatically.mdx new file mode 100644 index 00000000..cae149d2 --- /dev/null +++ b/guides/api/create-links-programmatically.mdx @@ -0,0 +1,6 @@ +--- +title: "Create Links Programmatically" +description: "Learn how to create links programmatically with the Dub API." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/api/generate-qr-codes.mdx b/guides/api/generate-qr-codes.mdx new file mode 100644 index 00000000..356e15e8 --- /dev/null +++ b/guides/api/generate-qr-codes.mdx @@ -0,0 +1,6 @@ +--- +title: "Generate QR Codes" +description: "Learn how to generate QR codes with the Dub API." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/api/manage-partners-via-api.mdx b/guides/api/manage-partners-via-api.mdx new file mode 100644 index 00000000..15b10639 --- /dev/null +++ b/guides/api/manage-partners-via-api.mdx @@ -0,0 +1,6 @@ +--- +title: "Manage Partners via the API" +description: "Learn how to manage partners via the Dub API." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/api/sync-customers-with-crm.mdx b/guides/api/sync-customers-with-crm.mdx new file mode 100644 index 00000000..f7f7f8bf --- /dev/null +++ b/guides/api/sync-customers-with-crm.mdx @@ -0,0 +1,6 @@ +--- +title: "Sync Customers with a CRM" +description: "Learn how to sync customers with a CRM using the Dub API." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/api/track-conversions-with-api.mdx b/guides/api/track-conversions-with-api.mdx new file mode 100644 index 00000000..78296b09 --- /dev/null +++ b/guides/api/track-conversions-with-api.mdx @@ -0,0 +1,6 @@ +--- +title: "Track Conversions with the API" +description: "Learn how to track conversions with the Dub API." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/archiving-domains.mdx b/guides/custom-domains/archiving-domains.mdx new file mode 100644 index 00000000..017252ee --- /dev/null +++ b/guides/custom-domains/archiving-domains.mdx @@ -0,0 +1,6 @@ +--- +title: "Archiving Domains" +description: "Learn how to archive domains on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/choosing-a-custom-domain.mdx b/guides/custom-domains/choosing-a-custom-domain.mdx new file mode 100644 index 00000000..0dd0b311 --- /dev/null +++ b/guides/custom-domains/choosing-a-custom-domain.mdx @@ -0,0 +1,6 @@ +--- +title: "Choosing a Custom Domain" +description: "Learn how to choose a custom domain for Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/custom-domain-deep-links.mdx b/guides/custom-domains/custom-domain-deep-links.mdx new file mode 100644 index 00000000..b20b4001 --- /dev/null +++ b/guides/custom-domains/custom-domain-deep-links.mdx @@ -0,0 +1,6 @@ +--- +title: "Custom Domain Deep Links" +description: "Learn how to set up deep links with custom domains on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/default-dub-domains.mdx b/guides/custom-domains/default-dub-domains.mdx new file mode 100644 index 00000000..bc3e9a9a --- /dev/null +++ b/guides/custom-domains/default-dub-domains.mdx @@ -0,0 +1,6 @@ +--- +title: "Default Dub Domains" +description: "Learn about the default domains available on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/free-dot-link-domain.mdx b/guides/custom-domains/free-dot-link-domain.mdx new file mode 100644 index 00000000..ab130c9d --- /dev/null +++ b/guides/custom-domains/free-dot-link-domain.mdx @@ -0,0 +1,6 @@ +--- +title: "Free .link Domain" +description: "Learn how to get a free .link domain on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/how-to-add-custom-domain.mdx b/guides/custom-domains/how-to-add-custom-domain.mdx new file mode 100644 index 00000000..61a6dc9e --- /dev/null +++ b/guides/custom-domains/how-to-add-custom-domain.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Add a Custom Domain" +description: "Learn how to add a custom domain on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/how-to-redirect-root-domain.mdx b/guides/custom-domains/how-to-redirect-root-domain.mdx new file mode 100644 index 00000000..c35f054f --- /dev/null +++ b/guides/custom-domains/how-to-redirect-root-domain.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Redirect a Root Domain" +description: "Learn how to redirect a root domain on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/how-to-set-primary-domain.mdx b/guides/custom-domains/how-to-set-primary-domain.mdx new file mode 100644 index 00000000..ca87069c --- /dev/null +++ b/guides/custom-domains/how-to-set-primary-domain.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Set a Primary Domain" +description: "Learn how to set a primary domain on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/how-to-transfer-domains.mdx b/guides/custom-domains/how-to-transfer-domains.mdx new file mode 100644 index 00000000..dad9373e --- /dev/null +++ b/guides/custom-domains/how-to-transfer-domains.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Transfer Domains" +description: "Learn how to transfer domains between workspaces on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/how-to-use-dub-with-subpath.mdx b/guides/custom-domains/how-to-use-dub-with-subpath.mdx new file mode 100644 index 00000000..633d23e6 --- /dev/null +++ b/guides/custom-domains/how-to-use-dub-with-subpath.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Use Dub with a Subpath" +description: "Learn how to use Dub with a subpath on your domain." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/setting-not-found-url.mdx b/guides/custom-domains/setting-not-found-url.mdx new file mode 100644 index 00000000..6b27829d --- /dev/null +++ b/guides/custom-domains/setting-not-found-url.mdx @@ -0,0 +1,6 @@ +--- +title: "Setting a Not Found URL" +description: "Learn how to set a custom not found URL on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/troubleshooting-domains.mdx b/guides/custom-domains/troubleshooting-domains.mdx new file mode 100644 index 00000000..600b3984 --- /dev/null +++ b/guides/custom-domains/troubleshooting-domains.mdx @@ -0,0 +1,6 @@ +--- +title: "Troubleshooting Domains" +description: "Learn how to troubleshoot domain issues on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/using-cloudflare-domains.mdx b/guides/custom-domains/using-cloudflare-domains.mdx new file mode 100644 index 00000000..e3e17dc8 --- /dev/null +++ b/guides/custom-domains/using-cloudflare-domains.mdx @@ -0,0 +1,6 @@ +--- +title: "Using Cloudflare Domains" +description: "Learn how to use Cloudflare domains with Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/custom-domains/using-proxies-on-custom-domains.mdx b/guides/custom-domains/using-proxies-on-custom-domains.mdx new file mode 100644 index 00000000..dd452a2b --- /dev/null +++ b/guides/custom-domains/using-proxies-on-custom-domains.mdx @@ -0,0 +1,6 @@ +--- +title: "Using Proxies on Custom Domains" +description: "Learn how to use proxies on custom domains with Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/getting-started/how-to-add-custom-domain.mdx b/guides/getting-started/how-to-add-custom-domain.mdx new file mode 100644 index 00000000..61a6dc9e --- /dev/null +++ b/guides/getting-started/how-to-add-custom-domain.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Add a Custom Domain" +description: "Learn how to add a custom domain on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/getting-started/how-to-change-default-workspace.mdx b/guides/getting-started/how-to-change-default-workspace.mdx new file mode 100644 index 00000000..cf7c5524 --- /dev/null +++ b/guides/getting-started/how-to-change-default-workspace.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Change Your Default Workspace" +description: "Learn how to change your default workspace on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/getting-started/how-to-create-link.mdx b/guides/getting-started/how-to-create-link.mdx new file mode 100644 index 00000000..6f2e6f89 --- /dev/null +++ b/guides/getting-started/how-to-create-link.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Create a Link" +description: "Learn how to create a short link on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/getting-started/how-to-import-csv.mdx b/guides/getting-started/how-to-import-csv.mdx new file mode 100644 index 00000000..cdee49e6 --- /dev/null +++ b/guides/getting-started/how-to-import-csv.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Import a CSV" +description: "Learn how to import links from a CSV file on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/getting-started/how-to-invite-teammates.mdx b/guides/getting-started/how-to-invite-teammates.mdx new file mode 100644 index 00000000..139d0172 --- /dev/null +++ b/guides/getting-started/how-to-invite-teammates.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Invite Teammates" +description: "Learn how to invite teammates to your Dub workspace." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/getting-started/introduction.mdx b/guides/getting-started/introduction.mdx new file mode 100644 index 00000000..2b558c52 --- /dev/null +++ b/guides/getting-started/introduction.mdx @@ -0,0 +1,98 @@ +--- +title: "Introduction" +description: "Step-by-step guides for setting up partner programs, conversion tracking, and link attribution with Dub." +--- + +Dub is the link attribution platform for building partner, affiliate, and referral programs. With powerful conversion tracking and 1-click global payouts, Dub helps you turn your customers and creators into a scalable growth channel. + +## Who Uses Dub? + +Dub is trusted by leading companies including Perplexity, Vercel, Raycast, Clerk, Framer, Nuxt, and Prisma to run partner programs, attribute revenue, and track link performance. + + + Explore [featured customers](https://dub.co/customers) to learn about their use cases and how Dub has impacted their business before implementing your own partner program. + + +## Popular Articles + + + + Create powerful affiliate, influencer, and referral programs + + + Track leads and sales from your marketing campaigns + + + Track clicks, conversions, and revenue in real-time + + + Get started with your first Dub short link + + + +## Dub Partners + +[Dub Partners](/partners/quickstart) is our flagship product for building affiliate, referral, and ambassador programs: + +- **Conversion tracking** - Attribute signups and revenue to the partners who drove them +- **Automated payouts** - 1-click global payouts to partners in 130+ countries +- **White-label portals** - Embed a branded partner dashboard directly in your app +- **Flexible rewards** - Configure percentage-based, flat-rate, or tiered commission structures +- **Native integrations** - Connect with [Stripe](/conversions/sales/stripe), [Shopify](/conversions/sales/shopify), and more for automatic tracking + +## Link Management + +Create and customize short links with powerful features: + +- **Custom domains** - Branded short links using your own domain +- **Device & geo targeting** - Redirect users based on device type or location +- **UTM builder** - Track campaigns with built-in UTM parameter support +- **Custom social cards** - Set previews for social media sharing +- **Password protection & expiration** - Secure and time-limit sensitive links + +## Analytics + +Track performance with comprehensive analytics: + +- **Click & conversion tracking** - Monitor clicks, leads, and sales in real-time +- **Revenue attribution** - See exactly which links drive revenue +- **Time-series charts** - Visualize performance over any time period +- **Data export** - Export analytics for further analysis + +## Developer Tools + +- **API & SDKs** - Native SDKs for [TypeScript](/sdks/typescript), [Python](/sdks/python), [Go](/sdks/go), [Ruby](/sdks/ruby), and [PHP](/sdks/php) +- **Webhooks** - Real-time notifications for link clicks, leads, and sales +- **Mobile SDKs** - [Swift](/sdks/client-side-mobile/installation-guides/swift) and [React Native](/sdks/client-side-mobile/installation-guides/react-native) for mobile apps + +## Browse Guides + + + + Create, organize, and optimize your short links + + + Understand your link performance and conversions + + + Build and manage partner, affiliate, and referral programs + + + For partners: earn commissions and receive payouts + + + Use your own domain for branded short links + + + Manage your team, roles, and billing + + + Switch from Rewardful, PartnerStack, and others + + + Enterprise single sign-on with Okta, Google, and Azure + + + Integrate Dub programmatically with our REST API + + diff --git a/guides/getting-started/what-is-a-workspace.mdx b/guides/getting-started/what-is-a-workspace.mdx new file mode 100644 index 00000000..72ab37f6 --- /dev/null +++ b/guides/getting-started/what-is-a-workspace.mdx @@ -0,0 +1,6 @@ +--- +title: "What Is a Workspace" +description: "Learn what a workspace is and how it works on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/ab-testing.mdx b/guides/link-management/ab-testing.mdx new file mode 100644 index 00000000..860add1e --- /dev/null +++ b/guides/link-management/ab-testing.mdx @@ -0,0 +1,6 @@ +--- +title: "A/B Testing" +description: "Learn how to set up A/B testing for links on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/bulk-link-actions.mdx b/guides/link-management/bulk-link-actions.mdx new file mode 100644 index 00000000..2d7f1fde --- /dev/null +++ b/guides/link-management/bulk-link-actions.mdx @@ -0,0 +1,6 @@ +--- +title: "Bulk Link Actions" +description: "Learn how to perform bulk actions on links on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/custom-link-previews.mdx b/guides/link-management/custom-link-previews.mdx new file mode 100644 index 00000000..8f09ddb3 --- /dev/null +++ b/guides/link-management/custom-link-previews.mdx @@ -0,0 +1,6 @@ +--- +title: "Custom Link Previews" +description: "Learn how to set custom link previews on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/custom-qr-codes.mdx b/guides/link-management/custom-qr-codes.mdx new file mode 100644 index 00000000..1812b318 --- /dev/null +++ b/guides/link-management/custom-qr-codes.mdx @@ -0,0 +1,6 @@ +--- +title: "Custom QR Codes" +description: "Learn how to create custom QR codes on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/device-targeting.mdx b/guides/link-management/device-targeting.mdx new file mode 100644 index 00000000..0e5fdabe --- /dev/null +++ b/guides/link-management/device-targeting.mdx @@ -0,0 +1,6 @@ +--- +title: "Device Targeting" +description: "Learn how to set up device targeting for links on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/dub-link-builder.mdx b/guides/link-management/dub-link-builder.mdx new file mode 100644 index 00000000..a8e92e66 --- /dev/null +++ b/guides/link-management/dub-link-builder.mdx @@ -0,0 +1,6 @@ +--- +title: "Dub Link Builder" +description: "Learn how to use the Dub link builder." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/dub-links-not-working.mdx b/guides/link-management/dub-links-not-working.mdx new file mode 100644 index 00000000..3945496e --- /dev/null +++ b/guides/link-management/dub-links-not-working.mdx @@ -0,0 +1,6 @@ +--- +title: "Dub Links Not Working" +description: "Learn how to troubleshoot Dub links that are not working." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/folders-rbac.mdx b/guides/link-management/folders-rbac.mdx new file mode 100644 index 00000000..35ab1861 --- /dev/null +++ b/guides/link-management/folders-rbac.mdx @@ -0,0 +1,6 @@ +--- +title: "Folders RBAC" +description: "Learn about role-based access control for folders on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/geo-targeting.mdx b/guides/link-management/geo-targeting.mdx new file mode 100644 index 00000000..0e47ab85 --- /dev/null +++ b/guides/link-management/geo-targeting.mdx @@ -0,0 +1,6 @@ +--- +title: "Geo Targeting" +description: "Learn how to set up geo targeting for links on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/how-noindex-works.mdx b/guides/link-management/how-noindex-works.mdx new file mode 100644 index 00000000..2f94bf20 --- /dev/null +++ b/guides/link-management/how-noindex-works.mdx @@ -0,0 +1,6 @@ +--- +title: "How Noindex Works" +description: "Learn how noindex works for links on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/how-to-check-link-destination.mdx b/guides/link-management/how-to-check-link-destination.mdx new file mode 100644 index 00000000..38c537c3 --- /dev/null +++ b/guides/link-management/how-to-check-link-destination.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Check a Link Destination" +description: "Learn how to check the destination of a link on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/how-to-create-link.mdx b/guides/link-management/how-to-create-link.mdx new file mode 100644 index 00000000..6f2e6f89 --- /dev/null +++ b/guides/link-management/how-to-create-link.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Create a Link" +description: "Learn how to create a short link on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/how-to-create-utm-templates.mdx b/guides/link-management/how-to-create-utm-templates.mdx new file mode 100644 index 00000000..0f5392e1 --- /dev/null +++ b/guides/link-management/how-to-create-utm-templates.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Create UTM Templates" +description: "Learn how to create UTM templates on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/how-to-export-links.mdx b/guides/link-management/how-to-export-links.mdx new file mode 100644 index 00000000..11764dc5 --- /dev/null +++ b/guides/link-management/how-to-export-links.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Export Links" +description: "Learn how to export your links from Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/how-to-transfer-links.mdx b/guides/link-management/how-to-transfer-links.mdx new file mode 100644 index 00000000..60140881 --- /dev/null +++ b/guides/link-management/how-to-transfer-links.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Transfer Links" +description: "Learn how to transfer links between workspaces on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/how-to-use-tags.mdx b/guides/link-management/how-to-use-tags.mdx new file mode 100644 index 00000000..b4f243e5 --- /dev/null +++ b/guides/link-management/how-to-use-tags.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Use Tags" +description: "Learn how to use tags to organize links on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/link-cloaking.mdx b/guides/link-management/link-cloaking.mdx new file mode 100644 index 00000000..cb5e30fa --- /dev/null +++ b/guides/link-management/link-cloaking.mdx @@ -0,0 +1,6 @@ +--- +title: "Link Cloaking" +description: "Learn how link cloaking works on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/link-comments.mdx b/guides/link-management/link-comments.mdx new file mode 100644 index 00000000..7e4565d7 --- /dev/null +++ b/guides/link-management/link-comments.mdx @@ -0,0 +1,6 @@ +--- +title: "Link Comments" +description: "Learn how to add comments to links on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/link-double-redirects.mdx b/guides/link-management/link-double-redirects.mdx new file mode 100644 index 00000000..2a80f7ac --- /dev/null +++ b/guides/link-management/link-double-redirects.mdx @@ -0,0 +1,6 @@ +--- +title: "Link Double Redirects" +description: "Learn about link double redirects on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/link-expiration.mdx b/guides/link-management/link-expiration.mdx new file mode 100644 index 00000000..26fe4f1a --- /dev/null +++ b/guides/link-management/link-expiration.mdx @@ -0,0 +1,6 @@ +--- +title: "Link Expiration" +description: "Learn how to set link expiration on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/link-folders.mdx b/guides/link-management/link-folders.mdx new file mode 100644 index 00000000..c9bc65d5 --- /dev/null +++ b/guides/link-management/link-folders.mdx @@ -0,0 +1,6 @@ +--- +title: "Link Folders" +description: "Learn how to organize links with folders on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/parameter-passing.mdx b/guides/link-management/parameter-passing.mdx new file mode 100644 index 00000000..0242389a --- /dev/null +++ b/guides/link-management/parameter-passing.mdx @@ -0,0 +1,6 @@ +--- +title: "Parameter Passing" +description: "Learn how parameter passing works for links on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/password-protected-links.mdx b/guides/link-management/password-protected-links.mdx new file mode 100644 index 00000000..604fd270 --- /dev/null +++ b/guides/link-management/password-protected-links.mdx @@ -0,0 +1,6 @@ +--- +title: "Password Protected Links" +description: "Learn how to create password protected links on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/link-management/utm-builder.mdx b/guides/link-management/utm-builder.mdx new file mode 100644 index 00000000..15008434 --- /dev/null +++ b/guides/link-management/utm-builder.mdx @@ -0,0 +1,6 @@ +--- +title: "UTM Builder" +description: "Learn how to use the UTM builder on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/migrating/migrating-from-bitly.mdx b/guides/migrating/migrating-from-bitly.mdx new file mode 100644 index 00000000..24770a14 --- /dev/null +++ b/guides/migrating/migrating-from-bitly.mdx @@ -0,0 +1,6 @@ +--- +title: "Migrating from Bitly" +description: "Learn how to migrate from Bitly to Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/migrating/migrating-from-firstpromoter.mdx b/guides/migrating/migrating-from-firstpromoter.mdx new file mode 100644 index 00000000..b42f5351 --- /dev/null +++ b/guides/migrating/migrating-from-firstpromoter.mdx @@ -0,0 +1,6 @@ +--- +title: "Migrating from FirstPromoter" +description: "Learn how to migrate from FirstPromoter to Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/migrating/migrating-from-partnerstack.mdx b/guides/migrating/migrating-from-partnerstack.mdx new file mode 100644 index 00000000..bd032cf7 --- /dev/null +++ b/guides/migrating/migrating-from-partnerstack.mdx @@ -0,0 +1,6 @@ +--- +title: "Migrating from PartnerStack" +description: "Learn how to migrate from PartnerStack to Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/migrating/migrating-from-rebrandly.mdx b/guides/migrating/migrating-from-rebrandly.mdx new file mode 100644 index 00000000..f07c5928 --- /dev/null +++ b/guides/migrating/migrating-from-rebrandly.mdx @@ -0,0 +1,6 @@ +--- +title: "Migrating from Rebrandly" +description: "Learn how to migrate from Rebrandly to Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/migrating/migrating-from-rewardful.mdx b/guides/migrating/migrating-from-rewardful.mdx new file mode 100644 index 00000000..fb6860e8 --- /dev/null +++ b/guides/migrating/migrating-from-rewardful.mdx @@ -0,0 +1,6 @@ +--- +title: "Migrating from Rewardful" +description: "Learn how to migrate from Rewardful to Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/migrating/migrating-from-short.mdx b/guides/migrating/migrating-from-short.mdx new file mode 100644 index 00000000..de20ac0c --- /dev/null +++ b/guides/migrating/migrating-from-short.mdx @@ -0,0 +1,6 @@ +--- +title: "Migrating from Short.io" +description: "Learn how to migrate from Short.io to Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/migrating/migrating-from-tolt.mdx b/guides/migrating/migrating-from-tolt.mdx new file mode 100644 index 00000000..ea221d6a --- /dev/null +++ b/guides/migrating/migrating-from-tolt.mdx @@ -0,0 +1,6 @@ +--- +title: "Migrating from Tolt" +description: "Learn how to migrate from Tolt to Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/dual-sided-incentives.mdx b/guides/partners/dual-sided-incentives.mdx new file mode 100644 index 00000000..c3c22ca1 --- /dev/null +++ b/guides/partners/dual-sided-incentives.mdx @@ -0,0 +1,6 @@ +--- +title: "Dual-Sided Incentives" +description: "Learn how to set up dual-sided incentives on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/dub-partners.mdx b/guides/partners/dub-partners.mdx new file mode 100644 index 00000000..6ddaf330 --- /dev/null +++ b/guides/partners/dub-partners.mdx @@ -0,0 +1,6 @@ +--- +title: "Dub Partners" +description: "Learn about Dub Partners for affiliate and referral programs." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/email-campaigns.mdx b/guides/partners/email-campaigns.mdx new file mode 100644 index 00000000..1c905c56 --- /dev/null +++ b/guides/partners/email-campaigns.mdx @@ -0,0 +1,6 @@ +--- +title: "Email Campaigns" +description: "Learn how to run email campaigns for partners on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/fraud-detection.mdx b/guides/partners/fraud-detection.mdx new file mode 100644 index 00000000..fc9d6c81 --- /dev/null +++ b/guides/partners/fraud-detection.mdx @@ -0,0 +1,6 @@ +--- +title: "Fraud Detection" +description: "Learn about fraud detection for partner programs on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/how-to-set-up-bank-account.mdx b/guides/partners/how-to-set-up-bank-account.mdx new file mode 100644 index 00000000..6a173052 --- /dev/null +++ b/guides/partners/how-to-set-up-bank-account.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Set Up a Bank Account" +description: "Learn how to set up a bank account for payouts on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/inviting-partners.mdx b/guides/partners/inviting-partners.mdx new file mode 100644 index 00000000..1d49a32a --- /dev/null +++ b/guides/partners/inviting-partners.mdx @@ -0,0 +1,6 @@ +--- +title: "Inviting Partners" +description: "Learn how to invite partners to your program on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/managing-program-partners.mdx b/guides/partners/managing-program-partners.mdx new file mode 100644 index 00000000..6d8cd697 --- /dev/null +++ b/guides/partners/managing-program-partners.mdx @@ -0,0 +1,6 @@ +--- +title: "Managing Program Partners" +description: "Learn how to manage partners in your program on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/messaging-partners.mdx b/guides/partners/messaging-partners.mdx new file mode 100644 index 00000000..1fa5568e --- /dev/null +++ b/guides/partners/messaging-partners.mdx @@ -0,0 +1,6 @@ +--- +title: "Messaging Partners" +description: "Learn how to message partners on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/partner-commissions.mdx b/guides/partners/partner-commissions.mdx new file mode 100644 index 00000000..d45d35a3 --- /dev/null +++ b/guides/partners/partner-commissions.mdx @@ -0,0 +1,6 @@ +--- +title: "Partner Commissions" +description: "Learn how partner commissions work on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/partner-groups.mdx b/guides/partners/partner-groups.mdx new file mode 100644 index 00000000..d217165f --- /dev/null +++ b/guides/partners/partner-groups.mdx @@ -0,0 +1,6 @@ +--- +title: "Partner Groups" +description: "Learn how to organize partners into groups on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/partner-link-settings.mdx b/guides/partners/partner-link-settings.mdx new file mode 100644 index 00000000..d98cf357 --- /dev/null +++ b/guides/partners/partner-link-settings.mdx @@ -0,0 +1,6 @@ +--- +title: "Partner Link Settings" +description: "Learn how to configure partner link settings on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/partner-payouts.mdx b/guides/partners/partner-payouts.mdx new file mode 100644 index 00000000..41ff1c97 --- /dev/null +++ b/guides/partners/partner-payouts.mdx @@ -0,0 +1,6 @@ +--- +title: "Partner Payouts" +description: "Learn how partner payouts work on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/partner-rewards.mdx b/guides/partners/partner-rewards.mdx new file mode 100644 index 00000000..3b820339 --- /dev/null +++ b/guides/partners/partner-rewards.mdx @@ -0,0 +1,6 @@ +--- +title: "Partner Rewards" +description: "Learn how to configure partner rewards on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/program-analytics.mdx b/guides/partners/program-analytics.mdx new file mode 100644 index 00000000..3668dce4 --- /dev/null +++ b/guides/partners/program-analytics.mdx @@ -0,0 +1,6 @@ +--- +title: "Program Analytics" +description: "Learn about partner program analytics on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/program-application-form.mdx b/guides/partners/program-application-form.mdx new file mode 100644 index 00000000..40f0b15f --- /dev/null +++ b/guides/partners/program-application-form.mdx @@ -0,0 +1,6 @@ +--- +title: "Program Application Form" +description: "Learn how to customize the program application form on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/program-applications.mdx b/guides/partners/program-applications.mdx new file mode 100644 index 00000000..7f017c57 --- /dev/null +++ b/guides/partners/program-applications.mdx @@ -0,0 +1,6 @@ +--- +title: "Program Applications" +description: "Learn how to manage program applications on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/program-bounties.mdx b/guides/partners/program-bounties.mdx new file mode 100644 index 00000000..30dc3a5e --- /dev/null +++ b/guides/partners/program-bounties.mdx @@ -0,0 +1,6 @@ +--- +title: "Program Bounties" +description: "Learn how to set up program bounties on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/program-landing-page.mdx b/guides/partners/program-landing-page.mdx new file mode 100644 index 00000000..c506383f --- /dev/null +++ b/guides/partners/program-landing-page.mdx @@ -0,0 +1,6 @@ +--- +title: "Program Landing Page" +description: "Learn how to set up a program landing page on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/partners/program-resources.mdx b/guides/partners/program-resources.mdx new file mode 100644 index 00000000..577588aa --- /dev/null +++ b/guides/partners/program-resources.mdx @@ -0,0 +1,6 @@ +--- +title: "Program Resources" +description: "Learn how to manage program resources on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/programs/commissions-payouts.mdx b/guides/programs/commissions-payouts.mdx new file mode 100644 index 00000000..4c412f71 --- /dev/null +++ b/guides/programs/commissions-payouts.mdx @@ -0,0 +1,6 @@ +--- +title: "Commissions and Payouts" +description: "Learn about commissions and payouts for partners on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/programs/communicating-with-programs.mdx b/guides/programs/communicating-with-programs.mdx new file mode 100644 index 00000000..77f2f7ee --- /dev/null +++ b/guides/programs/communicating-with-programs.mdx @@ -0,0 +1,6 @@ +--- +title: "Communicating with Programs" +description: "Learn how to communicate with programs as a partner on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/programs/managing-partner-teams.mdx b/guides/programs/managing-partner-teams.mdx new file mode 100644 index 00000000..dae30b9a --- /dev/null +++ b/guides/programs/managing-partner-teams.mdx @@ -0,0 +1,6 @@ +--- +title: "Managing Partner Teams" +description: "Learn how to manage partner teams on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/programs/merging-partner-accounts.mdx b/guides/programs/merging-partner-accounts.mdx new file mode 100644 index 00000000..823a71b5 --- /dev/null +++ b/guides/programs/merging-partner-accounts.mdx @@ -0,0 +1,6 @@ +--- +title: "Merging Partner Accounts" +description: "Learn how to merge partner accounts on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/programs/navigating-partner-program.mdx b/guides/programs/navigating-partner-program.mdx new file mode 100644 index 00000000..84f68c35 --- /dev/null +++ b/guides/programs/navigating-partner-program.mdx @@ -0,0 +1,6 @@ +--- +title: "Navigating a Partner Program" +description: "Learn how to navigate a partner program on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/programs/partner-payout-invoice.mdx b/guides/programs/partner-payout-invoice.mdx new file mode 100644 index 00000000..a53b113a --- /dev/null +++ b/guides/programs/partner-payout-invoice.mdx @@ -0,0 +1,6 @@ +--- +title: "Partner Payout Invoice" +description: "Learn about partner payout invoices on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/programs/partner-profile.mdx b/guides/programs/partner-profile.mdx new file mode 100644 index 00000000..3da207fe --- /dev/null +++ b/guides/programs/partner-profile.mdx @@ -0,0 +1,6 @@ +--- +title: "Partner Profile" +description: "Learn how to manage your partner profile on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/programs/partners-faq.mdx b/guides/programs/partners-faq.mdx new file mode 100644 index 00000000..f2c84e9b --- /dev/null +++ b/guides/programs/partners-faq.mdx @@ -0,0 +1,6 @@ +--- +title: "Partners FAQ" +description: "Frequently asked questions about being a partner on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/programs/program-marketplace.mdx b/guides/programs/program-marketplace.mdx new file mode 100644 index 00000000..d6f8508d --- /dev/null +++ b/guides/programs/program-marketplace.mdx @@ -0,0 +1,6 @@ +--- +title: "Program Marketplace" +description: "Learn about the program marketplace on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/programs/receiving-payouts.mdx b/guides/programs/receiving-payouts.mdx new file mode 100644 index 00000000..956f9a1c --- /dev/null +++ b/guides/programs/receiving-payouts.mdx @@ -0,0 +1,6 @@ +--- +title: "Receiving Payouts" +description: "Learn how to receive payouts as a partner on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/saml-sso/azure-saml.mdx b/guides/saml-sso/azure-saml.mdx new file mode 100644 index 00000000..13c2049c --- /dev/null +++ b/guides/saml-sso/azure-saml.mdx @@ -0,0 +1,6 @@ +--- +title: "Azure SAML" +description: "Learn how to set up Azure SAML SSO with Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/saml-sso/azure-scim.mdx b/guides/saml-sso/azure-scim.mdx new file mode 100644 index 00000000..0e36241a --- /dev/null +++ b/guides/saml-sso/azure-scim.mdx @@ -0,0 +1,6 @@ +--- +title: "Azure SCIM" +description: "Learn how to set up Azure SCIM provisioning with Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/saml-sso/google-saml.mdx b/guides/saml-sso/google-saml.mdx new file mode 100644 index 00000000..969bc657 --- /dev/null +++ b/guides/saml-sso/google-saml.mdx @@ -0,0 +1,6 @@ +--- +title: "Google SAML" +description: "Learn how to set up Google SAML SSO with Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/saml-sso/okta-saml.mdx b/guides/saml-sso/okta-saml.mdx new file mode 100644 index 00000000..f9e103e3 --- /dev/null +++ b/guides/saml-sso/okta-saml.mdx @@ -0,0 +1,6 @@ +--- +title: "Okta SAML" +description: "Learn how to set up Okta SAML SSO with Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/saml-sso/okta-scim.mdx b/guides/saml-sso/okta-scim.mdx new file mode 100644 index 00000000..74817e54 --- /dev/null +++ b/guides/saml-sso/okta-scim.mdx @@ -0,0 +1,6 @@ +--- +title: "Okta SCIM" +description: "Learn how to set up Okta SCIM provisioning with Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/workspaces/how-to-cancel-subscription.mdx b/guides/workspaces/how-to-cancel-subscription.mdx new file mode 100644 index 00000000..0d55d882 --- /dev/null +++ b/guides/workspaces/how-to-cancel-subscription.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Cancel a Subscription" +description: "Learn how to cancel your subscription on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/workspaces/how-to-change-billing-information.mdx b/guides/workspaces/how-to-change-billing-information.mdx new file mode 100644 index 00000000..3d9e369a --- /dev/null +++ b/guides/workspaces/how-to-change-billing-information.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Change Billing Information" +description: "Learn how to change your billing information on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/workspaces/how-to-download-invoice.mdx b/guides/workspaces/how-to-download-invoice.mdx new file mode 100644 index 00000000..8281fa98 --- /dev/null +++ b/guides/workspaces/how-to-download-invoice.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Download an Invoice" +description: "Learn how to download an invoice on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/workspaces/how-to-invite-teammates.mdx b/guides/workspaces/how-to-invite-teammates.mdx new file mode 100644 index 00000000..139d0172 --- /dev/null +++ b/guides/workspaces/how-to-invite-teammates.mdx @@ -0,0 +1,6 @@ +--- +title: "How to Invite Teammates" +description: "Learn how to invite teammates to your Dub workspace." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/workspaces/what-is-a-workspace.mdx b/guides/workspaces/what-is-a-workspace.mdx new file mode 100644 index 00000000..72ab37f6 --- /dev/null +++ b/guides/workspaces/what-is-a-workspace.mdx @@ -0,0 +1,6 @@ +--- +title: "What Is a Workspace" +description: "Learn what a workspace is and how it works on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/guides/workspaces/workspace-roles.mdx b/guides/workspaces/workspace-roles.mdx new file mode 100644 index 00000000..986969ee --- /dev/null +++ b/guides/workspaces/workspace-roles.mdx @@ -0,0 +1,6 @@ +--- +title: "Workspace Roles" +description: "Learn about workspace roles and permissions on Dub." +--- + +This guide is being migrated from the [Dub Help Center](https://dub.co/help). diff --git a/images/data-model.png b/images/data-model.png new file mode 100644 index 00000000..829b5148 Binary files /dev/null and b/images/data-model.png differ diff --git a/images/docs-preview.png b/images/docs-preview.png new file mode 100644 index 00000000..453bb8fc Binary files /dev/null and b/images/docs-preview.png differ diff --git a/images/dub-partners-flow.png b/images/dub-partners-flow.png new file mode 100644 index 00000000..769520ff Binary files /dev/null and b/images/dub-partners-flow.png differ diff --git a/images/partners/configure-rewards-amount.png b/images/partners/configure-rewards-amount.png new file mode 100644 index 00000000..78289cbd Binary files /dev/null and b/images/partners/configure-rewards-amount.png differ diff --git a/images/partners/configure-rewards-type.png b/images/partners/configure-rewards-type.png new file mode 100644 index 00000000..4552189b Binary files /dev/null and b/images/partners/configure-rewards-type.png differ diff --git a/images/partners/help-and-support.png b/images/partners/help-and-support.png new file mode 100644 index 00000000..99d3d713 Binary files /dev/null and b/images/partners/help-and-support.png differ diff --git a/images/partners/invite-partners.png b/images/partners/invite-partners.png new file mode 100644 index 00000000..7153be6c Binary files /dev/null and b/images/partners/invite-partners.png differ diff --git a/images/partners/program-basics-name-logo.png b/images/partners/program-basics-name-logo.png new file mode 100644 index 00000000..11b3ac28 Binary files /dev/null and b/images/partners/program-basics-name-logo.png differ diff --git a/images/partners/program-basics-referral-link.png b/images/partners/program-basics-referral-link.png new file mode 100644 index 00000000..586ce018 Binary files /dev/null and b/images/partners/program-basics-referral-link.png differ diff --git a/images/partners/program-basics-website-url.png b/images/partners/program-basics-website-url.png new file mode 100644 index 00000000..59bf4e42 Binary files /dev/null and b/images/partners/program-basics-website-url.png differ diff --git a/images/partners/program-overview.png b/images/partners/program-overview.png new file mode 100644 index 00000000..4dbaa94f Binary files /dev/null and b/images/partners/program-overview.png differ diff --git a/integrations/quickstart.mdx b/integrations/quickstart.mdx index 09cacc63..a6a488be 100644 --- a/integrations/quickstart.mdx +++ b/integrations/quickstart.mdx @@ -294,12 +294,12 @@ Dub supports the following scopes for OAuth 2.0: - See the full example on GitHub. + See the full example on GitHub diff --git a/introduction.mdx b/introduction.mdx index ed57113e..f2071f30 100644 --- a/introduction.mdx +++ b/introduction.mdx @@ -1,55 +1,100 @@ --- title: Introduction -"og:description": "Dub is the modern link attribution platform for you to create short links, track conversion analytics, and run affiliate programs." +description: "Build and scale affiliate, referral, and ambassador programs with powerful attribution tracking." "og:image": /images/docs-og.jpg --- -[Dub](https://dub.co) is the modern link attribution platform for you to [create short links](/concepts/links/introduction), [track conversion analytics](/conversions/quickstart), and [run affiliate programs](/partners/quickstart). +[Dub](https://dub.co) is the modern link attribution platform for you to [run partner programs](/partners/quickstart), [track conversion analytics](/conversions/quickstart), and [create short links](/concepts/links/introduction). Whether you are: -- a marketer looking to track the success of your campaigns -- a creator looking to measure the impact of your content -- a founder looking to [start an affiliate program](/partners/quickstart) +- a founder looking to [launch an affiliate or referral program](/partners/quickstart) +- a marketer looking to [track the success of your campaigns](/conversions/quickstart) +- a creator looking to [measure the impact of your content](/concepts/analytics/introduction) - a developer looking to [integrate link analytics](/concepts/analytics/introduction) into your application We've got you covered. ## Key features -Dub is more than just a link shortener – we offer a suite of tools to help you measure attribution and grow your business with partnerships. +Dub offers a suite of tools to help you grow your business with partnerships, track conversions, and measure attribution across all your marketing channels. Here are some of the features that Dub offers: -- [Create short links](/concepts/links/introduction) (including [bulk link creation](/concepts/links/bulk-operations)) -- [Real-time link analytics](/concepts/analytics/introduction) +- [Partner programs](/partners/quickstart) (affiliate, referral, and ambassador programs with white-labeling) - [Conversion tracking](/conversions/quickstart) -- [Partner programs](/partners/quickstart) (e.g. referral/affiliate programs) +- [Real-time link analytics](/concepts/analytics/introduction) +- [Create short links](/concepts/links/introduction) (including [bulk link creation](/concepts/links/bulk-operations)) - [Webhooks](/concepts/webhooks/introduction) - [Integrations](https://dub.co/integrations) + [building custom integrations](/integrations/quickstart) - [REST API](/api-reference/introduction) + [native SDKs](/sdks/overview) for multiple languages -## Getting started +## What would you like to do? + + + + Set up affiliate or referral tracking from scratch + + + Attribute revenue to your marketing campaigns + + + Add Dub to your existing codebase with our SDKs + + + Use Stripe, Shopify, Segment, or other platforms + + + +## Popular integrations -To get started with Dub, you can do any of the following: +Connect Dub with your existing tools to track conversions and attribute revenue. - - Learn how to use Dub's API to interact with Dub programmatically + + Track recurring revenue, refunds, and payment events - - Learn how to integrate Dub with your favorite tools + + Native app for e-commerce conversion tracking - - Follow our quickstart guide to get started with conversion tracking + + No-code client-side tracking + + + Automate workflows with 7,000+ apps + + + Sync leads and deals to your CRM + + + Route data to your analytics stack + + + +See all [platform integrations](/integrations) to automate conversion tracking, sync data with your existing tools, and reduce manual setup time. + +## SDKs + +Integrate Dub programmatically with our native SDKs to create links at scale, track conversions server-side, and build custom workflows. + + + + TypeScript SDK for Node.js and browser + + + Python SDK for server-side integration + + + Go SDK for backend services + + + PHP SDK for web applications + + + Ruby SDK for Rails and more - - Build powerful referral/affiliate programs with white-labeling and 1-click - payouts + + Command-line interface for Dub diff --git a/partners/how-attribution-works.mdx b/partners/how-attribution-works.mdx new file mode 100644 index 00000000..d496f950 --- /dev/null +++ b/partners/how-attribution-works.mdx @@ -0,0 +1,283 @@ +--- +title: "How attribution works" +description: "A deep-dive into Dub's attribution system and how conversions are tracked from click to commission." +--- + +Understanding how Dub attributes conversions to partners is essential for setting up accurate tracking and ensuring your partners get credited for the sales they drive. + +## The Attribution Flow + +Dub uses a multi-stage attribution model that tracks the complete customer journey from initial click to final purchase: + + + Partner link clicked, `dub_id` appended to URL + SDK stores `dub_id` as first-party cookie + Customer action tracked, linked to click + Purchase tracked, linked to customer + Partner reward automatically calculated + + +### Stage 1: Click Tracking + +When a visitor clicks a partner's referral link, Dub captures the click **server-side** before redirecting to your website. This happens automatically and cannot be blocked by ad blockers. + +**Data captured at click:** +- Unique click ID +- Timestamp +- Geographic location (country, city, continent) +- Device type (mobile, desktop, tablet) +- Browser and operating system +- Referrer URL +- Whether the click came from a QR code + +The click is appended to your destination URL as a `dub_id` query parameter: + +``` +https://yoursite.com?dub_id=cm3w8x2... +``` + + + Diagram showing how click events are tracked + + +### Stage 2: Cookie Storage + +When the visitor lands on your site, the [@dub/analytics SDK](/sdks/client-side/introduction) detects the `dub_id` parameter and stores it as a **first-party cookie**. + +```javascript +// The SDK automatically handles this when installed +// Cookie: dub_id=cm3w8x2... (expires in 90 days by default) +``` + +**Why first-party cookies?** +- Persist across page navigation and sessions +- Not blocked by ad blockers (unlike third-party cookies) +- Compliant with privacy regulations +- Work reliably across all browsers + +The default cookie lifetime is **90 days**, meaning conversions within this window are attributed to the original click. You can customize this with the `expiresInDays` parameter. + +### Stage 3: Lead Event + +When the visitor takes a qualifying action (signup, booking, form submission), you track a **lead event**. This links the customer to the original click. + +```typescript +await dub.track.lead({ + clickId: cookies.get("dub_id"), // From the cookie + eventName: "Sign Up", + customerExternalId: user.id, // Your user ID + customerEmail: user.email, + customerName: user.name, +}); +``` + +The lead event is **automatically deduplicated** based on `customerExternalId` + `eventName`. Only the first event for each combination is recorded, preventing duplicate attribution. + + + Diagram showing how lead events are tracked + + +### Stage 4: Sale Event + +When the customer makes a purchase, you track a **sale event**. Dub automatically links this to the customer's previous lead event. + +```typescript +await dub.track.sale({ + customerExternalId: user.id, // Same ID from lead event + amount: 9900, // Amount in cents ($99.00) + paymentProcessor: "stripe", + invoiceId: "inv_123", // For idempotency +}); +``` + +The sale is attributed to the partner who drove the original click, and a **commission record** is automatically created based on your program's reward rules. + + + Diagram showing how sale events are tracked + + +## Attribution Models + +Dub supports two attribution models: + +### Last-Click Attribution (Default) + +All credit goes to the **most recent** partner link the customer clicked before converting. + +```html + +``` + +**Best for:** Most programs, especially those with shorter sales cycles. + +### First-Click Attribution + +All credit goes to the **first** partner who introduced the customer, regardless of subsequent clicks. + +```html + +``` + +**Best for:** Programs where initial discovery is highly valuable, or products with long consideration periods. + +## Handling Multiple Clicks + +When a customer clicks multiple partner links: + +| Model | Behavior | +|-------|----------| +| Last-click | The `dub_id` cookie is overwritten with each new click. The most recent partner gets credit. | +| First-click | The original `dub_id` cookie is preserved. The first partner retains credit. | + +Each click is still recorded in analytics, so you can see the full customer journey even if only one partner receives the commission. + +## Attribution Window + +The **attribution window** is the timeframe during which a conversion can be credited to a click. In Dub, this is controlled by the cookie lifetime: + +| Configuration | Default | Description | +|--------------|---------|-------------| +| `expiresInDays` | 90 | Days the `dub_id` cookie persists | + +```html + + +``` + +After the cookie expires, new conversions cannot be attributed to the original click unless the customer clicks another partner link. + +## Cross-Domain Attribution + +If your customer journey spans multiple domains (e.g., `yoursite.com` → `app.yoursite.com`), Dub supports cross-domain tracking: + +### Subdomain Tracking + +For subdomains, set the cookie domain to your apex domain: + +```html + +``` + +This makes the `dub_id` cookie accessible across `www.yoursite.com`, `app.yoursite.com`, etc. + +### Multi-Domain Tracking + +For separate domains, use the `outbound` parameter to automatically append `dub_id` to outbound links: + +```html + +``` + +Learn more in the [cross-domain tracking guide](/sdks/client-side/features/cross-domain-tracking). + +## Partner Commission Flow + +When a sale is attributed, Dub automatically calculates and records the partner's commission: + +1. **Sale event received** with `customerExternalId` +2. **Customer lookup** finds the associated lead and original click +3. **Partner identified** from the click's referral link +4. **Commission calculated** based on program reward rules +5. **Commission record created** with status: `pending` + +Commissions can then be: +- **Approved** manually or automatically after a hold period +- **Paid** via Dub's 1-click payout system +- **Adjusted** for refunds or chargebacks + +## Direct Sale Attribution + +For scenarios without a signup flow (e.g., one-time purchases), you can track sales directly with the click ID: + +```typescript +await dub.track.sale({ + clickId: cookies.get("dub_id"), // Directly from cookie + customerExternalId: order.email, + customerName: order.name, + customerEmail: order.email, + amount: 4900, + invoiceId: order.id, +}); +``` + + + Direct sale tracking bypasses the lead event. This means lead-based rewards are not created—only sale commissions. + + +## Deferred Attribution + +For products with qualification periods (trials, approvals), Dub supports **deferred lead attribution**: + +```typescript +// Track initial signup (deferred) +await dub.track.lead({ + clickId: cookies.get("dub_id"), + eventName: "Sign Up", + customerExternalId: user.id, + mode: "deferred", // Creates customer link but defers reward +}); + +// Later, when qualified +await dub.track.lead({ + clickId: "", // Empty - uses existing customer record + eventName: "Qualified Lead", + customerExternalId: user.id, // Same customer ID +}); +``` + +This ensures partners are only rewarded when customers reach a meaningful milestone. + +## Troubleshooting Attribution + +### Common issues + +| Issue | Cause | Solution | +|-------|-------|----------| +| Conversions not attributed | `dub_id` cookie missing | Verify SDK installation and allowed hostnames | +| Wrong partner credited | Last-click model with multiple clicks | Consider first-click model if appropriate | +| Duplicate leads | Same customer tracked twice | Ensure consistent `customerExternalId` | +| Missing commission | Sale tracked before lead | Track lead event first, or use direct sale tracking | + +### Verifying attribution + +1. **Check the cookie**: Inspect browser cookies for `dub_id` +2. **Test the flow**: Click a partner link, sign up, and verify the lead appears in your dashboard +3. **Review analytics**: Check the Events tab for click → lead → sale progression + +## Next Steps + + + + Implement lead and sale tracking + + + Set up commission rules for your program + + diff --git a/partners/link-based-discounts.mdx b/partners/link-based-discounts.mdx index 0c16a1a6..ca69194f 100644 --- a/partners/link-based-discounts.mdx +++ b/partners/link-based-discounts.mdx @@ -1,6 +1,6 @@ --- title: "Link-based discounts" -description: "Set up dual-sided incentives for your affiliate/referral programs with link-based and promo code-based discounts" +description: "Set up dual-sided incentives for your affiliate/referral programs with link-based and promo code-based discounts." --- import FetchPartnerDiscountData from "/snippets/fetch-partner-discount-data.mdx"; diff --git a/partners/program-setup.mdx b/partners/program-setup.mdx new file mode 100644 index 00000000..344a7c37 --- /dev/null +++ b/partners/program-setup.mdx @@ -0,0 +1,289 @@ +--- +title: "Partner program setup" +description: "A comprehensive guide to configuring your partner program after setting up conversion tracking." +og:title: "Partner Program Setup | Dub Partners" +"og:image": "https://assets.dub.co/cms/dub-partners.jpg" +--- + + + Dub Partners require a [Business plan](https://dub.co/pricing) subscription or + higher. + + +This guide walks you through the complete setup of your partner program. + + + Before proceeding, complete the [Partners Quickstart](/partners/quickstart) to install the client-side SDK and set up conversion tracking. + + +## Creating your program + +To create your partner program, launch the onboarding wizard: + + + Launch the program onboarding wizard to set up your affiliate or referral program + + +The wizard guides you through 5 steps: + + + + Configure the basics of your program including name, logo, domain, and reward structure. + + + Set up advanced reward rules, partner groups, and dual-sided incentives. + + + Send email invitations to your first partners or import existing partners from another platform. + + + Access resources and get help setting up your program. + + + View your complete program dashboard once setup is complete. + + + +### Getting started details + +In the first step, you'll configure: + +**Program basics** – Set your company name and upload a logo that will appear on your partner portal and landing page. + + + Program basics - company name and logo + + +**Referral link** – Choose a domain for your partner links (claim a free .link domain or connect your own) and set the destination URL. + + + Program basics - referral link domain and website URL + + +**Website URL** – Set where visitors will be redirected when they click on partner referral links. + + + Program basics - website URL and referral link preview + + +### Configure rewards details + +In the second step, you'll set up your default reward configuration: + +**Reward type** – Choose whether to reward partners for sales (purchases and subscriptions) or leads (signups). + +**Commission structure** – Select one-off payments or recurring commissions for subscription-based products. For recurring rewards, set the duration (e.g., 12 months). + + + Configure rewards - reward type and commission structure + + +**Reward amount** – Set the commission as a percentage of the sale or a flat dollar amount per conversion. + + + Configure rewards - reward structure and amount + + + + After creating your program, you can set up custom reward rules, partner groups, and dual-sided incentives. See [Advanced reward options](#advanced-reward-options) below. + + +### Invite partners + +In the third step, you can invite your first partners by email. Enter their email addresses and they'll receive an invitation to join your program. + + + Invite partners - add partner emails + + +You can also skip this step and invite partners later from your program dashboard, or set up a public landing page where partners can apply to join. + +### Help and Support details + +In the fourth step, configure support resources that will be displayed to partners in their dashboard: + +- **Support email** (required) – Where partners can reach you with questions +- **Help center URL** – Link to your documentation or FAQ +- **Terms of Service URL** – Your affiliate/partner program terms + + + Help and Support - support email and resource URLs + + +### Overview + +The final step displays a summary of your program configuration. Review your reward structure, referral link format, and website URL before clicking **Create program**. + + + Overview - program summary before creation + + +## How conversion tracking powers your program + +Partner commissions are automatically calculated when conversions are tracked. The flow works like this: a customer clicks a partner link → the SDK stores a cookie → you track lead and sale events → Dub calculates the commission based on your reward rules. + + + For a detailed explanation of the click→cookie→lead→sale flow, attribution models, and troubleshooting, see [How attribution works](/partners/how-attribution-works). + + +## Importing from other platforms + +If you're migrating from another affiliate platform, you can import your existing partners and historical conversion data: + + + + Import partners, links, and conversion history + + + Migrate your affiliate program + + + Transfer partners and commissions + + + Import your referral program + + + + + When importing historical conversions, partners will receive credit for past sales and commissions will be calculated based on your current reward rules. + + +## Setting up payouts + +To pay your partners, you'll need to connect your bank account to Dub: + +1. Navigate to your [program settings](https://app.dub.co/settings/payouts) +2. Connect your bank account for outgoing payments +3. Configure payout frequency (manual or automatic) + +Dub supports 1-click global payouts to partners in 130+ countries. Payouts are processed through connected bank accounts (availability varies by country and banking rails). + +For detailed instructions, see [How to set up your bank account](https://dub.co/help/article/how-to-set-up-bank-account). + +## Inviting partners + +There are two ways to grow your partner network: + +### Direct invitations + +Invite specific partners via email directly from your program dashboard. This is ideal for: +- Existing customers you want to turn into affiliates +- Influencers or content creators you've identified +- Strategic partners with established audiences + + + Send targeted invitations to high-value partners you've already identified + + +### Program landing page + +Create a public landing page where anyone can apply to join your program. Configure: +- Program description and benefits +- Commission structure overview +- Application requirements +- Custom branding + +Partners who apply through your landing page will appear in your applications queue for approval. + + + Scale your program with a public page that attracts partners organically + + +## Advanced reward options + +After your program is created, you can configure more sophisticated reward structures: + + + + Custom commission rules based on LTV, product categories, or performance tiers + + + Tiered programs (Bronze, Silver, Gold) with different commission rates per group + + + Offer customer discounts through partner links to boost conversion rates + + + +## White-labeling the partner experience + +Embed the partner dashboard directly in your application so users can join your partner program without leaving your site: + + + + Set up a white-labeled referral dashboard inside your app with secure embed tokens + + + +This creates a seamless experience where your users can: +- Enroll in your partner program +- Access their unique referral links +- Track their conversions and earnings +- Request payouts + +All without being redirected to an external dashboard. + +## Integration options for revenue tracking + +Choose the integration method that best fits your stack: + + + + **Best for:** SaaS, subscriptions, one-time purchases. Automatic tracking of payments, refunds, and recurring billing + + + **Best for:** E-commerce stores. Native app automatically tracks all orders + + + **Best for:** Custom implementations, hybrid tracking, non-standard payment flows + + + **Best for:** Teams already using Segment for analytics + + + +## Next steps + + + + Deep dive into conversion attribution + + + Monitor partner performance + + + Process and manage payouts + + + Protect your program from abuse + + diff --git a/partners/quickstart.mdx b/partners/quickstart.mdx index 99ee324d..3cd6ddb8 100644 --- a/partners/quickstart.mdx +++ b/partners/quickstart.mdx @@ -9,6 +9,8 @@ import DubClientInstall from "/snippets/dub-client-install.mdx"; import DubClientInstallVerify from "/snippets/dub-client-install-verify.mdx"; import VerifyTrackClick from "/snippets/verify-track-click.mdx"; import InstallServerSdksTrackConversions from "/snippets/install-server-sdks-track-conversions.mdx"; +import OpenAnalyticsSettings from "/snippets/open-analytics-settings.mdx"; +import OpenProgramDashboard from "/snippets/open-program-dashboard.mdx"; Dub Partners require a [Business plan](https://dub.co/pricing) subscription or @@ -17,30 +19,18 @@ import InstallServerSdksTrackConversions from "/snippets/install-server-sdks-tra [Dub Partners](https://dub.co/partners) lets you build powerful, scalable referral and affiliate programs with 1-click global payouts and white-labeling functionality. -In this guide, we'll walk you through the steps to get started with Dub Partners: - -1. [Install the `@dub/analytics` client-side SDK](#step-1%3A-install-the-%40dub%2Fanalytics-client-side-sdk) -2. [Install the Dub server-side SDK + track conversion events](#step-2%3A-install-the-dub-server-side-sdk-%2B-track-conversion-events) -3. [Set up your partner program](#step-3%3A-set-up-your-partner-program) - ## Step 1: Install the `@dub/analytics` client-side SDK -First, you'll need to install the [@dub/analytics client-side SDK](/sdks/client-side/introduction). - -This script detects the `dub_id` query parameter and storing it as a first-party cookie, which will be used to attribute subsequent conversion events to the original link. +First, install the [@dub/analytics client-side SDK](/sdks/client-side/introduction). This script captures click attribution by storing a first-party cookie that links conversions back to the referring partner. - - A diagram showing how click events are tracked in the conversion funnel - + + For a detailed explanation of the click→cookie→lead→sale flow, see [How attribution works](/partners/how-attribution-works). + -On top of that, it also: +The SDK also supports: -- lets you [track clicks on the client-side](/sdks/client-side/features/click-tracking) using query parameters (e.g. `?via=john`) -- [automatically fetch the partner and discount data](/sdks/client-side/features/click-tracking#automatically-fetching-partner-and-discount-data) for a given link – which is helpful for displaying [dual-sided incentives](https://dub.co/help/article/dual-sided-incentives) +- [Client-side click tracking](/sdks/client-side/features/click-tracking) via query parameters (e.g. `?via=john`) +- [Fetching partner and discount data](/sdks/client-side/features/click-tracking#automatically-fetching-partner-and-discount-data) for [dual-sided incentives](https://dub.co/help/article/dual-sided-incentives) @@ -50,7 +40,9 @@ Once the script is installed, make sure to verify that [client-side click tracki -In case you missed it, you'll also need to allowlist your site's domain to ensure the client-side click events are ingested by Dub. To do that, navigate to your [workspace's Analytics settings page](https://app.dub.co/settings/analytics) and add your site's domain to the **Allowed Hostnames** list. +In case you missed it, you'll also need to allowlist your site's domain to ensure the client-side click events are ingested by Dub. Navigate to your workspace's Analytics settings page and add your site's domain to the **Allowed Hostnames** list. + + +## Alternative: Use a native integration + +Instead of the manual server-side SDK setup in Step 2, you can use one of our native integrations to track conversions automatically: + + + + Automatically track purchases, subscriptions, and refunds + + + Native app for e-commerce conversion tracking + + + +If you use Stripe or Shopify, you can skip Step 2 and proceed directly to [Step 3: Set up your partner program](#step-3-set-up-your-partner-program). + ## Step 2: Install the Dub server-side SDK + track conversion events @@ -73,13 +80,19 @@ In case you missed it, you'll also need to allowlist your site's domain to ensur Once you have conversion tracking up and running, you can follow these steps to set up your partner program: -1. Go through the [program onboarding flow](https://app.dub.co/program/new) to create your program. + + +1. Go through the program onboarding flow to create your program. - If you're migrating from another platform, you can also import your partners and historical conversions (e.g. [from Rewardful](https://dub.co/help/article/migrating-from-rewardful)). 2. [Connect your bank account](https://dub.co/help/article/how-to-set-up-bank-account) for partner payouts. 3. [Invite your partners](https://dub.co/help/article/inviting-partners) to join your program + set up a branded [program landing page](https://dub.co/help/article/program-landing-page) for future partners. 4. Create [custom reward rules](https://dub.co/help/article/partner-rewards) and [dual-sided incentives](https://dub.co/help/article/dual-sided-incentives) to incentivize partners to share your link with others. 5. Set up a [whitelabeled referral dashboard](/partners/embedded-referrals) that lives directly inside your app so your users can automatically enroll in your partner program without leaving your app. + + For a comprehensive guide on program configuration including conversion tracking integration, see [Partner program setup](/partners/program-setup). + + Dub Partners + +## Verify your setup + +Before going live, confirm you've completed each step: + +| Step | Verification | +|------|--------------| +| **1. Script installed** | Check that `@dub/analytics` loads on your site (no console errors) | +| **2. Domain allowlisted** | Your domain is in [Allowed Hostnames](https://app.dub.co/settings/analytics) | +| **3. Cookie working** | Visit your site via a Dub link and check for `dub_id` cookie | +| **4. Conversions tracking** | Test a signup/purchase and verify it appears in your [Analytics dashboard](https://app.dub.co/analytics) | +| **5. Program created** | Partner program exists in your [dashboard](https://app.dub.co/program/new) | +| **6. Payouts ready** | Bank account connected in [payout settings](https://app.dub.co/settings/payouts) | + +## Next steps + + + + Deep dive into click→lead→sale attribution + + + Configure rewards, invitations, and white-labeling + + diff --git a/platform-overview.mdx b/platform-overview.mdx new file mode 100644 index 00000000..0ccc8a6d --- /dev/null +++ b/platform-overview.mdx @@ -0,0 +1,63 @@ +--- +title: Platform overview +description: "A high-level overview of how the Dub platform works." +--- + +import OpenAnalyticsSettings from "/snippets/open-analytics-settings.mdx"; + +This page provides a high-level, conceptual overview of how the Dub platform works, focusing on the end-to-end flow of the Dub Partners product. + +## The Core Flow + +The partner lifecycle consists of five key stages: + +1. **Program Creation**: A user (the "Program Owner") creates a Partner Program in their Dub workspace. + +2. **Partner Onboarding**: A partner discovers the program and is invited or signs up. They get a unique referral link. + +3. **Link Sharing**: The partner shares their unique link on their website, social media, etc. + +4. **Visitor Click & Conversion**: A visitor clicks the link. The `@dub/analytics` script attributes the click to the partner. The visitor then converts (e.g., signs up, makes a purchase). + +5. **Commission & Payout**: A commission is generated for the partner. The Program Owner can then pay out all partners with 1-click global payouts. + +## Generate Your Script + +Before tracking conversions, you need to install the [`@dub/analytics`](/sdks/client-side/introduction) script on your website. This lightweight script detects when visitors arrive via a Dub link and stores a first-party cookie for attribution. + +To get started: + +1. Navigate to your workspace's Analytics settings page +2. Generate a [publishable key](/api-reference/publishable-keys) for client-side authentication +3. Allowlist the domains where you'll install the script + + + +Once configured, follow one of the [installation guides](/sdks/client-side/introduction#installation-guides) to add the script to your site. + +## Integration Options + +At Stage 4 (Visitor Click & Conversion), you'll need to track when visitors convert. Dub offers multiple integration paths: + + + + **Stripe** and **Shopify** native apps automatically track purchases, subscriptions, and refunds + + + **Google Tag Manager** for no-code client-side tracking on any platform + + + **Zapier** connects Dub to 7,000+ apps to automate your workflows + + + **TypeScript**, **Python**, **Go**, **PHP**, **Ruby** for custom implementations + + + + + Dub Partners Flow - End-to-end partner lifecycle diagram + diff --git a/sdks/cli.mdx b/sdks/cli.mdx index f0f92eb4..a9d34285 100644 --- a/sdks/cli.mdx +++ b/sdks/cli.mdx @@ -1,5 +1,5 @@ --- -title: "Command Line Interface (CLI)" +title: "Command line interface (CLI)" description: Programmatically manage your Dub resources directly from your terminal. --- diff --git a/sdks/client-side-mobile/installation-guides/react-native.mdx b/sdks/client-side-mobile/installation-guides/react-native.mdx index 2a1a2aba..c3004ea9 100644 --- a/sdks/client-side-mobile/installation-guides/react-native.mdx +++ b/sdks/client-side-mobile/installation-guides/react-native.mdx @@ -1,6 +1,6 @@ --- title: React Native -description: How to add the Dub React Native SDK to your React Native project +description: How to add the Dub React Native SDK to your React Native project. tag: "Beta" --- @@ -35,6 +35,6 @@ Here are some open-source code examples that you can reference: href="https://github.com/dubinc/dub-react-native/tree/main/example" color="#333333" > - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/client-side-mobile/installation-guides/swift.mdx b/sdks/client-side-mobile/installation-guides/swift.mdx index 5bdb354f..3756a8c1 100644 --- a/sdks/client-side-mobile/installation-guides/swift.mdx +++ b/sdks/client-side-mobile/installation-guides/swift.mdx @@ -1,6 +1,6 @@ --- title: Swift -description: How to add the Dub iOS SDK to your Swift project +description: How to add the Dub iOS SDK to your Swift project. tag: "Beta" --- @@ -35,7 +35,7 @@ Here are some open-source code examples that you can reference: href="https://github.com/dubinc/dub-ios/tree/main/Examples/SwiftUI" color="#333333" > - See the full example on GitHub. + See the full example on GitHub - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/client-side-mobile/introduction.mdx b/sdks/client-side-mobile/introduction.mdx index 1b49bb9c..f61a6300 100644 --- a/sdks/client-side-mobile/introduction.mdx +++ b/sdks/client-side-mobile/introduction.mdx @@ -35,7 +35,7 @@ Here are some open-source code examples that you can reference: href="https://github.com/dubinc/dub-ios/tree/main/Examples/SwiftUI" color="#333333" > - See the full example on GitHub. + See the full example on GitHub - See the full example on GitHub. + See the full example on GitHub - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/client-side/features/click-tracking.mdx b/sdks/client-side/features/click-tracking.mdx index 01843efc..44a56097 100644 --- a/sdks/client-side/features/click-tracking.mdx +++ b/sdks/client-side/features/click-tracking.mdx @@ -1,6 +1,6 @@ --- title: Client-side click tracking -description: Track clicks on the client-side using query parameters +description: Track clicks on the client-side using query parameters. --- import DubAnalyticsParams from "/snippets/dub-analytics-params-react.mdx"; diff --git a/sdks/client-side/features/conversion-tracking.mdx b/sdks/client-side/features/conversion-tracking.mdx index b77f7d83..1bc918e2 100644 --- a/sdks/client-side/features/conversion-tracking.mdx +++ b/sdks/client-side/features/conversion-tracking.mdx @@ -1,7 +1,7 @@ --- title: Client-side conversion tracking sidebarTitle: Conversion tracking -description: Learn how to use the @dub/analytics script to track conversion events on the client-side +description: Learn how to use the @dub/analytics script to track conversion events on the client-side. --- import EnableConversionTracking from "/snippets/enable-conversion-tracking.mdx"; diff --git a/sdks/client-side/features/cross-domain-tracking.mdx b/sdks/client-side/features/cross-domain-tracking.mdx index 105a3a7d..27506552 100644 --- a/sdks/client-side/features/cross-domain-tracking.mdx +++ b/sdks/client-side/features/cross-domain-tracking.mdx @@ -1,6 +1,6 @@ --- title: Cross-domain tracking -description: Track conversions across domains +description: Track conversions across domains. --- By default, the script already sets the `dub_id` cookie on a **cross-domain level**. diff --git a/sdks/client-side/features/reverse-proxy-support.mdx b/sdks/client-side/features/reverse-proxy-support.mdx index fce78a23..ad3afd9e 100644 --- a/sdks/client-side/features/reverse-proxy-support.mdx +++ b/sdks/client-side/features/reverse-proxy-support.mdx @@ -1,6 +1,6 @@ --- title: Reverse-proxy support -description: Track clicks on the client-side using a reverse proxy +description: Track clicks on the client-side using a reverse proxy. --- ## Tracking clicks via a reverse proxy diff --git a/sdks/client-side/installation-guides/framer.mdx b/sdks/client-side/installation-guides/framer.mdx index e0ff8586..0b464e3c 100644 --- a/sdks/client-side/installation-guides/framer.mdx +++ b/sdks/client-side/installation-guides/framer.mdx @@ -1,6 +1,6 @@ --- title: Framer -description: How to add the @dub/analytics client-side script to your Framer site +description: How to add the @dub/analytics client-side script to your Framer site. --- import DubAnalyticsParams from "/snippets/dub-analytics-params.mdx"; diff --git a/sdks/client-side/installation-guides/google-tag-manager.mdx b/sdks/client-side/installation-guides/google-tag-manager.mdx index ae1e22f5..ad287e48 100644 --- a/sdks/client-side/installation-guides/google-tag-manager.mdx +++ b/sdks/client-side/installation-guides/google-tag-manager.mdx @@ -1,6 +1,6 @@ --- title: Google Tag Manager -description: How to add the @dub/analytics client-side script to your site using Google Tag Manager +description: How to add the @dub/analytics client-side script to your site using Google Tag Manager. og:image: https://assets.dub.co/cms/gtm-integration.jpeg --- diff --git a/sdks/client-side/installation-guides/manual.mdx b/sdks/client-side/installation-guides/manual.mdx index 5cbaba1a..af2851bb 100644 --- a/sdks/client-side/installation-guides/manual.mdx +++ b/sdks/client-side/installation-guides/manual.mdx @@ -1,6 +1,6 @@ --- -title: Manual Installation -description: How to add the @dub/analytics client-side script to your website +title: Manual installation +description: How to add the @dub/analytics client-side script to your website. --- import DubAnalyticsParams from "/snippets/dub-analytics-params.mdx"; diff --git a/sdks/client-side/installation-guides/react.mdx b/sdks/client-side/installation-guides/react.mdx index 0d716ec6..4a3053b4 100644 --- a/sdks/client-side/installation-guides/react.mdx +++ b/sdks/client-side/installation-guides/react.mdx @@ -1,6 +1,6 @@ --- title: React -description: How to add the @dub/analytics client-side script to your React website +description: How to add the @dub/analytics client-side script to your React website. --- import DubAnalyticsInstall from "/snippets/dub-analytics-install.mdx"; diff --git a/sdks/client-side/installation-guides/shopify.mdx b/sdks/client-side/installation-guides/shopify.mdx index 0485ec1c..55fb9257 100644 --- a/sdks/client-side/installation-guides/shopify.mdx +++ b/sdks/client-side/installation-guides/shopify.mdx @@ -1,6 +1,6 @@ --- title: Shopify -description: How to add the @dub/analytics client-side script to your Shopify store +description: How to add the @dub/analytics client-side script to your Shopify store. --- import DubClientInstallVerify from "/snippets/dub-client-install-verify.mdx"; diff --git a/sdks/client-side/installation-guides/webflow.mdx b/sdks/client-side/installation-guides/webflow.mdx index 3897707c..2bafcc3f 100644 --- a/sdks/client-side/installation-guides/webflow.mdx +++ b/sdks/client-side/installation-guides/webflow.mdx @@ -1,6 +1,6 @@ --- title: Webflow -description: How to add the @dub/analytics client-side script to your Webflow site +description: How to add the @dub/analytics client-side script to your Webflow site. --- import DubAnalyticsParams from "/snippets/dub-analytics-params.mdx"; diff --git a/sdks/client-side/installation-guides/wordpress.mdx b/sdks/client-side/installation-guides/wordpress.mdx index 1f211a2e..8b3e531b 100644 --- a/sdks/client-side/installation-guides/wordpress.mdx +++ b/sdks/client-side/installation-guides/wordpress.mdx @@ -1,6 +1,6 @@ --- title: WordPress -description: How to add the @dub/analytics client-side script to your WordPress site +description: How to add the @dub/analytics client-side script to your WordPress site. --- import DubAnalyticsParams from "/snippets/dub-analytics-params.mdx"; diff --git a/sdks/client-side/introduction.mdx b/sdks/client-side/introduction.mdx index a1e648db..e7a9743e 100644 --- a/sdks/client-side/introduction.mdx +++ b/sdks/client-side/introduction.mdx @@ -45,19 +45,19 @@ Here are some open-source code examples that you can reference: - See the full example on GitHub. + See the full example on GitHub - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/client-side/variants.mdx b/sdks/client-side/variants.mdx index 5298efed..9ae72786 100644 --- a/sdks/client-side/variants.mdx +++ b/sdks/client-side/variants.mdx @@ -1,5 +1,5 @@ --- -title: Script Variants +title: Script variants description: Learn more about the different variants of the @dub/analytics script. --- diff --git a/sdks/embed/analytics.mdx b/sdks/embed/analytics.mdx index 6a44dc92..3955cd98 100644 --- a/sdks/embed/analytics.mdx +++ b/sdks/embed/analytics.mdx @@ -1,5 +1,5 @@ --- -title: "Analytics Embed" +title: "Analytics embed" description: "Learn how to embed the Dub Analytics dashboard in your application." --- diff --git a/sdks/embed/referrals.mdx b/sdks/embed/referrals.mdx index cfa021f4..72707310 100644 --- a/sdks/embed/referrals.mdx +++ b/sdks/embed/referrals.mdx @@ -1,5 +1,5 @@ --- -title: "Referrals Embed" +title: "Referrals embed" description: "Learn how to install the Dub Referrals Embed in your application." --- diff --git a/sdks/go.mdx b/sdks/go.mdx index 31cc4fa7..11e3f63a 100644 --- a/sdks/go.mdx +++ b/sdks/go.mdx @@ -71,11 +71,11 @@ You can also check out the [Go SDK quickstart](/sdks/quickstart/go) for a basic ## Additional Resources - + Download and install the Dub Go SDK on GitHub - + Embed the Dub Referrals dashboard in your application diff --git a/sdks/php.mdx b/sdks/php.mdx index 2f507d24..05e15573 100644 --- a/sdks/php.mdx +++ b/sdks/php.mdx @@ -75,7 +75,7 @@ If you're using a different PHP framework, you can refer to the [PHP SDK quickst Download and install the Dub PHP SDK on Packagist diff --git a/sdks/python.mdx b/sdks/python.mdx index 444d097b..175caabb 100644 --- a/sdks/python.mdx +++ b/sdks/python.mdx @@ -56,11 +56,11 @@ If you're using a different Python framework, you can refer to the [Python SDK q ## Additional Resources - + Download and install the Dub Python SDK on PyPI diff --git a/sdks/quickstart/django.mdx b/sdks/quickstart/django.mdx index bbebeb9d..9e558d86 100644 --- a/sdks/quickstart/django.mdx +++ b/sdks/quickstart/django.mdx @@ -158,11 +158,11 @@ def analytics(request): - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/express.mdx b/sdks/quickstart/express.mdx index 7614f35c..49c8269b 100644 --- a/sdks/quickstart/express.mdx +++ b/sdks/quickstart/express.mdx @@ -149,11 +149,11 @@ const timeseries = response as ClicksTimeseries[]; - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/flask.mdx b/sdks/quickstart/flask.mdx index f52dd85f..8b2f5860 100644 --- a/sdks/quickstart/flask.mdx +++ b/sdks/quickstart/flask.mdx @@ -147,11 +147,11 @@ def analytics(request): - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/go.mdx b/sdks/quickstart/go.mdx index 5bf9fb02..86af1f8c 100644 --- a/sdks/quickstart/go.mdx +++ b/sdks/quickstart/go.mdx @@ -171,11 +171,11 @@ func main() { - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/laravel.mdx b/sdks/quickstart/laravel.mdx index d71b6eb3..c0954559 100644 --- a/sdks/quickstart/laravel.mdx +++ b/sdks/quickstart/laravel.mdx @@ -245,11 +245,11 @@ class LinkController extends Controller - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/nextjs.mdx b/sdks/quickstart/nextjs.mdx index a4f6af84..dd1aff29 100644 --- a/sdks/quickstart/nextjs.mdx +++ b/sdks/quickstart/nextjs.mdx @@ -148,11 +148,11 @@ const timeseries = response as ClicksTimeseries[]; - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/nuxt.mdx b/sdks/quickstart/nuxt.mdx index 571372a6..fc380a2d 100644 --- a/sdks/quickstart/nuxt.mdx +++ b/sdks/quickstart/nuxt.mdx @@ -148,11 +148,11 @@ const timeseries = response as ClicksTimeseries[]; - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/php.mdx b/sdks/quickstart/php.mdx index e62397ad..b058874f 100644 --- a/sdks/quickstart/php.mdx +++ b/sdks/quickstart/php.mdx @@ -170,11 +170,11 @@ try { - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/python.mdx b/sdks/quickstart/python.mdx index bea0199d..20678659 100644 --- a/sdks/quickstart/python.mdx +++ b/sdks/quickstart/python.mdx @@ -140,11 +140,11 @@ print(res) - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/rails.mdx b/sdks/quickstart/rails.mdx index ae5765eb..4a08347b 100644 --- a/sdks/quickstart/rails.mdx +++ b/sdks/quickstart/rails.mdx @@ -154,11 +154,11 @@ end - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/remix.mdx b/sdks/quickstart/remix.mdx index fcb8886b..c689dcd5 100644 --- a/sdks/quickstart/remix.mdx +++ b/sdks/quickstart/remix.mdx @@ -151,11 +151,11 @@ const timeseries = response as ClicksTimeseries[]; - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/ruby.mdx b/sdks/quickstart/ruby.mdx index 8f5afc26..4dda95a0 100644 --- a/sdks/quickstart/ruby.mdx +++ b/sdks/quickstart/ruby.mdx @@ -138,11 +138,11 @@ puts res.raw_response.body - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/sinatra.mdx b/sdks/quickstart/sinatra.mdx index dcfaaf12..f68a15d4 100644 --- a/sdks/quickstart/sinatra.mdx +++ b/sdks/quickstart/sinatra.mdx @@ -154,11 +154,11 @@ end - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/quickstart/typescript.mdx b/sdks/quickstart/typescript.mdx index f5dceb12..a3068875 100644 --- a/sdks/quickstart/typescript.mdx +++ b/sdks/quickstart/typescript.mdx @@ -111,11 +111,11 @@ const timeseries = response as ClicksTimeseries[]; - See the full example on GitHub. + See the full example on GitHub diff --git a/sdks/ruby.mdx b/sdks/ruby.mdx index 5300ad0d..a69beb5b 100644 --- a/sdks/ruby.mdx +++ b/sdks/ruby.mdx @@ -61,11 +61,11 @@ If you're using a different Ruby framework, you can refer to the [Ruby SDK quick ## Additional Resources - + Download and install the Dub Ruby SDK on RubyGems diff --git a/sdks/typescript.mdx b/sdks/typescript.mdx index af236a23..525724d3 100644 --- a/sdks/typescript.mdx +++ b/sdks/typescript.mdx @@ -68,11 +68,11 @@ If you're using a different JavaScript framework, you can refer to the [TypeScri ## Additional Resources - + Download and install the Dub TypeScript SDK on NPM diff --git a/snippets/dub-conversion-tracking-demo-apps.mdx b/snippets/dub-conversion-tracking-demo-apps.mdx index 8cc7d82a..71a9ae69 100644 --- a/snippets/dub-conversion-tracking-demo-apps.mdx +++ b/snippets/dub-conversion-tracking-demo-apps.mdx @@ -5,7 +5,7 @@ href="https://github.com/dubinc/examples/tree/main/conversions/stripe" color="#333333" > - Example app that shows how to track conversion events with Dub. + Example app that shows how to track conversion events with Dub - Example app that shows how to track conversion events with Segment and Dub. + Example app that shows how to track conversion events with Segment and Dub - Example app that shows how to track Clerk signup events with Dub. + Example app that shows how to track Clerk signup events with Dub - Example app that shows how to track Cal.com booking events with Dub. + Example app that shows how to track Cal.com booking events with Dub diff --git a/snippets/enable-conversion-tracking.mdx b/snippets/enable-conversion-tracking.mdx index 33049490..1902eb4c 100644 --- a/snippets/enable-conversion-tracking.mdx +++ b/snippets/enable-conversion-tracking.mdx @@ -7,10 +7,18 @@ First, you'll need to enable conversion tracking for your Dub links to be able t - To enable conversion tracking for all future links in a workspace, you can do the following: -To enable conversion tracking for all future links in a workspace, you can do the following: - -1. Navigate to your [workspace's Analytics settings page](https://app.dub.co/settings/analytics). + To enable conversion tracking for all future links in a workspace: + + + Configure conversion tracking in the dashboard + + +1. Navigate to your workspace's Analytics settings page. 2. Toggle the **Workspace-level Conversion Tracking** switch to enable conversion tracking for the workspace. diff --git a/snippets/install-server-sdks-track-conversions.mdx b/snippets/install-server-sdks-track-conversions.mdx index 9ee7b9b6..0437a8fd 100644 --- a/snippets/install-server-sdks-track-conversions.mdx +++ b/snippets/install-server-sdks-track-conversions.mdx @@ -1,9 +1,10 @@ import AuthProviders from "/snippets/auth-providers.mdx"; - If you are using Shopify, you can skip this step since our Shopify app will - automatically track conversions for you. Read the [Shopify integration - guide](https://dub.co/docs/conversions/sales/shopify) for more information. + If you are using Stripe or Shopify, you can skip this step since our native + integrations will automatically track conversions for you. Read the + [Stripe](/conversions/sales/stripe) or [Shopify](/conversions/sales/shopify) + integration guide for more information. The recommended way to track conversions on Dub is using [server-side tracking](/conversions/leads/introduction), which is more reliable than [client-side tracking](/conversions/leads/client-side). @@ -51,6 +52,20 @@ The first event you'll want to track is a `lead` event. This happens when a user /> +Depending on which platform you're using, we offer native integrations for the following: + + + + No-code tracking via GTM tags + + + Route leads through your Segment pipeline + + + Sync leads directly to HubSpot contacts + + + Our most common lead event is `Sign Up`, which happens when a user signs up for an account. Depending on which authentication framework you're using, here are a few examples of how to send `Sign Up` lead events: diff --git a/snippets/open-analytics-settings.mdx b/snippets/open-analytics-settings.mdx new file mode 100644 index 00000000..5c034787 --- /dev/null +++ b/snippets/open-analytics-settings.mdx @@ -0,0 +1,7 @@ + + Generate your publishable key, allowlist domains, and configure conversion tracking in your Dub dashboard + diff --git a/snippets/open-program-dashboard.mdx b/snippets/open-program-dashboard.mdx new file mode 100644 index 00000000..60076ae8 --- /dev/null +++ b/snippets/open-program-dashboard.mdx @@ -0,0 +1,7 @@ + + Launch the program onboarding wizard to set up your affiliate or referral program + diff --git a/snippets/referrals-embed-guide.mdx b/snippets/referrals-embed-guide.mdx index 3fafbff2..a34870eb 100644 --- a/snippets/referrals-embed-guide.mdx +++ b/snippets/referrals-embed-guide.mdx @@ -38,7 +38,7 @@ You can also view the source code for the example app on [GitHub](https://github href="https://github.com/dubinc/examples/tree/main/embed/referrals" color="#333333" > - View the source code for [acme.dub.sh](https://acme.dub.sh) on GitHub. + View the source code for [acme.dub.sh](https://acme.dub.sh) on GitHub ## Step 1: Generate embed token diff --git a/snippets/steps/allowlist-domains.mdx b/snippets/steps/allowlist-domains.mdx index f6d7c5dc..802fd624 100644 --- a/snippets/steps/allowlist-domains.mdx +++ b/snippets/steps/allowlist-domains.mdx @@ -2,7 +2,16 @@ Then, you'll need to allowlist your site's domain to allow the client-side conversion events to be ingested by Dub. -To do that, navigate to your [workspace's Analytics settings page](https://app.dub.co/settings/analytics) and add your site's domain to the **Allowed Hostnames** list. +Navigate to your workspace's Analytics settings page and add your site's domain to the **Allowed Hostnames** list. + + + Configure allowed hostnames in the dashboard + This provides an additional layer of security by ensuring only authorized domains can track conversions using your publishable key. diff --git a/snippets/steps/generate-publishable-key.mdx b/snippets/steps/generate-publishable-key.mdx index 871de215..5111d263 100644 --- a/snippets/steps/generate-publishable-key.mdx +++ b/snippets/steps/generate-publishable-key.mdx @@ -2,7 +2,16 @@ Before you can track conversions on the client-side, you need to generate a [publishable key](/api-reference/publishable-keys) from your Dub workspace. -To do that, navigate to your [workspace's Analytics settings page](https://app.dub.co/settings/analytics) and generate a new publishable key under the **Publishable Key** section. +Navigate to your workspace's Analytics settings page and generate a new publishable key under the **Publishable Key** section. + + + Generate your publishable key in the dashboard +