Shopify

Sync Data

Lær, hvordan du synkroniserer og tilpasser data fra din Shopify-butik

Synkronisér dine Shopify-produkter, meta-felter og abonnenter til Clerk. Denne guide dækker oprettelse af en app i Shopifys Developer Dashboard, tilpasning af produktdata samt synkronisering af abonnentoplysninger.

Opsæt Sync #

For at synkronisere dine Shopify-butiksdata med Clerk, skal du oprette en app i Shopifys Developer Dashboard og konfigurere den i Clerk. Brugeren, der opsætter synkroniseringen, skal have adgang til Developer Dashboard og tilladelser til at udvikle apps på Shopify-butikken.

Adgangskrav: Kun butiksindehavere eller medarbejdere med administratorrettigheder kan oprette appen (ikke via samarbejdsadgang). Hvis du sætter det op for en kunde, skal du have medarbejderadgang eller få appens legitimationsoplysninger fra dem.

Opret appen #

  1. Klik på Settings i Shopify.

  2. Klik på Apps and sales channels.

  3. Klik på Develop apps.

  4. Klik på Build apps in Dev Dashboard.

    • Hvis du ikke ser denne mulighed, skal du i stedet klikke på Learn more.
    • I det nye vindue, der åbner, skal du klikke på Go to Dev Dashboard.
    • Alternativt kan du åbne Dev Dashboard direkte efter login.

  5. I Developer Dashboard skal du klikke på Create App.

  6. Indtast Clerk.io som appnavn.

  7. I App URL skal du tilføje Shopifys standard app-pladsholder: https://shopify.dev/docs/apps/default-app-home

  8. Under Embed App in Shopify Admin skal du fjerne markeringen. Appen skal kun installeres én gang og behøver ikke at vises i Shopifys sidemenu.

  9. I Webhooks API Version skal du vælge den seneste version (mindst 2025-07).

Konfigurer scopes #

  1. Under Access scopes, giv adgang til nedenstående scopes. Du kan kopiere følgende streng direkte ind i indtastningsfeltet for at tilføje alle scopes på én gang:

    read_all_orders,read_customers,write_customers,read_inventory,read_locales,read_locations,read_markets,read_markets_home,read_metaobjects,read_online_store_pages,read_orders,read_products,read_publications,read_content,read_translations

    Du kan også vælge dem individuelt:

    • Customers (read_ og write_)
    • Inventory (read_)
    • Locales (read_)
    • Locations (read_)
    • Markets (read_)
    • Markets Home (read_)
    • Metaobjects (read_)
    • Online Store Pages (read_)
    • Orders (read_)
    • All Orders (read_)
    • Products (read_)
    • Publications (read_)
    • Store Content (read_)
    • Translations (read_)

  2. Nederst på skærmen skal du klikke på Release.

Installer appen #

  1. Klik på Home, og klik derefter på Install app øverst til højre.

  2. Shopify omdirigerer dig til en side, hvor du vælger den Shopify-butik, appen skal installeres på. Vælg din butik fra listen.

  3. På den følgende side skal du gennemgå sammendraget af appdetaljer og klikke på Install nederst til højre.

Forbind til Clerk #

  1. Gå tilbage til Developer Dashboard og klik på Settings i Clerk.io appen. Her finder du Client ID og Client Secret.

  2. Gå til my.clerk.io > Data > Configuration. Under Sync Method skal du vælge Shopify.

  3. Indsæt Client ID og Client Secret i formularen. Klik derefter på Start Sync.

Kendt problem: Shopify kan fejle i at generere et token ved første synkronisering, hvilket forårsager en autentificeringsfejl. Dette er et kendt intermitterende problem i Shopify. Vent blot 1-2 minutter og prøv at synkronisere igen.

Markets og lager #

Hvis du kører flere Shopify-markeder, sprog eller lagerplaceringer, skal du bekræfte disse felter før synkronisering:

  • Shopify Market
  • Shopify Locale
  • Prefix URLs with Locale
  • Force Relative URLs
  • Lagerplaceringer

Disse værdier skal matche din Shopify-markeds-/domæneopsætning. For en komplet felt-for-felt kortlægning, se Shopify integration settings.

Variantdata #

Shopify-variantdata kan opføre sig forskelligt afhængigt af indstillingen Import only stock variant data.

Typiske Shopify-variantattributter i Clerk.io omfatter:

  • variant_inventory_policy (strengliste)
  • variant_inventory_tracking (boolesk liste)
  • variant_list_prices (nummerliste)
  • variant_names (strengliste)
  • variant_option_size (strengliste)
  • variant_prices (nummerliste)
  • variant_stocks (nummerliste)
  • variant_weight (nummerliste)
  • variant_weight_unit (strengliste)
  • variants (strengliste, variant-ID’er)

Eksempel:

{
  "variant_inventory_policy": ["deny", "deny"],
  "variant_inventory_tracking": [true, true],
  "variant_list_prices": [240, 240],
  "variant_names": ["Xs", "M"],
  "variant_option_size": ["Xs", "M"],
  "variant_prices": [120, 120],
  "variant_stocks": [1, 7],
  "variant_weight": [0.4, 0.4],
  "variant_weight_unit": ["KILOGRAMS", "KILOGRAMS"],
  "variants": ["55970989179259", "55970989244795"]
}

Når Import only stock variant data er aktiveret, indeholder disse lister kun varianter på lager.

Tilpasning af produktdata #

I Shopify kan meta-felter og andre attributter, du opretter, synkroniseres via my.clerk.io > System status > Data sync.

Gå blot til input-feltet Custom Attributes og indtast de produktattributter, der skal medtages.

For at tilføje flere attributter, adskil dem med kommaer.

Add attributes

Attributter skal altid skrives med deres key.

Dette vil oftest være med små bogstaver. For eksempel skal attributten “Sizes” skrives “sizes”.

Du behøver ikke inkludere namespace - Clerk finder det automatisk baseret på key.

I Shopify kan du ofte finde disse keys ved at finde din attribut under Settings > Custom data > Products/Variants:

Custom data

Synkronisér abonnenter #

Shopify understøtter håndtering af abonnenter direkte i platformen.

Disse kan nemt synkroniseres med Clerk.

Når det er aktiveret, importerer vi attributten “subscribed: true” for enhver e-mailadresse, der er tilmeldt i Shopify.

Dette kan derefter bruges til Auto-Email.

Gå blot til din my.clerk.io-butik, vælg Data -> Configuration og indstil Include Subscriber State til Yes. Klik derefter Save og start en ny synkronisering.

Subscriber state configuration

Hvis du vil bruge et frameld-link til kunder, har hver kunde importeret fra Shopify-backend et unsub_url-attribut, som kan anvendes i Auto Email-designs i unsubscribe-feltet: {{customer.unsub_url}}

Webhooks API-versionen skal være sat til mindst 2022-04, hvor denne support blev tilføjet. Du kan tjekke dette i den app, du har oprettet til Clerk i Developer Dashboard under Settings.

Legacy Custom App #

Fra januar 2026 tillader Shopify ikke længere oprettelse af custom apps direkte i Shopify-admin for butikker. Eksisterende custom apps fortsætter med at virke, men denne metode bør kun benyttes, hvis du allerede har en custom app opsat. For alle andre opsætninger bruges Developer Dashboard-metoden ovenfor.

Hvis du har en eksisterende custom app og skal bruge eller ændre den, skal du vælge Shopify (Legacy Custom App) som Sync Method i my.clerk.io > Data > Configuration.

Disse trin gælder kun, hvis din Shopify-butik stadig har adgang til at oprette custom apps i Shopify-admin.

  1. Gå i Shopify til Apps > App and sales channel settings og klik på Develop apps.
Develop apps page

  1. Klik på Create app, navngiv den “Clerk.io”, vælg App developer og klik derefter igen på Create app.

  2. Klik på Configuration → Admin API integration → Configure.

Permissions configuration

  1. Under Admin API access scopes, giv Læseadgang (scopes der starter med read_) til følgende. For Customers, sæt den til Læs og skriv (inkluderer write_customers), da Shopify kræver det for adgang til kunde marketing-URL-felter (for eksempel til customer.unsub_url).

    Du kan kopiere følgende streng direkte ind i indtastningsfeltet for at tilføje alle scopes på én gang:

    read_all_orders,read_customers,write_customers,read_inventory,read_locales,read_locations,read_markets,read_markets_home,read_metaobjects,read_online_store_pages,read_orders,read_products,read_publications,read_content,read_translations

    Du kan også vælge dem individuelt:

    • Customers (read_ og write_)
    • Inventory (read_)
    • Locales (read_)
    • Locations (read_)
    • Markets (read_)
    • Markets Home (read_)
    • Metaobjects (read_)
    • Online Store Pages (read_)
    • Orders (read_)
    • All Orders (read_)
    • Products (read_)
    • Publications (read_)
    • Store Content (read_)
    • Translations (read_)
API access scopes

  1. Klik på Save, derefter Install App → Install.

  2. Åbn API Credentials og kopiér dit Shopify-domæne samt appens API Key, Access Token og Secret Key.

API credentials

  1. Gå til my.clerk.io > Data > Configuration. Under Sync Method, vælg Shopify (Legacy Custom App).

  2. Indsæt disse værdier i formularen. Vælg en standard billedstørrelse, hvis du bliver bedt om det, og klik derefter på Start Sync.

Denne side er oversat af en hjælpsom AI, og der kan derfor være sproglige fejl. Tak for forståelsen.