Sync Data

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.

Konfigurer datasynkronisering #

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 Developer Dashboard-tilladelser kan oprette appen (ikke via samarbejdsadgang). Hvis du opsætter for en kunde, skal du have medarbejderadgang eller app-legitimationsoplysninger fra dem.

Opret appen #

1. I Shopify skal du klikke 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, skal du i stedet klikke på Learn more.
   • I det nye vindue der åbnes, klik 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 tilføjes Shopifys standard-app-placeholder: 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 vises i side-menuen i Shopify.

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

Konfigurer scopes #

1. Under Access scopes skal du give adgang til følgende:

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

2. Nederst på siden 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, gennemgå opsummeringen af app-detaljer 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 ved at generere en 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 igen.

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.

Attributter skal altid skrives med deres key.

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

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

I Shopify kan du som regel finde disse nøgler ved at finde din attribut under Settings > Custom data > Products/Variants:

Synkroniser abonnenter #

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

Disse kan nemt synkroniseres med Clerk.

Når det er aktiveret, importerer vi attributten “subscribed: true” for enhver e-mailadresse, 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.

Hvis du ønsker at bruge et afmeldingslink til kunder, har hver kunde, der trækkes fra en Shopify-backend, en unsub_url-attribut, som kan bruges til auto email-designs i feltet for afmelding: {{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 den app, 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 virke, men denne metode skal 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 har brug for at 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. I Shopify, gå til Apps > App and sales channel settings og klik på Develop apps.

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

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

4. 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 at få adgang til kundernes marketing URL-felter (f.eks. for customer.unsub_url).

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

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

6. Åbn API Credentials og kopier dit Shopify-domæne samt appens API Key, Access Token og Secret Key.

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

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