# Išplėstinės įterpimo parinktys

> Įterpimo valdiklis priima daugiau konfigūracijos parametrų, nei rodoma kopijavimo ir įklijavimo fragmente, įskaitant kliento parinkčių perdavimą jo atidaromam atsiskaitymo langui.

Jūsų Entase paskyroje sugeneruoti įterpimo kodai į puslapį įterpia paruoštą renginio valdiklį. Jie skirti kopijuoti ir įklijuoti be jokių programavimo darbų – kaip jį gauti, žr. [Renginių įterpimas į savo svetainę](/organizers/sharing-and-embedding/embedding-events-on-your-website.md).

Šiame puslapyje aprašytos parinktys, kurias galite pridėti prie to fragmento, ir kaip konfigūruoti jo atidaromą atsiskaitymo langą.

Valdiklis pats įkelia JavaScript klientą, todėl šalia jo nereikia pridėti `client.js`. Jam taip pat nereikia viešinamojo rakto: valdiklį teikia Entase, todėl atsiskaitymo langas autorizuojamas per valdiklį, o ne per jūsų puslapyje esantį raktą.

## Konfigūravimas

Kiekvienas valdiklis konfigūruojamas parinkčių objektu:

```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` susieja konfigūraciją su jos konteineriu: valdiklis atvaizduojamas elemente, kurio id yra `entase_`, po kurio nurodytas tas pats kodas. Jei šio elemento nėra, valdiklis į žurnalą įrašo įspėjimą ir nieko neatvaizduoja.

Norėdami puslapyje pateikti kelis valdiklius, pridėkite po vieną įrašą kiekvienam valdikliui.

| Pavadinimas | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
| `obj` | eilutė | – | Objekto kodas iš jūsų įterpimo fragmento. Privalomas. |
| `width` | eilutė | `'auto'` | Konteinerio plotis kaip CSS reikšmė. `'auto'` reiškia visą plotį. |
| `height` | eilutė | `'auto'` | Konteinerio aukštis kaip CSS reikšmė. `'auto'` pradedamas nuo 200px, o valdiklis pats keičia savo dydį, kad tilptų jo turinys. |
| `theme` | eilutė | `'light'` | `'light'` arba `'dark'`. |
| `locale` | eilutė | `'auto'` | Valdiklio kalba. `'auto'` nuskaito jūsų `<html>` elemento atributą `lang`. |
| `ext` | loginė reikšmė | `false` | Išplėstinis išdėstymas – virš datų prideda renginio pavadinimą ir plakatą. |
| `attribution` | loginė reikšmė | `true` | Rodo Entase priskyrimo eilutę. Norėdami ją paslėpti, nustatykite `false`. |
| `client` | objektas | `{}` | Parinktys, perduodamos JavaScript klientui, kuris atidaro atsiskaitymo langą. |

Nepriklausomai nuo `width`, konteineriui nustatomas mažiausias 200px plotis; esant mažesniam pločiui, valdiklio išdėstymas negali būti tinkamas.

## Atsiskaitymo lango konfigūravimas

`client` priima tas pačias parinktis kaip ir kliento konstruktorius, todėl iš valdiklio atidaromą atsiskaitymo langą galima stilizuoti ir nustatyti jo dydį taip pat, kaip ir atidaromo jūsų pačių:

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

Visą sąrašą žr. [Konstruktoriaus parinktys](/developers/js-client/constructor-options.md).

Yra du apribojimai. `tprm` nustato pats valdiklis pagal puslapio URL (žr. toliau), todėl čia perduota reikšmė pakeičiama. Be to, kai keli valdikliai yra tame pačiame puslapyje, jie naudoja vieną kliento egzempliorių – taikomos paskutinio inicijuoto valdiklio `client` parinktys, todėl visų tame pačiame puslapyje esančių valdiklių parinktys turi būti vienodos.

## Automatinis kampanijos parametrų persiuntimas

Skirtingai nei atskiras klientas, valdiklis nuskaito jūsų puslapio užklausos eilutę ir persiunčia žinomus kampanijos parametrus tiek valdikliui, tiek atsiskaitymo langui:

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

Lankytojo, atvykusio į `yoursite.com/concert?utm_source=facebook&sgm=SOCIAL`, priskyrimas įrašomas prie bet kokio sukurto užsakymo be papildomos konfigūracijos. Parametrai, nepatenkantys į šį sąrašą, ignoruojami – jei norite perduoti savus parametrus, atidarykite atsiskaitymo langą tiesiogiai naudodami klientą ir patys nustatykite `tprm`. Žr. [Stebėjimas ir sutikimas](/developers/js-client/tracking-and-consent.md).
