Zum Hauptinhalt springen
Wie bereits erörtert, ermöglicht die DATA API von Kameleoon den Benutzern, Daten abzurufen und auf Kameleoon-Server zu schreiben. Drei wichtige Endpoints erleichtern dies: Visit, Product Recommendation und Map. In einigen Situationen müssen Zielkonversionsereignisse, die offline stattgefunden haben, wie Transaktionen im Geschäft oder Telefontransaktionen, an Kameleoon gesendet werden. Der in diesem Tutorial beschriebene Visit-Endpoint sendet Offline-Daten für einzelne Besucher. Im Gegensatz zum MAP-Endpoint, der eine größere Flexibilität bei der Struktur der übermittelten Daten bietet, lässt der Visit-Endpoint nur die Übermittlung vordefinierter Datenpunkte zu. Dazu gehören Conversions, Ereignisse und Seitenaufruf-Ereignisse sowie verschiedene andere Datentypen. Diese Informationen helfen dabei, Experimentergebnisse effektiv zu filtern und zu analysieren. Dieser Artikel behandelt die folgenden Operationen: Um Offline-Konversionsdaten an den Kameleoon-Server zu übertragen, senden Sie eine POST-Anfrage, die korrekt mit siteCode und visitorCode formatiert ist: 
https://eu-data.kameleoon.io/visit/events?siteCode=example_sitecode&visitorCode=example_visitor_code
Die Domain für Kameleoon-Skripte kann je nach Projekt variieren. Abhängig vom Erstellungsdatum werden Projekte entweder auf kameleoon.eu oder kameleoon.io gehostet. Verwenden Sie die in den Projekteinstellungen der Kameleoon App angezeigte Domain. Verwenden Sie für Nordamerika na-data.kameleoon.io oder na-data.kameleoon.eu.
  • siteCode: Eine eindeutige ID, die dem Experimentprojekt zugeordnet ist. Anweisungen zum Abrufen dieses Codes finden Sie unter diesem Link.
  • visitorCode: Eine eindeutige Zeichenfolge, die jedem Benutzer zugewiesen wird, der die Anwendung durchsucht. Sie weist Benutzer Experimenten und Variationen zu und verfolgt gleichzeitig deren Daten für die Berichterstellung. Für Kameleoon Web Experimentation wird der Besuchercode zufällig generiert und jedem Benutzer zugewiesen. Für Kameleoon Feature Experimentation generiert das Web SDK den Besuchercode, oder es kann eine benutzerdefinierte ID verwendet werden, insbesondere für Websites, die eine Anmeldung erfordern.
Projekte, die die geräteübergreifende Abstimmung von Kameleoon verwenden, können den Parameter mappingIdentifier anstelle des visitorCode verwenden. Lesen Sie hier mehr.
Dieser Endpoint unterstützt Massenkonversionen für mehrere visitorCodes. Fügen Sie dazu jedes Ereignis in den Anfragetext ein.
Erforderliche Parameter für den Anfragetext beim Senden von Zieldaten sind:
  • nonce: Eine zufällige Zeichenfolge aus 16 hexadezimalen Zeichen, die für jedes Ereignis eindeutig ist.
  • eventType: Eine Zeichenfolge, die den Ereignistyp angibt. Verwenden Sie für dieses Beispiel CONVERSION.
  • goalID: Die eindeutige ID des Ziels. Dieser Artikel erklärt, wie Sie auf Ziele zugreifen und sie verwalten.
  • revenue: Ein optionaler Float-Parameter, der den während der Konversion erzielten Umsatz angibt.
Diese Informationen werden in die folgende cURL-Anfrage übersetzt: 
curl -X POST 'https://eu-data.kameleoon.io/visit/events?siteCode=f17c21u1ag&visitorCode=245fc&json=true' \
-H 'Content-Type: application/json' \
-H 'User-Agent: CustomUserAgent/1.0' \
-d '[{"nonce":"a2bb4d22083348ef","eventType":"CONVERSION","goalId":36151,"revenue":23.50}]'
Da eine erfolgreiche Anfrage keine Objektantwort liefert, zeigt der nächste Abschnitt, wie Sie den Erfolg mit dem GET/visit/visitor-Endpoint überprüfen können.

​
Überprüfung von Offline-Zielkonversionsdaten

Verwenden Sie den GET-Endpoint, um das Ergebnis der POST-Anfrage zu überprüfen. Die Anfrage-URL muss enthalten:
  • siteCode: Siehe den vorherigen Abschnitt für Anweisungen zum Abrufen dieses Codes.
  • visitorCode: Derselbe Besuchercode, der im vorherigen Abschnitt verwendet wurde.
  • maxNumberPreviousVisits: Eine Ganzzahl, die die maximale Anzahl der zurückzugebenden vorherigen Besuche darstellt.
  • currentVisit: Auf true setzen, um sich auf den aktuellen Besuch zu konzentrieren; der Standardwert ist false. (Hinweis: Dies ist nur für Kameleoon Feature Experimentation verfügbar.)
  • conversion: Auf true setzen, um Konversionsereignisse für den angegebenen Benutzer und die im Kameleoon-Konto konfigurierten Ziele abzurufen.
Wenn Feature Experimentation nicht aktiv ist, warten Sie, bis Kameleoon den Besuch verarbeitet hat, in der Regel nach 30 Minuten Inaktivität. Die Konversionsdaten erscheinen dann im letzten berechneten vorherigen Besuch.
Dies übersetzt sich in die folgende cURL-Anfrage: 
curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&maxNumberPreviousVisits=5&currentVisit=true&conversion=true' \
-H 'Content-Type: application/json' \
-H 'User-Agent: CustomUserAgent/1.0' \
Eine erfolgreiche GET-Anfrage gibt eine Antwort zurück, die die in der vorherigen Anfrage gesendeten Daten enthält, und bestätigt damit, dass die POST-Anfrage erfolgreich war: 
{
  "previousVisits": [
    {
      "siteCode": "f17c21u1ag",
      "visitorCode": "245fc",
      "timeStarted": 1740447713028,
      "conversionEvents": [
        {
          "itp": false,
          "time": 1740447713028,
          "data": {
            "goalId": 361517,
            "revenue": 23.50,
            "negative": false,
            "metadata": {}
          }
        }
      ]
    }
  ]
}

​
Zusätzliche Informationen

In den meisten Fällen werden Konversionen für ein bestimmtes Ziel und einen bestimmten Besucher in Experimentberichten verwendet. Kameleoon verknüpft Konversionen mit Experimenten basierend auf mehreren Regeln:
  • Konversionen während aktiver Besuche: Wenn eine Konversion auftritt, während der Besucher aktiv ist und von einem Experiment angesprochen wird, verknüpft Kameleoon die Konversion mit dem Experiment für diesen Besuch.
  • Konversionen nach dem Ende von Besuchen: Wenn ein Besucher zuvor in ein Experiment einbezogen war, später aber einen Kauf über einen anderen Kanal tätigt (z. B. telefonisch oder im Geschäft), schreibt Kameleoon diese Konversion dem Experiment zu, sofern sie innerhalb des definierten Attributionsfensters (Standard: sieben Tage) erfolgt. Kameleoon erstellt in diesem Szenario einen neuen, mit der Konversion verbundenen Besuch.
Die Analyse der Daten auf Besucherebene bietet einen vollständigen Überblick über die Konversionen, einschließlich derjenigen, die bei nicht zielgerichteten Besuchen auftreten – vorausgesetzt, ein Experiment hat den Besucher zuvor angesprochen. Weitere Informationen dazu, wie Kameleoon Konversionen zählt, finden Sie unter diesem Link.