Dokumentácia

Integrácie

Shopify s vlastnou aplikáciou

Pripojte Shopify obchod k AmICited cez vlastnú aplikáciu zo Shopify Dev Dashboard namiesto aplikácie z App Store: scopes, Client ID a secret a obmedzenia.

Bežný spôsob pripojenia Shopify je aplikácia FlowHunt zo Shopify App Store (pozrite si e-shopy). Ak nechcete mať v obchode verejnú aplikáciu alebo pravidlá vášho obchodu inštalácie z App Store neumožňujú, môžete sa pripojiť cez vlastnú aplikáciu (custom app), ktorú si sami vytvoríte v Shopify Dev Dashboard.

Po pripojení funguje vlastná aplikácia rovnako ako inštalácia z App Store: cenová ponuka importu, spätný import objednávok a produktov, reporty Eshop, link building aj CMS.

Integrácie e-shopov sú dostupné od plánu Pro a pripájať ich môžu len správcovia workspaceu.

Skôr než začnete#

  • Použite Shopify organizáciu samotného obchodu. Aplikácia musí patriť do tej istej Shopify organizácie ako obchod. Agentúra nemôže na obchode klienta použiť vlastnú aplikáciu, takže aplikáciu musí vytvoriť klient.
  • Platba kartou. Workspacey fakturované cez Shopify nemôžu vlastnú aplikáciu použiť. Najprv prepnite plán na platbu kartou.
  • Oprávnenia v Shopify. Musíte mať možnosť vytvárať aplikácie v Dev Dashboard obchodu (vlastník obchodu alebo účet zamestnanca s povolením vyvíjať aplikácie).

Vytvorenie aplikácie v Shopify#

  1. Otvorte vývoj aplikácií v administrácii Shopify

    V administrácii Shopify kliknite na Settings, potom na Apps, potom na Develop apps a kliknite na Build apps in Dev Dashboard. Môžete tiež prejsť priamo do Shopify Dev Dashboard a prihlásiť sa účtom, ktorý obchod vlastní.

    Úvodná stránka administrácie Shopify s položkou Settings v ľavom dolnom menu
    Nastavenia administrácie Shopify s položkou Apps v menu
    Nastavenia Apps v administrácii Shopify s tlačidlom Develop apps
    Stránka vývoja aplikácií s tlačidlom Build apps in Dev Dashboard
  2. Vytvorte aplikáciu

    V Dev Dashboard otvorte Apps a kliknite na Create app. Ak už vaša organizácia nejaké aplikácie má, kliknite na Create app vpravo hore a zvoľte Create app manually.

    Stránka Apps v Shopify Dev Dashboard
    Odkaz Create app pod Get API credentials v Dev Dashboard
  3. Vyplňte aplikáciu a jej scopes

    • App name (1): čokoľvek, čo spoznáte, napríklad „AmICited“.
    • App URL (2): https://app.flowhunt.io/. Zrušte začiarknutie Embed app in Shopify admin; aplikácia nemá v Shopify vlastnú obrazovku.
    • Allowed redirection URL(s): nechajte prázdne. AmICited sa prihlasuje pomocou Client ID a Client secret aplikácie, takže Shopify naň nikdy nepresmerúva. Use legacy install flow nechajte nezačiarknuté.
    • Scopes (3, v časti API access): vložte tento zoznam. Sú to rovnaké scopes, o ktoré žiada aplikácia z App Store, takže vlastná aplikácia získa všetky funkcie AmICited okrem histórie objednávok staršej ako 60 dní (pozri nižšie):
    text
    read_orders,write_orders,read_products,write_products,read_customers,write_customers,read_inventory,write_inventory,read_locations,write_price_rules,read_content,write_content,read_themes,write_themes,read_locales

    Webhooks API version nechajte tak, ako je.

    Formulár Create an app v Dev Dashboard s poliami App name, URL adresy, Scopes a Webhooks API version

    Radšej zaškrtávate políčka, než by ste vkladali text? Kliknite na Select from list nad poľom Scopes, vyhľadajte každý scope zo zoznamu vyššie (1), zaškrtnite ho a kliknite na Done (2).

    Odkaz Select from list nad poľom Scopes
    Dialóg Select scopes s vyhľadávacím poľom a tlačidlom Done
  4. Vytvorte aplikáciu

    Keď máte vyplnený názov, URL a scopes, kliknite na Create app vpravo hore vo formulári (4 na snímke formulára vyššie). Shopify aplikáciu vytvorí a vydá jej prvú verziu.

    Tlačidlo Create app vpravo hore vo formulári Create an app
  5. Skontrolujte, či je verzia aktívna

    V menu aplikácie otvorte Versions: prvá verzia je označená ako Active. Ak neskôr scopes zmeníte, kliknite na Create version, aby sa zmena prejavila.

    Stránka Versions v Dev Dashboard s prvou verziou označenou ako Active
  6. Nastavte distribúciu na vlastnú

    Vlastnú aplikáciu treba najprv obmedziť na váš obchod, až potom ju v ňom môžete nainštalovať.

    1. V Overview aplikácie kliknite na kartu Distribution (Manage custom install link). Shopify otvorí Partners Dashboard; ak sa opýta, vyberte účet, ktorý pre obchod používate.
    2. Zvoľte Custom distribution (1) a kliknite na Select (2). Spôsob distribúcie vám Shopify neskôr nedovolí zmeniť.
    3. Do poľa Store domain zadajte adresu obchodu your-store.myshopify.com (1; pozrite Nájdite adresu svojho obchodu nižšie) a kliknite na Generate link (2). Allow multi-store install for one Plus organization má význam len vtedy, ak váš obchod patrí do organizácie Shopify Plus s viacerými obchodmi.
    Overview aplikácie v Dev Dashboard s kartou Distribution
    Výber účtu Shopify pre Partners Dashboard (rozmazaný)
    Stránka Distribution s možnosťou Custom distribution a tlačidlom Select
    Formulár Custom distribution s poľom Store domain a tlačidlom Generate link
  7. Nainštalujte aplikáciu do obchodu

    Kým aplikácia nie je v obchode nainštalovaná, nemôže nič čítať.

    1. V Dev Dashboard otvorte Overview aplikácie a kliknite na Install app v hornej časti karty Installs. V niektorých dashboardoch má toto tlačidlo názov Test app, ako na snímke nižšie. Môžete tiež otvoriť menu ⋯ v riadku aplikácie v zozname Apps a zvoliť Install app.
    2. Vyberte obchod, ktorý chcete pripojiť.
    3. Skontrolujte prístup, o ktorý aplikácia žiada, a kliknite na Install.
    Overview aplikácie v Dev Dashboard s tlačidlom Test app v časti Installs
    Výber Shopify obchodu, do ktorého sa aplikácia nainštaluje
    Obrazovka Update data access v administrácii Shopify s tlačidlom Install

    Obrazovka upozorní, že „This app hasn’t been reviewed“. To je v poriadku: je to vaša vlastná aplikácia, nie aplikácia z App Store.

  8. Skopírujte Client ID a Client secret

    V Dev Dashboard otvorte Settings aplikácie. V časti Credentials skopírujte Client ID a Client secret (použite tlačidlá na kopírovanie vedľa každého poľa). So secretom zaobchádzajte ako s heslom.

    Položka Settings aplikácie v menu Dev Dashboard
    Sekcia Credentials s Client ID (rozmazané)
    Sekcia Credentials s Client secret

Vlastné aplikácie importujú objednávky za posledných 60 dní

Objednávky staršie ako 60 dní vracia Shopify len aplikáciám so scope read_all_orders a Dev Dashboard ho pri vlastnej aplikácii odmietne („Contains invalid scopes: read_all_orders“). Pripojenie cez vlastnú aplikáciu preto importuje objednávky za posledných 60 dní a od tohto bodu začínajú aj reporty Eshop. Cenová ponuka importu môže stále ponúkať dlhšiu históriu; samotný import sa však zastaví na 60 dňoch. Ak potrebujete celú históriu objednávok, pripojte sa radšej cez aplikáciu z App Store.

Pripojenie v AmICited#

  1. Nájdite adresu svojho obchodu

    V administrácii Shopify otvorte Settings. Adresa obchodu (your-store.myshopify.com) je zobrazená pod názvom obchodu v hornej časti menu.

    Nastavenia administrácie Shopify s adresou myshopify.com pod názvom obchodu (rozmazané)
  2. Otvorte dialóg Shopify

    Prejdite do Zdroje údajov, v časti Eshops kliknite na Connect Shopify Store a potom na Use a custom app instead (1 na snímke nižšie).

  3. Zadajte obchod a prístupové údaje

    Zadajte Store address, Client ID a Client secret (2) a kliknite na Connect store (3).

    Dialóg Shopify s možnosťou Use a custom app instead a poliami Store address, Client ID a Client secret
  4. Zvoľte doménu a potvrďte import

    Priraďte obchod k doméne a zvoľte, akú históriu objednávok importovať, rovnako ako pri inštalácii z App Store. Každá možnosť pred potvrdením ukáže odhadovaný počet riadkov a jednorazový náklad.

Potom nastavte údaje o zákazníkoch a nastavenia obchodu rovnako ako pri akomkoľvek inom obchode.

Čím sa vlastná aplikácia líši#

Prečo sa odkazy neaplikujú znova hneď po úprave produktu?

Vlastné aplikácie nedostávajú webhooky zo Shopify, takže úprava produktu alebo stránky v Shopify nespôsobí, že by link building svoje odkazy hneď aplikoval znova. Aplikujú sa znova pri ďalšom spustení pravidla.

Čo sa stane, ak sa aplikácia vymaže alebo odinštaluje?

Pripojenie sa približne do jedného dňa zastaví a workspace dostane upozornenie. Ak sa chcete znova pripojiť, otvorte rovnaký dialóg, zvoľte Update credentials a zadajte aktuálne Client ID a Client secret aplikácie.

Prečo import siaha len 60 dní dozadu?

Staršie objednávky vyžadujú scope read_all_orders od Shopify a Dev Dashboard ho pri vlastnej aplikácii neprijme. Pripojenie cez vlastnú aplikáciu preto importuje objednávky za posledných 60 dní a odvtedy už pribúdajú nové objednávky. Ak chcete celú históriu, použite aplikáciu z App Store.

Môže agentúra použiť jednu aplikáciu pre všetkých svojich klientov?

Nie. Aplikácia musí patriť do tej istej Shopify organizácie ako obchod, takže každý klient si vytvorí vlastnú aplikáciu.

Súvisiace#