Empfehlungen und Produktkatalog

OneTrace.ru wählt für jeden Kunden passende Produkte aus: Beliebtes, „Zusammen gekauft“, Ähnliches, zuletzt Angesehenes und eine persönliche Auswahl. Empfehlungen erscheinen auf der Website, in E-Mails, Journeys und Kampagnen. Dafür brauchen Sie einen Produktkatalog sowie Ereignisse zu Produktaufrufen, Warenkorb und Käufen.

Den Bereich öffnen Sie im Menü Kommunikation → Empfehlungen. Ansehen können ihn alle Projektmitglieder; Feeds anbinden, Einstellungen ändern und eine Neuberechnung starten können „Inhaber“, „Administrator“ und „Manager“.

Produktkatalog

Oben auf der Seite sehen Sie, wie viele Produkte der Katalog enthält, wie viele davon verfügbar sind und wie viele Kategorien es gibt. Solange der Katalog leer ist, gibt es nichts zu empfehlen: Binden Sie einen Feed an oder laden Sie Produkte über die API hoch.

Feed anbinden

1. Klicken Sie im Block Produktfeeds auf Feed hinzufügen.
2. Geben Sie einen Name und die Feed-URL an – den Link zur Datei.
3. Wählen Sie das Format: YML (Yandex), Google Merchant, CSV, JSON oder JSON Lines.
4. Wählen Sie im Feld Aktualisierung, wie oft der Feed neu gelesen wird: alle 1, 3, 6 oder 12 Stunden oder täglich.
5. Ist der Feed durch Passwort oder Token geschützt, füllen Sie den Authorization-Header aus, zum Beispiel Bearer …. Er wird verschlüsselt gespeichert.
6. Klicken Sie auf Speichern. Der erste Import startet sofort.

In CSV und JSON werden Spalten anhand ihrer Namen erkannt: id, name oder title, url, image, price, old_price, currency, available, category, brand (auch russische Namen für Name, Preis und Marke werden erkannt). Alle übrigen Spalten gelten als Produkteigenschaften. Die Produkt-ID muss mit der übereinstimmen, die die Website in den Ereignissen überträgt – sonst lassen sich die Aktionen der Kunden nicht mit dem Katalog verknüpfen.

Zu jedem Feed sehen Sie den Status (Aktiv oder Fehler), den Zeitpunkt des letzten Imports und das Ergebnis: wie viele Produkte und Kategorien gelesen und wie viele als nicht verfügbar markiert wurden. Die Schaltfläche Jetzt aktualisieren startet einen Import außerhalb des Zeitplans. Pausieren stoppt die geplanten Importe (Status „Pausiert“), Jetzt aktualisieren hebt die Pause auf. Ein Feed mit Fehler wird nach Zeitplan erneut versucht, der Fehlertext steht darunter.

Wichtig zu wissen:

• Produkte, die nicht mehr im Feed stehen, werden als nicht verfügbar markiert, nicht gelöscht: Ihr Ereignisverlauf bleibt erhalten, und ein Produkt, das wieder im Feed auftaucht, ist erneut verfügbar.
• Beim Löschen eines Feeds bleiben die Produkte im Katalog.

Bildkopien

In den Feed-Einstellungen können Sie Produktbilder in unseren Speicher kopieren aktivieren. Dann werden Bilder in E-Mails und Widgets vom CDN von OneTrace.ru geladen und hängen nicht von der Erreichbarkeit Ihrer Website ab.

• Höchstens … Bilder herunterladen pro Sekunde, Minute oder Stunde – eine Begrenzung, um Ihre Website nicht zu belasten. Standardmäßig 5 pro Sekunde.
• Unter dem Feed sehen Sie, wie viele Bilder kopiert, eingereiht und nicht heruntergeladen wurden. Solange keine Kopie existiert (oder sich die Bildadresse im Feed geändert hat), wird das Originalbild angezeigt.
• Kopien zählen zum Bildspeicherlimit des Tarifs. Ist der Schalter nicht verfügbar, ist in Ihrer Installation kein Bildspeicher eingerichtet.

Lagerbestand

Nicht jeder Shop führt Lagerbestände, daher wird ihre Berücksichtigung separat eingeschaltet: Der Schalter Lagerbestand berücksichtigen befindet sich in den Einstellungen jedes Feeds, für Produkte aus der API und aus Shop-Plugins in der Einstellungskarte des Bereichs (Lagerbestand aus API und Plugins berücksichtigen). Standardmäßig ist er aus.

• Ein – der Bestand wird gespeichert, ein Produkt mit Bestand null wird aus dem Verkauf genommen. Funktionen auf Basis des Bestands arbeiten, etwa Journeys „nur noch wenige“. Im Feed stammt der Bestand aus <count> (YML), g:quantity (Google) oder der Spalte stock, quantity (CSV und JSON), in der API aus dem Feld stock.
• Aus – der Bestand wird nicht genutzt: Ein Produkt richtet sich nach der Verfügbarkeit aus dem Feed oder dem Feld available, auch wenn der Shop Bestand null sendet.

Upload über die API

Entwickler können Produkte über Anfragen an https://cdp.onetrace.ru/api/v1/products hochladen und löschen – bis zu 1000 Produkte und Kategorien pro Anfrage. Dafür ist ein geheimer Schlüssel mit der Berechtigung „Produkte hochladen und löschen“ nötig, siehe API-Schlüssel und Serverseitige Integration.

Katalogsprachen

Wenn Ihre Website in mehreren Sprachen verfügbar ist, laden Sie Übersetzungen der Produkte hoch – dann zeigen Widgets, Suche und E-Mails Namen und Links in der Sprache des Kunden.

• Feed in einer anderen Sprache. Fügen Sie einen zweiten Feed hinzu – denselben Export in einer anderen Sprache – und wählen Sie dafür die Sprache des Feeds. Ein solcher Feed legt keine Produkte an und markiert keine als nicht verfügbar: Er ergänzt die Produkte des Hauptfeeds mit denselben IDs um Übersetzungen von Namen, Links und Produkteigenschaften. Das Feld erscheint, wenn das Projekt mehrere Sprachen hat, siehe Projekteinstellungen, Tarif und Audit.
• Über die API. Übergeben Sie Übersetzungen im Feld translations des Produkts und der Kategorie, zum Beispiel "translations": {"en": {"name": "Linen dress", "url": "https://shop.example/en/linen-dress"}}.

Die Sprache wird automatisch gewählt: auf der Website die Sprache des Besuchers, die der Tracker übermittelt, in einer E-Mail die Sprache ihrer Version, siehe Sprachversionen. Gibt es keine Übersetzung in diese Sprache, werden der Hauptname und der Hauptlink angezeigt. Die Produktsuche findet ein Produkt anhand seines Namens in jeder der Sprachen. In der Produkttabelle stehen neben dem Namen die Sprachen, in die das Produkt übersetzt ist.

Ereignisse für die Modelle

Geben Sie im Block Events für die Modelle an, welche Ereignisse Produktaktionen bedeuten:

Standardmäßig werden die Ereignisse aus den Prognoseeinstellungen übernommen, die übrigen Werte aus der Branche des Shops. Nach Speichern werden die Modelle neu berechnet.

Modelle und nächtliche Berechnung

Die Karte Modelle zeigt den Status (Ausstehend, Wird berechnet, Bereit, Kein Katalog, Fehler), den Berechnungszeitpunkt und die Anzahl der Verknüpfungen zwischen Produkten.

Die Modelle werden jede Nacht neu berechnet, außerdem sofort nach dem Speichern der Einstellungen und über die Schaltfläche Neu berechnen. Während der Berechnung und bei einem Fehler werden Empfehlungen auf Basis der vorherigen Version ausgeliefert.

Neben den Verknüpfungen schreibt die Berechnung die Merkmale favorite_category, favorite_brand und top_products in die Profile, bei Branchen mit Größen außerdem pref_… (Größe des Kunden, siehe Branche des Shops) und replenish_at (Datum für „Zeit nachzukaufen“). Sie können sie in Segmenten nutzen, etwa „Lieblingskategorie – Schuhe“.

Arten von Empfehlungen

Neue Besucher ohne Verlauf erhalten beliebte Produkte. In die Auswahl gelangen nur verfügbare Produkte.

Ergebnis prüfen

Wählen Sie im Block Ergebnis prüfen die Art und geben Sie je nach Art eine Produkt-ID, Kategorie-ID oder Profil-ID an. Klicken Sie auf Anzeigen, um die Produktkarten zu sehen, die der Kunde erhält.

Wirkungsbericht

Die Tabelle Wirkung auf der Website in 30 Tagen zeigt für jede Art Impressionen, Klicks, CTR, Käufe und Umsatz. Ein Kauf wird gezählt, wenn der Kunde das Produkt innerhalb von 7 Tagen nach einem Klick auf die Empfehlung gekauft hat; der Umsatz wird zum Katalogpreis berechnet. Die Wirkung von Empfehlungen in E-Mails sehen Sie in den Berichten von Kampagnen und Journeys.

Wo Sie Empfehlungen anzeigen

• Auf der Website – fertige Widgets aus dem Bereich „Website“ oder ein Tracker-Aufruf, siehe Empfehlungs-Widgets auf der Website.
• In E-Mails – der Block Produkte im E-Mail-Baukasten. Darin wählen Sie Welche Produkte, Anzahl, die Spaltenzahl, Preis anzeigen und Schaltfläche unter dem Produkt. Bei den Arten „Zusammen angesehen“, „Zusammen gekauft“ und „Ähnlich“ stammt das Produkt aus dem Ereignis, das die E-Mail ausgelöst hat (Event-Eigenschaft mit der Produkt-ID) – so entsteht eine E-Mail zum verlassenen Warenkorb. Gibt es keine passenden Produkte, wird der Block in der E-Mail nicht angezeigt.
• In Vorlagen beliebiger Kanäle – die Funktion recommendations():

{% for product in recommendations('personal', 4) %}
  <a href="{{ product.url }}">{{ product.name }}</a> — {{ product.price }}
{% endfor %}