Smaily Connect for Magento 2 is an extension for Magento Open Source, Adobe Commerce and Mage-OS. It links your store to your own Smaily email-marketing account and, optionally, to Smaily Campaign Intelligence — Smaily's recommendation engine for personalized products and purchase-based automations.

It does four things:

• Syncs contacts — your newsletter subscribers (or, if you choose, every customer) reach your Smaily contact list, and an unsubscribe in Smaily comes back to Magento.
• Triggers automations — store events (welcome, first order, abandoned cart) start your Smaily workflows.
• Powers recommendations — when you connect Campaign Intelligence, your catalog, customers and orders (and, if you switch it on, browsing) feed personalized recommendations and engine-run automations.
• Serves a product RSS feed — for the RSS block of the Smaily template editor.

Your data stays yours. Contacts live in your Smaily account; the extension only connects the two systems.

Smaily Connect for Magento 2 on laiendus platvormidele Magento Open Source, Adobe Commerce ja Mage-OS. See ühendab sinu poe sinu enda Smaily e-turunduse kontoga ja soovi korral Smaily Campaign Intelligence'iga — Smaily soovitusmootoriga, mis pakub personaalseid tooteid ja ostupõhiseid automaatikaid.

See teeb nelja asja:

• Sünkroonib kontakte — sinu uudiskirja tellijad (või soovi korral kõik kliendid) jõuavad sinu Smaily kontaktide nimekirja ning Smailys tehtud loobumine jõuab tagasi Magentosse.
• Käivitab automaatikaid — poe sündmused (tervitus, esimene tellimus, hüljatud ostukorv) käivitavad sinu Smaily töövood.
• Toidab soovitusi — kui ühendad Campaign Intelligence'i, toidavad sinu kataloog, kliendid ja tellimused (ning soovi korral sirvimine) personaalseid soovitusi ja mootoris töötavaid automaatikaid.
• Pakub toodete RSS-voogu — Smaily mallide redaktori RSS-ploki jaoks.

Sinu andmed jäävad sinu omaks. Kontaktid asuvad sinu Smaily kontol; laiendus ainult ühendab kaks süsteemi.

There are three systems:

• Magento — your store: customers, newsletter subscribers, orders, products and storefront activity.
• Smaily — your email-marketing account, where contacts and automation workflows live (yourcompany.sendsmaily.net).
• Campaign Intelligence — Smaily's recommendation engine. Optional, connected with a one-time setup link from Smaily.

Smaily Connect is the bridge. Store events reach the extension; the extension queues contacts and automation triggers for Smaily and — if connected — catalog, customer and order data for Campaign Intelligence. Magento's cron sends the queue, normally within a minute.

Süsteeme on kolm:

• Magento — sinu pood: kliendid, uudiskirja tellijad, tellimused, tooted ja tegevus poes.
• Smaily — sinu e-turunduse konto, kus asuvad kontaktid ja automaatikate töövood (sinufirma.sendsmaily.net).
• Campaign Intelligence — Smaily soovitusmootor. Valikuline, ühendatakse Smailylt saadud ühekordse seadistuslingiga.

Smaily Connect on sild. Poe sündmused jõuavad laienduseni; laiendus paneb kontaktid ja automaatikate päästikud Smaily jaoks järjekorda ning — kui ühendatud — kataloogi-, kliendi- ja tellimusandmed Campaign Intelligence'i jaoks. Järjekorra saadab välja Magento cron, tavaliselt minuti jooksul.

You need:

• A Magento store on a supported version (below). The admin footer shows the Magento version on every page ("Magento ver. 2.4.x"); on the server, bin/magento --version prints it and php -v prints the PHP version — run it with the same PHP that runs bin/magento.
• Magento cron running every minute. The extension does all its sending from cron. Without it, nothing reaches Smaily.
• A Smaily account with API access. Create an API user in Smaily under Preferences > API — you'll need the subdomain, the API username and the API password. The account's package must include API access.
• (Optional) A Campaign Intelligence setup link — a one-time link on https://intelligence.smaily.com/…, provided by Smaily if you use the recommendation add-on.
• (With Campaign Intelligence) Two storefront addresses your firewall lets through. The shopper's browser posts to POST /smaily/attribution/land (an email-link click, so that your server sets the campaign-click cookies) and to POST /smaily/relay (browse events) on your store's own domain. A web application firewall, a CDN rule or a security module must let both through. They need no login and carry no name or email address — only the visitor token, the link's values and the products the shopper looked at. When they are blocked, browse events are lost and the browser sets the click cookies instead (Safari keeps those for 7 days at most).

Magento 2.4.3 and older cannot run Smaily Connect. If your store is below the minimum, upgrade it first.

Sul on vaja:

• Magento poodi toetatud versioonil (vt allpool). Halduse jalus näitab Magento versiooni igal lehel („Magento ver. 2.4.x“); serveris näitab seda bin/magento --version ja PHP versiooni php -v — käivita see sama PHP-ga, mis käivitab bin/magento.
• Magento cron, mis käivitub iga minut. Laiendus saadab kõik cronist. Ilma selleta ei jõua Smailysse midagi.
• API-ligipääsuga Smaily kontot. Loo Smailys API kasutaja menüüs Preferences > API — vaja läheb alamdomeeni, API kasutajanime ja API parooli. Konto pakett peab sisaldama API-ligipääsu.
• (Valikuline) Campaign Intelligence'i seadistuslinki — ühekordset linki aadressil https://intelligence.smaily.com/…, mille Smaily annab, kui kasutad soovituste lisateenust.
• (Campaign Intelligence'iga) Kahte poe veebilehe aadressi, mida sinu tulemüür läbi laseb. Ostja brauser postitab sinu poe enda domeenil aadressile POST /smaily/attribution/land (e-kirja lingi klikk, et sinu server seaks kampaaniakliki küpsised) ja aadressile POST /smaily/relay (sirvimissündmused). Veebirakenduse tulemüür, CDN-i reegel või turvamoodul peab mõlemad läbi laskma. Need ei vaja sisselogimist ega sisalda nime ega e-posti aadressi — ainult külastajatunnust, lingi väärtusi ja tooteid, mida ostja vaatas. Kui need on blokeeritud, lähevad sirvimissündmused kaduma ja kliki küpsised seab hoopis brauser (Safari hoiab neid kõige rohkem 7 päeva).

Magento 2.4.3 ja vanemad ei suuda Smaily Connecti käitada. Kui sinu pood on miinimumist madalamal, uuenda see kõigepealt.

The recommended way is composer. Until 3.0.0 is released, give the release candidate's exact version, as the releases page names it: composer require smaily/smailyformagento without a version installs the old 2.8.1, and ^3.0 does not install a release candidate on a standard Magento project, which accepts stable versions only. From 3.0.0 on, composer require smaily/smailyformagento is enough.

Run the commands from the Magento root, as the user that owns the Magento files. bin/magento deploy:mode:show shows the mode. In production mode:

bin/magento maintenance:enable
composer require smaily/smailyformagento:3.0.0-rc17
bin/magento module:enable Smaily_Connect
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy en_US   # every locale your store uses
bin/magento maintenance:disable
bin/magento cache:flush

Keep maintenance mode on until the last command: until setup:static-content:deploy has run, every storefront and admin page fails.

In developer or default mode, composer require, module:enable, setup:upgrade and cache:flush are enough.

Without composer, install the release ZIP into app/code/Smaily/Connect. The full steps — checking the download, production and developer mode, cron, updating and removing — are in INSTALLING.md.

After the install, the admin notifications show Smaily Connect is ready to set up, with a Read Details link to this guide. Finishing the initial setup marks it read.

Upgrading from Smaily for Magento 2.8.x? See Upgrading from 2.8.x first.

Soovitatav viis on composer. Kuni 3.0.0 väljalaskeni anna väljalaskekandidaadi täpne versioon, nagu väljalasete leht selle nimetab: composer require smaily/smailyformagento ilma versioonita paigaldab vana 2.8.1 ja ^3.0 ei paigalda tavalises Magento projektis väljalaskekandidaati, sest see lubab ainult stabiilseid versioone. Alates versioonist 3.0.0 piisab käsust composer require smaily/smailyformagento.

Käivita käsud Magento juurkaustas, Magento failide omaniku kasutajana. Režiimi näitab bin/magento deploy:mode:show. Tootmisrežiimis:

bin/magento maintenance:enable
composer require smaily/smailyformagento:3.0.0-rc17
bin/magento module:enable Smaily_Connect
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy en_US   # kõik poe keeleseaded
bin/magento maintenance:disable
bin/magento cache:flush

Hoia hooldusrežiim sees viimase käsuni: kuni setup:static-content:deploy pole käivitunud, annab iga poe ja halduse leht vea.

Arendus- või vaikerežiimis piisab käskudest composer require, module:enable, setup:upgrade ja cache:flush.

Ilma composerita paigalda väljalaske ZIP kausta app/code/Smaily/Connect. Kõik sammud — allalaaditud faili kontroll, tootmis- ja arendusrežiim, cron, uuendamine ja eemaldamine — on juhendis INSTALLING.md (inglise keeles).

Pärast paigaldust näitavad halduse teated Smaily Connect on seadistamiseks valmis koos lingiga Read Details, mis viib sellesse juhendisse. Algseadistuse lõpetamine märgib teate loetuks.

Uuendad versioonilt Smaily for Magento 2.8.x? Vaata kõigepealt jaotist Uuendamine versioonilt 2.8.x.

Everything lives under Marketing > Smaily Connect, on four pages:

These pages are the only place to configure Smaily Connect — there is no entry under Stores > Configuration.

The bottom of the Dashboard and the Settings page names the installed version, "Smaily Connect" followed by the version number. Give it when you contact Smaily support.

Kõik asub menüüs Turundus > Smaily Connect (ingliskeelses halduses Marketing > Smaily Connect), neljal lehel:

Need lehed on ainus koht Smaily Connecti seadistamiseks — menüüs Stores > Configuration sellel kirjet pole.

Töölaua ja lehe Seaded allservas on paigaldatud versioon: „Smaily Connect“ ja versiooninumber. Nimeta see, kui pöördud Smaily klienditoe poole.

You set Smaily Connect up once for the whole store, however many Magento websites it has: the initial setup asks for no website, and every value it saves applies to all websites. A website differs only where you give it its own values in Settings.

On a store with more than one website, the Connect, Contacts and Automations steps list under Websites with their own values each website that already holds its own values for the step's settings — for example carried over from Smaily for Magento 2.8.x — with those values. Each one keeps them (Keep its own values) unless you pick Use this step's values for it before you press Continue. The Contacts step names the websites its save starts contact sync on. Per-language Smaily accounts are set for one website, in Settings — see Multilingual stores.

On Settings, a Website selector next to the tabs picks the website whose values you see. On the Connection, Contacts and Automations tabs, Use its own Smaily account on this website, Use its own Contacts settings on this website and Use its own automations on this website give that website its own values: ticked, the tab's save keeps them for that website alone. Unticked, the tab shows the settings saved for all websites, and a change there applies to every website that uses them. Untick it on a website that has its own values and save to remove them: the website then uses the settings for all websites again. A store with one website sees neither the selector nor these switches.

A website that uses another Smaily account than the one saved for all websites always has its own automations, because the workflows saved for all websites come from that other account: its Use its own automations on this website stays ticked, and the initial setup's Automations step keeps them. The account decides, not where its login is saved: a website with its own login of the same account (the same subdomain and API username) keeps the automations saved for all websites, and so does every website while no Smaily account is saved for all websites. Saving another account for a website on the Connection tab starts its automations with no workflow: pick its workflows from its own account on the Automations tab and press Save Automations. Until then no automation starts on that website — the tab asks you to Pick this website's workflows, and the Log shows each automation as Skipped, naming the website. The same holds for a website that already had another account but used the automations saved for all websites. Untick its own Smaily account and save, and the website uses the Smaily account and the automations saved for all websites again.

Campaign Intelligence is one connection for the whole installation, whichever website is selected. Each product is sent to it once, with the price and link of your default website (or of the first website the product is sold on).

Smaily Connecti seadistad kogu poe jaoks üks kord, olenemata sellest, mitu Magento veebisaiti poel on: algseadistus ei küsi veebisaiti ja iga väärtus, mille see salvestab, kehtib kõigil veebisaitidel. Veebisait erineb ainult seal, kus annad talle lehel Seaded oma väärtused.

Mitme veebisaidiga poes loetlevad sammud Ühenda, Kontaktid ja Automaatikad pealkirja Oma väärtustega veebisaidid all iga veebisaidi, millel on selle sammu seadetele juba oma väärtused — näiteks Smaily for Magento 2.8.x-ist üle toodud —, koos nende väärtustega. Iga veebisait jääb oma väärtuste juurde (Jäta tema oma väärtused), kui sa ei vali tema jaoks enne nupu Jätka vajutamist Kasuta selle sammu väärtusi. Samm Kontaktid nimetab veebisaidid, kus selle salvestamine käivitab kontaktide sünkroonimise. Keelepõhised Smaily kontod seadistatakse ühele veebisaidile, lehel Seaded — vt Mitmekeelsed poed.

Lehel Seaded valib vahekaartide kõrval olev valik Veebisait, mille veebisaidi väärtusi näed. Vahekaartidel Ühendus, Kontaktid ja Automaatikad annavad valikud Kasuta sellel veebisaidil oma Smaily kontot, Kasuta sellel veebisaidil oma kontaktide seadeid ja Kasuta sellel veebisaidil oma automaatikaid sellele veebisaidile oma väärtused: linnukesega salvestab vahekaart need ainult selle veebisaidi jaoks. Ilma linnukeseta näitab vahekaart kõigi veebisaitide jaoks salvestatud seadeid ja seal tehtud muudatus kehtib igal veebisaidil, mis neid kasutab. Võta linnuke ära veebisaidil, millel on oma väärtused, ja salvesta, et need eemaldada: siis kasutab veebisait jälle kõigi veebisaitide seadeid. Ühe veebisaidiga pood ei näe valikut ega neid lüliteid.

Veebisaidil, mis kasutab muud Smaily kontot kui kõigi veebisaitide jaoks salvestatu, on alati oma automaatikad, sest kõigi veebisaitide jaoks salvestatud töövood on sellelt teiselt kontolt: tema valik Kasuta sellel veebisaidil oma automaatikaid jääb linnukesega ja algseadistuse samm Automaatikad jätab need alles. Otsustab konto, mitte see, kuhu selle sisselogimisandmed on salvestatud: veebisait, millel on sama konto oma sisselogimisandmed (sama alamdomeen ja API kasutajanimi), jääb kõigi veebisaitide jaoks salvestatud automaatikate juurde, ja nii ka iga veebisait seni, kuni kõigi veebisaitide jaoks pole Smaily kontot salvestatud. Kui salvestad vahekaardil Ühendus veebisaidile muu konto, algavad tema automaatikad ilma töövoota: vali vahekaardil Automaatikad tema töövood tema enda kontolt ja vajuta Salvesta automaatikad. Seni ei käivitu sellel veebisaidil ükski automaatika — vahekaart palub Vali selle veebisaidi töövood ja Logi näitab iga automaatikat olekuga Vahele jäetud, veebisaidi nimega. Sama kehtib veebisaidi kohta, millel oli juba muu konto, kuid mis kasutas kõigi veebisaitide jaoks salvestatud automaatikaid. Kui võtad oma Smaily konto linnukese ära ja salvestad, kasutab veebisait jälle kõigi veebisaitide jaoks salvestatud Smaily kontot ja automaatikaid.

Campaign Intelligence on kogu paigalduse peale üks ühendus, olenemata valitud veebisaidist. Iga toode saadetakse sinna üks kord, vaikimisi veebisaidi hinna ja lingiga (või esimese veebisaidi omaga, kus toodet müüakse).

Open Marketing > Smaily Connect > Initial setup. The step list on the left shows the five steps; a step you have completed stays open, so you can move back and forth.

1. Enter the Subdomain — if your Smaily URL is https://demo.sendsmaily.net, the subdomain is demo. Pasting the full URL also works.
2. Enter the API username and API password of your Smaily API user. The password is stored encrypted.
3. Press Test connection. It checks the credentials as typed, without saving; a success also loads your workflows for step 3.
4. If your store languages use different Smaily accounts or workflows, pick how under How is Smaily organized for your store languages? — see Multilingual stores. A single-language store does not see this.
5. Shoppers buy on a separate (headless) storefront? Open Using a separate storefront? and enter its address as Storefront URL now — see Using a separate storefront?.
6. (Optional) Order and shipping confirmations through a separate transactional Smaily account? Below your Smaily account, the Transactional emails card offers it: switch on Send transactional emails, enter its Subdomain, API username and API password, and press its own Test connection. Once Smaily accepts it, step 3 shows its triggers. The step saves it for all websites; a website's own transactional account is set under Settings › Connection — see Transactional emails.
7. Press Continue. The step is saved, even if Smaily did not accept the credentials; the last step then tells you so. Saving the connection sends no contacts yet: contact sync starts when step 2 is saved.

The setup opens on this step until you continue from it, also when Smaily login details are saved already (for example carried over from 2.8.x); the saved values are filled in. A finished setup reopens on this step as a summary marked Completed; Edit credentials brings the form back. On a store with more than one website where no Smaily account is saved for all websites — only the websites' own, for example carried over from 2.8.x — the summary lists those websites under Websites with their own values instead, with their subdomain and API username: Continue keeps them, and Edit credentials lets you save a Smaily account for all websites.

Ava Turundus > Smaily Connect > Algseadistus. Vasakul olev sammude loend näitab viit sammu; tehtud samm jääb avatuks, nii et saad edasi-tagasi liikuda.

1. Sisesta Alamdomeen — kui sinu Smaily URL on https://demo.sendsmaily.net, on alamdomeen demo. Sobib ka täieliku URL-i kleepimine.
2. Sisesta oma Smaily API kasutaja API kasutajanimi ja API parool. Parool salvestatakse krüpteeritult.
3. Vajuta Testi ühendust. See kontrollib sisestatud kasutajaandmeid ilma salvestamata; õnnestumisel laaditakse ka sammu 3 töövood.
4. Kui sinu poe keeled kasutavad eri Smaily kontosid või töövooge, vali see küsimuse Kuidas on Smaily sinu poe keelte jaoks korraldatud? all — vt Mitmekeelsed poed. Ühekeelne pood seda ei näe.
5. Ostjad ostavad eraldi (headless) poe veebilehel? Ava Kas pood töötab eraldi veebilehel? ja sisesta selle aadress kohe väljale Poe veebilehe aadress — vt Kas pood töötab eraldi veebilehel?.
6. (Valikuline) Ostu ja tarne kinnituskirjad eraldi tehingulise Smaily konto kaudu? Sinu Smaily konto all pakub seda kaart Tehingulised kirjad: lülita sisse Saada tehingulisi kirju, sisesta selle konto Alamdomeen, API kasutajanimi ja API parool ning vajuta tema enda nuppu Testi ühendust. Kui Smaily konto vastu võtab, näitab samm 3 selle päästikuid. Samm salvestab konto kõigile veebisaitidele; veebisaidi oma tehinguline konto seadistatakse jaotises Seaded › Ühendus — vt Tehingulised kirjad.
7. Vajuta Jätka. Samm salvestatakse ka siis, kui Smaily kasutajaandmeid vastu ei võtnud; viimane samm ütleb sulle siis selle. Ühenduse salvestamine ei saada veel ühtegi kontakti: kontaktide sünkroonimine algab sammu 2 salvestamisel.

Seadistus avaneb sellel sammul, kuni sa sellest edasi lähed, ka siis, kui Smaily kasutajaandmed on juba salvestatud (näiteks 2.8.x-ist üle toodud); salvestatud väärtused on täidetud. Lõpetatud seadistus avaneb uuesti sellel sammul kokkuvõttena märkega Lõpetatud; Muuda kasutajaandmeid toob vormi tagasi. Mitme veebisaidiga poes, kus kõigi veebisaitide jaoks pole Smaily kontot salvestatud — ainult veebisaitide oma kontod, näiteks 2.8.x-ist üle toodud —, loetleb kokkuvõte selle asemel pealkirja Oma väärtustega veebisaidid all need veebisaidid koos nende alamdomeeni ja API kasutajanimega: Jätka jätab need alles ja Muuda kasutajaandmeid laseb salvestada Smaily konto kõigile veebisaitidele.

Contact synchronization to Smaily. This is a lawful-basis choice: pick the mode that matches how you have asked your customers for permission.

• Subscribers only (consent) — Recommended. Only newsletter subscribers are synced, and unsubscribes in Smaily come back to Magento.
• All customers (legitimate interest) — every registered customer is synced (soft opt-in).
• Checkout opt-in only — only shoppers who tick the newsletter checkbox at checkout.

Then pick the extra fields and the checkout options, and press Continue. Contact sync starts when this step is saved, as the step says — on a store with more than one website, on every website, and the step names them; a website that keeps its own Contacts settings (see If your store has several websites) syncs as those settings say. Until then nothing goes to Smaily for the website — no subscription or unsubscribe, no registration, no order — and the checkout shows no newsletter checkbox, even after step 1 has saved the connection. From the save on, contacts sync in the mode you picked. A website that synced contacts before an upgrade — from 2.8.x with its synchronization on, or from an earlier 3.0.0 release candidate with its Smaily account connected — keeps syncing without this step being saved again. A website whose contact sync is off is the exception (for example after an upgrade from 2.8.x with Enable Module = No): there the step shows Sync contacts to Smaily unticked, and saving keeps sync off unless you tick it. Saving sends none of the contacts you already have: they reach Smaily only when you press Start import on the Initial contact import card — see What gets imported. Each option is explained under Settings › Contacts.

Kontaktide sünkroonimine Smailysse. See on õigusliku aluse valik: vali režiim, mis vastab sellele, kuidas oled klientidelt luba küsinud.

• Ainult turunduskirjade tellijad (nõusolekuga) — Soovitatud. Sünkroonitakse ainult uudiskirja tellijad ning Smailys tehtud loobumised jõuavad tagasi Magentosse.
• Kõik kliendid (õigustatud huvi) — sünkroonitakse iga registreeritud klient (pehme nõusolek).
• Ainult kassas turunduskirjade nõusoleku andnud kontaktid — ainult ostjad, kes märgivad kassas uudiskirja märkeruudu.

Seejärel vali lisaväljad ja kassa valikud ning vajuta Jätka. Kontaktide sünkroonimine algab selle sammu salvestamisel, nagu samm ise ütleb — mitme veebisaidiga poes igal veebisaidil, ja samm nimetab need; veebisait, mis jääb oma kontaktide seadete juurde (vt Kui poel on mitu veebisaiti), sünkroonib nende seadete järgi. Seni ei saadeta veebisaidi kohta Smailysse midagi — ei uudiskirja tellimist ega sellest loobumist, kliendikonto loomist ega tellimust — ja kassas ei ole uudiskirja märkeruutu, ka siis, kui samm 1 on ühenduse juba salvestanud. Salvestamisest alates sünkroonitakse kontakte sinu valitud režiimis. Veebisait, mis sünkroonis kontakte juba enne uuendamist — versioonist 2.8.x, kus sünkroonimine oli sees, või varasemast 3.0.0 väljalaskekandidaadist, kus Smaily konto oli ühendatud —, sünkroonib edasi ilma seda sammu uuesti salvestamata. Erand on veebisait, kus kontaktide sünkroonimine on väljas (näiteks pärast uuendamist versioonist 2.8.x, kus oli Enable Module = No): seal näitab samm valikut Sünkrooni kontaktid Smailysse ilma linnukeseta ja salvestamine jätab sünkroonimise välja, kui sa linnukest ei pane. Salvestamine ei saada ühtegi juba olemasolevat kontakti: need jõuavad Smailysse alles siis, kui vajutad kaardil Esmane kontaktide import nuppu Alusta importi — vt Mida imporditakse. Iga valikut selgitab jaotis Seaded › Kontaktid.

Map store events to Smaily automations. For each event — Welcome, First order, Abandoned cart — tick Enabled and pick a Smaily Workflow. The lists come live from your Smaily account and show only enabled workflows whose trigger is form submitted — the only trigger the Smaily API can start. Missing a workflow? Create it in Smaily, then press Refresh workflows.

Once Smaily accepts the transactional Smaily account of step 1, this step also shows Order confirmation and Shipping confirmation — see Transactional emails.

Not ready yet? Leave the events unticked and continue; you can switch them on later under Settings › Automations.

Seo poe sündmused Smaily automaatikatega. Iga sündmuse — Tervitus, Esimene tellimus, Hüljatud ostukorv — juures märgi Lubatud ja vali Smaily töövoog. Loendid tulevad otse sinu Smaily kontolt ja näitavad ainult lubatud töövooge, mille päästik on form submitted (vorm on esitatud) — see on ainus päästik, mida Smaily API saab käivitada. Töövoog on puudu? Loo see Smailys ja vajuta siis Värskenda töövooge.

Kui Smaily on sammu 1 tehingulise Smaily konto vastu võtnud, näitab see samm ka päästikuid Ostu kinnituskiri ja Tarne kinnituskiri — vt Tehingulised kirjad.

Pole veel valmis? Jäta sündmused märkimata ja jätka; saad need hiljem sisse lülitada jaotises Seaded › Automaatikad.

Campaign Intelligence is an optional paid add-on (€250/month) on top of your Smaily monthly payment. Have a setup link from Smaily? Paste it into Setup URL or token from Smaily and press Connect — see Settings › Intelligence for what happens next. Otherwise press Finish; you can connect later.

Campaign Intelligence on valikuline tasuline lisateenus (250 €/kuus), mis lisandub sinu Smaily kuumaksele. Kas sul on Smailylt saadud seadistuslink? Kleebi see väljale Smailylt saadud seadistus-URL või -võti ja vajuta Ühenda — mis edasi saab, kirjeldab jaotis Seaded › Intelligence. Muul juhul vajuta Lõpeta; saad ühendada hiljem.

You are all set! The last step says that Smaily Connect is syncing — or, if Smaily has not accepted the credentials, that syncing starts once it does, and to check them under Settings > Connection. It lists where everything lives, the address of your product RSS feed and a link to this guide. Go to Dashboard or Open Settings to carry on.

Then check two things: that Magento's cron runs every minute, and that the Dashboard says All systems normal after the first deliveries.

Kõik on valmis! Viimane samm ütleb, et Smaily Connect sünkroonib — või, kui Smaily pole kasutajaandmeid vastu võtnud, et sünkroonimine algab siis, kui ta need vastu võtab, ja et kontrolliksid neid jaotises Seaded > Ühendus. See loetleb, kus mis asub, sinu toodete RSS-voo aadressi ja lingi sellele juhendile. Jätkamiseks vajuta Ava töölaud või Ava seaded.

Seejärel kontrolli kahte asja: et Magento cron käivitub iga minut ja et töölaud ütleb pärast esimesi saadetisi Kõik toimib normaalselt.

Your Smaily API credentials, saved for all websites — or, with Use its own Smaily account on this website, for the selected website only (see If your store has several websites): Subdomain, API username, API password. Test connection checks what you typed without saving; Save Connection saves it and asks Smaily once.

• Connected beside Status means Smaily accepted the saved credentials the last time they were checked — at a test or a save. Changed credentials read Not connected until checked, and so do credentials Smaily later refuses (for example after the API user was removed).
• A password is never shown again. Leave API password empty to keep the saved one — but after you change the subdomain or username, enter the password too, or the save is refused on the password field.
• Wrong credentials do not block a save: it shows Saved. and the status turns Not connected. Press Test connection to see Smaily's reason.
• When a save or a test fails, a banner above the form says why, and the field at fault is marked in red with the message under it.

Sinu Smaily API kasutajaandmed, salvestatud kõigile veebisaitidele — või valikuga Kasuta sellel veebisaidil oma Smaily kontot ainult valitud veebisaidile (vt Kui poel on mitu veebisaiti): Alamdomeen, API kasutajanimi, API parool. Testi ühendust kontrollib sisestatut ilma salvestamata; Salvesta ühendus salvestab selle ja küsib Smailylt üks kord.

• Ühendatud välja Olek kõrval tähendab, et Smaily võttis salvestatud kasutajaandmed vastu, kui neid viimati kontrolliti — testil või salvestamisel. Muudetud kasutajaandmed näitavad kuni kontrollimiseni Pole ühendatud, nagu ka need, millest Smaily hiljem keeldub (näiteks pärast API kasutaja eemaldamist).
• Parooli kunagi uuesti ei näidata. Jäta API parool tühjaks, et salvestatud parool alles hoida — aga kui muudad alamdomeeni või kasutajanime, sisesta ka parool, muidu lükatakse salvestamine parooliväljal tagasi.
• Valed kasutajaandmed salvestamist ei takista: kuvatakse Salvestatud. ja olek muutub Pole ühendatud. Smaily põhjuse nägemiseks vajuta Testi ühendust.
• Kui salvestamine või test ebaõnnestub, ütleb vormi kohal olev riba põhjuse ja vigane väli märgitakse punasega, teade selle all.

When shoppers buy on a separate (headless) storefront and Magento is the back end only, open Using a separate storefront? under the account fields and enter the storefront's address as Storefront URL, for example https://shop.example.com. It is kept per website and saved with Save Connection (in the initial setup, with step 1's Continue).

• What changes: the product links sent to Campaign Intelligence and in the RSS feed start with the storefront's address; the path and query of each link stay. Image links, the abandoned-cart link and Magento's own emails do not change. Leave the field empty to use Magento's own links.
• What is accepted: an https:// address with the host only — no path, query or fragment (a trailing / is dropped).
• After you change it: run the Catalog import again under Settings > Intelligence, so Campaign Intelligence gets the new links; the save result reminds you. The RSS feed follows within 15 minutes.
• Set it before you connect Campaign Intelligence — connecting starts the catalog import at once.

The section opens by itself, with a sentence saying why, when every order of the last 30 days came through Magento's API — the way a separate storefront places them. An order created in the admin, or placed with Login as Customer, does not count either way. The storefront must open Magento's product paths (or redirect them, keeping the query string). See A separate storefront.

Kui ostjad ostavad eraldi (headless) poe veebilehel ja Magento on ainult taustasüsteem, ava kontoväljade all Kas pood töötab eraldi veebilehel? ja sisesta poe veebilehe aadress väljale Poe veebilehe aadress, näiteks https://shop.example.com. See hoitakse veebisaidi kaupa ja salvestatakse nupuga Salvesta ühendus (algseadistuses sammu 1 nupuga Jätka).

• Mis muutub: Campaign Intelligence'i ja RSS-voogu saadetavad tootelingid algavad poe veebilehe aadressiga; iga lingi tee ja päring jäävad samaks. Pildilingid, hüljatud ostukorvi link ja Magento enda e-kirjad ei muutu. Jäta väli tühjaks, et kasutada Magento enda linke.
• Mis sobib: https://-aadress ainult hostiga — ilma tee, päringu ja fragmendita (lõpus olev / jäetakse ära).
• Pärast muutmist: käivita jaotises Seaded > Intelligence uuesti Kataloog-import, et Campaign Intelligence saaks uued lingid; salvestamise tulemus tuletab seda meelde. RSS-voog järgneb 15 minuti jooksul.
• Sisesta see enne Campaign Intelligence'i ühendamist — ühendamine käivitab kohe kataloogi impordi.

Jaotis avaneb ise, koos lausega põhjuse kohta, kui kõik viimase 30 päeva tellimused tulid Magento API kaudu — nii, nagu eraldi poe veebileht neid esitab. Adminis loodud või funktsiooniga Login as Customer esitatud tellimust ei arvestata. Poe veebileht peab avama Magento tooteteed (või need ümber suunama, päringut säilitades). Vt Eraldi poe veebileht.

A store view's language comes from its locale (et_EE → et). As soon as your store views speak more than one language, the Connection panel asks How is Smaily organized for your store languages? with four cards. The panels below follow the card you pick; nothing is saved until you save.

• Per-language workflows. In the two per-language modes, the Automations tab adds a Per-language workflows table: one workflow per trigger and language, and a Default fallback row. A contact's automation uses its language row, else the Default fallback row. After that, One account, per-language workflows uses the workflow at the top of the tab. Per-language Smaily accounts never does — that workflow belongs to none of the language accounts — so the tab hides it, and the automation uses the workflow of the Default fallback account's language, through that account. With none there either, the contact gets no automation: the Log shows the row as Skipped, naming the language, and the Automations tab lists each switched-on automation with the languages it has no workflow for, under Some languages have no workflow.
• Default fallback account. Handles contacts whose language matches no account; its credentials also serve every store view without its own account. When you pick another one, enter its password.
• Switching mode away from per-language accounts removes the per-store-view credentials on save (the panel asks first). Each of the two per-language modes keeps its own Per-language workflows: the table shows the workflows of the card you pick, and automations use only those, so One account, per-language workflows never starts a workflow picked for a per-language account. The workflows of the mode you leave stay saved and show again when you switch back. After a switch back to Per-language Smaily accounts, enter the accounts again and check the table: a workflow the account does not list shows as Workflow #… (not in your Smaily list — kept). The other two cards use no table.
• A store view changed language? Open Settings > Connection, check the block of its new language and save; until then it keeps the old language's account.
• Several websites. Per-language Smaily accounts belong to the store views of one website, so on a store with more than one website the initial setup does not offer them. Pick the website on Settings > Connection and tick Use its own Smaily account on this website; the Per-language Smaily accounts card then shows. Such a website also keeps its own automations, because their workflows come from its accounts: on its Automations tab, Use its own automations on this website stays ticked. On a store with one website the initial setup offers per-language accounts; they then stay with that website, and a website you add later does not use them.

Poevaate keel tuleneb selle lokaadist (et_EE → et). Niipea kui sinu poevaated räägivad rohkem kui ühte keelt, küsib ühenduse paneel Kuidas on Smaily sinu poe keelte jaoks korraldatud? nelja kaardiga. Allolevad paneelid järgivad valitud kaarti; midagi ei salvestata enne, kui salvestad.

• Keelepõhised töövood. Kahes keelepõhises režiimis lisandub vahekaardile Automaatikad tabel Keelepõhised töövood: üks töövoog päästiku ja keele kohta ning rida Vaikimisi varuvalik. Kontakti automaatika kasutab tema keele rida, selle puudumisel rida Vaikimisi varuvalik. Kui ka seda pole, kasutab Üks konto, keelepõhised töövood vahekaardi ülaosas olevat töövoogu. Keelepõhised Smaily kontod seda ei tee — see töövoog ei kuulu ühelegi keele kontole —, seega peidab vahekaart selle ja automaatika kasutab Vaikimisi varukonto keele töövoogu, selle konto kaudu. Kui ka seal töövoogu pole, ei saa kontakt automaatikat: logi näitab rida kui Vahele jäetud ja nimetab keele ning vahekaart Automaatikad loetleb pealkirja Mõnel keelel pole töövoogu all iga sisselülitatud automaatika koos keeltega, millel töövoogu pole.
• Vaikimisi varukonto. Käsitleb kontakte, kelle keel ei sobi ühegi kontoga; selle kasutajaandmed teenindavad ka kõiki poevaateid, millel oma kontot pole. Kui valid uue varukonto, sisesta selle parool.
• Režiimi vahetamine keelepõhistelt kontodelt eemaldab salvestamisel poevaatepõhised kasutajaandmed (paneel küsib enne kinnitust). Kummalgi keelepõhisel režiimil on oma Keelepõhised töövood: tabel näitab valitud kaardi töövooge ja automaatikad kasutavad ainult neid, nii et Üks konto, keelepõhised töövood ei käivita kunagi keelepõhise konto jaoks valitud töövoogu. Režiimi, millelt lahkud, töövood jäävad salvestatuks ja ilmuvad tagasi, kui sellele režiimile naased. Kui naased kaardile Keelepõhised Smaily kontod, sisesta kontod uuesti ja kontrolli tabelit: töövoog, mida konto ei loetle, on kujul Töövoog #… (pole sinu Smaily loendis — säilitatud). Ülejäänud kaks kaarti tabelit ei kasuta.
• Poevaate keel muutus? Ava Seaded > Ühendus, kontrolli uue keele plokki ja salvesta; seni kasutab poevaade vana keele kontot.
• Mitu veebisaiti. Keelepõhised Smaily kontod kuuluvad ühe veebisaidi poevaadetele, seega mitme veebisaidiga poes algseadistus neid ei paku. Vali veebisait lehel Seaded > Ühendus ja märgi Kasuta sellel veebisaidil oma Smaily kontot; siis ilmub kaart Keelepõhised Smaily kontod. Sellisel veebisaidil on ka oma automaatikad, sest nende töövood tulevad tema kontodelt: tema vahekaardil Automaatikad jääb valik Kasuta sellel veebisaidil oma automaatikaid märgituks. Ühe veebisaidiga poes pakub algseadistus keelepõhiseid kontosid; need jäävad selle veebisaidi juurde ja hiljem lisatud veebisait neid ei kasuta.

Order confirmations and shipping confirmations can go through a separate Smaily account, used only for these emails and kept apart from your marketing account, so that a marketing bounce or complaint never threatens their delivery. Contact Smaily support (support@smaily.com) to set up a transactional Smaily account.

The account — Settings › Connection

Below your Smaily account, the Transactional emails card has the Send transactional emails switch, off by default: it is the master switch of these emails, and each trigger on the Automations tab has its own Enabled too. Switch it on to show the Transactional Smaily account: Subdomain, API username, API password and its own Test connection. Save Connection saves the switch and the account together with your Smaily account and asks Smaily once; Connected beside its Test connection means Smaily accepted it. As with your Smaily account, the password is stored encrypted and never shown again; leave it empty to keep the saved one. Empty the fields and save to remove the account. Switched off, the account is hidden and stays saved as it is.

Every Smaily setting here is per website, so on an installation with more than one website, Use a separate account for this website gives the selected website its own transactional account instead of the one saved for all websites.

The initial setup offers the same card in step 1, without Use a separate account for this website: Continue saves the switch and the account for all websites, and step 3 shows the triggers below.

The triggers — Settings › Automations

Until Smaily accepts the transactional account, the Automations tab shows nothing of it. It accepts it when its Test connection succeeds — the triggers then show at once, before you save — or when Save Connection saves it; changing its fields hides them again until the next test or save. Once it does, the Transactional emails card shows Order confirmation and Shipping confirmation, each with Enabled (off by default) and the Smaily workflow it will use, listed from the transactional account, so you can turn on order confirmations without shipping confirmations, or the other way round. Press Save Automations to save them.

Shipping confirmation is sent when a shipment is created for the order, so there are no order statuses to pick.

Multilingual store: on a website with more than one store language, each trigger shows one workflow per language, whatever the multilingual mode, and a Default fallback for a language without a workflow.

Customer details

Below the two triggers, Customer details → Include addresses, phone and order note adds the delivery name, the billing and delivery address, the phone number and the customer's order note to both emails once sending arrives. It is off by default — this is personal data, so switch it on only if your email template shows these details.

Ostu ja tarne kinnituskirjad saavad minna läbi eraldi Smaily konto, mida kasutatakse ainult nende kirjade jaoks ja hoitakse turunduskontost lahus, et turunduskirjade tagasipõrked või kaebused ei ohustaks kunagi nende kohalejõudmist. Tehingulise Smaily konto seadistamiseks võta ühendust Smaily klienditoega (support@smaily.com).

Konto — Seaded › Ühendus

Sinu Smaily konto all on kaardil Tehingulised kirjad lüliti Saada tehingulisi kirju, vaikimisi väljas: see on nende kirjade pealüliti ja igal päästikul vahekaardil Automaatikad on ka oma Lubatud. Lülita see sisse, et näha osa Tehinguliste kirjade Smaily konto: väljad Alamdomeen, API kasutajanimi, API parool ja oma nupp Testi ühendust. Salvesta ühendus salvestab lüliti ja konto koos sinu Smaily kontoga ja küsib Smailylt üks kord; Ühendatud tema nupu Testi ühendust kõrval tähendab, et Smaily võttis konto vastu. Nagu sinu Smaily kontol, salvestatakse parool krüpteeritult ja seda ei näidata enam kunagi; jäta väli tühjaks, et salvestatud parool alles jääks. Konto eemaldamiseks tühjenda väljad ja salvesta. Väljalülitatuna on konto peidus ja jääb salvestatuna alles.

Iga Smaily seadistus on siin veebisaidi põhine, seega saad mitme veebisaidiga paigalduses valikuga Kasuta selle veebisaidi jaoks eraldi kontot anda valitud veebisaidile kõigi veebisaitide jaoks salvestatud konto asemel oma tehingulise konto.

Algseadistus pakub sama kaarti sammus 1, ilma valikuta Kasuta selle veebisaidi jaoks eraldi kontot: Jätka salvestab lüliti ja konto kõigile veebisaitidele ning samm 3 näitab allpool kirjeldatud päästikuid.

Päästikud — Seaded › Automaatikad

Kuni Smaily pole tehingulist kontot vastu võtnud, ei näita vahekaart Automaatikad sellest midagi. Smaily võtab selle vastu, kui konto test nupuga Testi ühendust õnnestub — päästikud ilmuvad siis kohe, juba enne salvestamist —, või kui Salvesta ühendus selle salvestab; konto väljade muutmine peidab need uuesti kuni järgmise testi või salvestamiseni. Kui konto on vastu võetud, näitab kaart Tehingulised kirjad päästikuid Ostu kinnituskiri ja Tarne kinnituskiri, kummalgi Lubatud (vaikimisi väljas) ja Smaily töövoog, mida see kasutama hakkab, valituna tehingulise konto töövoogude loendist, nii saad sisse lülitada ostu kinnituskirjad ilma tarne kinnituskirjadeta või vastupidi. Nende salvestamiseks vajuta Salvesta automaatikad.

Tarne kinnituskiri saadetakse, kui tellimusele luuakse saadetis, seega pole tellimuse olekuid, mida valida.

Mitmekeelne pood: veebisaidil, kus on rohkem kui üks poe keel, näitab iga päästik iga keele jaoks oma töövoogu, sõltumata mitmekeelsuse režiimist, ja valikut Vaikimisi varuvalik keele jaoks, millel töövoogu pole.

Kliendi andmed

Kahe päästiku all olev Kliendi andmed → Lisa aadressid, telefon ja tellimuse märkus lisab mõlemale kirjale saaja nime, arveldus- ja tarneaadressi, telefoninumbri ja kliendi märkuse tellimusele, kui saatmine lisandub. See on vaikimisi väljas — need on isikuandmed, nii et lülita see sisse ainult siis, kui su kirjapõhi neid andmeid näitab.

Sync contacts to Smaily switches contact sync on or off for the website. Changes sync within a minute or two, through a queue that retries on its own. A newsletter subscriber without a customer account (a guest) syncs, and is included in the contacts import, just as an account holder is.

Contact sync mode

When the subscription status goes to Smaily. Only when a subscriber's newsletter status changes in Magento — by the shopper on the storefront, by staff in the admin (the customer's Newsletter tab, the Newsletter Subscribers grid and its actions), through Magento's API or by a Magento import. That is a consent act: it goes to Smaily as subscribed or unsubscribed, and a new subscription subscribes again a contact who unsubscribed in Smaily. Everything else sends no status, so the contact keeps the one it has in Smaily: a profile save that does not change the newsletter status, the automations and their fields, and the extension's own contacts import (an address Smaily does not have yet is added as a subscriber; an unsubscribed subscriber is sent as unsubscribed). Who gets an abandoned-cart reminder in each mode: see Abandoned cart.

With Magento's Need to Confirm newsletter option on, a signup waits for its confirmation email and syncs once confirmed.

Deleting a subscriber in Marketing > Communications > Newsletter Subscribers (the grid's Delete action, for one row or many) does not change the contact in Smaily or turn personalization off: a deletion is not an unsubscribe, and the contact may have reached Smaily from another source, so it keeps its status there. To stop your emails to a subscriber, use the grid's Unsubscribe action instead: the contact is unsubscribed in Smaily, and with Campaign Intelligence connected personalization is turned off too (see Personalization opt-out). Deleting a customer account does not change the contact in Smaily either.

Other options

• Extra fields to sync with each contact — First name, Last name, Name prefix, Phone, Gender, Date of birth, Customer ID, Customer group, Subscription type. Empty values are never sent, so existing Smaily data is not wiped. The field names in Smaily are listed under Email fields.
• Include guest order emails — also sync the emails of guest orders placed without the checkout opt-in. Applies only under All customers (legitimate interest).
• Show a newsletter checkbox at checkout — an unticked Subscribe to our newsletter box on the checkout's payment step, for guests and customers. Ticking it makes a real Magento newsletter subscriber (with Need to Confirm, after confirmation).
• Let Smaily send the opt-in confirmation emails (suppresses Magento's own) — while contact sync runs for the website, Magento stops sending its own subscription-success and unsubscribe emails, so your Smaily automations handle them. Before the Contacts settings are saved, or with Sync contacts to Smaily off, Magento sends them as usual. Magento's request to confirm a signup is always sent.

To send the contacts you already have, use the Initial contact import card on this tab — see What gets imported.

Sünkrooni kontaktid Smailysse lülitab veebisaidi kontaktide sünkroonimise sisse või välja. Muudatused sünkroonitakse minuti-paari jooksul järjekorra kaudu, mis proovib ise uuesti. Kliendikontota uudiskirja tellija (külaline) sünkroonitakse ja kaasatakse kontaktide importi samamoodi nagu kontoga klient.

Kontaktide sünkroonimise režiim

Millal läheb tellimuse olek Smailysse. Ainult siis, kui tellija uudiskirja olek Magentos muutub — ostja poes, töötaja halduses (kliendi vahekaart Newsletter, tabel Newsletter Subscribers ja selle toimingud), Magento API kaudu või Magento impordiga. See on nõusoleku toiming: see läheb Smailysse tellija või loobununa ning uus liitumine tellib uuesti ka kontakti, kes on Smailys loobunud. Kõik muu ei saada olekut, nii et kontakt säilitab Smailys oma oleku: profiili salvestamine, mis uudiskirja olekut ei muuda, automaatikad ja nende väljad ning laienduse enda kontaktide import (aadress, mida Smailys veel pole, lisatakse tellijana; loobunud tellija saadetakse loobununa). Kes saab igas režiimis hüljatud ostukorvi meeldetuletuse: vt Hüljatud ostukorv.

Kui Magento uudiskirja valik Need to Confirm on sees, ootab liitumine kinnituskirja ja sünkroonitakse pärast kinnitamist.

Tellija kustutamine menüüs Marketing > Communications > Newsletter Subscribers (tabeli toiming Delete, ühe või mitme rea jaoks) kontakti Smailys ei muuda ega lülita personaliseerimist välja: kustutamine ei ole loobumine ja kontakt võib olla Smailysse jõudnud ka mujalt, nii et selle olek jääb Smailys samaks. Kui tahad, et tellija sinu kirju enam ei saaks, kasuta selle asemel tabeli toimingut Unsubscribe: kontakt märgitakse Smailys loobunuks ja ühendatud Campaign Intelligence'i korral lülitatakse välja ka personaliseerimine (vt Personaliseerimisest loobumine). Ka kliendikonto kustutamine kontakti Smailys ei muuda.

Muud valikud

• Lisaväljad, mis sünkroonitakse iga kontaktiga — Eesnimi, Perekonnanimi, Nime eesliide, Telefon, Sugu, Sünnikuupäev, Kliendi ID, Kliendigrupp, Tellimuse tüüp. Tühje väärtusi ei saadeta kunagi, seega olemasolevaid Smaily andmeid ei kustutata. Väljade nimed Smailys on loetletud jaotises E-kirja väljad.
• Kaasa külalistellimuste e-posti aadressid — sünkrooni ka nende külalistellimuste e-posti aadressid, kus kassas nõusolekut ei antud. Kehtib ainult režiimis Kõik kliendid (õigustatud huvi).
• Näita kassas uudiskirja märkeruutu — märkimata ruut Liitu meie uudiskirjaga kassa maksesammul, nii külalistele kui klientidele. Märkimine teeb ostjast päris Magento uudiskirja tellija (valikuga Need to Confirm pärast kinnitamist).
• Lase Smailyl saata uudiskirjaga liitumise ja sellest loobumise kirjad (Magento enda kirjad jäetakse ära) — kui veebisaidi kontaktide sünkroonimine käib, ei saada Magento enam oma liitumise õnnestumise ja loobumise kirju, nii et nendega tegelevad sinu Smaily automaatikad. Enne kontaktide seadete salvestamist või kui Sünkrooni kontaktid Smailysse on väljas, saadab Magento need nagu tavaliselt. Magento palve liitumine kinnitada saadetakse alati.

Juba olemasolevate kontaktide saatmiseks kasuta sellel vahekaardil kaarti Esmane kontaktide import — vt Mida imporditakse.

Each store event starts the Smaily workflow you pick for it. Tick Enabled, pick the Smaily Workflow and press Save Automations. If the workflow list cannot load, the reason shows beside the save button.

• An automation for an address that is not a contact in your Smaily account adds it as a contact. It never re-subscribes a contact who unsubscribed.
• Each run also writes a date field onto the contact, for segments such as "got the welcome letter" — see When an automation last ran.
• Stop the abandoned-cart follow-ups once the shopper buys: on every follow-up step of the workflow, continue only while abandoned_cart_purchased_at is empty or earlier than abandoned_cart_automation_at. The extension writes the purchase time as soon as a reminded shopper places an order.
• Keep reminded guests out of newsletters: a reminder to a guest adds the guest to your Smaily account as a contact. To leave these contacts out of newsletter campaigns, exclude in the campaign's segment the contacts whose abandoned_cart_automation_at is set and who did not subscribe in your store.
• Campaign Intelligence's own automations are on this tab too, under the store events — see Campaign Intelligence automations.
• Order and shipping confirmations through a separate transactional account are set up here too, once that account is connected — see Transactional emails.
• A website on another Smaily account than the one saved for all websites starts only the workflows picked for it from its own account — see If your store has several websites.

Discount codes

The Welcome, First order and Abandoned cart cards each have a Send a discount code box. With it ticked, every email of that automation carries the shopper's own single-use discount code. The discount itself — its percentage or amount, minimum order, products, customer groups and dates — is one of your Magento cart price rules; the extension makes a new code from it for each shopper. Set it up like this:

1. In Magento, open Marketing > Cart Price Rules and press Add New Rule. Set the discount and its conditions, set Coupon to Specific Coupon, tick Use Auto Generation, make the rule active for the websites the automation sends for, and save it.
2. Reload this tab (or the initial setup's Automations step). On the automation's card, tick Send a discount code.
3. Pick the rule under Cart price rule and set Valid for (days) (1–365, 7 by default). The list shows only the active rules with Specific Coupon and Use Auto Generation for those websites. With none, the card says how to create one and links to Magento's new-rule page.
4. Press Save Automations, and put the code and its last day into the workflow's email — see Discount codes.

• A code works once, under the rule's conditions, until the end of its last valid day: that many days after the email, in your store's timezone (Stores > Configuration > General > General > Locale Options > Timezone), and never after the rule's To date. After that day, or once it was used, the cart answers with Magento's own "The coupon code isn't valid".
• The code is made when the email is sent. A send that is retried, or sent again from the Log, gets the same code. A skipped abandoned-cart reminder, or an automation with no workflow, makes none.
• The codes are ordinary coupon codes of the rule, in the format under Stores > Configuration > Customers > Promotions > Auto Generated Specific Coupon Codes, listed under the rule's Manage Coupon Codes.
• If the rule can't give a code when the email goes — deleted, inactive, without Use Auto Generation, not for that website, or outside its dates — the email goes without a code, and the row's Details in the Log say why.
• The discount code settings belong to the automations: a website with its own automations has its own (see If your store has several websites).

Iga poe sündmus käivitab Smaily töövoo, mille sa selle jaoks valid. Märgi Lubatud, vali Smaily töövoog ja vajuta Salvesta automaatikad. Kui töövoogude loendit ei õnnestu laadida, on põhjus salvestusnupu kõrval.

• Automaatika aadressile, mis pole su Smaily kontol kontakt, lisab selle kontaktiks. See ei telli kunagi uuesti kontakti, kes on loobunud.
• Iga käivitus kirjutab kontaktile ka kuupäevavälja, segmentide jaoks nagu „sai tervituskirja“ — vt Automaatika viimane käivitus.
• Peata hüljatud ostukorvi järelkirjad, kui ostja ostab: töövoo igas järelsammus jätka ainult siis, kui abandoned_cart_purchased_at on tühi või varasem kui abandoned_cart_automation_at. Laiendus kirjutab ostu aja kohe, kui meeldetuletuse saanud ostja tellimuse esitab.
• Hoia meeldetuletuse saanud külalised uudiskirjadest eemal: meeldetuletus külalisele lisab külalise su Smaily kontole kontaktiks. Et need kontaktid uudiskirja kampaaniatesse ei satuks, välista kampaania segmendis kontaktid, kellel on abandoned_cart_automation_at täidetud ja kes ei liitunud su poes.
• Campaign Intelligence'i enda automaatikad on samuti sellel vahekaardil, poe sündmuste all — vt Campaign Intelligence'i automaatikad.
• Ka ostu ja tarne kinnituskirjad eraldi tehingulise konto kaudu seadistatakse siin, kui see konto on ühendatud — vt Tehingulised kirjad.
• Veebisait, mis kasutab muud Smaily kontot kui kõigi veebisaitide jaoks salvestatu, käivitab ainult need töövood, mis on talle tema enda kontolt valitud — vt Kui poel on mitu veebisaiti.

Sooduskoodid

Kaartidel Tervitus, Esimene tellimus ja Hüljatud ostukorv on igaühel märkeruut Saada sooduskood. Kui see on märgitud, kannab selle automaatika iga e-kiri ostja enda ühekordset sooduskoodi. Soodustus ise — selle protsent või summa, minimaalne tellimus, tooted, kliendigrupid ja kuupäevad — on üks sinu Magento ostukorvi hinnareeglitest; laiendus loob sellest igale ostjale uue koodi. Seadista see nii:

1. Ava Magentos Marketing > Cart Price Rules ja vajuta Add New Rule. Määra soodustus ja selle tingimused, vali väljale Coupon Specific Coupon, märgi Use Auto Generation, tee reegel aktiivseks veebisaitidel, mille jaoks automaatika saadab, ja salvesta see.
2. Laadi see vahekaart uuesti (või algseadistuse samm Automaatikad). Märgi automaatika kaardil Saada sooduskood.
3. Vali reegel väljal Ostukorvi hinnareegel ja määra Kehtib (päeva) (1–365, vaikimisi 7). Loendis on ainult nende veebisaitide aktiivsed reeglid, millel on Specific Coupon ja Use Auto Generation. Kui ühtegi pole, ütleb kaart, kuidas see luua, ja viitab Magento uue reegli lehele.
4. Vajuta Salvesta automaatikad ja lisa kood ning selle viimane päev töövoo e-kirja — vt Sooduskoodid.

• Kood kehtib üks kord, reegli tingimustel, kuni oma viimase kehtivuspäeva lõpuni: nii mitu päeva pärast e-kirja, su poe ajavööndis (Stores > Configuration > General > General > Locale Options > Timezone), ja mitte kunagi pärast reegli kuupäeva To. Pärast seda päeva või pärast kasutamist vastab ostukorv Magento enda teatega „The coupon code isn't valid“.
• Kood luuakse e-kirja saatmisel. Uuesti proovitud või logist uuesti saadetud saatmine saab sama koodi. Vahele jäetud hüljatud ostukorvi meeldetuletus või töövoota automaatika koodi ei loo.
• Koodid on reegli tavalised kupongikoodid, kujul, mis on määratud menüüs Stores > Configuration > Customers > Promotions > Auto Generated Specific Coupon Codes, ja need on loetletud reegli jaotises Manage Coupon Codes.
• Kui reegel ei saa e-kirja saatmise ajal koodi anda — kustutatud, mitteaktiivne, ilma Use Auto Generation'ita, mitte selle veebisaidi jaoks või väljaspool oma kuupäevi —, läheb e-kiri ilma koodita ja logi rea Üksikasjad ütlevad, miks.
• Sooduskoodi seaded kuuluvad automaatikate juurde: veebisaidil, millel on oma automaatikad, on ka oma sooduskoodi seaded (vt Kui poel on mitu veebisaiti).

A cart counts as abandoned when it has products and an email address and has been idle longer than Wait (minutes) (default 30, minimum 10). The store checks for such carts every 5 minutes.

• A cart older than 24 hours is never mailed, so a cron that was down never sends stale reminders.
• Each cart is mailed once, and one email address gets at most one reminder in 24 hours, however many carts carry it. A further cart's row in the Log reads Skipped.
• The email can come from a signed-in customer or from a guest at checkout. On Magento's own checkout (Luma-based themes, and Hyvä's Luma-based checkout) a guest's typed email is saved to the cart two seconds after it becomes a valid address — so a guest who leaves on the shipping step can still be reminded.
• To stop the checkout being used to put other people's addresses on carts: one IP address can save at most 30 emails in 10 minutes, one cart takes at most five addresses, and the whole store at most 2,000 an hour.
• The reminder carries up to 10 products and a recovery link, abandoned_cart_url, that restores the exact cart (a registered customer signs in first). The link works for 30 days; after that it opens the cart page with "This cart link has expired."

Who gets a reminder

The website's contact sync mode decides, not whether contact sync is switched on. Just before each reminder goes out, the store reads the shopper's contact in Smaily:

• A contact who unsubscribed in Smaily gets no reminder, in every mode.
• Subscribers only (consent) and Checkout opt-in only: a shopper who agreed to marketing emails in the store — a newsletter subscriber of the website (a customer or a guest), or a shopper who ticked Subscribe to our newsletter at checkout for this cart, also without placing the order — gets it, also when Smaily does not have them yet. Any other shopper gets it only as a subscribed contact in Smaily, also one who unsubscribed in the store: the Smaily list is the one you send to.
• All customers (legitimate interest): every cart with an email address, also when Smaily does not have the shopper (they are added as a contact), except a shopper who unsubscribed from the store's newsletter and did not tick the checkout box for this cart.
• Include guest order emails does not decide a guest's reminder: it applies only to the contact sync under All customers (legitimate interest).

A skipped cart's row in the Log reads Skipped with the reason. A reminder carries no subscription status, so it never subscribes a contact again who unsubscribed in Smaily. While Smaily cannot be reached, the reminder waits and is tried again.

Ostukorv loetakse hüljatuks, kui selles on tooted ja e-posti aadress ning see on olnud puutumata kauem kui Ooteaeg (minutites) (vaikimisi 30, vähemalt 10). Pood otsib selliseid ostukorve iga 5 minuti järel.

• Üle 24 tunni vanusele ostukorvile kirja ei saadeta, nii et seisnud cron ei saada kunagi aegunud meeldetuletusi.
• Iga ostukorvi kohta saadetakse kiri üks kord ning üks e-posti aadress saab 24 tunni jooksul kõige rohkem ühe meeldetuletuse, ükskõik mitmel ostukorvil see on. Järgmise ostukorvi rida on logis Vahele jäetud.
• E-post võib tulla sisselogitud kliendilt või kassas olevalt külaliselt. Magento enda kassas (Luma-põhised teemad ja Hyvä Luma-põhine kassa) salvestatakse külalise sisestatud e-post ostukorvile kaks sekundit pärast seda, kui see on kehtiv aadress — nii saab meeldetuletuse ka külaline, kes lahkub tarneviisi sammul.
• Et kassat ei kasutataks teiste inimeste aadresside ostukorvidele panemiseks: üks IP-aadress saab salvestada kõige rohkem 30 e-posti aadressi 10 minutiga, üks ostukorv võtab kõige rohkem viis aadressi ja kogu pood kõige rohkem 2000 tunnis.
• Meeldetuletus sisaldab kuni 10 toodet ja taastamislinki abandoned_cart_url, mis taastab täpselt sama ostukorvi (registreeritud klient logib enne sisse). Link kehtib 30 päeva; pärast seda avab see ostukorvi lehe teatega „See ostukorvi link on aegunud.“

Kes saab meeldetuletuse

Otsustab veebisaidi kontaktide sünkroonimise režiim, mitte see, kas kontaktide sünkroonimine on sisse lülitatud. Vahetult enne iga meeldetuletuse saatmist loeb pood Smailyst ostja kontakti:

• Kontakt, kes on Smailys loobunud, meeldetuletust ei saa, üheski režiimis.
• Ainult turunduskirjade tellijad (nõusolekuga) ja Ainult kassas turunduskirjade nõusoleku andnud kontaktid: ostja, kes on poes turunduskirjadega nõustunud (veebisaidi uudiskirja tellija – klient või külaline – või ostja, kes märkis selle ostukorvi puhul kassas ruudu Liitu meie uudiskirjaga, ka tellimust esitamata), saab selle ka siis, kui teda Smailys veel pole. Iga teine ostja saab selle ainult siis, kui ta on Smailys tellija, ka poes loobunud ostja: Smaily nimekiri on see, kellele sa saadad.
• Kõik kliendid (õigustatud huvi): iga e-posti aadressiga ostukorv, ka siis, kui ostjat Smailys pole (ta lisatakse kontaktiks), välja arvatud ostja, kes on poe uudiskirjast loobunud ega märkinud selle ostukorvi puhul kassa ruutu.
• Kaasa külalistellimuste e-posti aadressid ei otsusta külalise meeldetuletust: see kehtib ainult kontaktide sünkroonimisele režiimis Kõik kliendid (õigustatud huvi).

Vahele jäetud ostukorvi rida on logis Vahele jäetud koos põhjusega. Meeldetuletus ei saada tellimuse olekut, nii et see ei telli kunagi uuesti kontakti, kes on Smailys loobunud. Kuni Smailyga ühendust ei saa, meeldetuletus ootab ja seda proovitakse uuesti.

The Intelligence tab connects Campaign Intelligence, switches browse tracking on and runs the historical imports.

Connecting

1. Get a one-time setup link from Smaily.
2. Paste it into Setup URL or token from Smaily and press Connect. The token is exchanged at once and never stored; the status shows the connected account.
3. Connecting starts the Catalog import: your whole catalog goes to Campaign Intelligence once, from the next cron run (usually within a minute). The notice The catalog import has started offers Hold back the import — press it before then and nothing is sent. Pressed later, the products already queued still go and the rest do not. Either way, you can start it again under Settings > Intelligence.
4. Connecting starts the Customers import too: the customer accounts your contact sync puts into Smaily, and every customer with an order in the order history Campaign Intelligence takes, go to Campaign Intelligence once, after the catalog import, so that it knows each of them by their customer account (see What gets imported). The notice The customers import has started says so; to hold it back, press Cancel import on the Customers card under Settings > Intelligence. A customers import already queued or running is left as it is. While Campaign Intelligence is connected and no customers import has ever completed — your store was connected before connecting started this import, or the import was canceled or failed — Magento's System Messages at the top of the admin show Smaily Connect: the customers import has never completed…. Its link Start the customers import opens Settings > Intelligence; press Start import, or Run again, on the Customers card there. Nothing starts the import for you. The message does not show while a customers import is queued or running, unless the card shows it as Stalled; it is gone for good once one has completed.
5. Connecting starts the Orders import too, after the customers import: your order history goes to Campaign Intelligence once, newest first — the recent orders first, so that Campaign Intelligence can start, then the older ones; no order older than the history Campaign Intelligence takes (see What gets imported). The notice The orders import has started says so; to hold it back, press Cancel import on the Orders card.

The setup link must be an https address on intelligence.smaily.com; anything else is refused before anything is sent. From then on, product saves, stock changes, deletions, customer accounts and orders (including refunds) reach Campaign Intelligence on their own. There is no per-type switch.

Browse tracking

Enable storefront browse tracking (product views, searches, cart activity) — off by default — sends those storefront events to Campaign Intelligence, only for visitors who gave marketing consent. The events pass through your own server, so the API key never reaches the browser. Save it with the tab's Save button, which appears once Campaign Intelligence is connected.

Vahekaart Intelligence ühendab Campaign Intelligence'i, lülitab sisse sirvimise jälgimise ja käivitab ajaloolised impordid.

Ühendamine

1. Hangi Smailylt ühekordne seadistuslink.
2. Kleebi see väljale Smailylt saadud seadistus-URL või -võti ja vajuta Ühenda. Võti vahetatakse kohe ja seda ei salvestata; olek näitab ühendatud kontot.
3. Ühendamine käivitab Kataloog-impordi: kogu sinu kataloog saadetakse Campaign Intelligence'i üks kord, alates järgmisest cron-käivitusest (tavaliselt minuti jooksul). Teade Kataloogi import käivitus pakub nuppu Peata import — vajuta seda enne ja midagi ei saadeta. Hiljem vajutades lähevad juba järjekorras olevad tooted siiski teele, ülejäänud mitte. Mõlemal juhul saad impordi uuesti käivitada jaotises Seaded > Intelligence.
4. Ühendamine käivitab ka Kliendid-impordi: kliendikontod, mille sinu kontaktide sünkroonimine Smailysse paneb, ja iga klient, kellel on tellimus Campaign Intelligence'i võetavas tellimuste ajaloos, saadetakse Campaign Intelligence'i üks kord, pärast kataloogi importi, et see tunneks igaüht neist tema kliendikonto järgi (vt Mida imporditakse). Seda ütleb teade Klientide import käivitus; selle peatamiseks vajuta kaardil Kliendid nuppu Katkesta import jaotises Seaded > Intelligence. Juba järjekorras olev või töötav klientide import jäetakse nii, nagu see on. Kui Campaign Intelligence on ühendatud ja ükski klientide import pole kunagi lõpuni jõudnud — pood ühendati enne, kui ühendamine selle impordi käivitas, või import katkestati või ebaõnnestus —, näitavad Magento System Messages halduse ülaosas teadet Smaily Connect: klientide import pole kunagi lõpuni jõudnud…. Selle link Käivita klientide import avab jaotise Seaded > Intelligence; vajuta seal kaardil Kliendid nuppu Alusta importi või Käivita uuesti. Automaatselt importi ei käivitata. Teadet ei näidata, kui klientide import on järjekorras või töötab, välja arvatud siis, kui kaart näitab seda olekus Seiskunud; teade kaob jäädavalt, kui üks import on lõpuni jõudnud.
5. Ühendamine käivitab ka Tellimused-impordi, pärast klientide importi: sinu tellimuste ajalugu saadetakse Campaign Intelligence'i üks kord, uusimast alates — kõigepealt hiljutised tellimused, et Campaign Intelligence saaks alustada, siis vanemad; mitte ühtegi tellimust, mis on vanem kui Campaign Intelligence'i võetav ajalugu (vt Mida imporditakse). Seda ütleb teade Tellimuste import käivitus; selle peatamiseks vajuta kaardil Tellimused nuppu Katkesta import.

Seadistuslink peab olema https-aadress domeenil intelligence.smaily.com; kõik muu lükatakse tagasi enne, kui midagi saadetakse. Edaspidi jõuavad toodete salvestused, laoseisu muutused, kustutamised, kliendikontod ja tellimused (koos tagasimaksetega) Campaign Intelligence'i ise. Andmetüübipõhist lülitit pole.

Sirvimise jälgimine

Luba poe sirvimise jälgimine (tootevaatamised, otsingud, ostukorvitegevus) — vaikimisi väljas — saadab need poe sündmused Campaign Intelligence'i, ainult turundusnõusoleku andnud külastajate kohta. Sündmused liiguvad läbi sinu enda serveri, nii et API võti ei jõua kunagi brauserisse. Salvesta see vahekaardi nupuga Salvesta, mis ilmub pärast Campaign Intelligence'i ühendamist.

The browse tracker needs to know whether the visitor allowed marketing cookies. It asks, in this order:

1. Your own consent function, when the page defines window.smailyConnect.consentOverride. true means consent; any other answer means none.
2. Magento's cookie notice, when Cookie Restriction Mode is on (Stores > Configuration > General > Web > Default Cookie Settings): consent once the visitor allows cookies there, on that website.
3. Otherwise there is no consent, and nothing is tracked.

Without consent the tracker sends no event and sets no session cookie. When browse tracking is on and cookie restriction mode is off, the admin shows a notification saying so; a store that uses its own consent function can mark it read. On a store view with a Storefront URL, the separate storefront's own banner decides instead.

Option A — Magento's cookie notice

Switch on Cookie Restriction Mode. Nothing else is needed.

Option B — your own consent tool

Tools such as Amasty Cookie Consent or Cookiebot leave Magento's mode off. Add a small script that answers for your tool — for example under Content > Design > Configuration > (store view) > HTML Head > Scripts and Style Sheets:

• window.smailyConnect.consentOverride() returns true only when the visitor allowed marketing cookies in your tool.
• When the visitor changes their choice on the page, fire document.dispatchEvent(new CustomEvent('smaily:consent-changed')); the tracker asks again at once. Without the event, the change counts from the next page view.

Example for Amasty Cookie Consent — put your marketing group's id from Amasty's cookie group settings in place of 3:

<script>
window.smailyConnect = window.smailyConnect || {};
window.smailyConnect.consentOverride = function () {
    var MARKETING_GROUP_ID = '3'; // your marketing group's id in Amasty
    var match = document.cookie.match(/(?:^|; )amcookie_allowed=([^;]*)/);

    return !!match && decodeURIComponent(match[1]).split(',').indexOf(MARKETING_GROUP_ID) !== -1;
};
</script>

Example for Cookiebot:

<script>
window.smailyConnect = window.smailyConnect || {};
window.smailyConnect.consentOverride = function () {
    return !!(window.Cookiebot && window.Cookiebot.consent && window.Cookiebot.consent.marketing);
};
['CookiebotOnConsentReady', 'CookiebotOnAccept'].forEach(function (name) {
    window.addEventListener(name, function () {
        document.dispatchEvent(new CustomEvent('smaily:consent-changed'));
    });
});
</script>

Check the example against the tool version you run.

Sirvimise jälgija peab teadma, kas külastaja lubas turundusküpsised. Ta küsib selles järjekorras:

1. Sinu enda nõusoleku funktsioonilt, kui leht defineerib window.smailyConnect.consentOverride. true tähendab nõusolekut; iga muu vastus tähendab, et nõusolekut pole.
2. Magento küpsiste teatelt, kui Cookie Restriction Mode (küpsiste piirangurežiim) on sees (Stores > Configuration > General > Web > Default Cookie Settings): nõusolek on olemas, kui külastaja on seal küpsised lubanud, sellel veebisaidil.
3. Muul juhul nõusolekut pole ja midagi ei jälgita.

Ilma nõusolekuta ei saada jälgija ühtegi sündmust ega sea seansiküpsist. Kui sirvimise jälgimine on sees ja küpsiste piirangurežiim väljas, näitab haldus selle kohta teadet; pood, mis kasutab oma nõusoleku funktsiooni, võib selle loetuks märkida. Poevaates, millel on Poe veebilehe aadress, otsustab selle asemel eraldi poe veebilehe enda bänner.

Variant A — Magento küpsiste teade

Lülita sisse Cookie Restriction Mode. Muud pole vaja.

Variant B — sinu enda nõusoleku tööriist

Tööriistad nagu Amasty Cookie Consent või Cookiebot jätavad Magento režiimi välja. Lisa väike skript, mis vastab sinu tööriista eest — näiteks menüüs Content > Design > Configuration > (poevaade) > HTML Head > Scripts and Style Sheets:

• window.smailyConnect.consentOverride() tagastab true ainult siis, kui külastaja lubas sinu tööriistas turundusküpsised.
• Kui külastaja muudab lehel oma valikut, käivita document.dispatchEvent(new CustomEvent('smaily:consent-changed')); jälgija küsib kohe uuesti. Ilma selle sündmuseta kehtib muudatus järgmisest lehevaatamisest.

Näide Amasty Cookie Consent jaoks — pane 3 asemele oma turundusgrupi id Amasty küpsisegruppide seadetest:

<script>
window.smailyConnect = window.smailyConnect || {};
window.smailyConnect.consentOverride = function () {
    var MARKETING_GROUP_ID = '3'; // your marketing group's id in Amasty
    var match = document.cookie.match(/(?:^|; )amcookie_allowed=([^;]*)/);

    return !!match && decodeURIComponent(match[1]).split(',').indexOf(MARKETING_GROUP_ID) !== -1;
};
</script>

Näide Cookiebot'i jaoks:

<script>
window.smailyConnect = window.smailyConnect || {};
window.smailyConnect.consentOverride = function () {
    return !!(window.Cookiebot && window.Cookiebot.consent && window.Cookiebot.consent.marketing);
};
['CookiebotOnConsentReady', 'CookiebotOnAccept'].forEach(function (name) {
    window.addEventListener(name, function () {
        document.dispatchEvent(new CustomEvent('smaily:consent-changed'));
    });
});
</script>

Kontrolli näidet oma tööriista versiooni vastu.

When a shopper arrives from a recommendation link in a Smaily email, the link's parameters (smaily_rec, smaily_vt, smaily_ctx) are kept in first-party cookies and added to the order, so Campaign Intelligence can credit the purchase to the recommendation. It runs on its own once Campaign Intelligence is connected — nothing to switch on — and works with full-page cache. The last click wins. A malformed value (for example from a test email's placeholder) is ignored; the order still reaches Campaign Intelligence.

Kui ostja saabub Smaily e-kirjas olnud soovituslingilt, hoitakse lingi parameetrid (smaily_rec, smaily_vt, smaily_ctx) esimese osapoole küpsistes ja lisatakse tellimusele, et Campaign Intelligence saaks ostu soovitusele omistada. See töötab ise, kui Campaign Intelligence on ühendatud — midagi pole vaja sisse lülitada — ja toimib ka lehevahemäluga. Kehtib viimane klikk. Vigast väärtust (näiteks testkirja kohatäitjast) eiratakse; tellimus jõuab Campaign Intelligence'i ikkagi.

The Smaily recommendations widget shows a shopper their own recommendations from Campaign Intelligence — the same products as in their Smaily emails — on your store's pages, under the heading Recommended for you, as your theme's own product cards. Nothing appears until you place the widget, and it has no settings.

1. Open a page under Content > Pages or a block under Content > Blocks.
2. In the content editor press Insert Widget..., pick Smaily recommendations as the Widget Type and press Insert Widget. In Page Builder do the same in a Text element, or put {{widget type="Smaily\Connect\Block\Widget\Recommendations"}} in an HTML Code element.
3. Save the page or block.

• Who sees what: a signed-in customer sees their recommendations unless they opted out of personalized recommendations or unsubscribed from your newsletter; a guest sees them only after an earlier click on a Smaily email link. A shopper Campaign Intelligence has nothing for, a new visitor or a shopper without marketing consent sees nothing — not even the heading.
• The cards: up to four products with your store's own name, image and price. A product that is disabled, not visible in the catalog, not in this website or not for sale is left out. A purchase after a click on a card is credited to your store's pages.
• Consent: the same rules as the browse tracker (Cookie consent tool). Consent given on the page shows the recommendations at once.
• Speed: the page stays in the full-page cache and the cards are asked for after it has loaded, so the page never waits. A shopper's recommendations are kept for an hour, so a new one can take up to an hour to show. When Campaign Intelligence does not answer, nothing shows and the store asks again after 10 minutes.
• Nothing shows while Campaign Intelligence is not connected or the account is deactivated. Hyvä needs the Hyvä compatibility module; a separate storefront does not get the widget.

Vidin Smaily soovitused näitab ostjale poe lehtedel tema enda soovitusi Campaign Intelligence'ist — samu tooteid, mis on tema Smaily e-kirjades — pealkirja Sulle soovitatud all, sinu teema enda tootekaartidena. Midagi ei ilmu enne, kui vidina lehele paigutad, ja sellel pole seadeid.

1. Ava leht menüüs Content > Pages või plokk menüüs Content > Blocks.
2. Vajuta sisuredaktoris Insert Widget..., vali Widget Type väärtuseks Smaily soovitused ja vajuta Insert Widget. Page Builderis tee sama elemendis Text või pane {{widget type="Smaily\Connect\Block\Widget\Recommendations"}} elementi HTML Code.
3. Salvesta leht või plokk.

• Kes mida näeb: sisse logitud klient näeb oma soovitusi, kui ta pole personaalsetest soovitustest loobunud ega uudiskirjast lahkunud; külaline näeb neid ainult pärast varasemat klikki Smaily e-kirja lingil. Ostja, kellele Campaign Intelligence'il soovitusi pole, uus külastaja või turundusnõusolekuta ostja ei näe midagi — ka pealkirja mitte.
• Kaardid: kuni neli toodet sinu poe enda nime, pildi ja hinnaga. Toode, mis on välja lülitatud, kataloogis nähtamatu, pole selles veebisaidis või pole müügil, jäetakse välja. Ost pärast kaardil klikkimist omistatakse sinu poe lehtedele.
• Nõusolek: samad reeglid nagu sirvimise jälgijal (Küpsiste nõusoleku tööriist). Lehel antud nõusoleku järel ilmuvad soovitused kohe.
• Kiirus: leht jääb lehevahemällu ja kaarte küsitakse pärast lehe laadimist, nii et leht ei oota kunagi. Ostja soovitusi hoitakse tund aega, seega võib uue soovituse ilmumiseks kuluda kuni tund. Kui Campaign Intelligence ei vasta, ei näidata midagi ja pood küsib uuesti 10 minuti pärast.
• Midagi ei näidata, kui Campaign Intelligence pole ühendatud või konto on deaktiveeritud. Hyvä vajab Hyvä ühilduvusmoodulit; eraldi poe veebileht vidinat ei saa.

Under the store events on Settings > Automations, Campaign Intelligence Automations lists the engine-run triggers available for your sector (replenishment reminders, win-back and more). Each card maps a trigger to a Smaily Workflow, with Cooldown (days), an optional Daily Cap, Test mode and Test Emails. Press Save Intelligence Automations.

• Every trigger starts off and in test mode: in test mode, emails go only to the listed test addresses.
• Going live: untick Test mode and save. This asks for real sends; Smaily switches them on after you confirm. Until then the card keeps showing Test mode. Active means real customers receive the emails.
• Ticking Test mode or unticking Enabled takes effect at once.

Jaotises Seaded > Automaatikad, poe sündmuste all, loetleb Campaign Intelligence'i automaatikad sinu valdkonnale saadaolevad mootoris töötavad päästikud (varude täiendamise meeldetuletused, tagasivõitmine ja muud). Iga kaart seob päästiku Smaily töövooga, koos väljadega Puhkeaeg (päevades), valikuline Päevalimiit, Testrežiim ja Test-aadressid. Vajuta Salvesta Intelligence'i automaatikad.

• Iga päästik alustab välja lülitatuna ja testrežiimis: testrežiimis lähevad kirjad ainult loetletud testaadressidele.
• Päris saatmise alustamine: eemalda märge Testrežiim ja salvesta. See taotleb saatmist päris klientidele; Smaily lülitab selle sisse pärast sinu kinnitust. Seni näitab kaart edasi Testrežiim. Aktiivne tähendab, et päris kliendid saavad kirju.
• Testrežiimi märkimine või Lubatud märke eemaldamine jõustub kohe.

If Smaily suspends or closes the Campaign Intelligence account behind your store, the engine stops accepting data and the extension stops sending:

• Nothing is lost: everything queued stays queued and goes out once the account is active again.
• Settings > Intelligence says the account is not active, links to your Smaily account and offers Check again. The Campaign Intelligence imports and automations are unavailable meanwhile.
• The Dashboard and an admin notification name the deactivated account. Waiting does not fix it — only Smaily can make the account active again.
• Your Smaily contact sync and email automations are not affected.

Once Smaily tells you the account is active, press Check again. The store also asks again on its own every 15 minutes.

Kui Smaily peatab või sulgeb sinu poe taga oleva Campaign Intelligence'i konto, lõpetab mootor andmete vastuvõtmise ja laiendus lõpetab saatmise:

• Midagi ei lähe kaduma: kõik järjekorras olev jääb järjekorda ja saadetakse, kui konto on taas aktiivne.
• Seaded > Intelligence ütleb, et konto ei ole aktiivne, lingib sinu Smaily kontole ja pakub nuppu Kontrolli uuesti. Campaign Intelligence'i impordid ja automaatikad pole seni kasutatavad.
• Töölaud ja halduse teade nimetavad deaktiveeritud kontot. Ootamine seda ei lahenda — ainult Smaily saab konto taas aktiivseks teha.
• Sinu Smaily kontaktide sünkroonimist ja e-posti automaatikaid see ei mõjuta.

Kui Smaily on öelnud, et konto on aktiivne, vajuta Kontrolli uuesti. Pood küsib ka ise iga 15 minuti järel uuesti.

A product feed for the RSS block of the Smaily template editor, at https://your-store.example/smaily/rss/feed. Switch it on or off with Enable the product RSS feed on the RSS tab and its Save button. The URL builder on the same tab assembles a filtered feed address as you pick — copy it with Copy.

Only enabled, catalog-visible products are listed; a configurable product's variants appear as their parent. Items carry smly:price, smly:old_price and smly:discount (prices as your storefront shows them, tax included). With a Storefront URL saved, item links start with it. The feed is cached for 15 minutes.

Tootevoog Smaily mallide redaktori RSS-ploki jaoks, aadressil https://sinu-pood.example/smaily/rss/feed. Lülita see sisse või välja vahekaardil RSS valikuga Luba toodete RSS-voog ja selle nupuga Salvesta. Samal vahekaardil olev URL-i koostaja paneb sinu valikutest kokku filtreeritud voo aadressi — kopeeri see nupuga Kopeeri.

Loetletakse ainult lubatud ja kataloogis nähtavad tooted; konfigureeritava toote variandid kuvatakse nende põhitootena. Kirjetel on smly:price, smly:old_price ja smly:discount (hinnad nagu sinu pood neid näitab, koos maksuga). Kui Poe veebilehe aadress on salvestatud, algavad kirjete lingid sellega. Voogu hoitakse vahemälus 15 minutit.

Use a field in a Smaily template as a merge tag, for example {{ first_name }} or {{ product_name_1 }}, or in a segment rule. A field whose value the store does not know is left out, so the value Smaily already holds stays — a template should expect it may be missing. The abandoned-cart product slots are the exception: unused slots are sent empty, so a smaller cart clears the products of a larger one.

Dates and times are in UTC, as YYYY-MM-DD HH:MM:SS (a discount code's last day is a date in the store's timezone, see Discount codes). The field names are the same in Smaily's WooCommerce and Shopify extensions, so templates and segments carry over between stores.

Kasuta välja Smaily mallis asendusväljana, näiteks {{ first_name }} või {{ product_name_1 }}, või segmendi reeglis. Välja, mille väärtust pood ei tea, ei saadeta, nii et Smailys juba olev väärtus säilib — mall peaks arvestama, et väli võib puududa. Erand on hüljatud ostukorvi tootepesad: kasutamata pesad saadetakse tühjana, nii et väiksem ostukorv kustutab suurema ostukorvi tooted.

Kuupäevad ja kellaajad on UTC-s, kujul YYYY-MM-DD HH:MM:SS (sooduskoodi viimane päev on kuupäev poe ajavööndis, vt Sooduskoodid). Väljade nimed on samad mis Smaily WooCommerce'i ja Shopify laiendustes, nii et mallid ja segmendid sobivad poodide vahel.

Sent with every contact sync and with the Welcome automation. The optional fields are sent only when ticked under Extra fields to sync with each contact and only when the customer has a value.

Saadetakse iga kontaktide sünkroonimisega ja automaatikaga Tervitus. Valikulised väljad saadetakse ainult siis, kui need on märgitud jaotises Lisaväljad, mis sünkroonitakse iga kontaktiga, ja ainult siis, kui kliendil on väärtus.

Each automation writes the moment it ran onto the contact, overwritten on every run. An automation that has not run for the contact writes nothing. Use them in segments such as "got the abandoned-cart reminder more than 30 days ago".

Iga automaatika kirjutab kontaktile oma käivitamise hetke, mis kirjutatakse igal käivitusel üle. Automaatika, mis pole kontakti jaoks käivitunud, ei kirjuta midagi. Kasuta neid segmentides, näiteks „sai hüljatud ostukorvi meeldetuletuse üle 30 päeva tagasi“.

Put them in the workflow's email, for example {{ welcome_coupon_code }}, valid until {{ welcome_coupon_expires_at }}.

Lisa need töövoo e-kirja, näiteks {{ welcome_coupon_code }}, kehtib kuni {{ welcome_coupon_expires_at }}.

Every slot and over_10_products are sent on every reminder; unused ones are empty. Test them with {% if product_name_2 %}. Prices carry no currency sign — add it in the template.

Iga meeldetuletusega saadetakse kõik pesad ja over_10_products; kasutamata on tühjad. Kontrolli neid kujul {% if product_name_2 %}. Hindadel pole valuutamärki — lisa see mallis.

With Campaign Intelligence connected, the recommendation engine writes each contact's recommendations onto the Smaily contact itself, as numbered fields such as rec_1_name, rec_1_description and rec_1_link_url, in the contact's language. The store does not write these fields. Ask Smaily for the full list for your account and for ready-made template blocks.

Kui Campaign Intelligence on ühendatud, kirjutab soovitusmootor iga kontakti soovitused ise Smaily kontaktile, nummerdatud väljadena, näiteks rec_1_name, rec_1_description ja rec_1_link_url, kontakti keeles. Pood neid välju ei kirjuta. Küsi Smailylt oma konto väljade täielikku loendit ja valmis mallide plokke.

• The contact import follows Sync contacts to Smaily: its button is available once sync is on and saved. With sync off, or ticked but not saved yet, the button is disabled. On a new website it is disabled too until the website's Contacts settings are saved, and the card says "Contacts start syncing to Smaily once the Contacts settings are saved, so an import would send nothing yet. Save them to import." A contact keeps its store status; under Subscribers only nobody becomes subscribed by being imported. The estimate above Start import says how many contacts the import sends from the website, for the mode picked on the panel.
• Run the Catalog import again after changing products outside Magento's own product save — an ERP or PIM link, a CSV or bin/magento import run, a database import — so Campaign Intelligence gets the new prices and products. Also run it when a release note asks you to.
• The catalog import does not remove products. Deletions reach Campaign Intelligence from Magento's own product delete and from Magento's import with the Delete behaviour; anything else is caught by the nightly product check.
• Imports run one at a time, oldest first, and are safe to run again: the receiving side drops duplicates.

• Kontaktide import järgib lülitit Sünkrooni kontaktid Smailysse: selle nupp on kasutatav, kui sünkroonimine on sees ja salvestatud. Kui sünkroonimine on väljas või linnuke on pandud, aga salvestamata, on nupp keelatud. Uuel veebisaidil on nupp keelatud ka seni, kuni veebisaidi kontaktide seaded on salvestatud, ja kaart ütleb: „Kontaktide sünkroonimine Smailysse algab, kui kontaktide seaded on salvestatud, seega import ei saadaks veel midagi. Salvesta need, et importida.“ Kontakt säilitab oma oleku poes; režiimis Ainult turunduskirjade tellijad ei saa keegi importimise läbi tellijaks. Nupu Alusta importi kohal olev hinnang ütleb, mitu kontakti import veebisaidilt saadab, paneelil valitud režiimi järgi.
• Käivita Kataloog-import uuesti pärast toodete muutmist väljaspool Magento enda tootesalvestust — ERP- või PIM-liides, CSV või bin/magento import, andmebaasi import —, et Campaign Intelligence saaks uued hinnad ja tooted. Käivita see ka siis, kui väljalaskemärkmed seda paluvad.
• Kataloogi import tooteid ei eemalda. Kustutamised jõuavad Campaign Intelligence'i Magento enda toote kustutamisest ja Magento impordist käitumisega Delete; kõik muu püüab kinni öine tootekontroll.
• Impordid töötavad ükshaaval, vanim enne, ja neid on ohutu uuesti käivitada: vastuvõtja pool jätab duplikaadid välja.

Each import is a card. Once started, a status pill says where it is and a progress bar shows "X of Y". While it is queued or running, the card offers Cancel import; once it has ended, Run again.

The result stays on the card; you do not have to keep the page open. bin/magento smaily:backfill:status shows the same on the command line.

While the Orders import runs, its card has one bar for the part being sent, counting the orders Campaign Intelligence has received. First it says "Sending the orders of the last 18 months first…" and the bar fills with those months. Once they are in, the bar jumps to the share of the whole history sent so far, and the card says "The last 18 months are in: Campaign Intelligence can start. Older orders, back to 60 months, follow in the background…". The extension also tells Campaign Intelligence how far the import has come, so its console can show it.

Iga import on kaart. Pärast käivitamist ütleb olekumärk, kus see on, ja edenemisriba näitab „X / Y“. Kuni import on järjekorras või töötab, pakub kaart nuppu Katkesta import; kui see on lõppenud, nuppu Käivita uuesti.

Tulemus jääb kaardile; lehte ei pea lahti hoidma. bin/magento smaily:backfill:status näitab sama käsureal.

Kuni Tellimused-import töötab, on selle kaardil üks riba parajasti saadetava osa jaoks ja see loeb tellimusi, mille Campaign Intelligence on kätte saanud. Esmalt ütleb kaart „Saadan kõigepealt viimase 18 kuu tellimused…“ ja riba täitub nende kuudega. Kui need on kohal, hüppab riba kogu seni saadetud ajaloo osakaaluni ja kaart ütleb „Viimase 18 kuu tellimused on kohal: Campaign Intelligence saab alustada. Vanemad tellimused, kuni 60 kuu tagant, järgnevad taustal…“. Laiendus annab ka Campaign Intelligence'ile teada, kui kaugele import on jõudnud, et selle konsool saaks seda näidata.

A running import that nothing has moved for over an hour — also one that fails before its first page — is set aside: the imports behind it go first, and it is tried again whenever nothing else waits, so one that failed for a passing reason carries on by itself.

Töötav import, mida pole üle tunni edasi viidud — ka selline, mis ebaõnnestub enne esimest osa —, pannakse kõrvale: tema taga ootavad impordid lähevad ette ja teda proovitakse uuesti, kui midagi muud ei oota, nii et mööduval põhjusel ebaõnnestunud import jätkab ise.

Once a night at 03:30 (your store's time zone), the extension sends Campaign Intelligence the list of all your products — each product's SKU and whether it is in stock, nothing else. Campaign Intelligence then:

• stops recommending a product missing from the list (for example one deleted straight in the database);
• takes the stock from the list where it differs (a product found back in stock this way sends no back-in-stock email);
• counts products it does not have, so Smaily's team sees that a catalog import is needed.

Disabled products are left out, so they stop being recommended. If the list would remove more than a fifth of your products, or is empty, nothing is removed and Smaily's team checks it. The check waits for another night while the catalog import is running (a catalog import set aside as stalled does not hold it back, even while other imports run), while product changes still wait in the Log, or while Campaign Intelligence is not connected or active. A store with more than 50,000 enabled products cannot use it yet.

Each list sent shows in the Log as one catalog_manifest row; Details shows Campaign Intelligence's answer. If no list has gone out for three nights, the Dashboard says so and why.

Igal ööl kell 03:30 (sinu poe ajavööndis) saadab laiendus Campaign Intelligence'ile kõigi sinu toodete loendi — iga toote SKU ja kas see on laos, muud mitte. Seejärel Campaign Intelligence:

• lõpetab loendist puuduva toote soovitamise (näiteks otse andmebaasis kustutatud toote);
• võtab erineva laoseisu loendist (nii laos tagasi olevaks leitud toote kohta ei saadeta „taas laos“ kirja);
• loendab tooted, mida tal pole, et Smaily meeskond näeks, et kataloogi import on vajalik.

Keelatud tooted jäetakse välja, nii et neid enam ei soovitata. Kui loend eemaldaks üle viiendiku sinu toodetest või on tühi, ei eemaldata midagi ja Smaily meeskond kontrollib seda. Kontroll ootab järgmist ööd, kui kataloogi import töötab (seiskunuks märgitud kataloogi import seda ei takista, ka siis, kui teised impordid töötavad), kui tootemuudatused ootavad logis veel saatmist või kui Campaign Intelligence pole ühendatud või aktiivne. Pood, kus on üle 50 000 lubatud toote, ei saa seda veel kasutada.

Iga saadetud loend on logis üks rida catalog_manifest; Üksikasjad näitab Campaign Intelligence'i vastust. Kui kolm ööd järjest pole loendit saadetud, ütleb töölaud seda koos põhjusega.

Magento's standard theme and themes built on it work as they are: the checkout newsletter checkbox, the early capture of a guest's email for abandoned carts, browse tracking, recommendation attribution and the My Account > Personalization page.

Magento standardteema ja sellele ehitatud teemad töötavad nii, nagu on: kassa uudiskirja märkeruut, külalise e-posti varajane salvestamine hüljatud ostukorvi jaoks, sirvimise jälgimine, soovituste omistamine ja leht Minu konto > Personaliseerimine.

A Hyvä storefront also needs the Hyvä compatibility module, the composer package smaily/module-connect-hyva. It brings the browse tracker, recommendation attribution, the Smaily recommendations widget and the styled Personalization page to Hyvä. It has the same version as Smaily Connect: install the same version of both, the same way — a store that installed Smaily Connect from the release ZIP takes the Hyvä module from the release too, because the composer command would install a second copy of Smaily Connect.

With composer, one command installs both modules. Until 3.0.0 is released, give the release candidate's exact version for both packages — 3.0.0-rc17 below; a standard Magento project accepts stable versions only. From 3.0.0 on, composer require smaily/module-connect-hyva is enough: it installs Smaily Connect too. Run the commands from the Magento root, as the user that owns the Magento files; <Vendor>/<theme> is the Hyvä theme your store uses, and its Tailwind build needs Node.js 20 or newer. In production mode:

bin/magento maintenance:enable
composer require smaily/smailyformagento:3.0.0-rc17 smaily/module-connect-hyva:3.0.0-rc17
bin/magento module:enable Smaily_Connect Hyva_SmailyConnect
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento hyva:config:generate
npm --prefix app/design/frontend/<Vendor>/<theme>/web/tailwind ci
npm --prefix app/design/frontend/<Vendor>/<theme>/web/tailwind run build-prod
bin/magento setup:static-content:deploy en_US   # every locale your store uses
bin/magento maintenance:disable
bin/magento cache:flush

In developer or default mode, composer require, module:enable, setup:upgrade, hyva:config:generate, the two npm commands and cache:flush are enough.

From the release ZIPs: every release on the releases page carries smaily-connect-magento2.zip (Smaily Connect) and smaily-connect-magento2-hyva.zip (the Hyvä module), each with its .sha256 file. Download all four files into one folder and check both archives there — each must answer OK:

sha256sum -c smaily-connect-magento2.zip.sha256           # macOS: shasum -a 256 -c
sha256sum -c smaily-connect-magento2-hyva.zip.sha256

Extract each into its module folder (from the Magento root; give unzip the ZIP's full path if it is elsewhere), then run the commands above for your mode, without the composer require line:

mkdir -p app/code/Smaily/Connect app/code/Hyva/SmailyConnect
unzip smaily-connect-magento2.zip -d app/code/Smaily/Connect
unzip smaily-connect-magento2-hyva.zip -d app/code/Hyva/SmailyConnect

Update the Hyvä module together with Smaily Connect, to the same version. The module's README has these steps too.

• Hyvä's free theme uses a Luma-based checkout, where the newsletter checkbox and the guest email capture work as on Luma.
• The commercial Hyvä Checkout is not supported: it shows no Smaily newsletter checkbox, and a guest's cart gets its email only when that checkout saves it.

Hyvä poe veebileht vajab lisaks Hyvä ühilduvusmoodulit, composeri paketti smaily/module-connect-hyva. See toob Hyväle sirvimise jälgija, soovituste omistamise, vidina Smaily soovitused ja kujundatud personaliseerimise lehe. Selle versioon on sama mis Smaily Connectil: paigalda mõlemast sama versioon ja samal viisil — pood, mis paigaldas Smaily Connecti väljalaske ZIP-ist, võtab ka Hyvä mooduli väljalaskest, sest composeri käsk paigaldaks Smaily Connectist teise koopia.

Composeriga paigaldab mõlemad moodulid üks käsk. Kuni 3.0.0 väljalaskeni anna mõlemale paketile väljalaskekandidaadi täpne versioon — allpool 3.0.0-rc17; tavaline Magento projekt lubab ainult stabiilseid versioone. Alates versioonist 3.0.0 piisab käsust composer require smaily/module-connect-hyva: see paigaldab ka Smaily Connecti. Käivita käsud Magento juurkaustas, Magento failide omaniku kasutajana; <Vendor>/<theme> on sinu poe Hyvä teema ja selle Tailwindi ehitus vajab Node.js 20 või uuemat. Tootmisrežiimis:

bin/magento maintenance:enable
composer require smaily/smailyformagento:3.0.0-rc17 smaily/module-connect-hyva:3.0.0-rc17
bin/magento module:enable Smaily_Connect Hyva_SmailyConnect
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento hyva:config:generate
npm --prefix app/design/frontend/<Vendor>/<theme>/web/tailwind ci
npm --prefix app/design/frontend/<Vendor>/<theme>/web/tailwind run build-prod
bin/magento setup:static-content:deploy en_US   # kõik poe keeleseaded
bin/magento maintenance:disable
bin/magento cache:flush

Arendus- või vaikerežiimis piisab käskudest composer require, module:enable, setup:upgrade, hyva:config:generate, kahest npm-käsust ja cache:flush.

Väljalaske ZIP-idest: igal väljalaskel väljalasete lehel on smaily-connect-magento2.zip (Smaily Connect) ja smaily-connect-magento2-hyva.zip (Hyvä moodul), kumbki koos oma .sha256-failiga. Laadi kõik neli faili ühte kausta ja kontrolli seal mõlemat arhiivi — kumbki peab vastama OK:

sha256sum -c smaily-connect-magento2.zip.sha256           # macOS: shasum -a 256 -c
sha256sum -c smaily-connect-magento2-hyva.zip.sha256

Paki kumbki lahti oma mooduli kausta (Magento juurkaustas; kui ZIP on mujal, anna käsule unzip selle täielik tee), seejärel käivita oma režiimi jaoks ülaltoodud käsud ilma reata composer require:

mkdir -p app/code/Smaily/Connect app/code/Hyva/SmailyConnect
unzip smaily-connect-magento2.zip -d app/code/Smaily/Connect
unzip smaily-connect-magento2-hyva.zip -d app/code/Hyva/SmailyConnect

Uuenda Hyvä moodulit koos Smaily Connectiga, samale versioonile. Need sammud on ka mooduli README-s (inglise keeles).

• Hyvä tasuta teema kasutab Luma-põhist kassat, kus uudiskirja märkeruut ja külalise e-posti salvestamine töötavad nagu Lumas.
• Tasulist Hyvä Checkouti ei toetata: selles pole Smaily uudiskirja märkeruutu ja külalise ostukorv saab e-posti alles siis, kui see kassa selle salvestab.

When shoppers use a separate storefront (PWA Studio, Vue Storefront, a custom site) and Magento is the back end only:

• Works as is: contact sync, the first-order and abandoned-cart automations, the catalog, customer and order sync, the imports, the nightly check, the Log, and the GDPR command.
• Needs the storefront team: the checkout newsletter checkbox, putting a guest's email on the cart, campaign-click capture, browse tracking and the cookies at login and order placement.
• Not available: the Welcome automation for signups made on the storefront (they arrive through Magento's API), the Checkout opt-in only sync mode, the My Account > Personalization page, the Smaily recommendations widget, and the abandoned_cart_url link (link to the storefront's cart page in the template instead).

Set the Storefront URL before connecting Campaign Intelligence. The full checklist and the hand-off for the storefront team are in HEADLESS_STOREFRONTS.md.

Kui ostjad kasutavad eraldi poe veebilehte (PWA Studio, Vue Storefront, eritellimusel sait) ja Magento on ainult taustasüsteem:

• Töötab nii, nagu on: kontaktide sünkroonimine, esimese tellimuse ja hüljatud ostukorvi automaatikad, kataloogi, klientide ja tellimuste sünkroonimine, impordid, öine kontroll, logi ja GDPR-käsk.
• Vajab poe veebilehe meeskonna tööd: kassa uudiskirja märkeruut, külalise e-posti panemine ostukorvile, kampaaniaklikkide salvestamine, sirvimise jälgimine ning küpsised sisselogimisel ja tellimuse esitamisel.
• Pole saadaval: automaatika Tervitus poe veebilehel tehtud liitumistele (need tulevad Magento API kaudu), sünkroonimisrežiim Ainult kassas turunduskirjade nõusoleku andnud kontaktid, leht Minu konto > Personaliseerimine, vidin Smaily soovitused ja link abandoned_cart_url (lingi mallis selle asemel poe veebilehe ostukorvi lehele).

Sisesta poe veebilehe aadress enne Campaign Intelligence'i ühendamist. Täielik kontrollnimekiri ja üleandmisjuhend poe veebilehe meeskonnale on dokumendis HEADLESS_STOREFRONTS.md (inglise keeles).

Mageplaza One Step Checkout on a Luma-based theme: what follows was read from its source code (versions 2.8.2 and 4.0.10), not tested on a running store — check it on yours after installing or updating. Other one-step checkouts and Mageplaza's Hyvä edition are not covered.

• Smaily Connect's newsletter checkbox shows below the payment methods, and ticking it subscribes the shopper.
• A guest's email reaches the cart as soon as it is typed, so abandoned-cart reminders work.
• Show one checkbox, not two. Both checkboxes are on after install. We recommend Smaily Connect's: set One Step Checkout's Show Newsletter Checkbox to No. If you keep One Step Checkout's instead, set Smaily Connect's Show a newsletter checkbox at checkout off and One Step Checkout's Checked Newsletter by default to No — a pre-ticked box is not consent. Its subscribers then sync under Subscribers only and All customers, but start no Welcome automation, and do not sync under Checkout opt-in only.

Check after install: (1) the checkout shows one newsletter checkbox; (2) a guest cart left after typing an email shows a reminder in the Log after the wait time; (3) a guest order with the box ticked appears in Marketing > Communications > Newsletter Subscribers and as a contact sync in the Log.

Mageplaza One Step Checkout Luma-põhisel teemal: järgnev on loetud selle lähtekoodist (versioonid 2.8.2 ja 4.0.10), mitte testitud töötaval poel — kontrolli seda oma poes pärast paigaldust või uuendust. Teisi üheleheküljelisi kassasid ja Mageplaza Hyvä versiooni see ei hõlma.

• Smaily Connecti uudiskirja märkeruut on makseviiside all ja selle märkimine teeb ostjast tellija.
• Külalise e-post jõuab ostukorvile kohe pärast sisestamist, nii et hüljatud ostukorvi meeldetuletused töötavad.
• Näita ühte märkeruutu, mitte kahte. Pärast paigaldust on mõlemad sees. Soovitame Smaily Connecti oma: määra One Step Checkouti valik Show Newsletter Checkbox väärtusele No. Kui jätad hoopis One Step Checkouti oma, lülita Smaily Connecti Näita kassas uudiskirja märkeruutu välja ja määra One Step Checkouti Checked Newsletter by default väärtusele No — eelnevalt märgitud ruut pole nõusolek. Selle tellijad sünkroonitakse siis režiimides Ainult turunduskirjade tellijad ja Kõik kliendid, kuid automaatika Tervitus ei käivitu ja režiimis Ainult kassas nõusoleku andnud neid ei sünkroonita.

Kontrolli pärast paigaldust: (1) kassas on üks uudiskirja märkeruut; (2) külalise ostukorv, mis jäeti pärast e-posti sisestamist, annab pärast ooteaega logisse meeldetuletuse; (3) külalistellimus märgitud ruuduga ilmub menüüsse Marketing > Communications > Newsletter Subscribers ja logisse kontaktide sünkroonimisena.

Every delivery is one row: contact syncs and automation triggers to Smaily, and catalog, customer, order and browse data to Campaign Intelligence — the Source column tells them apart. Entity is the contact's email address for a contact or automation row (a very long address shows as its first 12 characters of a hash). Last Error shows Smaily's or Campaign Intelligence's own words, in your admin language.

Details opens a panel with the attempt history, the payload as it was (or will be) sent, the last error and the last answer from Smaily or Campaign Intelligence. Passwords and API keys are never shown; contact data is shown in full so you can debug a delivery — treat it as personal data. Details, the Log's Updated column and the Dashboard's Recent activity show when a row's latest attempt happened: its delivery, its latest failure or its skip. Sent rows are kept for 30 days from that time, failed rows for 90.

Iga saadetis on üks rida: kontaktide sünkroonimised ja automaatikate käivitused Smailysse ning kataloogi-, kliendi-, tellimuse- ja sirvimisandmed Campaign Intelligence'i — veerg Allikas eristab neid. Kirje on kontakti või automaatika real kontakti e-posti aadress (väga pikk aadress kuvatakse räsi 12 esimese märgina). Viimane viga näitab Smaily või Campaign Intelligence'i enda sõnu, sinu halduse keeles.

Üksikasjad avab paneeli katsete ajaloo, andmesisuga nii, nagu see saadeti (või saadetakse), viimase vea ja Smaily või Campaign Intelligence'i viimase vastusega. Paroole ja API võtmeid ei näidata kunagi; kontaktiandmed näidatakse täielikult, et saaksid saadetist siluda — käsitle neid isikuandmetena. Üksikasjad, logi veerg Uuendatud ja töölaua Viimane tegevus näitavad, millal toimus rea viimane katse: selle kohaletoimetamine, viimane ebaõnnestumine või vahelejätmine. Saadetud ridu hoitakse sellest ajast 30 päeva, ebaõnnestunuid 90.

Campaign Intelligence'i enda vastused (näiteks „This setup token has expired…“) on inglise keeles.

These rows did not fail; nothing was sent, and they do not retry. Details gives the reason:

Need read ei ebaõnnestunud; midagi ei saadetud ja neid uuesti ei proovita. Üksikasjad annab põhjuse:

• Automatic retry. A delivery that fails for a passing reason is tried again after 1, 5, 15 and 60 minutes — 5 attempts over about 81 minutes — before it is marked Failed. When Smaily asks the store to slow down, the row waits as long as asked.
• No retry. A delivery that was refused outright — wrong credentials, a deleted workflow, data Smaily or Campaign Intelligence calls invalid — is marked Failed at once, so you see it now.
• Retry — select failed rows in the grid and choose Retry. Rows that cannot safely be sent again are left alone and counted ("… skipped because sending again would not be safe").
• Send again — on one failed row (in the grid or in Details), queues a new attempt as a new row; the failed row stays as your record.
• No Send again button? Sending again would reach the shopper twice or reach nobody: the reminder was withdrawn, a later message of the same kind already reached the contact, the contact's data was erased, or it is a nightly product list (built afresh each night).

Fix the cause first (see the tables above), then retry.

• Automaatne kordus. Mööduval põhjusel ebaõnnestunud saadetist proovitakse uuesti 1, 5, 15 ja 60 minuti pärast — 5 katset umbes 81 minuti jooksul —, enne kui see märgitakse Ebaõnnestunud. Kui Smaily palub poel aeglustada, ootab rida nii kaua, kui palutud.
• Kordust pole. Otse tagasi lükatud saadetis — valed kasutajaandmed, kustutatud töövoog, andmed, mida Smaily või Campaign Intelligence nimetab vigaseks — märgitakse kohe Ebaõnnestunud, et näeksid seda kohe.
• Proovi uuesti — vali tabelis ebaõnnestunud read ja vali Proovi uuesti. Read, mida pole ohutu uuesti saata, jäetakse puutumata ja loendatakse („… jäeti vahele, sest uuesti saatmine poleks ohutu“).
• Saada uuesti — ühel ebaõnnestunud real (tabelis või jaotises Üksikasjad) paneb uue katse järjekorda uue reana; ebaõnnestunud rida jääb sinu jaoks ajaloona alles.
• Nuppu „Saada uuesti“ pole? Uuesti saatmine jõuaks ostjani kaks korda või ei jõuaks kellenigi: meeldetuletus võeti tagasi, sama liiki hilisem kiri on kontaktini juba jõudnud, kontakti andmed on kustutatud või on tegu öise tootenimekirjaga (koostatakse igal ööl uuesti).

Kõrvalda kõigepealt põhjus (vt ülalolevaid tabeleid) ja proovi siis uuesti.

1. Is cron running? Run bin/magento cron:run --group smaily_connect once by hand; if rows in the Log then move from Pending, Magento's cron is not set up to run every minute.
2. Is Smaily connected? The Dashboard says Not connected when Smaily has not accepted the saved credentials.
3. Is contact sync on? Sync contacts to Smaily on Settings > Contacts, for the right website. On a new install, contacts sync only once the website's Contacts step is saved. Under Checkout opt-in only, only checkout signups sync.
4. What does the Log say? Filter on Failed and read Last Error — see The Log, error messages & fixes.

1. Kas cron töötab? Käivita üks kord käsitsi bin/magento cron:run --group smaily_connect; kui read logis liiguvad siis olekust Ootel edasi, pole Magento cron seadistatud iga minut käivituma.
2. Kas Smaily on ühendatud? Töölaud ütleb Pole ühendatud, kui Smaily pole salvestatud kasutajaandmeid vastu võtnud.
3. Kas kontaktide sünkroonimine on sees? Sünkrooni kontaktid Smailysse jaotises Seaded > Kontaktid, õige veebisaidi jaoks. Uues paigalduses sünkroonitakse kontakte alles siis, kui veebisaidi Kontaktide samm on salvestatud. Režiimis Ainult kassas turunduskirjade nõusoleku andnud kontaktid sünkroonitakse ainult kassas liitujad.
4. Mida logi ütleb? Filtreeri olekut Ebaõnnestunud ja loe veergu Viimane viga — vt Logi, veateated & lahendused.

Unsubscribes come back from Smaily every 15 minutes, and only under Subscribers only (consent). Under the other two modes, Smaily keeps its own unsubscribe and Magento is not changed.

Loobumised tulevad Smailyst tagasi iga 15 minuti järel ja ainult režiimis Ainult turunduskirjade tellijad (nõusolekuga). Kahes teises režiimis hoiab Smaily loobumist enda juures ja Magentot ei muudeta.

• The automation is Enabled with a workflow picked, for the cart's website (and language).
• The cart has an email address: a signed-in customer's, or a guest's typed on the checkout's email field.
• The cart has been idle longer than Wait (minutes), but less than 24 hours.
• The cart was not reminded already, and the address got no reminder for another cart in the last 24 hours (that row reads Skipped).
• The website's contact sync mode allows a reminder to this shopper — see Abandoned cart. A skipped cart's row reads Skipped with the reason.
• The address has not unsubscribed in Smaily — an automation never re-subscribes a contact who unsubscribed. An address that is not a contact yet is added as one.

• Automaatika on Lubatud ja töövoog valitud, ostukorvi veebisaidi (ja keele) jaoks.
• Ostukorvil on e-posti aadress: sisselogitud kliendi oma või külalise oma, mis on sisestatud kassa e-posti väljale.
• Ostukorv on olnud puutumata kauem kui Ooteaeg (minutites), kuid vähem kui 24 tundi.
• Ostukorvile pole meeldetuletust juba saadetud ja aadress pole viimase 24 tunni jooksul saanud teise ostukorvi meeldetuletust (see rida on Vahele jäetud).
• Veebisaidi kontaktide sünkroonimise režiim lubab sellele ostjale meeldetuletuse — vt Hüljatud ostukorv. Vahele jäetud ostukorvi rida on Vahele jäetud koos põhjusega.
• Aadress pole Smailys loobunud — automaatika ei telli kunagi uuesti kontakti, kes on loobunud. Aadress, mis pole veel kontakt, lisatakse kontaktiks.

Check that Show a newsletter checkbox at checkout is on for the website. The box shows on the payment step of Magento's own checkout — Luma-based themes and Hyvä's Luma-based checkout. The commercial Hyvä Checkout and a separate storefront do not show it (see Store types); for Mageplaza One Step Checkout, see One-step checkouts.

Kontrolli, et Näita kassas uudiskirja märkeruutu on veebisaidi jaoks sees. Ruut on Magento enda kassa maksesammul — Luma-põhised teemad ja Hyvä Luma-põhine kassa. Tasuline Hyvä Checkout ja eraldi poe veebileht seda ei näita (vt Poe tüübid); Mageplaza One Step Checkouti kohta vt Üheleheküljelised kassad.

Yes. Every record carries an id the receiving side remembers, so a repeated import or retry creates no duplicates. The contact import sends each contact with its current store status; it does not subscribe anyone under Subscribers only.

Jah. Igal kirjel on id, mida vastuvõtja pool mäletab, nii et korduv import või kordus ei tekita duplikaate. Kontaktide import saadab iga kontakti tema praeguse olekuga poes; režiimis Ainult turunduskirjade tellijad ei tee see kedagi tellijaks.

There is no sync-frequency setting; the 4-hour, 12-hour and daily choices of version 2.8.x are gone.

Sünkroonimise sageduse seadet pole; versiooni 2.8.x valikud 4 tundi, 12 tundi ja kord päevas on kadunud.

From the command line: bin/magento smaily:engine:disconnect --force. Data ingest stops and the extension tells Campaign Intelligence that this connection ends. If your store has no other connection, Campaign Intelligence pauses the store: it issues no recommendations and sends none of its automated emails, and it keeps your store's data. Reconnecting needs a fresh one‑time setup link and ends the pause. When Campaign Intelligence cannot be reached, the command still removes the connection and says so. Your store's data is deleted when you close your Smaily account. To stop Smaily syncing for a website, switch off Sync contacts to Smaily and the automations.

Käsurealt: bin/magento smaily:engine:disconnect --force. Andmevoog peatub ja laiendus annab Campaign Intelligence'ile teada, et see ühendus lõpeb. Kui su poel teist ühendust ei ole, paneb Campaign Intelligence poe pausile: soovitusi ei anta ja selle automaatseid e‑kirju ei saadeta, aga poe andmed jäävad alles. Taasühendamiseks on vaja värsket ühekordset seadistuslinki ja see lõpetab pausi. Kui Campaign Intelligence'iga ühendust ei saa, eemaldab käsk ühenduse ikkagi ja ütleb selle välja. Su poe andmed kustutatakse, kui sulged oma Smaily konto. Veebisaidi Smaily sünkroonimise peatamiseks lülita välja Sünkrooni kontaktid Smailysse ja automaatikad.

• Disabling stops everything at once. On the next setup:upgrade, Magento drops the extension's tables — the queues (including anything not yet sent), the Log, the abandoned-cart tracker and the import progress. Your settings are kept.
• Uninstalling also removes the settings (the encrypted Smaily password and Campaign Intelligence key included) and the record of personalization opt-outs.
• Nothing is deleted in Smaily or Campaign Intelligence. Contacts and data already there stay. On uninstall, as on disconnect, the extension tells Campaign Intelligence that this connection ends: if your store has no other connection, Campaign Intelligence stops using your store's data at once and keeps it. Your store's data is deleted when you close your Smaily account.

The commands are in INSTALLING.md › Disabling or removing the module.

• Keelamine peatab kohe kõik. Järgmisel käsul setup:upgrade kustutab Magento laienduse tabelid — järjekorrad (koos veel saatmata kirjetega), logi, hüljatud ostukorvide jälgija ja impordi edenemise. Sinu seaded säilivad.
• Eemaldamine (uninstall) kustutab ka seaded (koos krüpteeritud Smaily parooli ja Campaign Intelligence'i võtmega) ning personaliseerimisest loobumiste kirje.
• Smailys ja Campaign Intelligence'is ei kustutata midagi. Seal juba olevad kontaktid ja andmed jäävad alles. Eemaldamisel, nagu ka lahtiühendamisel, annab laiendus Campaign Intelligence'ile teada, et see ühendus lõpeb: kui su poel teist ühendust ei ole, lõpetab Campaign Intelligence su poe andmete kasutamise kohe ja hoiab need alles. Su poe andmed kustutatakse, kui sulged oma Smaily konto.

Käsud on juhendis INSTALLING.md › Disabling or removing the module (inglise keeles).

The admin pages speak English and Estonian and follow your admin user's interface locale. The storefront texts — the Personalization page, the checkout newsletter checkbox, the recommendations heading and the saved-cart messages — follow the store view's locale and ship in English, Estonian (et_EE), Russian (ru_RU), Finnish (fi_FI), Latvian (lv_LV) and Lithuanian (lt_LT).

The Russian, Finnish, Latvian and Lithuanian texts are machine translations that a native speaker has not reviewed yet. To change one, add the phrase to your theme's translation file (i18n/<locale>.csv): Magento uses the theme's wording over the extension's. Other languages can be added as Magento translation packs.

Halduse lehed räägivad inglise ja eesti keelt ning järgivad sinu halduse kasutaja liidese lokaati. Poe tekstid — personaliseerimise leht, kassa uudiskirja märkeruut, soovituste pealkiri ja salvestatud ostukorvi teated — järgivad poevaate lokaati ning on olemas inglise, eesti (et_EE), vene (ru_RU), soome (fi_FI), läti (lv_LV) ja leedu (lt_LT) keeles.

Vene, soome, läti ja leedu tekstid on masintõlked, mida emakeelne kõneleja pole veel üle vaadanud. Teksti muutmiseks lisa fraas oma teema tõlkefaili (i18n/<lokaat>.csv): Magento eelistab teema sõnastust laienduse omale. Teisi keeli saab lisada Magento tõlkepakettidena.

Your Magento database also keeps the delivery queues and the Log (sent rows 30 days, failed rows 90), and a small record of which carts were dealt with. While the abandoned-cart automation is on, the email a guest types on Magento's checkout is saved to the cart before the guest submits it; it reaches Smaily only with a reminder, and stays on the cart until Magento deletes the cart (its Quote Lifetime setting). Mention this in your privacy notice.

Discount codes — when an automation's Send a discount code is on, the single-use code the extension makes for a shopper is one of the cart price rule's coupon codes in Magento. The code holds no email address; the Log row of the email it went out in links it to the shopper. A used code stays with your store's coupon codes. An erasure deletes the shopper's unused codes (see Export and erasure).

Sinu Magento andmebaas hoiab ka saatmisjärjekordi ja logi (saadetud read 30 päeva, ebaõnnestunud 90) ning väikest kirjet selle kohta, milliste ostukorvidega on tegeletud. Kui hüljatud ostukorvi automaatika on sees, salvestatakse e-post, mille külaline Magento kassas sisestab, ostukorvile enne, kui külaline selle esitab; Smailyni jõuab see ainult koos meeldetuletusega ja jääb ostukorvile, kuni Magento ostukorvi kustutab (selle seade Quote Lifetime). Maini seda oma privaatsusteates.

Sooduskoodid — kui automaatika Saada sooduskood on sees, on laienduse ostjale loodud ühekordne kood üks ostukorvi hinnareegli kupongikoodidest Magentos. Koodil endal e-posti aadressi ei ole; ostjaga seob selle logi rida e-kirjast, millega kood saadeti. Kasutatud kood jääb su poe kupongikoodide hulka. Kustutamine kustutab ostja kasutamata koodid (vt Eksport ja kustutamine).

With Campaign Intelligence connected, the storefront may set these first-party cookies. List them in your cookie policy.

The first three record a click on your own email so a purchase can be credited to it; they are set without the consent check, as in Smaily's other store extensions. Decide with your legal counsel how your cookie banner should describe them.

Kui Campaign Intelligence on ühendatud, võib pood seada järgmised esimese osapoole küpsised. Loetle need oma küpsiste poliitikas.

Esimesed kolm salvestavad kliki sinu enda e-kirjas, et ostu saaks sellele omistada; need seatakse ilma nõusoleku kontrollita, nagu Smaily teistes poelaiendustes. Otsusta koos oma juristiga, kuidas sinu küpsisebänner neid kirjeldab.

Personalized recommendations are on by default. A customer can switch them off under My Account > Personalization: untick Allow personalized recommendations and press Save Preference. The page exists only while Campaign Intelligence is connected and active. If the store cannot read the preference at that moment, the page offers a single Opt out of personalized recommendations button instead.

• The choice is kept by the store, written onto the Smaily contact (smaily_rec_profiling) when Smaily has one, and sent to Campaign Intelligence as a queued delivery (engine.profiling_consent in the Log), so an outage only delays it.
• A newsletter unsubscribe — in the store, in the admin (the Unsubscribe action in Newsletter Subscribers), or in Smaily and mirrored back — also turns personalization off; subscribing again turns it back on, unless the shopper opted out separately. Deleting the subscriber in Newsletter Subscribers is not an unsubscribe and leaves personalization as it is.
• An opted-out shopper's browsing is not linked to their account at login.
• An admin using Login as Customer, or creating an order in the admin, links no browsing and credits no recommendation.

Personaalsed soovitused on vaikimisi sees. Klient saab need välja lülitada lehel Minu konto > Personaliseerimine: eemalda märge Luba personaalsed soovitused ja vajuta Salvesta eelistus. Leht on olemas ainult siis, kui Campaign Intelligence on ühendatud ja aktiivne. Kui pood ei saa eelistust sel hetkel lugeda, pakub leht selle asemel ühte nuppu Loobu personaalsetest soovitustest.

• Valikut hoiab pood, see kirjutatakse Smaily kontaktile (smaily_rec_profiling), kui Smailys kontakt on, ja saadetakse Campaign Intelligence'i järjekorras oleva saadetisena (logis engine.profiling_consent), nii et katkestus ainult viivitab seda.
• Uudiskirjast loobumine — poes, halduses (toiming Unsubscribe loendis Newsletter Subscribers) või Smailys ja tagasi peegeldatuna — lülitab välja ka personaliseerimise; uuesti liitumine lülitab selle tagasi sisse, kui ostja pole sellest eraldi loobunud. Tellija kustutamine loendis Newsletter Subscribers ei ole loobumine ja jätab personaliseerimise nii, nagu see oli.
• Loobunud ostja sirvimist ei seota sisselogimisel tema kontoga.
• Haldur, kes kasutab funktsiooni Login as Customer või loob tellimuse halduses, ei seo sirvimist ega omista soovitust.

For a data subject request, run on the server:

bin/magento smaily:gdpr export shopper@example.com          # Art. 15: prints JSON
bin/magento smaily:gdpr erase shopper@example.com --force   # Art. 17

Both cover the shopper's record in Campaign Intelligence and the extension's own tables — the two delivery queues and the abandoned-cart tracker. The erasure:

• deletes queued messages not yet sent, so nothing more goes out;
• anonymizes sent and failed rows — they keep their type, status and times as your record, with the address and contents replaced by [erased], and can no longer be retried. They are removed on their normal schedule: 30 days after the delivery, 90 days after the failure;
• marks the shopper's carts as erased, so no abandoned-cart reminder goes out for them. The mark stays while the cart is still open in the store; once the cart is ordered or closed, the nightly tidy-up removes it 30 days after its last change before the erasure, or sooner if Magento deletes the cart;
• removes the visitor token and the session identifier from the recommendation record of the shopper's orders — the orders placed with the address and those of a customer account that has it. The orders stay, and so does which recommendation or email led to each sale;
• erases the shopper in Campaign Intelligence.

The discount codes the extension made for that address are covered too. The export lists each one: the code, when it was made, its last valid day and whether it was used. The erasure deletes the codes that were never used. A used code stays, because its order still names it; the code holds no email address, and the erasure anonymizes the Log rows that linked it to the shopper. Codes you generated yourself in Magento are never changed. A code is found while the email it went out in is still in the Log.

It prints one line per place it reached. The local part runs first; if Campaign Intelligence is unreachable or the account is deactivated, the command says so — run it again later to finish. Running it twice is harmless.

The command does not touch Magento's own customer data (use Magento's tools) or the Smaily contact (delete it in Smaily).

Andmesubjekti taotluse korral käivita serveris:

bin/magento smaily:gdpr export shopper@example.com          # art 15: väljastab JSON-i
bin/magento smaily:gdpr erase shopper@example.com --force   # art 17

Mõlemad hõlmavad ostja kirjet Campaign Intelligence'is ja laienduse enda tabeleid — kahte saatmisjärjekorda ja hüljatud ostukorvide jälgijat. Kustutamine:

• kustutab järjekorras olevad saatmata kirjed, nii et midagi enam teele ei lähe;
• anonüümib saadetud ja ebaõnnestunud read — need säilitavad sinu tõendina tüübi, oleku ja ajad, aadress ja sisu asendatakse väärtusega [erased] ning neid ei saa enam uuesti proovida. Need eemaldatakse tavapärase ajakava järgi: 30 päeva pärast kohaletoimetamist, 90 päeva pärast ebaõnnestumist;
• märgib ostja ostukorvid kustutatuks, nii et nende kohta hüljatud ostukorvi meeldetuletust ei saadeta. Märge jääb alles, kuni ostukorv on poes veel avatud; kui ostukorv on tellitud või suletud, eemaldab öine korrastus selle 30 päeva pärast viimast muudatust enne kustutamist, või varem, kui Magento ostukorvi kustutab;
• eemaldab ostja tellimuste soovituskirjest külastajatunnuse ja seansitunnuse — nii selle aadressiga esitatud tellimustelt kui ka selle aadressiga kliendikonto tellimustelt. Tellimused jäävad alles, samuti see, milline soovitus või e-kiri iga ostuni viis;
• kustutab ostja Campaign Intelligence'ist.

Eksport ja kustutamine hõlmavad ka sooduskoode, mille laiendus selle aadressi jaoks lõi. Eksport loetleb iga koodi: koodi, selle loomise aja, viimase kehtivuspäeva ning kas seda on kasutatud. Kustutamine kustutab koodid, mida pole kunagi kasutatud. Kasutatud kood jääb alles, sest tellimus viitab sellele; koodil endal e-posti aadressi ei ole ja kustutamine anonüümib logi read, mis seda ostjaga sidusid. Magentos ise loodud koode ei muudeta kunagi. Kood leitakse seni, kuni e-kiri, millega see saadeti, on veel logis.

See väljastab ühe rea iga koha kohta, kuhu jõudis. Kohalik osa käib esimesena; kui Campaign Intelligence on kättesaamatu või konto deaktiveeritud, ütleb käsk seda — käivita see hiljem uuesti, et lõpetada. Kahekordne käivitamine ei tee kahju.

Käsk ei puuduta Magento enda kliendiandmeid (kasuta Magento tööriistu) ega Smaily kontakti (kustuta see Smailys).

If you use Campaign Intelligence, your store's privacy policy needs to describe personalization. Below is a template paragraph, written from what the extension does, to adapt into your own policy. This is not legal advice — have your own legal counsel review the adapted text, including the lawful-basis choice.

Personalized product recommendations (profiling)

Who processes the data. [Your store name] ("we") is the data controller. To personalize our email marketing we use the Smaily Campaign Intelligence service of Sendsmaily OÜ ("Smaily"), which processes this data on our behalf as our data processor, under a data processing agreement.

What we do. We use your purchase history and — if you have accepted marketing cookies — your browsing in our online store to personalize the product recommendations in the emails we send you. This is profiling: an automated analysis of your shopping to predict which products may interest you. It affects only which products we show you; it has no legal or similarly significant effect on you.

What data is used.

• Contact and account details: email address, name, phone number, country and language.
• Purchase history: products ordered, quantities, prices, order dates and statuses, and returned items.
• Browsing in our store (only if you accepted marketing cookies): products viewed, searches and cart activity, linked to a pseudonymous session identifier — and, while you are logged in and have not opted out, to your account.
• Cookies we set when you arrive through a recommendation link in our emails (smaily_rec_id and smaily_rec_ctx, kept up to 30 days; smaily_rec_uid, up to 365 days), to measure which recommendations led to purchases.
• Abandoned-cart reminders (if we use them; separate from profiling): the email address you type at checkout is saved with your cart before you place the order, so that we can remind you of the cart within 24 hours by email.

Legal basis. Our legitimate interest in offering relevant marketing (Article 6(1)(f) GDPR), with your right to object at any time (Article 21). Browsing data is collected only with your marketing-cookie consent. [Your legal counsel: confirm the lawful basis and document a legitimate-interest assessment.]

How to opt out. Log in, open My Account > Personalization, untick "Allow personalized recommendations" and press "Save Preference". You will still receive our emails, without personalization. Unsubscribing from our newsletter also stops personalization. You can also contact us at [your contact email].

Your rights. You may access the data used for recommendations and get a copy, have it erased, object to profiling, and complain to your data protection authority [e.g. Andmekaitse Inspektsioon in Estonia]. Contact us at [your contact email].

Retention. We keep each kind of data only as long as its purpose needs it; after that it is deleted automatically and permanently:

• Your browsing activity in our store (pages and products viewed, cart events and searches) and your interactions with our emails (opens and clicks): 14 months after each event, so that we can compare with the same month a year earlier (seasonal purchases), plus two months of margin.
• The pseudonymous visitor token: 14 months after its last activity (its creation, or the latest order that carried it), so that we can recognize you as a returning shopper in our store (recommendations in the store, crediting a purchase) across a year of repeat purchases, plus two months of margin. The cookie in your browser expires on its own schedule, as stated above.
• The product recommendations computed for you, the records of which recommendation led to which purchase, and the history of your engagement with our emails: 2 years (730 days), for two-year reporting and to look back at purchases.
• A recommendation that a newer one replaced: 180 days after the replacement, so that a later click or purchase can still be credited to the email that showed the product, and so that products are not repeated too soon. One that is still linked to a click or purchase record is kept as long as that record, at most 2 years.
• Short-lived technical records: why a recommendation was chosen, 30 days (support and error tracing); signals from your shopping behavior that the next recommendations act on, 30 days after they were acted on, or 90 days after they were detected if they never were (an old signal no longer describes you); changes to the weights of the recommendation rules, 90 days (checking and undoing a wrong change); data our store sent twice, 90 days (so that it is stored once).
• Your contact and account details and the recommendation profile kept with them, your purchase history and our product catalog: as long as we use this service for our store, to provide the service.

When we close our Smaily account, all data held for our store in this service is deleted; disconnecting our store from the service does not delete it. If you ask us to erase your data at any time (see "Your rights" above), it is deleted immediately regardless of these periods; we retain only a record showing that the deletion was carried out. In our store's database, the erasure also removes the visitor token and the session identifier from your orders; the record of which recommendation or email led to a purchase stays with the order. Abandoned-cart reminder data (the email address you type at checkout, kept with your cart — a separate feature from the profiling above) is kept in our store's database and deleted automatically together with your cart [30] days after the cart last changed, whether or not you placed the order; the record of a reminder sent to you is deleted 30 days after it was sent, or 90 days after the sending failed. [The cart period is your store's Stores > Configuration > Sales > Checkout > Shopping Cart > Quote Lifetime (days) setting, 30 by default; Magento deletes expired carts in a nightly clean-up.]

Kui kasutad Campaign Intelligence'i, peab sinu poe privaatsuspoliitika personaliseerimist kirjeldama. Allpool on mallilõik, mis on kirjutatud selle põhjal, mida laiendus teeb, ja mida saad oma poliitikasse kohandada. See ei ole õigusnõustamine — lase kohandatud tekst oma juristil üle vaadata, sh õigusliku aluse valik.

Personaalsed tootesoovitused (profileerimine)

Kes andmeid töötleb. [Sinu poe nimi] („meie“) on vastutav töötleja. E-posti turunduse personaliseerimiseks kasutame Sendsmaily OÜ („Smaily“) teenust Smaily Campaign Intelligence, mis töötleb neid andmeid meie nimel volitatud töötlejana, andmetöötluslepingu alusel.

Mida me teeme. Kasutame sinu ostuajalugu ja — kui oled nõustunud turundusküpsistega — sinu sirvimist meie e-poes, et personaliseerida sulle saadetavate e-kirjade tootesoovitusi. See on profileerimine: sinu ostukäitumise automaatne analüüs, et ennustada, millised tooted võiksid sind huvitada. See mõjutab ainult seda, milliseid tooteid sulle näitame; sellel pole sinu jaoks õiguslikke ega muid samaväärselt olulisi tagajärgi.

Milliseid andmeid kasutatakse.

• Kontakt- ja kontoandmed: e-posti aadress, nimi, telefoninumber, riik ja keel.
• Ostuajalugu: tellitud tooted, kogused, hinnad, tellimuste kuupäevad ja olekud ning tagastatud tooted.
• Sirvimine meie poes (ainult siis, kui nõustusid turundusküpsistega): vaadatud tooted, otsingud ja ostukorvitegevus, seotuna pseudonüümse seansitunnusega — ning sisselogituna ja loobumata ka sinu kontoga.
• Küpsised, mille seame, kui saabud meie e-kirjas olnud soovituslingi kaudu (smaily_rec_id ja smaily_rec_ctx, säilivad kuni 30 päeva; smaily_rec_uid, kuni 365 päeva), et mõõta, millised soovitused viisid ostuni.
• Hüljatud ostukorvi meeldetuletused (kui me neid kasutame; eraldi profileerimisest): kassas sisestatud e-posti aadress salvestatakse sinu ostukorviga enne tellimuse esitamist, et saaksime sulle ostukorvi 24 tunni jooksul e-postiga meelde tuletada.

Õiguslik alus. Meie õigustatud huvi pakkuda asjakohast turundust (GDPR art 6 lg 1 p f) koos sinu õigusega igal ajal vastuväide esitada (art 21). Sirvimisandmeid kogume ainult sinu turundusküpsiste nõusolekul. [Sinu jurist: kinnita õiguslik alus ja dokumenteeri õigustatud huvi hindamine.]

Kuidas loobuda. Logi sisse, ava Minu konto > Personaliseerimine, eemalda märge „Luba personaalsed soovitused“ ja vajuta „Salvesta eelistus“. Meie kirju saad edasi, ilma personaliseerimiseta. Uudiskirjast loobumine peatab samuti personaliseerimise. Võid ka kirjutada meile aadressil [sinu kontakt-e-post].

Sinu õigused. Sul on õigus tutvuda soovituste jaoks kasutatavate andmetega ja saada neist koopia, nõuda nende kustutamist, esitada vastuväide profileerimisele ja pöörduda andmekaitse järelevalveasutuse poole [nt Andmekaitse Inspektsioon]. Kirjuta meile aadressil [sinu kontakt-e-post].

Säilitamine. Hoiame iga liiki andmeid ainult nii kaua, kui selle eesmärk nõuab; seejärel kustutatakse need automaatselt ja jäädavalt:

• Sinu sirvimistegevus meie poes (vaadatud lehed ja tooted, ostukorvisündmused ja otsingud) ning sinu tegevus meie e-kirjadega (avamised ja klikid): 14 kuud pärast iga sündmust, et saaksime võrrelda eelmise aasta sama kuuga (hooajalised ostud), pluss kahe kuu varu.
• Pseudonüümne külastajatunnus: 14 kuud pärast selle viimast kasutust (loomist või viimast tellimust, millega see kaasas oli), et tunda sind meie poes naasva ostjana ära (soovitused poes, ostu sidumine soovitusega) aasta jooksul korduvate ostude vältel, pluss kahe kuu varu. Sinu brauseris olev küpsis aegub oma tähtaja järgi, nagu eespool kirjas.
• Sulle arvutatud tootesoovitused, kirjed selle kohta, milline soovitus millise ostuni viis, ning sinu e-kirjadega seotud kaasatuse ajalugu: 2 aastat (730 päeva), kaheaastase aruandluse ja ostude tagasivaate jaoks.
• Soovitus, mille uuem soovitus asendas: 180 päeva pärast asendamist, et hilisemat klikki või ostu saaks endiselt siduda e-kirjaga, mis toodet näitas, ja et samu tooteid liiga varsti ei korrataks. Kui soovitus on seotud kliki või ostu kirjega, hoitakse seda sama kaua kui seda kirjet, kõige rohkem 2 aastat.
• Lühiajalised tehnilised kirjed: miks soovitus valiti — 30 päeva (kasutajatugi ja vigade uurimine); sinu ostukäitumise signaalid, millele järgmised soovitused toetuvad — 30 päeva pärast seda, kui neid kasutati, või 90 päeva pärast avastamist, kui neid ei kasutatud (vana signaal ei kirjelda sind enam); soovitusreeglite kaalude muudatused — 90 päeva (vale muudatuse kontrollimiseks ja tagasivõtmiseks); meie poe kaks korda saadetud andmed — 90 päeva (et need salvestataks ühe korra).
• Sinu kontakt- ja kontoandmed koos nende juures hoitava soovitusprofiiliga, sinu ostuajalugu ja meie tootekataloog: seni, kuni kasutame seda teenust oma poe jaoks, teenuse osutamiseks.

Kui sulgeme oma Smaily konto, kustutatakse kõik selles teenuses meie poe kohta hoitavad andmed; poe lahtiühendamine teenusest neid ei kustuta. Kui palud oma andmed igal ajal kustutada (vt eespool „Sinu õigused“), kustutatakse need kohe, sõltumata eespool nimetatud tähtaegadest; alles jääb üksnes kirje, mis tõendab, et kustutamine on tehtud. Meie poe andmebaasis eemaldab kustutamine sinu tellimustelt ka külastajatunnuse ja seansitunnuse; kirje selle kohta, milline soovitus või e-kiri ostuni viis, jääb tellimuse juurde. Hüljatud ostukorvi meeldetuletuse andmeid (kassas sisestatud e-posti aadress, mida hoitakse koos sinu ostukorviga — eraldiseisev funktsioon eespool kirjeldatud profileerimisest) hoitakse meie poe andmebaasis ning need kustutatakse automaatselt koos ostukorviga [30] päeva pärast ostukorvi viimast muudatust, olenemata sellest, kas vormistasid tellimuse; kirje sulle saadetud meeldetuletuse kohta kustutatakse 30 päeva pärast selle saatmist või 90 päeva pärast seda, kui saatmine ebaõnnestus. [Ostukorvi tähtaeg on sinu poe seade Stores > Configuration > Sales > Checkout > Shopping Cart > Quote Lifetime (days), vaikimisi 30; Magento kustutab aegunud ostukorvid öise korrastusega.]

• Secrets are encrypted — the Smaily API password and the Campaign Intelligence API key are stored with Magento's own encryption.
• Secrets never reach the browser — browse events pass through your server; the Log and its Details never show a password or key.
• The setup token is not kept — it is exchanged once, and only an https address on intelligence.smaily.com is accepted, both for the setup link and for the addresses the engine answers with.
• The log file masks addresses — var/log/smaily_connect.log writes email addresses as j***@e***.com.

Smaily Connect is operated by Sendsmaily OÜ. Questions: info@smaily.com.

• Saladused on krüpteeritud — Smaily API parool ja Campaign Intelligence'i API võti salvestatakse Magento enda krüpteeringuga.
• Saladused ei jõua brauserisse — sirvimissündmused liiguvad läbi sinu serveri; logi ja selle Üksikasjad ei näita kunagi parooli ega võtit.
• Seadistusvõtit ei hoita — see vahetatakse üks kord ja vastu võetakse ainult https-aadress domeenil intelligence.smaily.com, nii seadistuslingi kui ka mootori vastuses olevate aadresside puhul.
• Logifail maskeerib aadressid — var/log/smaily_connect.log kirjutab e-posti aadressid kujul j***@e***.com.

Smaily Connecti haldab Sendsmaily OÜ. Küsimused: info@smaily.com.

Run from the Magento root as the user that owns the Magento files.

Käivita Magento juurkaustas, Magento failide omaniku kasutajana.

Version 3 replaces the 2.8.x module, but the composer package name is the same and your settings migrate automatically. Write down your 2.8.x settings first. composer update alone stays on 2.8.x, so require version 3. Until 3.0.0 is released, the commands give the release candidate's exact version, as the releases page names it: ^3.0 does not install a release candidate on a standard Magento project, which accepts stable versions only. From 3.0.0 on, composer require smaily/smailyformagento:^3.0 is enough. In production mode:

bin/magento maintenance:enable
composer require smaily/smailyformagento:3.0.0-rc17
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy en_US   # every locale your store uses
bin/magento maintenance:disable
bin/magento cache:flush

In developer or default mode, composer require, setup:upgrade and cache:flush are enough.

If 2.8.x was copied into app/code (the folder app/code/Smaily/SmailyForMagento exists, and composer show smaily/smailyformagento answers that the package is not found), delete that folder first, then install version 3. Version 3 does not replace a copy in app/code: installed beside it, the 2.8.x module stays enabled. Delete the folder only: the 2.8.x settings stay in the database and migrate as on a composer store. Do not run bin/magento module:uninstall for Smaily_SmailyForMagento: once version 3 is installed, it removes version 3. In production mode:

bin/magento maintenance:enable
rm -rf app/code/Smaily/SmailyForMagento
composer require smaily/smailyformagento:3.0.0-rc17
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy en_US   # every locale your store uses
bin/magento maintenance:disable
bin/magento cache:flush

In developer or default mode, the rm -rf command, composer require, setup:upgrade and cache:flush are enough. To install version 3 from the release ZIP instead, replace the composer require line with steps 1 and 2 of INSTALLING.md: download and check the ZIP, then extract it into app/code/Smaily/Connect. The other commands stay the same.

• The admin notification says the earlier settings were migrated. Every Marketing > Smaily Connect page opens the Initial setup until it is finished — once, for the whole store; it shows the migrated settings, and on a store with more than one website it lists the websites that hold their own — check them against your notes. For a website where 2.8.x had Enable Module = No, contact sync stays off: its Contacts step shows Sync contacts to Smaily unticked, and Continue keeps it off. Tick it there to switch contact sync on. A website where 2.8.x synced contacts keeps syncing from the upgrade on; one where its synchronization was off or never saved sends no contacts until its Contacts step is saved.
• For a website where 2.8.x had Enable Subscribers Collection on with no Autoresponder ID, 2.8.x sent no welcome email, and the welcome automation stays off. The admin notification "Smaily Connect upgrade: the welcome automation has no workflow" names those websites. To send a welcome email there, pick each of those websites on Settings, and on the Automations tab tick Enabled for Welcome and pick a Smaily Workflow.
• Likewise, for a website where 2.8.x had Enable Abandoned Cart on with no Autoresponder ID, 2.8.x sent no abandoned-cart reminder, and the abandoned-cart automation stays off. The admin notification "Smaily Connect upgrade: the abandoned-cart automation has no workflow" names those websites. To send reminders there, pick each of those websites on Settings, and on the Automations tab tick Enabled for Abandoned cart and pick a Smaily Workflow.
• The old newsletter captcha is not carried over — use Magento's own reCAPTCHA for newsletter forms.
• The sync-frequency setting is gone: changes sync as they happen.
• Switch off any other abandoned-cart emails before switching the Smaily one on.

Exactly what migrates and what changes is in UPGRADING.md.

Versioon 3 asendab mooduli 2.8.x, kuid composeri paketi nimi on sama ja sinu seaded migreeritakse automaatselt. Pane kõigepealt kirja oma 2.8.x seaded. Ainult composer update jääb versioonile 2.8.x, seega nõua versiooni 3. Kuni 3.0.0 väljalaskeni annavad käsud väljalaskekandidaadi täpse versiooni, nagu väljalasete leht selle nimetab: ^3.0 ei paigalda tavalises Magento projektis väljalaskekandidaati, sest see lubab ainult stabiilseid versioone. Alates versioonist 3.0.0 piisab käsust composer require smaily/smailyformagento:^3.0. Tootmisrežiimis:

bin/magento maintenance:enable
composer require smaily/smailyformagento:3.0.0-rc17
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy en_US   # kõik poe keeleseaded
bin/magento maintenance:disable
bin/magento cache:flush

Arendus- või vaikerežiimis piisab käskudest composer require, setup:upgrade ja cache:flush.

Kui 2.8.x kopeeriti kausta app/code (kaust app/code/Smaily/SmailyForMagento on olemas ja composer show smaily/smailyformagento vastab, et paketti ei leitud), kustuta kõigepealt see kaust ja paigalda siis versioon 3. Versioon 3 ei asenda koopiat kaustas app/code: kui see paigaldada koopia kõrvale, jääb 2.8.x moodul sisselülitatuks. Kustuta ainult kaust: 2.8.x seaded jäävad andmebaasi ja migreeritakse nagu composeriga paigaldatud poes. Ära käivita mooduli Smaily_SmailyForMagento jaoks käsku bin/magento module:uninstall: kui versioon 3 on paigaldatud, eemaldab see versiooni 3. Tootmisrežiimis:

bin/magento maintenance:enable
rm -rf app/code/Smaily/SmailyForMagento
composer require smaily/smailyformagento:3.0.0-rc17
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy en_US   # kõik poe keeleseaded
bin/magento maintenance:disable
bin/magento cache:flush

Arendus- või vaikerežiimis piisab käsust rm -rf ning käskudest composer require, setup:upgrade ja cache:flush. Väljalaske ZIP-ist paigaldamiseks asenda rida composer require juhendi INSTALLING.md (inglise keeles) sammudega 1 ja 2: laadi ZIP alla, kontrolli seda ja paki see lahti kausta app/code/Smaily/Connect. Ülejäänud käsud jäävad samaks.

• Halduse teade ütleb, et varasemad seaded migreeriti. Iga Turundus > Smaily Connect leht avab Algseadistuse, kuni see on lõpetatud — üks kord, kogu poe jaoks; see näitab migreeritud seadeid ja mitme veebisaidiga poes loetleb veebisaidid, millel on oma väärtused — võrdle neid oma märkmetega. Veebisaidil, kus 2.8.x-is oli Enable Module = No, jääb kontaktide sünkroonimine välja: selle Kontaktid samm näitab valikut Sünkrooni kontaktid Smailysse ilma linnukeseta ja Jätka jätab selle välja. Sünkroonimise sisselülitamiseks pane sinna linnuke. Veebisait, kus 2.8.x sünkroonis kontakte, sünkroonib edasi kohe pärast uuendamist; veebisait, kus sünkroonimine oli väljas või salvestamata, ei saada kontakte enne, kui selle Kontaktid samm on salvestatud.
• Veebisaidil, kus 2.8.x-is oli Enable Subscribers Collection sees, kuid Autoresponder ID puudus, ei saatnud 2.8.x tervituskirja ja tervitusautomaatika jääb välja. Halduse teade „Smaily Connecti uuendus: tervitusautomaatikal pole töövoogu“ nimetab need veebisaidid. Tervituskirja saatmiseks vali lehel Seaded järjest iga nimetatud veebisait ning märgi vahekaardil Automaatikad sündmuse Tervitus juures Lubatud ja vali Smaily töövoog.
• Samamoodi: veebisaidil, kus 2.8.x-is oli Enable Abandoned Cart sees, kuid Autoresponder ID puudus, ei saatnud 2.8.x hüljatud ostukorvi meeldetuletust ja hüljatud ostukorvi automaatika jääb välja. Halduse teade „Smaily Connecti uuendus: hüljatud ostukorvi automaatikal pole töövoogu“ nimetab need veebisaidid. Meeldetuletuste saatmiseks vali lehel Seaded järjest iga nimetatud veebisait ning märgi vahekaardil Automaatikad sündmuse Hüljatud ostukorv juures Lubatud ja vali Smaily töövoog.
• Vana uudiskirja captcha't üle ei tooda — kasuta uudiskirja vormidel Magento enda reCAPTCHA-t.
• Sünkroonimise sageduse seadet enam pole: muudatused sünkroonitakse kohe.
• Lülita muud hüljatud ostukorvi kirjad välja enne, kui Smaily oma sisse lülitad.

Täpselt, mis migreeritakse ja mis muutub, kirjeldab UPGRADING.md (inglise keeles).