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

Opsæt Sync #

Opsætningen består af 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 synkronisering.

Hvis en tredjepart gennemfører opsætningen, skal du først følge Shopify adgangstrinene for at finde butikkens .myshopify.com-domæne og samarbejdskode.

Adgangskrav: Shopify-brugeren, der gennemfører app-opsætningen, skal have tilladelse til at udvikle apps og installere apps i butikken. Samarbejdspartner-adgang inkluderer ikke automatisk disse tilladelser. Hvis en tredjepart ikke kan gennemføre Shopify-trinene, kan butikkens team oprette og installere appen og derefter sikkert dele Client ID og Client Secret med den person, der konfigurerer synkroniseringen i my.clerk.io.

I Shopify #

Fuldfør disse trin i Shopifys Dev Dashboard. Se Shopifys aktuelle Dev Dashboard-app guide, hvis etiketterne ændres.

Opret app #

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

Konfigurer app #

  1. Åbn Versions fanen for den nye app.
  2. Under App URL skal du indtaste 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 senest tilgængelige version.
  4. Tilføj adgangsomfangene, der står i næste afsnit.

Konfigurer scopes #

Giv følgende scopes. De tillader Clerk.io at importere katalog, ordrer, kunder, sider, markeder, lokationer og relaterede data, der kræves til Shopify-integrationen. Du kan indsætte hele listen i access-scope-feltet:

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 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 fx 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 Release efter scopes er tilføjet.

Installer app #

Installer den frigivne app i Shopify-butikken, som skal synkronisere med Clerk.io.

  1. I appen, åbn Home og klik Install app.
  2. Vælg eller opret Shopify-butikken.
  3. Gennemgå de anmodede adgangsrettigheder og klik Install.

I Clerk.io #

Fuldfør disse trin i my.clerk.io med legitimationsoplysningerne fra Shopify. Butikkens team kan gøre det direkte eller sikkert dele credentials med en tredjepart, der konfigurerer Clerk.io synk.

Konfigurer synk #

  1. I Shopify Dev Dashboard, åbn Clerk.io-appens Settings og kopier Client ID og Client Secret, eller få dem via en godkendt sikker overlevering fra Shopify-butiksteamet.
  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 Save, og klik så Start Sync.

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

Kendt problem: Shopify kan fejle ved at generere et token ved første synk og give en godkendelsesfejl. Dette er et kendt periodisk problem i Shopify. Vent blot 1-2 minutter og prøv at synkronisere igen.

Markets og inventory #

Hvis du har flere Shopify-markeder, -locales eller lagerlokationer, skal du bekræfte disse felter før synkronisering:

  • Shopify Market
  • Shopify Locale
  • Prefix URLs with Locale
  • Force Relative URLs
  • Inventory locations

Disse værdier bør matche din Shopify marked/domæneopsætning. For en komplet felt-til-felt mapping, se Shopify integrationsindstillinger.

Variantdata #

Shopify variantdata kan opføre sig forskelligt afhængigt af indstillingen Import only stock variant data.

Typiske Shopify-variantattributter i Clerk.io omfatter:

  • variant_inventory_policy (strengliste)
  • variant_inventory_tracking (boolean-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-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, der er på lager.

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 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 normalt være helt med små bogstaver. For eksempel skal attributten “Sizes” være “sizes”.

Du behøver ikke inkludere namespace - Clerk.io finder det automatisk ud fra key.

I Shopify kan du ofte finde disse keys ved at finde din attribut under 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 emailadresse, der er tilmeldt i Shopify.

Dette kan derefter bruges til Auto-Email.

Gå blot til din my.clerk.io butik, så 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 hentes fra et Shopify-backend, en unsub_url-attribut, der kan bruges til auto email-designs i unsubscribe-feltet: {{customer.unsub_url}}

Webhooks API versionen skal være sat til mindst 2022-04, hvor denne understøttelse blev tilføjet. Du kan kontrollere 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 brugerdefinerede apps direkte i Shopify-admin for butikker. Eksisterende brugerdefinerede apps fortsætter med at fungere, men denne metode bør kun bruges, hvis du allerede har en brugerdefineret app sat op. Til alle andre opsætninger skal du bruge Developer Dashboard-metoden ovenfor.

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. I Shopify, gå til Settings > Apps > Develop Apps.
Develop apps page

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

  2. Klik 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 til Read and write (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 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 Save, derefter Install App → Install.

  2. Åbn API Credentials og kopier dit Shopify-domain og 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 du bliver bedt om det, og klik derefter Start Sync.

Denne side er oversat af en hjælpsom AI, og der kan derfor være sproglige fejl. Tak for forståelsen.