Linkkit is a powerful link management and attribution platform designed to help businesses track campaigns, manage partnerships, and simplify link sharing.Whether you are:<ul><li>A startup founder launching an affiliate or referral program</li><li>A marketing team tracking campaign performance and conversions</li><li>A developer integrating advanced link analytics into applications</li></ul>Linkkit gives you the tools to manage everything in one place.<h2>Core Features</h2>Linkkit provides a complete toolkit for campaign tracking, attribution, and smart link management.Some of the major features include:<h3>Partner &amp; Referral Programs</h3>Create and manage affiliate programs, influencer campaigns, and customer referral systems with ease.<h3>Marketing Attribution</h3>Track where your leads, clicks, and conversions are coming from across different channels.<h3>Real-Time Analytics</h3>Monitor clicks, user activity, and campaign performance instantly with live reporting.<h3>Smart Short Links</h3>Generate branded short links individually or in bulk for ads, social media, SMS, and email campaigns.<h3>Webhooks &amp; Automation</h3>Send event-based data to your applications and automate workflows using webhooks.<h3>Integrations &amp; APIs</h3>Connect Linkkit with your existing tools or build custom workflows using APIs and SDKs.<h2>What Can You Do With Linkkit?</h2><h3>Launch a Partner Program</h3>Scale your business with affiliates, influencers, ambassadors, and referral partnerships.<h3>Track Conversion Events</h3>Measure signups, purchases, leads, and custom events from your marketing campaigns.<h3>Create Branded Short Links</h3>Generate clean, professional short links for promotions, campaigns, and customer engagement.<h3>Automate Workflows</h3>Use webhooks and integrations to connect Linkkit with your CRM, analytics, and automation tools. <h2>Popular Integrations</h2>Linkkit integrates seamlessly with modern tools and platforms to simplify your workflow.<h3>Stripe</h3>Track subscriptions, recurring payments, refunds, cancellations, and revenue attribution.<h3>Shopify</h3>Connect your online store and measure campaign-driven sales performance.<h3>Google Tag Manager</h3>Send conversion and marketing event data directly through GTM.<h3>Zapier</h3>Automate workflows by connecting Linkkit with thousands of third-party apps.<h3>HubSpot</h3>Sync leads, referral activity, and campaign data with your CRM.<h3>Segment</h3>Track and route customer events across your analytics stack.View all integrations →<h2>SDKs &amp; Developer Tools</h2>Linkkit provides developer-friendly SDKs to help you integrate faster.<h3>Server-Side SDKs</h3><ul><li>TypeScript SDK</li><li>Python SDK</li><li>Go SDK</li><li>PHP SDK</li><li>Ruby SDK</li></ul><h3>Client-Side SDKs</h3>Use lightweight client-side libraries to track events and interactions directly from your frontend applications. <h2>Stay Updated</h2><h3>Blog</h3>Explore the latest product updates, tutorials, and feature announcements.<h3>X / Twitter</h3>Follow Linkkit for release updates, feature launches, and product news.<h2></h2>

Introduction

Learn how Linkkit tracks the complete customer journey — from the first click to the final conversion. Linkkit’s attribution system is designed to help businesses understand exactly how marketing campaigns, referral programs, and partner links generate real business outcomes. Whether you're tracking affiliate traffic, paid ads, influencer campaigns, or referral links, Linkkit provides accurate conversion attribution with real-time analytics. &lt;!-- Image 1 goes here --&gt;<h2>The Attribution Flow</h2>Linkkit uses a multi-stage attribution process to connect clicks with leads and sales.The attribution journey typically follows these stages:<ol><li>Click Tracking</li><li>Lead Tracking</li><li>Conversion or Sale Tracking</li></ol>This system helps businesses identify which campaigns, partners, or traffic sources contribute to conversions and revenue.<h3>Stage 1 — Click Tracking</h3>When a visitor clicks a Linkkit referral or marketing link, the click is captured before the user is redirected to the destination page.This tracking happens automatically and works reliably across devices and browsers.<h3>Data Captured During Click Tracking</h3>Linkkit records important attribution data such as:<ul><li>Unique click ID</li><li>Timestamp</li><li>Country and geographic location</li><li>Device type</li><li>Browser and operating system</li><li>Referral source</li><li>UTM parameters</li><li>Campaign information</li><li>QR code tracking data</li></ul>&lt;!-- Image 2 goes here --&gt;The tracking ID is appended to the destination URL automatically:<pre><code>https://yourwebsite.com?lk_id=abc123xyz</code></pre>Linkkit then stores this tracking identifier using first-party cookies.<pre><code>Cookie: lk_id=abc123xyz</code></pre><h3>Why First-Party Cookies Matter</h3>Using first-party cookies provides several advantages:<ul><li>Better browser compatibility </li><li>Improved tracking reliability </li><li>Reduced ad blocker interference </li><li>More accurate attribution </li><li>Persistent session tracking </li></ul>By default, Linkkit keeps attribution cookies active for up to 90 days, allowing conversions to be connected back to the original click.<h3>Stage 2 — Lead Tracking</h3>Lead tracking connects users with the original marketing click when they perform an important action.Examples of lead events include:<ul><li>User registrations </li><li>Newsletter signups </li><li>Demo bookings </li><li>Contact form submissions </li><li>Trial activations &lt;!-- Image 3 goes here --&gt; </li></ul>Example lead tracking request:<pre><code>await linkkit.track.lead({
 clickId: cookies.get("lk_id"),
 eventName: "User Signup",
 customerId: user.id,
 customerEmail: user.email,
 customerName: user.name,
});</code></pre>Linkkit automatically prevents duplicate lead tracking by validating customer identifiers and event names.This ensures cleaner attribution reporting and more accurate analytics.<h3>Stage 3 — Sale &amp; Conversion Tracking</h3>Once a user completes a purchase or conversion event, Linkkit connects the conversion back to the original click and lead.Supported conversion events include:<ul><li>Purchases </li><li>Subscription upgrades </li><li>Paid invoices </li><li>Course enrollments </li><li>App purchases </li><li>SaaS subscriptions &lt;!-- Image 4 goes here --&gt; </li></ul>Example conversion tracking:<pre><code>await linkkit.track.sale({
 customerId: user.id,
 amount: 9900,
 currency: "USD",
 invoiceId: "INV-001",
});</code></pre>Once the conversion is processed, Linkkit automatically attributes the sale to the correct campaign, referral source, or affiliate partner.This makes it easy to calculate ROI and partner commissions automatically.<h2>Attribution Models</h2>Linkkit supports multiple attribution models, depending on how you want conversions credited.<h3>Last-Click Attribution (Default)</h3>With last-click attribution, the most recent marketing source receives full conversion credit.This is the most commonly used attribution model for affiliate and referral systems.<h3>Best For</h3><ul><li>Affiliate marketing </li><li>Influencer campaigns </li><li>Performance marketing </li><li>Paid advertising </li></ul><h3>First-Click Attribution</h3>First-click attribution gives full credit to the first source that introduced the customer.<h3>Best For</h3><ul><li>Brand awareness campaigns </li><li>Content marketing </li><li>Long customer journeys </li><li>Multi-touch funnels &lt;!-- Image 5 goes here --&gt; </li></ul><h3>Attribution Model Comparison</h3><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Model</th><th colspan="1" rowspan="1">Behavior</th></tr><tr><td colspan="1" rowspan="1">Last-Click</td><td colspan="1" rowspan="1">The most recent click receives credit</td></tr><tr><td colspan="1" rowspan="1">First-Click</td><td colspan="1" rowspan="1">Original referral source keeps credit</td></tr></tbody></table><h2>Attribution Window</h2>The attribution window defines how long a conversion can still be connected to an original click.Linkkit allows you to customise attribution windows based on your campaign requirements.<h3>Default Attribution Window</h3><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Setting</th><th colspan="1" rowspan="1">Default Value</th></tr><tr><td colspan="1" rowspan="1">Cookie Expiration</td><td colspan="1" rowspan="1">90 Days</td></tr></tbody></table>Example custom configuration:<code>&lt;script</code><code>src="https://cdn.linkkit.com/analytics.js"</code><code>data-cookie-options='{"expiresInDays":30}'</code><code>&gt;&lt;/script&gt;</code> Shorter attribution windows are useful for flash campaigns, while longer windows work better for SaaS and high-ticket sales cycles<h2>Cross-Domain Attribution</h2>Many businesses use multiple domains during the customer journey.For example:<ul><li><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://website.com">website.com</a> → <a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://app.website.com">app.website.com</a> </li><li><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://app.website.com">app.website.com</a> → <a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://checkout.website.com">checkout.website.com</a> </li><li><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://marketing.site">marketing.site</a> → <a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://store.site">store.site</a> </li></ul>Linkkit supports cross-domain attribution to ensure tracking continuity across multiple domains and subdomains. &lt;!-- Image 6 goes here --&gt; This helps preserve attribution data throughout the entire customer journey.<h2>Partner Commission Tracking</h2>When a conversion occurs, Linkkit can automatically calculate commissions for affiliates, referral partners, or influencers.The commission flow typically works like this:<ol><li>User clicks referral link </li><li>The lead event is recorded </li><li>Conversion occurs </li><li>Attribution is verified </li><li>Commission is generated automatically </li></ol>This enables businesses to manage scalable affiliate and referral programs with minimal manual work. &lt;!-- Image 7 goes here --&gt; <h2>Direct Sale Attribution</h2>For businesses without a signup process, Linkkit also supports direct conversion tracking.Example:<pre><code>await linkkit.track.sale({
 clickId: cookies.get("lk_id"),
 customerEmail: order.email,
 customerName: order.name,
 amount: 4900,
 invoiceId: order.id,
});</code></pre>This is useful for:<ul><li>eCommerce stores </li><li>One-time purchases </li><li>Digital product sales </li><li>Quick checkout flows </li></ul><h2>Deferred Lead Tracking</h2>Some businesses require delayed qualification periods before rewarding partners.Examples include:<ul><li>Free trial approvals </li><li>Loan approvals </li><li>Account verification </li><li>Subscription activation </li></ul>Linkkit supports deferred lead attribution workflows for these cases.<pre><code>await linkkit.track.lead({
 clickId: cookies.get("lk_id"),
 eventName: "Trial Signup",
 customerId: user.id,
 mode: "deferred",
});</code></pre>Once the lead becomes qualified, a second event can finalise attribution and commission tracking. &lt;!-- Image 8 goes here --&gt;<h2>Troubleshooting Attribution</h2><h3>Common Attribution Issues</h3><table class="border-collapse table-auto w-full" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Issue</th><th colspan="1" rowspan="1">Possible Cause</th><th colspan="1" rowspan="1">Solution</th></tr><tr><td colspan="1" rowspan="1">Missing conversions</td><td colspan="1" rowspan="1">Tracking cookie missing</td><td colspan="1" rowspan="1">Verify analytics script installation</td></tr><tr><td colspan="1" rowspan="1">Incorrect attribution</td><td colspan="1" rowspan="1">Multiple clicks overwrite attribution</td><td colspan="1" rowspan="1">Switch to the first-click model</td></tr><tr><td colspan="1" rowspan="1">Duplicate leads</td><td colspan="1" rowspan="1">Same user tracked multiple times</td><td colspan="1" rowspan="1">Use consistent customer IDs</td></tr><tr><td colspan="1" rowspan="1">Missing commissions</td><td colspan="1" rowspan="1">Sale tracked before the lead</td><td colspan="1" rowspan="1">Track lead events before sales</td></tr></tbody></table><hr><h2>Verifying Attribution</h2>To ensure attribution is working correctly:<ol><li>Check browser cookies for the <code>lk_id</code> value </li><li>Test referral links manually </li><li>Trigger sample lead events </li><li>Confirm conversion events appear in analytics </li><li>Verify partner attribution reports </li></ol> &lt;!-- Image 9 goes here --&gt; <h2>Real-Time Analytics Dashboard</h2>All attribution events appear inside the Linkkit analytics dashboard in real time.You can monitor:<ul><li>Click events </li><li>Lead events </li><li>Sales and revenue </li><li>Conversion funnels </li><li>Campaign performance </li><li>Referral partner activity </li></ul>Analytics dashboards help marketing teams understand exactly which campaigns generate the highest ROI. &lt;!-- Image 10 goes here --&gt;

How Attribution Works

Getting Started

Learn how to track conversions, leads, and sales using Linkkit’s secure server-side tracking system.Server-side tracking is the recommended method for accurate attribution because events are processed directly from your backend instead of relying entirely on browser-based tracking.With Linkkit, you can connect clicks to real users, subscriptions, purchases, and revenue with reliable attribution data.&lt;!-- Image 1 goes here --&gt;<h2>Why Use Server-Side Tracking?</h2>Traditional browser tracking can be blocked by:<ul><li>Ad blockers</li><li>Browser privacy restrictions</li><li>Disabled JavaScript</li><li>Cookie limitations</li></ul>Server-side tracking improves reliability by sending events directly from your backend infrastructure.<h3>Benefits of Server-Side Tracking</h3><ul><li>More accurate conversion attribution</li><li>Better data consistency</li><li>Improved security</li><li>Reduced tracking loss</li><li>Reliable partner commission tracking</li><li>Better performance for large-scale applications</li></ul><h2>Step 1 — Enable Conversion Tracking</h2>Before tracking conversions, you need to enable conversion tracking for your links.Linkkit allows you to enable tracking in multiple ways:<h3>Workspace-Level Tracking</h3>Enable conversion tracking for all future links inside your workspace.<h3>Steps</h3><ol><li>Open your workspace settings</li><li>Navigate to Tracking Settings</li><li>Enable Workspace Conversion Tracking</li></ol>&lt;!-- Image 2 goes here --&gt;This automatically enables attribution tracking for all newly created links.<h2>Link-Level Tracking</h2>If you only want tracking enabled for specific campaigns or referral links, you can enable tracking individually.<h3>Steps</h3><ol><li>Open the Link Builder</li><li>Select your target link</li><li>Enable the Conversion Tracking option</li></ol>&lt;!-- Image 3 goes here --&gt;<h2>Enable Tracking via API</h2>You can also enable tracking programmatically while creating links.<h3>Example</h3><pre><code>const link = await linkkit.links.create({
 url: "https://yourwebsite.com",
 trackConversion: true,
});</code></pre>This is useful for automation workflows and custom integrations.<h2>Step 2 — Install the Analytics Script</h2>The linkkit analytics script captures the tracking identifier from incoming clicks and stores it securely using first-party cookies.This allows future events to be connected back to the original referral source. &lt;!-- Image 4 goes here --&gt; <h3>Example Tracking Parameter</h3><pre><code>https://yourwebsite.com?lk_id=abc123xyz</code></pre><h3>Stored Cookie</h3><pre><code>Cookie: lk_id=abc123xyz</code></pre><h2>Installing the Analytics Script</h2>Linkkit supports multiple installation methods.<h3>Supported Platforms</h3><ul><li>React </li><li>Next.js </li><li>Shopify </li><li>WordPress </li><li>Webflow </li><li>Google Tag Manager </li><li>Manual HTML installation</li></ul><h3>Manual Installation Example</h3><code>&lt;script src="https://cdn.linkkit.com/analytics.js" defer &gt;&lt;/script&gt;</code>Add the script inside the <code>&lt;head&gt;</code> section of your website.<h2>Verify Installation</h2>After installation, verify that tracking works correctly.<h3>Test 1 — Analytics Object</h3>Open your browser console and run:<pre><code>_linkkitAnalytics</code></pre>If installed correctly, the analytics object will appear.<h3>Test 2 — Cookie Validation</h3>Add a test parameter to your URL:<pre><code>https://yourwebsite.com?lk_id=test123</code></pre>Then confirm the <code>lk_id</code> A cookie is stored in your browser. &lt;!-- Image 5 goes here --&gt; <h3>Common Issues</h3><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Problem</th><th colspan="1" rowspan="1">Solution</th></tr><tr><td colspan="1" rowspan="1">Script not loading</td><td colspan="1" rowspan="1">Verify the script is inside <code>&lt;head&gt;</code></td></tr><tr><td colspan="1" rowspan="1">Cookie missing</td><td colspan="1" rowspan="1">Check browser cookie permissions</td></tr><tr><td colspan="1" rowspan="1">Tracking delayed</td><td colspan="1" rowspan="1">Clear CDN cache if applicable</td></tr><tr><td colspan="1" rowspan="1">Analytics object unavailable</td><td colspan="1" rowspan="1">Confirm script loaded successfully</td></tr></tbody></table><h2>Step 3 — Install the Server SDK</h2>Linkkit provides official SDKs for server-side event tracking.<h3>Available SDKs</h3><ul><li>TypeScript SDK </li><li>Python SDK </li><li>PHP SDK </li><li>Go SDK </li><li>Ruby SDK &lt;!-- Image 6 goes here --&gt; </li></ul>These SDKs simplify conversion tracking and attribution workflows.<h3>TypeScript SDK Example</h3><pre><code>npm install linkkit</code></pre><h3>Initialise the SDK</h3><pre><code>import { linkkit } from "linkkit";

const client = new linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});</code></pre><h2>Using the REST API</h2>If your framework is not officially supported, you can use the REST API directly.<h3>Available Endpoints</h3><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Endpoint</th><th colspan="1" rowspan="1">Purpose</th></tr><tr><td colspan="1" rowspan="1">POST /track/lead</td><td colspan="1" rowspan="1">Track lead events</td></tr><tr><td colspan="1" rowspan="1">POST /track/sale</td><td colspan="1" rowspan="1">Track conversion or revenue events</td></tr></tbody></table><h2>Step 4 — Track Lead Events</h2>Lead events occur when a visitor performs an action showing interest in your product or service.Examples include:<ul><li>User registrations </li><li>Demo bookings </li><li>Newsletter subscriptions </li><li>Trial signups </li><li>Add-to-cart actions &lt;!-- Image 7 goes here --&gt; </li></ul><h2>Example Lead Tracking</h2><pre><code>const lkId = req.cookies["lk_id"];

if (lkId) {
 await client.track.lead({
 clickId: lkId,
 eventName: "Sign Up",
 customerId: customer.id,
 customerName: customer.name,
 customerEmail: customer.email,
 });
}</code></pre>The lead event becomes the foundation for future attribution.Once recorded, future purchases and upgrades can automatically inherit attribution from the original click.<h2>Lead Event Properties</h2><table class="border-collapse table-auto w-full" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Property</th><th colspan="1" rowspan="1">Required</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">clickId</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Original tracking ID from the link click</td></tr><tr><td colspan="1" rowspan="1">eventName</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Name of the lead event</td></tr><tr><td colspan="1" rowspan="1">customerId</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Unique customer identifier</td></tr><tr><td colspan="1" rowspan="1">customerName</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer's full name</td></tr><tr><td colspan="1" rowspan="1">customerEmail</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer email address</td></tr><tr><td colspan="1" rowspan="1">metadata</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Additional custom data</td></tr></tbody></table><h2>Duplicate Event Protection</h2>Linkkit automatically prevents duplicate lead events.Events are validated using:<ul><li>Customer ID </li><li>Event name </li><li>Attribution source </li></ul>This helps maintain clean analytics and accurate reporting.<h2>Step 5 — Track Sale Events</h2>Sales events happen when users complete revenue-generating actions.Examples:<ul><li>Subscription purchases </li><li>Product orders </li><li>Plan upgrades </li><li>Course purchases </li><li>One-time payments &lt;!-- Image 8 goes here --&gt; </li></ul><h3>Example Sale Tracking</h3><pre><code>await client.track.sale({
 customerId: customer.id,
 amount: 9900,
 currency: "USD",
 invoiceId: "INV-001",
});</code></pre>Once recorded, Linkkit automatically attributes the sale to the original click source.

Server-Side Tracking

Learn how to use Linkkit’s client-side analytics script to track clicks, leads, and conversion events directly from your website or web application. The Linkkit analytics script automatically detects tracking parameters from incoming links and stores them securely using first-party cookies. This makes it possible to attribute future conversions back to the original referral source. &lt;!-- Image 1 goes here --&gt; Linkkit client-side tracking is ideal for:<ul><li>Marketing websites</li><li>SaaS onboarding flows</li><li>Referral campaigns</li><li>Affiliate programs</li><li>Creator partnerships</li><li>eCommerce stores</li></ul><h2>How Client-Side Tracking Works</h2>The tracking flow in Linkkit follows three simple stages:<ol><li>Track the original click</li><li>Store the tracking identifier</li><li>Attribute future conversions</li></ol>When a user clicks a tracked link, Linkkit captures the tracking parameter and saves it as a first-party cookie in the browser.<h3>Example Tracked URL</h3><pre><code>https://yourwebsite.com?lk_id=abc123xyz</code></pre><h3>Stored Cookie</h3><pre><code>Cookie: lk_id=abc123xyz</code></pre>This cookie allows future lead and sale events to be connected to the original referral source. &lt;!-- Image 2 goes here --&gt; <h3>Step 1 — Enable Conversion Tracking</h3>Before tracking conversions, you need to enable conversion tracking for your links.Linkkit provides multiple ways to enable tracking.<h3>Workspace-Level Tracking</h3>Enable tracking for all future links inside your workspace.<h3>Steps</h3><ol><li>Open your workspace settings </li><li>Navigate to Tracking Settings </li><li>Enable Workspace Conversion Tracking &lt;!-- Image 3 goes here --&gt; </li></ol>This automatically enables attribution tracking for newly created links.<h2>Link-Level Tracking</h2>You can also enable tracking only for selected links.<h3>Steps</h3><ol><li>Open the Link Builder </li><li>Select your target link </li><li>Enable the Conversion Tracking option &lt;!-- Image 4 goes here --&gt; </li></ol>This option is useful when you only want attribution enabled for specific campaigns or partner links.<h2>Enable Tracking via API</h2>You can enable conversion tracking programmatically while creating links.<pre><code>const link = await client.links.create({
 url: "https://yourwebsite.com",
 trackConversion: true,
});</code></pre>This approach works well for automated workflows and custom integrations.<h2>Step 2 — Allowlist Your Domain</h2>To improve security, Linkkit requires authorized domains for client-side event tracking.This ensures only approved websites can send tracking events using your publishable key.<h3>Steps</h3><ol><li>Open Tracking Settings </li><li>Navigate to Allowed Hostnames </li><li>Add your website domain &lt;!-- Image 5 goes here --&gt; </li></ol><h3>Examples</h3><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Hostname</th><th colspan="1" rowspan="1">Behavior</th></tr><tr><td colspan="1" rowspan="1"><code>example.com</code></td><td colspan="1" rowspan="1">Tracks only <code>example.com</code></td></tr><tr><td colspan="1" rowspan="1"><code>*.example.com</code></td><td colspan="1" rowspan="1">Tracks all subdomains</td></tr></tbody></table><h3>Local Development</h3>For local testing, you can temporarily allow:<pre><code>localhost</code></pre>Remove localhost from the allowlist before going live.<h2>Step 3 — Generate Your Publishable Key</h2>Before installing the analytics script, generate a publishable tracking key from your workspace.<h3>Steps</h3><ol><li>Open Tracking Settings </li><li>Navigate to Publishable Keys </li><li>Generate a new key &lt;!-- Image 6 goes here --&gt; </li></ol>Your publishable key will be used by the client-side analytics script.<h3>Example</h3><pre><code>pk_live_xxxxxxxxx</code></pre><h2>Step 4 — Install the Analytics Script</h2>Install the Linkkit analytics script on your website.The script automatically:<ul><li>Detects tracking parameters </li><li>Stores first-party cookies </li><li>Tracks click attribution </li><li>Sends conversion events </li><li>Connects leads and sales &lt;!-- Image 7 goes here --&gt; </li></ul><h2>Manual Installation</h2><code>&lt;script src="https://cdn.linkkit.com/analytics.js" defer &gt;&lt;/script&gt;</code>Add the script inside your website’s <code>&lt;head&gt;</code> section.<h2>Supported Platforms</h2>Linkkit supports installation across multiple platforms:<ul><li>React </li><li>Next.js </li><li>Shopify </li><li>WordPress </li><li>Webflow </li><li>Framer </li><li>Google Tag Manager </li><li>Static HTML websites </li></ul><h2>React Installation Example</h2><pre><code>npm install linkkit-analytics</code></pre><pre><code>import { Analytics } from "linkkit-analytics/react";

export default function App() {
 return &lt;Analytics /&gt;;
}</code></pre><h2>Next.js Installation Example</h2><pre><code>import { Analytics } from "linkkit-analytics/next";

export default function RootLayout({ children }) {
 return (
 &lt;html&gt;
 &lt;body&gt;
 {children}
 &lt;Analytics /&gt;
 &lt;/body&gt;
 &lt;/html&gt;
 );
}</code></pre> &lt;!-- Image 8 goes here --&gt; <h2>Verify Installation</h2>After installing the analytics script, verify that tracking is working correctly.<h3>Test 1 — Analytics Object</h3>Open your browser console and run:<pre><code>_LinkkitAnalytics</code></pre>If installed correctly, the analytics object will appear.<h3>Test 2 — Cookie Validation</h3>Visit a test URL:<pre><code>https://yourwebsite.com?lk_id=test123</code></pre>Then confirm that the <code>lk_id</code> cookie exists in your browser.<h3>Test 3 — Network Request Validation</h3>Open your browser’s Network tab and verify that the following request succeeds:<pre><code>/track/click</code></pre> &lt;!-- Image 9 goes here --&gt; <h3>Common Installation Issues</h3><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Problem</th><th colspan="1" rowspan="1">Solution</th></tr><tr><td colspan="1" rowspan="1">Script not loading</td><td colspan="1" rowspan="1">Ensure the script is placed inside <code>&lt;head&gt;</code></td></tr><tr><td colspan="1" rowspan="1">Cookie not appearing</td><td colspan="1" rowspan="1">Verify browser cookie permissions</td></tr><tr><td colspan="1" rowspan="1">Missing tracking events</td><td colspan="1" rowspan="1">Confirm allowed hostname configuration</td></tr><tr><td colspan="1" rowspan="1">Analytics object missing</td><td colspan="1" rowspan="1">Ensure script loads successfully</td></tr><tr><td colspan="1" rowspan="1">CDN caching issues</td><td colspan="1" rowspan="1">Purge cached files and retry</td></tr></tbody></table><h2>Tracking Lead Events</h2>Lead events occur when users perform actions showing interest in your product or service.Examples include:<ul><li>Account registrations </li><li>Demo bookings </li><li>Newsletter signups </li><li>Trial activations </li><li>Add-to-cart actions </li></ul> &lt;!-- Image 10 goes here --&gt; <h3>Example Lead Tracking</h3><pre><code>window.Linkkit.track("lead", {
 eventName: "Sign Up",
 customerId: user.id,
 customerEmail: user.email,
});</code></pre>Lead events help Linkkit connect customer activity with the original referral source for accurate attribution analytics.<h2>Tracking Sale Events</h2>Sales events are triggered when users complete revenue-generating actions.Examples:<ul><li>Subscription purchases </li><li>Product orders </li><li>Membership upgrades </li><li>Course enrollments </li><li>One-time payments </li></ul><h3>Example Sale Tracking</h3><pre><code>window.Linkkit.track("sale", {
 customerId: customer.id,
 amount: 9900,
 currency: "USD",
});</code></pre>Linkkit automatically attributes the sale to the original tracked click.<h2>Real-Time Analytics</h2>All tracked client-side events appear inside the Linkkit analytics dashboard in real time.You can monitor:<ul><li>Click events </li><li>Leads </li><li>Sales </li><li>Conversion funnels </li><li>Referral sources </li><li>Campaign performance </li><li>Geographic analytics &lt;!-- Image 11 goes here --&gt; </li></ul>This helps marketing and growth teams measure attribution performance with complete visibility.

Client-Side Tracking

Web Installation 

<blockquote>Connect Linkkit with your favorite platforms, automation tools, analytics systems, and business applications to streamline workflows and improve attribution tracking.</blockquote><h2>Overview</h2>Linkkit integrations help businesses automate marketing workflows, track conversions, sync customer data, and improve campaign attribution across multiple platforms. With Linkkit, you can connect your applications, payment systems, CRMs, analytics platforms, and automation tools in one centralized ecosystem.By using integrations, teams can:<ul><li>Automate repetitive tasks</li><li>Track conversions and revenue</li><li>Sync customer and campaign data</li><li>Improve attribution analytics</li><li>Connect marketing and sales workflows</li><li>Build scalable automation systems</li></ul>Whether you're running affiliate campaigns, managing SaaS subscriptions, or analyzing customer journeys, Linkkit integrations help simplify your workflow and improve operational efficiency. &lt;!-- Image 1 goes here --&gt;<h2>Official Integrations</h2>These integrations are officially supported and maintained by the Linkkit platform.<h2>Zapier</h2>Connect Linkkit with Zapier to automate workflows between thousands of applications without writing code.<h3>Popular Zapier Workflows</h3><ul><li>Send leads to Google Sheets</li><li>Trigger Slack notifications for conversions</li><li>Create CRM contacts automatically</li><li>Sync affiliate sales data</li><li>Automate customer onboarding</li></ul> &lt;!-- Image 2 goes here --&gt;<h2><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://Make.com">Make.com</a></h2>Use <a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://Make.com">Make.com</a> with Linkkit to create advanced visual automation workflows and data pipelines.<h3>Common Use Cases</h3><ul><li>Multi-step automation flows</li><li>Customer event synchronization</li><li>Revenue tracking workflows</li><li>Marketing attribution automation</li><li>CRM enrichment</li></ul> &lt;!-- Image 3 goes here --&gt;<h2>Stripe</h2>Integrate Stripe with Linkkit to track payments, subscriptions, and revenue attribution.<h3>Features</h3><ul><li>Subscription tracking</li><li>Payment attribution</li><li>Revenue analytics</li><li>Customer conversion monitoring</li><li>Recurring billing insights</li></ul> &lt;!-- Image 4 goes here --&gt;<h2>Shopify</h2>Connect Shopify with Linkkit to measure store conversions, affiliate sales, and customer acquisition performance.<h3>Shopify Tracking Features</h3><ul><li>Order attribution</li><li>Checkout conversion tracking</li><li>Affiliate campaign analytics</li><li>Customer revenue tracking</li><li>Store performance reporting</li></ul> &lt;!-- Image 5 goes here --&gt;<h2>Segment</h2>Use Segment with Linkkit to centralize event tracking and customer analytics across your applications.<h3>Supported Events</h3><ul><li>Lead generation events</li><li>Purchase tracking</li><li>User engagement analytics</li><li>Marketing attribution events</li><li>Revenue conversion tracking</li></ul> &lt;!-- Image 6 goes here --&gt;<h2>WordPress</h2>Integrate Linkkit with WordPress to enable link tracking and conversion analytics on your website.<h3>WordPress Benefits</h3><ul><li>Easy installation</li><li>Marketing attribution tracking</li><li>Campaign analytics</li><li>Deep link support</li><li>Conversion monitoring</li></ul> &lt;!-- Image 7 goes here --&gt;<h2>Raycast</h2>Use Linkkit with Raycast to manage links, campaigns, and tracking workflows directly from your desktop.<h3>Features</h3><ul><li>Fast link creation</li><li>Campaign management</li><li>Quick analytics access</li><li>Productivity workflows</li><li>Desktop-based tracking tools</li></ul> &lt;!-- Image 8 goes here --&gt;<h2>Slack</h2>Connect Slack with Linkkit to receive real-time conversion and campaign notifications.<h3>Slack Notifications</h3><ul><li>New lead alerts</li><li>Sale notifications</li><li>Campaign performance updates</li><li>Affiliate activity monitoring</li><li>Conversion event tracking</li></ul> &lt;!-- Image 9 goes here --&gt;<h2>Build Custom Integrations</h2>Linkkit provides a flexible developer platform that allows you to create custom integrations using the Linkkit API. Developers can:<ul><li>Create and manage links</li><li>Track conversion events</li><li>Build custom attribution systems</li><li>Connect internal tools</li><li>Automate campaign workflows</li><li>Sync external platforms</li></ul>The Linkkit API is designed for scalability, automation, and modern application development. &lt;!-- Image 10 goes here --&gt;<h2>API Capabilities</h2>Using the Linkkit API, you can:<table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Feature</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">Link Creation</td><td colspan="1" rowspan="1">Generate branded and trackable links</td></tr><tr><td colspan="1" rowspan="1">Conversion Tracking</td><td colspan="1" rowspan="1">Monitor leads and sales</td></tr><tr><td colspan="1" rowspan="1">Analytics Access</td><td colspan="1" rowspan="1">Retrieve attribution data</td></tr><tr><td colspan="1" rowspan="1">Event Tracking</td><td colspan="1" rowspan="1">Send custom conversion events</td></tr><tr><td colspan="1" rowspan="1">Campaign Reporting</td><td colspan="1" rowspan="1">Analyze traffic and revenue performance</td></tr><tr><td colspan="1" rowspan="1">Automation Workflows</td><td colspan="1" rowspan="1">Connect external systems</td></tr></tbody></table><h2>Integration Webhooks</h2>Linkkit also supports webhooks for real-time integration events and automation workflows.Webhooks allow your applications to receive instant updates whenever important events occur inside Linkkit. &lt;!-- Image 11 goes here --&gt;<h2>Supported Webhook Events</h2><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Webhook Event</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">link.created</td><td colspan="1" rowspan="1">Triggered when a new link is created</td></tr><tr><td colspan="1" rowspan="1">link.updated</td><td colspan="1" rowspan="1">Triggered when a link is updated</td></tr><tr><td colspan="1" rowspan="1">link.deleted</td><td colspan="1" rowspan="1">Triggered when a link is removed</td></tr><tr><td colspan="1" rowspan="1">link.clicked</td><td colspan="1" rowspan="1">Triggered when a tracking link receives a click</td></tr><tr><td colspan="1" rowspan="1">lead.created</td><td colspan="1" rowspan="1">Triggered when a new lead event is recorded</td></tr><tr><td colspan="1" rowspan="1">sale.created</td><td colspan="1" rowspan="1">Triggered when a sale conversion occurs</td></tr><tr><td colspan="1" rowspan="1">partner.enrolled</td><td colspan="1" rowspan="1">Triggered when a new affiliate or partner joins</td></tr></tbody></table><h2>Benefits of Using Linkkit Integrations</h2>Linkkit integrations help businesses:<ul><li>Improve marketing attribution</li><li>Automate customer workflows</li><li>Track revenue more accurately</li><li>Connect analytics platforms</li><li>Reduce manual processes</li><li>Scale campaign operations</li></ul><h2>Popular Use Cases</h2>Businesses commonly use Linkkit integrations for:<ul><li>Affiliate marketing automation</li><li>SaaS revenue attribution</li><li>eCommerce analytics</li><li>CRM synchronization</li><li>Lead tracking</li><li>Campaign reporting</li><li>Customer lifecycle monitoring</li></ul> &lt;!-- Image 12 goes here --&gt;<h2>Why Use Linkkit Integrations?</h2>Linkkit integrations are built to help modern businesses connect marketing, analytics, automation, and revenue tracking into one unified workflow.With Linkkit, teams can:<ul><li>Measure campaign performance</li><li>Automate repetitive tasks</li><li>Track conversions in real time</li><li>Build scalable attribution systems</li><li>Improve operational efficiency</li></ul>Designed for growth-focused teams, Linkkit integrations simplify analytics, automation, and conversion tracking across your entire business ecosystem.

Introduction 

<h1>Build Your Own Integration</h1><blockquote>Learn how to build custom integrations with Linkkit using OAuth 2.0 authentication, APIs, webhooks, and attribution tracking tools.</blockquote><h2>Overview</h2>Linkkit allows developers to build powerful custom integrations that connect attribution tracking, analytics, conversion monitoring, and automation workflows directly into their applications.Using the Linkkit API and OAuth 2.0 authentication, developers can:<ul><li>Create custom integrations</li><li>Manage tracking links programmatically</li><li>Track lead and sale conversions</li><li>Access analytics data</li><li>Sync customer information</li><li>Build automation workflows</li><li>Connect third-party platforms</li></ul>This guide explains how to authenticate users securely and integrate Linkkit into your application using OAuth 2.0.&lt;!-- Image 1 goes here --&gt;<h2>Why Use OAuth 2.0?</h2>Linkkit supports OAuth 2.0 authentication for secure third-party integrations.OAuth 2.0 is recommended because it:<ul><li>Provides secure user authentication</li><li>Eliminates the need to share passwords</li><li>Supports permission-based access</li><li>Allows token refresh workflows</li><li>Works well for SaaS platforms and public apps</li></ul>OAuth is ideal for:<ul><li>Public integrations</li><li>SaaS applications</li><li>Browser applications</li><li>Mobile apps</li><li>Desktop applications</li><li>Marketplace integrations</li></ul><h2>OAuth 2.0 Authentication Flow</h2>The Linkkit OAuth flow consists of six main steps:<ol><li>Create an OAuth application</li><li>Redirect users for authorization</li><li>Exchange authorization code for tokens</li><li>Retrieve user information</li><li>Make authenticated API requests</li><li>Refresh expired access tokens</li></ol>&lt;!-- Image 2 goes here --&gt;<h3>Step 1: Create an OAuth Application</h3>To begin:<ol><li>Open your Linkkit dashboard</li><li>Navigate to the OAuth Applications section</li><li>Click Create OAuth App</li><li>Fill in the required application details</li><li>Save the application configuration</li></ol>After creation, you will receive:<ul><li>Client ID</li><li>Client Secret</li><li>Redirect URL configuration</li></ul>These credentials are required for OAuth authentication.<h3>Step 2: Redirect Users to the Authorization URL</h3>When users connect their accounts, redirect them to the Linkkit authorisation endpoint.<h3>Authorization Endpoint</h3><pre><code>GET https://app.linkkit.com/oauth/authorize</code></pre><h3>Required Parameters</h3><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Parameter</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">client_id</td><td colspan="1" rowspan="1">Your OAuth application client ID</td></tr><tr><td colspan="1" rowspan="1">redirect_uri</td><td colspan="1" rowspan="1">Authorized redirect URL</td></tr><tr><td colspan="1" rowspan="1">response_type</td><td colspan="1" rowspan="1">Must be set to code</td></tr><tr><td colspan="1" rowspan="1">scope</td><td colspan="1" rowspan="1">Requested OAuth permissions</td></tr><tr><td colspan="1" rowspan="1">state</td><td colspan="1" rowspan="1">CSRF protection token</td></tr><tr><td colspan="1" rowspan="1">code_challenge</td><td colspan="1" rowspan="1">PKCE code challenge</td></tr><tr><td colspan="1" rowspan="1">code_challenge_method</td><td colspan="1" rowspan="1">PKCE method (S256)</td></tr></tbody></table><h3>Example Authorization URL</h3><pre><code>https://app.linkkit.com/oauth/authorize?client_id=YOUR_CLIENT_ID&amp;redirect_uri=YOUR_REDIRECT_URI&amp;response_type=code&amp;scope=links.write analytics.read&amp;state=RANDOM_STATE&amp;code_challenge=CODE_CHALLENGE&amp;code_challenge_method=S256</code></pre>PKCE authentication is strongly recommended for mobile applications and frontend integrations. &lt;!-- Image 3 goes here --&gt; <h2>Step 3: Exchange Authorization Code for Access </h2>After the user approves access, Linkkit redirects them back with an authorization code.You can exchange this code for an access token.<h3>Token Endpoint</h3><pre><code>POST https://api.linkkit.com/oauth/token</code></pre><h3>Example Request</h3><pre><code>await fetch("https://api.linkkit.com/oauth/token", {
 method: "POST",
 headers: {
 "Content-Type": "application/x-www-form-urlencoded",
 },
 body: new URLSearchParams({
 code: "YOUR_AUTHORIZATION_CODE",
 client_id: "YOUR_CLIENT_ID",
 code_verifier: "YOUR_CODE_VERIFIER",
 redirect_uri: "YOUR_REDIRECT_URI",
 grant_type: "authorization_code",
 }),
});</code></pre><h3>Required Parameters</h3><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Parameter</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">code</td><td colspan="1" rowspan="1">Authorization code received after login</td></tr><tr><td colspan="1" rowspan="1">client_id</td><td colspan="1" rowspan="1">OAuth client ID</td></tr><tr><td colspan="1" rowspan="1">code_verifier</td><td colspan="1" rowspan="1">Original PKCE verifier</td></tr><tr><td colspan="1" rowspan="1">redirect_uri</td><td colspan="1" rowspan="1">Registered redirect URL</td></tr><tr><td colspan="1" rowspan="1">grant_type</td><td colspan="1" rowspan="1">Must be <code>authorization_code</code></td></tr></tbody></table><hr><h3>Example Token Response</h3><pre><code>{
 "access_token": "linkkit_access_token_xxxxx",
 "refresh_token": "refresh_token_xxxxx",
 "token_type": "Bearer",
 "expires_in": 7200,
 "scope": "links.write analytics.read"
}</code></pre> &lt;!-- Image 4 goes here --&gt; <h3>Step 4: Retrieve User Information</h3>Once authenticated, you can retrieve user and workspace information.<h3>User Info Endpoint</h3><pre><code>GET https://api.linkkit.com/oauth/userinfo</code></pre><h3>Example Request</h3><pre><code>curl --request GET \
 --url https://api.linkkit.com/oauth/userinfo \
 --header 'Authorization: Bearer ACCESS_TOKEN'</code></pre><h3>Example Response</h3><pre><code>{
 "id": "user_123",
 "name": "John Doe",
 "image": "https://example.com/avatar.png",
 "workspace": {
 "id": "ws_123",
 "slug": "acme",
 "name": "Acme Inc"
 }
}</code></pre>This endpoint helps applications personalize the user experience and identify connected workspaces.<h3>Step 5: Make API Requests</h3>After obtaining a valid access token, you can interact with the Linkkit API.<h3>Example: Create a Tracking Link</h3><pre><code>import { Linkkit } from "getlinkkit";

const linkkit = new Linkkit({
 token: ACCESS_TOKEN,
});

const link = await linkkit.links.create({
 url: "https://example.com",
});</code></pre>You can also authenticate requests manually using the <code>Authorization</code> header.<pre><code>curl --request POST \
 --url https://api.linkkit.com/links \
 --header 'Authorization: Bearer ACCESS_TOKEN' \
 --header 'Content-Type: application/json'</code></pre> &lt;!-- Image 5 goes here --&gt;<h3>Step 6: Refresh Access Tokens</h3>Access tokens expire automatically for security reasons.To refresh tokens, send a request to the token endpoint using the refresh token.<h3>Refresh Token Endpoint</h3><pre><code>POST https://api.linkkit.com/oauth/token</code></pre><h3>Refresh Request Example</h3><pre><code>await fetch("https://api.linkkit.com/oauth/token", {
 method: "POST",
 headers: {
 "Content-Type": "application/x-www-form-urlencoded",
 },
 body: new URLSearchParams({
 client_id: "YOUR_CLIENT_ID",
 client_secret: "YOUR_CLIENT_SECRET",
 grant_type: "refresh_token",
 refresh_token: "YOUR_REFRESH_TOKEN",
 }),
});</code></pre><h3>Refresh Response</h3><pre><code>{
 "access_token": "new_access_token",
 "refresh_token": "new_refresh_token",
 "token_type": "Bearer",
 "expires_in": 7200
}</code></pre>Refreshing tokens automatically improves security and user experience. &lt;!-- Image 6 goes here --&gt; <h2>Supported OAuth Scopes</h2>Linkkit supports multiple OAuth permission scopes.<table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Scope</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1"><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://links.read">links.read</a></td><td colspan="1" rowspan="1">Read tracking links</td></tr><tr><td colspan="1" rowspan="1">links.write</td><td colspan="1" rowspan="1">Create and update link</td></tr><tr><td colspan="1" rowspan="1"><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://analytics.read">analytics.read</a></td><td colspan="1" rowspan="1">Access analytics data</td></tr><tr><td colspan="1" rowspan="1"><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://tags.read">tags.read</a></td><td colspan="1" rowspan="1">Read the tag information</td></tr><tr><td colspan="1" rowspan="1">tags.write</td><td colspan="1" rowspan="1">Manage tags</td></tr><tr><td colspan="1" rowspan="1"><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://domains.read">domains.read</a></td><td colspan="1" rowspan="1">Read domains</td></tr><tr><td colspan="1" rowspan="1">domains.write</td><td colspan="1" rowspan="1">Manage domain</td></tr><tr><td colspan="1" rowspan="1"><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://folders.read">folders.read</a></td><td colspan="1" rowspan="1">Access folders</td></tr><tr><td colspan="1" rowspan="1">folders.write</td><td colspan="1" rowspan="1">Manage folders</td></tr><tr><td colspan="1" rowspan="1"><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://user.read">user.read</a></td><td colspan="1" rowspan="1">Read user information</td></tr></tbody></table><h2>Webhook Support</h2>Linkkit also supports webhook-based integrations.Webhooks allow your application to receive real-time events whenever important actions occur.<h3>Supported Webhook Events</h3><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Event</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">link.created</td><td colspan="1" rowspan="1">Triggered when a link is created</td></tr><tr><td colspan="1" rowspan="1">link.updated</td><td colspan="1" rowspan="1">Triggered when a link changes</td></tr><tr><td colspan="1" rowspan="1">link.deleted</td><td colspan="1" rowspan="1">Triggered when a link is removed</td></tr><tr><td colspan="1" rowspan="1">link.clicked</td><td colspan="1" rowspan="1">Triggered when a link receives a click</td></tr><tr><td colspan="1" rowspan="1">lead.created</td><td colspan="1" rowspan="1">Triggered when a lead conversion occurs</td></tr><tr><td colspan="1" rowspan="1">sale.created</td><td colspan="1" rowspan="1">Triggered when a sale event occurs</td></tr><tr><td colspan="1" rowspan="1">partner.enrolled</td><td colspan="1" rowspan="1">Triggered when a partner joins</td></tr></tbody></table> &lt;!-- Image 7 goes here --&gt; <h2>API Key Authentication (Optional)</h2>Linkkit also supports API key authentication.However, API keys are recommended only for:<ul><li>Internal tools </li><li>Private automations </li><li>Personal applications </li><li>Server-side workflows </li></ul>OAuth 2.0 remains the recommended approach for public integrations and user-facing applications.<h2>Best Practices</h2>For secure and scalable integrations:<ul><li>Always use PKCE authentication </li><li>Store refresh tokens securely </li><li>Use minimal permission scopes </li><li>Refresh expired tokens automatically </li><li>Validate webhook signatures </li><li>Never expose client secrets publicly </li></ul><h2>Common Use Cases</h2>Developers commonly use Linkkit integrations for:<ul><li>SaaS attribution tracking </li><li>Affiliate platform integrations </li><li>CRM synchronization </li><li>Marketing automation </li><li>Custom analytics dashboards </li><li>Revenue attribution systems </li><li>Workflow automation </li></ul>

Build Your Own Integration

Integrations 

Understand how users interact with your links across devices, browsers, and operating systems using the Linkkit Analytics API.Device analytics help you identify where your traffic comes from and how visitors access your links. This data is useful for optimizing user experience, improving campaign targeting, and understanding audience behavior across platforms.<h2>Availability</h2>Device analytics endpoints require a Pro plan or higher.<h2>Overview</h2>Linkkit provides detailed device-level analytics for your short links, including:<ul><li>Device types</li><li>Browser usage</li><li>Operating systems</li><li>Traffic distribution across platforms</li></ul>These insights can be used to power analytics dashboards, marketing reports, and audience intelligence tools.<h2>Device Analytics</h2>Retrieve the most common devices used to interact with your links.This endpoint returns event counts grouped by device type, helping you understand whether your audience primarily uses mobile, desktop, or tablet devices.<h2>Common Use Cases</h2><ul><li>Mobile vs desktop traffic analysis</li><li>UX optimization</li><li>Campaign targeting</li><li>Device-specific performance tracking</li></ul><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "devices",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>Browser Analytics</h2>Analyze which browsers your visitors use most frequently.Browser analytics help identify compatibility issues and improve web experiences across different browsers.<h3>Insights You Can Track</h3><ul><li>Chrome usage </li><li>Safari traffic </li><li>Firefox visitors </li><li>Edge browser activity </li><li>Browser-based engagement trends</li></ul><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "browsers",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>Operating System Analytics</h2>Retrieve analytics grouped by operating system.This allows you to understand which platforms your audience uses most, including Windows, macOS, Android, iOS, and Linux.<h3>Common Use Cases</h3><ul><li>Platform-specific optimization </li><li>Audience segmentation </li><li>Technical compatibility analysis </li><li>Device ecosystem reporting</li></ul><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "os",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>Build Better Analytics Dashboards</h2>With device analytics, you can create dashboards that show:<ul><li>Mobile vs desktop traffic trends </li><li>Browser market share </li><li>Operating system breakdowns </li><li>Platform engagement patterns </li><li>Device-specific conversion performance </li></ul>These insights help teams make better product, marketing, and optimisation decisions.<h2>Best Practices</h2>For accurate and scalable device reporting:<ul><li>Use <code>timeseries</code> together with device analytics for trend visualization </li><li>Combine device data with geographic analytics for deeper insights </li><li>Monitor browser compatibility regularly </li><li>Track mobile traffic separately for responsive optimisation </li><li>Store aggregated reports for long-term analysis </li></ul><h2>Related Analytics</h2>Device analytics work seamlessly with other Linkkit analytics features, including:<ul><li>Geographic analytics </li><li>UTM tracking </li><li>Referrer analytics </li><li>Campaign reporting </li><li>Conversion tracking </li><li>Real-time click monitoring </li></ul>Together, these analytics tools provide a complete understanding of your link performance and audience behavior.

Device Analytics

Track where your link traffic comes from using the Linkkit Referrer Analytics API.Referrer analytics help you understand which websites, platforms, and pages are sending visitors to your links. This data is essential for measuring campaign performance, identifying traffic sources, and optimizing distribution strategies.With Linkkit, you can analyze both:<ul><li>Referring domains</li><li>Full referrer URLs</li></ul><h2>Availability</h2>Referrer analytics endpoints require a Pro plan or higher.<h2>Overview</h2>Linkkit provides detailed traffic source analytics so you can monitor how users discover and interact with your links across the web.Referrer data is especially useful for:<ul><li>Marketing attribution</li><li>Social media tracking</li><li>Affiliate monitoring</li><li>Campaign analysis</li><li>SEO and referral insights</li><li>Partnership reporting</li></ul><h2>Referrer Domain Analytics</h2>Retrieve the top referring domains driving traffic to your links.This endpoint groups analytics by referrer source, helping you identify which platforms or websites generate the most engagement.<h3>Common Referrer Sources</h3><ul><li>Social media platforms</li><li>Search engines</li><li>Blogs and news sites</li><li>Partner websites</li><li>Community forums</li><li>Email campaigns</li></ul><h3>Example Use Cases</h3><ul><li>Measure social traffic performance</li><li>Analyze referral partnerships</li><li>Identify high-performing traffic channels</li><li>Compare campaign distribution sources</li></ul><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "referrers",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>Referrer URL Analytics</h2>Analyze the exact pages or URLs sending visitors to your links.Unlike domain-level analytics, referrer URL analytics provide full referral URLs for deeper traffic insights.This helps you understand:<ul><li>Which posts generate clicks </li><li>Which pages drive conversions </li><li>Where campaigns perform best </li><li>Which content placements work most effectively </li></ul><h3>Common Use Cases</h3><ul><li>Influencer campaign tracking </li><li>Blog/article attribution </li><li>Community post analytics </li><li>Viral content monitoring </li><li>Traffic source validation</li></ul><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "referer_urls",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>Build Smarter Traffic Reports</h2>With referrer analytics, you can create dashboards that display:<ul><li>Top traffic sources </li><li>Most effective referral channels </li><li>High-performing content placements </li><li>Source-based conversion rates </li><li>Campaign attribution reports </li></ul>These insights help improve marketing decisions and optimize traffic acquisition strategies.<h2>Best Practices</h2>For more effective referrer tracking:<ul><li>Combine referrer analytics with UTM tracking </li><li>Monitor referral trends over time using <code>timeseries</code> </li><li>Compare referrer performance across campaigns </li><li>Track conversion quality by traffic source </li><li>Use full referrer URLs for detailed attribution analysis </li></ul><h2>Related Analytics Features</h2>Referrer analytics work seamlessly alongside other Linkkit analytics tools, including:<ul><li>Device analytics </li><li>Geographic analytics </li><li>UTM analytics </li><li>Conversion tracking </li><li>Real-time click monitoring </li><li>Campaign performance reporting </li></ul>Together, these analytics capabilities provide a complete view of how users discover and engage with your links.

Referrer Analytics

Measure the performance of your marketing campaigns using Linkkit UTM Analytics.UTM analytics help you track where your traffic comes from and how different campaigns, ads, and content variations perform across channels.With Linkkit, you can analyze UTM parameters in real time, including:<ul><li>UTM source</li><li>UTM medium</li><li>UTM campaign</li><li>UTM term</li><li>UTM content</li></ul>This makes it easier to understand campaign effectiveness, optimize marketing performance, and build advanced attribution dashboards.<h2>Availability</h2>UTM analytics endpoints require a Pro plan or higher.<h2>Overview</h2>UTM parameters are widely used in digital marketing to track traffic sources and campaign performance.Linkkit automatically captures and aggregates UTM data so you can:<ul><li>Monitor campaign traffic</li><li>Compare marketing channels</li><li>Analyze ad performance</li><li>Track keyword effectiveness</li><li>Measure content engagement</li><li>Build attribution reports</li></ul><h2>UTM Source Analytics</h2>Analyze the top traffic sources driving visitors to your links.The <code>utm_source</code> parameter identifies where traffic originates from, such as Google, Facebook, LinkedIn, or newsletters.<h3>Common Examples</h3><ul><li>google</li><li>facebook</li><li>twitter</li><li>linkedin</li><li>newsletter</li></ul><h3>Common Use Cases</h3><ul><li>Social media attribution</li><li>Traffic source comparison</li><li>Multi-channel campaign analysis</li><li>Marketing ROI reporting</li></ul><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "utm_sources",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>UTM Medium Analytics</h2>Track performance based on marketing media.The <code>utm_medium</code> parameter helps identify the type of traffic source used in your campaigns.<h3>Common Examples</h3><ul><li>cpc </li><li>email </li><li>social </li><li>referral </li><li>banner</li></ul><h3>Common Use Cases</h3><ul><li>Paid vs organic traffic analysis </li><li>Email campaign tracking </li><li>Ad channel performance reporting </li><li>Channel optimization</li></ul><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "utm_mediums",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>UTM Campaign Analytics</h2>Measure the performance of individual marketing campaigns.The <code>utm_campaign</code> parameter helps group traffic related to specific promotions, launches, or advertising initiatives.<h3>Common Use Cases</h3><ul><li>Product launch tracking </li><li>Seasonal campaign reporting </li><li>Paid advertising analysis </li><li>Marketing performance dashboards</li></ul><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "utm_campaigns",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>UTM Term Analytics</h2>Track keyword-level campaign performance.The <code>utm_term</code> parameter is commonly used for paid search campaigns and keyword attribution.<h3>Common Use Cases</h3><ul><li>PPC keyword tracking </li><li>Search advertising analysis </li><li>Conversion keyword reporting </li><li>Campaign optimization</li></ul><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "utm_terms",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>UTM Content Analytics</h2>Analyze performance variations within the same campaign.The <code>utm_content</code> parameter helps differentiate creatives, buttons, banners, or content variations.<h3>Common Use Cases</h3><ul><li>A/B testing </li><li>Creative performance tracking </li><li>CTA optimization </li><li>Ad variation analysis</li></ul><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "utm_contents",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>Build Advanced Marketing Dashboards</h2>With Linkkit UTM analytics, you can build dashboards that display:<ul><li>Campaign performance trends </li><li>Top-performing traffic sources </li><li>Marketing channel breakdowns </li><li>Keyword-level insights </li><li>Creative performance analytics </li><li>Conversion attribution reports </li></ul>These insights help marketing teams make data-driven decisions and improve campaign ROI.<h2>Best Practices</h2>For accurate UTM tracking and reporting:<ul><li>Use consistent UTM naming conventions </li><li>Standardize campaign structures across teams </li><li>Combine UTM analytics with conversion tracking </li><li>Use <code>timeseries</code> analytics for campaign trend visualization </li><li>Track UTM content for creative-level optimization </li></ul><h2>Related Analytics Features</h2>UTM analytics integrate seamlessly with other Linkkit analytics tools, including:<ul><li>Referrer analytics </li><li>Geographic analytics </li><li>Device analytics </li><li>Real-time click tracking </li><li>Conversion analytics </li><li>Campaign reporting dashboards </li></ul>Together, these analytics capabilities provide a complete view of your marketing performance and traffic attribution.

UTM Analytics

Filter and analyze link performance using tags with the Linkkit Analytics API.Tags make it easy to organize links into flexible groups such as campaigns, clients, products, teams, or marketing categories. With tag analytics, you can retrieve performance data for all links associated with specific tags.This allows you to build more structured analytics dashboards and track performance across grouped link collections.<h2>Overview</h2>Tag analytics help you aggregate data across multiple links without needing to query each link individually.Instead of analyzing links one by one, you can retrieve analytics for entire categories of links using tags.<h3>Common Use Cases</h3><ul><li>Campaign performance tracking</li><li>Client-specific analytics</li><li>Product launch reporting</li><li>Team-based dashboards</li><li>Marketing attribution</li><li>Category-level reporting</li></ul><h2>Filter Analytics by Tags</h2>Use the <code>tagIds</code> parameter to retrieve analytics for links associated with one or more tags.This is useful for aggregating clicks, conversions, and engagement metrics across grouped links.<pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "top_links",
 tagIds: ["tag_12345", "tag_67890"],
 interval: "30d",
});</code></pre><h2>How Tag Filtering Works</h2>When you pass multiple tag IDs, Linkkit filters analytics data to include links associated with the specified tags.You can combine tag filtering with other analytics groupings, such as:<ul><li>count </li><li>timeseries </li><li>countries </li><li>devices </li><li>referrers </li><li>utm_campaigns </li><li>top_links </li></ul>This makes tag analytics highly flexible for custom reporting systems.<h2>Tag-Based Analytics Dashboards</h2>With Linkkit tag analytics, you can build dashboards that display:<ul><li>Campaign-level performance </li><li>Client-specific traffic reports </li><li>Team analytics </li><li>Category-based engagement metrics </li><li>Multi-campaign comparisons </li><li>Aggregated conversion tracking </li></ul><h2>Example Use Cases</h2><h3>Marketing Campaign Analytics</h3>Group all campaign links under a single tag and track total campaign performance.<h3>Client Reporting</h3>Assign tags per client to generate isolated analytics dashboards for each account.<h3>Product Tracking</h3>Track engagement across links related to specific products or launches.<h3>Team Collaboration</h3>Use tags to organise links by internal teams or departments.<h2>Upcoming Features</h2><h3>Top Tags by Event</h3>Support for retrieving top-performing tags by event count is coming soon.This feature will allow you to:<ul><li>Identify highest-performing tag groups </li><li>Compare campaign categories </li><li>Monitor overall tag engagement trends </li></ul>Early access may be available in future Linkkit releases.<h2>Best Practices</h2>For scalable tag analytics:<ul><li>Use consistent tag naming conventions </li><li>Create tags based on reporting needs </li><li>Combine tags with UTM tracking for deeper insights </li><li>Use tag filtering with <code>timeseries</code> analytics for trend analysis </li><li>Organize tags by campaigns, clients, or workflows </li></ul><h2>Related Analytics Features</h2>Tag analytics work seamlessly with other Linkkit analytics capabilities, including:<ul><li>UTM analytics </li><li>Device analytics </li><li>Geographic analytics </li><li>Referrer analytics </li><li>Conversion tracking </li><li>Real-time analytics dashboards </li></ul>Together, these tools help you create advanced reporting systems and organized analytics experiences inside your application.

Tag Analytics

Filtering and aggregation

Learn how to integrate the Linkkit iOS SDK into your Swift application for deep linking, attribution tracking, lead tracking, and conversion analytics. &lt;!-- Image 1 goes here --&gt;<h2>Prerequisites</h2>Before integrating the Linkkit Swift SDK, make sure you have the following ready:<ol><li>Your Linkkit publishable key (<code>LINKKIT_PUBLISHABLE_KEY</code>)</li><li>Your custom tracking domain (<code>LINKKIT_DOMAIN</code>)</li><li>Xcode 16 or later</li><li>Swift 4.0+</li><li>iOS 16.0+ support enabled in your app</li></ol>If you plan to use conversion analytics, ensure conversion tracking is enabled inside your Linkkit dashboard.<h2>Quickstart</h2>This guide walks you through setting up the Linkkit iOS SDK in your Swift project.<h3>Step 1: Install the Linkkit iOS SDK</h3>The SDK can be installed using Swift Package Manager.Inside Xcode:<ul><li>Open your project</li><li>Go to File → Add Package Dependencies</li><li>Add your Linkkit iOS SDK repository URL</li><li>Install the latest stable version</li></ul><h3>Minimum Environment Requirements</h3><h4>Build Tools</h4><ul><li>Xcode 16+</li><li>Swift 4.0+</li></ul><h4>Supported Platforms</h4><ul><li>iOS 16.0+</li><li>macOS Ventura and above</li></ul><h2>Step 2: Initialise the SDK</h2>Before using any Linkkit features, initialise the SDK with your publishable key and domain.<h3>SwiftUI Example</h3><pre><code>import SwiftUI
import Linkkit

@main
struct LinkkitApp: App {

 private let publishableKey = "&lt;LINKKIT_PUBLISHABLE_KEY&gt;"
 private let domain = "&lt;LINKKIT_DOMAIN&gt;"

 init() {
 Linkkit.setup(
 publishableKey: publishableKey,
 domain: domain
 )
 }

 var body: some Scene {
 WindowGroup {
 ContentView()
 .environment(\.linkkit, Linkkit.shared)
 }
 }
}</code></pre> &lt;!-- Image 2 goes here --&gt; <h2>Step 3: Track Deep Link Opens</h2>Use the <code>trackOpen</code> method to measure deep link opens and deferred deep link activity.The method should:<ul><li>Run once on the first app launch </li><li>Run again whenever a deep link opens the app </li></ul><h3>SwiftUI Example</h3><pre><code>import SwiftUI
import Linkkit

struct ContentView: View {

 @Environment(\.linkkit) var linkkit
 @AppStorage("is_first_launch") private var isFirstLaunch = true

 var body: some View {
 NavigationStack {

 VStack {
 Text("Welcome to Linkkit")
 }

 .onOpenURL { url in
 handleOpen(deepLink: url)
 }

 .onAppear {
 if isFirstLaunch {
 handleOpen()
 isFirstLaunch = false
 }
 }
 }
 }

 private func handleOpen(deepLink: URL? = nil) {

 Task {
 do {

 let response = try await linkkit.trackOpen(
 deepLink: deepLink
 )

 guard let destinationURL = response.link?.url else {
 return
 }

 // Navigate user to destination

 } catch {
 print(error.localizedDescription)
 }
 }
 }
}</code></pre> &lt;!-- Image 3 goes here --&gt; <h2>Optional Features</h2><h3>Track Lead Events</h3>Lead events help you monitor actions such as:<ul><li>User signups </li><li>Newsletter subscriptions </li><li>Demo requests </li><li>Free trial activations </li></ul>Use the <code>trackLead</code> method to send lead data to Linkkit analytics.<h3>Swift Example</h3><pre><code>import SwiftUI
import Linkkit

struct ContentView: View {

 @Environment(\.linkkit) var linkkit

 func trackLead(
 customerId: String,
 name: String,
 email: String
 ) {

 Task {

 do {

 let response = try await linkkit.trackLead(
 eventName: "User Sign Up",
 customerExternalId: customerId,
 customerName: name,
 customerEmail: email
 )

 print(response)

 } catch {
 print(error.localizedDescription)
 }
 }
 }
}</code></pre><h2>Lead Event Parameters</h2><table class="border-collapse table-auto w-full" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Property</th><th colspan="1" rowspan="1">Required</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">clickId</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Unique identifier of the original click</td></tr><tr><td colspan="1" rowspan="1">eventName</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Name of the lead event</td></tr><tr><td colspan="1" rowspan="1">customerExternalId</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Your internal customer ID</td></tr><tr><td colspan="1" rowspan="1">customerName</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Name of the customer</td></tr><tr><td colspan="1" rowspan="1">customerEmail</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer email address</td></tr><tr><td colspan="1" rowspan="1">customerAvatar</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Avatar image URL</td></tr><tr><td colspan="1" rowspan="1">mode</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Tracking mode (async, wait, or deferred)</td></tr><tr><td colspan="1" rowspan="1">metadata</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Additional custom event data</td></tr></tbody></table> &lt;!-- Image 4 goes here --&gt; <h2>Track Sale Events</h2>Sales events allow you to monitor purchases and revenue attribution directly from your app.Common use cases include:<ul><li>Subscription purchases </li><li>Product checkouts </li><li>Premium upgrades </li><li>In-app purchases </li></ul><h3>Swift Example</h3><pre><code>import SwiftUI
import Linkkit

struct ContentView: View {

 @Environment(\.linkkit) var linkkit

 func trackSale(
 customerId: String,
 amount: Int,
 currency: String = "usd"
 ) {

 Task {

 do {

 let response = try await linkkit.trackSale(
 customerExternalId: customerId,
 amount: amount,
 currency: currency,
 eventName: "Purchase"
 )

 print(response)

 } catch {
 print(error.localizedDescription)
 }
 }
 }
}</code></pre> &lt;!-- Image 5 goes here --&gt; <h2>Sale Event Parameters</h2><table class="border-collapse table-auto w-full" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Property</th><th colspan="1" rowspan="1">Required</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">customerExternalId</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Your customer identifier</td></tr><tr><td colspan="1" rowspan="1">amount</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Sale amount in cents</td></tr><tr><td colspan="1" rowspan="1">paymentProcessor</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Payment provider used</td></tr><tr><td colspan="1" rowspan="1">eventName</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Event name</td></tr><tr><td colspan="1" rowspan="1">invoiceId</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Invoice or order ID</td></tr><tr><td colspan="1" rowspan="1">currency</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Currency code</td></tr><tr><td colspan="1" rowspan="1">metadata</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Additional sale metadata</td></tr><tr><td colspan="1" rowspan="1">clickId</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Attribution click identifier</td></tr><tr><td colspan="1" rowspan="1">customerName</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer name</td></tr><tr><td colspan="1" rowspan="1">customerEmail</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer email</td></tr><tr><td colspan="1" rowspan="1">customerAvatar</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer avatar URL</td></tr></tbody></table><h2>Best Practices</h2>To get the most accurate attribution tracking:<ul><li>Initialise the SDK as early as possible </li><li>Handle deferred deep links on first launch </li><li>Use unique customer IDs </li><li>Track leads before tracking sales </li><li>Store metadata for advanced analytics </li></ul><h2>Example Projects</h2>You can create production-ready apps using Linkkit with:<ul><li>SwiftUI </li><li>UIKit </li><li>Custom navigation flows </li><li>Universal links </li><li>Deferred deep linking </li></ul>These examples can help you quickly integrate Linkkit into real-world iOS applications.<h2>Why Use Linkkit for Mobile Attribution?</h2>Linkkit helps developers and marketers:<ul><li>Track deep links accurately </li><li>Measure app installs and conversions </li><li>Attribute revenue to campaigns </li><li>Understand user journeys </li><li>Improve marketing performance </li></ul>With first-party attribution and mobile SDK support, Linkkit simplifies conversion analytics for modern iOS apps.

Swift SDK Integration Guide for Linkkit

<blockquote>Integrate Linkkit into your React Native application to enable mobile deep linking, attribution tracking, conversion analytics, and campaign performance monitoring.</blockquote><h2>Prerequisites</h2>Before integrating the Linkkit React Native SDK, make sure you have the following ready:<ol><li>Your Linkkit publishable key (<code>LINKKIT_PUBLISHABLE_KEY</code>)</li><li>Your custom tracking domain (<code>LINKKIT_DOMAIN</code>)</li><li>A React Native project configured for Android and iOS</li><li>Conversion tracking enabled in Linkkit (optional)</li></ol><h2>Quickstart</h2>This guide walks you through installing the SDK, initialising Linkkit, handling deep links, and tracking conversions inside your React Native app.<h3>Step 1: Install the Linkkit React Native SDK</h3>Install the official Linkkit package using npm, yarn, or pnpm.<h3>Install with npm</h3><pre><code>npm install @getlinkkit/react-native</code></pre><h3>Install with yarn</h3><pre><code>yarn add @getlinkkit/react-native</code></pre><h3>Install with pnpm</h3><pre><code>pnpm add @getlinkkit/react-native</code></pre>After installation, rebuild your app to ensure native dependencies are linked correctly. &lt;!-- Image 1 goes here --&gt; <h3>Step 2: Initialise the SDK</h3>Initialise Linkkit before using attribution or deep linking features.<h3>Option 1: Use the LinkkitProvider</h3><pre><code>import { LinkkitProvider } from "@getlinkkit/react-native";

export default function App() {
 return (
 &lt;LinkkitProvider
 publishableKey="&lt;LINKKIT_PUBLISHABLE_KEY&gt;"
 domain="&lt;LINKKIT_DOMAIN&gt;"
 &gt;
 {/* Application Content */}
 &lt;/LinkkitProvider&gt;
 );
}</code></pre><h3>Option 2: Initialise manually</h3><pre><code>import { useEffect } from "react";
import linkkit from "@getlinkkit/react-native";

export default function App() {

 useEffect(() =&gt; {

 linkkit.init({
 publishableKey: "&lt;LINKKIT_PUBLISHABLE_KEY&gt;",
 domain: "&lt;LINKKIT_DOMAIN&gt;",
 });

 }, []);

 return (
 // App Layout
 );
}</code></pre> &lt;!-- Image 2 goes here --&gt;<h3>Step 3: Track Deep Link Open Events</h3>Use the <code>trackOpen()</code> method to detect and track deep link opens and deferred deep links.The tracking method should:<ul><li>Run once on the first launch </li><li>Run again whenever the app opens through a deep link </li><li>Handle deferred attribution events automatically </li></ul><pre><code>import { useEffect } from "react";
import { Linking } from "react-native";
import AsyncStorage from "@react-native-async-storage/async-storage";
import linkkit from "@getlinkkit/react-native";

export default function App() {

 useEffect(() =&gt; {

 linkkit.init({
 publishableKey: "&lt;LINKKIT_PUBLISHABLE_KEY&gt;",
 domain: "&lt;LINKKIT_DOMAIN&gt;",
 });

 initializeTracking();

 const subscription = Linking.addEventListener("url", ({ url }) =&gt; {
 processDeepLink(url);
 });

 return () =&gt; {
 subscription.remove();
 };

 }, []);

 async function initializeTracking() {

 const launchedBefore = await AsyncStorage.getItem("app_launched");

 if (!launchedBefore) {

 await processDeepLink();
 await AsyncStorage.setItem("app_launched", "true");

 } else {

 const initialUrl = await Linking.getInitialURL();

 if (initialUrl) {
 await processDeepLink(initialUrl);
 }
 }
 }

 async function processDeepLink(
 deepLink?: string | null
 ) {

 try {

 const response = await linkkit.trackOpen(deepLink);

 const redirectUrl = response.link?.url;

 // Redirect user inside app

 } catch (error) {

 console.log(error);

 }
 }

 return (
 // Application UI
 );
}</code></pre> &lt;!-- Image 3 goes here --&gt;<h3>Step 4: Track Lead Events (Optional)</h3><h3>Lead tracking allows you to monitor user acquisition and signup-related events.</h3>Common examples include:<ul><li>Account creation </li><li>Trial registrations </li><li>Newsletter signups </li><li>Demo requests</li></ul><pre><code>import linkkit from "@getlinkkit/react-native";

async function trackLead(user) {

 try {

 await linkkit.trackLead({
 eventName: "User Registration",
 customerExternalId: user.id,
 customerName: user.name,
 customerEmail: user.email,
 });

 } catch (error) {

 console.log(error);

 }
}</code></pre><h2>Lead Event Attributes</h2><table class="border-collapse table-auto w-full" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Property</th><th colspan="1" rowspan="1">Required</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">clickId</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Unique identifier for the attributed click</td></tr><tr><td colspan="1" rowspan="1">eventName</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Name of the lead event</td></tr><tr><td colspan="1" rowspan="1">customerExternalId</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Unique customer ID from your system</td></tr><tr><td colspan="1" rowspan="1">customerName</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer's full name</td></tr><tr><td colspan="1" rowspan="1">customerEmail</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer email address</td></tr><tr><td colspan="1" rowspan="1">customerAvatar</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer profile image</td></tr><tr><td colspan="1" rowspan="1">mode</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Tracking mode (async, wait, or deferred)</td></tr><tr><td colspan="1" rowspan="1">metadata</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Additional event metadata</td></tr></tbody></table> &lt;!-- Image 4 goes here --&gt; <h2>Step 5: Track Sale Events (Optional)</h2>Track purchases and revenue attribution directly from your React Native application.Typical use cases include:<ul><li>Subscription purchases </li><li>Premium feature upgrades </li><li>Product checkouts </li><li>In-app purchases</li></ul><pre><code>import linkkit from "@getlinkkit/react-native";

async function trackSale(user, order) {

 try {

 await linkkit.trackSale({
 customerExternalId: user.id,
 amount: order.total,
 currency: "usd",
 eventName: "Purchase",
 });

 } catch (error) {

 console.log(error);

 }
}</code></pre><h2>Sale Event Attributes</h2><table class="border-collapse table-auto w-full" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Property</th><th colspan="1" rowspan="1">Required</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">customerExternalId</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Unique customer identifier</td></tr><tr><td colspan="1" rowspan="1">amount</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Sale amount in cents</td></tr><tr><td colspan="1" rowspan="1">paymentProcessor</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Payment gateway or provider</td></tr><tr><td colspan="1" rowspan="1">eventName</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Conversion event name</td></tr><tr><td colspan="1" rowspan="1">invoiceId</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Invoice or transaction ID</td></tr><tr><td colspan="1" rowspan="1">currency</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Currency code</td></tr><tr><td colspan="1" rowspan="1">metadata</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Additional purchase data</td></tr><tr><td colspan="1" rowspan="1">clickId</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Attribution click identifier</td></tr><tr><td colspan="1" rowspan="1">customerName</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer's full name</td></tr><tr><td colspan="1" rowspan="1">customerEmail</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer email address</td></tr><tr><td colspan="1" rowspan="1">customerAvatar</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer avatar image</td></tr></tbody></table> &lt;!-- Image 5 goes here --&gt; <h2>Example Project</h2>Use the sample project below to understand a complete Linkkit React Native integration flow. &lt;CardGroup cols={2}&gt; &lt;Card title="React Native Starter Example" icon="github" href="<a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="https://github.com/linkkit/linkkit-react-native">https://github.com/linkkit/linkkit-react-native</a>" color="#333333"Explore a complete React Native integration example using Linkkit. &lt;/Card&gt; &lt;/CardGroup&gt;

React Native 

Mobile installation

<h1>Stripe Integration</h1><blockquote>Connect Stripe with Linkkit to automatically track subscriptions, payments, revenue attribution, and customer conversions from your marketing campaigns.</blockquote><h2>Overview</h2>The Linkkit Stripe integration helps businesses measure revenue generated through referral links, affiliate campaigns, paid ads, and deep links.By connecting Stripe to Linkkit, you can:<ul><li>Automatically track successful payments</li><li>Attribute revenue to marketing campaigns</li><li>Measure customer lifetime value</li><li>Monitor subscription conversions</li><li>Track recurring payments and upgrades</li><li>Improve campaign ROI visibility</li></ul>This integration is ideal for SaaS products, subscription platforms, eCommerce stores, and online services using Stripe for payment processing. &lt;!-- Image 1 goes here --&gt; <h2>Requirements</h2>Before setting up the Stripe integration, make sure you have:<ol><li>A Linkkit account</li><li>A Stripe account with API access enabled</li><li>Conversion tracking is enabled in Linkkit</li><li>Your Stripe Secret API Key</li><li>Admin access to both platforms</li></ol><h2>Quick Setup</h2>Follow the steps below to connect Stripe with Linkkit.<h2>Step 1: Install the Linkkit Package</h2>Install the official Linkkit package in your application.<h3>npm</h3><pre><code>npm install getlinkkit</code></pre><h3>yarn</h3><pre><code>yarn add getlinkkit</code></pre><h3>pnpm</h3><pre><code>pnpm add getlinkkit</code></pre> &lt;!-- Image 2 goes here --&gt; <h2>Step 2: Configure Linkkit</h2>Initialise Linkkit using your publishable key and tracking domain.<pre><code>import linkkit from "getlinkkit";

linkkit.init({
 publishableKey: process.env.LINKKIT_PUBLISHABLE_KEY,
 domain: process.env.LINKKIT_DOMAIN,
});</code></pre>This setup allows Linkkit to connect conversion events with your attribution data.<h2>Step 3: Connect Stripe Webhooks</h2>Stripe webhooks allow Linkkit to receive real-time payment and subscription events.Inside your Stripe Dashboard:<ol><li>Open Developers → Webhooks </li><li>Click Add Endpoint </li><li>Enter your webhook URL </li><li>Select the required payment events </li><li>Save the webhook configuration </li></ol><h3>Recommended Stripe Events</h3><ul><li><code>checkout.session.completed</code> </li><li><code>invoice.paid</code> </li><li><code>customer.subscription.created</code> </li><li><code>customer.subscription.updated</code> </li><li><code>customer.subscription.deleted</code> &lt;!-- Image 3 goes here --&gt; </li></ul><h2>Step 4: Track Stripe Payments</h2>Use Linkkit to record successful purchases and subscription payments.<pre><code>import linkkit from "getlinkkit";

await linkkit.trackSale({
 customerExternalId: customer.id,
 amount: payment.amount_total,
 currency: payment.currency,
 paymentProcessor: "stripe",
 invoiceId: payment.id,
 eventName: "Subscription Purchase",
});</code></pre>This allows Linkkit to attribute purchases back to the original marketing source.<h2>Step 5: Track Customer Signups</h2>You can also track lead events before a purchase happens.<pre><code>import linkkit from "getlinkkit";

await linkkit.trackLead({
 customerExternalId: customer.id,
 customerEmail: customer.email,
 customerName: customer.name,
 eventName: "Free Trial Signup",
});</code></pre>Lead tracking helps you analyse conversion funnels and customer acquisition performance. &lt;!-- Image 4 goes here --&gt;<h2>Supported Stripe Events</h2>Linkkit supports tracking for multiple Stripe event types.<table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Event Type</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">checkout.session.completed</td><td colspan="1" rowspan="1">Tracks completed checkout sessions</td></tr><tr><td colspan="1" rowspan="1">invoice.paid</td><td colspan="1" rowspan="1">Tracks successful invoice payments</td></tr><tr><td colspan="1" rowspan="1">customer.subscription.created</td><td colspan="1" rowspan="1">Detects new subscriptions</td></tr><tr><td colspan="1" rowspan="1">customer.subscription.updated</td><td colspan="1" rowspan="1">Tracks subscription changes</td></tr><tr><td colspan="1" rowspan="1">customer.subscription.deleted</td><td colspan="1" rowspan="1">Detects cancelled subscriptions</td></tr></tbody></table><hr><h1>Revenue Attribution</h1>Once Stripe is connected, Linkkit automatically associates revenue with:<ul><li>Referral campaigns </li><li>Affiliate links </li><li>Paid advertisements </li><li>Email campaigns </li><li>Deep links </li><li>Social media promotions </li></ul>This helps marketing and growth teams understand which channels generate the highest revenue. &lt;!-- Image 5 goes here --&gt; <h2>Best Practices</h2>To improve attribution accuracy:<ul><li>Enable conversion tracking before launching campaigns </li><li>Pass consistent customer IDs </li><li>Track leads before purchases </li><li>Verify Stripe webhook signatures </li><li>Store metadata for advanced reporting </li></ul><h2>Common Use Cases</h2>The Stripe integration is commonly used for:<ul><li>SaaS subscription tracking </li><li>Affiliate marketing attribution </li><li>Creator monetization analytics </li><li>eCommerce revenue reporting </li><li>Paid campaign measurement </li><li>Subscription upgrade tracking </li></ul><h2>Why Use Linkkit with Stripe?</h2>Linkkit gives businesses complete visibility into their conversion funnel by connecting marketing attribution with real revenue data.With Stripe and Linkkit together, you can:<ul><li>Measure campaign ROI </li><li>Track recurring revenue </li><li>Analyze customer journeys </li><li>Improve acquisition strategies </li><li>Scale affiliate and referral programs </li></ul>Built for modern growth teams, Linkkit makes payment attribution and conversion analytics simple and scalable.

Stripe

Connect Google Tag Manager with Linkkit to manage tracking scripts, conversion events, attribution analytics, and marketing tags from one centralized platform.<h2>Overview</h2>The Linkkit Google Tag Manager integration allows you to deploy and manage Linkkit tracking events without manually editing your website code. By integrating Google Tag Manager with Linkkit, you can:<ul><li>Track marketing conversions</li><li>Measure campaign performance</li><li>Monitor referral traffic</li><li>Trigger custom analytics events</li><li>Manage tracking scripts from one dashboard</li><li>Improve attribution accuracy across campaigns</li></ul>This integration is ideal for marketing teams, agencies, SaaS platforms, and businesses managing multiple tracking tools. &lt;!-- Image 1 goes here --&gt; <h2>Requirements</h2>Before setting up the integration, make sure you have:<ol><li>A Linkkit account</li><li>A Google Tag Manager container</li><li>A website or application with GTM installed</li><li>Your Linkkit tracking domain</li><li>Conversion tracking is enabled in Linkkit</li></ol><h2>Getting Started</h2>This guide explains how to connect Linkkit with Google Tag Manager and configure conversion tracking events.<h3>Step 1: Install the Linkkit Package</h3>Install the official Linkkit package in your project.<h3>npm</h3><pre><code>npm install getlinkkit</code></pre><h3>yarn</h3><pre><code>yarn add getlinkkit</code></pre><h3>pnpm</h3><pre><code>pnpm add getlinkkit</code></pre> &lt;!-- Image 2 goes here --&gt; <h3>Step 2: Initialize Linkkit</h3>Initialize Linkkit before sending events through Google Tag Manager.<pre><code>import linkkit from "getlinkkit";

linkkit.init({
 publishableKey: process.env.LINKKIT_PUBLISHABLE_KEY,
 domain: process.env.LINKKIT_DOMAIN,
});</code></pre>This setup connects your website or application with Linkkit attribution tracking.<h3>Step 3: Add Google Tag Manager to Your Website</h3>Copy your GTM container script from your Google Tag Manager dashboard and place it inside your website.<h3>Example GTM Script</h3><pre><code>&lt;!-- Google Tag Manager --&gt;
&lt;script&gt;
(function(w,d,s,l,i){w[l]=w[l]||[];
w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});
var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&amp;l='+l:'';
j.async=true;
j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-XXXXXXX');
&lt;/script&gt;
&lt;!-- End Google Tag Manager --&gt;</code></pre>Replace <code>GTM-XXXXXXX</code> with your actual GTM container ID. &lt;!-- Image 3 goes here --&gt; <h3>Step 4: Configure Custom Events in GTM</h3>Inside Google Tag Manager:<ol><li>Create a new tag </li><li>Select a custom HTML tag </li><li>Add your Linkkit tracking code </li><li>Configure triggers for user actions </li><li>Publish the container </li></ol>You can trigger Linkkit events for:<ul><li>Form submissions </li><li>Checkout completions </li><li>User registrations </li><li>Button clicks </li><li>Subscription upgrades </li><li>Product purchases</li></ul><h3>Step 5: Send Lead Events</h3>Use Linkkit lead tracking to monitor customer acquisition events.<pre><code>import linkkit from "getlinkkit";

await linkkit.trackLead({
 eventName: "Newsletter Signup",
 customerExternalId: user.id,
 customerEmail: user.email,
});</code></pre>This helps track which campaigns generate qualified leads.<h3>Step 6: Send Purchase Events</h3>Track sales and revenue attribution directly from your application.<pre><code>import linkkit from "getlinkkit";

await linkkit.trackSale({
 customerExternalId: user.id,
 amount: order.total,
 currency: "usd",
 eventName: "Purchase",
});</code></pre>Linkkit automatically associates conversion events with the original traffic source. &lt;!-- Image 4 goes here --&gt; <h2>Common Tracking Events</h2>Here are some commonly tracked events using Linkkit and Google Tag Manager.<table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Event</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">Page View</td><td colspan="1" rowspan="1">Tracks page visits</td></tr><tr><td colspan="1" rowspan="1">Lead Signup</td><td colspan="1" rowspan="1">Tracks new user registrations</td></tr><tr><td colspan="1" rowspan="1">Purchase</td><td colspan="1" rowspan="1">Tracks completed purchases</td></tr><tr><td colspan="1" rowspan="1">Subscription</td><td colspan="1" rowspan="1">Tracks subscription activations</td></tr><tr><td colspan="1" rowspan="1">Button Click</td><td colspan="1" rowspan="1">Tracks CTA interactions</td></tr><tr><td colspan="1" rowspan="1">Form Submission</td><td colspan="1" rowspan="1">Tracks lead generation forms</td></tr></tbody></table><h2>Benefits of Using Google Tag Manager with Linkkit</h2>Using GTM with Linkkit helps teams:<ul><li>Deploy tracking faster </li><li>Reduce developer dependency </li><li>Manage tags centrally </li><li>Improve attribution reporting </li><li>Track custom marketing events </li><li>Optimize campaign performance &lt;!-- Image 5 goes here --&gt; </li></ul><h2>Best Practices</h2>For accurate attribution and analytics:<ul><li>Use consistent event names </li><li>Verify GTM triggers before publishing </li><li>Track leads before purchases </li><li>Test events in GTM preview mode </li><li>Keep customer identifiers consistent </li></ul><h2>Recommended Use Cases</h2>This integration works well for:<ul><li>SaaS platforms </li><li>Marketing agencies </li><li>Affiliate programs </li><li>Subscription businesses </li><li>eCommerce stores </li><li>Lead generation funnels</li></ul><h2>Why Use Linkkit with Google Tag Manager?</h2>Linkkit and Google Tag Manager together provide a flexible and scalable tracking solution for modern websites and applications. With this integration, businesses can:<ul><li>Understand customer journeys </li><li>Measure campaign ROI </li><li>Improve conversion tracking </li><li>Manage analytics efficiently </li><li>Scale marketing attribution workflows </li></ul>Designed for growth-focused teams, Linkkit simplifies attribution tracking and conversion analytics across all marketing channels.

Google Tag Manager Integration

Connect Shopify with Linkkit to automatically track store conversions, purchases, customer journeys, and revenue attribution from your marketing campaigns.<h2>Overview</h2>The Linkkit Shopify integration helps eCommerce brands understand which campaigns, referral links, influencers, and traffic sources generate real sales.Once connected, Linkkit can automatically:<ul><li>Track Shopify purchases</li><li>Attribute sales to campaigns</li><li>Monitor customer conversions</li><li>Measure affiliate performance</li><li>Analyze store revenue sources</li><li>Improve marketing ROI tracking</li></ul>This integration is ideal for Shopify stores running paid ads, influencer campaigns, referral programs, or affiliate marketing.&lt;!-- Image 1 goes here --&gt;<h2>Requirements</h2>Before setting up the Shopify integration, make sure you have:<ol><li>A Linkkit account</li><li>A Shopify store</li><li>Conversion tracking is enabled in Linkkit</li><li>Admin access to your Shopify store</li><li>Your Linkkit tracking domain</li></ol><h2>Quick Setup</h2>Follow the steps below to connect Shopify with Linkkit.<h3>Step 1: Install the Linkkit Package</h3>Install the official Linkkit package in your application.<h3>npm</h3><pre><code>npm install getlinkkit</code></pre><h3>yarn</h3><pre><code>yarn add getlinkkit</code></pre><h3>pnpm</h3><pre><code>pnpm add getlinkkit</code></pre> &lt;!-- Image 2 goes here --&gt; <hr><h3>Step 2: Initialize Linkkit</h3>Initialize Linkkit using your publishable key and tracking domain.<pre><code>import linkkit from "getlinkkit";

linkkit.init({
 publishableKey: process.env.LINKKIT_PUBLISHABLE_KEY,
 domain: process.env.LINKKIT_DOMAIN,
});</code></pre>This setup enables Linkkit attribution tracking across your Shopify storefront.<h3>Step 3: Connect Shopify Store</h3>Inside your Shopify admin dashboard:<ol><li>Open Apps </li><li>Install the Linkkit Shopify integration </li><li>Authorize your store connection </li><li>Select the Linkkit workspace </li><li>Complete the integration setup </li></ol>After installation, Linkkit will begin listening to Shopify order events automatically. &lt;!-- Image 3 goes here --&gt; <h3>Step 4: Automatically Track Shopify Orders</h3>Once connected, Linkkit can automatically record:<ul><li>Completed purchases </li><li>Subscription orders </li><li>Customer checkouts </li><li>Product sales </li><li>Repeat purchases </li><li>Revenue attribution events </li></ul>No manual event tracking is required for standard Shopify checkout flows.<h3>Step 5: Track Custom Sale Events</h3>You can also send custom conversion events manually.<pre><code>import linkkit from "getlinkkit";

await linkkit.trackSale({
 customerExternalId: customer.id,
 amount: order.totalPrice,
 currency: "usd",
 paymentProcessor: "shopify",
 invoiceId: order.id,
 eventName: "Store Purchase",
});</code></pre>This is useful for custom storefronts, headless commerce setups, or advanced analytics workflows.<h3>Step 6: Track Customer Leads</h3>Track user registrations, email signups, and trial events before purchases happen.<pre><code>import linkkit from "getlinkkit";

await linkkit.trackLead({
 customerExternalId: customer.id,
 customerEmail: customer.email,
 customerName: customer.name,
 eventName: "Newsletter Signup",
});</code></pre>Lead tracking helps measure how visitors move through your conversion funnel. &lt;!-- Image 4 goes here --&gt; <h2>Shopify Events Supported</h2>Linkkit supports multiple Shopify conversion events automatically.<table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Event</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">Order Created</td><td colspan="1" rowspan="1">Tracks newly placed orders</td></tr><tr><td colspan="1" rowspan="1">Checkout Completed</td><td colspan="1" rowspan="1">Tracks successful checkouts</td></tr><tr><td colspan="1" rowspan="1">Subscription Purchase</td><td colspan="1" rowspan="1">Tracks recurring orders</td></tr><tr><td colspan="1" rowspan="1">Customer Created</td><td colspan="1" rowspan="1">Tracks new customer registrations</td></tr><tr><td colspan="1" rowspan="1">Refund Issued</td><td colspan="1" rowspan="1">Tracks refunded purchases</td></tr><tr><td colspan="1" rowspan="1">Repeat Purchase</td><td colspan="1" rowspan="1">Tracks returning customer orders</td></tr></tbody></table><hr><h2>Revenue Attribution</h2>Linkkit connects Shopify sales with the original traffic source, including:<ul><li>Affiliate links </li><li>Influencer campaigns </li><li>Referral programs </li><li>Paid advertisements </li><li>Email campaigns </li><li>Social media promotions </li></ul>This gives marketing teams full visibility into campaign performance and customer acquisition value. &lt;!-- Image 5 goes here --&gt; <h2>Currency Handling</h2>Linkkit records Shopify sales using your store’s primary currency settings.For example:<ul><li>If your Shopify store currency is USD, Linkkit records all sales in USD </li><li>Even if customers pay using another local currency </li></ul>This keeps reporting and analytics consistent across your dashboard.<h2>Best Practices</h2>For accurate Shopify attribution tracking:<ul><li>Enable conversion tracking before launching campaigns </li><li>Use consistent customer identifiers </li><li>Track leads before purchases </li><li>Verify checkout flows properly </li><li>Keep referral links active during campaigns </li></ul><h2>Common Use Cases</h2>The Shopify integration is commonly used for:<ul><li>Affiliate marketing programs </li><li>Influencer campaign tracking </li><li>eCommerce analytics </li><li>Subscription store attribution </li><li>Referral program tracking </li><li>Paid ad conversion measurement </li></ul><h2>Why Use Linkkit with Shopify?</h2>Linkkit helps Shopify store owners understand exactly where their sales come from.With Shopify and Linkkit together, you can:<ul><li>Track revenue by campaign </li><li>Measure customer acquisition performance </li><li>Improve conversion attribution </li><li>Analyze affiliate traffic </li><li>Optimize marketing spend </li></ul>Built for modern eCommerce businesses, Linkkit makes Shopify attribution tracking simple, scalable, and marketing-friendly.

Shopify 

<blockquote>Learn how to connect Segment with Linkkit to track customer conversions, monitor attribution data, and sync lead and revenue events across your analytics workflow.</blockquote><h2>Overview</h2>The Linkkit Segment integration helps businesses centralize customer tracking, attribution analytics, and conversion reporting using Segment.By connecting Segment with Linkkit, you can:<ul><li>Track signup and purchase conversions</li><li>Send customer events directly to Linkkit</li><li>Monitor campaign attribution performance</li><li>Sync analytics across platforms</li><li>Measure revenue from marketing channels</li><li>Improve conversion reporting accuracy</li></ul>This integration is perfect for SaaS products, subscription businesses, agencies, startups, and growth-focused teams using Segment for event management. &lt;!-- Image 1 goes here --&gt; <h2>Requirements</h2>Before getting started, make sure you have:<ol><li>A Linkkit account</li><li>A Segment workspace</li><li>Conversion tracking is enabled in Linkkit</li><li>Your Linkkit API credentials</li><li>Access to your Segment write key</li></ol><h2>Enable Conversion Tracking</h2>Before sending conversion events from Segment, enable conversion tracking inside Linkkit.You can enable tracking using one of the following methods.<h3>Option 1: Enable Workspace-Level Conversion Tracking</h3>To enable conversion tracking for all future links in your workspace:<ol><li>Open your Linkkit dashboard</li><li>Navigate to Tracking Settings</li><li>Enable Workspace Conversion Tracking</li><li>Save your changes</li></ol>Once enabled, all newly created tracking links will automatically support conversion attribution. &lt;!-- Image 2 goes here --&gt; <h3>Option 2: Enable Conversion Tracking for Individual Links</h3>If you only want conversion tracking for selected links:<ol><li>Open the Link Builder</li><li>Select the desired tracking link</li><li>Turn on Conversion Tracking</li><li>Save the link settings</li></ol>This option gives you more granular control over attribution tracking. &lt;!-- Image 3 goes here --&gt; <h3>Option 3: Enable Tracking Programmatically</h3>You can also enable conversion tracking directly through the API.<pre><code>const link = await linkkit.links.create({
 url: "https://yourwebsite.com",
 trackConversion: true,
});</code></pre>This method is useful for automated workflows and custom integrations.<h2>Install the Linkkit Analytics Script</h2>To track visitor attribution and conversion events correctly, install the Linkkit analytics script on your website.The script helps Linkkit:<ul><li>Capture click attribution data </li><li>Store visitor tracking IDs </li><li>Associate conversions with campaigns </li><li>Track customer journeys</li></ul>You can install the script using:<ul><li>React </li><li>Next.js </li><li>Shopify </li><li>WordPress </li><li>Webflow </li><li>Google Tag Manager </li><li>Manual HTML installation &lt;!-- Image 4 goes here --&gt; </li></ul><h2>Verify Installation</h2>After installing the analytics script, verify everything is working properly.<h3>Check 1: Verify Analytics Object</h3>Open your browser console and enter:<pre><code>_linkkitAnalytics</code></pre>If the script is installed successfully, the analytics object should appear.<h3>Check 2: Verify Tracking Cookie</h3>Add the following parameter to your website URL:<pre><code>?linkkit_id=test</code></pre>Then verify the <code>linkkit_id</code> cookie is being stored in your browser.If both checks pass, your analytics installation is configured correctly.<h2>Configure the Segment Destination</h2>Next, configure the Linkkit destination inside Segment.<h3>Step 1: Add the Linkkit Destination</h3>Inside your Segment dashboard:<ol><li>Open Destinations </li><li>Search for Linkkit </li><li>Add the destination to your workspace </li><li>Continue to the configuration </li></ol>This allows Segment to send customer events directly into Linkkit. &lt;!-- Image 5 goes here --&gt;<h3>Step 2: Add Your Linkkit API Key</h3>Inside the destination settings:<table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Setting</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">Name</td><td colspan="1" rowspan="1">Internal name for the destination</td></tr><tr><td colspan="1" rowspan="1">API Key</td><td colspan="1" rowspan="1">Your Linkkit API key</td></tr><tr><td colspan="1" rowspan="1">Enable Destination</td><td colspan="1" rowspan="1">Allows Segment to forward events</td></tr></tbody></table>After entering the details, save the configuration. &lt;!-- Image 6 goes here --&gt;<h3>Step 3: Configure Event Mapping</h3>Choose which Segment events should trigger Linkkit conversions.<h3>Recommended Event Mapping</h3><table class="border-collapse table-auto w-full" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Conversion Type</th><th colspan="1" rowspan="1">Suggested Event Name</th><th colspan="1" rowspan="1">Example</th></tr><tr><td colspan="1" rowspan="1">Lead Event</td><td colspan="1" rowspan="1">User Signup</td><td colspan="1" rowspan="1">User creates an account</td></tr><tr><td colspan="1" rowspan="1">Sale Event</td><td colspan="1" rowspan="1">Order Completed</td><td colspan="1" rowspan="1">Customer purchases a product</td></tr></tbody></table>You can customise mappings based on your application workflow. &lt;!-- Image 7 goes here --&gt;<h3>Step 4: Send Lead Events</h3>Use the Segment Node SDK to send customer signup events.<pre><code>import { Analytics } from "@segment/analytics-node";

const analytics = new Analytics({
 writeKey: process.env.SEGMENT_WRITE_KEY,
});

analytics.track({
 userId: user.id,
 event: "User Signup",
 properties: {
 name: user.name,
 email: user.email,
 },
});</code></pre>Linkkit will process the event and associate it with attribution data automatically.<h3>Step 5: Send Sale Events</h3>Track completed purchases and subscription revenue.<pre><code>import { Analytics } from "@segment/analytics-node";

const analytics = new Analytics({
 writeKey: process.env.SEGMENT_WRITE_KEY,
});

analytics.track({
 userId: user.id,
 event: "Order Completed",
 properties: {
 amount: 9999,
 currency: "USD",
 payment_processor: "stripe",
 },
});</code></pre>This helps Linkkit measure campaign-driven revenue performance. &lt;!-- Image 8 goes here --&gt;<h2>Supported Lead Event Attributes</h2><table class="border-collapse table-auto w-full" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Property</th><th colspan="1" rowspan="1">Required</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">clickId</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Attribution click identifier</td></tr><tr><td colspan="1" rowspan="1">eventName</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Name of the lead conversion event</td></tr><tr><td colspan="1" rowspan="1">customerExternalId</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Unique customer ID</td></tr><tr><td colspan="1" rowspan="1">customerName</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer's full name</td></tr><tr><td colspan="1" rowspan="1">customerEmail</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer email address</td></tr><tr><td colspan="1" rowspan="1">customerAvatar</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer profile image</td></tr><tr><td colspan="1" rowspan="1">mode</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Event processing mode</td></tr><tr><td colspan="1" rowspan="1">metadata</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Additional custom event data</td></tr></tbody></table><h2>Supported Sale Event Attributes</h2><table class="border-collapse table-auto w-full" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Property</th><th colspan="1" rowspan="1">Required</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">customerExternalId</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Unique customer identifier</td></tr><tr><td colspan="1" rowspan="1">amount</td><td colspan="1" rowspan="1">Yes</td><td colspan="1" rowspan="1">Sale amount in cents</td></tr><tr><td colspan="1" rowspan="1">paymentProcessor</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Payment provider name</td></tr><tr><td colspan="1" rowspan="1">eventName</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Name of the sale event</td></tr><tr><td colspan="1" rowspan="1">invoiceId</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Invoice or order ID</td></tr><tr><td colspan="1" rowspan="1">currency</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Currency code</td></tr><tr><td colspan="1" rowspan="1">metadata</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Additional purchase details</td></tr><tr><td colspan="1" rowspan="1">clickId</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Attribution click identifier</td></tr><tr><td colspan="1" rowspan="1">customerName</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer name</td></tr><tr><td colspan="1" rowspan="1">customerEmail</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer email</td></tr><tr><td colspan="1" rowspan="1">customerAvatar</td><td colspan="1" rowspan="1">No</td><td colspan="1" rowspan="1">Customer avatar image</td></tr></tbody></table><h2>View Conversion Analytics</h2>After setup, Linkkit provides multiple ways to analyze conversion performance.<h3>Time-Series Analytics</h3>Track clicks, leads, and revenue growth over time. &lt;!-- Image 9 goes here --&gt;<h3>Funnel Analytics</h3>Visualise customer conversion stages from click → lead → purchase. &lt;!-- Image 10 goes here --&gt;<h3>Real-Time Event Stream</h3>Monitor live customer events and conversion activity across campaigns. &lt;!-- Image 11 goes here --&gt;<h2>Best Practices</h2>For accurate Segment attribution tracking:<ul><li>Use consistent customer IDs </li><li>Install the analytics script before launching campaigns </li><li>Track lead events before purchase events </li><li>Keep event names standardized </li><li>Test mappings before production deployment</li></ul><h2>Common Use Cases</h2>The Segment integration is commonly used for:<ul><li>SaaS conversion analytics </li><li>Affiliate campaign tracking </li><li>Revenue attribution reporting </li><li>Subscription analytics </li><li>Product event tracking </li><li>Marketing performance measurement</li></ul><h2>Why Use Linkkit with Segment?</h2>Linkkit and Segment together create a scalable event tracking and attribution system for modern businesses.With this integration, teams can:<ul><li>Understand customer journeys </li><li>Track conversion funnels </li><li>Measure marketing ROI </li><li>Analyze revenue attribution </li><li>Centralize customer event data</li></ul>Built for growth-focused teams, Linkkit simplifies customer analytics, campaign attribution, and conversion tracking across your entire marketing stack.

Segment Integration

<blockquote>Connect HubSpot with Linkkit to sync leads, track customer journeys, monitor conversions, and improve marketing attribution across your CRM workflows.</blockquote><h2>Overview</h2>The Linkkit HubSpot integration helps businesses connect marketing attribution with customer relationship management.By integrating HubSpot with Linkkit, you can:<ul><li>Track lead generation sources</li><li>Sync conversion data into HubSpot</li><li>Monitor customer acquisition performance</li><li>Attribute revenue to campaigns</li><li>Automate CRM workflows</li><li>Improve sales and marketing visibility</li></ul>This integration is ideal for SaaS companies, agencies, startups, and businesses using HubSpot for CRM and marketing automation.&lt;!-- Image 1 goes here --&gt;<h2>Requirements</h2>Before connecting HubSpot with Linkkit, make sure you have:<ol><li>A Linkkit account</li><li>A HubSpot account with admin access</li><li>Conversion tracking is enabled in Linkkit</li><li>Your Linkkit publishable key</li><li>Your custom tracking domain</li></ol><h2>Quick Setup</h2>This guide explains how to connect HubSpot with Linkkit and start tracking CRM conversions and customer activity.<h3>Step 1: Install the Linkkit Package</h3>Install the official Linkkit SDK in your application.<h3>npm</h3><pre><code>npm install getlinkkit</code></pre><h3>yarn</h3><pre><code>yarn add getlinkkit</code></pre><h3>pnpm</h3><pre><code>pnpm add getlinkkit</code></pre> &lt;!-- Image 2 goes here --&gt; <h3>Step 2: Initialize Linkkit</h3>Initialize Linkkit before sending tracking events to HubSpot.<pre><code>import linkkit from "getlinkkit";

linkkit.init({
 publishableKey: process.env.LINKKIT_PUBLISHABLE_KEY,
 domain: process.env.LINKKIT_DOMAIN,
});</code></pre>This setup enables attribution tracking and CRM event synchronization.<h3>Step 3: Connect HubSpot</h3>Inside your HubSpot dashboard:<ol><li>Open Settings </li><li>Navigate to Integrations </li><li>Connect your Linkkit workspace </li><li>Authorize API permissions </li><li>Complete the setup process </li></ol>After connecting, Linkkit can sync conversion and customer activity into HubSpot automatically. &lt;!-- Image 3 goes here --&gt; <h3>Step 4: Track Lead Events</h3>Use Linkkit lead tracking to record signups, registrations, and customer acquisition events.<pre><code>import linkkit from "getlinkkit";

await linkkit.trackLead({
 eventName: "Demo Request",
 customerExternalId: user.id,
 customerName: user.name,
 customerEmail: user.email,
});</code></pre>Lead tracking helps marketing and sales teams understand where customers are coming from.<h3>Step 5: Track Sales and Revenue</h3>Track purchases, subscription upgrades, and revenue attribution inside HubSpot workflows.<pre><code>import linkkit from "getlinkkit";

await linkkit.trackSale({
 customerExternalId: user.id,
 amount: order.total,
 currency: "usd",
 eventName: "Subscription Purchase",
});</code></pre>This allows Linkkit to associate revenue with the original traffic source and customer journey. &lt;!-- Image 4 goes here --&gt;<h2>What Can You Sync with HubSpot?</h2>Linkkit can sync multiple conversion and attribution events into HubSpot.<table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Event Type</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">Lead Signup</td><td colspan="1" rowspan="1">Tracks new customer registrations</td></tr><tr><td colspan="1" rowspan="1">Demo Request</td><td colspan="1" rowspan="1">Tracks inbound demo requests</td></tr><tr><td colspan="1" rowspan="1">Purchase Event</td><td colspan="1" rowspan="1">Tracks completed purchases</td></tr><tr><td colspan="1" rowspan="1">Subscription Upgrade</td><td colspan="1" rowspan="1">Tracks subscription changes</td></tr><tr><td colspan="1" rowspan="1">Campaign Attribution</td><td colspan="1" rowspan="1">Tracks marketing source data</td></tr><tr><td colspan="1" rowspan="1">Customer Activity</td><td colspan="1" rowspan="1">Tracks CRM engagement events</td></tr></tbody></table><h2>Marketing Attribution</h2>Once connected, Linkkit can attribute HubSpot leads and conversions to:<ul><li>Referral campaigns </li><li>Affiliate links </li><li>Paid advertisements </li><li>Email marketing campaigns </li><li>Social media traffic </li><li>Deep links and QR campaigns </li></ul>This helps teams understand which channels generate the most qualified leads and revenue. &lt;!-- Image 5 goes here --&gt; <h2>Automation Workflows</h2>HubSpot workflows combined with Linkkit tracking allow businesses to:<ul><li>Automatically assign leads </li><li>Trigger onboarding emails </li><li>Update deal stages </li><li>Notify sales teams </li><li>Track customer lifecycle stages </li><li>Automate CRM follow-ups </li></ul>Many businesses also use automation tools like Zapier or Make for additional workflow customization.<h2>Best Practices</h2>For reliable HubSpot attribution tracking:<ul><li>Keep customer IDs consistent </li><li>Track leads before sales events </li><li>Map CRM properties carefully </li><li>Test workflows before publishing </li><li>Use webhook-based updates when possible </li></ul>HubSpot developers often recommend planning data models and object relationships early to avoid future sync issues.<h2>Common Use Cases</h2>The HubSpot integration is commonly used for:<ul><li>SaaS lead tracking </li><li>CRM attribution reporting </li><li>Marketing automation </li><li>Affiliate program tracking </li><li>Customer lifecycle analytics </li><li>Revenue operations workflows </li></ul><h2>Why Use Linkkit with HubSpot?</h2>Linkkit helps businesses connect marketing performance with CRM data and real revenue outcomes.With HubSpot and Linkkit together, you can:<ul><li>Track the complete customer journey </li><li>Measure campaign ROI </li><li>Improve lead attribution </li><li>Monitor conversion funnels </li><li>Align marketing and sales teams </li></ul>Built for modern growth-focused businesses, Linkkit makes HubSpot attribution and CRM tracking simple, scalable, and automation-friendly.

HubSpot Integration

Third party integration 

Learn how to create and manage deep links in Linkkit for mobile applications, including support for React Native, iOS, and Android.Deep links allow users to open specific screens or content directly inside your mobile app instead of landing on a generic homepage or browser page.With Linkkit Deep Links, you can:<ul><li>Open app content directly from short links</li><li>Redirect users to the App Store or Play Store if the app is not installed</li><li>Track deep link clicks and opens</li><li>Build seamless mobile onboarding experiences</li><li>Replace Firebase Dynamic Links with your own branded links</li></ul><h2>Availability</h2>Deep linking features require a Pro plan or higher.<h2>What Are Deep Links?</h2>Deep links are URLs that send users directly to a specific location inside your mobile app.For example:<ul><li>Product pages</li><li>User profiles</li><li>Checkout screens</li><li>Promotional campaigns</li><li>Referral pages</li></ul>Instead of opening a browser, the link launches the installed app and navigates users to the correct screen automatically.<h3>Example Use Case</h3>Imagine you're running a mobile ad campaign for a product inside your app.Instead of sending users to a website homepage, you can create a short Linkkit URL that:<ol><li>Opens the app directly if installed</li><li>Redirects users to the App Store or Play Store if not installed</li><li>Returns users to the exact product page after installation</li></ol>This creates a smoother user experience and improves conversion rates.<h2>Step 1: Configure Your Deep Link Domain</h2>Before creating deep links, you need to configure a custom deep link domain inside your Linkkit workspace.<h3>Add a Custom Domain</h3>Navigate to your workspace domain settings and add a custom domain for deep linking.Examples:<ul><li><code>yourapp.link</code></li><li><code>go.yourbrand.com</code></li><li><code>app.yourdomain.com</code></li></ul>You can use:<ul><li>Your existing domain</li><li>A branded <code>.link</code> domain</li><li>A dedicated mobile deep linking domain</li></ul><h3>Upload Deep Link Configuration Files</h3>After setting up your domain, configure platform-specific deep link verification files.These files are hosted automatically under the <code>/.well-known/</code> directory of your domain.<h3>iOS Configuration (apple-app-site-association)</h3>For iOS Universal Links, upload an <code>apple-app-site-association</code> file.<pre><code>{
 "applinks": {
 "apps": [],
 "details": [
 {
 "appID": "&lt;YOUR_TEAM_ID&gt;.&lt;YOUR_BUNDLE_IDENTIFIER&gt;",
 "paths": []
 }
 ]
 }
}</code></pre><h3>Important Note</h3>iOS may cache old configurations.If deep links stop working after updates, uninstall and reinstall the app to refresh the cached association file.<h3>Android Configuration (assetlinks.json)</h3>For Android App Links, upload a <code>assetlinks.json</code> file.<pre><code>[
 {
 "target": {
 "namespace": "android_app",
 "package_name": "YOUR_PACKAGE_NAME",
 "sha256_cert_fingerprints": []
 },
 "relation": ["delegate_permission/common.handle_all_urls"]
 }
]</code></pre><h3>Verify Your Configuration Files</h3>After uploading your files, confirm they are accessible publicly.<h3>Verification URLs</h3><h3>iOS</h3><pre><code>https://yourdomain.link/.well-known/apple-app-site-association</code></pre><h3>Android</h3><pre><code>https://yourdomain.link/.well-known/assetlinks.json</code></pre><h3>Allowlist Your Deep Link Domain</h3>Your mobile app must explicitly trust your deep link domain.<h3>iOS</h3>Enable Associated Domains in your app configuration.<h3>Android</h3>Enable and verify Android App Links.Without allowlisting, deep links will open in the browser instead of the app.<h2>Step 2: Create Deep Links</h2>Once your domain is configured, you can create short links that open specific screens inside your app.<h3>Set the Destination URL</h3>Create a new link inside the Linkkit dashboard and enter the destination URL.Example:<pre><code>https://yourapp.com/product/apple-macbook</code></pre>This URL should map to a screen or route inside your app.<h3>Configure a Short Link Slug</h3>You can:<ul><li>Create a custom slug </li><li>Generate a random slug </li><li>Use AI-generated slugs </li></ul>Example:<pre><code>yourdomain.link/apple-macbook</code></pre>If no slug is provided, Linkkit automatically generates one.<h3>Configure Device Targeting</h3>Device targeting lets you redirect users to the correct app store if the app is not installed.Examples:<ul><li>iOS users → App Store </li><li>Android users → Google Play Store </li></ul>This ensures users can still install the app before opening the deep link destination.<h2>Step 3: Handle Deep Links Inside Your App</h2>When users open a deep link, your app needs to detect and process the incoming URL.There are two main scenarios.<h3>Scenario 1: App Already Installed</h3>If the app is installed, the deep link opens your app directly.You can handle this manually or use the official Linkkit mobile SDKs.<h3>Option 1: Use the Linkkit Mobile SDK</h3>Supported platforms include:<ul><li>React Native </li><li>iOS (SwiftUI/UIKit) </li></ul>Example React Native initialization:<pre><code>import dub from "@linkkit/react-native";

dub.init({
 publishableKey: "&lt;LINKKIT_PUBLISHABLE_KEY&gt;",
 domain: "&lt;LINKKIT_DOMAIN&gt;",
});</code></pre>The SDK helps:<ul><li>Detect deep links </li><li>Track opens automatically </li><li>Retrieve destination URLs </li><li>Handle deferred deep linking</li></ul><h3>Option 2: Handle Deep Links Manually</h3>You can manually listen for incoming URLs in your app.<h3>React Native Example</h3><pre><code>import { Linking } from "react-native";

Linking.addEventListener("url", (event) =&gt; {
 handleDeepLink(event.url);
});</code></pre>You should also handle the initial launch URL:<pre><code>const url = await Linking.getInitialURL();</code></pre><h3>Track Deep Link Opens</h3>After detecting a deep link, send the URL to the Linkkit tracking endpoint.<h3>Request</h3><pre><code>{
 "deepLink": "https://yourdomain.link/short-link"
}</code></pre><h3>Example Request</h3><pre><code>async function trackDeepLinkClick(deepLink) {
 const response = await fetch("https://api.linkkit.co/track/open", {
 method: "POST",
 headers: {
 "Content-Type": "application/json",
 },
 body: JSON.stringify({
 deepLink,
 }),
 });

 const data = await response.json();

 const destinationUrl = data.link.url;

 // Navigate inside your app
}</code></pre>The API response includes:<ul><li>Click ID </li><li>Link information </li><li>Final destination URL</li></ul><h3>Scenario 2: App Not Installed</h3>If the user does not have the app installed:<ol><li>Linkkit redirects them to the App Store or Play Store </li><li>The user installs the app </li><li>Deferred deep linking restores the original destination after installation </li></ol>This allows users to continue seamlessly to the intended content.<h3>Testing Deep Links</h3>Always test deep links before production deployment.<h3>Test on Android Emulator</h3><pre><code>adb shell am start -W -a android.intent.action.VIEW -d "https://yourdomain.link/your-short-link" com.yourpackage.name</code></pre><h3>Test on iOS Simulator</h3><pre><code>xcrun simctl openurl booted "https://yourdomain.link/your-short-link"</code></pre><h3>Test on Real Devices</h3>You can also test deep links by sending links through:<ul><li>WhatsApp </li><li>Telegram </li><li>Messages </li><li>Slack </li><li>Email </li></ul>Then tap the link directly from the app.<h2>Troubleshooting Deep Links</h2>If your deep links are not working correctly, check the following common issues.<h2>Domain Not Allowlisted</h2>Ensure your domain is properly configured inside both iOS and Android app settings.<h2>Cached Configuration Files</h2>Mobile operating systems often cache association files.Try reinstalling the app after updating:<ul><li><code>apple-app-site-association</code> </li><li><code>assetlinks.json</code> </li></ul><h2>Links Wrapped by Third-Party Platforms</h2>Some email providers, ad platforms, and tracking tools rewrite URLs.When this happens, deep linking can break because the original domain changes.Use direct Linkkit URLs whenever possible.<h2>iOS URL Handler Conflicts</h2>Some third-party SDKs may intercept deep links before Linkkit processes them.Avoid using short-circuit URL handlers that prevent multiple SDKs from receiving URLs.<h3>Incorrect Example</h3><pre><code>return sdkHandler(url) || linkkitHandler(url);</code></pre><h3>Correct Example</h3><pre><code>BOOL sdkHandled = sdkHandler(url);
BOOL linkkitHandled = linkkitHandler(url);

return sdkHandled || linkkitHandled;</code></pre>This ensures all handlers receive the deep link properly.<h2>Build Seamless Mobile Experiences</h2>With Linkkit Deep Links, you can:<ul><li>Improve mobile onboarding </li><li>Increase app conversions </li><li>Create smoother user journeys </li><li>Track deep link engagement </li><li>Replace Firebase Dynamic Links </li><li>Deliver personalized in-app experiences </li></ul>Deep linking helps bridge the gap between web, mobile, and marketing campaigns while creating a seamless experience for users across platforms.

Deep Links Quickstart

Learn how to implement deferred deep linking in Linkkit to track users even when your app is not installed.Deferred deep linking allows you to preserve the original deep link experience after a user installs your app from the App Store or Google Play Store.This enables seamless onboarding flows, better attribution tracking, and personalized in-app experiences.<h2>Availability</h2>Deferred deep linking requires a Pro plan or higher.<h2>What Is Deferred Deep Linking?</h2>Deferred deep linking ensures users are redirected to the correct screen inside your app, even if they install the app after clicking a deep link.Without deferred deep linking:<ol><li>User clicks a deep link</li><li>App is not installed</li><li>User installs the app</li><li>Original context is lost</li></ol>With Linkkit Deferred Deep Linking:<ol><li>User clicks a deep link</li><li>User installs the app</li><li>Linkkit restores the original destination</li><li>User lands on the intended screen automatically</li></ol><h3>Common Use Cases</h3><ul><li>Product onboarding flows</li><li>Referral systems</li><li>Mobile ad campaigns</li><li>Affiliate attribution</li><li>Personalized onboarding</li><li>Conversion tracking</li><li>Re-engagement campaigns</li></ul><h2>Android Deferred Deep Linking</h2>Android supports deferred deep linking through the Google Play Install Referrer API.This allows your app to retrieve install attribution data after installation.<h2>How Android Deferred Deep Linking Works</h2><h3>Flow Overview</h3><ol><li>User clicks a Linkkit deep link</li><li>User does not have the app installed</li><li>Linkkit redirects the user to Google Play</li><li>User installs and opens the app</li><li>The app retrieves install referrer data</li><li>Linkkit restores the original deep link</li><li>User is redirected to the correct screen</li></ol><h3>Understanding the Referrer URL</h3>When redirecting to the Play Store, Linkkit embeds the deep link inside the referrer parameter.Example:<pre><code>https://play.google.com/store/apps/details?id=com.example.app&amp;referrer=deepLink%3Dhttps%253A%252F%252Fapp.linkkit.co%252Fabc123</code></pre>To retrieve the original deep link:<ol><li>Extract the <code>referrer</code> parameter </li><li>Decode the URL </li><li>Extract the <code>deepLink</code> value </li><li>Decode again to retrieve the original URL </li></ol><h2>Step 1: Install the Referrer Dependency</h2><h3>React Native</h3><pre><code>{
 "dependencies": {
 "react-native-play-install-referrer": "latest"
 }
}</code></pre><h2>Step 2: Implement Install Referrer Tracking</h2><h3>React Native Example</h3><pre><code>import { PlayInstallReferrer } from "react-native-play-install-referrer";

class InstallReferrerTracker {
 async trackInstallReferrer() {
 PlayInstallReferrer.getInstallReferrerInfo(async (info, error) =&gt; {
 if (error) return;

 const referrer = info.installReferrer;

 if (!referrer) return;

 const deepLink = this.extractDeepLink(referrer);

 if (deepLink) {
 await this.trackDeepLinkOpen(deepLink);
 }
 });
 }

 extractDeepLink(referrerUrl) {
 try {
 const url = new URL(referrerUrl);
 const deepLink = url.searchParams.get("deepLink");

 return decodeURIComponent(deepLink);
 } catch (error) {
 console.error(error);
 return null;
 }
 }

 async trackDeepLinkOpen(deepLink) {
 const response = await fetch(
 "https://api.linkkit.co/track/open",
 {
 method: "POST",
 headers: {
 "Content-Type": "application/json",
 },
 body: JSON.stringify({
 deepLink,
 }),
 },
 );

 const data = await response.json();

 const destinationURL = data.link.url;

 this.navigate(destinationURL);
 }

 navigate(destinationURL) {
 console.log("Navigate to:", destinationURL);
 }
}</code></pre><h2>Step 3: Initialize the Tracker</h2>Run the install referrer tracker when your app launches.<pre><code>import React, { useEffect } from "react";
import InstallReferrerTracker from "./InstallReferrerTracker";

export default function App() {
 useEffect(() =&gt; {
 const tracker = new InstallReferrerTracker();

 tracker.trackInstallReferrer();
 }, []);

 return null;
}</code></pre><h2>Step 4: Handle Navigation</h2>After retrieving the destination URL, navigate users to the correct screen.<pre><code>navigate(destinationURL) {
 const url = new URL(destinationURL);

 if (url.pathname.includes("/product/")) {
 const productId = url.pathname.split("/product/")[1];

 navigation.navigate("Product", {
 productId,
 });
 } else {
 navigation.navigate("Home");
 }
}</code></pre><h2>Important Android Notes</h2><h3>First Launch Only</h3>Install referrer data is typically available only on the first launch after installation.Avoid duplicate tracking.<h3>Handle URL Decoding Carefully</h3>The referrer string may be encoded multiple times.Always decode safely before extracting values.<h3>Use Background Threads</h3>Network requests and tracking operations should not block the UI thread.<h3>Test Thoroughly</h3>Use Google Play internal testing tracks for accurate deferred deep link testing.<h2>iOS Deferred Deep Linking</h2>Unlike Android, iOS does not provide a native install referrer API.Linkkit uses a hybrid deferred deep linking system combining:<ul><li>Clipboard-based tracking </li><li>IP-based matching </li></ul>This improves reliability across iOS installations.<h2>How iOS Deferred Deep Linking Works</h2>When a user clicks a Linkkit deep link without the app installed:<ol><li>User lands on a Linkkit landing page </li><li>User chooses an install option </li><li>Linkkit stores attribution data </li><li>User installs the app </li><li>Linkkit restores the original deep link after app launch </li></ol><h2>iOS Tracking Methods</h2>Linkkit supports two deferred deep linking approaches on iOS.<h3>1. Clipboard-Based Tracking</h3>This is the most reliable iOS deferred deep linking method.<h3>Flow Overview</h3><ol><li>User taps Get the App </li><li>Linkkit copies the deep link to the clipboard </li><li>User installs the app </li><li>App reads the clipboard </li><li>App tracks the deep link open </li><li>User is redirected to the intended screen</li></ol><h3>Clipboard-Based Tracking Example</h3><pre><code>import Clipboard from "@react-native-clipboard/clipboard";

const clipboard = await Clipboard.getString();

if (clipboard.includes("yourdomain.link")) {
 requestBody = {
 deepLink: clipboard,
 };
}</code></pre><h2>2. IP-Based Tracking</h2>If clipboard access is unavailable or denied, Linkkit falls back to IP matching.<h3>Flow Overview</h3><ol><li>User taps Get the App without Copying </li><li>User installs the app </li><li>App sends the Linkkit domain </li><li>Linkkit matches the install using IP-based attribution </li><li>Destination URL is restored </li></ol><h2>Track Deep Link Opens on iOS</h2><h3>React Native Example</h3><pre><code>async function trackOpen() {
 const clipboard = await Clipboard.getString();

 let requestBody;

 if (clipboard &amp;&amp; clipboard.includes("yourdomain.link")) {
 requestBody = {
 deepLink: clipboard,
 };
 } else {
 requestBody = {
 dubDomain: "yourdomain.link",
 };
 }

 const response = await fetch(
 "https://api.linkkit.co/track/open",
 {
 method: "POST",
 headers: {
 "Content-Type": "application/json",
 },
 body: JSON.stringify(requestBody),
 },
 );

 const data = await response.json();

 return data.link?.url;
}</code></pre><h3>Handle Navigation After Install</h3>Once the destination URL is resolved, route users inside your app.<pre><code>if (path.includes("/product/")) {
 navigation.navigate("Product", {
 productId,
 });
} else {
 navigation.navigate("Home");
}</code></pre><h2>Important iOS Notes</h2><h3>Clipboard Permissions</h3>Users may deny clipboard access.Always implement fallback logic using IP-based matching.<h3>IP Matching Limitations</h3>IP tracking may be less reliable on:<ul><li>VPNs </li><li>Shared Wi-Fi </li><li>Corporate networks </li><li>Mobile carrier NATs</li></ul><h3>Respect User Privacy</h3>Ensure clipboard usage complies with App Store privacy guidelines.<h3>Test Using TestFlight</h3>Always test deferred deep linking flows in production-like environments.<h2>Best Practices</h2>For reliable deferred deep linking:<ul><li>Configure deep links correctly first </li><li>Test both install and re-open flows </li><li>Use clipboard tracking when possible </li><li>Always implement fallback logic </li><li>Handle network failures gracefully </li><li>Track only on first launch </li><li>Validate destination URLs before navigation </li></ul><h2>Related Features</h2>Deferred deep linking works seamlessly with other Linkkit features, including:<ul><li>Deep links </li><li>Device targeting </li><li>Conversion tracking </li><li>UTM analytics </li><li>Campaign attribution </li><li>Real-time analytics </li><li>Mobile SDKs </li></ul>Together, these tools help create seamless mobile experiences while improving attribution accuracy and user onboarding flows.

Deferred Deep Linking

Learn how to track deep link conversions and attribution events in Linkkit to measure installs, signups, purchases, and in-app revenue generated from your links. Linkkit’s attribution system helps you understand how your deep links contribute to real business outcomes inside your mobile application. With conversion attribution, you can track:<ul><li>App installs</li><li>User signups</li><li>Leads</li><li>Purchases</li><li>Subscription upgrades</li><li>Revenue generated from campaigns</li><li>Customer acquisition performance</li></ul><h2>Availability</h2>Deep link attribution requires a Business plan or higher.<h2>Supported Platforms</h2>Currently supported:<ul><li>React Native</li><li>iOS (Swift)</li></ul>Android support is coming soon.<h2>What Is Deep Link Attribution?</h2>Deep link attribution connects user actions inside your app back to the original deep link click.This allows you to measure:<ul><li>Which campaigns generate users</li><li>Which links drive conversions</li><li>Which traffic sources generate revenue</li><li>How users move through your funnel</li></ul>Instead of tracking only clicks, Linkkit helps you track the full conversion journey.<h2>Conversion Funnel Tracking</h2>With Linkkit Attribution, you can measure the complete funnel:<pre><code>Click → App Open → Lead → Sale</code></pre>This gives you deeper visibility into campaign performance and customer behavior.<h2>Prerequisites</h2>Before tracking conversions, you need to enable conversion tracking.If you're using partner links, conversion tracking may already be enabled automatically.<h2>Enable Conversion Tracking</h2>You can enable conversion tracking in three ways:<ul><li>Workspace-level tracking </li><li>Link-level tracking </li><li>API-based tracking </li></ul>Once enabled, Linkkit can start associating conversions with deep link clicks.<h2>Generate a Publishable Key</h2>To track conversions from the client side, generate a publishable key from your workspace settings.Navigate to:<pre><code>Workspace Settings → Tracking → Publishable Key</code></pre>Create and copy your publishable key for SDK initialization.<h2>Step 1: Install the Mobile SDK</h2>Install the Linkkit mobile SDK for your platform.<h3>React Native Installation</h3><h3>npm</h3><pre><code>npm install @linkkit/react-native</code></pre><h3>yarn</h3><pre><code>yarn add @linkkit/react-native</code></pre><h3>pnpm</h3><pre><code>pnpm add @linkkit/react-native</code></pre><h2>Initialize the SDK</h2>The SDK must be initialized before tracking events.You can initialize it using either the provider method or manual initialization.<h3>Option 1: Use LinkkitProvider</h3><pre><code>import { LinkkitProvider } from "@linkkit/react-native";

export default function App() {
 return (
 &lt;LinkkitProvider
 publishableKey="&lt;LINKKIT_PUBLISHABLE_KEY&gt;"
 linkkitDomain="&lt;LINKKIT_DOMAIN&gt;"
 &gt;
 {/* App Content */}
 &lt;/LinkkitProvider&gt;
 );
}</code></pre><h3>Option 2: Manual Initialization</h3><pre><code>import { useEffect } from "react";
import linkkit from "@linkkit/react-native";

export default function App() {
 useEffect(() =&gt; {
 linkkit.init({
 publishableKey: "&lt;LINKKIT_PUBLISHABLE_KEY&gt;",
 domain: "&lt;LINKKIT_DOMAIN&gt;",
 });
 }, []);
}</code></pre><h2>Step 2: Track Deep Link Open Events</h2>After initialization, start tracking deep link opens and deferred deep link opens.The <code>trackOpen()</code> method should be called:<ul><li>Once during first app launch </li><li>Again whenever the app opens from a deep link </li></ul><h3>React Native Example</h3><pre><code>import { useEffect } from "react";
import { Linking } from "react-native";
import AsyncStorage from "@react-native-async-storage/async-storage";
import linkkit from "@linkkit/react-native";

export default function App() {
 useEffect(() =&gt; {
 async function initialize() {
 linkkit.init({
 publishableKey: "&lt;LINKKIT_PUBLISHABLE_KEY&gt;",
 domain: "&lt;LINKKIT_DOMAIN&gt;",
 });

 const isFirstLaunch =
 await AsyncStorage.getItem("is_first_launch");

 if (isFirstLaunch === null) {
 await handleFirstLaunch();

 await AsyncStorage.setItem(
 "is_first_launch",
 "false",
 );
 } else {
 const url = await Linking.getInitialURL();

 if (url) {
 await handleDeepLink(url);
 }
 }

 const listener = Linking.addEventListener(
 "url",
 (event) =&gt; {
 handleDeepLink(event.url);
 },
 );

 return () =&gt; {
 listener.remove();
 };
 }

 initialize();
 }, []);
}</code></pre><h2>Deep Link Resolution Response</h2>If Linkkit successfully matches the deep link click, the response includes:<ul><li>Destination URL </li><li>Click ID </li><li>Link metadata </li></ul>The destination URL can be used for in-app navigation.The click ID is automatically stored by the SDK for future attribution events.<h3>Step 3: Track Conversion Events</h3>After tracking deep link opens, you can record conversion events such as:<ul><li>User registrations </li><li>Purchases </li><li>Subscription upgrades </li><li>Paid conversions </li></ul>Linkkit supports two primary conversion event types:<ul><li>Leads </li><li>Sales </li></ul><h2>Track Leads</h2>Use <code>trackLead()</code> to record lead or signup events.<pre><code>import linkkit from "@linkkit/react-native";

async function trackLead(user) {
 try {
 await linkkit.trackLead({
 eventName: "User Sign Up",
 customerExternalId: user.id,
 customerName: user.name,
 customerEmail: user.email,
 });
 } catch (error) {
 console.error(error);
 }
}</code></pre><h2>Track Sales</h2>Use <code>trackSale()</code> to record purchases and revenue events.<pre><code>import linkkit from "@linkkit/react-native";

async function trackSale(user, product) {
 try {
 await linkkit.trackSale({
 customerExternalId: user.id,
 amount: product.price.amount,
 currency: "usd",
 eventName: "Purchase",
 });
 } catch (error) {
 console.error(error);
 }
}</code></pre><h2>Server-Side Conversion Tracking</h2>You can also send conversion events from your backend.This is useful for:<ul><li>Secure revenue tracking </li><li>Backend validation </li><li>Subscription systems </li><li>Webhook-based billing flows </li></ul>To do this:<ol><li>Retrieve the <code>clickId</code> </li><li>Send it to your backend </li><li>Call the appropriate API endpoint </li></ol>Supported endpoints:<pre><code>POST /track/lead
POST /track/sale</code></pre><h2>Step 4: View Attribution Analytics</h2>All tracked conversion data becomes available in your Linkkit Analytics dashboard.<h3>Analytics Views</h3>Linkkit provides multiple reporting views to analyze attribution performance.<h2>Time-Series Analytics</h2>Visualize clicks, leads, and sales over time.Examples:<ul><li>Daily conversions </li><li>Revenue growth </li><li>Campaign trends </li><li>User acquisition patterns </li></ul><h2>Funnel Analytics</h2>Track drop-off between stages:<pre><code>Clicks → Leads → Sales</code></pre>This helps identify where users leave the conversion journey.<h2>Real-Time Event Stream</h2>Monitor live attribution events across all your links.The real-time feed displays:<ul><li>New clicks </li><li>Signups </li><li>Purchases </li><li>Revenue events </li><li>Attribution activity </li></ul><h3>Common Attribution Use Cases</h3>Deep link attribution is ideal for:<ul><li>Mobile growth campaigns </li><li>Influencer marketing </li><li>Affiliate tracking </li><li>Referral systems </li><li>Paid advertising attribution </li><li>Subscription analytics </li><li>Product onboarding flows </li></ul><h2>Best Practices</h2>For accurate attribution tracking:<ul><li>Initialize the SDK early </li><li>Track deep link opens immediately </li><li>Persist click IDs securely </li><li>Avoid duplicate conversion events </li><li>Validate purchase data server-side </li><li>Use descriptive event names </li><li>Track conversions consistently across platforms </li></ul><h2>Privacy &amp; Security Considerations</h2>When tracking attribution events:<ul><li>Avoid storing unnecessary personal data </li><li>Respect platform privacy guidelines </li><li>Use secure backend validation for purchases </li><li>Handle attribution data responsibly </li></ul><h2>Build Better Attribution Workflows</h2>With Linkkit Deep Link Attribution, you can:<ul><li>Understand user acquisition performance </li><li>Measure campaign ROI </li><li>Track revenue generated from links </li><li>Optimize conversion funnels </li><li>Build advanced analytics dashboards </li><li>Improve mobile growth strategies </li></ul>By connecting deep links to real business outcomes, Linkkit helps you make smarter product and marketing decisions with reliable attribution data.

Deep Link Attribution

Deep Links 

Learn how to structure, group, and manage links inside Linkkit using external IDs, tenants, tags, and folders.As your application grows, managing links efficiently becomes essential. Linkkit provides multiple ways to organize links so you can easily associate them with users, teams, campaigns, clients, or any custom entity in your system.Whether you're building a referral platform, multi-tenant SaaS, or campaign management tool, Linkkit gives you flexible organization methods designed for scalable workflows.<h2>Organization Methods</h2><table class="border-collapse table-auto w-full" style="min-width: 100px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Method</th><th colspan="1" rowspan="1">Relationship Type</th><th colspan="1" rowspan="1">Description</th><th colspan="1" rowspan="1">Best For</th></tr><tr><td colspan="1" rowspan="1">External ID</td><td colspan="1" rowspan="1">One-to-one</td><td colspan="1" rowspan="1">Unique identifier from your own system</td><td colspan="1" rowspan="1">User referral links, custom mapping</td></tr><tr><td colspan="1" rowspan="1">Tenant ID</td><td colspan="1" rowspan="1">One-to-many</td><td colspan="1" rowspan="1">Groups links by workspace, team, or user</td><td colspan="1" rowspan="1">Multi-tenant applications</td></tr><tr><td colspan="1" rowspan="1">Tags</td><td colspan="1" rowspan="1">Many-to-many</td><td colspan="1" rowspan="1">Flexible labels for categorization</td><td colspan="1" rowspan="1">Campaigns, filtering, analytics</td></tr><tr><td colspan="1" rowspan="1">Folders</td><td colspan="1" rowspan="1">One-to-many</td><td colspan="1" rowspan="1">Hierarchical link organization</td><td colspan="1" rowspan="1">Structured link management</td></tr></tbody></table><h2>External ID</h2>External IDs allow you to connect Linkkit links directly with records inside your own database.Instead of storing the internal Linkkit link ID, you can attach your own unique identifier to each link. This makes it easier to sync links with users, referral systems, products, or other entities inside your application.<h3>Common Use Cases</h3><ul><li>Referral links</li><li>User-specific short URLs</li><li>CRM integrations</li><li>Internal database mapping</li><li>Customer tracking systems</li></ul><h3>Important Notes</h3><ul><li><code>externalId</code> must be unique across your workspace</li><li>Creating a duplicate external ID returns a <code>409 Conflict</code> error</li><li>External IDs simplify retrieval and analytics queries</li></ul><h2>Create a Link with externalId</h2><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const link = await linkkit.links.create({
 url: "https://example.com",
 externalId: "user_12345",
});</code></pre><h2>Retrieve a Link by externalId</h2><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const link = await linkkit.links.get({
 externalId: "user_12345",
});</code></pre><h2>Update a Link Using externalId</h2>You can update links directly using the external ID instead of the Linkkit link ID.When updating, prefix the external ID with <code>ext_</code>.Example:<ul><li>Original external ID: <code>user_12345</code> </li><li>Update identifier: <code>ext_user_12345</code></li></ul><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const link = await linkkit.links.update("ext_user_12345", {
 url: "https://new-example.com",
});</code></pre><h2>Retrieve Analytics by externalId</h2>Fetch analytics data using your own system identifier.This is useful for dashboards, referral tracking, or user-level reporting.<pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const analytics = await linkkit.analytics.retrieve({
 externalId: "ext_user_12345",
});</code></pre><h2>Tenant ID</h2>Tenant IDs help group links created by a specific user, workspace, organization, or team.This is especially useful in multi-tenant applications where multiple users manage their own links inside the same platform.<h3>Common Use Cases</h3><ul><li>SaaS platforms </li><li>Team-based dashboards </li><li>Agency/client systems </li><li>Workspace-level organization </li><li>User-specific link grouping </li></ul><h2>Create a Link with tenantId</h2><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const link = await linkkit.links.create({
 url: "https://example.com",
 tenantId: "team_123",
});</code></pre><h2>Retrieve Links by tenantId</h2><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.links.list({
 tenantId: "team_123",
});</code></pre><h2>Retrieve Analytics by tenantId</h2><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const analytics = await linkkit.analytics.retrieve({
 tenantId: "team_123",
});</code></pre><h2>Tags</h2>Tags provide a flexible way to categorise and filter links across different campaigns, users, or workflows.Unlike folders, tags support many-to-many relationships, allowing a single link to belong to multiple categories at once.<h3>Benefits of Tags</h3><ul><li>Organize campaign links </li><li>Group links by client or project </li><li>Filter analytics instantly </li><li>Build advanced reporting systems </li><li>Create shareable filtered views </li></ul><h2>Create a Link with Tags</h2>You can assign tags using either tag IDs or tag names.<pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const link = await linkkit.links.create({
 url: "https://example.com",
 tagIds: ["tag_xxx"],
});</code></pre><h2>Retrieve Links by Tags</h2><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.links.list({
 tagNames: ["summer-campaign"],
});</code></pre><h2>Retrieve Analytics by Tags</h2><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const analytics = await linkkit.analytics.retrieve({
 tagIds: ["tag_xxx"],
});</code></pre><h2>Folders</h2>Folders help organize links into structured directories for easier navigation and management.Unlike tags, folders create a hierarchical organization system similar to file management.<h2>Benefits of Folders</h2><ul><li>Keep projects organized </li><li>Structure large link collections </li><li>Separate campaigns by directory </li><li>Improve dashboard navigation </li><li>Simplify team collaboration </li></ul><h2>Create a Link with folderId</h2><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const link = await linkkit.links.create({
 url: "https://example.com",
 folderId: "folder_xxx",
});</code></pre><hr><h2>Retrieve Links by folderId</h2><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.links.list({
 folderId: "folder_xxx",
});</code></pre><h2>Retrieve Analytics by folderId</h2><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const analytics = await linkkit.analytics.retrieve({
 folderId: "folder_xxx",
});</code></pre><h2>Best Practices</h2>For scalable link management inside Linkkit:<ul><li>Use <code>externalId</code> for direct database mapping </li><li>Use <code>tenantId</code> for multi-user systems </li><li>Use tags for flexible filtering and reporting </li><li>Use folders for structured organization </li><li>Combine tags and folders for advanced workflows </li></ul>Proper organization makes analytics, filtering, and large-scale link management significantly easier as your application grows.

Organizing Links

<blockquote>Learn how to use Linkkit to create, manage, update, and automate short links programmatically at scale.</blockquote><h2>Overview</h2>Links are the core foundation of the Linkkit platform.Every campaign, attribution workflow, and conversion event in Linkkit begins with a tracking link.Whether you are:<ul><li>Creating branded links for marketing campaigns</li><li>Managing affiliate and referral programs</li><li>Generating links for SMS campaigns</li><li>Automating short links through APIs</li><li>Tracking customer attribution at scale</li></ul>Linkkit provides a flexible infrastructure to handle everything from a few links to millions of tracked URLs.This guide explains the Linkkit link model, link management workflows, and how to create, update, and upsert links using the Linkkit API and SDKs.&lt;!-- Image 1 goes here --&gt;<h2>The Link Model</h2>Every Linkkit link contains a structured set of properties used for tracking, attribution, and analytics.<table class="border-collapse table-auto w-full" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Property</th><th colspan="1" rowspan="1">Description</th><th colspan="1" rowspan="1">Example</th></tr><tr><td colspan="1" rowspan="1"><code>id</code></td><td colspan="1" rowspan="1">Unique identifier for the link</td><td colspan="1" rowspan="1"><code>link_8HJ2LK90AZ12</code></td></tr><tr><td colspan="1" rowspan="1"><code>url</code></td><td colspan="1" rowspan="1">Destination URL users are redirected to</td><td colspan="1" rowspan="1"><code>https://example.com/home</code></td></tr><tr><td colspan="1" rowspan="1"><code>shortLink</code></td><td colspan="1" rowspan="1">Generated shortened tracking URL</td><td colspan="1" rowspan="1"><code>https://go.linkkit.io/demo</code></td></tr><tr><td colspan="1" rowspan="1"><code>domain</code></td><td colspan="1" rowspan="1">Domain associated with the short link</td><td colspan="1" rowspan="1"><code>go.linkkit.io</code></td></tr><tr><td colspan="1" rowspan="1"><code>key</code></td><td colspan="1" rowspan="1">Custom short link slug</td><td colspan="1" rowspan="1"><code>demo</code></td></tr></tbody></table>Linkkit also supports advanced features, including:<ul><li>Conversion tracking</li><li>Deep linking</li><li>Custom domains</li><li>Analytics tracking</li><li>Branded previews</li><li>Attribution monitoring</li><li>QR code campaigns</li></ul>&lt;!-- Image 2 goes here --&gt;<h2>SDK Support</h2>Linkkit provides SDKs and API access for multiple programming languages and frameworks.Supported environments include:<ul><li>Node.js</li><li>Go</li><li>Python</li><li>PHP</li><li>Ruby</li><li>REST APIs</li><li>Serverless environments</li></ul>These SDKs help developers automate link creation and campaign workflows efficiently.<h2>Create a Link</h2>Creating a short link in Linkkit requires only one mandatory field:<table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Required Field</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1"><code>url</code></td><td colspan="1" rowspan="1">The destination URL users should visit</td></tr></tbody></table>Once submitted, Linkkit automatically generates a trackable short URL.<h3>Node.js Example</h3><pre><code>import { Linkkit } from "getlinkkit";

export const linkkit = new Linkkit({
 token: process.env.LINKKIT_API_KEY,
});

const link = await linkkit.links.create({
 url: "https://example.com",
});</code></pre><h3>Go Example</h3><pre><code>package main

import (
 "context"
 linkkit "github.com/linkkit/linkkit-go"
)

func main() {
 client := linkkit.New("LINKKIT_API_KEY")

 client.Links.Create(context.Background(), map[string]interface{}{
 "url": "https://example.com",
 })
}</code></pre><h3>Python Example</h3><pre><code>import linkkit

client = linkkit.Linkkit(
 token="LINKKIT_API_KEY"
)

client.links.create({
 "url": "https://example.com"
})</code></pre><h3>PHP Example</h3><pre><code>&lt;?php

$linkkit = new Linkkit("LINKKIT_API_KEY");

$linkkit-&gt;links-&gt;create([
 "url" =&gt; "https://example.com"
]);</code></pre><h2>cURL Example</h2><pre><code>curl --request POST \
 --url https://api.linkkit.com/links \
 --header 'Authorization: Bearer YOUR_TOKEN' \
 --header 'Content-Type: application/json' \
 --data '{"url":"https://example.com"}'</code></pre> &lt;!-- Image 3 goes here --&gt;<h2>Update a Link</h2>Existing links can be updated anytime using the link ID.This allows businesses to:<ul><li>Change destination URLs </li><li>Update tracking settings </li><li>Modify campaign data </li><li>Edit metadata </li><li>Manage redirects dynamically </li></ul>You can update links using either:<ul><li>Internal Linkkit link IDs </li><li>External IDs from your own database </li></ul><h3>Node.js Update Example</h3><pre><code>const updatedLink = await linkkit.links.update(
 "link_8HJ2LK90AZ12",
 {
 url: "https://new-example.com",
 }
);</code></pre><h3>Python Update Example</h3><pre><code>client.links.update(
 "link_8HJ2LK90AZ12",
 {
 "url": "https://new-example.com"
 }
)</code></pre><h3>cURL Update Example</h3><pre><code>curl --request PATCH \
 --url https://api.linkkit.com/links/link_8HJ2LK90AZ12 \
 --header 'Authorization: Bearer YOUR_TOKEN' \
 --header 'Content-Type: application/json' \
 --data '{"url":"https://new-example.com"}'</code></pre> &lt;!-- Image 4 goes here --&gt; <h2>Upsert a Link</h2>Linkkit also supports upsert operations.Upsert combines:<ul><li>Link creation </li><li>Link updating </li></ul>into a single API request.If the link already exists, Linkkit updates it automatically.If the link does not exist, a new short link is created.This approach simplifies automation workflows and avoids duplicate links.<h3>Node.js Upsert Example</h3><pre><code>const link = await linkkit.links.upsert({
 url: "https://example.com",
});</code></pre><h3>Go Upsert Example</h3><pre><code>client.Links.Upsert(context.Background(), map[string]interface{}{
 "url": "https://example.com",
})</code></pre><h3>Python Upsert Example</h3><pre><code>client.links.upsert({
 "url": "https://example.com"
})</code></pre><h3>cURL Upsert Example</h3><pre><code>curl --request POST \
 --url https://api.linkkit.com/links/upsert \
 --header 'Authorization: Bearer YOUR_TOKEN' \
 --header 'Content-Type: application/json' \
 --data '{"url":"https://example.com"}'</code></pre> &lt;!-- Image 5 goes here --&gt; <h2>Benefits of Programmatic Link Management</h2>Using the Linkkit API helps businesses automate and scale link operations efficiently.<h3>Key Benefits</h3><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Feature</th><th colspan="1" rowspan="1">Benefit</th></tr><tr><td colspan="1" rowspan="1">Automated Link Creation</td><td colspan="1" rowspan="1">Generate links instantly</td></tr><tr><td colspan="1" rowspan="1">Dynamic Redirects</td><td colspan="1" rowspan="1">Update campaigns without changing URLs</td></tr><tr><td colspan="1" rowspan="1">Attribution Tracking</td><td colspan="1" rowspan="1">Monitor clicks and conversions</td></tr><tr><td colspan="1" rowspan="1">Campaign Analytics</td><td colspan="1" rowspan="1">Measure marketing performance</td></tr><tr><td colspan="1" rowspan="1">API Automation</td><td colspan="1" rowspan="1">Integrate into internal systems</td></tr><tr><td colspan="1" rowspan="1">Scalable Infrastructure</td><td colspan="1" rowspan="1">Handle large-scale campaigns</td></tr></tbody></table><h2>Common Use Cases</h2>Businesses commonly use Linkkit APIs for:<ul><li>Affiliate marketing systems </li><li>SMS campaign links </li><li>Email marketing attribution </li><li>QR code campaigns </li><li>Influencer tracking </li><li>SaaS onboarding links </li><li>Deep linking workflows </li><li>Dynamic campaign redirects </li></ul> &lt;!-- Image 6 goes here --&gt; <h2>Best Practices</h2>For better performance and scalability:<ul><li>Use custom domains for branded links </li><li>Enable conversion tracking </li><li>Store external IDs for synchronization </li><li>Use upsert for automated workflows </li><li>Organize links using tags and folders </li><li>Monitor analytics regularly </li></ul><h2>Why Use Linkkit?</h2>Linkkit provides a developer-friendly platform for link management, conversion tracking, and attribution analytics.With Linkkit, teams can:<ul><li>Create links programmatically </li><li>Automate marketing workflows </li><li>Track customer attribution </li><li>Monitor campaign performance </li><li>Scale link operations globally </li></ul>Designed for modern businesses and developers, Linkkit simplifies link infrastructure, analytics, and campaign automation in one centralized platform.

Links Introduction

Manage multiple short links in a single request using Linkkit Bulk Operations.Bulk actions help you save time when handling large numbers of links. Instead of sending repeated API requests, you can create, update, or remove multiple links simultaneously.This is especially useful for:<ul><li>Marketing campaigns</li><li>UTM management</li><li>Link migrations</li><li>Batch cleanup tasks</li><li>Automated workflows</li></ul><h2>Bulk Create Links</h2>Create up to 100 short links in one request.Bulk creation is ideal when importing links, generating campaign URLs, or automating large-scale link generation.<h3>Important Notes</h3><ul><li>Maximum: 100 links per request</li><li>Custom social previews are not supported in bulk creation</li><li>Webhook events are not triggered for bulk requests</li></ul><h2>Example</h2><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.links.createMany([
 {
 url: "https://example.com",
 },
 {
 url: "https://example.org",
 },
]);</code></pre>Use the Bulk Create endpoint to quickly generate multiple branded short links in a single API call.<h2>Bulk Update Links</h2>Update multiple links at once using the same configuration.Bulk updates are useful when you need to apply common settings across many links without editing them individually.<h3>Common Use Cases</h3><ul><li>Add tags to multiple links </li><li>Update UTM parameters </li><li>Set expiration dates </li><li>Modify link metadata </li><li>Organize campaign links </li></ul><h3>Important Notes</h3><ul><li>Maximum: 100 links per request </li><li>The <code>domain</code> and <code>slug/key</code> cannot be changed using bulk update </li><li>Webhook events are not triggered for bulk updates </li></ul><h3>Example</h3><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.links.updateMany({
 linkIds: ["lnk_123", "lnk_456"],
 data: {
 utm_source: "facebook",
 utm_medium: "cpc",
 },
});</code></pre>Bulk updating helps maintain consistency across campaigns and large link collections.<h2>Bulk Delete Links</h2>Delete multiple links in a single request.This operation is designed for fast cleanup of outdated, expired, or unused links.<h3>Important Notes</h3><ul><li>Maximum: 100 links per request </li><li>This action is permanent and cannot be undone </li><li>Webhook events are not triggered during bulk deletion </li></ul><h3>Example</h3><pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.links.deleteMany({
 linkIds: ["lnk_123", "lnk_456"],
});</code></pre>Use bulk deletion carefully, especially in production environments.<h2>Best Practices</h2>To ensure reliable bulk operations:<ul><li>Keep requests under the 100-link limit </li><li>Validate URLs before submission </li><li>Use batching for large imports </li><li>Test operations in development first </li><li>Avoid accidental deletions by verifying link IDs </li></ul><h2>API Reference</h2>Explore the complete API reference for:<ul><li>Bulk Create Links </li><li>Bulk Update Links </li><li>Bulk Delete Links </li></ul>Detailed request and response examples are available in the Linkkit API documentation.

Bulk Operations

Links API

Build powerful real-time analytics dashboards for your short links using the Linkkit Analytics API.The Analytics API gives you access to click tracking, conversion insights, traffic sources, geographic data, device analytics, and much more — directly inside your own application.Whether you're creating a marketing dashboard, SaaS reporting tool, affiliate platform, or campaign tracker, Linkkit provides flexible analytics endpoints designed for real-time data visualization and reporting.<h2>Availability</h2>Analytics API access requires a Pro plan or higher.<h2>Overview</h2>The Linkkit Analytics API allows you to retrieve analytics data for your links using different event types and grouping dimensions.You can analyze:<ul><li>Link clicks</li><li>Lead conversions</li><li>Sales performance</li><li>Traffic sources</li><li>Geographic insights</li><li>Device and browser usage</li><li>UTM campaign performance</li></ul>This makes it easy to build custom dashboards, reporting systems, and performance monitoring tools.<h2>Supported Event Types</h2><h3>The Analytics API supports the following event categories:</h3><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Event</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">clicks</td><td colspan="1" rowspan="1">Total clicks received by a link</td></tr><tr><td colspan="1" rowspan="1">leads</td><td colspan="1" rowspan="1">Leads generated through a link</td></tr><tr><td colspan="1" rowspan="1">sales</td><td colspan="1" rowspan="1">Sales or conversions attributed to a link</td></tr></tbody></table><h2>Supported Grouping Options</h2>Use the <code>groupBy</code> parameter to aggregate analytics data in different ways.<h2>Available Groupings</h2><table class="border-collapse table-auto w-full" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1">Group By</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">count</td><td colspan="1" rowspan="1">Returns total event count</td></tr><tr><td colspan="1" rowspan="1">timeseries</td><td colspan="1" rowspan="1">Returns analytics over time</td></tr><tr><td colspan="1" rowspan="1">top_links</td><td colspan="1" rowspan="1">Shows the highest-performing links</td></tr><tr><td colspan="1" rowspan="1">countries</td><td colspan="1" rowspan="1">Traffic grouped by country</td></tr><tr><td colspan="1" rowspan="1">cities</td><td colspan="1" rowspan="1">Traffic grouped by city</td></tr><tr><td colspan="1" rowspan="1">regions</td><td colspan="1" rowspan="1">Traffic grouped by region/state</td></tr><tr><td colspan="1" rowspan="1">continents</td><td colspan="1" rowspan="1">Traffic grouped by continent</td></tr><tr><td colspan="1" rowspan="1">devices</td><td colspan="1" rowspan="1">Device breakdown</td></tr><tr><td colspan="1" rowspan="1">browsers</td><td colspan="1" rowspan="1">Browser analytics</td></tr><tr><td colspan="1" rowspan="1">os</td><td colspan="1" rowspan="1">Operating system analytics</td></tr><tr><td colspan="1" rowspan="1">referrers</td><td colspan="1" rowspan="1">Referring platforms/domains</td></tr><tr><td colspan="1" rowspan="1">referer_urls</td><td colspan="1" rowspan="1">Exact referring URLs</td></tr><tr><td colspan="1" rowspan="1">utm_sources</td><td colspan="1" rowspan="1">UTM source tracking</td></tr><tr><td colspan="1" rowspan="1">utm_mediums</td><td colspan="1" rowspan="1">UTM medium tracking</td></tr><tr><td colspan="1" rowspan="1">utm_campaigns</td><td colspan="1" rowspan="1">UTM campaign performance</td></tr><tr><td colspan="1" rowspan="1">utm_terms</td><td colspan="1" rowspan="1">UTM keyword tracking</td></tr><tr><td colspan="1" rowspan="1">utm_contents</td><td colspan="1" rowspan="1">UTM content tracking</td></tr></tbody></table><h2>Retrieve Total Event Count</h2>Fetch the total number of events for a specific link. This is useful for displaying summary statistics such as total clicks, leads, or conversions.<pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "count",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>Retrieve Timeseries Analytics</h2>Get analytics data over time for charts, graphs, and traffic trends.Perfect for building visual dashboards and monitoring growth patterns.<pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "timeseries",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>Retrieve Top Performing Links</h2>Analyze which links generate the highest engagement or conversions.Useful for campaign optimization and performance tracking.<pre><code>import { Linkkit } from "linkkit";

export const linkkit = new Linkkit({
 apiKey: process.env.LINKKIT_API_KEY,
});

const result = await linkkit.analytics.retrieve({
 event: "clicks",
 groupBy: "top_links",
 linkId: "lnk_xxx",
 interval: "30d",
});</code></pre><h2>Real-Time Analytics Dashboards</h2>Using the Analytics API, you can create fully customized dashboards directly inside your application.<h3>Common Use Cases</h3><ul><li>Marketing campaign dashboards </li><li>SaaS analytics platforms </li><li>Affiliate tracking systems </li><li>Conversion reporting tools </li><li>Client reporting portals </li><li>Real-time traffic monitoring </li><li>UTM performance analysis </li></ul><h2>Analytics Features</h2>With Linkkit Analytics, you can:<ul><li>Monitor clicks in real time </li><li>Track leads and conversions </li><li>Analyze geographic traffic data </li><li>Measure campaign performance </li><li>Understand user devices and browsers </li><li>Track referral sources </li><li>Visualize traffic trends over time </li></ul><h2>Best Practices</h2>To build scalable analytics systems with Linkkit:<ul><li>Use <code>timeseries</code> for charts and visualizations </li><li>Combine UTM analytics with campaign tracking </li><li>Store analytics snapshots for long-term reporting </li><li>Filter analytics by tags, folders, or tenants </li><li>Use aggregation endpoints to reduce frontend processing </li></ul><h2>Build Custom Reporting Experiences</h2>The Analytics API is flexible enough to power:<ul><li>Internal admin dashboards </li><li>Public analytics portals </li><li>Customer-facing reports </li><li>Team performance tracking </li><li>White-label analytics platforms </li></ul>With real-time insights and flexible aggregation options, Linkkit makes it easy to deliver advanced link analytics inside any product.

Introduction

Core Features

Partner & Referral Programs

Marketing Attribution

Real-Time Analytics

Smart Short Links

Webhooks & Automation

Integrations & APIs

What Can You Do With Linkkit?

Launch a Partner Program

Track Conversion Events

Create Branded Short Links

Automate Workflows

Popular Integrations

Stripe

Shopify

Google Tag Manager

Zapier

HubSpot

Segment

SDKs & Developer Tools

Server-Side SDKs

Client-Side SDKs

Stay Updated

Blog

X / Twitter