inAudience-Funktion inAudience
Die Funktion inAudience ist eine Adobe Experience Platform-Funktion, mit der Sie überprüfen können, ob ein Kontakt in Ihrer Journey zu einer bestimmten Zielgruppe gehört. Mit dieser leistungsstarken Funktion können Sie personalisierte Journey-Pfade basierend auf der Zielgruppenzugehörigkeit erstellen und ermöglichen dadurch anspruchsvolle Segmentierung und anspruchsvolles Targeting in Ihren Kundenerlebnissen.
Verwenden Sie die Funktion inAudience, wenn Sie Folgendes tun müssen:
- Journey-Pfade basierend auf der Zielgruppenzugehörigkeit verzweigen. Weitere Informationen
- Bedingte Logik anwenden, die davon abhängt, ob ein Profil zu einem bestimmten Segment gehört
- Bestimmte Zielgruppen von Kundinnen und Kunden mit personalisierten Erlebnissen ansprechen
- Echtzeit-Zielgruppenbeteiligung unter Journey-Bedingungen auswerten
- Mehrere Zielgruppenprüfungen kombinieren, um komplexe Zielgruppenbestimmungsregeln zu erstellen
Die Funktion wertet die Zielgruppenzugehörigkeit in Echtzeit aus und gibt einen booleschen Wert zurück, wodurch sie sich ideal für Entscheidungsknoten und bedingte Ausdrücke eignet. Zielgruppen werden in Adobe Experience Platform definiert und verwaltet (weitere Informationen zum Arbeiten mit Zielgruppen in Journey Optimizer). Der Ausdruckseditor bietet automatische Vervollständigungsvorschläge, um Ihnen eine genaue Referenzierung zu erleichtern.
Zielgruppenstatus:
Zielgruppen können zwei Beteiligungsstatus aufweisen:
- Realisiert: Der Kontakt qualifiziert sich für die Zielgruppendefinition und ist ein aktives Mitglied
- Ausgestiegen: Der Kontakt hat die Zielgruppe verlassen und ist nicht mehr qualifiziert
Nur Kontakte mit dem Status Realisiert werden als aktive Zielgruppenmitglieder betrachtet. Wenn die Funktion true zurückgibt, bestätigt sie, dass der Kontakt den Status „Realisiert“ hat. Wenn sie false zurückgibt, zeigt dies den Status „Ausgestiegen“ an. Weitere Informationen zur Zielgruppenauswertung finden Sie in der Dokumentation zum Segmentierungs-Service.
inAudience(<parameter>)| table 0-row-3 1-row-3 | ||
|---|---|---|
| Parameter | Beschreibung | Typ |
| Zielgruppe | Der Zielgruppenname | <string> |
Wichtige Einschränkungen:
- Der Zielgruppenname muss eine Zeichenfolgenkonstante sein
- Er kann kein Feldverweis oder Ausdruck sein
- Sie können bis zu 100 Zielgruppen in einer einzelnen Journey abrufen
inAudience(<string>)
Gibt einen booleschen Wert zurück:
-
true: Der Kontakt ist Mitglied der Zielgruppe (Status „Realisiert“) -
false: Der Kontakt ist kein Mitglied der Zielgruppe (Status „Ausgestiegen“)
inAudience("men over 50")
Gibt wahr zurück, wenn der Kontakt innerhalb der Journey-Instanz Teil der Adobe Experience Platform-Zielgruppe „men over 50“ (Männer über 50) ist. Andernfalls wird falsch zurückgegeben.
Praktische Anwendungsfälle:
| code language-none |
|---|
|
Leitlinien und Einschränkungen guardrails
Beachten Sie bei Verwendung der Funktion inAudience in Ihren Journeys die folgenden Leitlinien und Einschränkungen:
Beschränkung für Zielgruppenabrufe:
- Sie können bis zu 100 Zielgruppen in einer einzelnen Journey abrufen
- Der Ausdruckseditor stellt eine automatisch vervollständigte Liste verfügbarer Zielgruppen bereit, um Ihnen deren korrekte Referenzierung zu erleichtern
Parametereinschränkungen:
- Der Zielgruppenname muss eine Zeichenfolgenkonstante sein
- Feldverweise und Ausdrücke werden nicht als Parameter unterstützt
Änderungen des Zielgruppennamens:
- Wenn Sie den Namen einer bestehenden Zielgruppe in Adobe Experience Platform ändern, werden die Verweise auf diese Zielgruppe in Ihren Journey-Ausdrücken nicht automatisch aktualisiert.
- Wenn Ihr Bedingungsknoten
inAudience('oldAudienceName')verwendet, müssen Sie den Ausdruck manuell bearbeiten, damit der neue Name verwendet wird. - Wenn der Zielgruppenname nicht aktualisiert wird, funktioniert die Journey-Bedingung nicht mehr, was zu falschem Journey-Verhalten führen kann
Überlegungen zur Zusammenführungsrichtlinie:
- Beim Verwenden mehrerer Zielgruppen mit der Funktion
inAudiencekönnen Inkonsistenzen mit Zusammenführungsrichtlinien zu Fehlern oder Warnhinweisen führen - Weitere Informationen zum Verhalten von Zusammenführungsrichtlinien finden Sie unter Journey-Eigenschaften.
Ausbreitungszeitpunkt:
Bei Verwendung von inAudience() in einem Bedingungsknoten variiert der Zeitpunkt der Segmentzugehörigkeitsevaluierung je nachdem, wo die Bedingung auf der Journey erscheint:
- Auf einer Zielgruppen-Journey lesen vor einer Warteaktivität: Journey Optimizer liest aus der Batch-Projektion des Profils. Die Daten in dieser Projektion werden innerhalb von 2 Stunden der Aufnahme aktualisiert. Bei Zielgruppen, die auf tägliche oder zeitbasierte Bedingungen angewiesen sind, können zusätzliche Verzögerungen auftreten. Fügen Sie eine Warteaktivität am Anfang der Journey hinzu oder lassen Sie eine Pufferzeit zu, um sicherzustellen, dass die neueste Segmentzugehörigkeit widergespiegelt wird.
- Auf einer Journey mit einem unitären Ereignis oder nach einer Warteaktivität wird Segmentzugehörigkeit aus der Streaming-(unitären)-Projektion gelesen. Die Daten sind normalerweise innerhalb von 15 Minuten verfügbar. Weitere Informationen finden Sie in der Dokumentation zur Streaming-Aufnahme in Adobe Experience Platform.
Verwandte Themen
Weitere Informationen zur Verwendung von Zielgruppen in Adobe Journey Optimizer:
- Informationen zu Zielgruppen: Erfahren Sie, wie Zielgruppen in Adobe Experience Platform und Journey Optimizer funktionieren, einschließlich ihrer Erstellung und Verwaltung
- Aktivität „Zielgruppe lesen“: Verwenden Sie Zielgruppen, um den Journey-Eintritt auszulösen und alle Mitglieder der Zielgruppe zum Eintritt in eine Journey zu bewegen
- Zielgruppenqualifizierungsereignisse: Überwachen Sie Zielgruppeneintritte und -austritte von Profilen, um Journey-Aktionen in Echtzeit auszulösen
- Verwenden von Zielgruppen in Bedingungen - Erstellen bedingter Journey-Pfade basierend auf der Zielgruppenzugehörigkeit mithilfe der Aktivität „Optimieren“
- Journey-Eigenschaften – Zusammenführungsrichtlinien: Erfahren Sie, wie Zusammenführungsrichtlinien funktionieren, wenn mehrere Zielgruppen mit der Funktion „inAudience“ verwendet werden
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 documents the
inAudiencefunction, which checks in real-time whether a journey profile belongs to a named Adobe Experience Platform audience and returns a boolean used in journey conditions.
Intents:
- Branch a journey path based on whether a profile is a member of a specific audience using
inAudience - Combine multiple
inAudiencechecks with AND/OR logic to create complex targeting conditions - Verify that a profile has not entered a specific audience using a negation check (
inAudience("...") == false) - Understand the propagation timing differences between Read Audience journeys and unitary event journeys
- Identify and fix broken audience references caused by audience renames in Adobe Experience Platform
Glossary:
- Realized: Audience participation status indicating the individual currently qualifies for the audience definition and is an active member (product-specific)
- Exited: Audience participation status indicating the individual has left the audience and no longer qualifies (product-specific)
- Merge policy: A rule in Adobe Experience Platform that determines how profile data from multiple datasets is combined when evaluating audience membership (product-specific)
- Batch projection: The profile data store refreshed on a schedule (within 2 hours after ingestion) used by Read Audience journeys (product-specific)
- Streaming projection: The real-time profile data store (typically available within 15 minutes) used in unitary event journeys and after Wait activities (product-specific)
Guardrails:
- A single journey can retrieve up to 100 audiences
- The audience name parameter must be a string constant; field references and dynamic expressions are not supported
- Renaming an audience in Adobe Experience Platform does not automatically update
inAudiencereferences in journey expressions — manual updates are required - Inconsistent merge policies across multiple audiences used in the same journey can cause errors or alerts
Terminology:
- Canonical name: inAudience — Acronym: none — variants: inSegment (legacy name)
- Synonyms: “inAudience” = “audience membership check function”
- Do not confuse: “Realized” (active member) ≠ “Exited” (no longer a member)
- Do not confuse: “inAudience” (current function) ≠ “inSegment” (deprecated legacy function)
FAQ:
- Q: What does
inAudiencereturn when a profile has exited the audience? — It returnsfalse; only profiles with “Realized” status are considered active members and returntrue. - Q: How many audiences can I check in a single journey? — Up to 100 audiences can be retrieved within a single journey.
- Q: What happens if I rename an audience in Adobe Experience Platform after using it in a journey? — The journey expression is not updated automatically; you must manually edit the
inAudiencecall to use the new audience name, otherwise the condition will break. - Q: How quickly is audience membership available after a profile update in a Read Audience journey? — In a Read Audience journey before a Wait activity, data is read from the batch projection refreshed within 2 hours after ingestion.
- Q: Can I pass a profile attribute as the audience name parameter? — No, the audience name must be a string constant; field references and expressions are not supported.