Kódy pro vložení vygenerované ve vašem účtu Entase vloží na stránku hotový widget události. Jsou navrženy ke zkopírování a vložení bez nutnosti vývojářské práce – postup získání najdete v článku Vložení událostí na váš web.
Tato stránka popisuje možnosti, které můžete k tomuto úryvku přidat, a způsob konfigurace checkoutu, který otevírá.
Widget si sám načítá klienta JavaScript, takže vedle něj nepřidávejte client.js. Nepotřebuje ani publikovatelný klíč: widget poskytuje Entase, takže checkout je autorizován prostřednictvím widgetu, nikoli klíčem na vaší stránce.
Konfigurace
Každý widget se konfiguruje pomocí objektu možností:
<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 propojuje konfiguraci s jejím kontejnerem: widget se vykreslí do prvku, jehož id je entase_ následované stejným kódem. Pokud tento prvek chybí, widget zapíše upozornění a nic nevykreslí.
Chcete-li na stránku umístit více widgetů, přidejte jednu položku pro každý widget.
| Název | Typ | Výchozí | Popis |
|---|---|---|---|
obj | řetězec | – | Kód objektu z vašeho úryvku pro vložení. Povinné. |
width | řetězec | 'auto' | Šířka kontejneru jako hodnota CSS. 'auto' znamená plnou šířku. |
height | řetězec | 'auto' | Výška kontejneru jako hodnota CSS. 'auto' začíná na 200 px a widget si změní velikost podle obsahu. |
theme | řetězec | 'light' | 'light' nebo 'dark'. |
locale | řetězec | 'auto' | Jazyk widgetu. 'auto' načte atribut lang vašeho prvku <html>. |
ext | booleovská hodnota | false | Rozšířené rozvržení – nad data přidá název události a plakát. |
attribution | booleovská hodnota | true | Zobrazí řádek s uvedením Entase. Chcete-li jej skrýt, nastavte false. |
client | objekt | {} | Možnosti předané klientovi JavaScript, který otevírá checkout. |
Kontejner má bez ohledu na width minimální šířku 200 px; pod touto hodnotou nelze widget správně rozvrhnout.
Konfigurace checkoutu
client přijímá stejné možnosti jako konstruktor klienta, takže checkout otevřený z widgetu lze stylovat a měnit jeho velikost stejně jako u checkoutu, který otevřete sami:
window.entase.o.push({
obj: 'OBJ_CODE',
client: {
checkoutMode: 'pane',
pane: { width: '60vw' },
backdrop: true,
backdropColor: '#101014'
}
});Úplný seznam najdete v článku Možnosti konstruktoru.
Dvě upozornění. tprm nastavuje samotný widget z adresy URL stránky (viz níže), takže zde předaná hodnota se nahradí. A když několik widgetů sdílí jednu stránku, sdílejí jednu instanci klienta – použijí se možnosti client posledního inicializovaného widgetu, proto je ponechte u všech widgetů na stejné stránce stejné.
Automatické předávání kampaní
Na rozdíl od samostatného klienta widget načte řetězec dotazu vaší stránky a předá známé parametry kampaně widgetu i checkoutu:
sgm, utm_source, utm_medium, utm_campaign, utm_term, utm_content, utm_id, utm_source_platform, utm_creative_format, fbclid
Návštěvník, který přijde na yoursite.com/concert?utm_source=facebook&sgm=SOCIAL, bude mít toto přiřazení zaznamenáno u každé výsledné objednávky bez další konfigurace. Parametry mimo tento seznam jsou ignorovány – chcete-li předávat vlastní parametry, otevřete checkout přímo pomocí klienta a sami nastavte tprm. Viz Sledování a souhlas.