LinkOps.linapp.ai documentation

Complete product guide for growth, routing, analytics, and operations

This guide documents the full LinkOps.linapp.ai workflow for operators, marketers, growth teams, and platform admins. It covers link creation, branded routing, analytics, dynamic QR, campaigns, landing pages, billing, workspace controls, developer API usage, and site administration.

Product overview

Commercial use guide

LinkOps.linapp.ai is a commercial link operations platform. It combines short links, branded domains, analytics, QR distribution, campaign tracking, landing pages, and controlled billing workflows in one workspace-driven system.

Who uses it

Marketing teams that need branded links and reporting.

Affiliate and acquisition operators that need route control and interstitials.

Agencies and multi-user workspaces managing multiple brands.

Internal platform teams that need plan enforcement and governance.

Core business outcomes

Centralize public-facing link infrastructure.

Measure traffic quality, source mix, device mix, and geography.

Ship campaigns, QR assets, and pages without fragmenting the stack.

Apply plan-based controls cleanly across customer workspaces.

Analytics

Advanced reporting

Analytics is built around real click events and workspace-level aggregation. It is intended for operational visibility, source review, traffic quality checks, and campaign analysis.

Overview metrics

  • Engagements and average daily traffic.
  • Active links and active QR assets in the workspace.
  • Distinct countries and referrer groups reached.
  • Suspicious click counts and clean traffic rate.

Highlights and dashboards

  • Top links, top referrers, top days, and top locations.
  • Saved dashboard modules for time series, devices, referrers, and locations.
  • Custom module ordering and module naming.
  • Filter by date range and available scoped dimensions.

How the data is produced

  • Public link clicks write device, browser, referrer, and location fields.
  • QR scans can feed the same analytics pipeline when tied to a short link.
  • Referrer groups are derived automatically from UTM source and HTTP referrer.
  • Locations use country and city fields collected at click time.

QR codes

Dynamic distribution

QR assets can operate as direct destination carriers or as dynamic routing assets. The commercial value is that the printed code can stay fixed while the destination changes.

Static QR operations

  • Create QR assets for URLs or short links.
  • Download and distribute the generated asset.
  • Keep QR management under plan-based controls.

Dynamic QR operations

  • Edit the QR target without regenerating the public-facing code.
  • Use a short link as the QR destination to inherit link logic and analytics.
  • Apply plan-level entitlement for dynamic target editing separately from basic QR access.

Campaigns

Commercial campaign operations

Campaigns provide a commercial wrapper around traffic, attribution, and execution. They can be used for launches, paid traffic, affiliate pushes, newsletters, and lifecycle reporting.

Campaign lifecycle

  • Create campaigns as draft, active, paused, completed, or archived.
  • Assign source, optional budget, objectives, notes, and start/end windows.
  • Duplicate successful campaigns into new drafts.
  • Use bulk actions to activate, pause, archive, or delete multiple campaigns.

Campaign analytics

  • Review tracked clicks, valid clicks, suspicious rate, unique visitors, and attributed links.
  • Inspect source, medium, browser, and country breakdowns.
  • Use performance trend cards to analyze campaign behavior over time.
  • Use budget only when you want commercial efficiency metrics such as cost per click.

How campaign attribution works

  • A campaign is not tied to only one short link by default.
  • Attribution is matched by utm_campaign in the click URL.
  • The campaign slug is the matching key used by the reporting system.
  • If multiple short links receive visits with the same utm_campaign value, all matching visits roll up into the same campaign.

Recommended flow

  • Create the campaign first and confirm the final slug.
  • Use that slug in every outbound URL as utm_campaign=<slug>.
  • Keep utm_source and utm_medium consistent across channels so breakdowns stay clean.
  • Check Reports / Logs first when validating new campaign traffic.

Campaign field reference

  • Name: Internal and external display label for the campaign record.
  • Slug: Canonical tracking key. This should match the value used in utm_campaign.
  • Primary source: Operator-facing hint for the main acquisition channel such as Google, Meta, Email, or Affiliate.
  • Status: Lifecycle state for operational control. Use draft before launch, active during execution, paused for temporary stops, completed after the run ends, and archived for historical records.
  • Budget: Optional commercial spend value used for cost efficiency metrics. Leave blank or zero if the campaign is not budget-managed.
  • Start window / End window: Optional planning dates for execution context. They do not create attribution by themselves.
  • Objective: Short strategic description such as lead generation, signups, product launch, or retargeting.
  • Notes: Internal planning notes, offer details, owner handoff notes, audience assumptions, or routing caveats.

UTM parameter guide for campaigns

UTM parameters are URL query parameters used to label inbound traffic. LinkOps currently reads these values from the public redirect request and stores them on the visit log.

  • utm_source: Where traffic came from, such as google, meta, linkedin, or newsletter.
  • utm_medium: The marketing method, such as cpc, social, email, or affiliate.
  • utm_campaign: The campaign tracking key. In LinkOps this should normally equal the campaign slug.
  • utm_term: Optional keyword or paid-search term. Useful outside the current campaign rollup, but still valid for downstream analytics tools.
  • utm_content: Optional creative or placement variant, such as button A, hero banner, or audience split.

Example: https://s.linapp.ai/a?utm_source=google&utm_medium=cpc&utm_campaign=spring-launch

Metric definitions

  • Tracked clicks: Total click events whose utm_campaign matches the campaign slug.
  • Valid clicks: Tracked clicks minus suspicious clicks.
  • Suspicious clicks: Events flagged by traffic quality logic.
  • Unique visitors: Distinct visitors approximated from tracked client IPs in the current implementation.
  • Attributed links: Distinct short links that generated visits for the same campaign slug.
  • Top sources / medium mix / device mix / top browsers / top countries: Breakdowns generated from stored visit metadata.

Cost metric formulas

  • CPC: budget / total clicks. This is shown only when budget is greater than zero and the campaign has clicks.
  • Cost / attributed click: budget / valid clicks. This uses non-suspicious clicks only.
  • If budget is blank or zero, cost metrics are intentionally left empty.
  • If no clicks are tracked yet, cost metrics are intentionally left empty.

Validation and troubleshooting

  • If Reports / Logs shows campaign values but Campaigns shows zero, refresh the Campaigns page after the backend has been updated.
  • If Reports / Logs does not show the visit, the public redirect request did not create a visit event.
  • If Reports / Logs shows a visit but the Campaign column is blank, the request did not include utm_campaign.
  • If the Campaign column shows a value that does not equal the campaign slug exactly, the visit will not roll up into that campaign.
  • Keep naming normalized, lowercase, and stable. Example: use spring-launch instead of changing between Spring, spring_launch, and spring.

Landing pages

Conversion surfaces

Pages give teams a controlled way to publish campaign or product surfaces inside the same system that owns routing and analytics.

Operational use

  • Publish landing pages tied to campaigns and branded links.
  • Use consistent messaging, SEO metadata, and public slugs.
  • Track page-linked traffic through the broader analytics system.

Custom domains

Brand operations

Custom domains are approval-gated to keep routing safe and auditable. Domains need to be approved and enabled before they can be used for public link creation or editing.

  • Submit domain records from the Custom Domains page.
  • Wait for site-admin approval.
  • Use persistent in-app reminders until the approval notice is dismissed.
  • Switch active links to approved custom domains when plan access allows it.

Workspace and invites

Team management

Workspaces isolate configuration, members, plans, analytics, domains, and public assets.

Members and roles

  • Invite colleagues with role-based access.
  • Track invite delivery, resend status, and invite links.
  • Restrict invite emails to supported addresses according to current platform policy.

Operational control

  • Switch workspaces from the workspace console.
  • Review role assignments and ownership transfer paths.
  • Use workspace-scoped plan enforcement across features and limits.

Billing and plans

Commercial controls

Billing is designed to keep the plan model, payment lifecycle, and workspace entitlements aligned.

Customer billing

  • Choose a plan from Billing and proceed to checkout.
  • Stripe is used for hosted payment completion.
  • Refund window and last payment data are shown in-app.
  • Plan entitlements continue to apply even if the Billing menu is hidden.

Plan enforcement

  • Feature access and numeric limits are enforced in both the UI and backend.
  • Unsupported features are disabled before requests are sent where possible.
  • Limit errors return specific plan, feature, and usage messages.

Developer API

Automation

The Developer API supports automation for links, analytics, campaigns, pages, and domain operations.

  • Create and manage API keys from the Developer API console.
  • Use plan-based API access and daily request quotas.
  • Automate short links, analytics reporting, campaigns, pages, and domain workflows.
  • Use the in-app API documentation together with backend API references.

Site admin

Platform governance

Site admin tools are designed for operators running the platform itself rather than a single customer workspace.

Plans and pricing

  • Enable, disable, or delete plans with in-use protections.
  • Bind Stripe price identifiers directly to plan definitions.
  • Configure feature entitlements and numeric limits with unlimited support.

Workspace control

  • Force a workspace onto another plan when needed.
  • Audit plan overrides and workspace state.
  • Review workspace owner email and effective limits.

Governance

  • Approve domains.
  • Review links, visits, audit logs, announcements, and configs.
  • Control billing visibility without breaking active entitlement enforcement.

Operating best practices

Recommended workflow
  • Use approved branded domains for public-facing campaigns whenever possible.
  • Keep production short links stable and rely on edit history for governed changes.
  • Use campaigns for commercial reporting, not only for naming convenience.
  • Route QR assets through short links when analytics continuity matters.
  • Keep plan entitlements aligned with the actual commercial offer shown on the homepage.
  • Use site-admin force-plan tools carefully and keep overrides intentional rather than permanent by default.