Shopify

Sync Data

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

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

Opsæt Sync #

For at synkronisere dine Shopify-butikdata 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 butiksejere eller medarbejdere med administratorrettigheder kan oprette appen (ikke via samarbejdsadgang). Den samme Shopify-bruger skal oprette og installere appen.

Opret appen #

  1. I Shopify, gå til Settings > Apps > Develop Apps.

  2. Klik på Build apps in Dev Dashboard.

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

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

  4. Indtast Clerk.io som appnavn.

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

  6. Under Embed App in Shopify Admin, fjern markeringen. Appen skal kun installeres én gang og behøver ikke fremgå i Shopifys sidemenu.

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

Konfigurer scopes #

  1. Under Access scopes, tildel adgang til nedenstående scopes. 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 har vi behov for skriveadgang? Clerk læser kun data, men Shopify kræver write_customers scope for at få adgang til kunders marketing URL-felter (for eksempel til 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 #

Vigtigt: Shopify-brugeren, der opretter appen, skal også installere den. Hvis en anden bruger forsøger at installere appen, vil Shopify ikke tillade installationen.

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

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

  3. På den følgende side, gennemgå appdetaljerne og klik på Install nederst til højre.

Tilslut til Clerk #

  1. Gå tilbage til Developer Dashboard og klik på Settings inden for 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 undlade at generere et token ved første synkronisering, hvilket forårsager en autentificeringsfejl. Dette er et kendt periodisk problem i Shopify. Vent blot 1-2 minutter og prøv at synkronisere igen.

Markets og lager #

Hvis du driver flere Shopify markets, locales eller lagerlokationer, skal du bekræfte disse felter inden synkronisering:

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

Disse værdier skal matche din Shopify market/domain opsætning. For en komplet felt-til-felt mapping, 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 inkluderer:

  • variant_inventory_policy (string list)
  • variant_inventory_tracking (boolean list)
  • variant_list_prices (number list)
  • variant_names (string list)
  • variant_option_size (string list)
  • variant_prices (number list)
  • variant_stocks (number list)
  • variant_weight (number list)
  • variant_weight_unit (string list)
  • variants (string list, variant IDs)

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 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 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

Synkroniser abonnenter #

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

Disse kan nemt synkroniseres med Clerk.

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

Dette kan derefter bruges til Auto-Email.

Gå blot til din my.clerk.io-butik, gå til 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, har hver kunde, der trækkes fra et Shopify-backend, en unsub_url-attribut, som kan bruges til auto email-design 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 kontrollere 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 fortsætter med at fungere, men denne metode bør kun bruges, hvis du allerede har opsat en custom app. For alle andre opsætninger, brug Developer Dashboard-metoden ovenfor.

Hvis du har en eksisterende custom app og har brug for at bruge eller ændre 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 Settings > Apps > Develop Apps.
Develop apps page

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

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

Permissions configuration

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

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

    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

    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_)
API access scopes

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

  2. Åbn API Credentials og kopier dit Shopify Domain 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 det bliver foreslået, 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.