Codurile de încorporare generate în contul dvs. Entase adaugă într-o pagină un widget de eveniment gata pregătit. Sunt concepute pentru a fi copiate și lipite fără muncă de dezvoltare – consultați Încorporarea evenimentelor pe site-ul dvs. pentru a afla cum să obțineți unul.
Această pagină documentează opțiunile pe care le puteți adăuga la acel fragment de cod și modul de configurare a paginii de finalizare a comenzii pe care o deschide.
Widgetul încarcă singur clientul JavaScript, deci nu adăugați client.js alături de el. De asemenea, nu are nevoie de o cheie publicabilă: widgetul este furnizat de Entase, astfel că pagina de finalizare a comenzii este autorizată prin widget, nu printr-o cheie de pe pagina dvs.
Configurare
Fiecare widget este configurat cu un obiect de opțiuni:
<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 asociază configurația cu containerul său: widgetul se afișează în elementul al cărui id este entase_ urmat de același cod. Dacă acel element lipsește, widgetul înregistrează un avertisment și nu afișează nimic.
Adăugați câte o intrare pentru fiecare widget pentru a plasa mai multe widgeturi într-o pagină.
| Nume | Tip | Valoare implicită | Descriere |
|---|---|---|---|
obj | șir | – | Codul obiectului din fragmentul dvs. de cod de încorporare. Obligatoriu. |
width | șir | 'auto' | Lățimea containerului ca valoare CSS. 'auto' înseamnă lățime completă. |
height | șir | 'auto' | Înălțimea containerului ca valoare CSS. 'auto' începe de la 200px, iar widgetul își redimensionează automat dimensiunea pentru a se potrivi conținutului. |
theme | șir | 'light' | 'light' sau 'dark'. |
locale | șir | 'auto' | Limba widgetului. 'auto' citește atributul lang al elementului dvs. <html>. |
ext | boolean | false | Aspect extins – adaugă numele evenimentului și afișul deasupra datelor. |
attribution | boolean | true | Afișează linia de atribuire Entase. Setați la false pentru a o ascunde. |
client | obiect | {} | Opțiuni transmise clientului JavaScript care deschide pagina de finalizare a comenzii. |
Containerul primește o lățime minimă de 200px, indiferent de width; sub această valoare, widgetul nu se poate aranja corect.
Configurarea paginii de finalizare a comenzii
client acceptă aceleași opțiuni ca constructorul clientului, astfel că pagina de finalizare a comenzii deschisă dintr-un widget poate fi stilizată și dimensionată la fel ca una pe care o deschideți dvs.:
window.entase.o.push({
obj: 'OBJ_CODE',
client: {
checkoutMode: 'pane',
pane: { width: '60vw' },
backdrop: true,
backdropColor: '#101014'
}
});Consultați Opțiuni pentru constructor pentru lista completă.
Două aspecte importante. tprm este setat chiar de widget din URL-ul paginii (vedeți mai jos), astfel că o valoare transmisă aici este înlocuită. Iar când mai multe widgeturi partajează o pagină, ele partajează o singură instanță de client – opțiunile client ale ultimului widget inițializat sunt cele aplicate, așadar păstrați-le identice pentru widgeturile de pe aceeași pagină.
Transmiterea automată a campaniilor
Spre deosebire de clientul independent, widgetul citește șirul de interogare al paginii dvs. și transmite parametrii de campanie cunoscuți atât widgetului, cât și paginii de finalizare a comenzii:
sgm, utm_source, utm_medium, utm_campaign, utm_term, utm_content, utm_id, utm_source_platform, utm_creative_format, fbclid
Un vizitator care ajunge la yoursite.com/concert?utm_source=facebook&sgm=SOCIAL are această atribuire înregistrată pentru orice comandă rezultată, fără configurări suplimentare. Parametrii din afara acestei liste sunt ignorați – pentru a transmite parametrii proprii, deschideți pagina de finalizare a comenzii direct cu clientul și setați dvs. tprm. Consultați Urmărire și consimțământ.