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 vejledning dækker oprettelse af en app i Shopifys Developer Dashboard, tilpasning af produktdata og 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 tilladelse til at udvikle apps på Shopify-butikken.

Adgangskrav: Kun butiksindehavere eller personale med administratorrettigheder kan oprette appen (ikke via samarbejdsadgang). Hvis du opsætter for en kunde, skal du have personaleadgang eller appoplysninger fra dem.

Opret appen #

  1. I Shopify, klik på Settings.

  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, klik i stedet på Learn more.
    • I det nye vindue, der åbner, klik på Go to Dev Dashboard.
    • Alternativt kan du åbne Dev Dashboard direkte efter login.

  5. I Developer Dashboard, klik på Create App.

  6. Indtast Clerk.io som app-navn.

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

  8. Under Embed App in Shopify Admin, fjern fluebenet. Appen skal kun installeres én gang og behøver ikke vise i Shopify-side menuen.

  9. I Webhooks API Version, vælg den seneste version (mindst 2025-07).

Konfigurér scopes #

  1. Under Access scopes, giv adgang til scopes listet nedenfor. Du kan indsætte følgende streng direkte i inputfeltet 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
    Hvorfor skal vi bruge skriveadgang? Clerk læser kun data, men Shopify kræver write_customers-scopet for at få adgang til kunders marketing-URL felter (for eksempel for at synkronisere customer.unsub_url).

    Eller du kan vælge dem enkeltvis:

    • 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 klik 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 efterfølgende side, gennemse appdetaljer og klik 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, vælg 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 godkendelsesfejl. Dette er et kendt, midlertidigt problem hos Shopify. Vent blot 1-2 minutter og forsøg synkronisering igen.

Markeder og lager #

Hvis du kører flere Shopify-markeder, lokaliteter eller lagre, bekræft disse felter før synkronisering:

  • Shopify Market
  • Shopify Locale
  • Prefix URLs with Locale
  • Force Relative URLs
  • Lager-lokaliteter

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

Variantdata #

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

Typiske Shopify-variant-attributter i Clerk.io inkluderer:

  • variant_inventory_policy (strengliste)
  • variant_inventory_tracking (boolean-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, der er på lager.

Tilpasning af produktdata #

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

Gå blot til inputfeltet kaldet Custom Attributes og indtast de produktattributter, der skal inkluderes.

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

Add attributes

Attributter skal altid skrives med deres key.

Dette vil som regel være med små bogstaver. For eksempel skal attributten “Sizes” være “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 i Settings > Custom data > Products/Variants:

Custom data

Synkronisér abonnenter #

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

Disse kan nemt synkroniseres med Clerk.

Når aktiveret, vil vi importere attributten “subscribed: true” for enhver e-mailadresse, der abonnerer i Shopify.

Dette kan derefter bruges til Auto-Email.

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

Subscriber state configuration

Hvis du vil bruge et afmeldingslink for kunder, så har hver kunde, som hentes fra et Shopify-backend, en unsub_url-attribut, der kan bruges i auto email designs i unsubscribe-feltet: {{customer.unsub_url}}

Webhooks API-versionen skal være sat til mindst 2022-04, hvor denne understøttelse blev tilføjet. Du kan tjekke dette i appen, du oprettede 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 vil fortsat virke, men denne metode bør kun bruges, hvis du allerede har en custom app opsat. For alle andre opsætninger, brug Developer Dashboard-metoden ovenfor.

Hvis du har en eksisterende custom app og skal bruge eller modificere den, vælg 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. I Shopify, gå til Apps > App and sales channel settings og klik på Develop apps.
Develop apps page

  1. Klik på Create app, giv den navnet “Clerk.io”, vælg App-udvikler, og klik derefter på Create app igen.

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

Permissions configuration

  1. Under Admin API access scopes, giv Læs-adgang (scopes, der starter med read_) til følgende. For Customers, sæt det til Læs og skriv (inkluderer write_customers).

    Hvorfor skal vi bruge skriveadgang? Clerk læser kun data, men Shopify kræver write_customers-scopet for at få adgang til kunders marketing-URL felter (for eksempel for at synkronisere customer.unsub_url).

    Du kan indsætte følgende streng direkte i inputfeltet for at tilføje alle scopes på samme tid:

    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

    Eller du kan 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 kopier dit Shopify Domain og app’ens API-nøgle, 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 oplysninger i formularen. Vælg en standard billedstørrelse, hvis du bliver spurgt, 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.