Server tracking quickstart

Server tracking is the recommended path for events your backend can verify, especially payments, subscriptions, renewals, and account creation. Your backend must enforce the user’s stored consent or other applicable legal basis before sending an event. Browser SDK consent controls do not automatically disable server SDK calls.

Before you start

Open Workspace settings -> Tracking and enable conversion tracking.
Open Workspace settings -> API Keys.
Create a Restricted key with Conversions -> Write.
Store the biqli_... key in a server secret or environment variable.
Capture the browser’s bq_id during signup or checkout.

BIQLI_API_KEY=biqli_xxxxxxxxxxxxxxxxxxxxxxxx

Never return this key to a browser or place it in a client bundle, URL, cookie, public repository, screenshot, or log.

TypeScript and Node.js

npm install @biqli/sdk

import {Biqli} from '@biqli/sdk';

const biqli = new Biqli({
  apiKey: process.env.BIQLI_API_KEY!,
});

await biqli.track.lead({
  clickId: request.cookies.bq_id,
  eventId: `signup:${customer.id}`,
  eventName: 'Signed up',
  customerExternalId: customer.id,
});

PHP

composer require biqli/sdk

use Biqli\Sdk\Biqli;

$biqli = new Biqli($_ENV['BIQLI_API_KEY']);

$biqli->track->sale([
    'clickId' => $_COOKIE['bq_id'] ?? null,
    'customerExternalId' => (string) $customer->id,
    'amount' => 4999,
    'currency' => 'usd',
    'paymentProcessor' => 'stripe',
    'invoiceId' => $invoice->id,
]);

Forward the click ID safely

Read bq_id in the browser and associate it with the authenticated signup, checkout, or customer session on your server. Do not accept a browser-supplied customer owner ID without authenticating it. After Biqli has attributed that customer, later events may omit clickId and use the same customerExternalId.

Retry safely

Official server SDKs retry temporary network errors and retryable HTTP responses with bounded backoff.

Give each lead a stable eventId.
Give each sale a stable paymentProcessor and invoiceId.
Keep the payload identical across retries.

Do not create a new identifier on every attempt.

Confirm the event

Open Customers, select the matching customer, and confirm the timeline shows the expected click, lead or sale, attribution link, amount, and source.

GETTING STARTED

BROWSER TRACKING

MOBILE DEEP LINKING

SERVER TRACKING

INTEGRATIONS

OPERATIONS

Server tracking quickstart

Before you start

TypeScript and Node.js

PHP

Forward the click ID safely

Retry safely

Confirm the event

​Before you start

​TypeScript and Node.js

​PHP

​Forward the click ID safely

​Retry safely

​Confirm the event

Before you start

TypeScript and Node.js

PHP

Forward the click ID safely

Retry safely

Confirm the event