Documentație

Integrări

Shopify cu o aplicație personalizată

Conectați un magazin Shopify la AmICited cu propria aplicație personalizată din Shopify Dev Dashboard în locul aplicației din App Store: scopes, Client ID și secret, precum și limitările.

Modul obișnuit de a conecta Shopify este aplicația FlowHunt din Shopify App Store (consultați magazine ecommerce). Dacă nu doriți o aplicație publică în magazinul dumneavoastră sau dacă politica magazinului blochează instalările din App Store, vă puteți conecta cu o aplicație personalizată pe care o creați singur în Shopify Dev Dashboard.

Odată conectată, o aplicație personalizată funcționează la fel ca o instalare din App Store: oferta de import, importul retroactiv al comenzilor și produselor, rapoartele Eshop, link building-ul și CMS-ul.

Integrările ecommerce sunt disponibile începând cu planul Pro și doar administratorii spațiului de lucru le pot conecta.

Înainte de a începe#

  • Folosiți organizația Shopify a magazinului. Aplicația trebuie să aparțină aceleiași organizații Shopify ca magazinul. O agenție nu își poate folosi propria aplicație în magazinul unui client, așa că aplicația trebuie creată de client.
  • Facturare cu cardul. Spațiile de lucru facturate prin Shopify nu pot folosi o aplicație personalizată. Treceți mai întâi planul pe facturare cu cardul.
  • Permisiuni Shopify. Trebuie să puteți crea aplicații în Dev Dashboard-ul magazinului (proprietarul magazinului sau un cont de personal care are voie să dezvolte aplicații).

Creați aplicația în Shopify#

  1. Deschideți dezvoltarea de aplicații în administrarea Shopify

    În administrarea Shopify, faceți clic pe Settings, apoi pe Apps, apoi pe Develop apps și faceți clic pe Build apps in Dev Dashboard. Puteți merge și direct la Shopify Dev Dashboard și vă puteți autentifica cu contul care deține magazinul.

    Pagina principală a administrării Shopify cu Settings în meniul din stânga jos
    Settings în administrarea Shopify cu Apps în meniu
    Setările Apps din administrarea Shopify cu butonul Develop apps
    Pagina App development cu butonul Build apps in Dev Dashboard
  2. Creați aplicația

    În Dev Dashboard, deschideți Apps și faceți clic pe Create app. Dacă organizația dumneavoastră are deja aplicații, faceți clic pe Create app în dreapta sus și alegeți Create app manually.

    Pagina Apps din Shopify Dev Dashboard
    Linkul Create app de sub Get API credentials în Dev Dashboard
  3. Completați datele aplicației și scopes

    • App name (1): orice nume pe care îl recunoașteți, de exemplu „AmICited”.
    • App URL (2): https://app.flowhunt.io/. Debifați Embed app in Shopify admin; aplicația nu are un ecran propriu în Shopify.
    • Allowed redirection URL(s): lăsați gol. AmICited se autentifică cu Client ID-ul și Client secret-ul aplicației, așa că Shopify nu redirecționează niciodată înapoi către el. Lăsați Use legacy install flow debifat.
    • Scopes (3, la API access): lipiți această listă. Acestea sunt scopes pe care le solicită aplicația din App Store, așa că aplicația personalizată primește toate funcțiile AmICited, cu excepția istoricului comenzilor mai vechi de 60 de zile (vedeți mai jos):
    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

    Lăsați Webhooks API version așa cum este.

    Formularul Create an app din Dev Dashboard cu App name, URL-uri, Scopes și Webhooks API version

    Preferați să bifați căsuțe în loc să lipiți? Faceți clic pe Select from list deasupra câmpului Scopes, căutați fiecare scope din lista de mai sus (1), bifați-l și faceți clic pe Done (2).

    Linkul Select from list deasupra câmpului Scopes
    Dialogul Select scopes cu câmpul de căutare și butonul Done
  4. Creați aplicația

    După ce numele, URL-ul și scopes sunt completate, faceți clic pe Create app în dreapta sus a formularului (4 în captura de ecran a formularului de mai sus). Shopify creează aplicația și lansează prima ei versiune.

    Butonul Create app din dreapta sus a formularului Create an app
  5. Verificați că versiunea este activă

    Deschideți Versions în meniul aplicației: prima versiune este marcată Active. Dacă modificați ulterior scopes, faceți clic pe Create version pentru ca modificarea să intre în vigoare.

    Pagina Versions din Dev Dashboard cu prima versiune marcată Active
  6. Setați distribuția la personalizată

    O aplicație personalizată trebuie limitată la propriul magazin înainte de a putea fi instalată acolo.

    1. În Overview al aplicației, faceți clic pe cardul Distribution (Manage custom install link). Shopify deschide Partners Dashboard; dacă vi se cere, alegeți contul pe care îl folosiți pentru magazin.
    2. Selectați Custom distribution (1) și faceți clic pe Select (2). Shopify nu vă permite să schimbați ulterior metoda de distribuție.
    3. La Store domain, introduceți adresa your-store.myshopify.com a magazinului (1; consultați Găsiți adresa magazinului mai jos) și faceți clic pe Generate link (2). Allow multi-store install for one Plus organization contează doar dacă magazinul dvs. aparține unei organizații Shopify Plus cu mai multe magazine.
    Overview al aplicației în Dev Dashboard cu cardul Distribution
    Selectorul de conturi Shopify pentru Partners Dashboard (estompat)
    Pagina Distribution cu Custom distribution și butonul Select
    Formularul Custom distribution cu câmpul Store domain și butonul Generate link
  7. Instalați aplicația în magazin

    Aplicația nu poate citi nimic până când nu este instalată în magazin.

    1. Deschideți Overview al aplicației în Dev Dashboard și faceți clic pe Install app în partea de sus a cardului Installs. În unele panouri, acest buton se numește Test app, ca în captura de ecran de mai jos. Puteți deschide și meniul ⋯ de pe rândul aplicației din lista Apps și alege Install app.
    2. Alegeți magazinul pe care doriți să îl conectați.
    3. Verificați accesul pe care îl solicită aplicația și faceți clic pe Install.
    Overview al aplicației în Dev Dashboard cu butonul Test app la Installs
    Selectorul de magazine Shopify cu magazinul în care se instalează aplicația
    Ecranul Update data access din administrarea Shopify cu butonul Install

    Ecranul avertizează că „This app hasn’t been reviewed”. Este normal: este propria dumneavoastră aplicație, nu una din App Store.

  8. Copiați Client ID și Client secret

    Deschideți Settings ale aplicației în Dev Dashboard. La Credentials, copiați Client ID și Client secret (folosiți butoanele de copiere de lângă fiecare câmp). Tratați secretul ca pe o parolă.

    Elementul Settings al aplicației în meniul Dev Dashboard
    Secțiunea Credentials cu Client ID (estompat)
    Secțiunea Credentials cu Client secret

Aplicațiile personalizate importă comenzile din ultimele 60 de zile

Shopify returnează comenzile mai vechi de 60 de zile doar aplicațiilor care au scope-ul read_all_orders, iar Dev Dashboard îl refuză pentru o aplicație personalizată („Contains invalid scopes: read_all_orders”). Prin urmare, o conexiune prin aplicație personalizată importă comenzile din ultimele 60 de zile, iar rapoartele Eshop încep de acolo. Oferta de import poate propune în continuare un istoric mai lung; importul propriu-zis se oprește la 60 de zile. Dacă aveți nevoie de istoricul complet al comenzilor, conectați-vă în schimb cu aplicația din App Store.

Conectați-o în AmICited#

  1. Găsiți adresa magazinului

    În administrarea Shopify, deschideți Settings. Adresa magazinului (your-store.myshopify.com) este afișată sub numele magazinului, în partea de sus a meniului.

    Settings în administrarea Shopify cu adresa myshopify.com sub numele magazinului (estompată)
  2. Deschideți dialogul Shopify

    Mergeți la Data Sources, la Eshops faceți clic pe Connect Shopify Store, apoi faceți clic pe Use a custom app instead (1 în captura de ecran de mai jos).

  3. Introduceți magazinul și datele de autentificare

    Introduceți Store address, Client ID și Client secret (2), apoi faceți clic pe Connect store (3).

    Dialogul Shopify cu Use a custom app instead și câmpurile Store address, Client ID și Client secret
  4. Alegeți domeniul și confirmați importul

    Asociați magazinul cu un domeniu și alegeți cât istoric de comenzi să importați, la fel ca la o instalare din App Store. Fiecare opțiune afișează numărul estimat de rânduri și costul unic înainte de a confirma.

După aceea, configurați datele clienților și setările magazinului la fel ca pentru orice magazin.

Prin ce diferă o aplicație personalizată#

De ce linkurile nu se reaplică imediat ce editez un produs?

Aplicațiile personalizate nu primesc webhook-uri Shopify, așa că editarea unui produs sau a unei pagini în Shopify nu face ca link building-ul să își reaplice imediat linkurile. Acestea sunt aplicate din nou la următoarea rulare a regulii.

Ce se întâmplă dacă aplicația este ștearsă sau dezinstalată?

Conexiunea se oprește în aproximativ o zi, iar spațiul de lucru primește o notificare. Pentru a vă reconecta, deschideți același dialog, alegeți Update credentials și introduceți Client ID-ul și Client secret-ul actuale ale aplicației.

De ce importul merge înapoi doar 60 de zile?

Comenzile mai vechi necesită scope-ul Shopify read_all_orders, iar Dev Dashboard nu îl acceptă pentru o aplicație personalizată. Prin urmare, o conexiune prin aplicație personalizată importă comenzile din ultimele 60 de zile, iar comenzile noi continuă să sosească de atunci încolo. Pentru istoricul complet, folosiți aplicația din App Store.

Poate o agenție să folosească o singură aplicație pentru toți clienții?

Nu. Aplicația trebuie să aparțină aceleiași organizații Shopify ca magazinul, așa că fiecare client își creează propria aplicație.

Articole conexe#