Mit Produkt Events können Sie nachvollziehen, wie Kontakte mit Ihren Produkten interagieren – zum Beispiel wenn sie einen Artikel ansehen, ihn in den Warenkorb legen oder einen Kauf abschließen. Diese Daten lassen sich anschließend in Automatisierungen, Segmenten und Statistiken nutzen, um das Kundenverhalten besser zu verstehen und die Kommunikation zu personalisieren.
In diesem Artikel erfahren Sie, wie Sie Produkt Events senden und welche Regeln Sie beachten müssen, damit die Daten korrekt gespeichert werden.
Weitere Informationen zu Produkt Events finden Sie im Artikel „Was ist ein Produkt Event".
Es gibt zwei Möglichkeiten, Produkt Events an User.com zu senden:
JavaScript SDK
REST API
Grundsätzlich ähnelt das Senden von Produkt Events dem Senden von Standard-Events. Es gibt jedoch einige Aspekte, auf die Sie achten sollten:
Verwenden Sie das Schlüsselwort product_event, wenn Sie ein Produkt Event senden.
Fügen Sie die erforderlichen Attribute hinzu: „product_id" und „event_type"
Die Angabe des Produktnamens ist optional. Wenn Sie ihn nicht angeben und das Produkt noch nicht existiert, wird das Produkt ohne Namen angelegt.
Die Liste der Event-Typen ist geschlossen. Sie können keine neuen hinzufügen. Verfügbare Optionen sind:
click
promo click
view
detail
liking
add to observation
reservation
add
add to cart
remove
checkout
checkout option
order
purchase
return
refund
Sie können Produktattribute einbinden, z. B. den „Produktnamen", die „Kategorie" oder beliebige weitere benutzerdefinierte Attribute, die Sie benötigen.
Stellen Sie vor dem Senden von Produkt Events sicher, dass die Produktattribute bereits in Ihrem Workspace vorhanden sind. Es ist wichtig, den gleichen Attributtyp beizubehalten.
User.com speichert keine historischen Werte von Produkt-Event-Attributen (mit Ausnahme von event_type). Jedes neue Produkt Event aktualisiert die aktuellen Attributwerte im Produktprofil. Das bedeutet, dass ältere Werte überschrieben werden.
Da Produktattribute stets den aktuellsten Wert widerspiegeln, können Sie keine Unterschiede zwischen Varianten innerhalb eines einzelnen Produkts nachverfolgen. Wenn Sie zwischen Varianten unterscheiden möchten (z. B. dieselben Schuhe in verschiedenen Größen), legen Sie für jede Variante ein separates Produkt an und weisen Sie jedem eine eindeutige product_id zu.
Damit Ihre Daten strukturiert und leicht handhabbar bleiben, empfiehlt es sich, Produktattribute anzulegen, bevor Sie sie an das System senden. So können Sie im Voraus den richtigen Datentyp (z. B. integer, boolean, date usw.) zuweisen.
Wenn ein Attribut gesendet wird, ohne vorab definiert zu sein, wird es automatisch als string angelegt. Dies kann die Genauigkeit der Filterung verringern und Ihre Segmentierungs- und Reporting-Möglichkeiten später einschränken.
Eine Übersicht der verfügbaren Attributtypen und Hinweise zur Auswahl der besten Option für Ihre Anforderungen finden Sie im folgenden Artikel.
REST-API-Endpunkte zum Senden eines Produkt Events:
Nachfolgend ein Beispiel für das Senden eines Produkt Events über die REST API:
curl -X POST
"https://<your_app_subdomain>.user.com/api/public/products-by-id/"
-H 'authorization: Token <your_64_char_api_key>'
-H 'content-type: application/json'
-d '{
"name": "my product",
"custom_id": "my_product_id",
"product_url": "https://myshop.com/products/my_product/",
"image_url": "https://myshop.com/media/products/myproduct.jpg"
}'Wenn Sie ein Produkt Event ohne Angabe eines Namens senden, prüft das System zuerst, ob bereits ein Produkt mit der angegebenen „product_id" existiert.
Wird kein passendes Produkt gefunden, wird mit dieser „product_id" ein neues Produkt angelegt – allerdings ohne Namen.
Sie können ein Produkt Event auch direkt aus HTML heraus auslösen, zum Beispiel wenn ein Kontakt auf eine Schaltfläche oder einen Link klickt.
<a href="#"
onclick="userengage('product_event', {
product_id: 'the_id',
event_type: 'add to cart',
name: 'product name',
my_attribute: 'value',
my_attribute_2: 'value_2'
})">
CLICK ME!
</a>Für eine bessere Datenorganisation und langfristige Flexibilität wird dringend empfohlen, Produktattribute vor dem Senden an das System anzulegen. Wenn Sie Attribute im Voraus definieren, können Sie den richtigen Datentyp festlegen (z. B. integer, boolean, date usw.).
Sind Attribute nicht vordefiniert, werden sie automatisch mit dem Datentyp string angelegt. Dies kann die Filterung ungenauer machen und Ihre Segmentierungs- und Reporting-Optionen in Zukunft einschränken.
Eine Übersicht der verfügbaren Attributtypen und Hinweise zur Auswahl des passenden Typs für Ihren Anwendungsfall finden Sie im folgenden Artikel.
Um Produkt Events mit der JavaScript-Methode zu senden, stellen Sie sicher, dass die Anfrage die erforderlichen Parameter enthält.
Pflichtfelder:
product_id
event_type
Optionale Felder:
name
description
Beliebige weitere Produkt-Event-Attribute, die für Ihren Anwendungsfall relevant sind
Wählen Sie für den „event_type" einen der weiter oben in diesem Artikel aufgeführten vordefinierten Werte aus.
Beispiel:
userengage("product_event", {
product_id: "12345",
event_type: "add to cart",
name: "Product Name",
description: "Product description"
});Kundeninteresse und Kaufabsicht verstehen: Erfassen Sie wichtige Aktionen wie Produktansichten, Klicks, Add-to-Cart-Events und Käufe, um besser zu verstehen, wofür sich Kunden interessieren und an welcher Stelle sie im Kaufprozess abspringen.
Konversionen mit automatisierten Follow-ups in Echtzeit steigern: Nutzen Sie Produkt Events, um Automatisierungen basierend auf dem Kundenverhalten auszulösen – zum Beispiel Erinnerungen oder Angebote, wenn ein Kontakt einen Artikel in den Warenkorb legt, den Kauf aber nicht abschließt.
Präzisere Segmente für gezieltes Marketing erstellen: Erstellen Sie Segmente auf Basis echter Produktinteraktionen, um die richtige Zielgruppe mit relevanten Botschaften zu erreichen – etwa Kunden, die ein bestimmtes Produkt angesehen oder Interesse an einer bestimmten Kategorie gezeigt haben.
Produkt-Engagement messen und Performance optimieren: Analysieren Sie Produkt-Event-Daten über einen längeren Zeitraum, um die Beliebtheit von Produkten zu bewerten, Engagement-Trends zu verfolgen und leistungsstarke oder leistungsschwache Produkte zu identifizieren – für bessere Marketing- und Vertriebsentscheidungen.
Umsatz mit personalisierten Produktempfehlungen steigern: Nutzen Sie Kauf-Events, um relevante Produkte auf Basis bereits getätigter Käufe zu empfehlen. So können Sie gezielte Kampagnen durchführen, die ergänzende oder ähnliche Artikel bewerben, Wiederholungskäufe fördern und den durchschnittlichen Bestellwert erhöhen.
Verwenden Sie passende Datentypen für Attribute, um Genauigkeit und Konsistenz zu gewährleisten. Legen Sie beispielsweise „Price" als „float" fest, um Fehler zu vermeiden.
Passen Sie Ihre Produktdaten an, indem Sie Attribute hinzufügen, die zu Ihren geschäftlichen Anforderungen passen – für eine präzisere Nachverfolgung und Analyse.
Durch eine strategische Verwaltung Ihrer Produkte können Sie wertvolle Erkenntnisse gewinnen und die Wirksamkeit Ihrer Marketing- und Engagement-Strategien verbessern.