Kwiga Help Center Dienste, Integrationen, API, Einstellungen Allgemeine Einstellungen Verwendung von Variablen im Projekt, Liste verfügbarer Variablen

Verwendung von Variablen im Projekt, Liste verfügbarer Variablen

Artikel:

vor 8 Monaten • Aktualisiert

Dieser Artikel erklärt, wie man Variablen im Projekt verwendet – wo sie eingesetzt werden können, welche Daten verfügbar sind und wie sie zur Automatisierung und Personalisierung genutzt werden. Enthält eine Liste mit Beschreibungen und Beispielen für E-Mails, Webhooks, Schaltflächen, Lektionen und mehr.

Allgemeine Informationen zu Variablen

Variablen sind eine praktische Möglichkeit, personalisierte Daten in verschiedene Elemente Ihres Projekts einzufügen. Sie können an folgenden Stellen verwendet werden:

1. Webhooks in Automatisierungen

Variablen können eingefügt werden:

in der Webhook-URL, zum Beispiel:
https://example.com/hook?user={user.email}
in den Anfrage-Body-Parametern
in den Headern

Dies ermöglicht es, persönliche Daten automatisch an Drittdienste zu übermitteln.

2. CTA (Call to Action)

In Buttons und Links können Variablen verwendet werden für:

die Personalisierung des Button-Textes
die Übermittlung von Daten über Links, zum Beispiel Benutzer-ID oder UTM-Tags

3. In Parametern

Variablen können in Formularparametern oder anderen Elementen verwendet werden:

E-Mail des Benutzers
Abonnement-ID
einzigartige Codes und Tags
jede andere Variable, die im Kontext verfügbar ist

4. In der Redirect-URL (wenn keine Zahlung erfolgt)

Variablen können manuell in die Redirect-URL eingefügt werden:

https://my.site.com/thanks?email={user.email}&course={course.title}

5. In der Weiterleitungs-URL nach erfolgreicher Angebotszahlung

In der Weiterleitungs-URL nach erfolgreicher Angebotszahlung sind Variablen aus den Blöcken contact.*, order.* und payment.* verfügbar

Beispiel: https://my.site.com/success?order_id={order.id}&email={contact.email}&payment_price={payment.price}

5. In Infoblöcken von Lektionen

Variablen und bedingte Blöcke funktionieren innerhalb der Texte von Infoblöcken. Zum Beispiel:

Anrede mit Namen: Hallo, {user.first_name}!
Ausgabe des Kursnamens, Datums, Status usw.
Kontaktdaten: {contact.name}, {contact.email} und andere Felder
Daten der aktuellen Lektion: {lesson.title}, {lesson.slug} und andere Felder der Lektion
Bedingte Blöcke @if/@endif: unterschiedlichen Inhalt anzeigen, je nachdem, ob der Kontakt ein Tag, Zugriff auf das Angebot usw. hat.

6. In E-Mails

Die Verwendung von Variablen in E-Mails ermöglicht eine personalisiertere und effektivere Kommunikation. Mithilfe von Variablen wie {имя}, {дата} oder {название курса} wirkt die E-Mail so, als wäre sie persönlich an den Kunden adressiert. Das erhöht das Vertrauen, die Interaktion und die Wahrscheinlichkeit, dass der Nutzer die E-Mail bis zum Ende liest oder die gewünschte Aktion ausführt. Darüber hinaus vereinfachen Variablen die Automatisierung von Massenmailings, ohne dass der individuelle Ansatz verloren geht.

7. In den Benachrichtigungen

Beim Einrichten von Benachrichtigungen in Automatisierungsaktionen ermöglichen Variablen das dynamische Einfügen von Informationen in Benachrichtigungen, wie z.B. Benutzername, Bestellnummer oder Angebotsname. Dies vereinfacht und beschleunigt den Erstellungsprozess von Benachrichtigungen, wodurch sie intuitiver und anpassungsfähiger für verschiedene Szenarien werden.

Liste der verfügbaren Variablen

Liste der verfügbaren Variablen, die an allen Stellen verfügbar sind, an denen Variablen verwendet werden können.

Variable	Wert
contact.id	Kontakt-ID
contact.user_id	Benutzer-ID
contact.first_name	Kontaktname
contact.last_name	Kontaktnachname
contact.middle_name	Zweiter Vorname des Kontakts
contact.name	Vollständiger Kontaktname
contact.email	Kontakt-E-Mail
contact.phone	Kontakttelefon
contact.country	Kontaktland. Zum Beispiel: Ukraine
contact.timezone	Kontaktzeitzone. Zum Beispiel: Europe/Kyiv
contact.currency	Kontaktwährung. Zum Beispiel: USD
contact.city	Kontaktstadt
contact.utm_source	Liste der einzigartigen utm_source des Kontakts (Trennzeichen ", ")
contact.utm_medium	Liste der einzigartigen utm_medium des Kontakts (Trennzeichen ", ")
contact.utm_campaign	Liste der einzigartigen utm_campaign des Kontakts (Trennzeichen ", ")
contact.utm_term	Liste der einzigartigen utm_term des Kontakts (Trennzeichen ", ")
contact.utm_content	Liste der einzigartigen utm_content des Kontakts (Trennzeichen ", ")
contact.field_<id>	Benutzerdefinierte Felder (Beschreibung unten)
datetime	Datum und Uhrzeit in UTC im Format YYYY-MM-DD HH:mm:ss
contact.visit_source	Besuchsquelle
Diese Variablen sind in der Weiterleitungs-URL nach erfolgreicher Angebotszahlung verfügbar.

Benutzerdefinierte Felder

{contact.field_<id>}

Beispiel {contact.field_123}

<id> - ID des Feldes, das in den Kontakteinstellungen abgerufen werden kann (Beispiel https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Wie man den Wert einer Variablen ändert

Nach der Variablen können Optionen hinzugefügt werden, um ihre Darstellung zu ändern: Text ergänzen, Buchstaben großschreiben oder das Datum formatieren.

Allgemeine Form: {variable|option:value|option}. Zum Beispiel: {order.id|prefix:ORDER-} oder {payment.paid_at|format:DD.MM.YYYY}.

Was möchten Sie erhalten	Was soll geschrieben werden
Text vor dem Wert hinzufügen	`{order.id\|prefix:ORDER-}` -> ergibt `ORDER-123`
Text nach dem Wert hinzufügen	`{order.id\|suffix:-EU}` -> ergibt `123-EU`
Nummer auf eine feste Länge bringen	`{payment.number\|pad:6}` -> ergibt `000001`
Nicht mit Nullen auffüllen, sondern mit einem eigenen Zeichen	`{payment.number\|pad:6\|padchar:_}` -> ergibt `_____1`
Alle Buchstaben großschreiben	`{contact.city\|upper}` -> `KYIV`
Alle Buchstaben kleinschreiben	`{contact.city\|lower}` -> `kyiv`
Nur den ersten Buchstaben großschreiben	`{contact.city\|ucfirst}` -> `Kyiv`
Datum im gewünschten Format anzeigen	`{payment.paid_at\|format:DD.MM.YYYY}` -> ergibt `24.12.2026`

Wenn Sie ein eigenes Datumsformat möchten, können Sie die fertigen Bezeichnungen in den öffentlichen Referenzen nachsehen: Für Varianten wie DD.MM.YYYY, MMMM YYYY, dddd eignet sich die Carbon-Dokumentation. Für Varianten wie Y-m-d und H:i:s eignet sich die offizielle PHP-Dokumentation.

Wichtig: Wenn pad verwendet wird, wird der Wert zuerst auf die gewünschte Länge aufgefüllt und erst danach werden die übrigen Optionen angewendet.

Bedingte Blöcke @if / @endif

Ermöglichen es, einen Teil des Textes abhängig von einer Bedingung anzuzeigen oder auszublenden. Wenn die Bedingung wahr ist, wird der Block angezeigt; andernfalls wird er vollständig entfernt.

Syntax: @if(Bedingung)...Text...@endif

Beispiel:
@if({contact.has|offer:123})Erhalten Sie Zugriff auf die Materialien@endif

Die Bedingung innerhalb von @if() ist eine beliebige Variable, die true oder false zurückgibt. Derzeit wird {contact.has|...} unterstützt (Prüfung der Zugehörigkeit eines Kontakts).

Bedingung contact.has — Kontaktprüfung

Ermöglicht zu prüfen, ob ein Kontakt bestimmten Bedingungen entspricht. Gibt true oder false zurück. Wird normalerweise zusammen mit bedingten Blöcken @if/@endif verwendet.

Syntax: {contact.has|Typ:Wert}

Typ	Wert	Beschreibung
`offer`	Angebots-ID	Der Kontakt hat Zugriff auf das Angebot
`order`	Bestell-ID	Der Kontakt hat eine Bestellung mit dieser ID
`product`	Produkt-ID	Der Kontakt hat Zugriff auf das Produkt
`tag`	ID oder Name des Tags	Der Kontakt hat einen Tag (kyrillische Zeichen und Leerzeichen im Namen werden unterstützt)
`list`	Listen-ID	Der Kontakt ist in der Liste enthalten
`course`	Kurs-ID	Der Kontakt ist für den Kurs angemeldet
`marathon`	Kurs-ID	Alias für course (Marathon — ein Untertyp des Kurses)
`webinar`	Webinar-ID	Der Kontakt hat Zugriff auf das Webinar
`closed_group`	ID der geschlossenen Gruppe	Der Kontakt hat Zugriff auf die geschlossene Gruppe

Es können mehrere Bedingungen über | angegeben werden — alle müssen gleichzeitig erfüllt sein (AND-Logik). Zum Beispiel: {contact.has|offer:123|tag:VIP}

Anwendungsbeispiele:

{contact.has\|offer:123}	prüft, ob ein Angebot mit der ID 123 vorhanden ist
{contact.has\|tag:VIP}	prüft den Tag nach Name
{contact.has\|tag:тест тег}	Tag mit Leerzeichen und Kyrillisch
{contact.has\|offer:123\|tag:VIP}	beide Bedingungen gleichzeitig (AND)

Variablen, die zusätzlich in CTA verwendet werden können

in Parametern
in der Redirect-URL (wenn keine Zahlung erfolgt)

Variable	Wert
first_name	Vorname aus der Anfrage
last_name	Nachname aus der Anfrage
middle_name	Vatersname aus dem Antrag
name	Vollständiger Name aus der Anfrage
email	Email aus der Anfrage
phone	Telefon aus der Anfrage
field_<id>	Benutzerdefinierte Felder Telefon aus dem Antrag (Beschreibung unten)
utm_source	utm_source - genau von dem Besuch, von dem die Anfrage hinterlassen wurde
utm_medium	utm_medium - genau von dem Besuch, von dem die Anfrage hinterlassen wurde
utm_campaign	utm_campaign - genau von dem Besuch, von dem die Anfrage hinterlassen wurde
utm_term	utm_term - genau von dem Besuch, von dem die Anfrage hinterlassen wurde
utm_content	utm_content - genau von dem Besuch, von dem die Anfrage hinterlassen wurde
widget_landing	Url der Landingpage, von der die Anfrage gesendet wurde
widget_landign_referer	Referer, der auf der Landingpage war, als die Anfrage gesendet wurde
In bestimmten Formularen können auch die unten beschriebenen Variablen in den Automatisierungs-Webhooks verfügbar sein Nach Bestellung ({order.}) - Wenn die Option Zugriff auf Produkt (Vollzugriff/Nach Angebot) im Formular ausgewählt ist Nach Produkt({product.}) - Wenn die Option Zugriff auf Produkt + Vollzugriff im Formular ausgewählt ist Nach Angebot ({offer.*}) - Wenn die Option Zugriff auf Produkt + Nach Angebot im Formular ausgewählt ist

Benutzerdefinierte Felder

{field_<id>}

Beispiel {contact.field_123}

<id> - ID des Feldes, das in den Kontakteinstellungen abgerufen werden kann (Beispiel https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Wenn auf der Seite, auf der der CTA oder das Kwiga-Skript zur Besucherverfolgung platziert ist, Besuche mit UTM-Tags stattfanden und der Kunde das Formular auf der Landingpage ohne UTM-Tags ausgefüllt hat, fehlen diese Variablen. Sie sind jedoch in den oben beschriebenen Variablen {contact.utm_...} verfügbar.

Variablen verfügbar in Automatisierungs-Webhooks (URL, Parameter, E-Mails)