zijra.Documentation
Get started

Install Zijra

Use your website’s actual public ID and collector origin.

Give your agent the complete setup task

Open your website repository in Cursor, Claude Code, Codex or another coding agent. Choose your saved website to copy the complete installation task or download its Markdown file. It preserves public tracker settings and includes framework detection, real action and consent examples, and a newly received visit check.

Choose your platform

Lovable installation

Inspect the generated framework before choosing the document file.

This is an example, not a connected installation. Sign in and select a saved website to get its real public ID and collector origin. Replace all example values before publishing.

  1. Open Code and identify the stack

    Current Lovable projects use TanStack Start; older projects may use React/Vite. Inspect package.json and the file tree. Manual code editing requires an eligible plan; a project-chat edit or your connected repository can apply the change.

  2. Install in the shared document

    For Vite, paste into root index.html before </head>. For TanStack Start, add the script once in the document shell in src/routes/__root.tsx, retaining HeadContent and Scripts. Convert HTML comments to JSX comments there.

    Code exampleHTML
    <script
      defer
      src="https://zijra.com/tracker.js"
      data-site-id="YOUR_PUBLIC_SITE_ID"
      data-ignore-query="true"
      data-ignore-hash="true"
      data-respect-privacy="true"
      data-collection-mode="aggregate"
    ></script>
    Preparing code…
  3. Review the change and publish

    Ask for only the tracker placement, review the actual file change, then publish. Open the published domain and test an internal link and Back; the editor preview can have a different origin.

Platform reference: Lovable code access · Lovable’s current and older stacks · TanStack Start document shell

Confirm a received visit

Open a published page on the domain saved in Zijra, keep it open briefly, then check installation. Success requires a pageview stored for this website. A loaded script, a green publish status or a fired tag alone does not establish that.

Check an internal navigation and Back as well. Zijra observes normal browser history changes after loading; it does not turn an unchanged URL, a tab switch or a component render into a new pageview. Hash-only routes are excluded unless you deliberately enable hash reporting.

Save a website to verify

If no visit arrives, check the published domain, collection status, excluded paths and whether the browser blocked the script or collector. Do Not Track and Global Privacy Control intentionally prevent collection when respected. Do not disable a visitor’s privacy choice to make verification pass.

Consent and additional domains

The snippet preserves the website’s saved collection mode. For visitor attribution, connect your consent manager to Zijra’s consent API and reapply the visitor’s current decision on each visit; granting access to a page is not attribution consent. Read the privacy and identity guide before sending names or profile images.

To collect from another subdomain or website domain, add its exact HTTPS origin in Website settings and install the same selected-site snippet there once. Allowed origins permit collection; they do not automatically join visitor identities across domains. Browser storage and consent do not transfer between unrelated origins.

Need a first-party collector path? Follow the proxy installation guide. Record successful actions through custom events, and connect verified sales separately through your payment provider.