> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/test-your-advocate-program.md).

# Ihr Advocate-Programm testen

Sie können Ihr Advocate-Programm testen, indem Sie [die Regeln Ihres Programms](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) anhand von Beispieldaten simulieren. So können Sie überprüfen, ob sich eine Regel wie erwartet verhält, bevor Sie sich im Produktivbetrieb darauf verlassen.

{% hint style="success" %}
**Hinweis:** Sie müssen mindestens eine Programmregel einrichten, um Ihr Programm testen zu können.
{% endhint %}

{% stepper %}
{% step %}

## „Mein Programm testen“ aufrufen

1. Wählen Sie im linken Navigationsmenü ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** <i class="fa-arrow-right">:arrow-right:</i> **Programmregeln** <i class="fa-arrow-right">:arrow-right:</i> **Mein Programm testen**.
   1. Wählen Sie **Weiter** , um zwischen den Schritten zu wechseln.
      {% endstep %}

{% step %}

## Programm und Version bestätigen

2. Das Programm ist anhand Ihres aktuellen Kontexts vorausgefüllt. Ändern Sie es nur, wenn Sie ein anderes Programm testen möchten.
3. Wählen Sie im *Version* ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Drop-down-Menü]**&#x61;us, ob Sie die **Entwurfs-** oder **Live-** Version simulieren möchten.
   1. Erfahren Sie mehr darüber, was eine Entwurfs- und eine Live-Version Ihres Advocate-Programms umfassen.
      {% endstep %}

{% step %}

## Ereignis auswählen und Eingaben ausfüllen

4. Wählen Sie aus, welches Ereignis Sie simulieren möchten, und geben Sie dann die Informationen so ein, wie sie in Ihrem Programm auftreten würden:
   * **Empfehlung gestartet**
   * **Freund tätigt einen Kauf**
   * **Freund lässt sich einen Kauf erstatten**
   * **Freund führt eine Aktion aus**

<details>

<summary>Feldreferenz</summary>

| Feld                             | Beschreibung                                                        | Verfügbar für                                                                    |
| -------------------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| **Kaufereignis**                 | Das erfasste Kaufereignis, das simuliert werden soll.               | Freund tätigt einen Kauf, Freund erstattet einen Kauf                            |
| **Kaufdatum**                    | Das Datum des simulierten Kaufs.                                    | Freund tätigt einen Kauf, Freund erstattet einen Kauf                            |
| **Ereignistyp**                  | Das erfasste Ereignis, das simuliert werden soll.                   | Freund führt eine Aktion aus                                                     |
| **Ereignisdatum**                | Das Datum, an dem das Ereignis stattgefunden hat.                   | Freund führt eine Aktion aus                                                     |
| **Währung**                      | Die Währung des simulierten Kaufbetrags.                            | Freund tätigt einen Kauf, Freund führt eine Aktion aus                           |
| **Kaufbetrag**                   | Der Betrag des simulierten Kaufs.                                   | Freund tätigt einen Kauf (erforderlich), Freund führt eine Aktion aus (optional) |
| **Empfehlung gestartet am**      | Das Datum, an dem die Empfehlung begonnen hat.                      | Alle Ereignisse                                                                  |
| **Empfehlung konvertiert**       | Geben Sie an, ob und wann die Empfehlung bereits konvertiert wurde. | Alle Ereignisse außer „Empfehlung gestartet“                                     |
| **Advocate-Segmente** (optional) | Beschränken Sie den Test auf ein bestimmtes Advocate-Segment.       | Alle Ereignisse                                                                  |
| **Friend-Segmente** (optional)   | Beschränken Sie den Test auf ein bestimmtes Friend-Segment.         | Alle Ereignisse                                                                  |

</details>
{% endstep %}

{% step %}

## Test ausführen

5. Auswählen **Test ausführen**. Ihre Regeln werden anhand des ausgewählten Programms, der Version und der von Ihnen angegebenen Eingaben ausgewertet.
   {% endstep %}

{% step %}

## Vorschauausgabe lesen

6. Prüfen Sie das *Vorschau* -Panel:
   1. Eine Zusammenfassung der ausgelösten Regel, der Datumsbereich, falls datumsbasierte Aktionen gelten, sowie eine Zeile mit Häkchen für jede daraus resultierende Aktion. Prüfen Sie, ob das Ihren Erwartungen entspricht.
      {% endstep %}
      {% endstepper %}

## Testfälle

Mit diesen Testfällen können Sie Beispielregeln einrichten, um vor der Veröffentlichung zu überprüfen, ob sich Ihr Programm wie gewünscht verhält. Die folgenden Szenarien behandeln jeweils eine bestimmte Situation im Detail. Passen Sie die Einzelheiten wie Auslöser, Beträge und Segmente an die Konfiguration Ihres Programms an.

<details>

<summary>Grundlegende Auslöserlogik</summary>

**Ziel:**

* Überprüfen, ob eine einfache Regel mit Kaufauslöser zutrifft und das erwartete Ergebnis liefert.
* Sicherstellen, dass kein falsches Fallback-Verhalten auftritt.

**Regelkonfiguration:**

* Auslöser: Friend tätigt einen Kauf.
* Aktion: Prämie und E-Mail an den Advocate, mit einer Geldprämie für den Advocate.
* Keine Standardaktion erforderlich.

**Testeingaben:**

* Ereignis: Friend tätigt einen Kauf.
* Kaufereignis, Kaufdatum, Kaufbetrag und Währung entsprechen Ihrer Regel.
* Empfehlung am selben Datum gestartet.
* Segmente nicht einschränken.

**Erwartetes Ergebnis:**

* Die Regel trifft zu, und in der Vorschau wird genau angezeigt, welche Regel zutraf.
* In der Prämienzeile für den Advocate wird der konfigurierte Prämienbetrag angezeigt.
* Die E-Mail-Zeile für den Advocate wird angezeigt.
* Es wird keine andere, falsche Fallback-Aktion angezeigt.

</details>

<details>

<summary>Treffer im Zeitfenster oder Fallback</summary>

**Ziel:**

* Überprüfen, ob ein Datum innerhalb eines zeitbasierten Zeitfensters die zeitbasierte Aktion auslöst.
* Überprüfen, ob bei einem Datum außerhalb des Zeitfensters die Standardaktion greift.

**Regelkonfiguration:**

* Auslöser: Friend tätigt einen Kauf.
* Eine zeitbasierte Aktion, die für ein Datumsfenster gilt und auf dem Startdatum der Empfehlung basiert.
* Eine Standardaktion außerhalb dieses Zeitfensters.

**Durchlauf A (im Zeitfenster):**

* Legen Sie das Startdatum der Empfehlung innerhalb des Zeitfensters fest.

**Erwartung für A:**

* In der Vorschau wird genau angezeigt, welche zeitbasierte Regel zutraf.
* Die zugehörige Prämie und E-Mail werden angewendet.

**Durchlauf B (außerhalb des Zeitfensters):**

* Legen Sie das Startdatum der Empfehlung außerhalb des Zeitfensters fest.

**Erwartung für B:**

* Die zeitbasierte Aktion trifft nicht zu.
* Stattdessen werden die Standardprämie und die Standard-E-Mail angewendet.

</details>

<details>

<summary>Auswahl einer gestaffelten Prämie</summary>

**Ziel:**

* Überprüfen, ob anhand des Kaufbetrags die richtige Prämienstufe ausgewählt wird.

**Regelkonfiguration:**

* Auslöser: Friend tätigt einen Kauf.
* Aktion: Gestaffelte Prämie und E-Mail an den Fürsprecher.
* Mindestens drei Prämienstufen für unterschiedliche Kaufbetragsbereiche (zum Beispiel eine niedrige, mittlere und hohe Stufe).

**Testeingaben:**

* Einmal pro Stufe ausführen.
* Geben Sie einen Kaufbetrag ein, der in den Bereich der jeweiligen Stufe fällt.
* Lassen Sie bei allen Durchläufen alle anderen Eingaben unverändert.

**Erwartetes Ergebnis:**

* Bei jedem Durchlauf wird die für die Stufe konfigurierte Prämie angezeigt, in deren Bereich der Betrag fällt – nicht die Prämie einer anderen Stufe.

</details>

<details>

<summary>Berechtigung durch Segment eingeschränkt</summary>

**Ziel:**

* Bestätigen Sie, dass eine Segmentbedingung steuert, ob die Regel angewendet wird.

**Regelkonfiguration:**

* Auslöser: Friend tätigt einen Kauf.
* Eine Bedingung, die voraussetzt, dass sich der Fürsprecher in einem bestimmten Segment befindet.
* Idealerweise gibt es eine Standardaktion für alle anderen.

**Durchlauf A (Treffer):**

* Legen Sie für den Fürsprecher das berechtigte Segment fest.

**Erwartung für A:**

* Die berechtigte Aktion wird angewendet.
* Die Standardaktion wird übersprungen.

**Durchlauf B (kein Treffer):**

* Legen Sie für den Fürsprecher ein nicht berechtigtes Segment fest.

**Erwartung für B:**

* Die Standardaktion wird angewendet, sofern eine konfiguriert ist.
* Andernfalls wird überhaupt keine passende Aktion ausgelöst.

</details>

<details>

<summary>Provisionsberechnung</summary>

**Ziel:**

* Bestätigen Sie, dass eine Prämie in Form einer Provision anhand des Kaufbetrags berechnet und in der richtigen Währung angezeigt wird.

**Regelkonfiguration:**

* Auslöser: Friend tätigt einen Kauf.
* Aktion: Prämie und E-Mail an den Fürsprecher.
* Eine provisionsbasierte Prämie – ein Prozentsatz des Kaufbetrags – in der Währung der Transaktion.

**Durchlauf A und B:**

* Zwei unterschiedliche Kaufbeträge, dieselbe Währung.

**Erwartetes Ergebnis für A und B:**

* Bei jedem Durchlauf wird der Provisionssatz korrekt auf den jeweiligen Betrag angewendet.

**Durchlauf C (falls Ihr Programm mehrere Währungen unterstützt):**

* Derselbe Betrag wie bei Durchlauf A, aber in einer anderen Währung.

**Erwartetes Ergebnis für C:**

* Die Provision wird korrekt berechnet und in der neuen Währung angezeigt.
* So lässt sich die Währungsumrechnung unabhängig von der Betragsberechnung prüfen.

</details>

<details>

<summary>Kein Treffer und keine Standardaktion konfiguriert</summary>

**Ziel:**

* Bestätigen Sie, dass in der Vorschau eindeutig keine Aktion angezeigt wird, wenn keine Bedingung zutrifft und es keine Ausweichaktion gibt.

**Regelkonfiguration:**

* Eine zeitbasierte Aktion ohne konfigurierte Standardaktion.

**Testeingaben:**

* Legen Sie ein Startdatum für die Empfehlung fest, das außerhalb des Zeitfensters liegt.

**Erwartetes Ergebnis:**

* Das Zeitfenster trifft nicht zu.
* Es ist keine Standardaktion als Ausweichlösung verfügbar.
* In der Vorschau wird eindeutig angezeigt, dass keine passende Aktion ausgeführt wird.

</details>

<details>

<summary>Kein Treffer, weil eine Regelbedingung nicht erfüllt ist</summary>

**Ziel:**

* Bestätigen Sie, dass die Vorschau keine Aktion anzeigt, wenn die Bedingungen der Regel selbst nicht erfüllt sind – und nicht nur, wenn das Zeitfenster nicht zutrifft.

**Regelkonfiguration:**

* Eine Regel mit zwei Bedingungen für das auslösende Ereignis: ein bestimmtes Kaufereignis und ein Mindestkaufbetrag.

**Testeingaben:**

* Geben Sie ein nicht passendes Kaufereignis, einen Betrag unterhalb des Mindestbetrags oder beides ein.

**Erwartetes Ergebnis:**

* Keine Regelbedingung ist erfüllt.
* In der Vorschau wird eindeutig angezeigt, dass nichts geschieht.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/test-your-advocate-program.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
