Dokumentacja

Integracje

Shopify z aplikacją niestandardową

Połącz sklep Shopify z AmICited za pomocą własnej aplikacji niestandardowej z Shopify Dev Dashboard zamiast aplikacji z App Store: zakresy uprawnień, Client ID i sekret oraz ograniczenia.

Standardowo Shopify łączy się przez aplikację FlowHunt z Shopify App Store (zobacz sklepy internetowe). Jeśli nie chcesz mieć w sklepie publicznej aplikacji albo zasady Twojego sklepu blokują instalacje z App Store, możesz połączyć się za pomocą aplikacji niestandardowej, którą sam tworzysz w Shopify Dev Dashboard.

Po podłączeniu aplikacja niestandardowa działa tak samo jak instalacja z App Store: wycena importu, uzupełnienie historii zamówień i produktów, raporty Sklepu, link building i CMS.

Integracje e-commerce są dostępne od planu Pro i mogą je podłączać tylko administratorzy przestrzeni roboczej.

Zanim zaczniesz#

  • Użyj organizacji Shopify, do której należy sklep. Aplikacja musi należeć do tej samej organizacji Shopify co sklep. Agencja nie może użyć własnej aplikacji w sklepie klienta, więc aplikację musi utworzyć klient.
  • Płatność kartą. Przestrzenie robocze rozliczane przez Shopify nie mogą korzystać z aplikacji niestandardowej. Najpierw przełącz plan na płatność kartą.
  • Uprawnienia w Shopify. Musisz mieć możliwość tworzenia aplikacji w Dev Dashboard sklepu (jako właściciel sklepu lub pracownik z uprawnieniem do tworzenia aplikacji).

Utwórz aplikację w Shopify#

  1. Otwórz tworzenie aplikacji w panelu Shopify

    W panelu administracyjnym Shopify kliknij Settings, następnie Apps, potem Develop apps, a na koniec Build apps in Dev Dashboard. Możesz też przejść bezpośrednio do Shopify Dev Dashboard i zalogować się kontem, do którego należy sklep.

    Strona główna panelu Shopify z pozycją Settings w lewym dolnym rogu menu
    Ustawienia panelu Shopify z pozycją Apps w menu
    Ustawienia Apps w panelu Shopify z przyciskiem Develop apps
    Strona App development z przyciskiem Build apps in Dev Dashboard
  2. Utwórz aplikację

    W Dev Dashboard otwórz Apps i kliknij Create app. Jeśli Twoja organizacja ma już aplikacje, kliknij Create app w prawym górnym rogu i wybierz Create app manually.

    Strona Apps w Shopify Dev Dashboard
    Link Create app w sekcji Get API credentials w Dev Dashboard
  3. Uzupełnij dane aplikacji i jej zakresy

    • App name (1): dowolna nazwa, którą rozpoznasz, na przykład „AmICited”.
    • App URL (2): https://app.flowhunt.io/. Odznacz Embed app in Shopify admin; aplikacja nie ma własnego ekranu w Shopify.
    • Allowed redirection URL(s): zostaw puste. AmICited loguje się za pomocą Client ID i Client secret aplikacji, więc Shopify nigdy do niego nie przekierowuje. Pozostaw Use legacy install flow odznaczone.
    • Scopes (3, w sekcji API access): wklej poniższą listę. To te same zakresy, o które prosi aplikacja z App Store, więc aplikacja niestandardowa dostaje wszystkie funkcje AmICited z wyjątkiem historii zamówień starszej niż 60 dni (zobacz niżej):
    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

    Pole Webhooks API version zostaw bez zmian.

    Formularz Create an app w Dev Dashboard z polami App name, adresami URL, Scopes i Webhooks API version

    Wolisz zaznaczać pola zamiast wklejać? Kliknij Select from list nad polem Scopes, wyszukaj każdy zakres z powyższej listy (1), zaznacz go i kliknij Done (2).

    Link Select from list nad polem Scopes
    Okno Select scopes z polem wyszukiwania i przyciskiem Done
  4. Utwórz aplikację

    Gdy nazwa, adres URL i zakresy są uzupełnione, kliknij Create app w prawym górnym rogu formularza (4 na zrzucie ekranu formularza powyżej). Shopify utworzy aplikację i opublikuje jej pierwszą wersję.

    Przycisk Create app w prawym górnym rogu formularza Create an app
  5. Sprawdź, czy wersja jest aktywna

    Otwórz Versions w menu aplikacji: pierwsza wersja jest oznaczona jako Active. Jeśli później zmienisz zakresy, kliknij Create version, aby zmiana zaczęła obowiązywać.

    Strona Versions w Dev Dashboard z pierwszą wersją oznaczoną jako Active
  6. Ustaw dystrybucję na niestandardową

    Aplikację niestandardową trzeba ograniczyć do własnego sklepu, zanim będzie można ją w nim zainstalować.

    1. W Overview aplikacji kliknij kartę Distribution (Manage custom install link). Shopify otworzy Partners Dashboard; jeśli pojawi się takie pytanie, wybierz konto, którego używasz dla sklepu.
    2. Zaznacz Custom distribution (1) i kliknij Select (2). Shopify nie pozwala później zmienić metody dystrybucji.
    3. W polu Store domain wpisz adres your-store.myshopify.com swojego sklepu (1; zobacz Znajdź adres swojego sklepu poniżej) i kliknij Generate link (2). Opcja Allow multi-store install for one Plus organization ma znaczenie tylko wtedy, gdy Twój sklep należy do organizacji Shopify Plus z kilkoma sklepami.
    Overview aplikacji w Dev Dashboard z kartą Distribution
    Wybór konta Shopify dla Partners Dashboard (rozmyty)
    Strona Distribution z opcją Custom distribution i przyciskiem Select
    Formularz Custom distribution z polem Store domain i przyciskiem Generate link
  7. Zainstaluj aplikację w sklepie

    Aplikacja nie może niczego odczytać, dopóki nie zostanie zainstalowana w sklepie.

    1. Otwórz Overview aplikacji w Dev Dashboard i kliknij Install app u góry karty Installs. W niektórych wersjach panelu ten przycisk nazywa się Test app, jak na zrzucie ekranu poniżej. Możesz też otworzyć menu ⋯ w wierszu aplikacji na liście Apps i wybrać Install app.
    2. Wybierz sklep, który chcesz podłączyć.
    3. Przejrzyj dostęp, o który prosi aplikacja, i kliknij Install.
    Overview aplikacji w Dev Dashboard z przyciskiem Test app w sekcji Installs
    Wybór sklepu Shopify, w którym ma zostać zainstalowana aplikacja
    Ekran Update data access w panelu Shopify z przyciskiem Install

    Ekran ostrzega, że „This app hasn’t been reviewed”. To normalne: to Twoja własna aplikacja, a nie aplikacja z App Store.

  8. Skopiuj Client ID i Client secret

    Otwórz Settings aplikacji w Dev Dashboard. W sekcji Credentials skopiuj Client ID i Client secret (użyj przycisków kopiowania obok każdego pola). Traktuj sekret jak hasło.

    Pozycja Settings aplikacji w menu Dev Dashboard
    Sekcja Credentials z Client ID (rozmazanym)
    Sekcja Credentials z Client secret

Aplikacje niestandardowe importują zamówienia z ostatnich 60 dni

Shopify udostępnia zamówienia starsze niż 60 dni tylko aplikacjom z zakresem read_all_orders, a Dev Dashboard odrzuca go w aplikacji niestandardowej („Contains invalid scopes: read_all_orders”). Dlatego połączenie przez aplikację niestandardową importuje zamówienia z ostatnich 60 dni i od tego momentu zaczynają się raporty Sklepu. Wycena importu może nadal proponować dłuższą historię, ale sam import kończy się na 60 dniach. Jeśli potrzebujesz pełnej historii zamówień, połącz sklep przez aplikację z App Store.

Połącz ją w AmICited#

  1. Znajdź adres swojego sklepu

    W panelu administracyjnym Shopify otwórz Settings. Adres sklepu (your-store.myshopify.com) jest widoczny pod nazwą sklepu u góry menu.

    Ustawienia panelu Shopify z adresem myshopify.com pod nazwą sklepu (rozmazanym)
  2. Otwórz okno Shopify

    Przejdź do Źródeł danych, w sekcji Eshops kliknij Connect Shopify Store, a następnie Use a custom app instead (1 na zrzucie ekranu poniżej).

  3. Wpisz sklep i poświadczenia

    Wpisz Store address, Client ID i Client secret (2), a następnie kliknij Connect store (3).

    Okno Shopify z opcją Use a custom app instead i polami Store address, Client ID i Client secret
  4. Wybierz domenę i potwierdź import

    Przypisz sklep do domeny i wybierz, ile historii zamówień zaimportować, tak samo jak przy instalacji z App Store. Każda opcja pokazuje przewidywaną liczbę wierszy i jednorazowy koszt, zanim potwierdzisz.

Następnie skonfiguruj dane klientów i ustawienia sklepu tak samo jak w przypadku każdego innego sklepu.

Czym różni się aplikacja niestandardowa#

Dlaczego linki nie są ponownie stosowane od razu po edycji produktu?

Aplikacje niestandardowe nie otrzymują webhooków Shopify, więc edycja produktu lub strony w Shopify nie powoduje, że link building od razu ponownie zastosuje swoje linki. Zostaną zastosowane przy następnym uruchomieniu reguły.

Co się stanie, jeśli aplikacja zostanie usunięta lub odinstalowana?

Połączenie przestaje działać w ciągu mniej więcej doby, a przestrzeń robocza otrzymuje powiadomienie. Aby połączyć się ponownie, otwórz to samo okno, wybierz Update credentials i wpisz aktualne Client ID i Client secret aplikacji.

Dlaczego import obejmuje tylko 60 dni wstecz?

Starsze zamówienia wymagają zakresu Shopify read_all_orders, a Dev Dashboard nie akceptuje go w aplikacji niestandardowej. Dlatego połączenie przez aplikację niestandardową importuje zamówienia z ostatnich 60 dni, a nowe zamówienia napływają od tego momentu na bieżąco. Jeśli potrzebujesz pełnej historii, użyj aplikacji z App Store.

Czy agencja może użyć jednej aplikacji dla wszystkich klientów?

Nie. Aplikacja musi należeć do tej samej organizacji Shopify co sklep, więc każdy klient tworzy własną aplikację.

Powiązane#