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-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 rettigheder til at udvikle apps på Shopify-butikken.

Adgangskrav: Kun butiksindehavere eller personale med administratorrettigheder kan oprette appen (ikke via samarbejdsadgang). Hvis du opsætter på vegne af en kunde, skal du have personaleradgang eller få kortoplysningerne 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 åbnes, klik Go to Dev Dashboard.
    • Alternativt kan du åbne Dev Dashboard direkte efter login.

  5. Klik på Create App i Developer Dashboard.

  6. Indtast Clerk.io som appnavn.

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

  8. Under Embed App in Shopify Admin, fjern markeringen. Appen skal kun installeres én gang og skal ikke vises i Shopifys sidemenu.

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

Konfigurer scopes #

  1. Under Access scopes, giv 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

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

  2. Klik på Release nederst på skærmen.

Installer appen #

  1. Klik på Home, og klik derefter på Install app i øverste højre hjørne.

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

  3. På den følgende side gennemgår du en oversigt over appdetaljer og klikker på Install nederst til højre.

Tilslut til Clerk #

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

Markeder og lager #

Hvis du har flere Shopify-markeder, lokale eller lagersteder, bør du bekræfte følgende felter før synkronisering:

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

Disse værdier skal matche din Shopify markeds-/domæneopsætning. For fuld 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-variantattributter i Clerk.io inkluderer:

  • variant_inventory_policy (strengliste)
  • variant_inventory_tracking (boolean-liste)
  • variant_list_prices (nummer-liste)
  • variant_names (strengliste)
  • variant_option_size (strengliste)
  • variant_prices (nummer-liste)
  • variant_stocks (nummer-liste)
  • variant_weight (nummer-liste)
  • 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 via my.clerk.io > System status > Data sync.

Gå blot til inputfeltet kaldet Custom Attributes og indtast de produktattributter, du vil inkludere.

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

Synkronisér abonnenter #

Shopify understøtter administration af abonnenter direkte i platformen.

Disse kan nemt synkroniseres med Clerk.

Når det er aktiveret, importerer vi attributten “subscribed: true” for enhver emailadresse, der er abonneret 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 på Save og start en ny synkronisering.

Subscriber state configuration

Hvis du vil bruge et afmeldingslink for kunder, har hver kunde, der hentes fra Shopify backend, et unsub_url-attribut, som kan bruges i auto email-designs i feltet for afmelding: {{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 den app, du oprettede til Clerk i Developer Dashboard under Settings.

Legacy Custom App #

Fra januar 2026 tillader Shopify ikke længere oprettelse af brugerdefinerede apps direkte i Shopify admin for butikker. Eksisterende brugerdefinerede apps vil stadig fungere, men denne metode bør kun bruges, hvis du allerede har en brugerdefineret app opsat. Brug Developer Dashboard-metoden ( se ovenfor) til alle andre opsætninger.

Hvis du har en eksisterende brugerdefineret app og skal 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 brugerdefinerede 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 appudvikler og klik så Create app igen.

  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, vælg Læs og skriv (inkluderer write_customers), da Shopify kræver dette for adgang til kundens marketing-URL-felter (for eksempel for 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 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-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 standardbilledstørrelse hvis 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.