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.

Syntax
inAudience(<parameter>)
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
Signatur und zurückgegebener Typ

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“)

Beispiele

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
// Simple audience check in a condition
inAudience("Premium Customers") == true

// Multiple audience evaluation
inAudience("High Value Customers") == true AND inAudience("Active Last 30 Days") == true

// Negation check
inAudience("Unsubscribed") == false

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 inAudience kö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:

AI Knowledge Reference

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 inAudience function, 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 inAudience checks 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 inAudience references 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 inAudience return when a profile has exited the audience? — It returns false; only profiles with “Realized” status are considered active members and return true.
  • 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 inAudience call 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.
recommendation-more-help
journey-optimizer-help