このページ:では、サポートに連絡する前に、アプリ内、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 セグメントのセグメントメンバーシップステータスを正しく反映しているかどうか、およびクライアントがインバウンドコンテンツを受信しなくなっているかどうかを確認します。
このセクションには、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。
理解を深めるには、この情報をこのページのドキュメントと組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明しますが、この節では、用語、意図、適用可能性、および制約の曖昧さを解消するのに役立つ追加のコンテキストを提供します。
- TL;DR:このページでは、Adobe Journey Optimizer ジャーニーの2つのインバウンドアクションのシナリオ(インバウンドステップを入力したがコンテンツを受信しないプロファイル、ジャーニーを終了した後もコンテンツを受信し続けるプロファイル)について、ステップバイステップのセルフサービスデバッグガイドを提供します。
インテント:
- インバウンドアクションの問題をデバッグする前に、Assurance セッションを前提条件として設定します
- Assuranceを使用して、デバイスまたはクライアントがEdge Networkからインバウンドコンテンツを受信しているかどうかを確認します
- Edge Networkの適格アクティビティと非適格アクティビティを確認して、プロファイルがインバウンドジャーニーアクションの対象であるかどうかを判断します
- Joai オーディエンスセグメントメンバーシップがHub プロファイルからEdge プロファイルに反映されていることを確認します
- プロファイルがインバウンドアクションに入った後、Hub プロファイルでのジョインセグメント取り込みの遅延を診断します
- セルフサービスの手順で問題が解決しない場合は、正しい診断情報をAdobe カスタマーサポートにエスカレーションします
用語集:
- インバウンドアクション:アプリ内、web、コードベースのエクスペリエンスチャネル (製品固有)など、ユーザーのデバイスやブラウザーにパーソナライズされたコンテンツを配信するジャーニーアクティビティ
- joai名前空間:インバウンドジャーニーアクションのプロファイルをアクティブ化するためにプロファイル
segmentMembershipで使用される特別なID名前空間ステップ (製品固有) - joai セグメント:特定のインバウンドジャーニーアクションに対応する、joai名前空間で自動的に作成されたオーディエンスセグメント。コンテンツ (製品固有)を受け取るには、プロファイルがこのセグメント内で実現状態である必要があります
- ジャーニーインバウンドデータセット: プロファイルがインバウンドジャーニーアクション (製品固有)に入ったときに行われたプロファイル更新を保存するために使用されるAEP データセット
- Hub profile: プロファイル属性とセグメントメンバーシップの信頼できる唯一の情報源として使用される、Adobe Experience Platformの中央プロファイルストア
- Edge プロファイル: Edge Network配信サーバーがコンテンツの適格性をリアルタイムで評価するために使用するHub プロファイルの予測コピー
- Assurance: クライアントサイドのSDK ビヘイビアーとEdge Network レスポンスをリアルタイムでデバッグするためのAdobe Experience Platform ツール
ガードレール:
- インバウンドアクションが正しく機能するには、ジャーニーインバウンドデータセットを現在のサンドボックスでプロファイル取り込みのために有効にする必要があります
- Joai名前空間は、サンドボックスのPlatform IDで定義する必要があります
- HubからEdgeへのJoai セグメントメンバーシップの伝達には、最大で15~30分かかります
- プロファイルがインバウンドアクションに入ってからJoai セグメントメンバーシップをHub プロファイルに取り込むには、最大で15~30分かかる場合があります
- 30~60分経過してもコンテンツが見つからない場合は、ジャーニーバージョン ID、アクション ID、Assurance トレース、EdgeおよびHub プロファイル JSON ビューを使用して、Adobe カスタマーケアにエスカレーションします
用語:
- 正規名:joai名前空間 – Acronym: joai — バリアント:joai ID, joai セグメント名前空間
- 正規名:インバウンドアクション – 略語:なし – バリエーション:インバウンドチャネル、インバウンドコンテンツ
- 同義語:「Hub profile」 = 「central profile」(AEP)、「Edge profile」 = 「projected profile」(Edge Networkで使用)
- 混同しない:Edge Delivery ビューの「適格アクティビティ」≠「非適格アクティビティ」は、プロファイルが受け取ったコンテンツを意味します。非適格とは、除外の理由が表示された場合に受け取らなかったコンテンツを意味します
FAQ:
- Q:このガイドで取り上げる2つの主なインバウンドアクションの失敗シナリオは何ですか? — シナリオ 1: インバウンドステップに入ったプロファイルが、ユーザーにコンテンツが表示されない。 シナリオ 2: プロファイルがジャーニーを終了しましたが、ユーザーはインバウンドコンテンツを引き続き受信します。
- Q: インバウンドアクション配信のデバッグに使用するツールを教えてください。 — Adobe Experience Platform Assurance。 まずAssurance セッションを設定し、次にアプリ内メッセージングとEdge Delivery ビューを使用して、コンテンツ配信とEdge Network応答を調べます。
- Q:共同作業セグメントとは何ですか。なぜそれが重要なのですか? — プロファイルがインバウンドアクションに入ると、その特定のアクションを対象とした共同作業オーディエンスセグメントに自動的に適格されます。 Edge Networkは、プロファイルがそのジョインセグメントで実現された状態にある場合にのみ、インバウンドコンテンツを配信します。
- Q: Edge プロファイルに共同作業セグメント メンバーシップが表示されるまでにどのくらいの時間がかかりますか? — Hub プロファイルが更新された後、HubからEdgeへの伝搬に最大15 ~ 30分かかります。
- Q: Edge プロファイルでジョイセグメント IDが離脱している場合はどうすればよいですか? — プロファイルがジャーニーセグメントから離脱しました。つまり、インバウンドジャーニーアクションから離脱しました。 予期しない場合は、Hub プロファイルの取り込みからトレースして、プロファイルがインバウンドアクションステップに正しく入力されたかどうかを確認します。
- Q: Adobe カスタマーケアにエスカレーションする際に提供すべき情報は何ですか? — ジャーニーバージョン ID、ジャーニーアクション ID、予期しない動作が発生したステップ、完全なAssurance トレース、Edge プロファイルとHub プロファイルの両方のJSON ビュー。