# Προηγμένες επιλογές ενσωμάτωσης

> Το widget ενσωμάτωσης δέχεται περισσότερες ρυθμίσεις από όσες εμφανίζονται στο απόσπασμα αντιγραφής και επικόλλησης, συμπεριλαμβανομένης της μεταβίβασης επιλογών client στο checkout που ανοίγει.

Οι κώδικες ενσωμάτωσης που δημιουργούνται στον λογαριασμό σας Entase τοποθετούν ένα έτοιμο widget εκδήλωσης σε μια σελίδα. Έχουν σχεδιαστεί για αντιγραφή και επικόλληση χωρίς εργασία ανάπτυξης – ανατρέξτε στο [Ενσωμάτωση εκδηλώσεων στον ιστότοπό σας](/organizers/sharing-and-embedding/embedding-events-on-your-website.md) για να μάθετε πώς να αποκτήσετε έναν.

Αυτή η σελίδα τεκμηριώνει τις επιλογές που μπορείτε να προσθέσετε σε αυτό το απόσπασμα και τον τρόπο διαμόρφωσης του checkout που ανοίγει.

Το widget φορτώνει το JavaScript client από μόνο του, επομένως δεν προσθέτετε το `client.js` δίπλα του. Επίσης, δεν χρειάζεται δημοσιεύσιμο κλειδί: το widget παρέχεται από το Entase, επομένως το checkout εξουσιοδοτείται μέσω του widget και όχι μέσω ενός κλειδιού στη σελίδα σας.

## Διαμόρφωση

Κάθε widget διαμορφώνεται με ένα αντικείμενο επιλογών:

```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` συνδέει τη διαμόρφωση με το κοντέινερ του: το widget αποδίδεται στο στοιχείο του οποίου το id είναι `entase_` ακολουθούμενο από τον ίδιο κωδικό. Αν αυτό το στοιχείο λείπει, το widget καταγράφει μια προειδοποίηση και δεν αποδίδει τίποτα.

Προσθέστε μία καταχώριση ανά widget για να τοποθετήσετε πολλά σε μια σελίδα.

| Όνομα | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
| `obj` | συμβολοσειρά | – | Ο κωδικός αντικειμένου από το απόσπασμα ενσωμάτωσης. Υποχρεωτικό. |
| `width` | συμβολοσειρά | `'auto'` | Πλάτος κοντέινερ ως τιμή CSS. Το `'auto'` σημαίνει πλήρες πλάτος. |
| `height` | συμβολοσειρά | `'auto'` | Ύψος κοντέινερ ως τιμή CSS. Το `'auto'` ξεκινά από 200px και το widget αλλάζει μέγεθος μόνο του ώστε να χωρά το περιεχόμενό του. |
| `theme` | συμβολοσειρά | `'light'` | `'light'` ή `'dark'`. |
| `locale` | συμβολοσειρά | `'auto'` | Γλώσσα widget. Το `'auto'` διαβάζει το χαρακτηριστικό `lang` του στοιχείου σας `<html>`. |
| `ext` | boolean | `false` | Εκτεταμένη διάταξη – προσθέτει το όνομα της εκδήλωσης και την αφίσα πάνω από τις ημερομηνίες. |
| `attribution` | boolean | `true` | Εμφανίζει τη γραμμή αναφοράς Entase. Ορίστε το σε `false` για απόκρυψή της. |
| `client` | αντικείμενο | `{}` | Επιλογές που μεταβιβάζονται στο JavaScript client που ανοίγει το checkout. |

Στο κοντέινερ δίνεται ελάχιστο πλάτος 200px ανεξάρτητα από το `width`, κάτω από το οποίο το widget δεν μπορεί να διαταχθεί σωστά.

## Διαμόρφωση του checkout

Το `client` δέχεται τις ίδιες επιλογές με τον constructor του client, επομένως το checkout που ανοίγει από ένα widget μπορεί να μορφοποιηθεί και να διαστασιολογηθεί όπως ένα που ανοίγετε εσείς οι ίδιοι:

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

Ανατρέξτε στις [Επιλογές constructor](/developers/js-client/constructor-options.md) για την πλήρη λίστα.

Δύο επισημάνσεις. Το `tprm` ορίζεται από το ίδιο το widget από το URL της σελίδας (δείτε παρακάτω), επομένως μια τιμή που μεταβιβάζεται εδώ αντικαθίσταται. Επίσης, όταν πολλά widget μοιράζονται μια σελίδα, μοιράζονται μία παρουσία client – οι επιλογές `client` του τελευταίου widget που αρχικοποιείται είναι αυτές που ισχύουν, επομένως διατηρήστε τες ίδιες σε όλα τα widget της ίδιας σελίδας.

## Αυτόματη προώθηση καμπάνιας

Σε αντίθεση με τον αυτόνομο client, το widget διαβάζει το query string της σελίδας σας και προωθεί γνωστές παραμέτρους καμπάνιας τόσο στο widget όσο και στο checkout:

`sgm`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`, `utm_id`, `utm_source_platform`, `utm_creative_format`, `fbclid`

Ένας επισκέπτης που φτάνει στο `yoursite.com/concert?utm_source=facebook&sgm=SOCIAL` έχει αυτή την απόδοση καταγεγραμμένη σε κάθε παραγγελία που προκύπτει χωρίς περαιτέρω διαμόρφωση. Οι παράμετροι εκτός αυτής της λίστας αγνοούνται – για να μεταφέρετε τις δικές σας, ανοίξτε το checkout απευθείας με τον client και ορίστε μόνοι σας το `tprm`. Δείτε [Παρακολούθηση και συγκατάθεση](/developers/js-client/tracking-and-consent.md).
