api-referencePOST
POSThttps://analytics.flowsery.com/analytics/api/v1/goals

Zeichnen Sie ein benutzerdefiniertes Zielereignis auf. Es ist nur der Name erforderlich; Besucher-ID, Sitzungs-ID, Metadaten und Zeitzone sind optional.

Bearer-Token (Workspace-Token oder Website-API-Schlüssel)

Workspace-Tokens benötigen einen Website-Selektor

Workspace-API-Tokens können auf jede Website im Workspace zugreifen. Übergeben Sie entweder <code>websiteId</code> oder <code>domain</code>, damit Flowsery weiß, welche Website abgefragt oder geändert werden muss. Website-API-Schlüssel sind bereits auf eine Website beschränkt, sodass der Selektor weggelassen werden kann.

Website-Auswahl

ParameterTypBeschreibung
websiteIdstringWebsite-ID zur Verwendung mit einem Workspace-API-Token. Fügen Sie dieses Feld in den JSON-Text ein, es sei denn, Sie geben domain an. Bei der Authentifizierung mit einem Website-API-Schlüssel weglassen.
domainstringWebsite domain zur Verwendung mit einem Workspace-API-Token, wenn websiteId nicht bereitgestellt wird. Fügen Sie dieses Feld in den JSON-Text ein. Bei der Authentifizierung mit einem Website-API-Schlüssel weglassen.

Anfrage-Body

ParameterTypBeschreibung
visitorUidstringOptionale Flowsery Besucher-ID, die normalerweise aus dem _fs_vid-Cookie in Ihrem eigenen Backend stammt.
sessionUidstringOptionale Flowsery-Sitzungs-ID, die normalerweise aus dem _fs_sid-Cookie stammt.
nameERFORDERLICHstringZielname (Kleinbuchstaben, Zahlen, Unterstriche und Bindestriche; max. 64 Zeichen).
metadataobjectOptionale benutzerdefinierte Schlüssel-Wert-Paare. Beschränken Sie sich auf maximal 10 Schlüssel.

Regeln fuer das Metadaten-Feld

<strong>Schluessel:</strong> Nur Kleinbuchstaben, Zahlen, Unterstriche (_) und Bindestriche (-). Max. 64 Zeichen.

<strong>Werte:</strong> Beliebige Zeichenkette bis zu 255 Zeichen. HTML- und Skriptinhalte werden aus Sicherheitsgruenden automatisch entfernt.

<strong>Limit:</strong> Bis zu 10 benutzerdefinierte Parameter pro Ereignis.

Kein bestehender Seitenaufruf erforderlich

Das Backend kann den Zieldatensatz bei Bedarf erstellen. Es sollte nicht dokumentiert werden, dass dieser Endpunkt einen zuvor aufgezeichneten Seitenaufruf erfordert.

Fehlerantworten

<strong>400 Bad Request</strong> – Wird zurückgegeben, wenn die Nutzlast ungültig ist.

<strong>404 Not Found</strong> – Nicht Teil des normalen Vertrags zum Erstellen eines Ziels.

Beispielanfrage (Node.js)
const handler = async (req, res) => {
  const _fs_vid = req.cookies._fs_vid;
  const _fs_sid = req.cookies._fs_sid;

  const response = await fetch(
    "https://analytics.flowsery.com/analytics/api/v1/goals",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${FLOWSERY_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        websiteId: process.env.FLOWSERY_WEBSITE_ID,
        visitorUid: _fs_vid,
        sessionUid: _fs_sid,
        name: "newsletter_signup",
        metadata: {
          name: "Elon Musk",
          email: "musk@x.com",
        },
      }),
    }
  );

  const result = await response.json();
  res.status(200).send("Goal tracked");
};
200
{
  "status": "success",
  "data": [{
    "message": "Goal created successfully"
  }]
}