Skip to main content
Data-Warehouse-Integrationen sind als Premium-Add-on für die Module Web Experimentation und Feature Experimentation verfügbar. Wenden Sie sich für weitere Informationen an Ihren Customer Success Manager.
Wenn Ihre Conversions in Snowflake liegen, können Sie sie messen, ohne sie auf Ihrer Website zu tracken. Ein Snowflake-Ziel führt eine Abfrage aus, die Sie für diese Daten definieren, und verwendet die Ergebnisse als Conversions auf Ihren Ergebnisseiten. Kameleoon ruft die Daten in der von Ihnen festgelegten Häufigkeit ab und fügt die Conversions einmal täglich in die Experimentergebnisse ein. Die Abfrage muss eine Spalte visitor_id und eine Spalte conversion_timestamp zurückgeben, und die Daten müssen mindestens 72 Stunden nach jedem Ereignis abfragbar bleiben. Bevor Sie das Ziel erstellen, aktivieren Sie die Snowflake-Integration für Ihr Projekt.

Ein Snowflake-Ziel erstellen

Um ein Ziel zu erstellen, das Conversions aus Snowflake liest, folgen Sie dem Ablauf Data warehouse tracking in Ein Ziel erstellen und wählen Sie im Dropdown Datawarehouse integration die Option Snowflake aus. Schritt 1 fragt anschließend nach diesen Snowflake-spezifischen Feldern:
  • Warehouse: Geben Sie das Snowflake-Warehouse ein, das abgefragt werden soll.
  • Frequency: Legen Sie fest, wie oft Kameleoon die Zieldaten aktualisieren soll.
  • Database: Geben Sie die Datenbank ein, die Ihre Conversion-Daten enthält.
  • Schema: Geben Sie das Schema ein, das Ihre Conversion-Daten enthält.
  • Query: Definieren Sie die SQL-Abfrage, die die benötigten Daten aus Snowflake abruft.
Füllen Sie Schritt 1 aus. Konfigurieren Sie danach bei Bedarf Schritt 2, Advanced settings, und speichern Sie Ihr Ziel. Aufbewahrungszeitraum im Data Warehouse: Damit Kameleoon ein Ereignis abrufen kann, muss es mindestens 72 Stunden nach seinem Auftreten über Ihre Abfrage zugänglich bleiben.

Abfrageformat

Die Abfrage muss einem bestimmten Format entsprechen: SELECT visitor_id, conversion_timestamp FROM your_events_table Dabei ist visitor_id die Spalte mit der eindeutigen ID Ihrer Besucher, und conversion_timestamp ist die Spalte mit dem genauen Zeitpunkt, zu dem die Conversion stattfand. In Snowflake muss die Spalte conversion_timestamp vom Typ Timestamp sein. Wenn Sie jeder Conversion einen Umsatz zuordnen möchten, muss die Abfrage dieses alternative Format verwenden: SELECT visitor_id, conversion_timestamp, revenue FROM your_events_table Dabei ist revenue die Spalte, die den Umsatz jeder Conversion enthält. Bei komplexeren Abfragen können Sie dieses Format beibehalten, indem Sie Ihre ursprüngliche Abfrage in eine Unterabfrage einschließen:

Wie Kameleoon Conversion-Daten abruft

Kameleoon ruft die Snowflake-Conversion-Daten hinter Ihrem Ziel in der von Ihnen festgelegten Häufigkeit ab. Dabei hängt Kameleoon Ihrer Abfrage eine WITH-Klausel an, die nach Zeitstempeln filtert. Anstatt bei jedem Lauf den gesamten Ereignisverlauf neu zu laden, ruft Kameleoon inkrementell ab: Jeder Abrufjob speichert den letzten erfolgreichen Abrufpunkt und fragt beim nächsten Lauf nur das Zeitfenster der neuen Datensätze seit diesem Punkt ab. Da nur dieses Zeitfenster abgefragt wird, bleibt jeder Abruf schnell, weil Kameleoon bereits importierte Daten nie erneut durchsucht. Auch wenn Kameleoon Conversions in der von Ihnen festgelegten Häufigkeit abruft, fügt es sie nur einmal täglich in die Experimentergebnisse ein. Da das Polling immer vorwärts voranschreitet, kann Kameleoon einen Datensatz übersehen, der mit einem Zeitstempel in Snowflake eintrifft, der älter ist als das letzte erfolgreiche Abfragefenster. Verspätete Datensätze entstehen meist, weil Ihre Datenpipeline Zeit benötigt, um das Conversion-Ereignis zu schreiben. Der Datensatz erreicht Snowflake dann erst, nachdem Kameleoon das Zeitfenster, zu dem er gehört, bereits abgefragt hat. Um verpasste Datensätze zu vermeiden, bitten Sie Ihren Customer Success Manager, den Ingestion-Zeitrahmen auf die typische Ankunftsverzögerung Ihrer Pipeline zu verlängern. Kameleoon importiert einen verspäteten Datensatz nur, solange sein Zeitstempel in ein Fenster fällt, das noch nicht abgefragt wurde. Sobald der Abrufpunkt einen vollen Tag überschreitet, liest Kameleoon diesen Tag nicht noch einmal ein. Für diesen Tag importiert Kameleoon deshalb keine verspätete oder korrigierte Zeile.

Ingestion-Zeitrahmen

Standardmäßig lässt Kameleoon bis zu 1 Stunde zwischen dem Auftreten eines Conversion-Ereignisses für Ihr Ziel und seiner Verfügbarkeit in Ihrem Snowflake-Warehouse zu. Das Abfragefenster berücksichtigt diese Verzögerung automatisch. Wenn Ihre Pipeline länger als 1 Stunde benötigt, um Ereignisse in Snowflake zu schreiben, etwa wegen Batch- oder nächtlicher ETL-Jobs, liegen diese verspätet eintreffenden Datensätze außerhalb des Abfragefensters und werden verpasst. Wenden Sie sich an Ihren Customer Success Manager, um die Verzögerung so zu verlängern, dass sie der tatsächlichen Ankunftsverzögerung Ihrer Pipeline entspricht.

Fehlgeschlagene Abrufe und Schemaänderungen

Ein fehlgeschlagener Abruf lässt den Abrufpunkt unverändert. Der Abrufpunkt ist der Zeitpunkt, bis zu dem Kameleoon bereits Datensätze importiert hat. Der nächste geplante Abruf startet daher am selben Punkt und wiederholt dasselbe Zeitfenster. Kameleoon importiert die Datensätze dieses Fensters, sobald die Abfrage erneut läuft. Eine Schemaänderung wirkt sich je nach Art der Änderung auf eine von zwei Arten auf die Ergebnisse aus:
  • Eine Spalte, die Ihre Abfrage erwartet, fehlt oder wurde umbenannt: Der Abruf schlägt fehl, und Kameleoon protokolliert den Fehler. Der Abrufpunkt rückt nicht vor. Spätere Läufe wiederholen daher das Zeitfenster, bis die Abfrage wieder zur Tabelle passt.
  • Eine Spalte behält ihren Namen, ihre Bedeutung ändert sich: Der Abruf gelingt, und der Abrufpunkt rückt vor. Kameleoon prüft nicht, ob eine gleichnamige Spalte weiterhin die Besucherkennung, den Zeitstempel oder den Umsatz enthält, den Sie erwarten. Daher können Ergebnisse ohne Fehlermeldung falsch sein.
Nachdem Sie eine Tabelle oder View umbenannt oder umstrukturiert haben, die eine Abfrage liest, führen Sie die Abfrage erneut aus, um zu bestätigen, dass sie die erwarteten Spalten zurückgibt.

Besucherkennung

Kameleoon verwendet den Wert von visitor_id, um festzustellen, welchem Besucher die jeweilige Conversion zugeordnet wird. Der Wert muss daher einer Kennung entsprechen, die Kameleoon bereits für diesen Besucher hat. Standardmäßig ist der Wert der Kameleoon-Besuchercode. Wenn Sie den geräteübergreifenden Verlaufsabgleich einrichten, gleicht Kameleoon visitor_id mit den benutzerdefinierten Daten ab, die Sie als eindeutige Kennung für den geräteübergreifenden Verlaufsabgleich markiert haben, statt mit dem Besuchercode.

Ihre Abfrage vor der Ingestion ausführen

Bevor Sie Ihr Ziel speichern, können Sie Ihre Abfrage direkt in Kameleoon testen. Mit dem Test können Sie:
  • Die Verbindung in Echtzeit überprüfen.
  • Bestätigen, dass Ihre Anmeldedaten und Zugriffsrechte korrekt sind, damit Sie Probleme sofort erkennen, ohne auf den ersten Datenimport warten zu müssen.
  • Die Struktur und Erreichbarkeit Ihrer Daten validieren.
Sie können eine einfache Abfrage ausführen, um sicherzustellen, dass Kameleoon auf die richtigen Datenbanken und Tabellen zugreifen kann. Sie können außerdem eine kleine Stichprobe des Datensatzes herunterladen, um zu bestätigen, dass Schema, Berechtigungen und Inhalte Ihren Erwartungen entsprechen.

Ihr Snowflake-Ziel verwenden

Sobald das Ziel erstellt ist, können Sie es in Ihre Kameleoon-Kampagnen einbinden. Wenn Sie ein Experiment oder eine Personalisierung einrichten, können Sie dieses Ziel im Abschnitt Goals der Finalisierungsseite auswählen. Mit dem Ziel können Sie dann bestimmte Conversions aus Ihrer Snowflake-Datenbank verfolgen und analysieren. Informationen zum Einrichten eines Ziels in einem Experiment finden Sie unter Ein Ziel für eine Kampagne einrichten.

Datenaufbewahrung

Conversion-Daten, die aus Snowflake importiert werden, werden in Kameleoon zu Besuchsdaten und unterliegen der Standard-Aufbewahrungsrichtlinie von Kameleoon. Informationen zum Aufbewahrungszeitraum finden Sie in der Datenaufbewahrungsrichtlinie.

Besucherdaten löschen

Sie können die Kopie der Besucherdaten von Kameleoon über den Data-API-Endpunkt POST /visit/forget entfernen, der eine Authentifizierung erfordert. Das Anfrageformat finden Sie unter Remove data for several visitors. Der Endpunkt löscht keine Tabellen in Ihrer Snowflake-Datenbank.