Ü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 lühikese viisardiga, 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 Setup wizard / 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).

Seadistusviisardil on 6 sammu. 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 (nt sinufirma).
  • 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 — tellijad (Subscribers)

Vali, kes Smaily'sse sünkitakse ja millised väljad kaasa lähevad, ning too olemasolevad kliendid üle.

  • Vali nõusoleku-preset (vt Tellijate seaded). Vaikimisi saadetakse ainult nõusoleku andnud kliendid.
  • Email ja keel sünkitakse alati; lisa vabalt teisi välju.
  • Bring existing customers over 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 (uus klient annab nõusoleku), 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.

  • Kleebi ühekordne setup-link, mille said Smaily'lt (kujul https://…/setup/…), ja vajuta Connect Campaign Intelligence. Linki saab kasutada täpselt üks kord.
  • Pärast ühendamist seemnenda ajalugu Products, Customers ja Orders importidega — ohutu korrata, duplikaadid on disaini poolest võimatud.
  • Soovi korral lülita sisse Browse tracking ja Recommendation attribution (vt Campaign Intelligence seaded).

Samm 5 — integratsioonid

Ühenda Smaily oma poe esiküljega.

  • 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 → Integrations all.

Samm 6 — lõpeta

Kokkuvõte kõigest, mille seadistasid. Kontakti-sünk, automaatikad ja poe-integratsioonid 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.
  • 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).

Subscribers (tellijad)

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; olemasolevad kontaktid ja Smaily automaatikad jäävad puutumata.

Kes sünkitakse (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, mida sünkida

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 ja (legitimate-interest režiimis) sundida opt-in'i automaatika-triggeritel.

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

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 " — disabled in Smaily" — selle asemel, et vaikselt kaduda, nii ei kao su seadistus lehe salvestamisel. Luba töövoog uuesti Smaily's või vali mõni teine, seejärel salvesta.

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. Reaalseks minekuks kasuta Activate for real….

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 # — disabled in Smaily" — selle asemel, et vaikselt kaduda, nii ei kao su seadistus lehe salvestamisel. Luba töövoog uuesti Smaily's või vali mõni teine, seejärel salvesta.

Campaign Intelligence

Ü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.
  • 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 peatab soovitused ja andmete sissevoolu; taasühendamiseks on vaja uut setup-linki.

Integrations (integratsioonid)

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 sirvimise jälgimine ja personaalsed soovitused 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.

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

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. 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.
  • 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.
  • 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. Disconnect, ühenda uue setup-lingiga, siis tule tagasi.

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.

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.

Korrata saab ainult järjekorda pandud kirjeid (Campaign Intelligence'i) — need hoiavad veel oma sisu. Smaily saatmist ei saa uuesti mängida.

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 järjekorras olevat (näiteks Campaign Intelligence'i), 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.

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 — soovitused ja andmete sissevool peatuvad. Taasühendamine vajab uut ühekordset setup-linki.

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.

Andmed ja privaatsus

Milliseid andmeid app kasutab

  • Kliendi nimi ja e-mail — tellijate/klientide sünkimiseks 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.

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 app'ist ja Campaign Intelligence'ist.
  • 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 sirvimise jälgimise ja personaalsed soovitused. Andmed säilivad, aga neid ei kasutata; valik on tagasipööratav. Turunduskirjad jätkuvad nagu enne.
  • Turundusest loobumine (unsubscribe) peatab ühtlasi ka profileerimise (tugevam signaal).

Anna ostjatele see valik, lisades poe esiküljele Smaily personalisation ploki (vt Settings → Integrations 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.