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ę.
Š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:
<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ų:
window.entase.o.push({
obj: 'OBJ_CODE',
client: {
checkoutMode: 'pane',
pane: { width: '60vw' },
backdrop: true,
backdropColor: '#101014'
}
});Visą sąrašą žr. Konstruktoriaus parinktys.
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.