Verbind Klaviyo Customer Hub met je headless Shopify-storefront. Schakel inloggen in, toon widgets (Favorieten, veelgestelde vragen) en gebruik actieve/recent bekeken productervaringen om betrokkenheid en conversie te verhogen.

Wat je leert

Je koppelt Klaviyo Customer Hub aan een headless Shopify-storefront, kiest een inlogmethode en publiceert de Hub zodat shoppers er sitebreed toegang toe hebben.

Klaviyo Customer Hub voor Shopify ondersteunt momenteel standaard storefronts en Shopify Headless. Voor WooCommerce ga je naar https://help.klaviyo.com/hc/es-es/articles/47792369863451

Voordat je van start gaat

Vereisten

  • Een headless Shopify-storefront met toegang tot de Storefront API (openbare toegangstoken/Storefront API openbare sleutel in Shopify’s Headless-beheerder).
  • Je Klaviyo-bedrijfs-ID (gebruikt door de onsite JavaScript-loader).
  • Beslissing over shopper-login: Shopify Customer Account API of Klaviyo One Time Password (OTP).
    • Als je bestaande account gebruikt, zorg dan dat je routes voor Inloggen, Uitloggen en (optioneel) Account beheren en Adressen beheren voor je webshop klaarstaan.
  • Mogelijkheid om je webshopcode te bewerken en wijzigingen te implementeren.
  • Een accountrol met toestemming om Klaviyo Customer Hub te bewerken, zoals eigenaar of Beheerder. Neem voor een aangepaste rol weergave- en bewerkingsmachtigingen voor Klaviyo Customer Hub op.
  • Een Klaviyo Customer Hub-proefperiode of een abonnement dat Favorieten en veelgestelde vragen bevat, als je deze functies wilt gebruiken.

Overzicht

Klaviyo Customer Hub is een sitebrede overlay waarmee shoppers sneller toegang krijgen tot accountacties en handige shoppingtools. Voor headless Shopify verbind je het onsite script van Klaviyo, kies je een inlogmethode (Shopify Customer Account API of Klaviyo OTP) en voeg je optioneel het volgende toe:

  • Actief product: toont het product dat een shopper bekijkt in de Hub.
  • Onlangs bekeken: toont onlangs bekeken producten met Klaviyo’s tracking.
  • Favorieten- en FAQ-widgets: worden weergegeven op productdetailpagina’s (PDP’s) en in de Hub.

Gebruik Klaviyo Customer Hub wanneer je een assistentielaag op de pagina wilt die productontdekking en sneller afrekenen stimuleert, waardoor conversie en levenslange waarde verbeteren.

Instelling

1. Configureer de instellingen van Klaviyo Customer Hub

Volg eerst Aan de slag met Klaviyo Customer Hub en rond de onboardingwizard af. Houd Klaviyo Customer Hub verborgen totdat je headless-configuratie klaar is. Ga daarna naar Klaviyo Customer Hub > Instellingen en zoek Headless Shopify-configuratie.

Zet headless Shopify-configuratie aan en plak je openbare Shopify-toegangstoken in openbare Storefront API-sleutel.

Selecteer onder Shopper login Shopify Customer Account API om je bestaande Shopify-login te gebruiken, of Klaviyo One Time Password (OTP) voor een login die alleen met Klaviyo werkt.

Als je Shopify Customer Account API selecteert, voer je de inlogroute en uitlogroute van je storefront in. Route voor account beheren en route voor adressen beheren zijn optioneel. Deze routes leiden shoppers om tussen de Hub en je site.

Als je Klaviyo One Time Password (OTP) selecteert, voer je Weergavenaam van winkel en Antwoord-e-mailadres in. Het antwoord-e-mailadres kan geen gmail.com- of klaviyo.com-adres zijn.

Klik op Opslaan om je instellingen op te slaan. Klik op Editor openen om de publicatiestatus van de Hub te controleren. Laat de status op Verborgen staan totdat je de winkelconfiguratie en -tests hieronder hebt afgerond.

2. Laad de Klaviyo Customer Hub-JavaScript (instructies voor ontwikkelaars)

Tip: Als je al Klaviyo-functies op je site gebruikt, heb je mogelijk al een loader ingesteld. Bevestig dit voordat je een tweede script toevoegt.

Maak /public/customerHub.js (of een equivalent) met de volgende loader (vervang COMPANY_ID door je Klaviyo openbare API-sleutel, ook wel je bedrijfs-ID genoemd):

javascript
// 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);

In je rootlayout (bijv. root.tsx), voeg de loader toe, zodat het onsite-script op elke pagina wordt geladen. Zoek naar het consolebericht "Klaviyo JS script loaded successfully."

typescript
// root.tsx
return (
  <html>
    <body>
      <script src="/customerHub.js" defer></script>
    </body>
  </html>
)

Nadat de Hub klaar is met laden, wordt window.customerHubApi beschikbaar. Het succesbericht van de loader bevestigt dat het script is geladen; wacht op de Hub API voordat je hydrateProduct aanroept, zoals hieronder wordt getoond.

3. Toon het actieve product in Klaviyo Customer Hub

Voeg het volgende script toe aan de HTML van je productpagina, waarbij je your-product-handle vervangt door de huidige Shopify-producthandle. Als je storefront React of een ander framework met client-side navigatie gebruikt, voer dan de hydration-call uit vanuit de paginalifecycle van dat framework telkens wanneer het product verandert.

html
<!-- 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>

Op desktop kan de Hub de huidige productkaart weergeven op het tabblad Chatten wanneer webchat is ingeschakeld. Deze kaart wordt niet weergegeven op mobiel.

4. Schakel recent bekeken producten in in Klaviyo Customer Hub

Implementeer Viewed Product -tracking op je productpagina's, zodat je deze meetwaarde in Klaviyo kunt gebruiken. Roep ook trackViewedItem aan om onlangs bekeken producten op te slaan in de browser van de shopper voor de Hub. Volg de trackingvoorbeelden in Integreer een e-commerceplatform zonder vooraf ontworpen Klaviyo-integratie.

5. Schakel account link takeover in

Wanneer Klaviyo Customer Hub Live is, kan het accountlinks die eindigen op /account of /account/login vervangen, zodat ze de Hub openen. Als je de Hub wilt openen vanuit een aangepast accountpictogram, stel je de link in op #k-hub. Voeg data-k-hub-ignore toe aan een accountlink als die je storefronts accountpagina steeds moet blijven openen.

6. Koppel Shopify Customer Account API-authenticatie (aanbevolen)

Voltooi deze stap alleen als je onder Inloggen voor shoppers Shopify Customer Account API hebt geselecteerd. Als je Klaviyo One Time Password (OTP) hebt geselecteerd, ga dan verder met stap 7.

Voeg een serverroute toe op /api/authenticateCustomerHub die POST-verzoeken accepteert en het toegangstoken van de ingelogde shopper doorgeeft aan Klaviyo. Stel COMPANY_ID in het voorbeeld in op je Klaviyo-bedrijfs-ID.

Het volgende voorbeeld maakt gebruik van het Hydrogen-framework van Shopify. Pas de serverroute aan op jouw framework als je een andere storefront gebruikt.

text
// ./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});
  }
}

Zodra deze route en de storefront-routes in de instellingen van Klaviyo zijn geconfigureerd, kan Klaviyo Customer Hub verbinding maken met je bestaande customer account login.

7. Voeg de Favorieten-widget toe (aanbevolen)

Favorieten en veelgestelde vragen kunnen in de lade van de Klaviyo Customer Hub worden weergegeven. Je kunt ze ook toevoegen aan productdetailpagina’s, zodat shoppers producten kunnen opslaan en antwoorden kunnen vinden tijdens het browsen.

Schakel eerst Favorieten in de Hub-editor in. Ga daarna naar Klaviyo Customer Hub > Ontwerp, selecteer Favorieten en kies welke shoppers de widget op de site kunnen zien. Klik op Publiceren om je widget-instellingen op te slaan en voeg vervolgens de volgende container toe aan je productpagina. Vervang de voorbeeld-Product-ID van Shopify door de ID van het huidige product.

typescript
// 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}
  />
)

Zodra Klaviyo Customer Hub live is en de widget zichtbaar is voor de shopper, kan die op een productpagina op Toevoegen aan favorieten klikken. Hun opgeslagen producten worden weergegeven in de favorietenervaring van de Hub.

8. Voeg FAQ-blokken toe (aanbevolen)

Maak je FAQ-blokken in Klaviyo. Selecteer in Klaviyo Customer Hub > Design FAQ, kies de vragen die je op productpagina's wilt weergeven en configureer de zichtbaarheid en het ontwerp op de site. Klik op Publiceren om je instellingen op te slaan voordat je de container hieronder toevoegt.

Voeg deze container toe aan je productpagina met de huidige Shopify product-ID. Dezelfde geselecteerde veelgestelde vragen worden op alle productpagina’s weergegeven; de product-ID selecteert geen verschillende vragen voor elk product.

typescript
// 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 geselecteerde FAQ-knoppen worden op productpagina’s weergegeven volgens je zichtbaarheidsinstellingen. Als je op een vraag klikt, wordt het antwoord geopend in Klaviyo Customer Hub.

9. Test en zet Klaviyo Customer Hub live

Test je storefront-code in staging voordat je die in productie uitrolt. De automatische account-linkovername en de onsite Favorites widget vereisen Live, dus neem ze op in je laatste live checks.

  1. Wanneer je klaar bent om te publiceren, ga je naar Klaviyo Customer Hub > Instellingen en klik je op Editor openen.
  2. Sla eventuele openstaande wijzigingen in het Hub-ontwerp op. Selecteer vervolgens Live in de statusdropdown, of klik op Live zetten wanneer de Hub verborgen is en er geen niet-opgeslagen wijzigingen zijn.
  3. Wacht op de bevestiging dat Klaviyo Customer Hub live is. Controleer in je productie-webshop inloggen en uitloggen, het account-icoon, de Chat-productkaart op desktop (als deze is ingeschakeld), recent bekeken producten en eventuele Favorieten- of FAQ-widgets die je hebt toegevoegd.

Best practices

  • Publiceer pas naar productie nadat je hebt getest om supportproblemen te helpen voorkomen. Houd de productiehub Verborgen totdat de configuratie klaar is en zet hem daarna Live vanuit de hub-editor.
  • Hydrateer het actieve product op PDP’s om de productcontext beschikbaar te houden in de Hub en shoppers te helpen het aan hun winkelwagen toe te voegen. Houd het conversiepercentage en de inkomsten per ontvanger (RPR) (percentage herhaalaankopen) in de gaten om het effect te beoordelen.
  • Implementeer product tracking vroeg om recent bekeken producten te vullen en browse-gebaseerde flows te ondersteunen. Houd betrokkenheid en omzet uit browse recovery in de gaten.
  • Voeg Favorieten toe zodat shoppers eenvoudig een shortlist kunnen opslaan. Houd herhaalbezoeken en activiteiten waarbij items aan de winkelwagen worden toegevoegd in de gaten.
  • Gebruik veelgestelde vragen om vragen over verzending, materialen of retouren te beantwoorden terwijl shoppers rondkijken. Houd drop-off en conversiepercentage in de gaten.
  • Gebruik server-side authenticatie met Shopify Customer Account API wanneer die beschikbaar is om de continuïteit voor ingelogde shoppers te behouden en het aantal supportverzoeken over inloggen te helpen verminderen.

Succes meten

Gebruik Analytics > Meetwaarden om de activiteit Product bekeken te monitoren. Bekijk de prestaties verderop in je flows en campagnes. Gebruik je e-commerceomzetdashboards om wijzigingen in conversie en gemiddelde bestelwaarde (AOV) bij te houden nadat je Klaviyo Customer Hub hebt ingeschakeld.

Houd het conversiepercentage vanaf productpagina’s, het percentage toegevoegd aan winkelwagen, sessies met Hub-openingen (als dit is geïmplementeerd), inkomsten per ontvanger (inkomsten per ontvanger) (RPR) en browse-gedreven inkomsten gekoppeld aan Viewed Product-events in de gaten.

Snelle checks

  • Bij een lage recent bekeken-activiteit controleer je de product tracking en kijk je of Viewed Product-gebeurtenissen aan profielen worden toegeschreven. Controleer ook browsergebaseerde recent bekeken tracking.
  • Bij een lage add-to-cart-activiteit vanuit de Hub controleer je of actieve producthydratie op elke PDP wordt uitgevoerd en of variaties en prijzen correct zijn.
  • Als je maar weinig Favorieten toevoegt, plaats je de Favorieten-slot dicht bij de call-to-actions op de belangrijkste productpagina en bevestig je dat data-product-id overeenkomt met het product.

Probleemoplossing

Symptoom: Klaviyo Customer Hub wordt niet op de site weergegeven.

Waarschijnlijke oorzaak: Script wordt niet geladen of Hub is Verborgen.

Oplossing: bevestig dat customerHub.js wordt geladen, dat de bedrijfs-ID is ingesteld en dat Klaviyo Customer Hub LIVE is. Ga naar Klaviyo Customer Hub > Instellingen > Editor openen en gebruik de statusdropdown om de status te wijzigen.

Symptoom: De console toont "Failed to load Klaviyo JS script."

Waarschijnlijke oorzaak: onjuiste script-URL of ontbrekende bedrijfs-ID.

Oplossing: Controleer https://static.klaviyo.com/onsite/js/<COMPANY_ID>/klaviyo.js en of COMPANY_ID is ingevuld.

Symptoom: de kaart voor actief product wordt niet weergegeven in de hub op PDP's.

Waarschijnlijke oorzaak: de hydration call ontbreekt, de product-handle is onjuist, of je bekijkt de Chat-productkaart op mobiel.

Oplossing: Open op desktop Chat met webchat ingeschakeld. Zorg dat de wachtlus wordt uitgevoerd en roep window.customerHubApi.hydrateProduct("<handle>") aan met de juiste product-handle.

Symptoom: sectie Recent bekeken is leeg.

Waarschijnlijke oorzaak: Ontbrekende of onvolledige producttracking.

Opgelost: Viewed Product-eventtracking en trackViewedItem browsertracking toevoegen. Verifieer events op een herkend profiel en controleer onlangs bekeken producten in dezelfde browser.

Symptoom: Favorieten- of FAQ-widgets worden niet weergegeven op de PDP.

Waarschijnlijke oorzaak: een ontbrekende container, een onjuiste product-ID, een verborgen widget of een abonnement dat de functie niet bevat.

Oplossing: voeg <div class="kl-hub-favorites-slot" data-product-id="..."></div> of <div class="klaviyo-faqs-slot" data-product-id="..."></div> toe met de juiste product-ID. Controleer toegang tot en zichtbaarheid van functies in Klaviyo en selecteer veelgestelde vragen voor productpagina's. Klaviyo Customer Hub moet ook Live zijn voordat de widget Favorieten wordt weergegeven.

Symptoom: Als je op het accountpictogram klikt, wordt de Hub niet geopend.

Waarschijnlijke oorzaak: de accountlink komt niet overeen met een ondersteunde account-URL, is uitgesloten van overname of Klaviyo Customer Hub is verborgen.

Oplossing: Stel Klaviyo Customer Hub in op Live, gebruik een accountlink die eindigt op /account of /account/login, of stel href="#k-hub" in. Verwijder data-k-hub-ignore alleen uit links die de Hub moeten openen.

Symptoom: met de Shopify Customer Account API geselecteerd, worden klanten in de Hub niet herkend als ingelogd.

Waarschijnlijke oorzaak: Ontbrekende /api/authenticateCustomerHub-route of mislukte API-aanvraag.

Oplossing: Implementeer het Hydrogen-voorbeeld (of het equivalent voor je framework), stuur access_token en company_id naar het login-eindpunt van Klaviyo en retourneer de response.

Veelgestelde vragen

Q: Moet ik de Shopify Customer Account API gebruiken voor inloggen?

A: Nee. In plaats daarvan kun je het eenmalige wachtwoord van Klaviyo (OTP, One Time Password) gebruiken. Als je al Shopify-accounts gebruikt, maak dan verbinding via de Shopify Customer Account API voor een naadloze ervaring.

V: Welke storefront-routes moet ik aanleveren?

A: Geef voor de Shopify Customer Account API de inlogroute en uitlogroute op. route voor account beheren en route voor adressen beheren zijn optioneel voor diepere links.

V: Waar vind ik de openbare storefront-API-sleutel?

A: Gebruik het openbare toegangstoken voor je webshop in Shopify’s Headless-kanaal. Volg Shopify’s installatiehandleiding voor Storefront API en voer vervolgens het openbare token in het veld Openbare sleutel Storefront API van Klaviyo in.

V: Kan Klaviyo Customer Hub mijn accountpictogram overnemen?

A: Ja. Wanneer Klaviyo Customer Hub live is, kunnen links die eindigen op /account of /account/login de Hub automatisch openen. Je kunt je accountlink ook verwijzen naar #k-hub.

V: Is Shopify Hydrogen vereist?

A: Nee. In het authenticatievoorbeeld wordt Hydrogen gebruikt, maar elk framework kan een serverroute implementeren op /api/authenticateCustomerHub die het access token en company_id naar Klaviyo post.

V: Kunnen favorieten en veelgestelde vragen op productdetailpagina’s (PDP’s) en in de Hub staan?

A: Ja. Configureer Favorieten en veelgestelde vragen in Klaviyo en voeg daarna hun container-divs toe aan je productpagina’s. Hun zichtbaarheid in de Hub en op productpagina’s volgt de instellingen die je kiest.

Was dit artikel nuttig?
Gebruik dit formulier alleen voor feedback op artikelen. Meer informatie over hoe je contact opneemt met support.

Ontdek meer van Klaviyo

Community
Maak contact met collega's, partners en Klaviyo-experts om inspiratie op te doen, inzichten te delen en antwoorden te krijgen op al je vragen.
Partners
Huur een Klaviyo-gecertificeerde expert in om je te helpen met een specifieke taak of voor doorlopend marketingbeheer.
Support

Krijg ondersteuning via je account.

E-mailsupport (gratis proefperiodes en betaalde accounts) 24/7 beschikbaar

Chat-/virtuele assistentie
Beschikbaarheid varieert per locatie en type abonnement