> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Verarbeitung von Offline-Zielkonversionen in Experimenten

> Senden Sie Offline-Konversionsereignisse wie Käufe im Geschäft mithilfe des Visit-Endpoints der Data API an Kameleoon und überprüfen Sie deren Aufnahme.

Wie [bereits erörtert](./storing-and-retrieving-external-data-to-target-users), 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](/user-manual/experiment-analytics/analyze-results/results-page/results-page-settings#Audience). Diese Informationen helfen dabei, Experimentergebnisse effektiv zu filtern und zu analysieren.

Dieser Artikel behandelt die folgenden Operationen:

* Senden von Offline-Zielkonversionen mit dem [POST/visit/events](/api-reference/visit/send-visitor-events)-Endpoint.
* Überprüfung der Übertragung von Offline-Zieldaten mit dem [GET/visit/visitor](/api-reference/visit/get-visitor-data)-Endpoint.

Um Offline-Konversionsdaten an den Kameleoon-Server zu übertragen, senden Sie eine POST-Anfrage, die korrekt mit **siteCode** und **visitorCode** formatiert ist:

```shell theme={null}
https://eu-data.kameleoon.io/visit/events?siteCode=example_sitecode&visitorCode=example_visitor_code
```

<Note>
  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`.
</Note>

* **`siteCode`**: Eine eindeutige ID, die dem Experimentprojekt zugeordnet ist. Anweisungen zum Abrufen dieses Codes finden Sie unter [diesem Link](/user-manual/faq#how-do-i-find-my-sitecode).
* **`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.

<Note>
  Projekte, die die geräteübergreifende Abstimmung von Kameleoon verwenden, können den Parameter `mappingIdentifier` anstelle des **`visitorCode`** verwenden. Lesen Sie [hier mehr](../../../cross-device-experimentation).
</Note>

<Note>
  Dieser Endpoint unterstützt Massenkonversionen für mehrere `visitorCode`s. Fügen Sie dazu jedes Ereignis in den Anfragetext ein.
</Note>

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](/user-manual/assets/goals/manage-goals) 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:

```shell theme={null}
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](/api-reference/visit/get-visitor-data)-Endpoint überprüfen können.

## Überprüfung von Offline-Zielkonversionsdaten

Verwenden Sie den [GET-Endpoint](/api-reference/visit/get-visitor-data), um das Ergebnis der POST-Anfrage zu überprüfen.

Die Anfrage-URL muss enthalten:

* **`siteCode`**: Siehe den [vorherigen Abschnitt](#sending-offline-goal-conversion) für Anweisungen zum Abrufen dieses Codes.
* **`visitorCode`**: Derselbe Besuchercode, der im [vorherigen Abschnitt](#sending-offline-goal-conversion) 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.

<Note>
  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.
</Note>

Dies übersetzt sich in die folgende cURL-Anfrage:

```shell theme={null}
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:

```shell theme={null}
{
  "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](/user-manual/experiment-analytics/analyze-results/data-and-metrics/how-kameleoon-counts-conversions).
