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 unter[Web-Daten-Tracker und Webbenachrichtigung](customer-profiles-web-tracker-and-notification.md). ## Voraussetzungen + Eine Connect Customer-Instanz mit konfiguriertem Kommunikations-Widget. Weitere Informationen finden Sie unter [Fügen Sie Ihrer von Connect Customer gehosteten Website eine Chat-Benutzeroberfläche hinzu](add-chat-to-website.md). + Kundenprofile sind auf der Instanz aktiviert. Weitere Informationen finden Sie unter [Kundenprofile für Ihre Connect Customer-Instanz aktivieren](enable-customer-profiles.md). ## Schritt 1: Aktivieren Sie die Datenerfassung im Kommunikations-Widget 1. Melden Sie sich auf der Connect Customer Admin-Website an. 1. Wählen Sie im Navigationsmenü **Kanäle** und anschließend **Kommunikations-Widgets** aus. 1. 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](add-chat-to-website.md). 1. Aktivieren Sie die **Datenerfassung**, um das Clickstream-Tracking zu aktivieren. 1. (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. 1. (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](outbound-campaigns-web-notification.md). 1. Fügen Sie die Website-Domains, in die das Widget eingebettet werden soll, zur Liste der zulässigen Domänen hinzu. 1. 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 erfordern`Frequently 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 | 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` oder`wishlist_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. nicht`cartId`). ``` 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](add-chat-to-website.md#confirm-and-copy-chat-widget-script) + **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(''); ``` **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](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-data-limits.html). ## Was wird erfasst Eine vollständige Liste der Aktivitäten, die der Tracker standardmäßig erfasst, finden Sie unter[Was der Web-Daten-Tracker erfasst](customer-profiles-web-tracker-and-notification.md#web-tracker-what-is-captured). ## 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).