Ülevaade
Mis on Smaily Connect?
Smaily Connect ühendab sinu Shopify poe sinu enda Smaily e-turunduse kontoga ja soovi korral ka Smaily Campaign Intelligence'iga (personaalsed tootesoovitused ja ostupõhised automaatikad).
See teeb kolme asja:
- Sünkib kontakte — nõusoleku andnud kliendid liiguvad sinu Smaily kontaktnimekirja.
- Käivitab automaatikaid — poe sündmused (tervitus, esimene tellimus, pooleli jäänud ost) käivitavad Smaily töövood.
- Toidab soovitusi — kui ühendad Campaign Intelligence'i, seemnendavad su kataloog, kliendid ja tellimused personaalsed soovitused ja mootori-põhised automaatikad.
Sinu andmed jäävad sinule. Kontaktid elavad sinu Smaily kontos; app ainult ühendab need kaks süsteemi.
Kuidas osad kokku käivad
Süsteeme on kolm:
- Shopify — sinu pood: kliendid, tellimused, tooted ja poe sündmused.
- Smaily — sinu e-turunduse konto, kus elavad kontaktid ja automaatika-töövood (
sinufirma.sendsmaily.net). - Campaign Intelligence — Smaily soovitusmootor aadressil
intelligence.smaily.com. Valikuline, ühendatakse ühekordse setup-lingiga.
Smaily Connect on sild. Shopify saadab sündmused ja andmed app'i; app edastab kontaktid ja triggerid Smaily'sse ning (kui ühendatud) kataloogi/kliendi/tellimuse andmed Campaign Intelligence'i.
Enne alustamist
Sul on vaja:
- Smaily kontot API-ligipääsuga. API-kasutajaid saad luua Smaily's Preferences → API all.
- (Valikuline) Campaign Intelligence setup-linki — ühekordne link, mille Smaily annab, kui kasutad soovitus-lisa.
Kõik seadistatakse Initial setup (algseadistus) juhendatud vooga, mida kirjeldab järgmine peatükk.
Alustamine
Pärast paigaldust: töölaud
App avaneb töölaual (Dashboard). Kuni seadistus on pooleli, näitab see Setup incomplete ja viipa ühendada Smaily ja/või Campaign Intelligence, ning nuppu Initial setup / Resume setup.
Kui kõik töötab, näitab töölaud kas Everything's running või Running — with failures to review (lingiga Event log'i).
Kui Smaily keeldub igast päringust, sest sinu Smaily pakett ei sisalda API-ligipääsu, näitab töölaud selle asemel Smaily pole ühendatud ja Smaily olekuna Pole ühendatud — vaata Veateated ja lahendused → Smaily ühenduse vead.
Initial setup koosneb 6 sammust. Sammud 2 ja edasi on lukus, kuni Smaily ühendus on kinnitatud.
Samm 1 — ühenda Smaily konto
Sisesta oma Smaily API-andmed. App kontrollib need enne salvestamist üle.
- Subdomain — osa enne
.sendsmaily.net(ntsinufirma). - API username ja API password — loo need Smaily's Preferences → API all.
Vajuta Test connection. Õnnestumisel näed Verified ja Connection verified — N active automations found. Andmeid saad hiljem muuta Settings → Connection all.
Samm 2 — kontaktid (Contacts)
Vali, millised kontaktid Smaily'sse sünkroniseeritakse ja millised väljad kaasa lähevad, ning too olemasolevad kontaktid üle.
- Vali nõusoleku-preset (vt Kontaktide seaded). Vaikimisi saadetakse ainult nõusoleku andnud kliendid.
- Email ja keel sünkitakse alati; lisa vabalt teisi välju.
- Initial contact import all käivita ühekordne Contacts import. See jookseb taustal — võid lehelt lahkuda, töö jätkub.
Samm 3 — automaatikad
Seo poe sündmused oma Smaily automaatika-töövoogudega.
- Poe-põhised triggerid: Welcome (klient liitub su e-posti turundusega — üks kord kontakti kohta), First order (kliendi esimene tellimus), Abandoned checkout (ost alustatud, kuid lõpetamata).
- Kui ühendad Campaign Intelligence'i, saad siin seadistada ka Engine-run recommendation automations — mootor otsustab, millal iga kontakt kaasata.
Smaily töövood peavad Smaily's eelnevalt olemas olema; app kuvab need sidumiseks.
Samm 4 — Campaign Intelligence (valikuline)
Ühenda Smaily Campaign Intelligence personaalsete soovituste, sirvimise jälgimise ja mootori-põhiste kampaaniate jaoks.
Kuni ühendust pole, algab samm lühikese tutvustusega: Campaign Intelligence kasutab sinu poe toote-, kliendi- ja tellimuseandmeid, et luua Smaily kampaaniate ja automaatikate jaoks personaalseid tootesoovitusi, ning see on valikuline tasuline lisateenus (kuumakse on seal välja toodud), mis lisandub tavapärasele Smaily kuumaksele. Aktiveerimiseks võta Smailyga ühendust või seadista see hiljem. Pärast ühendamist tutvustust enam ei näidata.
- Kleebi ühekordne setup-link, mille said Smaily'lt (kujul
https://intelligence.smaily.com/setup/…), ja vajuta Connect Campaign Intelligence. Linki saab kasutada täpselt üks kord. Vastu võetakse ainulthttps-link aadressilintelligence.smaily.com. - Ühendamine käivitab Products ja Customers impordi ise: kogu sinu kataloog ja kõik kliendid saadetakse Campaign Intelligence'isse üks kord, taustal, alates järgmisest taustakäivitusest (15 minuti jooksul). Iga klient saadetakse koos tema keelega. Üks teade ütleb seda kohe pärast ühendamist. Impordi peatamiseks vajuta enne seda teatel Stop import — see peatab mõlemad — või ühe impordi juures Cancel: midagi ei saadeta ja impordi saad hiljem käivitada nupuga Sync again. Kui katkestad pärast impordi algust, jäävad juba saadetud tooted või kliendid Campaign Intelligence'isse ja ülejäänuid ei saadeta. Pärast importi saadetakse ainult muudatused: salvestatud toode, laoseisu muutus, arhiveeritud või kustutatud toode, uus või muudetud klient. Lisaks saadab app kord ööpäevas, umbes kell 3.00 sinu poe ajavööndis, sinu aktiivsete toodete nimekirja — tooted, mida Products import saadab, igaühe koodi ja selle, kas toode on laos, muud mitte —, nii et laoseisu muutus, arhiveeritud või kustutatud toode, mis kohale ei jõudnud, on hommikuks parandatud. Mustandis või arhiveeritud toodet nimekirjas pole, seega see kaob soovitustest. Pood, millel on üle 50 000 toote (iga variant loeb eraldi), seda nimekirja ei saada; Event Log ütleb seda.
- Orders impordiga seemnendad tellimuste ajaloo siis, kui ise soovid — ohutu korrata, duplikaadid on disaini poolest võimatud.
- Soovi korral lülita sisse Browse tracking ja Recommendation attribution (vt Campaign Intelligence seaded).
Samm 5 — vormid ja RSS
Lisa oma poele uudiskirjaga liitumise vorm ja too tooted Smaily mallidesse.
- Newsletter signup block — teemaredaktoris (Online Store → Themes → Customize) lisa Smaily newsletter form plokk ükskõik millisesse sektsiooni. Registreerumised jõuavad automaatselt su Smaily kontaktidesse.
- Product RSS feed — URL, mille kleebid Smaily malliredaktorisse, et laadida poe tooted kampaaniatesse. Seadista Settings → Forms & RSS all.
Samm 6 — ülevaade
Kokkuvõte kõigest, mille seadistasid. Kontaktide sünkroniseerimine, automaatikad ja poe vormid aktiveeruvad, kui nende seadistus valmis saab.
Vajuta Finish setup. (Kui Smaily konto pole veel ühendatud, palutakse see enne lõpetamist ühendada.) Kõike saab hiljem muuta Settings all.
Seaded
Connection (ühendus)
Halda Smaily kontot, mille kaudu Smaily Connect saadab. Andmed valideeritakse Smaily vastu enne salvestamist.
- Ühendatuna näed Verified ja Connected as KASUTAJA @ subdomain.sendsmaily.net.
- Pole ühendatud koos tekstiga Pakett ei sisalda API-ligipääsu tähendab, et Smaily vastas salvestatud kontole koodiga 227: selle paketis pole API-t. Uuenda Smailys paketti, sisesta siis API parool uuesti ja vajuta Update credentials, et kasutajaandmeid uuesti kontrollida.
- Update credentials vahetab API-kasutaja.
- Disconnect peatab kontakti-sünki, kuni ühendad uuesti.
Kui su pood müüb mitmes keeles, pakub see tab ka mitmekeelset režiimi (eraldi Smaily konto või töövoog keele kohta).
Contacts (kontaktid)
Määrab, kes sinu Smaily kontaktnimekirja kopeeritakse ja millised väljad saadetakse.
Sync contacts to Smaily — pealüliti. Väljas olles kliente enam Smaily'sse ei kopeerita ja kõik, mida see lüliti juhib, on peidus: nõusoleku valikud, väljade valik ja Initial contact import. Lülita sisse ja need ilmuvad. Olemasolevad kontaktid ja Smaily automaatikad jäävad puutumata.
Kontaktide sünkroniseerimise valim (nõusoleku-presetid)
Vali oma turundusmeili õigusliku aluse järgi. Vaikimisi on nõusoleku-ohutu variant.
- Subscribers only (consent) (vaikimisi) — saadetakse ainult turundusele nõusoleku andnud kliendid. Smaily loobumised peegeldatakse tagasi kliendi Shopify turunduskonsenti (vajab Allow consent sync luba).
- All customers (legitimate interest) — iga klient saadetakse, sõltumata turunduskonsentist. Nõuab õiguslikku alust.
- Checkout opt-in only — saadetakse ainult ostjad, kes checkout'is turunduse aktsepteerivad (külalised kaasa). Kontosünki ega tagasi-sünki pole.
Väljad
Email sünkitakse alati (see identifitseerib kontakti) ja keel sünkitakse alati (see suunab kontakti mitmekeelses seadistuses õigesse kontosse). Vali vabalt lisaväljad.
Saad ka sünkida külalis-tellimuste e-maile. Automaatika ei telli kunagi uuesti kontakti, kes on Smaily's loobunud, üheski režiimis — seda teeb ainult ostja enda uus tellimus su poes.
Kuidas nõusolek on tõendatud
Subscribers only (consent) režiimis sünkitakse klient Smaily'sse ainult siis, kui Shopify märgib ta turundusele tellijaks (subscribed). Tõendiks on Shopify enda turunduskonsendi kirje — app ei eelda nõusolekut, vaid peegeldab seda, mille su pood on jäädvustanud.
Nõusoleku kirje sisaldab:
- Turundusseisund — tellija või mitte (sünkitakse ainult subscribed kliente).
- Nõusoleku tase — näiteks single opt-in.
- Nõusoleku ajatempel — millal seisund viimati määrati.
Nõusoleku jäädvustab su pood — checkout'i turundus-linnuke, Smaily newsletter form plokk (vormi saatmine ongi opt-in) või kliendi konto. Kui klient Smaily's loobub või kaebab, peegeldatakse see loobumine tagasi Shopify konsendi-kirjesse, et kaks jääks kooskõlla (vajab Allow consent sync luba).
Automated letters (automaatikad)
Siin elab kahte tüüpi automaatikat.
Poe-põhised triggerid
Seo poe sündmus Smaily töövooga: Welcome, First order, Abandoned checkout. Abandoned checkout'il on Send after viivitus (mitu minutit tegevusetust, enne kui ost loetakse hüljatuks).
Millal Welcome käivitub. Welcome saadetakse, kui kliendi e-posti turunduse tellimus su poes sisse lülitub — tavaliselt siis, kui ta märgib uudiskirja linnukese — ja ainult üks kord kontakti kohta: klient, kes loobub ja hiljem uuesti liitub, teist tervitust ei saa. Ainuüksi konto loomine seda ei saada, nii et adminis lisatud, imporditud või mõne teise rakenduse loodud klient, kellel turunduse tellimust pole, tervitust ei saa. Ka Smaily kaudu (näiteks Smaily liitumisvormiga) poodi jõudnud tellimus poe Welcome'it ei käivita.
Kui töövooge ei ilmu: neid ei leitud su Smaily kontolt (või Smaily ei olnud kättesaadav). Loo automaatikad esmalt Smaily's, siis tule tagasi.
Kui varem valitud töövoog hiljem Smaily's keelatakse, jääb see rippmenüüsse alles — märgitud kui "
Iga trigger märgistab kontakti — ehita selle peale segmente. Iga kord, kui mõni neist käivitub, kirjutab see kontaktile Smaily's käivitumise hetke, nii et eristad automaatika kaudu lisatud kontakti sellest, kes ise tellijaks hakkas:
welcome_automation_atfirst_order_automation_atabandoned_cart_automation_at
Väärtus on viimase käivituse kuupäev ja kellaaeg UTC-s (2026-08-04 14:30:00) — see kirjutatakse igal käivitusel üle ja trigger, mis pole selle kontakti jaoks kunagi käivitunud, jätab oma välja puutumata. Kasuta neid Smaily's automaatikaga puudutatud kontaktide kaasamiseks või välistamiseks. Abandoned checkout'i malli-väli is_abandoned_cart on muutmata ja saadetakse endiselt kõrvuti.
Hüljatud ostukorvi meeldetuletus kannab ostukorvi kümnes nummerdatud pesas. Igal pesal on product_name_<1-10>, product_quantity_<1-10>, product_price_<1-10> ja product_sku_<1-10>; rohkem kui kümne tootega ostukorv täidab kõik kümme ja seab over_10_products väärtuseks true, iga muu ostukorv saadab over_10_products tühjana, nii et väli kirjeldab alati praegust ostukorvi. Iga meeldetuletus kirjutab kõik kümme pesa, kasutamata pesad saadetakse tühjana — just see kustutab ostleja eelmise ostukorvi, nii et teine, väiksem ostukorv ei näita kunagi esimese jääke. Seetõttu peaks su Smaily mall jätma vahele pesad, mille product_name_<n> on tühi, mitte kuvama tühja rida.
Kes saab hüljatud ostukorvi meeldetuletuse. Smaily lisab aadressi, mida tal pole, tellijast kontaktina, kui selle jaoks töövoog käivitub. Seepärast loeb app enne iga meeldetuletust ostja kontakti Smaily'st ja järgib sinu kontaktide sünkroniseerimise valimit:
- Ostja, kes on Smaily's loobunud, ei saa seda kunagi, sõltumata valimist.
- All customers (legitimate interest) — meeldetuletuse saab iga e-posti aadressiga ostukorv, välja arvatud klient, kes on su poes e-posti turundusest loobunud ja selles kassas turunduse linnukest ei märkinud.
- Subscribers only (consent) — ainult Smaily tellijast kontakt, ostja, kes märkis selles kassas turunduse linnukese, või klient, kes on su poes e-posti turunduse tellija.
- Checkout opt-in only — ainult Smaily tellijast kontakt või ostja, kes märkis selles kassas turunduse linnukese.
Ostukorv, mis meeldetuletust ei saa, on Event log'is vahele jäetuna, põhjusega tellimusest loobunud või turundusnõusolek puudub. Kui Smaily'st või su poest ei saa sel hetkel lugeda, meeldetuletus ootab ja seda proovitakse uuesti nagu ebaõnnestunud saatmist — ilma kontrollita seda kunagi ei saadeta. Meeldetuletus ei telli kunagi kedagi uuesti: seda teeb ainult ostja enda uus tellimus su poes. Ostja, kes sai meeldetuletuse enne selle kontrolli tulekut, võib juba olla Smaily tellijast kontakt; sellistel kontaktidel on väljad is_abandoned_cart ja abandoned_cart_automation_at, nii et Smaily segment leiab nad üles.
Mootori-põhised soovitus-automaatikad
Neid käivitab Campaign Intelligence, mitte poe sündmus — mootor kaasab iga kontakti valitud Smaily töövoogu hetkel, mil ta ennustab (varu otsakorral, klient lahkumisohus). Iga automaatika kohta määrad:
- Enable lüliti ja kasutatava Smaily töövoo;
- Cooldown — minimaalne päevade arv sama kliendi kahe käivituse vahel (1–365);
- Test mode — sees olles lähevad meilid ainult su Test addresses'ile (komadega, kuni 50), mitte kunagi klientidele. Activate for real… lülitab testrežiimi välja pärissaatmise taotlusena: salvestamisel jääb automaatika testrežiimi ja kliendid hakkavad seda saama, kui Smaily on pärissaatmise sisse lülitanud. Pärast salvestamist näitab automaatika olekut Waiting for Smaily to enable real sends; kui avad lehe hiljem, näitab see Test mode, kuni Smaily on pärissaatmise sisse lülitanud, ja seejärel Active koos teatega, et pärissaatmine on sees. Automaatika, millel Smaily on pärissaatmise juba sisse lülitanud, jääb salvestamisel pärissaatmisele.
Test-režiimis automaatika ilma testaadressideta ei saada kellelegi, kuni lisad vähemalt ühe aadressi.
Kui siin valitud töövoog hiljem Smaily's keelatakse, jääb see rippmenüüsse alles — märgitud kui "Workflow #
Campaign Intelligence
Kuni Campaign Intelligence pole ühendatud, algab see tab sama tutvustusega nagu algseadistuse samm 4 — mida see teeb ja et tegu on valikulise tasulise lisateenusega, mis lisandub tavapärasele Smaily kuumaksele — ning selle all on nupp Open initial setup. Pärast ühendamist tutvustus kaob.
Ühendatuna näitab see tab ühendust (Test ja Disconnect) ning:
- Import existing data — seemnenda ajalugu, et soovitustel oleks, millest õppida (Products / Customers / Orders). Ohutu korrata.
- Browse tracking — jäädvustab toote- ja kategooriavaated, et toita sarnaste toodete soovitusi. Vaikimisi väljas; jookseb ainult siis, kui külastaja on andnud analüütika-nõusoleku. Väljalülitamine eemaldab jälgimispiksli sinu poest. Kui Shopify eemaldamisest keeldub, ütleb paneel seda ja pakub nuppu Retry removal — kuni see õnnestub, on piksel endiselt sinu poes, aga kõik tema saadetavad sündmused lükatakse tagasi, nii et midagi ei koguta.
- Recommendation attribution — omistab poe ostud soovitusele, mis need põhjustas. Vajalik, et üldse mingeid atributsiooni-numbreid näha; lülitad selle poe esiküljel sisse ühe klikiga (avab teemaredaktori sisselülitatud embed'iga — vajuta lihtsalt Save).
Test kinnitab, et ühendus on terve. Disconnect lõpetab andmete saatmise ja annab Campaign Intelligence'ile teada, et see ühendus lõpeb (vt Mida teeb lahtiühendamine (Disconnect)?); taasühendamiseks on vaja uut setup-linki. Uue setup-lingiga ühendamine, siin või algseadistuses, käivitab Products ja Customers impordi nii, nagu samm 4 kirjeldab; juba ootavat või jooksvat importi teist korda ei käivitata.
Kui Campaign Intelligence on selle poe tagasi lükanud, ütleb tab seda — punane silt Rejected, setup-lingi vorm kohapeal ja Test-nupp juhuks, kui Smaily on ligipääsu juba taastanud. Impordid on selle aja peidus, sest Campaign Intelligence'ini ei jõuaks midagi. Vaata punast „ühendus tagasi lükatud“ teadet.
Forms & RSS (vormid ja RSS)
Poe uudiskirja-plokk
Lisa Smaily newsletter form plokk oma teemasse (Online Store → Themes → Customize). Registreerumised jõuavad automaatselt su Smaily kontaktidesse. Plokk pärib su teema fondid ja värvid; pealkirja, nupu teksti ja nõusoleku-teksti seadista teemaredaktoris.
Soovituseelistuste plokk
Lisa Smaily personalisation plokk (sama teemaredaktor) vabalt valitud lehele — hästi sobib privaatsus- või kontoga seotud leht. Sisselogitud klient näeb märkeruutu Use my data for personalised recommendations ja saab igal ajal loobuda (või uuesti nõustuda); sisselogimata külastajal palutakse enne sisse logida. Valik salvestub kliendi Smaily kontaktile ja kehtib kõikjal: selle kliendi andmeid ei kasutata enam profileerimiseks ja personaalsed soovitused talle peatuvad, tavalised turunduskirjad jätkuvad, kuni ta pole loobunud. Kõik tekstid on teemaredaktoris muudetavad.
Toodete RSS-voog
URL, mis laadib poe tooted Smaily kampaaniatesse. Kontrollid ainult kujundavad URL-i — midagi ei salvestata. Sea Collection, Limit (10–250) ja Sort by, vajuta Update URL, siis kopeeri Feed URL Smaily malliredaktorisse.
Poe soovituste plokk
Kui Campaign Intelligence on ühendatud, näitab Smaily recommendations plokk ostjale kuni 4 talle soovitatud toodet — kaartidena sinu poe enda tootepildi, hinna, valuuta ja keelega. Toodet, mida ei saa osta, ei näidata.
Ploki lisamine
- Ava Online Store → Themes → Customize.
- Ava leht, kus soovitused peaksid olema, näiteks avaleht või tooteleht.
- Vali rakenduseplokke lubavas sektsioonis Add block või vali Add section, siis tab Apps ja seejärel Smaily recommendations.
- Vajuta Save.
Teemaredaktoris näitab plokk toodete asemel lühikest märget. Ilma plokita ei muutu sinu poes midagi. Shopify Canvas ei saa rakenduseplokke lisada, seega Canvasega plokki paigutada ei saa — kasuta teemaredaktorit.
Pealkiri
Ploki ainus seadistus. Jäta tühjaks, et näidata ostja keeles Sinule soovitatud (ingliskeelses poes Recommended for you); sisestatud tekst näidatakse täpselt nii, nagu see on kirjutatud.
Kes soovitusi näeb
- Ainult turundusnõusolekuga. Plokk küsib soovitusi ainult siis, kui Shopify kliendiandmete privaatsusseaded ütlevad, et ostja lubab turunduse — kui sinu pood näitab küpsiste riba, on ostja seal turunduse lubanud. See kehtib ka sisselogitud kliendile. Kui ostja nõustub hiljem samal lehel, näeb ta soovitusi ilma lehte uuesti laadimata.
- Keda ära tuntakse: sisselogitud klienti või külalist, kellel on Smaily külastaja-tunnus (Smaily e-kirja lingist või kassas e-posti turunduse linnukesest). Teised ei näe midagi ja plokk nende jaoks soovitusi ei küsigi.
- Sisselogitud klient, kes on Smaily personalisation plokiga personaalsed soovitused välja lülitanud, ei näe midagi.
- Kui soovitusi pole, ei näita plokk midagi — ka pealkirja mitte.
- Sinu lehed ei oota plokki. Plokk küsib pärast lehe laadimist; kui vastust 5 sekundi jooksul ei tule, ei näita see midagi. Iga sisselogimata ostja saab sama lehe, nii et poe lehtede vahemälu see ei mõjuta.
Olemasolevate andmete import
Mida imporditakse
Import (ka backfill) seemnendab su olemasolevad andmed, et sünkil ja soovitustel oleks ajalugu, millest lähtuda. Neid on neli:
- Contacts → su Smaily kontaktnimekiri (Contacts alt).
- Products, Customers, Orders → Campaign Intelligence (Campaign Intelligence alt).
Iga import on ühekordne masssissetoomine, mis jookseb taustal — võid lehelt lahkuda, töö jätkub. See on ohutu korrata: duplikaadid on disaini poolest võimatud. Esimest korda vajuta Sync now, pärast Sync again. Erand on Products ja Customers import: Campaign Intelligence'i ühendamine käivitab need sinu eest (vt samm 4).
Contacts — otsustab pealüliti. Contacts-import järgib Sync contacts to Smaily lülitit (Settings → Contacts) täpselt nagu igapäevane sünk. Kui lüliti on väljas, ei kuvata importi üldse — lülita sisse ja salvesta, siis see ilmub ja on käivitatav.
Orders — kogu ajalugu. Vaikimisi lubab Shopify rakendustel lugeda vaid viimase 60 päeva tellimusi, seega Orders-import seemnendab ainult selle akna. Kogu ostuajaloo importimiseks vajuta vahetult Orders-impordi kohal olevas Import your full order history? teates Read all orders, kinnita ühekordne luba ja seejärel Sync again.
Edenemise lugemine
Jooksmise ajal näed Importing… koos loenduriga. Products'i ja Customers'i puhul täitub edenemisriba teadaoleva koguni. Orders näitab jooksvat loendurit seni, kuni annad Read all orders loa — pärast seda täitub sellegi riba teadaoleva koguni. Ühendamisel käivitatud Products või Customers import näitab Importing… koos nulliga ja rida Ootab algust — import algab 15 minuti jooksul., kuni järgmine taustakäivitus selle alustab (15 minuti jooksul). Lõpetamisel tähendab olekurida:
| Olek | Tähendus |
|---|---|
| Done — N synced. | Kõik imporditud puhtalt. |
| Done — N of M synced. | Valmis; mõned kirjed lükati tagasi (tavaliselt vigased andmed, nt katkine e-mail). Ülejäänud on sees. |
| Stopped — N processed before an error. | Import sattus päris veale ja peatus. Vaata veabännerit, mida teha. |
| Cancelled — N processed. | Tühistasid selle. |
Kui mõned kirjed ebaõnnestusid, näed linki N failed — see Event log — ava see, et näha täpselt, millised kirjed ja miks.
Veateated ja lahendused
Smaily ühenduse vead
- Smaily rejected these credentials (401) — subdomain, kasutajanimi või parool on vale. Kontrolli need Smaily's Preferences → API all üle.
- Smaily keeldus päringust, sest selle konto pakett ei sisalda API-ligipääsu — Smaily vastas koodiga 227, A paid package is required. Sinu Smaily paketis pole API-t, seega keeldub Smaily igast päringust enne, kui kasutajaandmeid vaatab: neid ei saa enne seda üldse kontrollida ja ootamine ei aita. Uuenda Smailys paketti ja sisesta siis kasutajaandmed uuesti. Juba ühendatud konto näitab Settings → Connection all ja töölaual olekut Pole ühendatud alates esimesest päringust, millest Smaily nii keeldub; kontaktide sünkroonimine ja automaatikad jäävad seisma, kuni pakett API-t sisaldab. Kui sisaldab, sisesta API parool uuesti ja vajuta Update credentials: app kontrollib kasutajaandmeid uuesti ja konto näitab Verified.
- Could not reach Smaily — ajutine võrguprobleem; proovi uuesti.
- All three fields are required / Subdomain may contain only letters, numbers and dashes — paranda sisend ja proovi uuesti.
Campaign Intelligence vead
- This setup link was already used — setup-lingid on ühekordsed. Küsi Smaily'lt uus.
- Setup link not recognized — kontrolli, et kleepisid terve URL-i.
- The setup URL must be an https address on intelligence.smaily.com — kleebitud link viitab mujale. Kleebi link täpselt nii, nagu Smaily selle saatis; midagi ei saadetud kuhugi.
- The engine answered with an address that is not an https address on intelligence.smaily.com, so the connection was not saved — seadistuse vastus nimetas teise aadressi, seega midagi ei salvestatud. Võta ühendust Smaily toega.
- Campaign Intelligence did not respond — proovi Test varsti uuesti; kui püsib, võta tugiteenusega ühendust.
- Campaign Intelligence rejected the stored API key — võti tühistati või vahetati; taastamise sammud on järgmises jaotises.
Punane „ühendus tagasi lükatud“ teade töölaual
Punane teade töölaua ülaservas Campaign Intelligence rejected this store's connection tähendab, et teenus keeldub sellest poest täielikult: API-võti tühistati või selle taga olev Campaign Intelligence'i konto peatati või suleti Smaily poolel. Töölaud ei näita enam Everything's running ja Campaign Intelligence'i olek on selle aja Rejected — sama näitab ka Settings → Campaign Intelligence.
Mida see sinu poe jaoks tähendab:
- Campaign Intelligence'ini ei jõua midagi, seega soovitused ei värskendu ja vananevad.
- Smaily e-kirjade saatmist see ei mõjuta — kontaktide sünkroniseerimine ja automaatikad Smailysse töötavad edasi.
- Ootamine ei aita: app lõpetab uuesti proovimise, sest kordamine vastust ei muuda. Kohale toimetamata kirjed on Event log'is tõrgetena kirjas.
Kuidas see lahendada:
Kui Smaily ütleb, et konto on endisel kujul taastatud, ava Settings → Campaign Intelligence ja vajuta kõigepealt Test — õnnestunud test kustutab teate ise ja uut linki pole vaja.
- Küsi Smailyst uus Campaign Intelligence'i setup-link — info@smaily.com.
- Ava Settings → Campaign Intelligence, kleebi uus link välja Setup link ja vajuta Connect Campaign Intelligence. Ühendust ei ole vaja enne katkestada — uus link asendab vana ühenduse.
- Vajuta Event log'is Retry failed ingest, et tagasi lükatud kirjed uuesti saata.
Midagi sulgeda pole vaja: teade kaob ise sel hetkel, kui Campaign Intelligence appi jälle vastu võtab.
Loataotlused
Mõned funktsioonid küsivad ühekordset Shopify luba. Kinnita see, kui Shopify küsib, ja proovi tegevust uuesti.
- Enable multilingual sends — annab lugemisõiguse su poe keeltele/tõlgetele. Vajalik mitmekeelseks saatmiseks ja Products impordiks. Kui Products import näitab needs a one-time permission to read your store's languages, vajuta seda, kinnita, siis Sync again.
- Allow consent sync — laseb Smaily loobumistel uuendada kliendi turunduskonsenti Shopify's (subscribers-only režiim). Ilma selleta sünk ikka töötab — loobumine lihtsalt ei kajastu Shopify kliendikaardil.
- Browse tracking permissions — kui sirvimise jälgimise sisselülitamine ebaõnnestub, anna load, kui Shopify küsib, ja lülita uuesti sisse.
- Read returns — nüüd on see appi enda õigus, mitte eraldi nupp. Kui paigaldasid appi enne tagastuste uuendust, näitab Shopify järgmisel appi avamisel ühekordset kinnitusekraani. Kinnitamine laseb Campaign Intelligence'il näha, millised tooted tagastati, et kliendile ei soovitataks kohe tagasi toodet, mille ta just tagastas. Kuni sa pole kinnitanud, ei lähe midagi katki: tagastust, mida app ei näe, käsitletakse lihtsalt alleshoituna. Rida loetakse tagastatuks alles siis, kui kogu rida tuleb tagasi — kui kolmest tootest hüvitatakse üks, loetakse toode endiselt alleshoituks, sest klient jättis kaks endale.
Ebaõnnestunud sündmused ja kordus
Event log loetleb, mida app saatis, ja kõik tõrked. Kui mõned kirjed ei jõudnud kohale, näed N events failed in the last 24 hours.
- Kasuta View only failed, et nimekirja kitsendada.
- Retry failed ingest (N) seab ebaõnnestunud, järjekorra taga olevad kirjed uueks katseks.
Mis juhtub pärast ebaõnnestunud Smaily saatmist. Kui Smaily keeldub viisil, mis ei saa kunagi õnnestuda — valed või tühistatud tunnused, kustutatud töövoog, tagasi lükatud aadress — siis saatmine peatub kohe ja on nimekirjas ebaõnnestununa põhjusega permanent_http_…, nii et tead: see ootab parandust, mitte aega. Sama kehtib, kui Smaily vastab „invalid data“ (kood 203), sest Smaily lükkab samad andmed uuesti tagasi: saatmine ebaõnnestub esimesel katsel põhjusega permanent_envelope_203 ja Smaily vastusega. Iga muud Smaily veakoodi proovitakse uuesti, nagu allpool kirjas. Kui Smaily on lihtsalt hõivatud või korraks kättesaamatu, jäetakse saatmine meelde ja taustatöö proovib uuesti — umbes 1 minuti, 5 minuti, 15 minuti, 1 tunni ja 6 tunni pärast (või täpselt nii kaua, kui Smaily palub), kokku kuni 5 katset, seejärel loobutakse ja see läheb nimekirja ebaõnnestununa. See kehtib ühtviisi welcome-, first order-, hüljatud ostukorvi ja kontakti-sünki saatmistele, nii et lühike Smaily katkestus lükkab need kirjad edasi, mitte ei kaota ära.
Kuni saatmine ootab järgmist katset, näitab sündmuste logi seda kui retrying koos järgmise katse ajaga ning see EI lähe ebaõnnestunud sündmuste arvu sisse — teel olev saatmine ei ole ebaõnnestunud. See loetakse üks kord: kas siis, kui see õnnestub, või siis, kui sellest lõplikult loobutakse.
Edasi lükkunud saatmine kontrollitakse enne väljasaatmist üle: kui kontakt on vahepeal loobunud, jäetakse saatmine ära.
Retry failed ingest puudutab ainult Campaign Intelligence'i kirjeid — need hoiavad veel oma sisu. Smaily saatmisi korratakse ülaltoodud graafiku järgi ise, nende jaoks eraldi nuppu ei ole.
KKK ja veaotsing
Kas uuesti sünkimine on ohutu?
Jah. Iga import on ohutu korrata — duplikaadid on disaini poolest võimatud. Sync again jookseb algusest, taustal, ja püsib ka siis, kui lehelt lahkud.
Kui tihti andmed sünkivad?
Smaily Connect töötab kahel kiirusel:
- Peaaegu reaalajas (webhookid) — kui klient luuakse või uuendatakse, muudab oma turunduskonsenti või teeb tellimuse või checkout'i, teavitab Shopify app'i sekunditega ja sünk toimub kohe.
- Iga 15 minuti tagant (taust) — ajastatud töö proovib uuesti kõike ootel olevat (Smaily saatmised, mille ajutine tõrge kinni pidas, ja Campaign Intelligence'i järjekorras olevad kirjed), töötleb pooleli jäänud oste ja peegeldab Smaily loobumised tagasi Shopify'sse.
Ühekordsed impordid käivituvad, kui vajutad Sync now / Sync again, ja jätkuvad seejärel taustal. Campaign Intelligence'i ühendamine käivitab ka Products ja Customers impordi, järgmise taustakäivitusega. Ajastatud täisimporti pole: pärast importi saadetakse ainult muudatused — ning kord ööpäevas, umbes kell 3.00 poe aja järgi, kõigi aktiivsete toodete koodid koos laoseisuga (vt samm 4).
Miks näen vähem tellimusi kui oodatud?
Orders import näeb praegu ainult viimast 60 päeva. See on Shopify piirang standardsel tellimusõigusel, mida app kasutab — mitte viga, ja andmeid ei kao.
Kogu tellimusajalugu vajab laiendatud õigust (read_all_orders), mis nõuab Shopify heakskiitu. Me taotleme seda; kui see antakse, toob Orders impordi kordamine kogu ajaloo sisse.
Kas kogu kliendinimekiri imporditakse?
Jah. Kliendi-importi ei kärbita — Shopify privaatsuskaitse ainult redacteerib üksikuid välju, ei jäta kliente välja. Kui arv tundub oodatust väiksem, arvesta, et paljude tellimustega poel on tihti palju vähem unikaalseid kliente (korduvostjad).
Mida teeb lahtiühendamine (Disconnect)?
- Disconnect Smaily — kontakti-sünk peatub, kuni ühendad uuesti. Olemasolevad kontaktid ja Smaily automaatikad jäävad puutumata.
- Disconnect Campaign Intelligence — andmete sissevool peatub ja app annab Campaign Intelligence'ile teada, et see ühendus lõpeb. Kui su poel teist ühendust ei ole, paneb Campaign Intelligence poe pausile: soovitusi ei anta ja selle automaatseid e-kirju ei saadeta, aga poe andmed jäävad alles. Taasühendamine vajab uut ühekordset setup-linki ja see lõpetab pausi.
Kas app'i eemaldamine kustutab mu andmed?
Eemaldamine võtab app'i ligipääsu ja pärast Shopify andmesäilitus-akent kustutab app'i lokaalsed poeandmed.
Su Smaily kontaktid ja kõik Campaign Intelligence andmed jäävad alles — meelega, et saaksid platvormi vahetada ilma turundusajalugu kaotamata. Kliendipõhine kustutamine on alati taotlusel saadaval ja Shopify tavapärased privaatsus-(redact)-päringud täidetakse automaatselt.
Eemaldamisel, nagu ka Disconnect'i korral, annab app Campaign Intelligence'ile teada, et see ühendus lõpeb, ja kustutab oma Campaign Intelligence'i võtme: kui su poel teist ühendust ei ole, lõpetab Campaign Intelligence su poe andmete kasutamise kohe ja hoiab need alles. Kui paigaldad app'i uuesti, ühenda Campaign Intelligence uue setup-lingiga. Su poe Campaign Intelligence'i andmed kustutatakse, kui sulged oma Smaily konto.
Andmed ja privaatsus
Milliseid andmeid app kasutab
- Kliendi nimi ja e-mail — kontaktide/klientide sünkroniseerimiseks su Smaily kontosse ja (Campaign Intelligence'iga) kliendipõhise identiteedina.
- Tellimuse ja toote andmed — automaatikate ja (kui lubatud) soovituste jaoks.
- Anonüümsed sirvimissündmused — ainult Shopify liivakasti-Web Pixeli kaudu, Shopify kliendi-privaatsuse (nõusoleku) seadetega väravastatud.
- Külastaja-tunnus checkout'is liitujale — kui Browse tracking on sees ja ostja märgib checkout'is e-posti turunduse linnukese, aga tal pole veel Smaily külastaja-tunnust, saab ta juhusliku tunnuse esimese osapoole küpsisesse (
smaily_rec_uid, 365 päeva; Safari hoiab nii seatud küpsist 7 päeva). See saadetakse koos tellimusega, et Campaign Intelligence tunneks ostja järgmisel külastusel ära. Ilma linnukeseta tunnust ei looda ja olemasolevat tunnust kunagi ei asendata.
App küsib ainult nime ja e-maili — ei telefoninumbreid ega postiaadresse.
Kustutamine ja GDPR
App täidab Shopify kohustuslikud privaatsus-webhookid:
- Customer data request — ekspordib kliendi andmed.
- Customer redact — kustutab kliendi kirjed app'ist (tema Event Logi kirjed jäävad alles, aadressi asemel on tavaliselt mõne tunni jooksul
[erased]) ja palub Campaign Intelligence'il kliendi kustutada. Tema kontakt jääb sinu Smaily kontole — vajadusel kustuta see seal. - Shop redact — kustutab kõik poe lokaalsed andmed.
Täpsemalt vaata täielikku privaatsuspoliitikat.
Profileerimisest loobumine (personaalsed soovitused)
Campaign Intelligence personaliseerib soovitusi sünkitud kontaktidele vaikimisi. GDPR annab ostjale õiguse esitada profileerimisele vastuväide eraldi uudiskirjast loobumisest — app hoiab need kaks nõusolekut rangelt lahus:
- Profileerimisest loobumine peatab selle kliendi andmete kasutamise personaalsete soovituste jaoks — Campaign Intelligence jätab ta välja, nii et tema tegevust enam profileerimiseks temaga ei seota. Andmed säilivad, aga neid enam nii ei kasutata; valik on tagasipööratav. Turunduskirjad jätkuvad nagu enne. See ei lülita välja andmete kogumist: kas sirvimissündmusi üldse jäädvustatakse, sõltub Shopify privaatsus- (nõusoleku) seadetest ja sinu Browse tracking lülitist.
- Turundusest loobumine (unsubscribe) peatab ühtlasi ka profileerimise (tugevam signaal).
Anna ostjatele see valik, lisades poe esiküljele Smaily personalisation ploki (vt Settings → Forms & RSS eespool). Valik salvestub kliendi Smaily kontaktile koos ajatempliga (GDPR-i tõend) ja jõustub Campaign Intelligence'is kohe.
Kuna profileerimine on vaikimisi sees, peaks su poe privaatsuspoliitika mainima, et ostu- ja sirvimisandmeid kasutatakse soovituste personaliseerimiseks — läbipaistvus on see, mis teeb loobumis-mudeli seaduslikuks.
Turvalisus ja isoleeritus
- Poe-põhine isoleeritus — iga päring, järjekorra-kirje ja mootori-kutse on su poe ulatuses.
- Saladused ei jõua brauserisse — API-võtmed ja paroolid jäävad serveripoolele; sündmuste kirjed hoiavad ainult id-sid, mitte kunagi võtmeid ega isikuandmeid.
App'i haldab Sendsmaily OÜ. Küsimused: info@smaily.com.