How do I install the Decisa pixel on my site?

Create a pixel under Pixels, then open Custom Site under Integrations and paste the one-line snippet into your site — your first visit shows up as a click within seconds.

A pixel is the destination your site reports to (Meta, TikTok, or Google). The snippet is a single <script> tag that loads on every page, sets a first-party cookie, and records each pageview as a click — the thread that later ties orders back to your ads.

Before you start

• Access to a workspace. Installing the pixel is one of the actions that switches the Attribution module on.
• From your ad platform: the pixel's credential and its Conversions API token (you can add or rotate the token later). What counts as the credential depends on the platform — a Pixel ID for Meta, a Pixel code for TikTok, or a Google Ads customer ID for Google.
• A way to change your site — its HTML, your Shopify theme, Google Tag Manager — or an AI coding assistant such as Claude or ChatGPT to do it for you.

Steps

1. Create a pixel

   Use Sidebar → Attribution → Pixels and add a pixel: pick the platform (Meta, TikTok, or Google), give it a recognizable name, and paste in the platform's credentials and Conversions API token. Meta asks for a Pixel ID and TikTok for a Pixel code; Google identifies by customer ID instead, so the form adds a Customer ID field (your Google Ads customer ID) and leaves the external identifier optional. A workspace can hold several pixels — one per site or platform.

2. Open Custom Site and choose your pixels

   Use Sidebar → Integrations → Custom Site. The first step of the wizard lists your enabled pixels — select the ones this site should report to. The install snippet updates to match your selection.

3. Install the snippet

   Pick a path. The automatic option hands you a prompt that tells Claude, ChatGPT, or Cursor to read Decisa's live Markdown installation guide first, then install the pixel and wire server-side conversions/events using your selected pixel keys and server key. The manual option shows the same technical guide URL plus ready-to-paste snippets under HTML, Next.js, Shopify, and GTM; paste the snippet before the closing </head> tag of every page you want to track.

4. Verify the install

   Open your site in a browser, then check Sidebar → Attribution → Clicks — your visit appears within seconds, and the wizard marks the install step as done. The wizard's final step also offers a server-to-server option with a Live events panel that flips from Waiting to Receiving events and lists the last five clicks; Send test event delivers a test click and conversion instantly.

What happens next

• Every visit to your site is recorded under Clicks, with its UTM source, medium, and campaign.
• Purchases and signups you track later appear under Conversions, joined to the click that brought the visitor in.
• The server-to-server option also reveals your Site key — the secret your backend uses to send conversions straight to Decisa. Keep it on the server, never in page code; only workspace admins can view it.
• The manual guide URL is https://api.decisa.ai/v1/docs/attribution-installation.md in production. It covers pixel.js, /identify, /events, /conversions, visitor continuity, quality signals, CSP, and safe link decoration.

Gotchas