# Erweidert Embed-Optiounen

> Den Embed-Widget akzeptéiert méi Konfiguratiounsoptiounen, wéi de Copy-paste-Snippet weist, dorënner d'Weidergi vu Client-Optiounen un de Checkout, deen en opmécht.

D'Embed-Coden, déi an Ärem Entase-Kont generéiert ginn, füügen e fäerdegen Event-Widget an eng Säit an. Si si fir ze kopéieren an anzepechen, ouni Entwécklungsaarbecht – kuckt [Eventer op Ärer Websäit embeddéieren](/organizers/sharing-and-embedding/embedding-events-on-your-website.md), fir ze wëssen, wéi Dir een kritt.

Dës Säit dokumentéiert d'Optiounen, déi Dir zu deem Snippet derbäisetze kënnt, a wéi Dir de Checkout konfiguréiert, deen en opmécht.

De Widget lued de JavaScript-Client selwer, dofir füügt Dir `client.js` net dobäi. En erfuerdert och kee verëffentlechbare Schlëssel: de Widget gëtt vun Entase bereitgestallt, dofir gëtt de Checkout iwwer de Widget autoriséiert an net iwwer e Schlëssel op Ärer Säit.

## Konfiguratioun

All Widget gëtt mat engem Optiounsobjet konfiguréiert:

```html
<div id="entase_OBJ_CODE"></div>
<script>
  window.entase = window.entase || { o: [] };
  window.entase.o.push({
    obj: 'OBJ_CODE',
    theme: 'dark',
    ext: true
  });
</script>
<script src="https://js.entase.com/embed.js" async></script>
```

`obj` verbënnt d'Konfiguratioun mat sengem Container: de Widget gëtt an dat Element gerendert, deem seng id `entase_` ass, gefollegt vum selwechte Code. Wann dat Element feelt, protokolléiert de Widget eng Warnung a rendert näischt.

Füügt ee Bäitrag pro Widget derbäi, fir méi der dovun op enger Säit ze placéieren.

| Numm | Typ | Standard | Beschreiwung |
|---|---|---|---|
| `obj` | String | – | Den Objektcode aus Ärem Embed-Snippet. Erfuerderlech. |
| `width` | String | `'auto'` | Containerbreet als CSS-Wäert. `'auto'` bedeit voll Breet. |
| `height` | String | `'auto'` | Containerhéicht als CSS-Wäert. `'auto'` fänkt bei 200px un, an de Widget passt seng Gréisst selwer un, fir bei säin Inhalt ze passen. |
| `theme` | String | `'light'` | `'light'` oder `'dark'`. |
| `locale` | String | `'auto'` | Widgetsprooch. `'auto'` liest den `lang`-Attribut vun Ärem `<html>`-Element. |
| `ext` | Boolean | `false` | Erweiderte Layout – füügt den Eventnumm an d'Affiche iwwer den Datumer derbäi. |
| `attribution` | Boolean | `true` | Weist d'Entase-Zouuerkennungszeil un. Setzt et op `false`, fir se ze verstoppen. |
| `client` | Objet | `{}` | Optiounen, déi un de JavaScript-Client weidergi ginn, deen de Checkout opmécht. |

Dem Container gëtt onofhängeg vun `width` eng Mindestbreet vun 200px zougewisen, ënner där de Widget net korrekt ugeluecht ka ginn.

## De Checkout konfiguréieren

`client` akzeptéiert déiselwecht Optiounen ewéi de Client-Konstrukteur, dofir kann de Checkout, deen aus engem Widget opgemaach gëtt, grad esou gestylt a dimensionéiert ginn, ewéi een, deen Dir selwer opmaacht:

```js
window.entase.o.push({
  obj: 'OBJ_CODE',
  client: {
    checkoutMode: 'pane',
    pane: { width: '60vw' },
    backdrop: true,
    backdropColor: '#101014'
  }
});
```

Kuckt [Konstrukteur-Optiounen](/developers/js-client/constructor-options.md) fir déi komplett Lëscht.

Zwee Virbehalter. `tprm` gëtt vum Widget selwer op Basis vun der URL vun der Säit gesat (kuckt hei drënner), dofir gëtt e Wäert, deen hei weidergi gëtt, ersat. A wa verschidde Widgets eng Säit deelen, deele si sech eng Client-Instanz – d'`client`-Optioune vum leschte initialiséierte Widget sinn déi, déi gëllen; haalt se dofir fir all Widgets op der selwechter Säit identesch.

## Automatesch Weiderleedung vu Campagnen

Am Géigesaz zum eegestännege Client liest de Widget de Query-String vun Ärer Säit a leit bekannt Campagneparameter souwuel un de Widget wéi och un de Checkout weider:

`sgm`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`, `utm_id`, `utm_source_platform`, `utm_creative_format`, `fbclid`

E Visiteur, deen op `yoursite.com/concert?utm_source=facebook&sgm=SOCIAL` ukënnt, kritt dës Zouuerkennung bei all doraus entstoender Bestellung opgeholl, ouni weider Konfiguratioun. Parameteren ausserhalb vun dëser Lëscht ginn ignoréiert – fir Är eegen ze iwwerhuelen, maacht de Checkout direkt mam Client op a setzt `tprm` selwer. Kuckt [Tracking an Zoustëmmung](/developers/js-client/tracking-and-consent.md).
