Verbinde Klaviyo Customer Hub mit deinem Headless-Shopify-Storefront. Login aktivieren, Widget anzeigen (Favoriten, FAQs) und aktive/kürzlich angesehene Produkterlebnisse ermöglichen, um Kundenengagement und Conversion zu steigern.

Übersicht

Du verbindest den Klaviyo Customer Hub mit einem Headless-Shopify-Storefront, wählst eine Anmeldemethode aus und veröffentlichst den Hub, damit Shopper*innen site‐wide darauf zugreifen können.

Der Klaviyo Customer Hub für Shopify unterstützt derzeit Standard-Storefronts und Shopify Headless. Für WooCommerce gehe zu https://help.klaviyo.com/hc/de-de/articles/47792369863451

Bevor du anfängst

Voraussetzungen

  • Ein Headless-Shopify-Storefront mit Zugriff auf die Storefront API (Public access token/Storefront API public key in Shopifys Headless Administrator).
  • Deine Klaviyo company ID (wird vom Onsite-JavaScript-Loader verwendet).
  • Entscheidung zum Shopper-Login: Shopify Customer Konto API oder Klaviyo One Time Password (OTP).
    • Wenn du vorhandene Konten verwendest, halte die Routen für Login, Logout und (optional) Konto verwalten und Adressen verwalten deines Shops bereit.
  • Möglichkeit, deinen Storefront-Code zu bearbeiten und Änderungen bereitzustellen.
  • Eine Kontorolle mit Berechtigung, Klaviyo Customer Hub zu bearbeiten, wie Kontoinhaber*innen oder Administrator*innen. Schließe für eine benutzerdefinierte Rolle Anzeige- und Bearbeitungsberechtigungen für Klaviyo Customer Hub ein.
  • Eine Testversion von Klaviyo Customer Hub oder ein Tarif, der Favoriten und FAQs enthält, wenn du diese Funktionen verwenden möchtest.

Übersicht

Klaviyo Customer Hub ist ein websiteweites Overlay, das Shopper*innen schnelleren Zugriff auf Kontoaktionen und hilfreiche Shopping-Tools bietet. Für Headless Shopify verbindest du das Onsite-Skript von Klaviyo, wählst eine Anmeldemethode (Shopify Customer Account API oder Klaviyo OTP) aus und fügst optional Folgendes hinzu:

  • Aktives Produkt: zeigt das Produkt, das sich Kund*innen im Hub ansehen.
  • Kürzlich angesehen: listet kürzlich angesehene Produkte mithilfe des Trackings von Klaviyo auf.
  • Favoriten- und FAQs-Widgets: werden auf Produktdetailseiten (PDPs) und im Hub gerendert.

Nutze den Klaviyo Customer Hub, wenn du eine On-Page-Unterstützungsebene möchtest, die die Produktentdeckung fördert und einen schnelleren Checkout ermöglicht und so Conversion und Lifetime Value verbessert.

Einrichten

1. Konfiguriere die Einstellungen für den Klaviyo Customer Hub

Folge zuerst Erste Schritte mit Klaviyo Customer Hub und schließe den Onboarding-Assistenten ab. Blende Klaviyo Customer Hub aus, bis dein Headless-Setup bereit ist. Gehe dann zu Klaviyo Customer Hub > Einstellungen und suche nach Headless-Shopify-Konfiguration.

Aktiviere Headless Shopify configuration und füge dein öffentliches Shopify-Zugriffstoken in Storefront API public key ein.

Wähle unter Shopper-Login Shopify Customer Account API aus, um deinen bestehenden Shopify-Login zu verwenden, oder Klaviyo One Time Password (OTP) für einen Login, der nur mit Klaviyo funktioniert.

Wenn du Shopify Customer Account API auswählst, gib die Anmelderoute und die Abmelderoute deines Storefronts ein. Route zur Kontoverwaltung und Route zur Adressverwaltung sind optional. Diese Routen leiten Kund*innen zwischen dem Hub und deiner Website weiter.

Wenn du Klaviyo One Time Password (OTP) auswählst, gib Anzeigename des Shops und Antwort-E-Mail ein. Die Antwort-E-Mail kann keine Adresse von gmail.com oder klaviyo.com verwenden.

Klicke auf Speichern, um deine Einstellungen zu speichern. Um den Veröffentlichungsstatus des Hubs zu prüfen, klicke auf Editor öffnen. Lass den Status Ausgeblendet, bis du das Storefront-Setup und die Tests unten abgeschlossen hast.

2. Lade das Klaviyo Customer Hub JavaScript (Anweisungen für Entwickler*innen)

Tipp: Wenn du Klaviyo-Funktionen vor Ort bereits nutzt, ist möglicherweise schon ein Loader eingerichtet. Bestätige, bevor du ein zweites Skript hinzufügst.

Erstelle /public/customerHub.js (oder eine gleichwertige Datei) mit dem folgenden Loader (ersetze COMPANY_ID durch deinen Klaviyo öffentlichen API-Schlüssel, auch als deine Company ID bekannt):

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

Füge in deinem Root-Layout (z. B. root.tsx) den Loader ein, damit das Onsite-Skript auf jeder Seite geladen wird. Suche nach der Konsolenmeldung „Klaviyo JS script loaded successfully.“

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

Nachdem das Hub vollständig geladen wurde, ist window.customerHubApi verfügbar. Die Erfolgsmeldung des Loaders bestätigt, dass das Skript geladen wurde; warte auf die Hub API, bevor du hydrateProduct wie unten gezeigt aufrufst.

3. Zeige das aktive Produkt im Klaviyo Customer Hub

Füge das folgende Skript zu deinem Produktseiten-HTML hinzu und ersetze your-product-handle durch den aktuellen Shopify-Produkthandle. Wenn dein Storefront React oder ein anderes Framework mit clientseitiger Navigation verwendet, führe den Hydration-Aufruf aus dem Seitenlebenszyklus dieses Frameworks aus, sobald sich das Produkt ändert.

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>

Auf dem Desktop kann der Hub im Tab Chat die aktuelle Produktkarte anzeigen, wenn Web-Chat aktiviert ist. Diese Karte wird auf Mobilgeräten nicht angezeigt.

4. Kürzlich angesehene Produkte im Klaviyo Customer Hub aktivieren

Implementiere das Viewed Product -Tracking auf deinen Produktseiten, damit du diese Metrik in Klaviyo verwenden kannst. Rufe außerdem trackViewedItem auf, um kürzlich angesehene Produkte im Browser der Käufer*in für den Hub zu speichern. Folge den Tracking-Beispielen in Integriere eine E-Commerce-Plattform ohne vorkonfigurierte Klaviyo-Integrationen.

5. Übernahme von Kontoverknüpfungen aktivieren

Wenn Klaviyo Customer Hub Live ist, kann es Kontolinks ersetzen, die auf /account oder /account/login enden, sodass sie den Hub öffnen. Um den Hub über ein benutzerdefiniertes Kontosymbol zu öffnen, setze den Link auf #k-hub. Füge data-k-hub-ignore zu einem Kontolink hinzu, wenn dadurch weiterhin die Kontoseite deines Storefronts geöffnet werden soll.

6. Shopify Customer Account API-Authentifizierung verbinden (empfohlen)

Führe diesen Schritt nur aus, wenn du unter Shopper-Login Shopify Customer Account API ausgewählt hast. Wenn du Klaviyo One Time Password (OTP) ausgewählt hast, springe zu Schritt 7.

Füge unter /api/authenticateCustomerHub eine Server-Route hinzu, die POST-Anfragen akzeptiert und Klaviyo das Zugriffstoken der angemeldeten Shopper*in übergibt. Lege im Beispiel COMPANY_ID auf deine Klaviyo-Unternehmens-ID fest.

Im folgenden Beispiel wird Shopifys Hydrogen-Framework verwendet. Passe die Server-Route an dein Framework an, wenn du ein anderes Storefront verwendest.

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});
  }
}

Sobald diese Route und die Storefront-Routen in den Einstellungen von Klaviyo konfiguriert sind, kann Klaviyo Customer Hub eine Verbindung zu deinem bestehenden Konto-Login herstellen.

7. Füge das Widget „Favoriten“ hinzu (empfohlen)

Favoriten und FAQs können in der Klaviyo Customer Hub-Schublade angezeigt werden. Du kannst sie auch zu Produktdetailseiten hinzufügen, damit Kund*innen Produkte speichern und beim Stöbern Antworten finden können.

Aktiviere zuerst „Favoriten“ im Hub-Editor. Gehe dann zu Klaviyo Customer Hub > Design, wähle Favoriten aus und entscheide, welche Shopper*innen das Widget auf der Website sehen können. Klicke auf Publish, um deine Widget-Einstellungen zu speichern, und füge dann den folgenden Container zu deiner Produktseite hinzu. Ersetze die Beispiel-Shopify-Produkt-ID durch die ID des aktuellen Produkts.

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

Sobald der Klaviyo Customer Hub Live ist und das Widget für Kund*innen sichtbar ist, können sie auf einer Produktseite auf Zu Favoriten hinzufügen klicken. Die gespeicherten Produkte werden im Favoriten-Erlebnis des Hubs angezeigt.

8. Füge FAQ-Blöcke hinzu (empfohlen)

Erstelle deine FAQ-Blöcke in Klaviyo. Wähle in Klaviyo Customer Hub > Design FAQ aus, wähle die Fragen aus, die auf Produktseiten angezeigt werden sollen, und konfiguriere die Sichtbarkeit und das Design auf der Website. Klicke auf Veröffentlichen, um deine Einstellungen zu speichern, bevor du den Container unten hinzufügst.

Füge diesen Container mit der aktuellen Shopify-Produkt-ID zu deiner Produktseite hinzu. Auf allen Produktseiten werden dieselben ausgewählten FAQs angezeigt; die Produkt-ID wählt nicht für jedes Produkt unterschiedliche Fragen aus.

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

Die ausgewählten FAQ-Schaltflächen werden auf Produktseiten entsprechend deinen Sichtbarkeitseinstellungen angezeigt. Wenn du auf eine Frage klickst, wird die zugehörige Antwort im Klaviyo Customer Hub geöffnet.

9. Klaviyo Customer Hub testen und live schalten

Teste deinen Storefront-Code in der Staging-Umgebung, bevor du ihn in der Produktionsumgebung bereitstellst. Die automatische Übernahme von Kontoverknüpfungen und das Onsite-Favoriten-Widget erfordern Live, also nimm sie in deine finalen Live-Prüfungen auf.

  1. Wenn du zum Veröffentlichen bereit bist, gehe zu Klaviyo Customer Hub > Einstellungen und klicke auf Editor öffnen.
  2. Speichere alle ausstehenden Hub-Designänderungen. Wähle dann im Status-Dropdown Live aus oder klicke auf Live schalten, wenn der Hub ausgeblendet ist und keine ungespeicherten Änderungen vorhanden sind.
  3. Warte auf die Bestätigung, dass Klaviyo Customer Hub live ist. Überprüfe in deinem Produktions-Storefront Login und Logout, das Konto-Symbol, die Chat-Produktkarte auf dem Desktop (falls aktiviert), kürzlich angesehene Produkte sowie alle Favoriten- oder FAQ-Widgets, die du hinzugefügt hast.

Best Practices

  • Veröffentliche erst nach dem Testen in der Produktion, um Support-Probleme zu vermeiden. Lass den Produktions-Hub Ausgeblendet, bis die Einrichtung bereit ist, und stelle ihn dann im Hub-Editor auf Live um.
  • Hydriere das aktive Produkt auf PDPs, damit der Produktkontext im Hub verfügbar bleibt und Käufer*innen es in den Warenkorb legen können. Überwache die Conversion-Rate und den Umsatz pro Empfänger (Wiederkaufrate), um die Wirkung zu bewerten.
  • Implementiere Produkt-Tracking frühzeitig, um zuletzt angesehene Produkte zu befüllen und browse-basierte Flows zu unterstützen. Überwache Kundenengagement und Umsatz aus der Browse-Recovery.
  • Füge Favoriten hinzu, damit Shopper*innen auf einfache Weise eine Auswahlliste speichern können. Überwache wiederholte Besuche und „In den Warenkorb“-Aktivität.
  • Nutze FAQs, um Fragen zu Versand, Materialien oder Rückgaben zu beantworten, während Käufer*innen stöbern. Überwache Absprünge und Conversion-Rate.
  • Nutze serverseitige Authentifizierung mit der Shopify Customer Account API, wenn verfügbar, um die Kontinuität für angemeldete Käufer*innen aufrechtzuerhalten und dabei zu helfen, loginbezogene Supportanfragen zu reduzieren.

Messen deiner Erfolge

Verwende Analytics > Metriken, um die Aktivität Produkt angesehen zu überwachen. Überprüfe die nachgelagerte Performance in deinen Flows und Kampagnen. Nutze deine E-Commerce-Umsatz-Dashboards, um Änderungen bei Conversion und durchschnittlichem Bestellwert (durchschnittlicher Bestellwert) nach der Aktivierung von Klaviyo Customer Hub zu verfolgen.

Behalte die Conversion-Rate von Produktseiten, die In-den-Warenkorb-Rate, Sitzungen mit Hub-Öffnungen (falls instrumentiert), den Umsatz pro Empfänger (RPR) und den browse-basierten Umsatz im Blick, der mit Viewed Product-Events verknüpft ist.

Schnellprüfungen

  • Wenn die Aktivität „Kürzlich angesehen“ niedrig ist, überprüfe das Produkt-Tracking, und prüfe, ob Ereignisse vom Typ „Viewed Product“ Profilen zugeordnet werden. Prüfe außerdem das browserbasierte Tracking für „Kürzlich angesehen“.
  • Bei geringer Add-to-Cart-Aktivität aus dem Hub überprüfe, dass die aktive Produkthydratisierung auf jeder PDP ausgeführt wird und dass Varianten und Preise korrekt sind.
  • Wenn nur wenige Favoriten hinzugefügt werden, platziere den Favoriten-Slot in der Nähe der wichtigsten Call-to-Actions auf der Produktseite und bestätige, dass data-product-id mit dem Produkt übereinstimmt.

Fehlerbehebung

Symptom: Der Klaviyo Customer Hub wird auf der Website nicht angezeigt.

Wahrscheinliche Ursache: Das Skript wird nicht geladen oder der Hub ist Ausgeblendet.

Fix: Bestätige, dass customerHub.js geladen wird, die Unternehmens-ID festgelegt ist und der Klaviyo Customer Hub LIVE ist. Um den Status zu ändern, gehe zu Klaviyo Customer Hub > Einstellungen > Editor öffnen und verwende das Status-Dropdown-Menü.

Symptom: Die Konsole zeigt „Klaviyo-JS-Skript konnte nicht geladen werden.“

Wahrscheinliche Ursache: Falsche Skript-URL oder fehlende Unternehmens-ID.

Fix: Prüfe https://static.klaviyo.com/onsite/js/<COMPANY_ID>/klaviyo.js und ob COMPANY_ID ausgefüllt ist.

Symptom: Die Karte „Aktives Produkt“ wird im Hub auf PDPs nicht angezeigt.

Wahrscheinliche Ursache: Der hydration call fehlt, der Produkt-Handle ist falsch oder du prüfst die Chat product card auf dem Mobilgerät.

Fix: Öffne auf dem Desktop Chat, wenn der Web-Chat aktiviert ist. Stelle sicher, dass die Warteschleife ausgeführt wird, und rufe window.customerHubApi.hydrateProduct("<handle>") mit dem korrekten Produkt-Handle auf.

Symptom: Der Abschnitt „Zuletzt angesehen“ ist leer.

Wahrscheinliche Ursache: Fehlendes oder unvollständiges Produkt-Tracking.

Fix: Tracking des Ereignisses „Produkt angesehen“ und trackViewedItem Browser-Tracking hinzufügen. Überprüfe Ereignisse in einem erkannten Profil und prüfe in demselben Browser die zuletzt angesehenen Produkte.

Symptom: Favoriten- oder FAQ-Widgets werden nicht auf PDP gerendert.

Wahrscheinliche Ursache: Ein fehlender Container, eine falsche Produkt-ID, ein ausgeblendetes Widget oder ein Plan, der die Funktion nicht enthält.

Korrektur: Füge <div class="kl-hub-favorites-slot" data-product-id="..."></div> oder <div class="klaviyo-faqs-slot" data-product-id="..."></div> mit der richtigen Produkt-ID hinzu. Bestätige den Zugriff auf Funktionen und die Sichtbarkeit in Klaviyo und wähle FAQs für Produktseiten aus. Klaviyo Customer Hub muss auch Live sein, damit das Favoriten-Widget angezeigt wird.

Symptom: Wenn du auf das Konto-Symbol klickst, wird der Hub nicht geöffnet.

Wahrscheinliche Ursache: Der Konto-Link stimmt nicht mit einer unterstützten Konto-URL überein, ist von der Übernahme ausgeschlossen oder Klaviyo Customer Hub ist ausgeblendet.

Behebung: Setze Klaviyo Customer Hub auf Live, verwende einen Konto-Link, der auf /account oder /account/login endet, oder lege href="#k-hub" fest. Entferne data-k-hub-ignore nur aus Links, die den Hub öffnen sollen.

Symptom: Wenn die Shopify Customer Account API ausgewählt ist, werden Shopper*innen im Hub nicht als angemeldet erkannt.

Wahrscheinliche Ursache: Fehlende /api/authenticateCustomerHub-Route oder fehlgeschlagene API-Anfrage.

Fix: Implementiere das Hydrogen-Beispiel (oder das entsprechende Äquivalent deines Frameworks), sende access_token und company_id an Klaviyos Login-Endpunkt und gib die Antwort zurück.

FAQ

Q: Muss ich für die Anmeldung die Shopify Customer Account API verwenden?

A: Nein. Du kannst stattdessen Klaviyo-Einmalpasswort (OTP) verwenden. Wenn du bereits Shopify-Konten verwendest, stelle über die Shopify Customer Account API eine Verbindung her, um ein nahtloses Erlebnis zu erhalten.

F: Welche Storefront-Routen muss ich angeben?

A: Für die Shopify Customer Account API gib Anmelderoute und Abmelderoute an. Konto verwalten-Route und Adressen verwalten-Route sind für eine tiefergehende Verlinkung optional.

F: Wo finde ich den öffentlichen Storefront-API-Schlüssel?

A: Verwende das öffentliche Zugriffstoken für deinen Storefront in Shopifys Headless-Kanal. Folge der Einrichtungsanleitung für Shopifys Storefront API und gib dann das öffentliche Token in das Feld Öffentlicher Storefront API-Schlüssel in Klaviyo ein.

F: Kann Klaviyo Customer Hub mein Kontosymbol übernehmen?

A: Ja. Wenn Klaviyo Customer Hub Live ist, können Links, die auf /account oder /account/login enden, den Hub automatisch öffnen. Du kannst deinen Konto-Link auch auf #k-hub verweisen.

F: Ist Shopify Hydrogen erforderlich?

A: Nein. Das Authentifizierungsbeispiel verwendet Hydrogen, aber jedes Framework kann eine Server-Route unter /api/authenticateCustomerHub implementieren, die das Zugriffstoken und die company_id an Klaviyo postet.

F: Können Favoriten und FAQs auf PDPs und im Hub angezeigt werden?

A: Ja. Konfiguriere Favoriten und FAQs in Klaviyo und füge dann ihre Container-divs zu deinen Produktseiten hinzu. Ihre Sichtbarkeit im Hub und auf Produktseiten richtet sich nach den Einstellungen, die du auswählst.

War dieser Artikel hilfreich?
Nutze dieses Formular nur für Feedback zu Artikeln. So kontaktierst du den Support.

Mehr von Klaviyo entdecken

Community
Vernetze dich mit Kolleg*innen, Partner*innen und Klaviyo-Expert*innen, um dich inspirieren zu lassen, Erkenntnisse auszutauschen und Antworten auf deine Fragen zu erhalten.
Partner
Beauftragen Sie einen Klaviyo-zertifizierten Experten, der Ihnen bei einer bestimmten Aufgabe hilft oder für das laufende Marketing-Management zuständig ist.
Support

Kontaktiere den Support über dein Konto.

Support per E-Mail (kostenlose Testversion und kostenpflichtige Konten) Verfügbar 24/7

Chat / virtuelle Unterstützung
Verfügbarkeit abhängig von Standort und Abonnementtyp