inAudience 関数 inAudience
inAudience 関数は、ジャーニー内の個人が特定のオーディエンスに属しているかどうかを確認できる Adobe Experience Platform 関数です。 この強力な関数により、オーディエンスメンバーシップに基づいてパーソナライズされたジャーニーパスを作成し、カスタマーエクスペリエンス内での高度なセグメント化とターゲティングが可能になります。
inAudience 関数は、次の操作が必要な場合に使用します。
- オーディエンスメンバーシップに基づいてジャーニーパスを分岐。 詳細情報
- プロファイルが特定のセグメントに属しているかどうかに応じて条件付きロジックを適用
- パーソナライズされたエクスペリエンスで特定の顧客グループをターゲット
- ジャーニー条件内でリアルタイムのオーディエンスのパーティシペーションを評価
- 複数のオーディエンスチェックを組み合わせて、複雑なターゲティングルールを作成
この関数は、オーディエンスメンバーシップをリアルタイムで評価し、ブール値を返すので、決定ノードや条件式に最適です。 オーディエンスは Adobe Experience Platform で定義および管理され(詳しくは、Journey Optimizer でのオーディエンスの操作を参照)、式エディターでは、オーディエンスを正確に参照できるようにオートコンプリートの候補が表示されます。
オーディエンスステータス:
オーディエンスには次の 2 つのパーティシペーションステータスがあります。
- 実現済み:個人がオーディエンス定義を選定し、アクティブなメンバーです
- 退出済み:個人がオーディエンスから退出し、選定しなくなりました
実現済みステータスの個人のみがアクティブなオーディエンスメンバーと見なされます。 関数が true を返す場合、個人がステータスを実現したことが確認され、false を返す場合、退出済みステータスが示されます。 オーディエンス評価について詳しくは、セグメント化サービスのドキュメントを参照してください。
inAudience(<parameter>)| table 0-row-3 1-row-3 | ||
|---|---|---|
| パラメーター | 説明 | タイプ |
| オーディエンス | オーディエンス名 | <string> |
重要な制約:
- オーディエンス名は、文字列定数にする必要があります
- フィールド参照や式は使用できません
- 1 回のジャーニーで最大 100 個のオーディエンスを取得できます
inAudience(<string>)
次のブール値を返します。
-
true:個人はオーディエンスのメンバーです(実現済みステータス) -
false:個人はオーディエンスのメンバーではありません(退出済みステータス)
inAudience("men over 50")
ジャーニーインスタンス内の個人が「50 歳以上の男性」という名前の Adobe Experience Platform オーディエンスに属している場合、true を返します。それ以外の場合は false を返します。
実用的なユースケース:
| code language-none |
|---|
|
ガードレールと制限 guardrails
ジャーニーで inAudience 関数を使用する際は、次のガードレールと制限に注意してください。
オーディエンス取得の制限:
- 1 回のジャーニー内で最大 100 個のオーディエンスを取得できます
- 式エディターでは、使用可能なオーディエンスのオートコンプリートリストが表示されるので、正しく参照できます
パラメーター制約:
- オーディエンス名は、文字列定数にする必要があります
- フィールド参照と式は、パラメーターとしてサポートされていません
オーディエンス名の変更:
- Adobe Experience Platform で既存のオーディエンスの名前を変更しても、ジャーニー式内のそのオーディエンスへの参照は自動的に更新されません
- 条件ノードで
inAudience('oldAudienceName')が使用されている場合は、新しい名前を使用するように式を手動で編集する必要があります。 - オーディエンス名を更新しないと、ジャーニー条件が破られ、ジャーニーの動作が不正確になる場合があります
結合ポリシーの考慮事項:
inAudience関数で複数のオーディエンスを使用する際、結合ポリシーとの不一致により、エラーやアラートが発生する場合があります。- 結合ポリシーの動作について詳しくは、ジャーニーのプロパティを参照してください
伝達タイミング:
条件ノードでinAudience()を使用する場合、セグメントメンバーシップの評価タイミングは、条件がジャーニーのどこに表示されるかによって異なります。
- オーディエンスの読み取りジャーニーで、待機アクティビティ: Journey Optimizerがプロファイルのバッチプロジェクションから読み取る前。 この投影内のデータは、取り込み後 2時間 以内に更新されます。 日ベースまたは時間ベースの条件に依存するオーディエンスでは、さらに遅延が発生する場合があります。 ジャーニーの開始時に短い アクティビティ を追加するか、バッファー時間を許可して、最新のセグメントメンバーシップが反映されるようにします。
- 単一イベントジャーニーで、または待機アクティビティの後、 セグメントメンバーシップがストリーミング(単一)投影から読み取られます。 データは通常、15分以内に利用できます。 詳しくは、Adobe Experience Platform ストリーミング取り込みに関するドキュメント を参照してください。
関連トピック
Adobe Journey Optimizer でのオーディエンスの使用について詳しくは、以下を参照してください。
- オーディエンスについて - Adobe Experience Platform および Journey Optimizer でのオーディエンスの仕組み(作成方法や管理方法を含む)について説明します
- オーディエンスを読み取りアクティビティ - オーディエンスを使用してジャーニーエントリをトリガーし、すべてのオーディエンスメンバーをジャーニーにエントリさせます
- オーディエンスの選定イベント - オーディエンスからプロファイルのエントリと退出をリッスンして、ジャーニーアクションをリアルタイムでトリガーします
- 条件でのオーディエンスの使用 - 「最適化」アクティビティを使用して、オーディエンスメンバーシップに基づく条件付きジャーニーパスを作成します
- ジャーニーのプロパティ - 結合ポリシー - inAudience 関数を使用して複数のオーディエンスを使用する際の結合ポリシーの仕組みについて説明します
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.