Auf dieser Seite: Erfahren Sie, wie Sie mit der Zielgruppenbestimmungsaktivität „Inkrementelle Abfrage“ bei jeder Ausführung einer orchestrierten Kampagne nur neue Einträge zurückgeben können, ohne die bereits in früheren Ausführungen ausgewählten Profile.
Die Aktivität Inkrementelle Abfrage ist eine Targeting-Aktivität, die bei jeder Ausführung der orchestrierten Kampagne eine Datenbankabfrage ausführt. Wichtig ist, dass bei jeder Ausführung nur Datensätze ausgegeben werden, deren Datumsfeldwert nach dem Datum der vorherigen Ausführung liegt. Auf diese Weise vermeiden Sie das erneute Targeting derselben Personen oder den erneuten Export derselben Zeilen.
Verwenden Sie diese Option, wenn die Kampagne mehrmals ausgeführt werden kann, z. B. eine geplante Kampagne mit wöchentlicher Ausführung, oder wenn sie durch ein externes Signal oder eine API ausgelöst wird. Bei jeder Ausführung werden nur Datensätze berücksichtigt, die nach der vorherigen Ausführung datiert wurden, sodass Duplikate vermieden werden.
Typische Verwendungszwecke:
- Nachrichten und Zielgruppen: Ziehen Sie im nächsten Schritt nur neue Anmeldungen, neue Käufer oder andere Segmente mit dem Status „Neu seit dem letzten Durchgang“ (z. B. E-Mail, Mobile-Nachricht).
- Kontinuierliche Exporte: Senden Sie nur neue oder aktualisierte Zeilen an Dateien für Berichte oder BI-Tools, ohne zu duplizieren, was Sie bereits exportiert haben.
Konfigurieren der Aktivität „Inkrementelle Abfrage“ incremental-query-configuration
Legen Sie die Zielgruppendimension fest, erstellen Sie Ihre Abfrage und wählen Sie aus, wie die Aktivität entscheidet, welche Einträge aus künftigen Ausführungen ausgeschlossen werden sollen.
-
Legen Sie eine Aktivität Inkrementelle Abfrage in Ihrer orchestrierten Kampagne ab.
-
Wählen Sie unter Zielgruppe die Zielgruppendimension aus, z. B. Empfangende, Abonnierende, und klicken Sie auf Weiter. Erfahren Sie mehr zu Zielgruppendimensionen.
-
Klicken Sie auf Bedingung hinzufügen, um die Abfrage zu definieren. Erfahren Sie, wie Sie den Regel-Builder verwenden.
-
Wählen Sie unter Verarbeitete Daten Ihren Pfad zum Datumsfeld aus. Ein Datumsfeld ist erforderlich und das Attribut muss das Format Datum/Uhrzeit verwenden. Jeder Durchgang gibt nur Zeilen zurück, deren Datum nach der letzten Ausführung liegt.
note NOTE Die Eignung hängt nur vom Wert des Datumsfelds ab, nicht vom Zeitpunkt der Aufnahme des Datensatzes. Ein nach der vorherigen Ausführung erfasster Datensatz wird nicht zurückgegeben, wenn sein Datumsfeldwert älter als das Datum dieser Ausführung ist.
Letztes Ausführungsdatum überprüfen incremental-query-last-execution
Nach Ausführung der Aktivität wird das Feld Letztes Ausführungsdatum unter Verarbeitete Daten unter dem Pfad zum Datumsfeld angezeigt. Zeigt Datum und Uhrzeit der vorherigen Ausführung der Aktivität an. Dies ist das für die nächste Ausführung verwendete Stichtag. Dieses Feld ist schreibgeschützt.
Beispiel incremental-query-example
Im folgenden Beispiel wird eine Begrüßungs-E-Mail an Profile gesendet, die gerade Gold-Mitglieder geworden sind. Die Kampagne kann wöchentlich, jeden Montag, ausgeführt werden. Bei jedem Durchgang werden nur Profile berücksichtigt, die sich seit dem vorherigen Durchgang für eine Gold-Mitgliedschaft qualifiziert haben. Daher erhält jede Person die Begrüßungs-E-Mail nur einmal.
- Inkrementelle Abfrage: Wählt Gold-Mitglieder aus. Erste Ausführung: Alle aktuellen Gold-Mitglieder. Spätere Ausführungen: Nur Profile, die seit der vorherigen Ausführung Gold-Mitglieder wurden.
- E-Mail-Versand: Sendet die Begrüßungs-E-Mail an die von der Abfrage ausgegebenen Profile.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to configure the Incremental query targeting activity in an Orchestrated campaign so that each run returns only records whose date field value is later than the previous execution.
Intents:
- Understand what the Incremental query activity does across repeated Orchestrated campaign runs.
- Configure the activity’s targeting dimension and query condition.
- Choose a date field under Processed data so that each run returns only rows dated after the last execution.
- Understand what happens to downstream activities when a run returns no rows.
- Build a “new since last run” audience for messaging or ongoing exports.
Glossary:
- Incremental query: a Targeting activity that runs a database query each time the Orchestrated campaign runs and outputs only records whose date field value is later than the previous execution (product-specific)
- Processed data: the configuration area where you choose how the activity excludes records from earlier runs, for example by using a date field (product-specific)
- Path to the date field: the attribute, in Date Time format, used under Processed data so each run returns only rows whose date is after the last execution (product-specific)
- Last execution date: the field displayed under Processed data, below the Path to the date field, once the activity has run; it shows the date and time of the previous execution and is the cutoff date used by the next run; the field is read-only (product-specific)
- Targeting dimension: the audience type selected for the activity, for example recipients or subscribers (product-specific)
Guardrails:
- When a run returns no rows, the Orchestrated campaign stops at the Incremental query; activities after it are not executed until there is data, when the campaign runs again.
- A date field is required under Processed data, and the attribute must use the Date Time format.
- Each run returns only rows whose date is after the last execution.
- Eligibility depends only on the value of the date field, not on when the record was ingested. A record ingested after the previous execution is not returned if its date field value is older than the date of that execution.
Terminology:
- Canonical name: Incremental query — variants: none
- Synonyms: none
- Do not confuse: “Incremental query” (a Targeting activity that excludes previously returned records) ≠ “Targeting dimension” (the audience type, e.g. recipients or subscribers, selected within the activity)
FAQ:
- Q: What does the Incremental query activity return on each run? — Only records whose date field value is later than the previous execution, regardless of when they were ingested.
- Q: When should I use the Incremental query activity? — When the campaign can run multiple times, for example when scheduled (e.g. weekly) or triggered by an external signal or API, so each run targets only records dated after the previous execution.
- Q: What is required under Processed data? — A Path to the date field, using the Date Time format; each run returns only rows whose date is after the last execution.
- Q: What happens if a run returns no rows? — The Orchestrated campaign stops at the Incremental query, and activities after it are not executed until there is data on a later run.
- Q: What are typical uses of the Incremental query? — Pulling “new since last run” segments (e.g. new sign-ups, new purchasers) into messaging, or sending only new or updated rows to files for reporting or BI tools.
Examples:
- Welcome email to new gold members: an Incremental query selects gold members (first run: all current gold members; later runs: only profiles that became gold members since the previous execution), followed by an Email delivery activity that sends the welcome email to the profiles output by the query. The campaign can be scheduled to run weekly, every Monday, so each recipient receives the welcome email once.
Related pages:
- To pick the audience type for the Incremental query: Targeting dimensions (orchestrated/target-dimension.md)
- To build the query condition for the Incremental query: Learn how to use the rule builder (orchestrated/orchestrated-rule-builder.md)
Personas:
- marketer: Can configure the Incremental query activity so each Orchestrated campaign run returns only records whose date field value is later than the previous execution. Can select the Targeting dimension, add a condition with the rule builder, and choose the Path to the date field under Processed data. The page states that a date field is required and the attribute must use the Date Time format. Where: “Configure the Incremental query activity”.
Onboarding:
- Level: Intermediate
- First minimal step: Drop an Incremental query activity into your Orchestrated campaign.
- Success check: Each run returns only rows whose date is after the last execution.
- Next: Selecting the Targeting dimension for the Incremental query activity: Create your Targeting dimension (orchestrated/target-dimension.md); Adding a condition to define the query in the Incremental query activity: Work with the rule builder (orchestrated/orchestrated-rule-builder.md)