Så ställer du in Klaviyo Customer Hub med headless Shopify
Anslut Klaviyo Customer Hub till din headless Shopify-webbutik. Aktivera inloggning, visa widgetar (Favoriter, vanliga frågor) och driv produktupplevelser för Aktiva/Tidigare visade för att öka engagemang och konvertering.
Du kommer att lära dig
Du ansluter Klaviyo Customer Hub till en headless Shopify-butik, väljer en inloggningsmetod och publicerar Huben så att kunder kan komma åt den på hela webbplatsen.
Klaviyo Customer Hub för Shopify har för närvarande stöd för standardbutiker och Shopify Headless. För WooCommerce går du till https://help.klaviyo.com/hc/sv-se/articles/47792369863451
Innan du börjar
Förkrav
- En headless Shopify-butik med åtkomst till Storefront API (Public access token/Storefront API public key i Shopifys Headless Administratör).
- Ditt Klaviyo-företags-ID (används av JavaScript-inläsaren på webbplatsen).
- Beslut om inloggning för kunder: Shopify Customer Account API eller Klaviyo One Time Password (OTP).
- Om du använder befintliga Konto ska du ha din butiks vägar för Logga in, Logga ut och (valfritt) Hantera konto och Hantera adresser redo.
- Möjlighet att redigera din webbshopskod och driftsätta ändringar.
- En Konto med behörighet att redigera Klaviyo Customer Hub, till exempel Ägare eller Administratör. För en anpassad roll ska du inkludera visnings- och redigeringsbehörigheter för Klaviyo Customer Hub.
- En provperiod för Klaviyo Customer Hub eller en plan som inkluderar Favorites och FAQs, om du vill använda dessa funktioner.
Översikt
Klaviyo Customer Hub är ett överlägg på hela webbplatsen som ger kunder snabbare åtkomst till Konto-åtgärder och användbara shoppingverktyg. För headless Shopify ansluter du Klaviyos skript på plats, väljer en inloggningsmetod (Shopify Customer Konto API eller Klaviyo OTP) och kan vid behov lägga till:
- Aktiv produkt: visar produkten som en kund tittar på i hubben.
- Nyligen visade: listar nyligen visade produkter med hjälp av Klaviyos spårning.
- Widget för favoriter och vanliga frågor: återges på produktdetaljsidor (PDP:er) och i hubben.
Använd Klaviyo Customer Hub när du vill ha ett hjälplager på sidan som driver produktupptäckt och snabbare kassa, vilket förbättrar konvertering och livstidsvärde.
Konfiguration
1. Konfigurera inställningar för Klaviyo Customer Hub
Börja med att följa Komma igång med Klaviyo Customer Hub och slutför introduktionsguiden. Håll Klaviyo Customer Hub dolt tills din headless-konfiguration är klar. Gå sedan till Klaviyo Customer Hub > Inställningar och leta reda på Headless Shopify-konfiguration.

Aktivera Headless Shopify configuration och klistra in din offentliga åtkomsttoken för Shopify i Storefront API public key.
Under Shopper-inloggning väljer du Shopify Customer Konto API för att använda din befintliga Shopify-inloggning, eller Klaviyo One Time Password (OTP) för en inloggning som bara fungerar med Klaviyo.

Om du väljer Shopify Kund Konto API anger du din butiksfasads inloggningsrutt och utloggningsrutt. Hantera kontosökvägen och Hantera adresssökvägen är valfria. De här rutterna omdirigerar kunder mellan hubben och din webbplats.

Om du väljer Klaviyo One Time Password (OTP) anger du Butiksvisningsnamn och Svara till-e-post. ”Svara till”-e-postadressen kan inte använda en gmail.com- eller klaviyo.com-adress.
Klicka på Spara om du vill spara dina inställningar. Om du vill kontrollera Hubbens publiceringsstatus klickar du på Öppna redigerare. Behåll statusen Dold tills du är klar med konfigurationen av butiken och testningen nedan.

2. Läs in Klaviyo Customer Hub JavaScript (instruktioner för utvecklare)
Tips: Om du redan använder Klaviyos funktioner på webbplatsen kan du redan ha en loader på plats. Bekräfta innan du lägger till ett andra skript.
Skapa /public/customerHub.js (eller motsvarande) med följande inläsare (ersätt COMPANY_ID med din offentliga API-nyckel för Klaviyo, även känd som ditt företags-ID):
// customerHub.js
// TODO: Configuration
const COMPANY_ID = '';
const script = document.createElement('script');
script.src = `https://static.klaviyo.com/onsite/js/${COMPANY_ID}/klaviyo.js`;
script.async = true;
script.onload = () => { console.log('Klaviyo JS script loaded successfully'); };
script.onerror = () => { console.error('Failed to load Klaviyo JS script'); };
document.body.appendChild(script);I din rotlayout (t.ex. root.tsx), inkludera loadern så att onsite-skriptet läses in på varje sida. Leta efter konsolmeddelandet ”Klaviyo JS script loaded successfully.”
// root.tsx
return (
<html>
<body>
<script src="/customerHub.js" defer></script>
</body>
</html>
)När hubben har laddat klart blir window.customerHubApi tillgängligt. Inläsarens lyckat-meddelande bekräftar att skriptet har lästs in; vänta på Hub API innan du anropar hydrateProduct som visas nedan.
3. Visa den aktiva produkten i Klaviyo Customer Hub
Lägg till följande skript i HTML-koden för din produktsida och ersätt your-product-handle med den aktuella Shopify-produktens handle. Om din butik använder React eller ett annat ramverk med navigering på klientsidan ska du köra hydratiseringsanropet från ramverkets sidlivscykel när produkten ändras.

<!-- Product page HTML -->
<script type="text/javascript">
(function() {
function waitForCustomerHubApi() {
return new Promise((resolve) => {
const check = () => {
if (window.customerHubApi && window.customerHubApi.hydrateProduct) {
resolve();
} else {
requestAnimationFrame(check);
}
};
check();
});
}
waitForCustomerHubApi().then(() => {
window.customerHubApi.hydrateProduct("your-product-handle");
});
})();
</script>På dator kan Hubben visa det aktuella produktkortet på fliken Chatt när Webbchatt är aktiverat. Det här kortet visas inte på mobil.
4. Aktivera nyligen visade produkter i Klaviyo Customer Hub
Implementera spårning av Viewed Product på dina produktsidor så att du kan använda det här mättalet i Klaviyo. Anropa även trackViewedItem för att lagra nyligen visade produkter i kundens webbläsare för Hubben. Följ spårningsexemplen i Integrera en e-handelsplattform utan en färdigbyggd Klaviyo-integration.

5. Aktivera kapning av Konto-länk
När Klaviyo Customer Hub är live kan den ersätta kontolänkar som slutar på /account eller /account/login så att de öppnar hubben. För att öppna hubben från en anpassad kontoikon ställer du in länken till #k-hub. Lägg till data-k-hub-ignore i en kontolänk om den ska fortsätta att öppna din webbshops kontosida.

6. Anslut autentisering för Shopify Customer Konto API (rekommenderas)
Slutför bara det här steget om du valde Shopify Customer Konto API under Shopper login. Om du valde Klaviyo One Time Password (OTP) går du vidare till steg 7.
Lägg till en serverrutt på /api/authenticateCustomerHub som accepterar POST-förfrågningar och skickar den inloggade kundens åtkomsttoken till Klaviyo. Ange COMPANY_ID i exemplet som ditt företags-ID i Klaviyo.
Följande exempel använder Shopifys Hydrogen-ramverk. Anpassa serverrutten till ditt ramverk om du använder en annan butik.
// ./app/routes/api.authenticateCustomerHub.js
// TODO: Configuration
const COMPANY_ID = '';
export async function action({context}) {
// Pull the Customer Account API Client from your storefront's context
const {customerAccount} = context;
try {
// Get the access token for the current customer
const accessToken = await customerAccount.getAccessToken();
if (!accessToken) {
return new Response(JSON.stringify({message: 'User not logged in'}), {
status: 200,
});
}
// Send the access token to the Customer Hub API
const response = await fetch(
'https://atlas-app.services.klaviyo.com/api/onsite/headless-shopify-login',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
access_token: accessToken,
company_id: COMPANY_ID,
}),
},
);
const responseData = await response.text();
// Return the actual response from Customer Hub with the same status code
return new Response(responseData, {
status: response.status,
headers: {
'Content-Type':
response.headers.get('content-type') || 'application/json',
},
});
} catch (error) {
return new Response(null, {status: 500});
}
}När den här rutten och butiksrutterna i Klaviyo:s inställningar har konfigurerats kan Klaviyo Customer Hub ansluta till din befintliga inloggning för kundkonto.
7. Lägg till widgeten Favoriter (rekommenderas)
Favoriter och vanliga frågor kan visas i sidopanelen Klaviyo Customer Hub. Du kan också lägga till dem på produktdetaljsidor så att kunder kan spara produkter och hitta svar medan de surfar.
Aktivera Favoriter i Hub-redigeraren först. Gå sedan till Klaviyo Customer Hub > Design, välj Favoriter och välj vilka besökare som kan se widgeten på webbplatsen. Klicka på Publicera för att spara dina widgetinställningar och lägg sedan till följande container på din produktsida. Ersätt Shopify-produkt-ID:t i exemplet med den aktuella produktens ID.
// products.tsx
// Example identifiers:
// id: gid://shopify/Product/12345
// data-product-id: 12345
const gid = "gid://shopify/Product/12345";
const productId = gid.split('/').pop();
return (
<div
className="kl-hub-favorites-slot"
data-product-id={productId}
/>
)När Klaviyo Customer Hub är live och widgeten är synlig för kunden kan kunden klicka på Lägg till i favoriter på en produktsida. Deras sparade produkter visas i Hubens upplevelse Favoriter.

8. Lägg till FAQ-block (rekommenderas)
Skapa dina FAQ-block i Klaviyo. I Klaviyo Customer Hub > Design väljer du FAQ, väljer frågorna som ska visas på produktsidor och konfigurerar synlighet och design på webbplatsen. Klicka på Publicera för att spara dina inställningar innan du lägger till containern nedan.
Lägg till den här behållaren på din produktsida med det aktuella Shopify-produkt-ID:t. Samma valda vanliga frågor visas på alla produktsidor; produkt-ID:t väljer inte olika frågor för varje produkt.
// products.tsx
// Example:
const gid = "gid://shopify/Product/12345";
const productId = gid.split('/').pop();
return (
<div className="klaviyo-faqs-slot" data-product-id={productId} />
)De valda FAQ-knapparna visas på produktsidor enligt dina synlighetsinställningar. När du klickar på en fråga öppnas svaret i Klaviyo Customer Hub.
9. Testa och aktivera Klaviyo Customer Hub
Testa din webbshopskod i en stagingmiljö innan du distribuerar den till produktion. Automatisk kapning av länkar för Konton och onsite-widgeten Favoriter kräver Live, så inkludera dem i dina sista livekontroller.
- När du är redo att publicera går du till Klaviyo Customer Hub > Inställningar och klickar på Öppna redigeraren.
- Spara eventuella väntande designändringar i Hubben. Välj sedan Live i statusrullgardinsmenyn eller klicka på Gå live när Hubben är dold och inte har några osparade ändringar.
- Vänta på bekräftelsen att Klaviyo Customer Hub är live. I din produktionsbutik kontrollerar du inloggning och utloggning, Konto-ikonen, Chat-produktkortet för dator om det är aktiverat, nyligen visade produkter och eventuella widgetar för Favoriter eller vanliga frågor som du har lagt till.
Bästa praxis
- Publicera i produktion först efter testning för att undvika supportproblem. Håll Hubben i produktion Dold tills konfigurationen är klar och ställ sedan in den som Live i Hub-redigeraren.
- Berika den Aktiva produkten med data på PDP:er så att produktkontexten finns tillgänglig i Hubben och hjälper kunder att lägga den i varukorgen. Övervaka konverteringsfrekvens och intäkt per mottagare (intäkt per mottagare) för att bedöma effekten.
- Implementera produktspårning tidigt för att fylla i nyligen visade produkter och stödja bläddringsbaserade flöden. Övervaka engagemang och intäkter från återvinning efter bläddring.
- Lägg till Favoriter så att kunder enkelt kan spara en kortlista. Övervaka återkommande besök och lägg-till-i-varukorgen-aktivitet.
- Använd vanliga frågor för att svara på frågor om frakt, material eller returer medan kunderna tittar. Övervaka avhopp och konverteringsfrekvens.
- Använd autentisering på serversidan med Shopify Customer Konto API när det är tillgängligt för att bibehålla kontinuitet för inloggade kunder och bidra till att minska supportärenden som rör inloggning.
Mäta framgång
Använd Analytics > mättal för att övervaka aktiviteten Viewed Product. Granska efterföljande resultat i dina flöden och kampanjer. Använd dina instrumentpaneler för intäkter från e-handel för att spåra förändringar i konvertering och genomsnittligt beställningsvärde (genomsnittligt beställningsvärde) efter att du har aktiverat Klaviyo Customer Hub.
Följ konverteringsfrekvens från produktsidor, frekvensen för lägg i varukorg, sessioner med Hub-öppningar (om instrumenterat), intäkt per mottagare (intäkt per mottagare) och bläddringsdriven intäkt kopplad till Viewed Product-händelser.
Snabbkontroller
- Om du ser låg aktivitet för nyligen visade produkter: verifiera produktspårning och kontrollera att Viewed Product-händelser attribueras till profiler. Kontrollera också webbläsarbaserad spårning av nyligen visade produkter.
- Vid låg aktivitet för lägg till i varukorg från Hub kontrollerar du att Aktiv produktinläsning körs på varje PDP och att variationer och priser är korrekta.
- Om du har få Favoriter-tillägg placerar du Favoriter-platsen nära de huvudsakliga uppmaningarna på produktsidan och bekräftar att
data-product-idmatchar produkten.
Felsökning
Symtom: Klaviyo Customer Hub visas inte på webbplatsen.
Trolig orsak: Skriptet laddas inte eller så är hubben Dold.
Åtgärd: Bekräfta att customerHub.js läses in, att företags-ID:t är inställt och att Klaviyo Customer Hub är live. För att ändra status går du till Klaviyo Customer Hub > Inställningar > Öppna redigeraren och använder listrutan för status.
Symptom: Konsolen visar ”Det gick inte att läsa in Klaviyo JS-skript.”
Trolig orsak: Felaktig skript-URL eller saknat företags-ID.
Åtgärd: Verifiera https://static.klaviyo.com/onsite/js/<COMPANY_ID>/klaviyo.js och att COMPANY_ID är ifyllt.
Symptom: Produktkortet Aktiv visas inte i hubben på PDP:er.
Trolig orsak: Hydreringanropet saknas, produkthandtaget är fel eller så kontrollerar du chattens produktkort på mobilen.
Åtgärd: På dator öppnar du Chatt med Webbchatt aktiverat. Se till att vänteloopen körs och anropa window.customerHubApi.hydrateProduct("<handle>") med rätt produkt-handle.
Symptom: avsnittet Senast visade är tomt.
Trolig orsak: Saknad eller ofullständig produktspårning.
Åtgärd: Lägg till händelsespårning för Visa produkt och trackViewedItem webbläsarspårning. Verifiera händelser på en igenkänd profil och kontrollera nyligen visade produkter i samma webbläsare.
Symptom: Favorit- eller FAQ-widgetar återges inte på PDP.
Trolig orsak: En behållare saknas, felaktigt produkt-ID, dold widget eller en plan som inte inkluderar funktionen.
Åtgärd: Lägg till <div class="kl-hub-favorites-slot" data-product-id="..."></div> eller <div class="klaviyo-faqs-slot" data-product-id="..."></div> med rätt produkt-ID. Bekräfta åtkomst till och synlighet för funktionen i Klaviyo och välj vanliga frågor för produktsidor. Klaviyo Customer Hub måste också vara Live för att Favorites-widget ska visas.
Symptom: Om du klickar på Konto-ikonen öppnas inte Hubben.
Trolig orsak: Kontolänken matchar inte en Kontoadress som stöds, är exkluderad från övertagande eller så är Klaviyo Customer Hub dolt.
Åtgärd: Ställ in Klaviyo Customer Hub på Live, använd en Kontolänk som slutar på /account eller /account/login, eller ställ in href="#k-hub". Ta bort data-k-hub-ignore endast från länkar som ska öppna Hubben.
Symptom: När Shopify Customer Konto API har valts känns kunder inte igen som inloggade i Hubben.
Trolig orsak: Saknad /api/authenticateCustomerHub-rutt eller misslyckad API-begäran.
Åtgärd: Implementera Hydrogen-exemplet (eller motsvarande för ditt ramverk), skicka access_token och company_id till Klaviyos inloggningsslutpunkt och returnera svaret.
Vanliga frågor
Q: Måste jag använda Shopify Kundkonto-API för att logga in?
A: Nej. Du kan använda Klaviyo-engångslösenord (OTP) i stället. Om du redan använder Shopify-Konto kan du ansluta via Shopify Customer Konto API för en sömlös upplevelse.
F: Vilka storefront-rutter behöver jag ange?
A: För Shopify Customer Konto API anger du inloggningsrutt och utloggningsrutt. Rutt för att hantera konto och rutt för att hantera adresser är valfria för djupare länkning.
F: Var hittar jag den offentliga nyckeln för butiks-API?
A: Använd den offentliga åtkomsttoken för din webbshop i Shopifys Headless-kanal. Följ Shopifys guide för att konfigurera Storefront API och ange sedan den offentliga token i Klaviyos fält Storefront API public key.
F: Kan Klaviyo Customer Hub ta över min kontoikon?
S: Ja. När Klaviyo Customer Hub är live kan länkar som slutar på /account eller /account/login öppna hubben automatiskt. Du kan också peka din kontolänk till #k-hub.
F: Krävs Shopify Hydrogen?
S: Nej. Autentiseringsexemplet använder Hydrogen, men alla ramverk kan implementera en serverrutt på /api/authenticateCustomerHub som skickar åtkomsttoken och company_id till Klaviyo.
Q: Kan Favoriter och vanliga frågor visas på PDP:er och i Hubben?
S: Ja. Konfigurera Favoriter och vanliga frågor i Klaviyo och lägg sedan till deras container-divar på dina produktsidor. Deras synlighet i hubben och på produktsidorna följer de inställningar du väljer.