Dokumentation

Integrationer

Shopify med en brugerdefineret app

Forbind en Shopify-butik til AmICited med din egen brugerdefinerede app fra Shopify Dev Dashboard i stedet for App Store-appen: scopes, Client ID og secret samt begrænsningerne.

Den sædvanlige måde at forbinde Shopify på er FlowHunt-appen fra Shopify App Store (se ecommerce-butikker). Hvis du ikke ønsker en offentlig app i din butik, eller din butikspolitik blokerer installationer fra App Store, kan du forbinde med en brugerdefineret app (custom app), som du selv opretter i Shopify Dev Dashboard.

Når den er forbundet, fungerer en brugerdefineret app på samme måde som en installation fra App Store: importtilbuddet, backfill af ordrer og produkter, Eshop-rapporterne, link building og CMS’et.

Ecommerce-integrationer er tilgængelige fra Pro-planen, og kun workspace-administratorer kan forbinde dem.

Før du starter#

  • Brug butikkens egen Shopify-organisation. Appen skal tilhøre den samme Shopify-organisation som butikken. Et bureau kan ikke bruge sin egen app på en kundes butik, så det er kunden, der skal oprette appen.
  • Kortbetaling. Workspaces, der faktureres via Shopify, kan ikke bruge en brugerdefineret app. Skift først planen til kortbetaling.
  • Shopify-tilladelser. Du skal kunne oprette apps i butikkens Dev Dashboard (butiksejeren eller en medarbejderkonto, der har tilladelse til at udvikle apps).

Opret appen i Shopify#

  1. Åbn appudvikling i Shopify-administrationen

    Klik i Shopify-administrationen på Settings, derefter Apps og så Develop apps, og klik på Build apps in Dev Dashboard. Du kan også gå direkte til Shopify Dev Dashboard og logge ind med den konto, der ejer butikken.

    Forsiden i Shopify-administrationen med Settings i menuen nederst til venstre
    Settings i Shopify-administrationen med Apps i menuen
    Apps-indstillinger i Shopify-administrationen med knappen Develop apps
    Siden for appudvikling med knappen Build apps in Dev Dashboard
  2. Opret appen

    Åbn Apps i Dev Dashboard, og klik på Create app. Hvis din organisation allerede har apps, skal du klikke på Create app øverst til højre og vælge Create app manually.

    Siden Apps i Shopify Dev Dashboard
    Linket Create app under Get API credentials i Dev Dashboard
  3. Udfyld appen og dens scopes

    • App name (1): et navn, du kan genkende, for eksempel “AmICited”.
    • App URL (2): https://app.flowhunt.io/. Fjern markeringen i Embed app in Shopify admin; appen har ikke sin egen skærm i Shopify.
    • Allowed redirection URL(s): lad feltet stå tomt. AmICited logger ind med appens Client ID og Client secret, så Shopify omdirigerer aldrig tilbage til den. Lad Use legacy install flow være umarkeret.
    • Scopes (3, under API access): indsæt denne liste. Det er de samme scopes, som App Store-appen beder om, så den brugerdefinerede app får alle AmICited-funktioner undtagen ordrehistorik, der er ældre end 60 dage (se nedenfor):
    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

    Lad Webhooks API version være, som den er.

    Formularen Create an app i Dev Dashboard med App name, URL'er, Scopes og Webhooks API version

    Vil du hellere sætte flueben end indsætte tekst? Klik på Select from list over feltet Scopes, søg efter hvert scope fra listen ovenfor (1), sæt flueben, og klik på Done (2).

    Linket Select from list over feltet Scopes
    Dialogen Select scopes med søgefeltet og knappen Done
  4. Opret appen

    Når navn, URL og scopes er udfyldt, skal du klikke på Create app øverst til højre i formularen (4 på skærmbilledet af formularen ovenfor). Shopify opretter appen og udgiver dens første version.

    Knappen Create app øverst til højre i formularen Create an app
  5. Kontrollér, at versionen er aktiv

    Åbn Versions i appens menu: Den første version er markeret som Active. Hvis du senere ændrer dine scopes, skal du klikke på Create version, så ændringen træder i kraft.

    Siden Versions i Dev Dashboard med den første version markeret som Active
  6. Indstil distributionen til brugerdefineret

    En brugerdefineret app skal begrænses til din egen butik, før den kan installeres der.

    1. Klik på kortet Distribution (Manage custom install link) i appens Overview. Shopify åbner Partners Dashboard; vælg den konto, du bruger til butikken, hvis du bliver spurgt.
    2. Vælg Custom distribution (1), og klik på Select (2). Shopify lader dig ikke ændre distributionsmetoden bagefter.
    3. Indtast din butiks your-store.myshopify.com-adresse under Store domain (1; se Find din butiksadresse nedenfor), og klik på Generate link (2). Allow multi-store install for one Plus organization har kun betydning, hvis din butik tilhører en Shopify Plus-organisation med flere butikker.
    Appens Overview i Dev Dashboard med kortet Distribution
    Shopifys kontovælger til Partners Dashboard (sløret)
    Siden Distribution med Custom distribution og knappen Select
    Formularen Custom distribution med feltet Store domain og knappen Generate link
  7. Installér appen i din butik

    Appen kan ikke læse noget, før den er installeret i butikken.

    1. Åbn appens Overview i Dev Dashboard, og klik på Install app øverst på kortet Installs. I nogle dashboards hedder knappen Test app, som på skærmbilledet nedenfor. Du kan også åbne menuen ⋯ på appens række i listen Apps og vælge Install app.
    2. Vælg den butik, du vil forbinde.
    3. Gennemgå den adgang, appen beder om, og klik på Install.
    Appens Overview i Dev Dashboard med knappen Test app under Installs
    Shopifys butiksvælger med den butik, appen skal installeres i
    Skærmen Update data access i Shopify-administrationen med knappen Install

    Skærmen advarer om, at “This app hasn’t been reviewed”. Det er forventet: Det er din egen app, ikke en app fra App Store.

  8. Kopiér Client ID og Client secret

    Åbn appens Settings i Dev Dashboard. Under Credentials kopierer du Client ID og Client secret (brug kopiknapperne ved siden af hvert felt). Behandl secret som en adgangskode.

    Appens punkt Settings i menuen i Dev Dashboard
    Afsnittet Credentials med Client ID (sløret)
    Afsnittet Credentials med Client secret

Brugerdefinerede apps importerer ordrer fra de seneste 60 dage

Shopify returnerer kun ordrer, der er ældre end 60 dage, til apps med scopet read_all_orders, og Dev Dashboard afviser det på en brugerdefineret app (“Contains invalid scopes: read_all_orders”). En forbindelse via en brugerdefineret app importerer derfor ordrer fra de seneste 60 dage, og Eshop-rapporterne starter der. Importtilbuddet kan stadig tilbyde en længere historik, men selve importen stopper ved 60 dage. Hvis du har brug for hele ordrehistorikken, skal du i stedet forbinde med App Store-appen.

Forbind den i AmICited#

  1. Find din butiksadresse

    Åbn Settings i Shopify-administrationen. Butiksadressen (your-store.myshopify.com) vises under butiksnavnet øverst i menuen.

    Settings i Shopify-administrationen med myshopify.com-adressen under butiksnavnet (sløret)
  2. Åbn Shopify-dialogen

    Gå til Data Sources, klik under Eshops på Connect Shopify Store, og klik derefter på Use a custom app instead (1 på skærmbilledet nedenfor).

  3. Indtast butik og legitimationsoplysninger

    Indtast Store address, Client ID og Client secret (2), og klik derefter på Connect store (3).

    Shopify-dialogen med Use a custom app instead og felterne Store address, Client ID og Client secret
  4. Vælg domænet, og bekræft importen

    Knyt butikken til et domæne, og vælg, hvor meget ordrehistorik der skal importeres, på samme måde som ved en installation fra App Store. Hver mulighed viser det forventede antal rækker og engangsomkostningen, før du bekræfter.

Konfigurer derefter kundedata og butiksindstillinger på samme måde som for enhver anden butik.

Sådan adskiller en brugerdefineret app sig#

Hvorfor bliver links ikke anvendt igen, så snart jeg redigerer et produkt?

Brugerdefinerede apps modtager ikke Shopify-webhooks, så når du redigerer et produkt eller en side i Shopify, får det ikke link building til at anvende sine links igen med det samme. De anvendes igen, næste gang reglen kører.

Hvad sker der, hvis appen slettes eller afinstalleres?

Forbindelsen stopper inden for cirka en dag, og workspacet får en notifikation. For at genoprette forbindelsen skal du åbne den samme dialog, vælge Update credentials og indtaste appens aktuelle Client ID og Client secret.

Hvorfor går importen kun 60 dage tilbage?

Ældre ordrer kræver Shopifys scope read_all_orders, og Dev Dashboard accepterer det ikke på en brugerdefineret app. En forbindelse via en brugerdefineret app importerer derfor ordrer fra de seneste 60 dage, og nye ordrer kommer løbende ind derfra. Brug App Store-appen, hvis du vil have hele historikken.

Kan et bureau bruge én app til alle sine kunder?

Nej. Appen skal tilhøre den samme Shopify-organisation som butikken, så hver kunde opretter sin egen app.

Relateret#