Artikel über: Entwickler und APIs
Dieser Artikel ist auch verfügbar in:

Makros

Unsere Plattform unterstützt Makros für Call-to-Action-Links (CTA-Links). Damit können Sie dynamische Werte einfügen, die automatisch ausgefüllt werden. Das vereinfacht Ihre Arbeitsabläufe und sorgt für ein persönlicheres Nutzererlebnis.


Was ist ein Makro?


Ein Makro ist ein vordefinierter Platzhalter oder Code, der automatisch durch einen bestimmten Wert oder eine Reihe von Werten ersetzt wird. In Ihren CTA-Links fügen Makros Informationen dynamisch ein. So werden Ihre Links persönlicher und funktionaler, ohne dass Sie sie manuell aktualisieren müssen.


So verwenden Sie Makros in CTA-Links


Makros lassen sich ganz einfach in Ihre CTA-Links einbinden:


  1. Makro auswählen: Wählen Sie das passende Makro aus der folgenden Liste aus.


  1. Makro einfügen: Fügen Sie den Makrocode an der Stelle in Ihren CTA-Link ein, an der der dynamische Wert erscheinen soll.


  1. Speichern und Vorschau prüfen: Speichern Sie Ihre Änderungen und prüfen Sie in der Vorschau, ob das Makro im CTA-Link durch den gewünschten Wert ersetzt wird.


Wo können Makros verwendet werden?


Makros können in jeder URL Ihrer CTA-Links als Abfrageparameter verwendet werden.


So erstellen Sie nützlichere CTA-Links, die automatisch mit den relevanten Informationen aktualisiert werden.


Liste der verfügbaren Makros


Hier finden Sie die verfügbaren Makros und eine Beschreibung ihrer Funktionen:


  1. %SESSION_UID%: Fügt die Sitzungs-UID des Spielers ein.


Beispiel: https://example.com/profile?session=%SESSION_UID%


  1. %APP_ID%: Fügt die ID des aktuellen Spiels ein.


Beispiel: https://example.com/events?game_id=%APP_ID%


Mit diesen Makros bleiben Ihre CTA-Links immer aktuell und personalisiert. Das fördert die Interaktion und verbessert das Nutzererlebnis insgesamt.


Beispiele für Makros im Einsatz


Die folgenden Beispiele veranschaulichen die Verwendung:




So können Sie über den CTA-Link die Sitzung jedes Besuchers eindeutig identifizieren.




So können Sie nachvollziehen, aus welchem Spiel die Besucher über den CTA-Link auf die Zielseite gelangt sind.


Diese Beispiele zeigen, wie Makros Ihre CTAs relevanter machen und Ihnen helfen, auf der verlinkten Zielseite Daten aus Ihrer Anwendung abzurufen.


Makrowerte wie %SESSION_UID% und %APP_ID% lassen sich auf der verlinkten Zielseite auslesen. Anschließend können Sie damit unsere API aufrufen, um die Informationen zum jeweiligen Nutzer abzufragen.


So können Sie anhand der Makrowerte umfangreiche Nutzerdaten dynamisch abrufen und anzeigen – für ein personalisiertes und reibungsloses Nutzererlebnis.


Verfügbare Makros


Makro

Funktion

%SESSION_UID%

Gibt die aktuelle Sitzungs-ID des Nutzers zurück.

%APP_ID%

Gibt die App-ID des aktuell gespielten Spiels zurück.

%ID_UNIC%

Gibt die eindeutige Kennung des Nutzers zurück.

%GENDER%

Gibt das Geschlecht des Nutzers zurück.

%USERNAME%

Gibt den Benutzernamen des Nutzers zurück.

%FIRSTNAME%

Gibt den Vornamen des Nutzers zurück.

%LASTNAME%

Gibt den Nachnamen des Nutzers zurück.

%EMAIL%

Gibt die E-Mail-Adresse des Nutzers zurück.

%PHONE_NUMBER%

Gibt die Telefonnummer des Nutzers zurück.

%ADDRESS%

Gibt die Adresse des Nutzers zurück.

%ZIP_CODE%

Gibt die Postleitzahl des Nutzers zurück.

%TOWN%

Gibt den Wohnort des Nutzers zurück.

%COUNTRY%

Gibt das Land des Nutzers zurück.

%DOB%

Gibt das Geburtsdatum des Nutzers im Format YYYY-MM-DD zurück.

%COMPANY_NAME%

Gibt den Firmennamen des Nutzers zurück.

%WEBSITE%

Gibt die Website des Nutzers zurück.

%PROFIL_UID%

Gibt die eindeutige Kennung des Nutzerprofils zurück.

%PROFIL_TITLE%

Gibt den Titel des Nutzerprofils zurück.

%PRIZE_UID%

Gibt die eindeutige Kennung des Gewinns zurück.

%PRIZE_TITLE%

Gibt den Titel des Gewinns zurück.

%PRIZE_REF%

Gibt die Referenz des Gewinns zurück.

%PRIZE_CODE%

Gibt den dem Gewinn zugeordneten Code zurück.

%OPTIN_NEWSLETTER%

Gibt zurück, ob der Nutzer dem Erhalt von Newslettern zugestimmt hat.

%CUSTOM_TEXT%

Gibt den dem Nutzer zugeordneten benutzerdefinierten Text zurück.

%CUSTOM_FORMAT%

Gibt das dem Nutzer zugeordnete benutzerdefinierte Format zurück.

%SCORE%

Gibt die Punktzahl des Nutzers zurück.

%SELECT_VALUE%

Gibt den ersten ausgewählten Wert zurück.

%SELECT_VALUE2%

Gibt den zweiten ausgewählten Wert zurück.

%CUSTOM_CHECKBOX%

Gibt den Wert des benutzerdefinierten Kontrollkästchens zurück.

%TIME_TAKEN%

Gibt die vom Nutzer benötigte Zeit in Sekunden zurück.

%LOCALE%

Gibt die Sprach- und Ländereinstellung des Nutzers zurück.

%REF%

Gibt die Herkunft der Teilnahme zurück: den Parameter ref aus der Spiel-URL, sofern dieser festgelegt wurde, andernfalls die verweisende Domain oder direct, wenn beides nicht vorhanden ist.


Hinweis: Alle zurückgegebenen Makrodaten werden mit rawurlencode verarbeitet, damit sie problemlos in URLs verwendet werden können. Dabei werden Sonderzeichen für die sichere Verwendung in Links kodiert. So bleibt die Funktionalität erhalten, und mögliche Probleme mit reservierten oder unsicheren Zeichen werden vermieden. Ein Leerzeichen wird beispielsweise als %20 dargestellt, und Sonderzeichen wie & werden als %26 kodiert.

Aktualisiert am: 29/10/2026

War dieser Beitrag hilfreich?

Teilen Sie Ihr Feedback mit

Stornieren

Danke!