S Smaily Connect Magento 2 · Documentation Magento 2 · Dokumentatsioon

OverviewÜlevaade

Smaily Connect links your Magento store to Smaily email marketing and, optionally, to Smaily Campaign Intelligence for personalized product recommendations. Smaily Connect ühendab sinu Magento poe Smaily e-turundusega ja soovi korral Smaily Campaign Intelligence'iga, mis pakub personaalseid tootesoovitusi.

What is Smaily Connect?Mis on Smaily Connect?

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.

How the pieces fit togetherKuidas osad kokku sobivad

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.

Under the hood

All background work runs in Magento's cron, in its own smaily_connect cron group. A delivery that fails is retried on its own, so nothing is lost when Smaily or Campaign Intelligence is briefly out of reach. Every delivery shows in Marketing > Smaily Connect > Log.

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.

Kapoti all

Kogu taustatöö käib Magento cronis, laienduse oma cron-grupis smaily_connect. Ebaõnnestunud saadetist proovitakse ise uuesti, nii et kui Smaily või Campaign Intelligence on korraks kättesaamatu, ei lähe midagi kaduma. Iga saadetis on näha menüüs Turundus > Smaily Connect > Logi.

Before you startEnne alustamist

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.
ComponentSupported
Magento Open Source / Adobe Commerce / Mage-OS2.4.4 or newer
PHP8.1 – 8.4
StorefrontLuma-based themes; Hyvä with the compatibility module; a separate (headless) storefront with its own additions — see Store types
CronEvery minute

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.
KomponentToetatud
Magento Open Source / Adobe Commerce / Mage-OS2.4.4 või uuem
PHP8.1 – 8.4
Poe veebilehtLuma-põhised teemad; Hyvä koos ühilduvusmooduliga; eraldi (headless) poe veebileht koos selle enda lisadega — vt Poe tüübid
CronIga minut

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


Getting startedAlustamine

Install the extension, then work through the five-step initial setup in the admin. Paigalda laiendus ja läbi halduses viiesammuline algseadistus.

Install the extensionLaienduse paigaldus

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-rc11
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-rc11
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.

Finding your way aroundKus mis asub

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

PageWhat it is
DashboardThe landing page: a one-line health verdict, the status of Smaily, Campaign Intelligence and browse tracking, delivery counters and the latest activity.
Initial setupThe guided five-step setup. Until it is finished, every Smaily Connect page brings you here. You can run it again any time; your settings are kept.
SettingsEverything from the initial setup as tabs — Connection, Contacts, Automations, Intelligence, RSS — plus the historical imports. Each tab has its own save button.
LogEvery delivery to Smaily and Campaign Intelligence, with retry for failed rows. Check here first if something seems off.

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

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

LehtMis see on
TöölaudAvaleht: üherealine hinnang olukorrale, Smaily, Campaign Intelligence'i ja sirvimise jälgimise olek, saadetiste loendurid ja viimane tegevus.
AlgseadistusJuhendatud viiesammuline seadistus. Kuni see on lõpetamata, viib iga Smaily Connecti leht sind siia. Saad selle igal ajal uuesti läbida; sinu seaded säilivad.
SeadedKõik algseadistuse sisu vahekaartidena — Ühendus, Kontaktid, Automaatikad, Intelligence, RSS — ning ajaloolised impordid. Igal vahekaardil on oma salvestusnupp.
LogiIga saadetis Smailysse ja Campaign Intelligence'i, koos ebaõnnestunud ridade uuesti proovimisega. Kui miski tundub paigast ära, vaata kõigepealt siia.

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

If your store has several websitesKui poel on mitu veebisaiti

With more than one Magento website, the initial setup opens with Which website are you setting up? Pick the website and press Continue. Each website has its own Smaily connection, contact sync and automations; run the initial setup again for each website you want to connect. On Settings, a Website selector next to the tabs picks the website whose values you see and edit; picking a website that has not finished the initial setup opens that website's initial setup, and so does a link to Dashboard or Log for it. A store with one website never sees either.

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).

Kui sul on rohkem kui üks Magento veebisait, algab algseadistus küsimusega Millist veebisaiti seadistad? Vali veebisait ja vajuta Jätka. Igal veebisaidil on oma Smaily ühendus, kontaktide sünkroonimine ja automaatikad; läbi algseadistus uuesti iga veebisaidi jaoks, mida soovid ühendada. Lehel Seaded valib vahekaartide kõrval olev valik Veebisait, mille veebisaidi väärtusi näed ja muudad; veebisaidi valimine, mille algseadistus pole lõpetatud, avab selle veebisaidi algseadistuse, nagu ka selle veebisaidi link lehele Töölaud või Logi. Ühe veebisaidiga pood kumbagi ei näe.

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).

Step 1 — Connect your Smaily accountSamm 1 — Ühenda oma Smaily konto

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. Press Continue. The step is saved, even if Smaily did not accept the credentials; the last step then tells you so.

A finished setup reopens on this step as a summary marked Completed; Edit credentials brings the form back.

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. Vajuta Jätka. Samm salvestatakse ka siis, kui Smaily kasutajaandmeid vastu ei võtnud; viimane samm ütleb sulle siis selle.

Lõpetatud seadistus avaneb uuesti sellel sammul kokkuvõttena märkega Lõpetatud; Muuda kasutajaandmeid toob vormi tagasi.

Step 2 — ContactsSamm 2 — Kontaktid

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. Saving this step switches contact sync on — except for a website whose contact sync is off: there the step shows Sync contacts to Smaily unticked, and saving keeps sync off unless you tick it. Each option is explained under Settings › Contacts.

Another integration already syncs subscribers?

If another module or service already sends your newsletter subscribers or opt-outs to Smaily, switch it off once this step is saved — not before, so no opt-out is missed in between.

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. Selle sammu salvestamine lülitab kontaktide sünkroonimise sisse — välja arvatud veebisaidil, kus kontaktide sünkroonimine on väljas: seal näitab samm valikut Sünkrooni kontaktid Smailysse ilma linnukeseta ja salvestamine jätab sünkroonimise välja, kui sa linnukest ei pane. Iga valikut selgitab jaotis Seaded › Kontaktid.

Kas mõni teine lõiming juba sünkroonib tellijaid?

Kui mõni teine moodul või teenus saadab juba sinu uudiskirja tellijaid või loobumisi Smailysse, lülita see välja pärast selle sammu salvestamist — mitte varem, et vahepeal ükski loobumine kaduma ei läheks.

Step 3 — AutomationsSamm 3 — Automaatikad

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.

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.

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

Step 4 — Campaign Intelligence (optional)Samm 4 — Campaign Intelligence (valikuline)

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.

Separate storefront?

Connecting starts the catalog import at once. Set the Storefront URL on step 1 first, so the import sends your storefront's product links.

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.

Eraldi poe veebileht?

Ühendamine käivitab kohe kataloogi impordi. Sisesta Poe veebilehe aadress esmalt sammul 1, et import saadaks sinu poe veebilehe tootelingid.

Step 5 — OverviewSamm 5 — Ülevaade

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.


SettingsSeaded

Marketing > Smaily Connect > Settings holds everything from the initial setup as tabs. Each tab saves on its own, without a page reload; a tab can be opened directly, for example …/settings/?tab=rss. Turundus > Smaily Connect > Seaded sisaldab kõike algseadistusest vahekaartidena. Iga vahekaart salvestub eraldi, ilma lehte uuesti laadimata; vahekaardi saab avada ka otse, näiteks …/settings/?tab=rss.

ConnectionÜhendus

Your Smaily API credentials for this website: 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.
The subdomain

Only a plain Smaily subdomain is accepted, such as demo: letters, digits and hyphens. A pasted https://demo.sendsmaily.net is reduced to demo. Anything else is refused before anything is sent to Smaily.

Sinu Smaily API kasutajaandmed selle veebisaidi jaoks: 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.
Alamdomeen

Vastu võetakse ainult lihtne Smaily alamdomeen, näiteks demo: tähed, numbrid ja sidekriipsud. Kleebitud https://demo.sendsmaily.net taandatakse kujule demo. Kõik muu lükatakse tagasi enne, kui Smailysse midagi saadetakse.

Using a separate storefront?Kas pood töötab eraldi veebilehel?

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.

Multilingual storesMitmekeelsed poed

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.

CardMeaning
Single languageOne Smaily account and one workflow per automation. The default.
Per-language Smaily accountsEach language has its own Smaily account. The panel shows one account block per language, each with its own Test connection and status, plus a Default fallback account.
One account, per-language workflowsOne Smaily account; each language fires its own workflow. Most common.
One workflow branching by languageOne workflow that branches on the contact's language inside Smaily. The language field is sent with every contact.
  • 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, else the workflow at the top of the tab.
  • 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). Workflow mappings are kept but unused outside the per-language modes.
  • 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.

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.

KaartTähendus
Üks keelÜks Smaily konto ja üks töövoog automaatika kohta. Vaikimisi.
Keelepõhised Smaily kontodIgal keelel on oma Smaily konto. Paneel näitab iga keele jaoks oma kontoplokki, igaühel oma Testi ühendust ja olek, ning valikut Vaikimisi varukonto.
Üks konto, keelepõhised töövoodÜks Smaily konto; iga keel käivitab oma töövoo. Levinuim.
Üks töövoog, mis hargneb keele järgiÜks töövoog, mis hargneb Smaily sees kontakti keele järgi. Väli language saadetakse kaasa iga kontaktiga.
  • 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, ja kui ka seda pole, vahekaardi ülaosas olevat töövoogu.
  • 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). Töövoovastendused jäävad alles, kuid väljaspool keelepõhiseid režiime neid ei kasutata.
  • Poevaate keel muutus? Ava Seaded > Ühendus, kontrolli uue keele plokki ja salvesta; seni kasutab poevaade vana keele kontot.

ContactsKontaktid

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.

Contact sync mode

ModeWho is syncedUnsubscribes in Smaily come back?
Subscribers only (consent) — defaultOnly opted-in newsletter subscribers.Yes, every 15 minutes — and an unsubscribe in the store goes to Smaily.
All customers (legitimate interest)Every registered customer, as a soft opt-in: a customer new to Smaily becomes a subscriber; a contact Smaily already has keeps its status. A customer who unsubscribed in the store is sent as unsubscribed.No
Checkout opt-in onlyNobody automatically — only shoppers who tick the checkout newsletter checkbox. An unsubscribe in the store is sent.No
All customers is a legal choice

The EU soft opt-in lets you email existing customers only about products similar to what they bought; they must have had a clear way to refuse at purchase, and every email needs an unsubscribe link. You are responsible for the legal basis.

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

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) — Magento stops sending its own subscription-success and unsubscribe emails, so your Smaily automations handle them. 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.

Kontaktide sünkroonimise režiim

RežiimKeda sünkroonitakseKas Smaily loobumised tulevad tagasi?
Ainult turunduskirjade tellijad (nõusolekuga) — vaikimisiAinult nõusoleku andnud uudiskirja tellijad.Jah, iga 15 minuti järel — ja poes tehtud loobumine läheb Smailysse.
Kõik kliendid (õigustatud huvi)Iga registreeritud klient, pehme nõusolekuna: Smaily jaoks uus klient saab tellijaks; Smailys juba olev kontakt säilitab oma oleku. Poes loobunud klient saadetakse loobununa.Ei
Ainult kassas turunduskirjade nõusoleku andnud kontaktidKedagi ei sünkroonita automaatselt — ainult ostjad, kes märgivad kassas uudiskirja märkeruudu. Poes tehtud loobumine saadetakse.Ei
„Kõik kliendid“ on õiguslik valik

ELi pehme nõusolek lubab olemasolevatele klientidele saata kirju ainult nende ostetuga sarnaste toodete kohta; kliendil pidi ostu ajal olema selge võimalus keelduda ja igas kirjas peab olema loobumislink. Õigusliku aluse eest vastutad sina.

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

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) — Magento ei saada enam oma liitumise õnnestumise ja loobumise kirju, nii et nendega tegelevad sinu Smaily automaatikad. Magento palve liitumine kinnitada saadetakse alati.

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

AutomationsAutomaatikad

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.

EventFires when
WelcomeA shopper subscribes in your store: the newsletter form, the registration form, the newsletter page of their account, the checkout checkbox or the confirmation link. A shopper who unsubscribed and subscribes again gets it again. A subscription made in the admin, through the API or by an import syncs the contact but sends no welcome.
First orderA registered customer places their first order. A guest order does not fire it.
Abandoned cartA cart with an email address has been left idle — see Abandoned cart.
  • An automation reaches only a contact Smaily already has, and 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.
  • Campaign Intelligence's own automations are on this tab too, under the store events — see Campaign Intelligence automations.

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.

SündmusKäivitub, kui
TervitusOstja liitub sinu poes: uudiskirja vormi, registreerimisvormi, oma konto uudiskirja lehe, kassa märkeruudu või kinnituslingi kaudu. Loobunud ja uuesti liituv ostja saab selle uuesti. Halduses, API kaudu või impordiga tehtud liitumine sünkroonib kontakti, kuid tervitust ei saada.
Esimene tellimusRegistreeritud klient esitab oma esimese tellimuse. Külalistellimus seda ei käivita.
Hüljatud ostukorvE-posti aadressiga ostukorv on jäetud puutumata — vt Hüljatud ostukorv.
  • Automaatika jõuab ainult kontaktini, kes Smailys juba on, ega 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.
  • Campaign Intelligence'i enda automaatikad on samuti sellel vahekaardil, poe sündmuste all — vt Campaign Intelligence'i automaatikad.

Abandoned cartHüljatud ostukorv

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."
Avoid two reminders for one cart

Before you switch this automation on, switch off abandoned-cart emails sent by any other tool — for example Mageplaza SMTP, Avada Email Marketing, or Adobe Commerce's own email reminder rules.

Behind a proxy, Varnish or a load balancer?

Make sure Magento sees each shopper's own IP address (nginx real_ip, Apache mod_remoteip, or Magento's RemoteAddress alternativeHeaders setting). Otherwise the 30-in-10-minutes limit counts the whole store as one shopper.

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.“
Väldi kahte meeldetuletust ühe ostukorvi kohta

Enne selle automaatika sisselülitamist lülita välja hüljatud ostukorvi kirjad, mida saadab mõni teine tööriist — näiteks Mageplaza SMTP, Avada Email Marketing või Adobe Commerce'i enda e-posti meeldetuletuste reeglid.

Puhverserveri, Varnishi või koormusjaoturi taga?

Veendu, et Magento näeb iga ostja enda IP-aadressi (nginx real_ip, Apache mod_remoteip või Magento RemoteAddress seadistus alternativeHeaders). Muidu loeb piirang „30 10 minutiga“ kogu poodi üheks ostjaks.

IntelligenceIntelligence

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: your existing customer accounts go to Campaign Intelligence once, after the catalog import, so that it knows every customer by their customer account. 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. The Orders import does not start by itself — start it when Campaign Intelligence should learn your order history (see Importing existing data).

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.

Browse tracking needs a consent source

Without one the tracker sends nothing. The note under the switch says which source the store has; connect one as described in Connecting your cookie consent tool.

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: sinu olemasolevad kliendikontod saadetakse Campaign Intelligence'i üks kord, pärast kataloogi importi, et see tunneks iga klienti tema kliendikonto järgi. 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. Import Tellimused ise ei käivitu — käivita see, kui Campaign Intelligence peaks sinu tellimuste ajaloo teada saama (vt Olemasolevate andmete 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.

Sirvimise jälgimine vajab nõusoleku allikat

Ilma selleta ei saada jälgija midagi. Lüliti all olev märkus ütleb, milline allikas poel on; ühenda see nii, nagu kirjeldab jaotis Küpsiste nõusoleku tööriista ühendamine.

Recommendation attributionSoovituste omistamine

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.

Recommendations on your store's pagesSoovitused poe lehtedel

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.

Campaign Intelligence automationsCampaign Intelligence'i automaatikad

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 your Campaign Intelligence account is deactivatedKui sinu Campaign Intelligence'i konto on deaktiveeritud

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.

RSS feedRSS-voog

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.

ParameterValuesDefault
categoryCategory ID (see Catalog > Categories)all products
limit1–25050
sortcreated_at, updated_at, name, pricecreated_at
orderasc, descdesc

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.

ParameeterVäärtusedVaikimisi
categoryKategooria ID (vt Catalog > Categories)kõik tooted
limit1–25050
sortcreated_at, updated_at, name, pricecreated_at
orderasc, descdesc

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.


Email fieldsE-kirja väljad

The fields Smaily Connect writes onto your Smaily contacts, for templates, personalization and segments. Väljad, mille Smaily Connect sinu Smaily kontaktidele kirjutab — mallide, personaliseerimise ja segmentide jaoks.

Using the fieldsVäljade kasutamine

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. 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. Väljade nimed on samad mis Smaily WooCommerce'i ja Shopify laiendustes, nii et mallid ja segmendid sobivad poodide vahel.

Contact fieldsKontakti väljad

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.

FieldValue
emailThe contact's address, in lowercase.
is_unsubscribed0 or 1; left out under All customers for a customer who has not unsubscribed.
store, store_group, store_websiteThe names of the store view, store and website the contact came from.
languageThe store view's language code (et, en…). Contact syncs only.
first_name, last_name, prefixFirst name, Last name, Name prefix.
user_phonePhone — the default billing address's telephone.
user_genderGender — Male or Female.
birthdayDate of birth, YYYY-MM-DD.
customer_idCustomer ID in Magento.
customer_groupCustomer group code; Guest without an account.
subscription_typeSubscription type — always Subscriber.
smaily_rec_profiling, smaily_rec_profiling_tsThe shopper's personalization choice (1 allowed, 0 opted out) and when it was made. Only with Campaign Intelligence connected — see Personalization opt-out.

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.

VäliVäärtus
emailKontakti aadress, väiketähtedega.
is_unsubscribed0 või 1; režiimis Kõik kliendid jäetakse välja kliendil, kes pole loobunud.
store, store_group, store_websitePoevaate, poe ja veebisaidi nimed, kust kontakt tuli.
languagePoevaate keelekood (et, en…). Ainult kontaktide sünkroonimisel.
first_name, last_name, prefixEesnimi, Perekonnanimi, Nime eesliide.
user_phoneTelefon — vaikimisi arveaadressi telefoninumber.
user_genderSugu — Male või Female.
birthdaySünnikuupäev, YYYY-MM-DD.
customer_idKliendi ID Magentos.
customer_groupKliendigrupi kood; ilma kontota Guest.
subscription_typeTellimuse tüüp — alati Subscriber.
smaily_rec_profiling, smaily_rec_profiling_tsOstja personaliseerimise valik (1 lubatud, 0 loobunud) ja selle aeg. Ainult siis, kui Campaign Intelligence on ühendatud — vt Personaliseerimisest loobumine.

When an automation last ranAutomaatika viimane käivitus

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".

FieldWritten when
welcome_automation_atThe Welcome automation ran.
first_order_automation_atThe First order automation ran.
abandoned_cart_automation_atThe Abandoned cart automation ran.
abandoned_cart_purchased_atA shopper whose abandoned-cart reminder went out placed an order. Only for a contact Smaily already has; an ordinary purchase writes nothing. Use it as the exit condition of your abandoned-cart follow-ups (see Automations).

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“.

VäliKirjutatakse, kui
welcome_automation_atKäivitus automaatika Tervitus.
first_order_automation_atKäivitus automaatika Esimene tellimus.
abandoned_cart_automation_atKäivitus automaatika Hüljatud ostukorv.
abandoned_cart_purchased_atOstja, kellele saadeti hüljatud ostukorvi meeldetuletus, esitas tellimuse. Ainult kontaktile, kes Smailys juba on; tavaline ost ei kirjuta midagi. Kasuta seda hüljatud ostukorvi järelkirjade väljumistingimusena (vt Automaatikad).

First orderEsimene tellimus

FieldValue
order_idThe order number the customer sees (000000123).
order_totalThe order's grand total as a plain number, tax included.
order_currencyCurrency code (EUR).
is_first_orderAlways true.
first_name, last_name, storeThe customer's name on the order and the store view's name.
VäliVäärtus
order_idTellimuse number, mida klient näeb (000000123).
order_totalTellimuse kogusumma lihtsa arvuna, koos maksuga.
order_currencyValuutakood (EUR).
is_first_orderAlati true.
first_name, last_name, storeKliendi nimi tellimusel ja poevaate nimi.

Abandoned cartHüljatud ostukorv

FieldValue
abandoned_cart_urlThe recovery link that restores the exact cart; valid for 30 days.
is_abandoned_cartAlways true.
first_name, last_nameThe shopper's name, when known.
store, store_url, store_group, store_websiteThe store view's name and address, the store's and the website's names.
product_name_N, product_sku_N, product_quantity_NOne set per cart product, N = 1…10.
product_price_NThe price in the cart, tax included, as a plain number (24.90).
product_base_price_NThe product's regular price, as a plain number.
product_description_N, product_image_url_NThe short description (as plain text) and an image link.
over_10_productstrue when the cart holds more than 10 products, otherwise empty.

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.

VäliVäärtus
abandoned_cart_urlTaastamislink, mis taastab täpselt sama ostukorvi; kehtib 30 päeva.
is_abandoned_cartAlati true.
first_name, last_nameOstja nimi, kui see on teada.
store, store_url, store_group, store_websitePoevaate nimi ja aadress, poe ja veebisaidi nimed.
product_name_N, product_sku_N, product_quantity_NÜks komplekt ostukorvi toote kohta, N = 1…10.
product_price_NHind ostukorvis, koos maksuga, lihtsa arvuna (24.90).
product_base_price_NToote tavahind, lihtsa arvuna.
product_description_N, product_image_url_NLühikirjeldus (lihttekstina) ja pildi link.
over_10_productstrue, kui ostukorvis on üle 10 toote, muidu tühi.

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.

RecommendationsSoovitused

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.


Importing existing dataOlemasolevate andmete import

The live sync sends changes from now on. The imports send what you already have — in the background, a chunk per cron minute, without slowing the store down. Jooksev sünkroonimine saadab muudatused alates nüüdsest. Impordid saadavad selle, mis sul juba on — taustal, üks osa iga cron-minuti kohta, poodi aeglustamata.

What gets importedMida imporditakse

ImportWhereWhat it sends
Initial contact import → SmailySettings > Contacts, per websiteThe contacts the website's sync mode covers. Subscribers only: newsletter subscribers, subscribed and unsubscribed. All customers: those subscribers, then every other registered customer. Checkout opt-in only: nobody (it finishes at 0). Guest-order emails are not imported.
Catalog → Campaign IntelligenceSettings > IntelligenceEvery product of every website. Starts by itself when you connect.
Customers → Campaign IntelligenceSettings > IntelligenceRegistered customers. Starts by itself when you connect, after the catalog import.
Orders → Campaign IntelligenceSettings > IntelligenceOrder history, with refunds.
  • The contact import follows Sync contacts to Smaily: with sync off, its button is disabled. 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.
ImportKusMida see saadab
Esmane kontaktide import → SmailySeaded > Kontaktid, veebisaidi kaupaKontaktid, mida veebisaidi sünkroonimisrežiim hõlmab. Ainult turunduskirjade tellijad: uudiskirja tellijad, nii tellinud kui ka loobunud. Kõik kliendid: need tellijad ja seejärel kõik teised registreeritud kliendid. Ainult kassas nõusoleku andnud: mitte keegi (lõpeb 0-ga). Külalistellimuste e-posti aadresse ei impordita.
Kataloog → Campaign IntelligenceSeaded > IntelligenceIga veebisaidi kõik tooted. Käivitub ühendamisel ise.
Kliendid → Campaign IntelligenceSeaded > IntelligenceRegistreeritud kliendid. Käivitub ühendamisel ise, pärast kataloogi importi.
Tellimused → Campaign IntelligenceSeaded > IntelligenceTellimuste ajalugu koos tagasimaksetega.
  • Kontaktide import järgib lülitit Sünkrooni kontaktid Smailysse: kui sünkroonimine on väljas, on selle nupp keelatud. 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.

Reading the progressEdenemise lugemine

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.

StatusMeaning
PendingQueued for the next cron run.
RunningSending, a chunk per minute.
Done"Done, X of Y synced." — or "… — N failed.", with a link to those rows in the Log. Rows still waiting for an automatic retry do not count as failed.
Stopped"Stopped before an error" — the import hit an error and stopped cleanly; nothing was lost. Press Run again.
StalledNothing has moved it for over an hour — see Stalled imports.
CanceledStopped on your request. Starting again begins a fresh import.

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.

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.

OlekTähendus
OotelJärjekorras järgmise cron-käivituse jaoks.
TöötabSaadab, üks osa minutis.
Valmis„Valmis, X / Y sünkroonitud.“ — või „… — N ebaõnnestus.“, koos lingiga nendele ridadele logis. Read, mis ootavad veel automaatset kordust, ei loe ebaõnnestunuks.
Peatunud„Peatus enne viga“ — import sai vea ja peatus korrektselt; midagi ei läinud kaduma. Vajuta Käivita uuesti.
SeiskunudSeda pole üle tunni edasi viidud — vt Seiskunud impordid.
KatkestatudPeatatud sinu soovil. Uuesti alustamine käivitab värske impordi.

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

Stalled importsSeiskunud impordid

SymptomCauseFix
"Stalled — nothing has moved this import for over an hour; X of Y synced so far."Cron does not run, or the import fails on the same products every time.Check that Magento's cron runs every minute, then press Run again (it cancels the stalled import and starts fresh). If it stalls again, look in var/log/smaily_connect.log and Magento's own logs.
"Stalled — this import waits behind another import … Settings > …"The import at the front of the line never got going.Open the card the message names and press Cancel import or Run again there; this one follows.
Stays PendingCron is not running.Set up Magento's cron (see INSTALLING.md › Cron).

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.

SümptomPõhjusLahendus
„Seiskunud — seda importi pole üle tunni edasi viidud; seni sünkroonitud X / Y.“Cron ei tööta või import ebaõnnestub iga kord samadel toodetel.Kontrolli, et Magento cron käivitub iga minut, ja vajuta Käivita uuesti (see katkestab seiskunud impordi ja alustab värskelt). Kui see seiskub uuesti, vaata faili var/log/smaily_connect.log ja Magento enda logisid.
„Seiskunud — see import ootab teise impordi taga … Seaded > …“Järjekorra eesotsas olev import ei hakanud kunagi tööle.Ava teates nimetatud kaart ja vajuta seal Katkesta import või Käivita uuesti; see import järgneb.
Jääb olekusse OotelCron ei tööta.Seadista Magento cron (vt INSTALLING.md › Cron).

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.

The nightly product checkÖine tootekontroll

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.


Store typesPoe tüübid

Everything Smaily Connect does on the server works with any storefront. A few parts run in the shopper's browser — those depend on your theme and checkout. Kõik, mida Smaily Connect serveris teeb, töötab iga poe veebilehega. Mõned osad töötavad ostja brauseris — need sõltuvad sinu teemast ja kassast.

Luma-based themesLuma-põhised teemad

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.

HyväHyvä

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-rc11 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-rc11 smaily/module-connect-hyva:3.0.0-rc11
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-rc11; 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-rc11 smaily/module-connect-hyva:3.0.0-rc11
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.

A separate (headless) storefrontEraldi (headless) poe veebileht

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).

One-step checkoutsÜheleheküljelised kassad

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.


The Log, error messages & fixesLogi, veateated & lahendused

Almost everything can be diagnosed from Marketing > Smaily Connect > Log. Here is how to read it, and what each message means. Peaaegu kõike saab diagnoosida menüüs Turundus > Smaily Connect > Logi. Siin on, kuidas seda lugeda ja mida iga teade tähendab.

Reading the LogLogi lugemine

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.

StatusMeaning
PendingWaiting for the next cron run, or for an automatic retry.
SendingBeing sent right now.
SentDelivered.
FailedRefused, or every automatic attempt used up. See Failed rows & retry.
WithdrawnA reminder the store called back because the shopper bought in the meantime. Nothing was sent; nothing failed.
SkippedClosed without sending, because sending could not have done what it was for. Details says why — see Skipped & Withdrawn rows.

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.

The log file

The extension also writes errors to var/log/smaily_connect.log on the server. For troubleshooting, a developer can raise the detail with bin/magento config:set smaily_connect/logging/verbosity debug (or info) and must set it back with … verbosity error afterwards: the detailed levels write more about your contacts (with email addresses masked) to the file.

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.

OlekTähendus
OotelOotab järgmist cron-käivitust või automaatset kordust.
SaatmiselSaadetakse just praegu.
SaadetudKohale toimetatud.
EbaõnnestunudTagasi lükatud või kõik automaatsed katsed on ära kasutatud. Vt Ebaõnnestunud read & kordus.
Tagasi võetudMeeldetuletus, mille pood tagasi võttis, sest ostja vahepeal ostis. Midagi ei saadetud; midagi ei ebaõnnestunud.
Vahele jäetudSuletud ilma saatmata, sest saatmine poleks oma eesmärki täitnud. Üksikasjad ütleb põhjuse — vt Vahele jäetud & tagasi võetud read.

Ü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.

Logifail

Laiendus kirjutab vead ka serveris faili var/log/smaily_connect.log. Tõrkeotsinguks saab arendaja detailsust tõsta käsuga bin/magento config:set smaily_connect/logging/verbosity debug (või info) ja peab selle pärast tagasi seadma käsuga … verbosity error: detailsemad tasemed kirjutavad faili rohkem sinu kontaktide kohta (e-posti aadressid maskeeritult).

Smaily errorsSmaily vead

You seeCauseFix
"Smaily rejected these credentials. Check the subdomain, username and password." · in the Log: "Smaily API credentials were rejected"Smaily refused the subdomain, username or password (HTTP 401/403) — for example the API user was removed.Correct them under Settings > Connection and press Test connection. Then select the failed rows in the Log and Retry.
"Smaily refused the request because this account's package does not include API access. …" · Dashboard: "Package does not include API access"Smaily response code 227: the account's package has no API. The credentials cannot be checked at all.Upgrade the package in Smaily, then press Test connection. Waiting does not help.
"The configuration was saved, but Smaily rejected the API credentials. …"The save went through with credentials Smaily does not accept.Correct them and test again; nothing syncs until then.
"Please fill in the subdomain, username and password." · "Subdomain and username are required."A field is empty.Fill it in.
"The subdomain must be a plain Smaily subdomain such as "demo": letters, digits and hyphens only."The subdomain is not a plain one.Enter just the part before .sendsmaily.net.
"The subdomain or username changed — enter the password of this account."A saved password belongs to the old account.Enter the new account's password.
"Smaily API returned code 203: …"Smaily answered "invalid data", for example an address it does not accept. For a group of contacts the extension sends them again one at a time, so only the refused contact fails.Read the answer in Details, fix the data in Magento, then Send again.
"Smaily API request failed with HTTP 4xx: …"Smaily refused the request, for example because the workflow was deleted. It is not retried.Fix what Smaily's answer names (re-pick the workflow under Settings > Automations), then retry.
"Smaily API request failed: …" · "Could not reach Smaily: …" · "Smaily API request failed with HTTP 5xx …"A network problem, or Smaily was briefly unavailable.Nothing — the row is retried on its own. If it keeps failing, check that the server can reach Smaily over HTTPS.
"Smaily API credentials are not configured (store scope: …)"The store view has no Smaily account saved.Complete Settings > Connection for its website (or its language).
"Could not load the workflow list: …" · "A workflow is required when this trigger is enabled."The connection does not work, or no workflow was picked.Test the connection; pick a workflow or untick Enabled.
NäedPõhjusLahendus
„Smaily lükkas need kasutajaandmed tagasi. Kontrolli alamdomeeni, kasutajanime ja parooli.“ · logis: „Smaily lükkas API kasutajaandmed tagasi“Smaily keeldus alamdomeenist, kasutajanimest või paroolist (HTTP 401/403) — näiteks API kasutaja eemaldati.Paranda need jaotises Seaded > Ühendus ja vajuta Testi ühendust. Seejärel vali logis ebaõnnestunud read ja vajuta Proovi uuesti.
„Smaily keeldus päringust, sest selle konto pakett ei sisalda API-ligipääsu. …“ · töölaual: „Pakett ei sisalda API-ligipääsu“Smaily vastuskood 227: konto paketis pole API-t. Kasutajaandmeid ei saa üldse kontrollida.Uuenda Smailys paketti ja vajuta siis Testi ühendust. Ootamine ei aita.
„Seadistus salvestati, kuid Smaily lükkas API kasutajaandmed tagasi. …“Salvestamine õnnestus kasutajaandmetega, mida Smaily vastu ei võta.Paranda need ja testi uuesti; seni ei sünkroonita midagi.
„Palun täida alamdomeen, kasutajanimi ja parool.“ · „Alamdomeen ja kasutajanimi on kohustuslikud.“Mõni väli on tühi.Täida see.
„Alamdomeen peab olema lihtne Smaily alamdomeen, näiteks „demo“: ainult tähed, numbrid ja sidekriipsud.“Alamdomeen pole lihtne alamdomeen.Sisesta ainult osa enne .sendsmaily.net.
„Alamdomeen või kasutajanimi muutus — sisesta selle konto parool.“Salvestatud parool kuulub vanale kontole.Sisesta uue konto parool.
„Smaily API tagastas koodi 203: …“Smaily vastas „vigased andmed“, näiteks aadress, mida ta vastu ei võta. Kontaktide grupi puhul saadab laiendus need uuesti ükshaaval, nii et ebaõnnestub ainult tagasi lükatud kontakt.Loe vastust jaotisest Üksikasjad, paranda andmed Magentos ja vajuta Saada uuesti.
„Smaily API päring ebaõnnestus (HTTP 4xx): …“Smaily keeldus päringust, näiteks seetõttu, et töövoog kustutati. Seda uuesti ei proovita.Paranda see, mida Smaily vastus nimetab (vali töövoog uuesti jaotises Seaded > Automaatikad), ja proovi uuesti.
„Smaily API päring ebaõnnestus: …“ · „Smailyga ei saadud ühendust: …“ · „Smaily API päring ebaõnnestus (HTTP 5xx) …“Võrguprobleem või Smaily oli korraks kättesaamatu.Midagi — rida proovitakse ise uuesti. Kui see jääb ebaõnnestuma, kontrolli, et server jõuab Smailyni HTTPS-i kaudu.
„Smaily API kasutajaandmed on seadistamata (poe skoop: …)“Poevaatel pole salvestatud Smaily kontot.Täida Seaded > Ühendus selle veebisaidi (või keele) jaoks.
„Töövoogude loendi laadimine ebaõnnestus: …“ · „Töövoog on kohustuslik, kui see päästik on lubatud.“Ühendus ei tööta või töövoogu pole valitud.Testi ühendust; vali töövoog või eemalda märge Lubatud.

Campaign Intelligence errorsCampaign Intelligence'i vead

You seeCauseFix
"Could not connect to Campaign Intelligence: … HTTP 410: This setup token has expired or has already been used. …"Setup links are one-time.Ask Smaily for a new setup link.
"Could not connect to Campaign Intelligence: … HTTP 404: Setup token not found. …"The link was cut or mistyped.Copy the whole link again.
"The setup URL must be an https address on intelligence.smaily.com." · "Paste the setup URL or token from Smaily first."The link points elsewhere, or the field is empty. Nothing was sent.Paste the link exactly as Smaily gave it.
"The engine answered with an address that is not an https address on intelligence.smaily.com, so the connection was not saved."An unexpected answer from the engine.Contact Smaily.
In the Log: "Engine request failed with HTTP 401: …"The stored API key was revoked or replaced.Run bin/magento smaily:engine:disconnect --force, then connect again with a new setup link.
"Engine request failed with HTTP 403: This tenant is currently deactivated. …" · banner and notification: "Your Campaign Intelligence account is not active"; Dashboard: "Not active"Smaily suspended or closed the account.See A deactivated account.
"Engine request failed with HTTP 400: …" (or 422)Campaign Intelligence refused this row's data. It is not retried.Read its answer in Details, fix the product, customer or order in Magento, and save it again (or Send again).
"Engine request failed: …" · "… HTTP 5xx after retries" · Dashboard: "Connected, currently unreachable"The engine is briefly unreachable.Nothing — data waits in the queue and goes out when it recovers. An admin notification appears after an hour.
"Campaign Intelligence is not connected, so there is nowhere to send the catalog."An import was started without a connection.Connect first.
A failed catalog_manifest row: "Not sent: the store has more than 50,000 enabled products, …"The nightly product check's limit.Nothing to do; the regular catalog sync still runs.
NäedPõhjusLahendus
„Campaign Intelligence'iga ei õnnestunud ühendust luua: … HTTP 410: This setup token has expired or has already been used. …“Seadistuslingid on ühekordsed.Küsi Smailylt uus seadistuslink.
„Campaign Intelligence'iga ei õnnestunud ühendust luua: … HTTP 404: Setup token not found. …“Link on poolik või valesti sisestatud.Kopeeri kogu link uuesti.
„Seadistus-URL peab olema https-aadress domeenil intelligence.smaily.com.“ · „Kleebi esmalt Smailylt saadud seadistus-URL või -võti.“Link viib mujale või väli on tühi. Midagi ei saadetud.Kleebi link täpselt nii, nagu Smaily selle andis.
„Mootor vastas aadressiga, mis ei ole https-aadress domeenil intelligence.smaily.com, seega ühendust ei salvestatud.“Mootori ootamatu vastus.Võta ühendust Smailyga.
Logis: „Mootori päring ebaõnnestus (HTTP 401): …“Salvestatud API võti tühistati või vahetati.Käivita bin/magento smaily:engine:disconnect --force ja ühenda uuesti uue seadistuslingiga.
„Mootori päring ebaõnnestus (HTTP 403): This tenant is currently deactivated. …“ · riba ja teade: „Sinu Campaign Intelligence'i konto ei ole aktiivne“; töölaual: „Ei ole aktiivne“Smaily peatas või sulges konto.Vt Deaktiveeritud konto.
„Mootori päring ebaõnnestus (HTTP 400): …“ (või 422)Campaign Intelligence lükkas selle rea andmed tagasi. Seda uuesti ei proovita.Loe vastust jaotisest Üksikasjad, paranda toode, klient või tellimus Magentos ja salvesta uuesti (või vajuta Saada uuesti).
„Mootori päring ebaõnnestus: …“ · „… (HTTP 5xx) ka pärast korduskatseid“ · töölaual: „Ühendatud, hetkel kättesaamatu“Mootor on korraks kättesaamatu.Midagi — andmed ootavad järjekorras ja saadetakse, kui ühendus taastub. Tunni pärast ilmub halduse teade.
„Campaign Intelligence ei ole ühendatud, seega pole kataloogi kuhugi saata.“Import käivitati ilma ühenduseta.Ühenda kõigepealt.
Ebaõnnestunud rida catalog_manifest: „Ei saadetud: poes on üle 50 000 lubatud toote, …“Öise tootekontrolli piirang.Midagi pole vaja teha; tavaline kataloogi sünkroonimine töötab edasi.

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

Skipped and Withdrawn rowsVahele jäetud ja tagasi võetud read

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

Reason in DetailsWhat to do
"Skipped: no Smaily workflow is mapped to this automation trigger."Pick a workflow under Settings > Automations (or for that language).
"Skipped: this address already got an abandoned-cart reminder for another cart in the last 24 hours."Nothing — the one-reminder-a-day rule.
"Skipped: Smaily does not have this contact, and the purchase marker would create it as a subscriber."Nothing — the purchase marker never creates a contact.
"Skipped: the shopper has since changed their personalization preference, …"Nothing — the newer choice goes on its own row.
"Skipped: the shopper opted out of personalized recommendations, so their browsing is not linked to their address."Nothing — this respects the opt-out.
Withdrawn: the reminder was withdrawn because the shopper completed the purchaseNothing — the shopper bought before the reminder went out.

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

Põhjus üksikasjadesMida teha
„Vahele jäetud: selle automaatika päästikuga pole seotud ühtegi Smaily töövoogu.“Vali töövoog jaotises Seaded > Automaatikad (või selle keele jaoks).
„Vahele jäetud: sellele aadressile saadeti viimase 24 tunni jooksul juba teise ostukorvi meeldetuletus.“Midagi — üks meeldetuletus päevas.
„Vahele jäetud: Smailys ei ole seda kontakti ja ostu märge looks selle tellijana.“Midagi — ostu märge ei loo kunagi kontakti.
„Vahele jäetud: ostja on vahepeal oma personaliseerimise eelistust muutnud, …“Midagi — uuem valik saadetakse eraldi real.
„Vahele jäetud: ostja loobus personaalsetest soovitustest, seega tema sirvimist ei seota tema e-posti aadressiga.“Midagi — nii austatakse loobumist.
Tagasi võetud: meeldetuletus võeti tagasi, sest ostja viis ostu lõpuleMidagi — ostja ostis enne, kui meeldetuletus teele läks.

Failed rows and retryEbaõnnestunud read ja kordus

  • 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.

Dashboard verdicts and admin notificationsTöölaua hinnangud ja halduse teated

You seeMeaningDo
All systems normalDeliveries flow normally.Nothing.
Setup incompleteThe initial setup is not finished.Resume setup.
Not connectedThe Smaily credentials are missing or Smaily has not accepted them (or the package has no API).Open Connection settings and press Test connection.
Needs attention — deliveries failed in the last 24 hoursFailed rows in the Log.Review failures.
Needs attention — Campaign Intelligence unreachableData waits in the queue.Nothing; it syncs when the engine recovers.
Needs attention — Campaign Intelligence stopped accepting dataThe account is deactivated.See A deactivated account.
Needs attention — no nightly product list for N nightsThe banner says why the last night's list did not go out.See The nightly product check.
Notification: "Smaily Connect: N events failed in the last 24 hours"25 or more failures in a day.Open the Log, fix the cause, retry.
Notification: "Smaily Campaign Intelligence is unreachable"No answer for over an hour.Usually nothing; contact Smaily if it lasts.
Notification: "Smaily Connect: browse tracking collects nothing until a consent source is connected"Browse tracking is on, but cookie restriction mode is off.See Connecting your cookie consent tool.
Notification: "Smaily Connect was upgraded to version …"A major upgrade; nothing was changed.Review the settings.
Notification: "Smaily Connect upgrade: store-view Smaily account not carried over"The upgrade from 2.8.x left out a Smaily account saved for the store views named; 2.8.x did not use it.Nothing; those store views use their website's Smaily account, as in 2.8.x.
Notification: "Smaily Connect upgrade: the welcome automation has no workflow"On the websites named, 2.8.x had Enable Subscribers Collection on with no Autoresponder ID, so it sent no welcome email. The welcome automation stays off there.To send one, tick Enabled for Welcome and pick a Smaily Workflow on the Automations step — see Upgrading from 2.8.x.
Notification: "Smaily Connect upgrade: the abandoned-cart automation has no workflow"On the websites named, 2.8.x had Enable Abandoned Cart on with no Autoresponder ID, so it sent no reminder. The abandoned-cart automation stays off there.To send one, tick Enabled for Abandoned cart and pick a Smaily Workflow on the Automations step — see Upgrading from 2.8.x.
NäedTähendusTee
Kõik toimib normaalseltSaadetised liiguvad tavapäraselt.Midagi.
Seadistus on pooleliAlgseadistus pole lõpetatud.Jätka seadistamist.
Pole ühendatudSmaily kasutajaandmed puuduvad või Smaily pole neid vastu võtnud (või paketis pole API-t).Ava ühenduse seaded ja vajuta Testi ühendust.
Vajab tähelepanu — viimase 24 tunni jooksul ebaõnnestus saadetisiLogis on ebaõnnestunud ridu.Vaata ebaõnnestumised üle.
Vajab tähelepanu — Campaign Intelligence on kättesaamatuAndmed ootavad järjekorras.Midagi; need sünkroonitakse, kui mootor taastub.
Vajab tähelepanu — Campaign Intelligence ei võta enam andmeid vastuKonto on deaktiveeritud.Vt Deaktiveeritud konto.
Vajab tähelepanu — öist tootenimekirja pole N ööd saadetudRiba ütleb, miks eelmise öö nimekiri teele ei läinud.Vt Öine tootekontroll.
Teade: „Smaily Connect: viimase 24 tunni jooksul ebaõnnestus N sündmust“Ööpäevas 25 või rohkem ebaõnnestumist.Ava logi, kõrvalda põhjus, proovi uuesti.
Teade: „Smaily Campaign Intelligence pole kättesaadav“Üle tunni pole vastust.Tavaliselt midagi; kui see kestab, võta ühendust Smailyga.
Teade: „Smaily Connect: sirvimise jälgimine ei kogu midagi enne, kui nõusoleku allikas on ühendatud“Sirvimise jälgimine on sees, kuid küpsiste piirangurežiim on väljas.Vt Küpsiste nõusoleku tööriista ühendamine.
Teade: „Smaily Connect uuendati versioonile …“Suur versiooniuuendus; midagi ei muudetud.Vaata seadistused üle.
Teade: „Smaily Connecti uuendus: poevaate Smaily kontot üle ei toodud“Uuendus versioonilt 2.8.x jättis nimetatud poevaadetele salvestatud Smaily konto üle toomata; 2.8.x seda ei kasutanud.Midagi; need poevaated kasutavad oma veebisaidi Smaily kontot, nagu 2.8.x-is.
Teade: „Smaily Connecti uuendus: tervitusautomaatikal pole töövoogu“Nimetatud veebisaitidel oli 2.8.x-is Enable Subscribers Collection sees, kuid Autoresponder ID puudus, seega tervituskirja ei saadetud. Tervitusautomaatika jääb seal välja.Tervituskirja saatmiseks märgi sammul Automaatikad sündmuse Tervitus juures Lubatud ja vali Smaily töövoog — vt Uuendamine versioonilt 2.8.x.
Teade: „Smaily Connecti uuendus: hüljatud ostukorvi automaatikal pole töövoogu“Nimetatud veebisaitidel oli 2.8.x-is Enable Abandoned Cart sees, kuid Autoresponder ID puudus, seega meeldetuletust ei saadetud. Hüljatud ostukorvi automaatika jääb seal välja.Meeldetuletuse saatmiseks märgi sammul Automaatikad sündmuse Hüljatud ostukorv juures Lubatud ja vali Smaily töövoog — vt Uuendamine versioonilt 2.8.x.

FAQ & troubleshootingKKK & tõrkeotsing

Nothing is syncingMidagi ei sünkroonita

  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. 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. 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.

A contact unsubscribed in Smaily but is still subscribed in MagentoKontakt loobus Smailys, kuid on Magentos ikka tellija

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 abandoned-cart email never arrivesHüljatud ostukorvi kiri ei jõua kohale

  • 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).
  • Smaily already has the address as a contact who has not unsubscribed — an automation never creates or re-subscribes a contact.
  • 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).
  • Smailys on aadress juba kontaktina, kes pole loobunud — automaatika ei loo kunagi kontakti ega telli seda uuesti.

The checkout newsletter checkbox does not showKassa uudiskirja märkeruutu pole näha

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.

Is it safe to run an import again?Kas importi on ohutu uuesti käivitada?

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.

How often does data sync?Kui tihti andmed sünkroonitakse?

WhatWhen
Contact syncs, automations, catalog, customer and order changesQueued as they happen, sent every minute
Unsubscribes from Smaily back to Magento (Subscribers only)Every 15 minutes
Abandoned-cart scanEvery 5 minutes
ImportsOne chunk per minute
Campaign Intelligence health checkEvery 15 minutes
Nightly product check03:30, store time
Log clean-upNightly

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

MisMillal
Kontaktide sünkroonimised, automaatikad, kataloogi-, kliendi- ja tellimusmuudatusedPannakse järjekorda kohe, saadetakse iga minut
Loobumised Smailyst tagasi Magentosse (Ainult turunduskirjade tellijad)Iga 15 minuti järel
Hüljatud ostukorvide otsingIga 5 minuti järel
ImpordidÜks osa minutis
Campaign Intelligence'i seisukorra kontrollIga 15 minuti järel
Öine tootekontroll03:30, poe aja järgi
Logi puhastusIgal ööl

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

How do I disconnect Campaign Intelligence?Kuidas Campaign Intelligence'i lahti ühendada?

From the command line: bin/magento smaily:engine:disconnect --force. It removes the store's connection; data already in Campaign Intelligence stays there, and the API key stays valid on the engine until Smaily revokes it. Connecting again needs a new setup link from Smaily. To stop Smaily syncing for a website, switch off Sync contacts to Smaily and the automations.

Käsurealt: bin/magento smaily:engine:disconnect --force. See eemaldab poe ühenduse; Campaign Intelligence'is juba olevad andmed jäävad sinna ja API võti kehtib mootoris, kuni Smaily selle tühistab. Uuesti ühendamiseks on vaja Smailylt uut seadistuslinki. Veebisaidi Smaily sünkroonimise peatamiseks lülita välja Sünkrooni kontaktid Smailysse ja automaatikad.

Does disabling or removing the extension delete my data?Kas laienduse keelamine või eemaldamine kustutab andmed?

  • 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.

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.

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

Which languages does the extension speak?Mis keeli laiendus räägib?

English and Estonian. The admin pages follow your admin user's interface locale and the storefront texts follow the store view's locale (et_EE for Estonian). Other languages can be added as Magento translation packs.

Inglise ja eesti keelt. Halduse lehed järgivad sinu halduse kasutaja liidese lokaati ja poe tekstid poevaate lokaati (eesti keele jaoks et_EE). Teisi keeli saab lisada Magento tõlkepakettidena.


Data & privacyAndmed & privaatsus

What data goes whereMis andmed kuhu lähevad

Goes toDataWhen
SmailyEmail, subscription status, store names, language and the extra fields you tick.With contact sync on, for the contacts your sync mode covers.
SmailyAutomation fields: the first order's number and total; the abandoned cart's products and recovery link; the automation dates.When an automation you enabled runs.
Campaign IntelligenceProducts (no personal data).When connected.
Campaign IntelligenceCustomers: email, name, country, phone, language, customer ID, account creation date.When connected.
Campaign IntelligenceOrders: order number, the buyer's email, date, total, currency, status, items (SKU, quantity, price) and returned items; plus the recommendation-click data of attribution.When connected.
Campaign IntelligenceBrowse events: product views, searches, cart activity, checkout, under an anonymous session id — linked to the customer's account after login, unless they opted out of personalization.Only with browse tracking on and the visitor's marketing consent.

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.

KuhuAndmedMillal
SmailyE-post, tellimuse olek, poe nimed, keel ja sinu märgitud lisaväljad.Kui kontaktide sünkroonimine on sees, sinu sünkroonimisrežiimi hõlmatud kontaktide kohta.
SmailyAutomaatikate väljad: esimese tellimuse number ja summa; hüljatud ostukorvi tooted ja taastamislink; automaatikate kuupäevad.Kui sinu lubatud automaatika käivitub.
Campaign IntelligenceTooted (isikuandmeid pole).Kui ühendatud.
Campaign IntelligenceKliendid: e-post, nimi, riik, telefon, keel, kliendi ID, konto loomise kuupäev.Kui ühendatud.
Campaign IntelligenceTellimused: tellimuse number, ostja e-post, kuupäev, summa, valuuta, olek, tooted (SKU, kogus, hind) ja tagastatud tooted; lisaks omistamise soovituskliki andmed.Kui ühendatud.
Campaign IntelligenceSirvimissündmused: tootevaatamised, otsingud, ostukorvitegevus, kassa, anonüümse seansitunnuse all — pärast sisselogimist seotud kliendi kontoga, kui ta pole personaliseerimisest loobunud.Ainult siis, kui sirvimise jälgimine on sees ja külastaja on andnud turundusnõusoleku.

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.

CookiesKüpsised

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

CookieHoldsKeptSet
smaily_rec_idThe recommendation the shopper clicked last30 daysOn arrival from a recommendation link
smaily_rec_ctxWhere that recommendation was shown30 daysOn arrival from a recommendation link
smaily_rec_uidA pseudonymous visitor token from the email link365 daysOn arrival from a recommendation link
smaily_anon_sidAn anonymous browsing-session id30 daysOnly with browse tracking on and marketing consent

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.

KüpsisSisuSäilibSeatakse
smaily_rec_idSoovitus, millel ostja viimati klõpsas30 päevaSoovituslingilt saabumisel
smaily_rec_ctxKus see soovitus näidati30 päevaSoovituslingilt saabumisel
smaily_rec_uidE-kirja lingist saadud pseudonüümne külastajatunnus365 päevaSoovituslingilt saabumisel
smaily_anon_sidAnonüümne sirvimisseansi tunnus30 päevaAinult sisse lülitatud sirvimise jälgimise ja turundusnõusoleku korral

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.

Personalization opt-outPersonaliseerimisest loobumine

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, or in Smaily and mirrored back — also turns personalization off; subscribing again turns it back on, unless the shopper opted out separately.
  • 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 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.
  • 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.

Export and erasure (GDPR)Eksport ja kustutamine (GDPR)

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;
  • erases the shopper in Campaign Intelligence.

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;
  • kustutab ostja Campaign Intelligence'ist.

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).

Privacy-policy text for your storePrivaatsuspoliitika tekst sinu poele

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].

Adapt before you publish

Replace the bracketed parts, drop the sentences about features you do not use, and add how long your data is kept — ask Smaily for the retention periods of the Campaign Intelligence service. Have your legal counsel review the final text.

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].

Kohanda enne avaldamist

Asenda nurksulgudes osad, jäta välja laused funktsioonide kohta, mida ei kasuta, ja lisa, kui kaua andmeid hoitakse — küsi Campaign Intelligence'i teenuse säilitustähtaegu Smailylt. Lase lõplik tekst oma juristil üle vaadata.

SecurityTurvalisus

  • 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.


AppendixLisa

Command-line referenceKäsurea käsud

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

CommandWhat it does
bin/magento smaily:backfill:start [contacts|catalog|customers|orders] [--website=ID]Starts an import (default contacts; without --website, for every website). For a website whose Sync contacts to Smaily is off it still starts the contacts import, and says that the import sends nothing.
bin/magento smaily:backfill:statusShows the imports and their progress.
bin/magento smaily:engine:pingChecks the Campaign Intelligence connection.
bin/magento smaily:engine:disconnect --forceRemoves the store's Campaign Intelligence connection.
bin/magento smaily:gdpr export <email>Exports a shopper's data (Campaign Intelligence and the extension's tables) as JSON.
bin/magento smaily:gdpr erase <email> --forceErases a shopper's data — see Export and erasure.
bin/magento cron:run --group smaily_connectRuns the extension's cron jobs once (to check that they work).
bin/magento config:set smaily_connect/logging/verbosity error|info|debugSets the log file's detail; keep it at error outside troubleshooting.

Käivita Magento juurkaustas, Magento failide omaniku kasutajana.

KäskMida see teeb
bin/magento smaily:backfill:start [contacts|catalog|customers|orders] [--website=ID]Käivitab impordi (vaikimisi contacts; ilma --website-ta kõigi veebisaitide jaoks). Veebisaidil, kus Sünkrooni kontaktid Smailysse on väljas, käivitab ta kontaktide impordi ikkagi ja ütleb, et import ei saada midagi.
bin/magento smaily:backfill:statusNäitab importe ja nende edenemist.
bin/magento smaily:engine:pingKontrollib Campaign Intelligence'i ühendust.
bin/magento smaily:engine:disconnect --forceEemaldab poe Campaign Intelligence'i ühenduse.
bin/magento smaily:gdpr export <email>Ekspordib ostja andmed (Campaign Intelligence ja laienduse tabelid) JSON-ina.
bin/magento smaily:gdpr erase <email> --forceKustutab ostja andmed — vt Eksport ja kustutamine.
bin/magento cron:run --group smaily_connectKäivitab laienduse cron-tööd ühe korra (et kontrollida, kas need töötavad).
bin/magento config:set smaily_connect/logging/verbosity error|info|debugMäärab logifaili detailsuse; väljaspool tõrkeotsingut hoia see väärtusel error.

Upgrading from Smaily for Magento 2.8.xUuendamine versioonilt Smaily for Magento 2.8.x

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-rc11
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.

  • The admin notification says the earlier settings were migrated. Every Marketing > Smaily Connect page opens the Initial setup until it is finished for the website; it shows the migrated settings — 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.
  • 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, tick Enabled for Welcome and pick a Smaily Workflow on the Automations step of the website's Initial setup.
  • 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, tick Enabled for Abandoned cart and pick a Smaily Workflow on the Automations step of the website's Initial setup.
  • 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-rc11
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.

  • Halduse teade ütleb, et varasemad seaded migreeriti. Iga Turundus > Smaily Connect leht avab Algseadistuse, kuni see on veebilehe jaoks lõpetatud; see näitab migreeritud seadeid — 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.
  • 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 märgi veebisaidi Algseadistuse sammul 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 märgi veebisaidi Algseadistuse sammul 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).