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

API & Datenstruktur

Es gibt 3 Möglichkeiten, eine Verbindung zu unserer API herzustellen:



Welche Daten die API zurückgibt


Die API gibt pro Teilnahme einen Datensatz zurück: die Formulardaten, das Ergebnis (Punktzahl, Profil oder Gewinn) und technische Felder, wie in der folgenden Tabelle aufgeführt. Die einzelnen Antworten auf die Fragen eines Quiz oder einer Umfrage werden nicht zurückgegeben. Um alle Antworten einzusehen, nutze den Datenexport deiner App. Dort hat jede Frage eine eigene Spalte.


Du möchtest die Ergebnisse live auf einem großen Bildschirm anzeigen, zum Beispiel bei einer Veranstaltung? Nutze die Spieler-Rangliste: Sie hat einen eigenen Link, wird nach jeder Teilnahme in Echtzeit aktualisiert und lässt sich auf einem separaten Bildschirm anzeigen.


API-Datenstruktur


So könnte die Spalte Datenbeispiel mit typischen Werten für die jeweiligen Felder aussehen:


Schlüssel

Beschreibung

Datenbeispiel

Id

Eindeutige ID.

123456

appId

ID der App.

123456

appRef

Interne Referenz der App.

my campaign

idunic

Erfasste Daten aus dem Feld für die eindeutige ID.

ABC123XYZ

gender

Erfasste Daten aus dem Feld „Geschlecht“.

Male / Female / Prefer not to say

username

Erfasste Daten aus dem Feld „Benutzername“.

johndoe

firstName

Erfasste Daten aus dem Feld „Vorname“.

John

lastName

Erfasste Daten aus dem Feld „Nachname“.

Doe

email

Erfasste Daten aus dem Feld „E-Mail“.

johndoe@example.com

dob

Erfasste Daten aus dem Feld „Geburtsdatum“.

1990-01-01T00:00:00+01:00

address

Erfasste Daten aus dem Feld „Adresse“.

123 Main St, Apt 4B

cp

Erfasste Daten aus dem Feld „Postleitzahl“.

12345

town

Erfasste Daten aus dem Feld „Stadt“.

New York

country

Erfasste Daten aus dem Feld „Land“.

United States

phoneNumber

Erfasste Daten aus dem Feld „Telefonnummer“.

+12025550199

companyName

Erfasste Daten aus dem Feld „Firmenname“.

Example Corp.

website

Erfasste Daten aus dem Feld „Website“.

https://www.example.com

optinNewsletter

Erfasste Daten aus dem Opt-in-Kontrollkästchen.

true / false

customText

Erfasste Daten aus dem benutzerdefinierten Textfeld.

Benutzerdefinierter Eingabewert

customFormat

Erfasste Daten aus dem Feld mit benutzerdefiniertem Format.

Benutzerdefinierter Eingabewert

profil

Ergebnisprofil bei einem Persönlichkeitstest, Quiz oder einer Umfrage.

Explorer

profilUid

Eindeutige Profil-ID bei einem Persönlichkeitstest, Quiz oder einer Umfrage.

EXPL123

score

Punktzahl des Benutzers bei einer punktebasierten App.

85

prizeUid

UID des Gewinns. Wurde kein Preis gewonnen, wird lost zurückgegeben.

0f8e4a298ba5c036c7db5e5ef1ce422e85ceb5e3 / lost

prizeTitle

Titel des Preises, der erfasst wird, wenn der Benutzer einen Preis gewonnen hat.

Gold Membership

prizeRef

Preisreferenz, die erfasst wird, wenn der Benutzer einen Preis gewonnen hat.

GOLD2023

code

Vom Benutzer gewonnener Code.

WIN12345

date

Server-Zeitstempel.

2024-11-10T19:09:32+01:00

publisherId

ID des Herausgebers.

PUB123

sessionId

Sitzungs-ID des Benutzers.

Session_296c9d74f159eacf374a2ac4e9d6f028

countryCode

Ländercode auf Grundlage der IP-Adresse des Benutzers.

FR

selectValue

Erfasste Daten aus dem benutzerdefinierten Dropdown-Menü.

Option A

selectValue2

Erfasste Daten aus dem zweiten benutzerdefinierten Dropdown-Menü.

Option B

customCheckbox

Erfasste Daten aus der benutzerdefinierten Liste mit Kontrollkästchen. Bei Mehrfachauswahl werden die Werte durch einen senkrechten Strich getrennt. (∣)

Option 1 ∣ Option 2

timeTaken

Vom Benutzer in der App verbrachte Zeit in Sekunden.

360

levelsPlayed

Gesamtzahl der vom Benutzer abgeschlossenen Level in Combo™-, Dynamic Path™- oder Adventskalender-Erlebnissen. Bei allen anderen Spieltypen wird null zurückgegeben.

123456

referral

Herkunft des Traffics.

direct

updatedAt

Datum der letzten Aktualisierung der Daten.

2024-11-10T19:09:32+01:00

connectionCountry

Land auf Grundlage der IP-Adresse des Benutzers.

France

updatedAtTimeStamp

Zeitstempel der letzten Aktualisierung der Daten.

1731262172

dateWithTimezone

In die Zeitzone der App umgerechneter Zeitstempel.

2024-11-10T17:09:32+01:00

played

Gibt true zurück, wenn der Benutzer die Spielmechanik gespielt hat, andernfalls false.

true / false

locale

Während der Teilnahme verwendete Sprache der App.

en

ipAddress

IP-Adresse des Benutzers.

192.168.1.1

Aktualisiert am: 19/10/2026

War dieser Beitrag hilfreich?

Teilen Sie Ihr Feedback mit

Stornieren

Danke!