# Opțiuni avansate de încorporare

> Widgetul încorporat acceptă mai multe opțiuni de configurare decât arată fragmentul de cod copiat și lipit, inclusiv transmiterea opțiunilor clientului către pagina de finalizare a comenzii pe care o deschide.

Codurile de încorporare generate în contul dvs. Entase adaugă într-o pagină un widget de eveniment gata pregătit. Sunt concepute pentru a fi copiate și lipite fără muncă de dezvoltare – consultați [Încorporarea evenimentelor pe site-ul dvs.](/organizers/sharing-and-embedding/embedding-events-on-your-website.md) pentru a afla cum să obțineți unul.

Această pagină documentează opțiunile pe care le puteți adăuga la acel fragment de cod și modul de configurare a paginii de finalizare a comenzii pe care o deschide.

Widgetul încarcă singur clientul JavaScript, deci nu adăugați `client.js` alături de el. De asemenea, nu are nevoie de o cheie publicabilă: widgetul este furnizat de Entase, astfel că pagina de finalizare a comenzii este autorizată prin widget, nu printr-o cheie de pe pagina dvs.

## Configurare

Fiecare widget este configurat cu un obiect de opțiuni:

```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` asociază configurația cu containerul său: widgetul se afișează în elementul al cărui id este `entase_` urmat de același cod. Dacă acel element lipsește, widgetul înregistrează un avertisment și nu afișează nimic.

Adăugați câte o intrare pentru fiecare widget pentru a plasa mai multe widgeturi într-o pagină.

| Nume | Tip | Valoare implicită | Descriere |
|---|---|---|---|
| `obj` | șir | – | Codul obiectului din fragmentul dvs. de cod de încorporare. Obligatoriu. |
| `width` | șir | `'auto'` | Lățimea containerului ca valoare CSS. `'auto'` înseamnă lățime completă. |
| `height` | șir | `'auto'` | Înălțimea containerului ca valoare CSS. `'auto'` începe de la 200px, iar widgetul își redimensionează automat dimensiunea pentru a se potrivi conținutului. |
| `theme` | șir | `'light'` | `'light'` sau `'dark'`. |
| `locale` | șir | `'auto'` | Limba widgetului. `'auto'` citește atributul `lang` al elementului dvs. `<html>`. |
| `ext` | boolean | `false` | Aspect extins – adaugă numele evenimentului și afișul deasupra datelor. |
| `attribution` | boolean | `true` | Afișează linia de atribuire Entase. Setați la `false` pentru a o ascunde. |
| `client` | obiect | `{}` | Opțiuni transmise clientului JavaScript care deschide pagina de finalizare a comenzii. |

Containerul primește o lățime minimă de 200px, indiferent de `width`; sub această valoare, widgetul nu se poate aranja corect.

## Configurarea paginii de finalizare a comenzii

`client` acceptă aceleași opțiuni ca constructorul clientului, astfel că pagina de finalizare a comenzii deschisă dintr-un widget poate fi stilizată și dimensionată la fel ca una pe care o deschideți dvs.:

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

Consultați [Opțiuni pentru constructor](/developers/js-client/constructor-options.md) pentru lista completă.

Două aspecte importante. `tprm` este setat chiar de widget din URL-ul paginii (vedeți mai jos), astfel că o valoare transmisă aici este înlocuită. Iar când mai multe widgeturi partajează o pagină, ele partajează o singură instanță de client – opțiunile `client` ale ultimului widget inițializat sunt cele aplicate, așadar păstrați-le identice pentru widgeturile de pe aceeași pagină.

## Transmiterea automată a campaniilor

Spre deosebire de clientul independent, widgetul citește șirul de interogare al paginii dvs. și transmite parametrii de campanie cunoscuți atât widgetului, cât și paginii de finalizare a comenzii:

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

Un vizitator care ajunge la `yoursite.com/concert?utm_source=facebook&sgm=SOCIAL` are această atribuire înregistrată pentru orice comandă rezultată, fără configurări suplimentare. Parametrii din afara acestei liste sunt ignorați – pentru a transmite parametrii proprii, deschideți pagina de finalizare a comenzii direct cu clientul și setați dvs. `tprm`. Consultați [Urmărire și consimțământ](/developers/js-client/tracking-and-consent.md).
