Fullstack experiments

Mit dem Browser-Snippet entscheidet ABlyft im Browser des Visitors, welche Variation angezeigt wird. FullStack ist für Fälle, in denen die Entscheidung oder die Änderung selbst woanders stattfinden muss: auf deinem Server, in deinen Backend-Templates oder in deiner eigenen App. Typische Beispiele sind Suchranking, Preis- oder Sortierlogik.

Dafür veröffentlicht ABlyft eine Config file mit deinen laufenden Experiments, Variations und dem Targeting. Deine Anwendung liest diese Datei, wendet deinen eigenen Variation-Code an und meldet Conversions zurück.

So funktioniert esCopy Anchor Link

1. Du aktivierst FullStack für das Project und für jedes Experiment, das es nutzen soll.
2. Du erstellst Variations vom Typ FullStack und gibst ihnen Properties (Key-Value-Paare).
3. Beim Publishing schreibt ABlyft die Config file an eine öffentliche URL.
4. Deine Anwendung lädt die Datei, entscheidet, welche Variation ein Visitor erhält, und wendet die Properties der Variation an.
5. Deine Anwendung sendet Goals an ABlyft zurück, sodass Results wie bei jedem anderen Experiment erscheinen.

Schritt 1: FullStack für das Project aktivierenCopy Anchor Link

Gehe in deinem Project zu Settings → FullStack. Der Menüeintrag erscheint nur, wenn dein Plan FullStack enthält.

Die rechte Seite der Seite zeigt die Config File Implementation: die Config file URL (zum Kopieren anklicken), die Project ID, File size, Project revision und Last published. Wenn du Environments mit aktiviertem Create a sub-snippet hast, listet Sub Config Files eine zusätzliche Datei pro Environment auf. Jede enthält nur die Experiments dieses Environments.

Die URL hat diese Form:

https://fullstack.ablyft.com/c/{secretPrefix}-{projectId}.json

Für eine Environment-Datei wird vor .json ein -{environment API name} angehängt.

Schritt 2: FullStack für ein Experiment aktivierenCopy Anchor Link

1. Öffne das Experiment und seine Einstellungen (Zahnrad-Symbol).
2. Aktiviere im Abschnitt General den Schalter Enable FullStack for this experiment. Der Toggle ist nur sichtbar, wenn FullStack für das Project aktiviert ist. Das Experiment wird zur Config file hinzugefügt, und der Variation-Typ FullStack wird verfügbar.

Schritt 3: FullStack-Variations erstellenCopy Anchor Link

1. Erstelle im Experiment eine Variation und wähle den Typ FullStack.
2. Füge im Abschnitt FullStack Variation properties hinzu: Key-Value-Paare, die deine Anwendung erhält, zum Beispiel color = blue oder price_variant = premium.
3. Speichere.

Die Properties werden als data der Variation in der Config file ausgeliefert. Eine FullStack-Variation kann außerdem JS- und CSS-Code haben, siehe Custom JavaScript.

Was die Config file enthältCopy Anchor Link

Die Datei wird bei jedem Publishing des Projects neu erzeugt. Sie enthält alle Experiments des Projects mit dem Status running oder preview und für jedes Experiment seine Variations, Audiences, Environments und Pages.

{
  "project_id": 12345678,
  "project_name": "example.com",
  "debug_enabled": false,
  "published_at": "2026-01-15T10:30:00.000000Z",
  "stale_experiment_ids": [],
  "experiments": [
    {
      "id": 87654321,
      "status": "running",
      "api_name": "pricing-test",
      "name": "Pricing test",
      "traffic_allocation": 100,
      "audiences_match_type": "any",
      "metadata": [],
      "variations": [
        {
          "id": 11111111,
          "api_name": "original",
          "name": "Original",
          "baseline": true,
          "traffic_allocation": 50,
          "metadata": [],
          "data": {}
        },
        {
          "id": 22222222,
          "api_name": "premium",
          "name": "Premium price",
          "baseline": false,
          "traffic_allocation": 50,
          "metadata": [],
          "data": { "price_variant": "premium" }
        }
      ],
      "audiences": [],
      "environments": [],
      "pages": []
    }
  ],
  "exclusion_groups": [],
  "goals": [
    { "id": 33333333, "api_name": "purchase", "type": "revenue" }
  ]
}

Die Werte sind beispielhaft; die Feldnamen sind die, die ABlyft schreibt. Hinweise:

• audiences enthalten die Targeting-Definition jeder Audience, pages enthalten id und api_name.
• goals listet die Goals auf, die von den exportierten Experiments verwendet werden, mit id, api_name und type.
• exclusion_groups werden mit ihren Einträgen exportiert (experiment_id, traffic).
• stale_experiment_ids listet archivierte Experiments auf (in den letzten 6 Monaten archiviert, mit Participants). Das unterstützt das Aufräumen gespeicherter Visitor-Zuweisungen.

Was deine Anwendung tutCopy Anchor Link

ABlyft veröffentlicht die Datei, die Logik drumherum liegt in deiner Anwendung:

1. Lade die Config file (cache sie für die Dauer der Cache Expiration).
2. Entscheide für jeden Visitor, ob ein Experiment greift (Pages, Audiences, Environments, Traffic Allocation), und weise eine Variation zu anhand der Traffic Allocation der Variations. Speichere die Zuweisung pro Visitor, damit der Visitor immer dieselbe Variation sieht.
3. Wende die Variation an, anhand ihrer data-Properties.
4. Melde Goals an ABlyft zurück.

Für den letzten Punkt und für die Entscheidungslogik kontaktiere den ABlyft-Support, um die aktuellen Integrationsoptionen für deinen Account zu erfahren. Die Dokumentation der Feature Experimentation API beschreibt dafür zwei HTTPS-Endpoints: https://fe-api.ablyft.com/v1/decide (welche Variation erhält ein User?) und https://fe-api.ablyft.com/v1/track (Goals senden). Aufrufe werden mit einem API-Token authentifiziert (Authorization: Bearer [token]), und die aktuelle Zuweisung des Visitors wird als user.bucketing übergeben. Diese API wird auf Anfrage angeboten, bestätige also die Verfügbarkeit beim ABlyft-Support, bevor du darauf aufbaust.

FullStack- und Browser-Experiments mischen (hybrid)Copy Anchor Link

Du kannst Browser-Experiments und serverseitige Experiments für dieselben Visitors ausführen. Wichtig ist, dass der Visitor eine konsistente Zuweisung hat. Im Browser speichert ABlyft sie in ablyft_exps im konfigurierten Storage (siehe Storage & privacy). Auf der API-Seite sind es dieselben Informationen als user.bucketing. Stimmen beide überein, bleiben Tracking und Visitor-Erlebnis korrekt. Du kannst die Zuweisung im Browser mit ablyft.get('bucketing') auslesen, siehe die get()-Referenz.

Nächste SchritteCopy Anchor Link