Erweidert Embed-Optiounen · JavaScript-Client

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, 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:

JavaScript

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

Kuckt Konstrukteur-Optiounen 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.