# Upotuksen lisäasetukset

> Upotuswidgetti hyväksyy enemmän määrityksiä kuin kopioi ja liitä -katkelma näyttää, mukaan lukien asiakasasetusten välittämisen sen avaamaan kassaan.

Entase-tililläsi luodut upotuskoodit lisäävät valmiin tapahtumawidgetin sivulle. Ne on suunniteltu kopioitaviksi ja liitettäviksi ilman kehitystyötä – katso [Tapahtumien upottaminen verkkosivustollesi](/organizers/sharing-and-embedding/embedding-events-on-your-website.md), miten saat sellaisen.

Tällä sivulla kuvataan asetukset, jotka voit lisätä tähän katkelmaan, sekä sen avaaman kassan määrittäminen.

Widgetti lataa JavaScript-asiakkaan itse, joten et lisää `client.js`-tiedostoa sen rinnalle. Se ei myöskään tarvitse julkaistavaa avainta: widgetin tarjoaa Entase, joten kassa valtuutetaan widgetin kautta sivullasi olevan avaimen sijaan.

## Määritykset

Jokainen widgetti määritetään asetuskohteella:

```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` yhdistää määrityksen säilöönsä: widgetti renderöidään elementtiin, რომლის tunnus on `entase_`, jota seuraa sama koodi. Jos elementti puuttuu, widgetti kirjaa varoituksen eikä renderöi mitään.

Lisää yksi merkintä kutakin widgettiä kohden, jos haluat sijoittaa sivulle useita widgettejä.

| Nimi | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
| `obj` | merkkijono | – | Upotuskatkelmasi objektikoodi. Pakollinen. |
| `width` | merkkijono | `'auto'` | Säilön leveys CSS-arvona. `'auto'` tarkoittaa täyttä leveyttä. |
| `height` | merkkijono | `'auto'` | Säilön korkeus CSS-arvona. `'auto'` alkaa 200 pikselistä, ja widgetti muuttaa itse kokoaan sisältönsä mukaan. |
| `theme` | merkkijono | `'light'` | `'light'` tai `'dark'`. |
| `locale` | merkkijono | `'auto'` | Widgetin kieli. `'auto'` lukee `<html>`-elementtisi `lang`-attribuutin. |
| `ext` | totuusarvo | `false` | Laajennettu asettelu – lisää tapahtuman nimen ja julisteen päivämäärien yläpuolelle. |
| `attribution` | totuusarvo | `true` | Näyttää Entase-viittausrivin. Aseta arvoksi `false` piilottaaksesi sen. |
| `client` | objekti | `{}` | JavaScript-asiakkaalle välitettävät asetukset, joka avaa kassan. |

Säilölle annetaan 200 pikselin vähimmäisleveys `width`-asetuksesta riippumatta. Tämän leveyden alapuolella widgetti ei voi asettua oikein.

## Kassan määrittäminen

`client` hyväksyy samat asetukset kuin asiakaskonstruktori, joten widgetistä avattavan kassan tyyliä ja kokoa voi muuttaa kuten itse avaamasi kassan:

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

Katso koko luettelo kohdasta [Konstruktorin asetukset](/developers/js-client/constructor-options.md).

Kaksi huomioitavaa asiaa. Widgetti asettaa `tprm`-arvon itse sivun URL-osoitteen perusteella (katso alla), joten tässä annettu arvo korvataan. Kun useat widgetit jakavat sivun, ne jakavat yhden asiakasilmentymän – viimeksi alustetun widgetin `client`-asetukset ovat käytössä. Pidä ne siis samoina saman sivun widgeteissä.

## Kampanjoiden automaattinen välitys

Toisin kuin erillinen asiakas, widgetti lukee sivusi kyselymerkkijonon ja välittää tunnetut kampanjaparametrit sekä widgetille että kassalle:

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

Kävijän saapuessa osoitteeseen `yoursite.com/concert?utm_source=facebook&sgm=SOCIAL` tämä attribuutio tallennetaan kaikkiin siitä syntyviin tilauksiin ilman lisämäärityksiä. Tämän luettelon ulkopuoliset parametrit ohitetaan – jos haluat välittää omia parametrejäsi, avaa kassa suoraan asiakkaalla ja aseta `tprm` itse. Katso [Seuranta ja suostumus](/developers/js-client/tracking-and-consent.md).
