De insluitcodes die in je Entase-account worden gegenereerd, plaatsen een kant-en-klare eventwidget op een pagina. Ze zijn bedoeld om zonder ontwikkelwerk te worden gekopieerd en geplakt – zie Events op je website insluiten voor informatie over hoe je er een krijgt.
Op deze pagina worden de opties beschreven die je aan dat fragment kunt toevoegen, en hoe je het afrekenproces dat het opent configureert.
De widget laadt zelf de JavaScript-client, dus je voegt client.js er niet naast toe. Er is ook geen publiceerbare sleutel nodig: de widget wordt door Entase geleverd, dus het afrekenproces wordt geautoriseerd via de widget en niet via een sleutel op je pagina.
Configuratie
Elke widget wordt geconfigureerd met een optiesobject:
<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 koppelt de configuratie aan de container: de widget wordt weergegeven in het element waarvan de id bestaat uit entase_ gevolgd door dezelfde code. Als dat element ontbreekt, registreert de widget een waarschuwing en wordt er niets weergegeven.
Voeg één item per widget toe om er meerdere op een pagina te plaatsen.
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
obj | tekenreeks | – | De objectcode uit je insluitfragment. Vereist. |
width | tekenreeks | 'auto' | Containerbreedte als CSS-waarde. 'auto' betekent volledige breedte. |
height | tekenreeks | 'auto' | Containerhoogte als CSS-waarde. 'auto' begint op 200px en de widget past het formaat zelf aan zodat deze bij de inhoud past. |
theme | tekenreeks | 'light' | 'light' of 'dark'. |
locale | tekenreeks | 'auto' | Widgettaal. 'auto' leest het attribuut lang van je <html>-element. |
ext | booleaans | false | Uitgebreide lay-out – voegt de eventnaam en poster toe boven de datums. |
attribution | booleaans | true | Toont de Entase-vermeldingsregel. Stel in op false om deze te verbergen. |
client | object | {} | Opties die worden doorgegeven aan de JavaScript-client die het afrekenproces opent. |
De container krijgt een minimumbreedte van 200px, ongeacht width; daaronder kan de widget niet correct worden ingedeeld.
Het afrekenproces configureren
client accepteert dezelfde opties als de clientconstructor, dus het afrekenproces dat vanuit een widget wordt geopend, kan worden vormgegeven en gedimensioneerd zoals een proces dat je zelf opent:
window.entase.o.push({
obj: 'OBJ_CODE',
client: {
checkoutMode: 'pane',
pane: { width: '60vw' },
backdrop: true,
backdropColor: '#101014'
}
});Zie Constructoropties voor de volledige lijst.
Twee aandachtspunten. tprm wordt door de widget zelf ingesteld op basis van de pagina-URL (zie hieronder), dus een hier doorgegeven waarde wordt vervangen. En wanneer meerdere widgets een pagina delen, delen ze één clientinstantie – de client-opties van de widget die als laatste is geïnitialiseerd, zijn van kracht, dus houd ze identiek voor widgets op dezelfde pagina.
Automatisch doorsturen van campagnes
In tegenstelling tot de zelfstandige client leest de widget de queryreeks van je pagina en stuurt bekende campagneparameters door naar zowel de widget als het afrekenproces:
sgm, utm_source, utm_medium, utm_campaign, utm_term, utm_content, utm_id, utm_source_platform, utm_creative_format, fbclid
Van een bezoeker die op yoursite.com/concert?utm_source=facebook&sgm=SOCIAL arriveert, wordt die attributie vastgelegd bij elke daaruit voortvloeiende bestelling, zonder verdere configuratie. Parameters buiten deze lijst worden genegeerd – als je eigen parameters wilt meenemen, open je het afrekenproces rechtstreeks met de client en stel je tprm zelf in. Zie Tracking en toestemming.