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

Opsæt Sync #

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

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

I Shopify #

Gennemfør disse trin i Shopifys Dev Dashboard. Se Shopifys aktuelle Dev Dashboard-appguide, hvis etiketterne æ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 appnavn, og klik på Create.

Konfigurer app #

  1. Gå til fanen Versions for den nye app.
  2. Under App URL indtaster du https://shopify.dev/apps/default-app-home. Appen giver kun API-adgang og behøver ikke et indlejret admin-interface.
  3. Under Webhooks API Version vælg den nyeste tilgængelige version.
  4. Tilføj adgangsomfangene fra følgende sektion.

Konfigurer scopes #

Start med nedenstående scopes. De giver Clerk.io mulighed for at importere katalog, ordrer, kunder, sider, markeder, lokationer og tilhørende data, der er nødvendige til Shopify-integrationen. Sæt denne liste ind i adgangsområdefeltet:

Udelad read_all_orders, når du opretter første version, for at undgå en “invalid scopes”-fejl. Du tilføjer det i en anden version, før appen installeres.

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 brug for skriveadgang? Clerk.io læser kun data, men Shopify kræver write_customers-scope for at få adgang til kunders marketing-URL-felter, som f.eks. customer.unsub_url.

Du kan også vælge scopes enkeltvis:

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

Klik Release for at frigive første version med disse scopes, og tilføj derefter adgang til alle ordrer nedenfor.

Tilføj alle ordrer #

Tilføj read_all_orders i en anden version, så Clerk.io kan importere butikkens fulde ordrehistorik.

  1. I Dev Dashboard, åbn appens Versions fane og klik på Create Version.
  2. Behold de eksisterende scopes og tilføj ,read_all_orders i slutningen af adgangsområdefeltet.
  3. Gem konfigurationen som en ny version.
  4. Klik Release nederst.
  5. Indtast eventuelt en versionsbesked som f.eks. Read all orders was added, og gennemfør frigivelsen.

Den fulde scopeliste for denne anden version er:

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

Installer app #

Installer den frigivne app på den Shopify-butik, 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 den ønskede adgang og klik på Install.

I Clerk.io #

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

Konfigurer sync #

  1. I Shopify Dev Dashboard, åbn Clerk.io-appens Settings og kopier Client ID og Client Secret, eller modtag dem gennem en godkendt sikker overlevering fra Shopifys butiksteam.
  2. I my.clerk.io, åbn den relevante Store og gå til Data > Configuration.
  3. Sæt Sync Method til Shopify.
  4. Indtast Shopify-butikkens 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 Save, derefter Start Sync.

Hold Client Secret privat. Del den kun via en godkendt sikker kanal, og aldrig i et offentligt dokument, support-ticket eller chat.

Kendt problem: Shopify kan fejle med at generere et token ved første sync, hvilket forårsager 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 driver flere Shopify-markeder, sprog eller lagerplaceringer, så bekræft disse felter før synkronisering:

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

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

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 (strengliste)
  • variant_inventory_tracking (boolsk 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 slået til, 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 med navnet Custom Attributes og indtast produktattributterne, der skal inkluderes.

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

Attributter skal altid angives med deres key.

Dette vil typisk være helt med små bogstaver. For eksempel bør attributten “Sizes” være “sizes”.

Du behøver ikke at medtage namespace – Clerk.io finder den automatisk ud fra key.

I Shopify finder du attributnøglerne under Settings > Custom data > Products/Variants.

Synkroniser abonnenter #

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

Disse kan let synkroniseres med Clerk.io.

Når det er aktiveret, vil vi importere attributten “subscribed: true” for enhver e-mailadresse, der er abonneret på 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 sync.

Hvis du vil bruge et afmeldingslink for kunder, har hver kunde, som hentes 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 support blev tilføjet. Du kan tjekke dette i den app, du oprettede til Clerk.io i Dev Dashboard under Settings.

Legacy Custom App #

Fra januar 2026 tillader Shopify ikke længere oprettelse af brugerdefinerede apps direkte i Shopify-administrationen for butikker. Eksisterende brugerdefinerede apps fortsætter med at fungere, men denne metode bør kun bruges, hvis du allerede har en custom app oprettet. For alle andre opsætninger, brug Udvikler Dashboard-metoden ovenfor.

Hvis du har en eksisterende custom app, og du 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-administrationen.

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

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

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

  4. Under Admin API access scopes, tildel 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 har vi brug for skriveadgang? Clerk.io 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_)

  5. Klik Save, derefter Install App → Install.

  6. Åbn API Credentials og kopier dit Shopify-domæne samt appens API-nøgle, 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 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.