„Lebenslange Kampagnen verwenden“

Was Ihnen diese Seite dabei hilft

Erstellen Sie eine lebenslange Kampagne, die für Ereignisse aus Ihrem System bereit bleibt. Jeder gültige Auslöser erstellt höchstens eine Ausführung und sendet einen Anstoß an den Kontakt in seiner Nutzlast.

Warum das wichtig ist

Sie können zeitnah relevante E-Mails senden, ohne wiederholt Kampagnen erstellen und starten zu müssen. Ihr Backend steuert, wann ein Ereignis eintritt, während Nudgen den E-Mail-Inhalt, die Zustellung, die Nachverfolgung und die Kontaktpräferenzen an einem Ort speichert.

Wann Sie eine Lifetime-Kampagne verwenden sollten

Verwenden Sie eine Lifetime-Kampagne für ereignisgesteuerte E-Mails, wie zum Beispiel:

Bestellbestätigungen
Zahlungserinnerungen
Ereignisbasiertes Onboarding
Konto- oder Abonnementaktualisierungen

Im Gegensatz zu One-Shot- und Drip-Kampagnen a Die lebenslange Kampagne wird nicht sofort an eine gespeicherte Zielgruppe gesendet. Seine Zielgruppe ist immer Trigger.

Erstellen und aktivieren Sie eine Kampagne

Create a Lifetime campaign

Gehen Sie zu Kampagnen, klicken Sie auf Neue Kampagne und wählen Sie dann Lebensdauer. Fügen Sie den Kampagnennamen, das Ziel, die Markenkonfiguration und den optionalen CTA-Link hinzu.

Define runtime parameters

Fügen Sie jeden Wert hinzu, den Ihr System zum Zeitpunkt des Versands bereitstellt. Ein Parameter erstellt eine data.*-Variable: Beispielsweise wird order_id in der E-Mail zu {{data.order_id}}.

Create the email

Generieren oder schreiben Sie den Betreff und den HTML-Code und fügen Sie dann Ihre Laufzeitvariablen dort hinzu, wo sie hingehören. Sehen Sie sich die E-Mail in der Vorschau an und senden Sie einen Test, bevor Sie sie aktivieren.

Activate the campaign

Speichern Sie es als Entwurf und klicken Sie dann auf Aktivieren. Nudgen prüft, ob erforderliche Parameter in der E-Mail dargestellt sind und dass sich der Parametervertrag seit der Generierung nicht geändert hat.

Create a trigger key

Gehen Sie zu Einstellungen → API-Schlüssel und erstellen Sie einen Team-Trigger-API-Schlüssel. Speichern Sie das ndg_team_*-Geheimnis in Ihrem Backend oder Geheimmanager. Platzieren Sie es niemals im Browser- oder Mobile-App-Code.

Laufzeitparameter und Vorlagenvariablen

Ihr variableManifest ist der Vertrag zwischen der E-Mail-Vorlage und dem data-Objekt jedes Triggers. Eine Kampagne kann bis zu 100 Variablen definieren.

Feld	Geben Sie	ein Erforderlich	Beschreibung
`path`	`data.<name>`	Ja	Variabler Pfad. Verschachtelte Pfade wie `data.order.total` werden unterstützt.
`type`	`string`, `number`, `boolean`, `date` oder `url`	Ja	Geben Sie den Trigger ein, den er bereitstellen muss. Ein `date` muss eine gültige Datumszeichenfolge sein und ein `url` muss HTTP(S) sein.
`required`	boolescher Wert	Ja	Fehlende Werte geben `422` zurück, sofern kein Standardwert festgelegt ist.
`defaultValue`	Zeichenfolge, Zahl oder boolescher Wert	Nein	Fallback-Wert, der mit dem Variablentyp übereinstimmen muss.
`description`	Zeichenfolge	Nein	Erklären Sie den Wert, damit Sie und Nudgen AI ihn richtig nutzen können.

Verwenden Sie beispielsweise {{data.order_id}}, {{data.total}} und {{data.order_url}} in einer Vorlage. Sie können auch contact.*, event.*, brand.* und Legacy-Variablen wie {{firstName}} und {{brandName}} verwenden. Nudgen maskiert in HTML eingefügte Variablenwerte. Vorlagen unterstützen kein JavaScript, keine Ausdrücke oder Schleifen. Jede in einem href verwendete Variable muss eine data.*-Variable sein, die mit dem Typ url deklariert wurde.

Verwalten Sie den Lebenszyklus

Status	Was es bedeutet
Entwurf	Konfigurieren Sie die Kampagne und testen Sie ihre E-Mail.
Aktiv	Nudgen akzeptiert authentifizierte Auslöser.
Pausiert	Nudgen akzeptiert keine neuen Auslöser. Sie können es fortsetzen.
Archiviert	Die Kampagne ist dauerhaft geschlossen und kann nicht erneut aktiviert werden.

Die gültigen Übergänge sind draft → active → paused → active und active|paused → archived.

Durch das Anhalten oder Archivieren werden Ausführungen abgebrochen, die noch ausstehen oder in der Warteschlange stehen. Eine Ausführung, die bereits verarbeitet wird, sendet möglicherweise noch.

Bei jeder Ausführung werden Snapshots des Kampagneninhalts und der Sendeeinstellungen erstellt, wenn Nudgen den Auslöser empfängt. Das Bearbeiten einer aktiven Kampagne wirkt sich nur auf spätere Trigger aus, nicht auf bereits vorhandene Ausführungen.

Trigger von Ihrem Backend

Rufen Sie den Trigger-Endpunkt von einem vertrauenswürdigen Server aus auf, nachdem Sie das Quellereignis validiert haben. Verwenden Sie den Team-Trigger-API-Schlüssel und kein persönliches Zugriffstoken (PAT).

curl -X POST "$NUDGEN_APP_URL/api/v1/campaigns/$CAMPAIGN_ID/triggers" \
  -H "Authorization: Bearer $NUDGEN_TEAM_API_KEY" \
  -H "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "eventId": "order_123",
  "eventName": "order.created",
  "occurredAt": "2026-08-23T10:00:00Z",
  "contact": {
    "email": "an@example.com",
    "externalId": "customer_456",
    "name": "An Nguyen",
    "metadata": { "company": "Nudgen" }
  },
  "data": {
    "order_id": "order_123",
    "total": 490000,
    "order_url": "https://example.com/orders/order_123"
  }
}
JSON

Behalten Sie den gleichen eventId bei, wenn Sie ein Ereignis erneut versuchen. Nudgen gibt die vorhandene Ausführung mit 200 und duplicate: true zurück, anstatt einen weiteren Nudge zu senden. Eine neue Ausführung gibt 201 zurück.

Sicher integrieren

Von einem Webhook-Consumer oder Backend auslösen und den eingehenden Webhook überprüfen, bevor Nudgen aufgerufen wird.
Netzwerkfehler, 429 und 503 mit exponentiellem Backoff und demselben eventId erneut versuchen.
Protokollieren Sie keine Authorization-Header oder Payloads, die vertrauliche Kontaktdaten enthalten.
Wechseln Sie Triggerschlüssel regelmäßig und widerrufen Sie einen Schlüssel sofort, wenn Sie den Verdacht haben, dass er offengelegt wird.
Erstellen Sie eine Kampagne pro Ereignistyp und Variablenvertrag, damit Vorlagen und Ausführungsprüfungen übersichtlich bleiben.

Überwachen Sie Ausführungen

Öffnen Sie die Kampagne im Dashboard, um aktuelle Ausführungen und deren Status anzuzeigen. Eine Ausführung kann pending, queued, processing, sent, skipped, cancelled, failed oder sein delivery_unknown. skipped bedeutet, dass der Kontakt abgemeldet oder zurückgesendet wurde, sodass Nudgen das Ereignis aufzeichnet, aber kein Kontingent sendet oder verbraucht. delivery_unknown bedeutet, dass der Anbieter die E-Mail möglicherweise akzeptiert hat, das endgültige Zustellungsergebnis jedoch ungewiss war; Nudgen versucht es nicht automatisch erneut, um einen doppelten Versand zu vermeiden. Informationen zu programmatischen Setup-, Trigger- und Ausführungsabfragen finden Sie in der Entwickler-API.

Campaigns overview

Vergleichen Sie One-Shot-, Drip- und Lifetime-Kampagnen.

Developer API

Verwalten Sie Lifetime-Kampagnen und Trigger über die API.

Erste Schritte

Kontakte

Kampagnen

Marke

Dashboard

Einstellungen

Abrechnung

Affiliate

Agents

E-Mail-Finder (Erweiterung)

Signatur-Generator

Spam-Checker

E-Mail-Zustellbarkeits-Audit

Konzepte

Fehlerbehebung

Sicherheit & Datenschutz

„Lebenslange Kampagnen verwenden“

Was Ihnen diese Seite dabei hilft

Warum das wichtig ist

Wann Sie eine Lifetime-Kampagne verwenden sollten

Erstellen und aktivieren Sie eine Kampagne

Laufzeitparameter und Vorlagenvariablen

Verwalten Sie den Lebenszyklus

Trigger von Ihrem Backend

Sicher integrieren

Überwachen Sie Ausführungen

Verwandte Dokumente

Campaigns overview

Developer API

​Was Ihnen diese Seite dabei hilft

​Warum das wichtig ist

​Wann Sie eine Lifetime-Kampagne verwenden sollten

​Erstellen und aktivieren Sie eine Kampagne

​Laufzeitparameter und Vorlagenvariablen

​Verwalten Sie den Lebenszyklus

​Trigger von Ihrem Backend

​Sicher integrieren

​Überwachen Sie Ausführungen

​Verwandte Dokumente

Campaigns overview

Developer API

Was Ihnen diese Seite dabei hilft

Warum das wichtig ist

Wann Sie eine Lifetime-Kampagne verwenden sollten

Erstellen und aktivieren Sie eine Kampagne

Laufzeitparameter und Vorlagenvariablen

Verwalten Sie den Lebenszyklus

Trigger von Ihrem Backend

Sicher integrieren

Überwachen Sie Ausführungen

Verwandte Dokumente