> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# PixelSetupElement

> Installerer Whop Pixel og kobler konverteringshændelser til: kopiér snippet'en, tjek en side for den, og bekræft, at hændelserne affyres. Montér den inline eller i dit eget overlay.

> [!NOTE]
>
> Denne side dokumenterer `@whop/elements@1.10.0` og `@whop/elements-react@1.10.0`.

*Siden `v1.0.0`.*

Monteres inde i [`Websites`](https://docs.whop.com/da/elements/latest/websites/overview). Send props og callbacks via create-indstillingerne eller React-props.

> [!NOTE]
>
> Du kan montere dette element **inline** (`create`) eller åbne det som et **modal**-overlay (`createOverlay`).

```tsx React theme={null}
import { WhopElements, Websites, PixelSetupElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Websites /* options */>
        <PixelSetupElement onRedirectUrlChanged={(e) => console.log(e)} onScanned={(e) => console.log(e)} onFinished={(e) => console.log(e)} onUrlSubmitted={(e) => console.log(e)} onVerifyLaunched={(e) => console.log(e)} onVerifyConnected={(e) => console.log(e)} onVerdict={(e) => console.log(e)} onEventVerified={(e) => console.log(e)} />
      </Websites>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const websites = window.WhopElements().websites.create({ /* options */ });
  websites.create('pixel-setup', {
    onRedirectUrlChanged: (e) => console.log(e),
    onScanned: (e) => console.log(e),
    onFinished: (e) => console.log(e),
    onUrlSubmitted: (e) => console.log(e),
    onVerifyLaunched: (e) => console.log(e),
    onVerifyConnected: (e) => console.log(e),
    onVerdict: (e) => console.log(e),
    onEventVerified: (e) => console.log(e)
  }).mount('#websites-pixel-setup');
</script>
```

Eksempeldata. [Åbn Playground](https://docs.whop.com/da/elements/latest/websites/overview#playground).

## Props

**accountId** `string`

Konto-ID med præfikset `biz_`, som pixlen tilhører. Påkrævet; snippet'en, scanningerne og invitationerne kører alle mod den. Standard er `""`.

**accessToken** `string`

Et afgrænset token til scanningerne og udvikler-invitationen. Scanningerne kræver `company:basic:read`; “Invite a developer” kræver desuden `authorized_user:create`, og hændelsesforudindstillingerne læser kontoen med `company:balance:read` (uden det virker guiden stadig, med en generisk liste over forudindstillinger). Når der ikke angives nogen `destinationUrl`, foreslår det tomme URL-felt også sider fra kontoens annoncer og pixeltrafik – de læsninger kræver `ad_campaign:basic:read` og `stats:read`, og uden dem er feltet blot tomt. Udsted det på din server med `POST /api/v1/access_tokens`, og sæt et nyt, før det udløber. Et andet element, der åbner denne guide i sig selv – det gør annonce-elementet `campaign-creator` – kører disse kald med sit eget token, så tilføj disse scopes til det ene token i stedet for at udstede et nyt: dette element har ingen mulighed for at læse legitimationsoplysninger, du har sat andetsteds. Udelades det, bærer kaldene seerens egen session, som kun svarer på samme oprindelse (same-origin).

**destinationUrl** `string`

Siden, der skal tjekkes, og som scannes ved montering. Lad den være tom, så beder guiden om en. Det er også den, der styrer "Verify live" på hændelsestrinnet – den knap fører kontoejeren gennem sin egen funnel for at fange hændelser, som en server-side-scanning ikke kan se, så den vises først, når en destination er kendt, enten herfra eller angivet i guiden. Læses én gang ved opstart, så `update()` skifter ikke mål midt i forløbet – lav en ny montering til en anden side. Standard er `""`.

**eventName** `string`

Valgfri. En hændelse, der skal affyres på den side (`lead`, `schedule`, `view_content`, …); hændelsestrinnet blokerer, indtil den registreres. Hvis den ikke er sat, tilbydes alle hændelser, og ingen er påkrævet. Hændelser, som Whop registrerer server-side (`purchase`, `subscribe`, prøveperioder, checkout-trin), ignoreres. Læses én gang ved opstart. Standard er `""`.

**redirectUrl** `string`

En URL, som destinationen omdirigerer til, når hændelsen i stedet affyres dér. Kontoejeren kan også angive en i guiden – lyt efter `redirectUrlChanged`, og send den tilbage næste gang. Standard er `""`.

**initialStep** `"events" | "install"`

Hvor guiden åbner: på installationstrinnet eller direkte på `events`, når pixlen allerede er der, og kun konverteringshændelsen mangler. Standard er `"install"`.

**showIntro** `boolean`

Åbn på introskærmen "why a pixel". Slå den fra, hvor kontoejeren allerede ved, hvorfor de er her – et kampagneforløb, der sender dem ind midt i en lancering – så åbner guiden direkte på installationstrinnet. Standard er `true`.

**showInviteDeveloper** `boolean`

Tilbyd muligheden "Invite a developer to install it". Skjul den, hvor de personer, der bruger din indlejring, ikke bør invitere medlemmer til Whop-teamet bag den. Standard er `true`.

**showOptimizePrompt** `boolean`

Vis skærmen "your pixel is live", når en side består tjekket, som tilbyder konverteringshændelser som næste skridt. Slå den fra, hvor kontoejeren er kommet for selve hændelserne – et bestået tjek går så direkte til dem i stedet for at stoppe ved en skærm, de alligevel ville klikke sig forbi. Standard er `true`.

**verifyFirst** `boolean`

Start med sidetjekket i stedet for installationsvejledningen: URL-feltet (og dets forslag) står øverst, installationsmulighederne foldes ind under en "Pixel not installed yet?"-knap, og overskriften lyder "Verify your pixel". Til en kontoejer, der allerede har en pixel og er her for at finde ud af, hvorfor intet bliver attribueret. Kombinér det med `showIntro: false`. Standard er `false`.

## Hændelser

Send callbacks i create-indstillingerne eller React-props.

### `onRedirectUrlChanged`

Kontoejeren har angivet eller ryddet en omdirigerings-URL i guiden. Gem den, og send den tilbage som `redirectUrl` næste gang.

**payload** `object`

**egenskaber**

**url** `string` *required*

### `onScanned`

En pixelscanning er afsluttet. Udløses for hver URL, guiden tjekker, så dit eget installationsmærke kan følge med. `primary` markerer den side, der sættes op: funnel-tjekkeren scanner alt det andet, kontoejeren angiver, inklusive andre hostnavne, så tjek den, før du behandler et resultat som værende om deres site. Du behøver ikke dette for at holde en `websites`-tabel retvisende – monteret under det handle får et site, der er bevist live, allerede sin ventende række.

**payload** `object`

**egenskaber**

**url** `string` *required*

**status** `"installed" | "missing" | "unreachable"` *required*

**installed** `boolean` *required*

**primary** `boolean` *required*

### `onFinished`

Done blev trykket. Tjek selv siden igen – dette fortæller, at guiden er færdig, ikke at dine krav er opfyldt.

### `onUrlSubmitted`

Kontoejeren har angivet den side, der skal tjekkes, inde fra guiden – indtastet manuelt eller valgt blandt de foreslåede sider. Kan kun nås, når der ikke blev angivet nogen destination ved montering.

**payload** `object`

**egenskaber**

**url** `string` *required*

**source** `"typed" | "suggested"` *required*

### `onVerifyLaunched`

"Verify live" blev trykket. `popupBlocked` betyder, at browseren afviste funnel-vinduet, så gennemgangen aldrig startede.

**payload** `object`

**egenskaber**

**url** `string` *required*

**popupBlocked** `boolean` *required*

### `onVerifyConnected`

Funnel-siden har sendt et ping tilbage til guiden – pixlen er indlæst dér, og gennemgangen er i gang.

**payload** `object`

**egenskaber**

**url** `string` *required*

### `onVerdict`

Verify live-gennemgangen er afsluttet. `ok` betyder ingen sporingshuller; ellers indeholder `gaps` de hulkoder, gennemgangen fandt.

**payload** `object`

**egenskaber**

**url** `string` *required*

**ok** `boolean` *required*

**gaps** `string[]` *required*

**eventsCaptured** `number` *required*

### `onEventVerified`

Kontoejeren har gennemgået sin funnel med "Verify live", og denne hændelse blev affyret – bevis på, at den er koblet til dér, hvor en server-side-scanning ikke kan nå.

**payload** `object`

**egenskaber**

**url** `string` *required*

**event** `string` *required*

### `onLoaderStart`

Kører, efter at indlæsningsskelettet tegnes første gang, og før `onReady`.

### `onReady`

Kører efter elementets første komplette optegning.

### `onError`

Kører, når elementet ikke kan indlæses eller går ned. Fallback-visningen forbliver synlig. Brug `code` til programmatisk håndtering. `sourceKey` identificerer en host-state-kilde, der fejlede.

**e** `object`

**egenskaber**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Metoder

Kald disse på det handle, der returneres af `create`, eller via en React-`ref`.

### `mount`

Monterer elementet i `target` og starter indlæsningen. React-komponenter monterer sig selv.

**Parametre**

**target** `string | HTMLElement` *required*

### `destroy`

Fjerner elementet og frigiver dets frame og abonnementer. Du kan kalde det mere end én gang. React fjerner elementet automatisk.

### `update`

Fletter nye props ind i det monterede element. I React skal du i stedet ændre komponentens props.

**Parametre**

**options** `Partial\<PixelSetupElementProps\>` *required*

## Styling

Style disse dele via `appearance.classes`. Brug camel case eller kebab case til egenskabsnavne, og medtag enheder. Sidens stylesheets kan ikke nå elementets frame. Frameworket validerer hver deklaration, før den indsættes.

| Klasse | Rammer |
| - | - |
| `.whop-PixelSetupSurface` | Rodelementet for pixelopsætningsguiden – ét trin ad gangen |

```ts theme={null}
const websites = whop.websites.create({
  appearance: {
    classes: {
      'whop-PixelSetupSurface': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

websites.update({
  appearance: {
    classes: { 'whop-PixelSetupSurface': { fontWeight: '700' } }
  }
});
```

I React angiver du `appearance` til `<Websites>`. Sæt den globalt med `WhopElements({ appearance })`.


## Related topics

- [Websites](https://docs.whop.com/da/elements/latest/websites/overview.md)
- [CampaignCreatorElement](https://docs.whop.com/da/elements/latest/ads/campaign-creator.md)
- [Kom godt i gang med Elements](https://docs.whop.com/da/elements/latest/getting-started.md)
