このページ:では、サポートに連絡する前に、アプリ内、web、コードベースのエクスペリエンスなどのインバウンドアクションに関する一般的な問題をジャーニーでデバッグし、解決する方法について説明します。
アプリ内、web、コードベースのエクスペリエンスなどのインバウンドアクションは、ユーザーのジャーニー中にパーソナライズされたエンゲージメントを可能にするので、Journey Optimizer の重要なコンポーネントです。 ただし、インバウンドコンテンツの欠落や、プロファイルがジャーニーから離脱した後に配信が継続されるなど、予期しない動作が発生する場合があります。
このガイドでは、サポートに連絡する前に、ジャーニーでのインバウンドアクションに関連する問題をデバッグするための手順について段階的に説明し、問題を独自に特定して解決できるようにします。
前提条件 prerequisites
トラブルシューティングを開始する前に、以下を確認します。
-
Assurance セッションを設定します。 詳しくは、Adobe Experience Platform Assurance ドキュメント を参照してください。
-
インバウンドアクションを含むジャーニーに移動して、ジャーニー名とバージョン ID を取得します。
note NOTE ジャーニーバージョン ID は、URL の「journey/」の後にあります(例:86232fb1-2932-4036-8198-55dfec606fd7)。
-
インバウンドアクションをクリックして、その詳細を表示します。 インバウンドアクションのラベルと ID を取得します。
-
プロファイルの名前空間と ID を取得して、問題の発生したプロファイルを識別します。 設定に基づいて、名前空間は ECID、メール、顧客 ID などになります。 プロファイルを検索する方法について詳しくは、Experience Platform ドキュメントを参照してください。
シナリオ 1:ユーザーがインバウンドコンテンツを受信していない scenario-1
このシナリオでは、あるプロファイルがジャーニーでのインバウンドアクションにエントリしましたが、30 分経過しても、対応するインバウンドコンテンツが設定トリガーステップでデバイス/クライアントに表示されません。
事前確認 pre-checks
-
ジャーニーインバウンドデータセットがプロファイルの取り込みに対して有効になっている
インバウンドアクションでは、実行中にプロファイルの更新に ジャーニーインバウンド データセットを使用します。 現在のサンドボックスのプロファイルに対してデータセットが有効になっていることを確認します。 データセットの詳細
-
Platform ID で定義された「joai」ID
インバウンドアクションでは、インバウンドステップでプロファイルのアクティブ化にプロファイル
segmentMembershipの joai 名前空間を使用します。 サンドボックスの Platform ID で定義されていることを確認します。 詳しくは、Experience Platform ID サービスを参照してください
デバッグ手順 debugging-steps
次のグラフには、実行できるデバッグ手順のシーケンスを示します。
手順1:デバイス/クライアントがエッジネットワークからコンテンツを受信しているかどうかを確認する step-1
まず、デバイス/クライアントが期待どおりのコンテンツを取得しているかどうかを確認します。
-
Assurance セッションに移動し、左側のパネルから「アプリ内メッセージ」セクションを選択します。
-
「デバイスでのメッセージ」タブで、メッセージドロップダウンリストをクリックします。
{width="80%"}
-
ジャーニー名の後に「- アプリ内メッセージ」が付いたメッセージを探します。 このようなメッセージがあった場合、アプリ内メッセージがデバイス/クライアントに存在し、問題がアプリ内トリガーに関連している可能性があります。
-
メッセージが見つからない場合、アプリ内メッセージはデバイス/クライアントによって受信されませんでした。
手順2:エッジネットワークがコンテンツを返しているかどうかを確認する step-2
この手順では、Edge Network がデバイス/クライアントでレンダリングされる期待どおりのインバウントコンテンツを返していることを確認します。
プロファイルがジャーニーのインバウンドアクションにエントリすると、インバウンドジャーニーアクションに対応する特別なオーディエンスセグメント(joai 名前空間内)に自動的に選定されます。
クライアントが特定のプロファイルとサーフェスについて Edge Network にリクエストを行うと、そのプロファイルが現在対応する joai セグメントのメンバーである場合に限り、そのサーフェスをターゲティングするインバウンドジャーニーアクションのコンテンツを受信する資格がプロファイルに選定されます。
Edge Network の動作をデバッグするには、次の手順に従います。
-
Assurance セッションで Edge Delivery ビューを開きます。 このビューには、Edge Network サーバーでのインバウンドアクションの実行に関する情報が表示されます。 詳しくは、Experience Platform ドキュメントを参照してください。
-
インバウンドアクションに対応する Edge アクティビティが「選定アクティビティ」セクションまたは「未選定アクティビティ」セクションにリストされているかどうかを確認します。
- 「選定アクティビティ」セクションの場合、プロファイルはインバウンドジャーニーアクションに選定され、コンテンツを返す必要があります。
- 「未選定アクティビティ」セクションの場合、プロファイルはインバウンドジャーニーアクションに選定されません。 詳しくは、除外の理由を参照してください。
- いずれのセクションでもない場合は、Edge Network へのインバウンドジャーニーアクションの公開で問題が発生するか、リクエストしたサーフェス URI がインバウンドアクションのチャネル設定と一致しません。
note NOTE Assurance セッションで Edge アクティビティを見つけるには、audienceNamespace が joai で、audienceSegmentId が <JourneyVersionID>_<JourneyActionID> であるアクティビティを探します(例:86232fb1-2932-4036-8198-55dfec606fd7_708f718d-8503-4427-ad8d-8e28979b554c)。 {width="70%"}
-
アクティビティが「未選定アクティビティ」セクションにあり、除外の理由が 「セグメントがアクティブではありません」 である場合、Edge Network 配信サーバーは、プロファイルが関連する joai オーディエンスセグメントの一部ではないと判断します。
「プロファイル」セクションの segmentsMap 要素を開き、joai セグメント ID の存在を探すことで、Edge Network 配信サーバーのプロファイルのビューに joai セグメントが存在するかどうかを再確認できます。
-
Edge Network 配信サーバーがプロファイルを関連する joai セグメント内にあると表示しない場合は、次の手順に進みます。
手順3:「joai」オーディエンスメンバーシップがedge networkに反映されているかどうかを確認する step-3
この手順では、プロファイルがインバウンドジャーニーアクションにエントリし、対応する joai セグメントにプロファイルが選定された際に、Edge プロファイルが正しく更新されたことを確認します。
プロファイルが joai セグメントに選定されると、まずハブでプロファイルが更新され、次にセグメントメンバーシップが Edge プロファイルに投影されて、Edge Network 配信サーバーで使用できるようになります。
Edge プロファイルの segmentMembership 属性に joai セグメントが存在するかどうかを確認するには、次の手順に従います。
-
Journey Optimizer の左側のナビゲーションパネルにある顧客/プロファイルメニューに移動し、名前空間と ID を使用してプロファイルを参照します。 詳しくは、リアルタイム顧客プロファイルを参照してください
-
「属性」タブを選択し、Edge ビューを選択します。
-
「JSON を表示」をクリックして、プロファイルの JSON ビューを開きます。
{width="80%"}
-
segmentMembership属性に移動し、セグメント ID <JourneyVersionID>_<JourneyActionID> が joai 名前空間に存在し、「適合」ステータスになっているかどうかを確認します。 {width="90%"}
-
存在する場合、インバウンドジャーニーアクションに対応する joai セグメントが Edge プロファイルに正しく生成されます。
-
Edge Network 配信サーバーのプロファイルビューに表示されない場合は、配信サーバーが Edge プロファイルを読み込む方法に問題がある可能性があります。
-
-
joai セグメント ID が存在しないか 離脱 状態の場合、Edge に(まだ)生成されていません。
segmentMembershipの値がハブから Edge に生成されるまで 15~30 分待機します。 まだ表示されない場合は、次の手順に進みます。
手順4: ハブのプロファイルに「joai」オーディエンスメンバーシップが存在するかどうかを確認する step-4
この手順では、プロファイルがインバウンドジャーニーアクションにエントリし、対応する joai セグメントにプロファイルが選定された際に、ハブプロファイルが正しく更新されたことを確認します。
ハブプロファイルの segmentMembership 属性に joai セグメントが存在するかどうかを確認するには、次の手順に従います。
-
Journey Optimizer の左側のナビゲーションパネルにある顧客/プロファイルメニューに移動し、名前空間と ID を使用してプロファイルを参照します。 詳しくは、リアルタイム顧客プロファイルを参照してください
-
「属性」タブを選択し、ハブビューを選択します。
-
「JSON を表示」をクリックして、プロファイルの JSON ビューを開きます。
-
segmentMembership 属性に移動し、セグメント ID <JourneyVersionID>_<JourneyActionID> が joai 名前空間に存在し、「適合」ステータスになっているかどうかを確認します。
-
存在する場合、インバウンドジャーニーアクションに対応する joai セグメントがハブプロファイルに正しく取り込まれます。
-
30 分以上経過しても Edge プロファイルに見つからない場合、Edge 投影システムに問題がある可能性があります。
-
-
joai セグメント ID が存在しないか 離脱済み 状態の場合、プロファイルは、対応するインバウンドジャーニーアクションへのエントリ時に特別な joai オーディエンスセグメントに(まだ)正しく選定されていません。
segmentMembershipの値がハブのプロファイルに取り込まれるまで 15 ~ 30 分待機します。 まだ表示されない場合は、次の手順に進みます。
手順 5:クライアント/デバイスがまだ期待どおりのコンテンツを取得していない場合する step-5
上記の手順をすべて実行し、セグメントメンバーシップが Edge Network に生成されるまで 30~60 分待機しても期待どおりの動作が見られない場合は、アドビカスタマーケアまたはアドビ担当者にお問い合わせください。
次のようなデバッグ手順の詳細をできるだけ多く含めます。
- 予期しない動作が見られるステップ。
- ジャーニーバージョン ID。
- ジャーニーアクション ID。
- Assurance の完全なトレース。
- Edge プロファイルの JSON ビュー。
- ハブプロファイルの JSON ビュー。
- その他。
シナリオ 2:ユーザーがインバウンドコンテンツを引き続き受信する scenario-2
このシナリオはシナリオ 1 の逆です。プロファイルはジャーニーから離脱していますが、ユーザーはインバウンドコンテンツを引き続き受信しています。
ただし、プロファイルがジャーニーから離脱すると、ジャーニーのインバウンドアクションに対応する joai オーディエンスセグメントに選定されなくなります。
シナリオ 1 と同じデバッグ手順を実行して、ハブプロファイル、Edge プロファイル、Edge Network 配信サーバーが関連する joai セグメントのセグメントメンバーシップステータスを正しく反映しているかどうか、およびクライアントがインバウンドコンテンツを受信しなくなっているかどうかを確認します。
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 provides a step-by-step self-service debugging guide for two inbound action scenarios in Adobe Journey Optimizer journeys: a profile entering an inbound step but not receiving the content, and a profile continuing to receive content after exiting the journey.
Intents:
- Set up an Assurance session as a prerequisite before debugging inbound action issues
- Verify whether the device or client is receiving inbound content from the Edge Network using Assurance
- Check Edge Network qualified and unqualified activities to determine if a profile is eligible for an inbound journey action
- Confirm that the joai audience segment membership has propagated from the Hub profile to the Edge profile
- Diagnose delays in joai segment ingestion on the Hub profile after a profile enters an inbound action
- Escalate to Adobe Customer Care with the correct diagnostic information when self-service steps do not resolve the issue
Glossary:
- Inbound actions: Journey activities that deliver personalized content to a user’s device or browser, including In-app, web, and code-based experience channels (product-specific)
- joai namespace: A special identity namespace used in profile
segmentMembershipto activate a profile for an inbound journey action step (product-specific) - joai segment: An automatically created audience segment in the joai namespace corresponding to a specific inbound journey action; the profile must be in a realized state in this segment to receive the content (product-specific)
- Journey Inbound dataset: The AEP dataset used to store profile updates made when a profile enters an inbound journey action (product-specific)
- Hub profile: The central profile store in Adobe Experience Platform used as the source of truth for profile attributes and segment membership
- Edge profile: The projected copy of the Hub profile used by the Edge Network delivery server to evaluate content eligibility in real time
- Assurance: An Adobe Experience Platform tool for real-time debugging of client-side SDK behavior and Edge Network responses
Guardrails:
- The Journey Inbound dataset must be enabled for profile ingestion in the current sandbox before inbound actions work correctly
- The joai namespace must be defined in Platform Identities for the sandbox
- Propagation of joai segment membership from Hub to Edge can take up to 15–30 minutes
- Ingestion of joai segment membership into the Hub profile can take up to 15–30 minutes after the profile enters the inbound action
- If content is still missing after 30–60 minutes, escalate to Adobe Customer Care with journey version ID, action ID, Assurance trace, and Edge and Hub profile JSON views
Terminology:
- Canonical name: joai namespace — Acronym: joai — variants: joai identity, joai segment namespace
- Canonical name: Inbound actions — Acronym: none — variants: inbound channels, inbound content
- Synonyms: “Hub profile” = “central profile” (AEP); “Edge profile” = “projected profile” (used by Edge Network)
- Do not confuse: “Qualified Activities” ≠ “Unqualified Activities” in Edge Delivery view — qualified means the profile received content; unqualified means it did not, with an exclusion reason shown
FAQ:
- Q: What are the two main inbound action failure scenarios covered by this guide? — Scenario 1: a profile entered the inbound step but the user never sees the content. Scenario 2: a profile exited the journey but the user still receives the inbound content.
- Q: What tool do I use to debug inbound action delivery? — Adobe Experience Platform Assurance. Set up an Assurance session first, then use the In-App Messaging and Edge Delivery views to inspect content delivery and Edge Network responses.
- Q: What is the joai segment and why does it matter? — When a profile enters an inbound action, it is automatically qualified into a joai audience segment scoped to that specific action. The Edge Network only delivers the inbound content if the profile is in a realized state in that joai segment.
- Q: How long does it take for joai segment membership to appear on the Edge profile? — Up to 15–30 minutes for propagation from Hub to Edge after the Hub profile is updated.
- Q: What should I do if the joai segment ID is in exited state on the Edge profile? — The profile has left the joai segment, meaning it exited the inbound journey action. If this is unexpected, trace back through Hub profile ingestion and check if the profile correctly entered the inbound action step.
- Q: What information should I provide when escalating to Adobe Customer Care? — The journey version ID, journey action ID, the step where unexpected behavior occurs, the full Assurance trace, and the JSON views of both the Edge and Hub profiles.