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 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 [Aktivieren Sie Kundenprofile für Ihre Connect Customer-Instanz](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 ** dann ** 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**. Wenn Sie diese Option aktivieren, erfasst der Service automatisch Besucherinteraktionen mit HTML-Inhalten, wodurch umfassendere und genauere prädiktive Erkenntnisse gewonnen werden.
1. (Optional) Aktivieren Sie die ** Web-Benachrichtigung, ** wenn Sie proaktive Benachrichtigungen von diesem Widget aus senden möchten. Weitere Informationen finden Sie unter [Senden Sie Webbenachrichtigungen mit ausgehenden Kampagnen von Connect Customer](outbound-campaigns-web-notification.md).
1. Fügen Sie die Website-Domains, in die das Widget eingebettet werden soll, zur Liste der zulässigen Domains 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, 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();
```
**Wichtig**
Initialisieren Sie das Tracking erst, nachdem Sie die entsprechende Zustimmung des Besuchers gemäß Ihrer Datenschutzrichtlinie und den geltenden Vorschriften eingeholt haben.
**Anmerkung**
Bei Anwendungen mit nur einer Seite betten Sie das Snippet einmal auf der obersten Seite ein. Bei mehrseitigen Anwendungen betten Sie das Snippet auf jeder Seite ein, auf der Sie Aktivitäten erfassen möchten.
## 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.
**Wichtig**
Wenn Sie den Data Tracker mit Empfehlungen verwenden möchten, die Artikelkontexte wie `Find Similar Items` und benötigen`Frequently Paired Items`, müssen Sie geschäftsspezifische Ereignisse verwenden und das Feld einbeziehen. `item_id`
### Methode: Signatur
```
await amazon_connect.Web.ClickStream.recordBusinessMetric(eventType, eventPayload)
```
| **Parameter** | **Typ** | **Beschreibung** |
| --- | --- | --- |
| `eventType` | Zeichenfolge | Der Name des Geschäftsereignisses — ein reservierter Typ oder eine benutzerdefinierte Zeichenfolge. |
| `eventPayload` | object | Eventdaten, die mithilfe der unten aufgeführten Objektschemas strukturiert sind. |
### Objekt-Schemas
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 Artikel |
| **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 |
| **Scrollen ** | `depth_percentage`, `position_x`, `position_y` | Scrollposition (mindestens ein Feld erforderlich) |
| **event\_value ** | number | Numerischer Wert, der die Wichtigkeit eines Ereignisses darstellt |
\* 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:
| **Ereignistyp** | **Erforderliches Objekt ** | **Beschreibung** |
| --- | --- | --- |
| `add_to_cart` | item | Verfolgt, wann ein Besucher einen Artikel in seinen Warenkorb legt |
| `purchase` | order | Verfolgt einen abgeschlossenen Kauf |
| `view_items` | item\_list | Verfolgt, wann ein Besucher ein oder mehrere Artikel ansieht |
### Benutzerdefinierte Ereignisse
Neben den reservierten Ereignistypen können Sie jede benutzerdefinierte Zeichenfolge für den Ereignistyp definieren (z. B. `clear_cart` oder`wishlist_add`). Für benutzerdefinierte Ereignisse:
+ Der Dienst erzwingt keine strenge Validierung der Eventstruktur.
+ Sie können eine beliebige Kombination von Feldern aus den obigen Objektschemas verwenden, um sie Ihrem Anwendungsfall anzupassen.
+ Verwenden Sie 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 }
]
});
```
## 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.
| **Art des Besuchers ** | **Verhalten bei der Profilzuordnung ** |
| --- | --- |
| Besucher ohne Profilschlüssel (anonym) | Wird von einer anonymen Kennung verfolgt, die in einem Browser-Cookie gespeichert ist und nach 7 Tagen abläuft. Während dieses Zeitraums werden Clickstream-Daten desselben Besuchers mit einem einzigen anonymen Profil verknüpft. Nach Ablauf des Cookies wird eine neue anonyme Kennung generiert und nachfolgende Aktivitäten werden unter einem neuen Profil verfolgt. Es werden keine persönlich identifizierbaren Informationen gesammelt.
Wenn bei der Widget-Initialisierung Profilschlüssel bereitgestellt werden, werden die Clickstream-Daten mit dem entsprechenden bekannten Profil und nicht mit dem anonymen Profil verknüpft. |
| Besucher mit Profilschlüsseln | Wenn Sie bei der Widget-Initialisierung Profilschlüssel übergeben, verknüpft der Dienst alle Clickstream-Aktivitäten mit dem bekannten Profil dieses Benutzers in den Kundenprofilen. Dies ermöglicht eine umfassendere Personalisierung und genauere Auslösebedingungen. |
### 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 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).
```
{
"sub": "",
"iat": 1234567890,
"exp": 1234571490,
"profileKeys": {
"_email": "user@example.com",
"_account": "ACCT-12345"
},
"profileKeysOperator": "OR"
}
```
+ `profileKeys`— Ein Schlüssel-Wert-Objekt, bei dem jeder Schlüssel eine durchsuchbare Kundenprofil-ID ist (z. B., `_email``_phone`,`_account`) und der Wert der Suchwert ist.
+ `profileKeysOperator`(optional) — `"AND"` oder `"OR"` (Standard:). `"OR"` Legt fest, ob das Profil allen Schlüsseln oder einem beliebigen Schlüssel entsprechen muss.
+ Wenn genau ein Profil gefunden wird, wird es der Sitzung zugeordnet.
+ Wenn kein Profil gefunden wird, läuft die Sitzung anonym ab (ein neues Profil kann später erstellt werden).
+ Wenn mehrere Profile gefunden werden, wird ein Fehler `window.amazon_connect.Web.ClickStream.init()` zurückgegeben. Überarbeiten Sie Ihre Schlüsselauswahl, um die Einzigartigkeit sicherzustellen.
**Legen Sie Grenzwerte für die Anzahl der Objekte fest, um Probleme mit der Räumung zu vermeiden**
Wenn Sie eine Verknüpfung mit einem vorhandenen Profil herstellen, empfehlen wir, die `_webAnalytics` Objekttypen ein `WebAnalytics-Clickstream` - und `MaxProfileObjectCount` auszuschalten. Diese Data-Tracker-Ereignisobjekte häufen sich im Laufe der Zeit an. Ohne diese Einstellung berücksichtigt der Service nicht, dass sie entfernt werden, wenn ein Profil sein Objektlimit erreicht. Weitere Informationen zu Datenlimits finden Sie unter Datenlimits für [ Kundenprofile. ](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-data-limits.html)
### 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:
+ **Über JWT-Ansprüche ** — Legen Sie das `customerId` Feld in Ihren JWT-Ansprüchen fest (erfordert aktivierte Sicherheit).
+ **Per Initialisierung ** — Übergeben Sie den Bezeichner als Argument, wenn Sie den Tracker initialisieren:
```
// Pass the custom user id as a positional string argument.
await window.amazon_connect.Web.ClickStream.init('');
```
**Anmerkung**
Wenn auch angegeben und in ein vorhandenes Profil aufgelöst `profileKeys` werden, verwendet die Profilauflösung dieses Ergebnis und überspringt diese benutzerdefinierte Kennung.
## 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 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.
**Wichtig**
Gemäß Ihrer Datenschutzrichtlinie und den geltenden Vorschriften wie der Allgemeinen Datenschutzverordnung (GDPR) und dem California Consumer Privacy Act (CCPA) sind Sie dafür verantwortlich, vor der Initialisierung der Datenverfolgung die entsprechende Zustimmung der Besucher einzuholen.