Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erfassen Sie die Aktivität der Website-Besucher mit dem Web Data Tracker

Der Webdaten-Tracker erfasst, wie Besucher mit Ihrer Website interagieren — angeklickte Artikel, getätigte Suchanfragen, Absenden von Formularen. Er verknüpft diese Aktivität mit ihrem Profil in den Kundenprofilen. Der Tracker ist Teil des Kommunikations-Widgets und wird auf Widget-Ebene gesteuert. Eine Übersicht darüber, wie der Web-Daten-Tracker und die Web-Benachrichtigung zusammenarbeiten, finden Sie unterWeb-Daten-Tracker und Webbenachrichtigung.

Voraussetzungen

Schritt 1: Aktivieren Sie die Datenerfassung im Kommunikations-Widget

Schritt 2: Betten Sie das Widget ein und initialisieren Sie das Tracking

Betten Sie das Widget-Snippet in den HTML-Code Ihrer Website ein. Nachdem das Snippet geladen wurde, initialisieren Sie den Tracker, nachdem Sie die Zustimmung des Besuchers eingeholt haben.

// Start tracking visitor behavior (after obtaining consent)
await window.amazon_connect.Web.ClickStream.init();

// (Optional) Enable web notifications for this visitor
await window.amazon_connect.Web.Notification.init();

Schritt 3: (Optional) Verfolgen Sie unternehmensspezifische Ereignisse

Um benutzerdefinierte Geschäftsereignisse — wie Kaufabschlüsse, Aktionen zum Hinzufügen zum Warenkorb oder Produktansichten — zu erfassen, rufen Sie recordBusinessMetric von Ihrer Website JavaScript aus an, wenn das Ereignis eintritt.

Methode: Signatur

await amazon_connect.Web.ClickStream.recordBusinessMetric(eventType, eventPayload)

Objekt-Schemas

Das eventPayload unterstützt die folgenden Objekte. Verwenden Sie eine beliebige Kombination von Feldern, die Ihrem Anwendungsfall entspricht.

* Erforderliches Feld

Integrationsschritte und Anwendungsbeispiele

Fügen Sie nach dem Anruf amazon_connect.Web.ClickStream.init() recordBusinessMetric() Aufrufe in den Event-Handlern Ihrer Website hinzu (z. B. onclick).

Beispiel — Zum Einkaufswagen hinzufügen

await amazon_connect.Web.ClickStream.recordBusinessMetric('add_to_cart', {
    item: {
        item_id: 'prod-123',
        item_name: 'Wireless Headphones',
        price: 49.99,
        quantity: 1,
        currency: 'USD'
    }
});

Beispiel — Artikel anzeigen

await amazon_connect.Web.ClickStream.recordBusinessMetric('view_items', {
    item_list: [
        {
            item_id: 'item_10',
            quantity: 1,
            item_name: 'Premium Wireless Headphones',
            category: 'Electronics',
            price: 89.99,
            currency: 'USD'
        }
    ]
});

Reservierte Ereignistypen

Die folgenden Ereignistypen sind mit vordefinierten Schemas reserviert:

Benutzerdefinierte Ereignisse

Neben den reservierten Ereignistypen können Sie jede benutzerdefinierte Zeichenfolge für den Ereignistyp definieren (z. B. clear_cart oderwishlist_add). Für benutzerdefinierte Ereignisse:

await amazon_connect.Web.ClickStream.recordBusinessMetric('clear_cart', {
    cart_id: 'cart-123',
    item_list: [
        { item_id: 'p1', item_name: 'Widget', quantity: 1 }
    ]
});

Verknüpfen Sie Clickstream mit dem Kundenprofil

Die vom Web Data Tracker erfassten Clickstream-Daten werden kontinuierlich in Kundenprofile gestreamt. Wie Daten einem Profil zugeordnet werden, hängt davon ab, ob bei der Widget-Initialisierung Profilschlüssel bereitgestellt werden.

Verknüpfen Sie Webanalyse-Ereignisse mit vorhandenen Profilen

Um das Tracking mit einem bekannten Profil zu verknüpfen, geben Sie profileKeys in Ihren JWT-Ansprüchen an, zum Zeitpunkt der Verbindung nach einem vorhandenen Profil zu suchen und dieses zu verknüpfen. Der Dienst verwendet diese Schlüssel, um über die SearchProfiles API ein passendes Profil zu finden. Dazu muss die Sicherheit in Ihrem Kommunikations-Widget aktiviert sein. Einzelheiten zur Einrichtung finden Sie unterSchritt 3: Bestätigen und Kopieren des Kommunikations-Widget-Codes und der Sicherheitsschlüssel.

{
  "sub": "<widgetId>",
  "iat": 1234567890,
  "exp": 1234571490,
  "profileKeys": {
    "_email": "user@example.com",
    "_account": "ACCT-12345"
  },
  "profileKeysOperator": "OR"
}

Gruppieren von Ereignissen nach einem benutzerdefinierten Bezeichner

Wenn Sie keinen Link zu einem vorhandenen Profil erstellen müssen, sondern die Clickstream-Aktivitäten selbst gruppieren möchten, können Sie eine benutzerdefinierte Kennung angeben. Clickstream-Ereignisse mit derselben Kennung werden unter einem gemeinsamen _webAnalyticsUserId Profilschlüssel zusammengefasst.

Es gibt zwei Möglichkeiten, ihn bereitzustellen:

Was wird erfasst

Eine vollständige Liste der Aktivitäten, die der Tracker standardmäßig erfasst, finden Sie unterWas der Web-Daten-Tracker erfasst.

Datenschutz und Einwilligung

Der Web-Daten-Tracker ist standardmäßig aktiviert. Wenn Sie die Datenerfassung im Kommunikations-Widget nicht aktivieren, werden keine Clickstream-Daten erfasst. Formularfeldwerte, Passwörter und Zahlungsinformationen werden niemals automatisch erfasst, auch nicht, wenn Ereignisse beim Senden von Formularen nachverfolgt werden.