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.io. Denne guide dækker oprettelse af en app i Shopifys Dev Dashboard, tilpasning af produktdata og synkronisering af abonnentoplysninger.

Opsæt Sync #

Opsætningen har to dele: opret og installer en app i Shopify, og indtast derefter dens legitimationsoplysninger i my.clerk.io. Fuldfør begge dele, før du starter den første sync.

Før du opsætter synkroniseringen, skal du sikre dig, at du har butikkens nuværende .myshopify.com-domæne. Følg Shopify domænetrinene om nødvendigt.

I Shopify #

Gennemfør disse trin i Shopifys Dev Dashboard. Se Shopifys aktuelle Dev Dashboard app guide, hvis etiketter ændres.

Opret app #

  1. Åbn Shopify Dev Dashboard og log ind.
  2. I venstremenuen, åbn Apps og klik på Create app.
  3. Vælg Start from Dev Dashboard, indtast Clerk.io som app-navn, og klik på Create.

Konfigurér app #

  1. Åbn fanen Versions for den nye app.
  2. I App URL, indtast https://shopify.dev/apps/default-app-home. Appen giver kun API-adgang og har ikke brug for et indlejret admin interface.
  3. I Webhooks API Version, vælg den nyeste tilgængelige version.
  4. Tilføj adgangsområderne (scopes) angivet i næste sektion.

Konfigurer scopes #

Giv adgang til nedenstående scopes. De gør det muligt for Clerk.io at importere katalog, ordrer, kunder, sider, markeder, lokationer og relaterede data, som kræves for Shopify-integrationen. Du kan indsætte hele listen i adgangsfeltet:

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 kræves skriveadgang? Clerk.io læser kun data, men Shopify kræver scope write_customers for at tilgå kundens marketing-URL-felter, såsom customer.unsub_url.

Du kan også vælge scopes 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_)

Gå tilbage til appens Versions-fane og klik på Release, efter du har tilføjet scopes.

Installer app #

Installer den udgivne app på Shopify-butikken, der skal synkroniseres med Clerk.io.

  1. I appen, åbn Home og klik på Install app.
  2. Vælg eller opret Shopify-butikken.
  3. Gennemse anmodet adgang og klik på Install.

I Clerk.io #

Gennemfør disse trin i my.clerk.io med legitimationsoplysninger fra Shopify. Butikkens team kan gøre dette direkte, eller sikkert dele legitimationsoplysningerne med en tredjepart, der konfigurerer Clerk.io sync.

Konfigurér sync #

  1. I Shopify Dev Dashboard, åbn Clerk.io-appens Settings og kopier Client ID og Client Secret, eller få dem via godkendt sikker overdragelse fra Shopify-butik-teamet.
  2. I my.clerk.io, åbn den relevante Store og gå til Data > Configuration.
  3. Sæt Sync Method til Shopify.
  4. Indtast Shopify-butikens nuværende .myshopify.com-domæne i Shopify Domain. Indtast ikke det offentlige brugerdefinerede domæne, https:// eller en sti.
  5. Indsæt Client ID og Client Secret i de tilsvarende felter.
  6. Klik på Save, og klik derefter på Start Sync.

Hold Client Secret privat. Del det kun via en godkendt sikker kanal, og tilføj det aldrig til et offentligt dokument, supportticket eller chat.

Kendt problem: Shopify kan fejle i at generere en token ved første sync, hvilket resulterer i en godkendelsesfejl. Dette er et kendt intermitterende problem i Shopify. Vent blot 1-2 minutter og prøv derefter at synkronisere igen.

Markeder og lager #

Hvis du driver flere Shopify-markeder, -sprog eller -lagerlokationer, bekræft disse felter før synkronisering:

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

Disse værdier skal matche din Shopify-markeds-/domæneopsætning. For en komplet felt-for-felt-afbildning, 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 (streng-liste)
  • variant_inventory_tracking (boolean-liste)
  • variant_list_prices (nummer-liste)
  • variant_names (streng-liste)
  • variant_option_size (streng-liste)
  • variant_prices (nummer-liste)
  • variant_stocks (nummer-liste)
  • variant_weight (nummer-liste)
  • variant_weight_unit (streng-liste)
  • variants (streng-liste, 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 inputfeltet kaldet Custom Attributes og indtast de produktattributter, du vil inkludere.

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

Add attributes

Attributter skal altid skrives ved brug af deres key.

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

Du behøver ikke inkludere namespace - Clerk.io 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

Synkronisering af abonnenter #

Shopify understøtter administration af abonnenter direkte på platformen.

Disse kan nemt synkroniseres med Clerk.io.

Når det er aktiveret, vil vi importere 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 sync.

Subscriber state configuration

Hvis du vil bruge et afmeldingslink for kunder, har hver kunde, der trækkes fra en Shopify-backend, et unsub_url-attribut, som kan bruges til auto-email-designs i afmeldingsfeltet: {{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 har oprettet til Clerk.io i Dev Dashboard under Settings.

Legacy Custom App #

Fra januar 2026 tillader Shopify ikke længere oprettelse af custom apps direkte i Shopify admin til butikker. Eksisterende custom apps fungerer stadig, men denne metode bør kun bruges, hvis du allerede har en custom app sat op. Til alle andre opsætninger skal du bruge Developer Dashboard-metoden ovenfor.

Hvis du har en eksisterende custom app og har behov 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, 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 den til Læs og skriv (inkluderer write_customers).

    Hvorfor kræves skriveadgang? Clerk.io læser kun data, men Shopify kræver scope write_customers for at få adgang til kundens marketing-URL-felter (fx for 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 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 og appens 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 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.