# Conversion-Events

Conversion-Events sammeln Benutzereinnahmen in einem einheitlichen Format, sodass Sie sie für Attribution, Analysen und Segmentierung verwenden können.

## Was sind Conversion-Events

Umsatz-Events haben selten eine einheitliche Form. Ihr SDK könnte `PW_InAppPurchase` auslösen, Ihr Backend könnte ein benutzerdefiniertes `OrderPlaced`-Event senden, und Stripe oder Shopify liefern ihre eigenen Webhook-Events. Ohne ein gemeinsames Format bedeutet das Targeting oder Reporting von Umsätzen, dass für jede Quelle eine separate Logik geschrieben werden muss.

Conversion-Events lösen dieses Problem, indem sie all das in `PW_Conversion` normalisieren, ein integriertes Event mit einem festen Satz von Feldern:

*   `value`: der Transaktionsbetrag
*   `currency`: ISO 4217 Währungscode
*   `transaction_id` und `product_id`: optionale Identifikatoren

`PW_Conversion` deckt Käufe, Abonnementverlängerungen und Zahlungen von Drittanbieter-Plattformen ab, unabhängig davon, woher das ursprüngliche Geld-Event stammt. Neben [Standard-](/de/product/audience-data-and-segmentation/events/default-events/) und [benutzerdefinierten](/de/product/audience-data-and-segmentation/events/custom-events/) Events sind Conversion-Events die dritte Event-Kategorie in Pushwoosh.

Sobald der Umsatz als `PW_Conversion` erfasst wird, lesen RFM-Segmentierung, Customer Journeys, Dashboards und ManyMoney AI alle dieselben normalisierten Daten, unabhängig davon, welche Quelle sie erzeugt hat.

### Wie Umsätze Pushwoosh erreichen

Sie erhalten einen `PW_Conversion`-Datensatz auf eine von zwei Weisen:

*   **Senden Sie ihn direkt aus Ihrem Code:** Ihre App oder Ihr Backend sendet `PW_Conversion` nach einem Kauf.
*   **Ordnen Sie ein bestehendes Event im Control Panel zu:** Weisen Sie Pushwoosh auf ein Kauf-Event hin, das Sie bereits senden, und es generiert `PW_Conversion`-Datensätze, ohne Ihren Code zu ändern. Sie können mehr als ein Quell-Event pro Anwendung zuordnen.

<Aside type="caution" title="Wichtig">
Verwenden Sie nur einen Pfad pro Transaktion. Wenn Sie `PW_Conversion` direkt senden und auch ein anderes Event zuordnen, das für denselben Kauf ausgelöst wird, erfasst Pushwoosh beide als separate, unabhängige `PW_Conversion`-Events. Pushwoosh erkennt oder führt keine Duplikate über Quellen hinweg zusammen, selbst wenn sie eine `transaction_id` teilen.
</Aside>

## Anwendungsfälle

Sobald Conversion-Events eingerichtet sind, können diese Daten überall dort verwendet werden, wo Umsätze in Pushwoosh eine Rolle spielen:

*   Erstellen Sie [RFM-Segmente](/de/product/audience-data-and-segmentation/segmentation/rfm-segmentation/) für hochwertige Benutzer basierend auf Ausgabenhöhe und Aktualität, ohne benutzerdefinierte Umsatzlogik für jedes Event.
*   Setzen Sie `PW_Conversion` als [Conversion-Ziel](/de/product/customer-journey/journey-settings/#conversion-goals) in einer [Customer Journey](/de/product/customer-journey/pushwoosh-journey-overview/), um zu sehen, welche Flows tatsächlich Käufe fördern, nicht nur Klicks oder Öffnungen.
*   Sehen Sie sich Umsätze in Dashboards und Berichten an, ohne für jedes Kauf-Event eine benutzerdefinierte Logik erstellen zu müssen.
*   Kombinieren Sie Umsätze aus SDK-Kauf-Events und Zahlungs-Webhooks (Stripe, Shopify) in einem Datensatz, anstatt jede Quelle separat zu analysieren.
*   Lassen Sie [ManyMoney AI](/de/product/pushwoosh-ai/ai-assistant/) echte Transaktionsdaten in seinen Empfehlungen und Kampagnenoptimierungen verwenden.

<Aside type="tip" title="Beispielszenarien">
**Kombinieren Sie Verlängerungen und Ladenbestellungen**

Eine Abonnement-App sendet `PW_Conversion` nach jeder Verlängerungszahlung und ordnet ihren Shopify-Webhook für einmalige Warenverkäufe `PW_Conversion` zu. Beide Umsatzquellen zählen nun zur selben RFM-Segmentierung, sodass die größten Ausgeber der App automatisch im **Champions**-Segment landen. Von dort aus können Sie sie mit einem Treueangebot in einer Customer Journey ansprechen.

**Vereinheitlichen Sie Ausgaben über Kanäle hinweg**

Eine mobile App sendet `PW_Conversion` für In-App-Käufe direkt von ihrem Backend und ordnet separat einen Stripe-Webhook für auf ihrer Website getätigte Käufe zu. Da Pushwoosh beide als dieselbe Art von Umsatz-Event behandelt, sieht ManyMoney AI die vollständige Ausgabenhistorie eines Kunden, App und Website kombiniert, wenn es empfiehlt, wen als Nächstes anzusprechen.

**Sehen Sie, welche Journeys Käufe fördern**

Eine Journey zielt auf kürzlich abgewanderte Benutzer mit einem Rückgewinnungsangebot ab. Ihr **Conversion-Ziel** ist auf `PW_Conversion` gesetzt. Nach dem Ende der Journey zeigen die Zielstatistiken, wie viele dieser Benutzer einen Kauf getätigt haben, sodass Sie sehen können, dass die Journey echte Käufe und nicht nur Öffnungen gefördert hat. Um zu sehen, wie viel Umsatz das darstellt, überprüfen Sie die Segment- oder Dashboard-Umsatzansicht separat. Customer Journey zeigt die Anzahl der Käufe pro Ziel, nicht den Gesamtbetrag in Dollar pro Journey.
</Aside>

## Wie man Conversion-Events einrichtet

Conversion-Events werden pro Anwendung konfiguriert. Sie können Conversion-Events auf eine von zwei Weisen einrichten. Befolgen Sie die Anweisungen für den Pfad, der zu Ihrer Implementierung passt.

### Senden Sie `PW_Conversion` von Ihrem Code

Dieser Pfad passt, wenn Sie Event-Code in Ihrer App oder Ihrem Backend hinzufügen oder ändern können. Senden Sie nach jedem Kauf `PW_Conversion` über die [postEvent](/de/developer/api-reference/user-centric-api/#postevent)-Methode.

<Aside type="caution" icon="setting" title="Hilfe von Entwicklern erforderlich">
Um `PW_Conversion` von Ihrem Code aus zu senden, benötigen Sie die Hilfe Ihres Entwicklungsteams. Teilen Sie das Beispiel aus **Code anzeigen** zusammen mit [diesem Link](/de/developer/guides/audience-and-segmentation/events/) mit ihnen für Anweisungen.
</Aside>

1.  Gehen Sie zu **Audience > Events**. Finden Sie die Karte **Conversion events tracking**.

<img src="/events-conversion-events-5.webp" alt="Seite 'Events' mit der Karte 'Conversion-Events-Tracking' vor der Einrichtung, die null zugeordnete Events und die Schaltfläche 'Umsätze sammeln starten' anzeigt"/>

2.  Klicken Sie auf **View code**.

<img src="/events-conversion-events-3.webp" alt="Seite 'Conversion-Events einrichten' mit dem Link 'Code anzeigen'"/>

3.  Kopieren Sie das Beispiel und fügen Sie den `postEvent`-Aufruf überall dort ein, wo ein Kauf in Ihrer App oder Ihrem Backend abgeschlossen wird.
<img src="/events-conversion-events-2.webp" alt="Integrationscode-Dialog mit PW_Conversion postEvent-Beispielen für JavaScript, Swift, Objective-C und Java"/>

<Aside type="tip">
Nur `value` und `currency` sind erforderlich. `transaction_id` und `product_id` sind optional.

Wenn Sie `transaction_id` senden, speichert Pushwoosh es genau so, wie Sie es übergeben. Es dedupliziert den Umsatz nicht anhand dieses Feldes.
</Aside>

**Beispiel für JavaScript:**

```javascript
Pushwoosh.postEvent("PW_Conversion", {
    value: 49.99,
    currency: "USD",
    transaction_id: "ord_18274",
    product_id: "sku_premium_m"
});
```

#### Attribute für den postEvent-Aufruf

Die folgende Tabelle listet die Attribute auf, die Sie beim Senden von `PW_Conversion` übergeben können.

| Feld <div style="width:120px"></div> | Typ <div style="width:100px"></div> | Erforderlich <div style="width:80px"></div> | Beschreibung |
| --- | --- | --- | --- |
| `value` | Zahl | Ja | Der Geldbetrag der Transaktion. |
| `currency` | Zeichenkette (ISO 4217) | Ja | Der Währungscode der Transaktion, zum Beispiel `USD` oder `EUR`. |
| `transaction_id` | Zeichenkette | Nein | Ein eindeutiger Identifikator für die Transaktion. Empfohlen für Ihre eigene Buchführung. Pushwoosh speichert ihn unverändert, verwendet ihn aber nicht zur Deduplizierung von Umsätzen. |
| `product_id` | Zeichenkette | Nein | Der Identifikator des gekauften Produkts oder Plans. |

<Aside type="caution">
Conversion-Events unterstützen derzeit keine Rückerstattungen oder Stornierungen. Es gibt keine Möglichkeit, einen negativen oder stornierenden `PW_Conversion`-Datensatz zu senden. Sobald eine Transaktion erfasst ist, bleibt sie in Ihren Umsatzsummen, auch wenn der Kauf später erstattet oder storniert wird.
</Aside>

### Ein bestehendes Event zur Umsatzverfolgung zuordnen

Dieser Pfad passt, wenn Kaufdaten bereits durch ein anderes Event fließen und Sie Ihren Code nicht ändern möchten. Wenn ein zugeordnetes Quell-Event eintrifft, löst Pushwoosh es aus und zeichnet es als `PW_Conversion`-Event auf.

<Aside type="note">
Die Zuordnung ändert oder ersetzt das Quell-Event nicht. Es funktioniert weiterhin genau wie zuvor. Das Quell-Event bleibt in der Segmentierung, der Event-Historie und den Dashboards wie jedes andere Event verfügbar. Pushwoosh erstellt zusätzlich einen `PW_Conversion`-Datensatz daraus, der nur für Umsatzfunktionen verwendet wird.
</Aside>

1.  Gehen Sie zu **Audience > Events**. Finden Sie die Karte **Conversion events tracking**.

2.  Klicken Sie auf **Start collecting revenue** (oder **Event mapping**, wenn Sie bereits ein Event zugeordnet haben). Die Seite **Set conversion events** wird geöffnet.

<img src="/events-conversion-events-7.webp" alt="Seite 'Conversion-Events einrichten' mit dem Abschnitt 'Bestehende Events zur Conversion-Verfolgung verwenden'"/>

3.  Öffnen Sie im Abschnitt **Use existing events to track conversion** das Dropdown-Menü **EVENT** und wählen Sie das Event aus, das Sie bereits senden. Die Liste enthält benutzerdefinierte Events, Standard-Events und Inbound-Webhook-Events (wie Stripe oder Shopify).

<img src="/events-conversion-events-4.webp" alt="Seite 'Conversion-Events einrichten' mit dem Standard-Dropdown-Menü EVENT, das den Platzhalter 'Event auswählen' anzeigt"/>

4.  Ordnen Sie die verbleibenden Attribute zu:

    *   Wählen Sie unter **PRICE** das Attribut aus, das den Transaktionsbetrag speichert.
    *   Wählen Sie unter **CURRENCY** das Attribut aus, das den Währungscode speichert.
    *   Optional können Sie **TRANSACTION ID (OPTIONAL)** und **PRODUCT ID (OPTIONAL)** zuordnen.
<img src="/events-conversion-events-1.webp" alt="Formular zur Zuordnung von Conversion-Events mit ausgefüllten Feldern für EVENT, Preis, Währung, Transaktions-ID und Produkt-ID"/>

Um ein weiteres Quell-Event zuzuordnen, klicken Sie auf **+ ADD EVENT**. Um eine Zuordnung zu entfernen, klicken Sie auf **REMOVE**.

5.  Klicken Sie auf **Apply**.

Sie können mehrere Events als Quellen für dieselbe Anwendung zuordnen. Zum Beispiel können Sie ein benutzerdefiniertes `purchase_completed`-Event neben einem Stripe-Webhook-Event zuordnen.

<Aside type="caution" title="Wichtig">
Änderungen werden vergangene Statistiken nicht neu berechnen. Nur neue Conversion-Daten werden die aktualisierte Einrichtung verwenden.
</Aside>

## Überwachen von Conversion-Events

Die Karte **Conversion events tracking** unter **Audience > Events** fasst die Conversion-Aktivität für die ausgewählte Anwendung zusammen. Sie zeigt zwei Zahlen an:

*   **Mapped events:** wie viele Quell-Events derzeit in `PW_Conversion` einfließen.
*   **Triggered last 7 days:** die Gesamtzahl der `PW_Conversion`-Events, die in diesem Zeitraum ausgelöst wurden, von jeder aktuellen oder vergangenen Zuordnung oder von direkten `postEvent`-Aufrufen.

Klicken Sie auf **View code**, um das `PW_Conversion`-Integrationsbeispiel erneut zu öffnen.

<img src="/events-conversion-events-6.webp" alt="Karte 'Conversion-Events-Tracking' nach der Einrichtung, die die Anzahl der ausgelösten Events, die Anzahl der zugeordneten Events, die Links 'Code anzeigen', 'Event-Zuordnung' und 'Anleitung' anzeigt"/>

<Aside type="caution" title="Wichtig">
Diese Zählung spiegelt jedes `PW_Conversion`-Event wider, das in den letzten 7 Tagen ausgelöst wurde, unabhängig von der Quelle. Wenn Sie eine Zuordnung ändern oder entfernen, bleiben bereits generierte `PW_Conversion`-Events gezählt, bis sie aus dem 7-Tage-Fenster herausfallen. Die Zahl sinkt oder wird nicht sofort neu berechnet.
</Aside>