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 関数を使用して複数のオーディエンスを使用する際の結合ポリシーの仕組みについて説明します
このセクションには、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。
理解を深めるには、この情報をこのページのドキュメントと組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明しますが、この節では、用語、意図、適用可能性、および制約の曖昧さを解消するのに役立つ追加のコンテキストを提供します。
- TL;DR:このページでは、ジャーニープロファイルが名前付きAdobe Experience Platform オーディエンスに属しているかどうかをリアルタイムで確認し、ジャーニー条件で使用されるブール値を返す
inAudience関数について説明します。
インテント:
- プロファイルが
inAudienceを使用する特定のオーディエンスのメンバーであるかどうかに基づいて、ジャーニーパスを分岐します - 複数の
inAudienceチェックをAND/OR ロジックと組み合わせて、複雑なターゲット条件を作成します - プロファイルが否定検査(
inAudience("...") == false)を使用して特定のオーディエンスに入力されていないことを確認します - オーディエンスの読み取りジャーニーと単一イベントジャーニーの伝播タイミングの違いを把握します
- Adobe Experience Platformでのオーディエンス名の変更によって発生する破損したオーディエンス参照の特定と修正
用語集:
- 実現:個人が現在オーディエンス定義に適格であり、アクティブなメンバー (製品固有) であることを示すオーディエンス参加ステータス
- 終了:個人がオーディエンスを離脱し、(製品固有)に該当しないことを示すオーディエンス参加ステータス
- 結合ポリシー: オーディエンスメンバーシップ (製品固有)を評価する際に、複数のデータセットのプロファイルデータを組み合わせる方法を決定するAdobe Experience Platformのルール
- バッチ予測:読み取りオーディエンスジャーニー(製品固有)で使用される(取り込みから2時間以内)スケジュールで更新されたプロファイルデータストア
- ストリーミング予測:単一イベントジャーニーおよび待機アクティビティ (製品固有)後に使用されるリアルタイムのプロファイルデータストア(通常15分以内)
ガードレール:
- 1つのジャーニーで最大100人のオーディエンスを取得できます
- オーディエンス名パラメーターは文字列定数である必要があります。フィールド参照と動的式はサポートされていません
- Adobe Experience Platformでオーディエンスの名前を変更しても、ジャーニー式の
inAudience参照は自動的に更新されません。手動で更新する必要があります - 同じジャーニーで使用されている複数のオーディエンスで一貫性のない結合ポリシーを使用すると、エラーやアラートが発生する可能性があります
用語:
- 正規名:inAudience – 頭字語:なし – バリアント:inSegment (旧称)
- 同義語:“inAudience” = “audience membership check function”
- 「Realized」(アクティブなメンバー)≠「Exited」(もはやメンバーではない)と混同しないでください
- 混同しないでください。「inAudience」(現在の関数)≠「inSegment」(非推奨のレガシー関数)
FAQ:
- Q: プロファイルがオーディエンスを離脱した場合、
inAudienceは何を返しますか? —falseが返されます。「Realized」ステータスのプロファイルのみがアクティブなメンバーと見なされ、trueが返されます。 - Q: 1つのジャーニーでチェックインできるオーディエンス数は? - 1つのジャーニーで最大100人のオーディエンスを取得できます。
- Q: ジャーニーで使用した後、Adobe Experience Platformでオーディエンスの名前を変更するとどうなりますか? — ジャーニー式は自動的に更新されません。新しいオーディエンス名を使用するには、
inAudience呼び出しを手動で編集する必要があります。そうしないと、条件が壊れます。 - Q: オーディエンスを読み取りジャーニーでプロファイルを更新した後、オーディエンスメンバーシップをどの程度すばやく利用できますか? – 待機アクティビティの前の「オーディエンスを読み取り」ジャーニーでは、取り込み後2時間以内に更新されたバッチ投影からデータが読み取られます。
- Q: プロファイル属性をオーディエンス名パラメーターとして渡すことはできますか? – いいえ、オーディエンス名は文字列定数である必要があります。フィールド参照と式はサポートされていません。