View a markdown version of this page

Erfassen Sie die Aktivitäten der Website-Besucher mit dem Webdaten-Tracker - Amazon Connect Connect-Kunde

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äten der Website-Besucher mit dem Webdaten-Tracker

Der Webdaten-Tracker erfasst, wie Besucher mit Ihrer Website interagieren — angeklickte Artikel, durchgeführte Suchanfragen, eingereichte Formulare. 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 Webbenachrichtigung zusammenarbeiten, finden Sie unterWeb-Daten-Tracker und Webbenachrichtigung.

Voraussetzungen

Schritt 1: Aktivieren Sie die Datenerfassung im Kommunikations-Widget

  1. Melden Sie sich auf der Connect Customer Admin-Website an.

  2. Wählen Sie im Navigationsmenü Kanäle und anschließend Kommunikations-Widgets aus.

  3. Erstelle ein neues Widget oder bearbeite ein vorhandenes. Weitere Informationen finden Sie unter Fügen Sie Ihrer von Connect Customer gehosteten Website eine Chat-Benutzeroberfläche hinzu.

  4. Aktivieren Sie die Datenerfassung, um das Clickstream-Tracking zu aktivieren.

  5. (Optional) Die Datenerfassungseinstellungen beinhalten eine Option für die erweiterte Datenerfassung. Aktivieren Sie diese Option, damit der Service automatisch Besucherinteraktionen mit HTML-Inhalten erfasst, was zu umfassenderen und genaueren prädiktiven Erkenntnissen führt.

  6. (Optional) Aktivieren Sie die Webbenachrichtigung, wenn Sie proaktive Benachrichtigungen von diesem Widget aus senden möchten. Weitere Informationen finden Sie unter Senden Sie Webbenachrichtigungen mit ausgehenden Connect Customer-Kampagnen.

  7. Fügen Sie die Website-Domains, in die das Widget eingebettet werden soll, zur Liste der zulässigen Domänen hinzu.

  8. Speichern Sie das Widget und kopieren Sie den Widget-Snippet-Code. Binden Sie dieses Snippet im nächsten Schritt auf Ihrer Website ein.

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, sobald 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();
Wichtig

Initialisieren Sie das Tracking erst, nachdem Sie die entsprechende Zustimmung des Besuchers gemäß Ihrer Datenschutzrichtlinie und den geltenden Vorschriften eingeholt haben.

Anmerkung

Bei einseitigen Anwendungen müssen Sie das Snippet einmal auf der obersten Seite einbetten. Binden Sie bei mehrseitigen Anwendungen das Snippet auf jeder Seite ein, auf der Sie Aktivitäten erfassen möchten.

Schritt 3: (Optional) Verfolgen Sie unternehmensspezifische Ereignisse

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

Wichtig

Wenn Sie planen, den Daten-Tracker mit Empfehlungen zu verwenden, die Artikelkontexte wie Find Similar Items und erfordernFrequently Paired Items, müssen Sie unternehmensspezifische Ereignisse verwenden und das Feld einbeziehen. item_id

Signatur der Methode

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

Parameter

Typ

Beschreibung

eventType

Zeichenfolge

Der Name des Geschäftsereignisses — ein reservierter Typ oder eine beliebige benutzerdefinierte Zeichenfolge.

eventPayload

object

Ereignisdaten, die mithilfe der folgenden Objektschemas strukturiert wurden.

Objektschemas

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

Objekt

Wichtige Felder

Beschreibung

item

item_id*, item_name*, quantity*, category, price, currency, impression_type, impression_id

Ein einzelnes Produkt oder ein einzelnes Objekt

item_list

Liste <item>

Reihe von Artikelobjekten (mindestens 1)

Einkaufswagen

cart_id*, item_list*, total_value, currency

Einkaufswagen

bestellen

order_id*, item_list*, total_value, currency, payment_method, shipping_address, discount

Eine abgeschlossene Bestellung

search

search_query*, total_matching_results, results_per_page, filter_expression, sort_criteria

Eine Suchaktion

Formular

form_id*, form_name, form_length, validation_errors, fields_completed

Eine Formularinteraktion

scrolle

depth_percentage, position_x, position_y

Scrollposition (mindestens ein Feld erforderlich)

event_value

number

Numerischer Wert, der die Wichtigkeit eines Ereignisses darstellt

* Pflichtfeld

Integrationsschritte und Anwendungsbeispiele

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

Beispiel — In den Warenkorb legen

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 ansehen

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:

Ereignistyp

Erforderliches Objekt

Beschreibung

add_to_cart

item

Verfolgt, wenn ein Besucher einen Artikel in seinen Einkaufswagen legt

purchase

order

Verfolgt einen abgeschlossenen Kauf

view_items

item_list

Verfolgt, wenn ein Besucher einen oder mehrere Artikel ansieht

Benutzerdefinierte Ereignisse

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

  • Der Dienst erzwingt keine strikte Überprüfung der Ereignisstruktur.

  • Sie können eine beliebige Kombination von Feldern aus den obigen Objektschemas verwenden, um Ihrem Anwendungsfall gerecht zu werden.

  • Verwenden Sie die Feldnamen genau wie abgebildet (z. cart_id B. nichtcartId).

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

Ordnen Sie Clickstream authentifizierten Benutzern zu

Die vom Web-Data-Tracker erfassten Clickstream-Daten werden kontinuierlich in Kundenprofile gestreamt und mit dem Profil des Besuchers verknüpft. In der folgenden Tabelle wird beschrieben, wie sich diese Zuordnung bei anonymen und authentifizierten Besuchern verhält.

Art des Besuchers

Verhalten bei der Profilassoziation

Anonymer Besucher

Wird nur anhand der Sitzungs-ID verfolgt. Verhaltensdaten werden erfasst, aber nicht mit einer bekannten Kundenidentität verknüpft. Es werden keine persönlich identifizierbaren Informationen gesammelt.

Authentifizierter Besucher

Wenn Sie bei der Initialisierung des Widgets eine authentifizierte Benutzer-ID übergeben, verknüpft der Service alle Clickstream-Aktivitäten mit dem bekannten Profil dieses Benutzers in den Kundenprofilen. Dies ermöglicht eine umfassendere Personalisierung und genauere Triggerbedingungen.

Verwenden Sie einen der folgenden Ansätze, um Tracking einem authentifizierten Benutzer zuzuordnen:

  • (Empfohlen) Verwenden Sie den CustomerId JWT-Anspruch — Wenn Sie die Sicherheit für Ihr Kommunikations-Widget aktiviert haben, geben Sie die authentifizierte Benutzer-ID in das CustomerId Feld Ihrer JSON-Web-Token-Ansprüche (JWT) ein. Dadurch wird die Clickstream-Aktivität mit dem Benutzerprofil verknüpft, ohne dass die ID im clientseitigen Code offengelegt wird. Einzelheiten zur Einrichtung finden Sie unter. Schritt 3: Bestätigen und Kopieren des Kommunikations-Widget-Codes und der Sicherheitsschlüssel

  • Benutzer-ID bei der Initialisierung übergeben — Wenn die Sicherheit für Ihr Widget nicht aktiviert ist, übergeben Sie bei der Initialisierung des Trackers die authentifizierte Benutzer-ID als Argument:

    await window.amazon_connect.Web.ClickStream.init('<authenticated-user-id>');
Wichtig

Wenn eine authentifizierte Benutzer-ID übergeben wird, wird sie über den Kontoschlüssel mit vorhandenen Profilen verknüpft. Da sich Datenverfolgungsereignisse im Laufe der Zeit häufen, sollten Sie Objektlimits für Objekte festlegen WebAnalytics-Clickstream und _webAnalytics verhindern, dass neue Ereignisse andere Objekttypen überschreiben, sobald das Limit für Profilobjekte erreicht ist. Hinweise zur Konfiguration finden Sie unter Datenlimits für Kundenprofile.

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 Zustimmung

Der Web-Daten-Tracker ist von Natur aus 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 Einreichen von Formularen nachverfolgt werden.

Wichtig

Sie sind dafür verantwortlich, vor der Initialisierung der Datenverfolgung die entsprechende Zustimmung der Besucher einzuholen, und zwar in Übereinstimmung mit Ihrer Datenschutzrichtlinie und den geltenden Bestimmungen wie der Allgemeinen Datenschutzverordnung (DSGVO) und dem California Consumer Privacy Act (CCPA).