ライブアクティビティのトラブルシューティング troubleshoot-mobile-live

Adobe Experience Platform Assuranceのライブアクティビティビューでは、アプリの設定を検証し、アクティビティイベントを調べ、テストセッションからリモートでアクティビティを開始、更新、終了できます。

要件

3つのタブ

Assuranceから開始、更新、終了

ライブアクティビティを開始。 登録されたアクティビティタイプを選択するダイアログを開き、「単一」または「ブロードキャスト」を選択し、ブロードキャストチャネル ID （ブロードキャストのみ）を入力し、事前入力されたAPS JSON ペイロードを編集します。 プッシュから開始トークン、iOS バージョン、またはチャネル設定の要件が満たされない場合、ボタンが無効になるか、エラーが返されます。

更新を送信。 既存のアクティビティの「概要」タブから、「更新」（新しいコンテンツをプッシュ）または「終了」イベントを送信します。 単一の場合、プラグインはアクティビティの更新トークンを自動的に使用します。 ブロードキャストの場合、同じブロードキャストチャネル IDに登録されているすべてのデバイスをターゲットにします。 ペイロードは有効なJSONで、アクティビティの属性スキーマに一致する必要があります。そうでない場合、リクエストは拒否されます。

セットアップとセッション接続の手順については、Adobe Experience Platform Assurance ドキュメント ​を参照してください。

Journey OptimizerでAPI Triggered Campaignに移動し、次を取得します。

• キャンペーン名とID
• キャンペーンバージョン（該当する場合）
• キャンペーンの種類：トランザクション （単一）または​マーケティング （ブロードキャスト）
• サーフェス設定：ライブアクティビティに使用されるiOS アプリサーフェス
• アクティビティタイプ：キャンペーンで設定されたAttributeType構造体名

ライブアクティビティをトリガーするAPI呼び出しを行う際に、次を保存します。

• プロファイル識別子やライブアクティビティデータを含むAPI リクエストペイロード
• ステータスコード、メッセージ ID、リクエスト IDを含むAPI応答
• APIが呼び出されたときのタイムスタンプ
• 使用されているエンドポイント （例：/campaign/{CAMPAIGN_ID}/execute）

API リクエストから、次を取得します。

• プロファイル名前空間（例：ECID、電子メール、顧客ID）
• API呼び出しで使用されるプロファイル ID

Adobe Experience Platformでこのプロファイルを検索できることを確認します。 プロファイルを検索する方法については、Experience Platform ドキュメント ​を参照してください。

テストデバイスから以下を収集します。

• デバイスモデル（例：iPhone 14 Pro）
• iOS版
• アプリバンドル識別子
• APNs プッシュトークン
• テスト時のネットワーク接続ステータス

1. Journey Optimizerで、Customer > Profiles​に移動します。
2. API リクエストの名前空間とID値を使用して検索します。
3. プロファイルが見つからない場合は、プロファイルが存在しないか、取り込みが完了していません。 プロファイルを作成するか、取り込みを待ってからライブアクティビティをトリガーします。
4. プロファイルが見つかった場合は、以下の手順2に進んで、プッシュトークンが同期されているかどうかを確認します。

Assuranceを使用して、トークン登録を検証できます。

1. Assuranceでは、イベント リストから、イベント eventType = "liveActivity.pushToStart"をフィルタリングまたは検索します。
2. イベント​を選択し、ペイロードを調べます。
3. トークン、appId、attributeTypeの値が存在することを確認します。
4. イベントが正常に送信されたかどうかを確認します。

Adobe Experience Platformのプロフィールもご覧いただけます。

1. Adobe Experience Platformで、プロファイル​から「イベント」タブにアクセスします。
2. liveActivity.pushToStart イベントを検索します。
3. 偶数タイムスタンプとペイロードを確認します。

イベントが見つからない場合、モバイルアプリがMessaging.registerLiveActivityを正しく呼び出していません。 SDKとの連携を修正する必要があります。

1. プロファイル​から、属性 タブにアクセスします。

2. liveActivityPushNotificationDetailsを探します。

3. トークン設定を確認します。

   code language-json
   { "liveActivityPushNotificationDetails": [ { "appId": "com.example.myapp", "token": "abc123def456...", "platform": "apns", "denylisted": false, "attributeType": "OrderTrackingAttributes", "identity": {} } ] }

各フィールドを検証：

いずれかのフィールドが正しくない場合：モバイルアプリを更新し、Messaging.registerLiveActivitiesを使用して再登録し、5 ～ 10分待ってから、もう一度確認します。

liveActivityPushNotificationDetailsが見つからない場合：トークンがまだ同期されていません。 AssuranceでliveActivity.pushToStart イベントを見てから5 ～ 10分待ちます。

1. Journey Optimizerで​ キャンペーン ​を開き、アクション メニューに移動します。
2. ライブアクティビティ設定​を確認します。 IOS アプリのサーフェスは、プロファイルのliveActivityPushNotificationDetailsのappIdと一致するバンドル IDで設定する必要があります。 例えば、プロファイルに"appId": "com.example.myapp"がある場合、サーフェスは同じアプリをターゲットにする必要があります。
3. キャンペーン設定の​ アクティビティタイプ ​が、プロファイルのliveActivityPushNotificationDetailsのattributeTypeと正確に一致することを確認します。 例えば、プロファイルに"attributeType": "FoodDeliveryLiveActivityAttributes"がある場合、キャンペーンはこの同じアクティビティタイプを指定する必要があります。

API経由でキャンペーンを実行する場合は、ペイロードが正しい構造に従っていることを確認します。

単一ペイロード：

{
   "campaignId": "your-campaign-id",
   "recipients": [{
      "type": "aep",
      "userId": "user@example.com",
      "namespace": "email",
      "context": {
      "requestPayload": {
         "aps": {
            "content-available": 1,
            "timestamp": 1756984054,
            "event": "start",
            "attributes-type": "FoodDeliveryLiveActivityAttributes",
            "content-state": { ... },
            "attributes": { ... }
         }
      }
      }
   }]
}

一般的なペイロードの問題：

重要：常に最新のタイムスタンプを使用

• timestamp フィールドは、各API呼び出しが行われた時点で​ always ​が​現在のUnix エポックタイム （秒単位）である必要があります。
• これは、すべてのイベントタイプ​に適用されます：start、update、特にend。
• 更新/終了リクエストに対する影響：古いタイムスタンプまたは古いタイムスタンプを使用すると、更新リクエストと終了リクエストが失敗するか、デバイスによって無視されます。
• 以前のリクエストのタイムスタンプを​ NOT ​で再利用するか、キャッシュされた値を使用します。
• API呼び出しごとに新しいタイムスタンプを生成します。

任意フィールド （すべてのイベントタイプ）:

• requestId: トラッキング用の一意のID （推奨）。
• alert: titleとbodyを持つオブジェクト （更新に注意を引くために便利です）。

についてdismissal-date:

• Unix エポック時間（秒）を含むオプションフィールド。
• event: "end"​の場合にのみ関連します。
• ライブアクティビティをデバイスから自動的に削除するタイミングを指定します。
• エンドイベントで指定しない場合、ユーザーがアクティビティを却下するまでライブアクティビティは表示されたままになります。
• 将来のタイムスタンプである必要があります（timestamp以降）。

API ペイロードがiOS アプリのActivityAttributes実装と一致していることを確認します。 Adobe SDKのLiveActivityAttributes プロトコルは、iOS ActivityAttributesを拡張し、liveActivityData プロパティを必要とします。

マッピングを検証：

1. お使いのActivityAttributesは、AdobeのLiveActivityAttributes プロトコルを実装する必要があります。 例：

   code language-swift
   struct FoodDeliveryLiveActivityAttributes: LiveActivityAttributes { public struct ContentState: Codable, Hashable { var orderStatus: String var estimatedDeliveryTime: String } // Adobe SDK requirement var liveActivityData: LiveActivityData // Your custom attributes var restaurantName: String }

   注意 liveActivityData フィールドはAdobe SDKで必要であり、すべての実装に含める必要があります。

2. API ペイロードは、iOS構造をミラーリングする必要があります。

   code language-json
   { "aps": { "event": "start", "timestamp": 1756984054, "attributes-type": "FoodDeliveryLiveActivityAttributes", "content-state": { "orderStatus": "Preparing", "estimatedDeliveryTime": "20 mins" }, "attributes": { "liveActivityData": { "liveActivityID": "order-12345" }, "restaurantName": "Pizza Palace" } } }

検証チェックリスト：

• すべてのContentState フィールドをcontent-stateに含めます（すべてのイベントタイプに必須）。

• 次を含むすべてのLiveActivityAttributes フィールドをattributesに含めます（開始イベントのみ）。

  • liveActivityData （必須。通常はliveActivityIDまたは類似の識別子が含まれます）
  • 構造体のすべてのカスタムフィールド

• フィールド名を正確に一致させます（大文字と小文字を区別します）。

• データタイプ（文字列、Int、Bool、ネストされたオブジェクト）を一致させます。

• ネストされたオブジェクト構造を保持します。

よくある間違い：

詳細な例については、​ ライブアクティビティページの作成を参照してください。

Assuranceを使用して、APIの実行とペイロードの配信を検証します。

1. Assurance セッションを開きます。

2. API呼び出しを実行して、ライブアクティビティをトリガーします。

3. イベントリスト​で、次を確認します。

   • キャンペーン実行イベント：
   • ライブアクティビティ配信イベント：
   • ペイロード検証エラーイベント。

4. イベントペイロードを確認して、以下を確認します。

   • ペイロードが正しく処理されました。
   • 検証エラーは発生しませんでした。
   • ライブアクティビティがAPNに送信されました。

1. ライブアクティビティキャンペーン​に移動します。

2. 「レポート」ボタンをクリックします。

3. 「すべての時間レポートを表示」を選択します。

4. 次のセクションを確認します。

   1. 配信の成功について理解するには、送信統計​指標を確認してください。

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
      指標	意味	ビジネスの成長を促進するための
      ターゲティング	オーディエンスに適格なプロファイルの数	テストプロファイルを含める必要があります
      送信数	試行されたプッシュ通知の合計	API呼び出しと一致する必要があります
      配信済み	デバイスへの正常な配信	送信数と比較して成功率を確認する
      送信エラー	送信できなかったプッシュ通知	大きい数値
      除外を送信	Adobe Journey Optimizerによって除外されたプロファイル	プロファイルが除外されたかどうかを確認する

   2. 送信エラーが0を超える場合は、エラーの理由 テーブルで特定のエラーコードとメッセージを確認します。

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      共通エラー	意味	解決策
      無効なトークン	プッシュトークンが無効または期限切れです	デバイスからのライブアクティビティトークンの再登録
      トークンが見つかりません	プロファイルに関連付けられた有効なトークンがありません	liveActivityPushNotificationDetailsが存在することを確認
      APNsが拒否されました	Apple プッシュ通知サービスはプッシュを拒否しました	APNs証明書、バンドル ID、環境の確認
      ネットワークタイムアウト	APNに到達できない	一時的な問題。API呼び出しを再試行してください

   3. 除外を送信 > 0の場合、除外された理由 テーブルを確認します。

      table 0-row-3 1-row-3 2-row-3 3-row-3
      共通の除外	意味	解決策
      プロファイルがオプトアウトされました	ユーザーが通知をオプトアウトしました	プロファイルの同意ステータスを確認
      トークンをブロックリストに加える	無効としてマークされたトークン	トークンの再登録またはブロックリストステータスの確認
      プロファイルは対象外です	プロファイルがキャンペーン条件を満たしていません	キャンペーンオーディエンスのルールの確認

詳しくは、​ ライブアクティビティキャンペーンレポートページ ​を参照してください。

1. Journey Optimizerの​Customer > Profiles​に移動します。

2. プロファイルを検索して開きます。

3. 「イベント」タブを選択します。

4. eventType = "message.feedback"のイベントをフィルタリングまたは検索します。

5. ライブアクティビティのliveActivityIDとeventの種類に一致するフィードバックイベントを探します。

6. 次のキーフィールドを確認します。

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
   フィールド	使用可能な値	意味
   feedbackStatus	sent, error, denylist	サービスプロバイダーからの配信の結果
   serviceProvider	apns/apnsSandbox	IOS Live アクティビティのAPNであるべき
   errorCode	数値コードまたはnull	失敗した場合のAPNs固有のエラーコード
   errorMessage	エラーの説明またはnull	人間が判読可能なエラーメッセージ

7. 場合feedbackStatus: "error":

   • 特定のAPNs エラーについては、errorCodeとerrorMessageを確認してください
   • APNの一般的なエラーには、期限切れのトークン、無効な証明書、間違ったバンドル IDなどがあります

8. フィードバックイベントが見つからない場合：

   • プッシュ通知が試行されていない可能性があります
   • 上記の手順1で説明したように、キャンペーンレポートでプロファイルが除外されたかどうかを確認します。

1. Assurance セッションを開きます。API呼び出し中にアクティブにする必要があります。

2. API呼び出しを実行します（開始、更新、終了）。

3. イベントリスト​で、ライブアクティビティ配信イベントを探します。

4. APN プッシュ配信に関連するイベントを検索します。

5. 次のインジケーターを確認します。

   • APNsへのプッシュリクエスト: AdobeがAppleのサーバーにプッシュを送信したことを確認します
   • APNs応答: APNがプッシュを承認したか拒否したかを示します
   • 配信ステータス：成功または失敗の兆候

6. 問題が見つかった場合は、次の一般的なAPNの配信の問題を参照してください。

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   問題	Assuranceの症状	解決策
   APNs証明書の有効期限	認証エラー	新しいAPNs証明書の更新とアップロード
   環境が正しくない（開発環境と実稼動環境）	トークンの不一致エラー	証明書がアプリのビルドタイプに一致することを確認する
   バンドル IDの不一致	無効なバンドル ID	証明書バンドル IDがアプリと一致することを確認する
   トークン期限切れ	APNsからのInvalidToken エラー	ライブアクティビティトークンの再登録
   レート制限	リクエストが多すぎます	API呼び出し頻度の削減

1. Campaign レポートのライブアクティビティライフサイクル指標を確認します。

   キャンペーンレポートで、ライブアクティビティライフサイクル セクションを確認します。

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
   指標	確認すべきこと
   リモートスタート	API トリガー開始回数を表示する必要があります
   アップデート	更新イベント数を表示する必要があります
   終了	終了イベント数を表示する必要があります
   合計数	ライブアクティビティイベントの全体的な量

   これらの指標が0であるか、API呼び出しに一致しない場合は、AdobeとAPNの間に配信の問題があります。

2. Adobeが正常に配信されたが、デバイスにライブアクティビティが表示されない場合：

   • IOS デバイスログでライブアクティビティエラーを確認します。
   • アプリが前景または背景にあることを確認します（終了しません）。
   • デバイスにネットワーク接続があることを確認します。
   • 複数のデバイスをテストして、デバイス固有の問題を除外します。
   • IOSのバージョンが16.1以降であることを確認します。

すべての手順を完了しても問題が解決しない場合は、Adobe カスタマーサポートにお問い合わせください。

必要な情報：

• キャンペーン ID と名前
• プロファイルの名前空間とID
• API ペイロードからのliveActivityID
• API呼び出しのタイムスタンプ
• スクリーンショット：
• キャンペーンレポート（送信統計、エラー理由、除外された理由）
• プロファイルイベント （liveActivity.updateToken, message.feedback）
• 配信イベントを示すAssuranceのセッション
• 完全なAPI リクエストペイロード
• APNs証明書の詳細（有効期限、環境、バンドル ID）

1. Assurance セッションを開きます。

2. ライブアクティビティがデバイスで開始されたときに、セッションがアクティブであることを確認します。

3. eventType = "liveActivity.updateToken"のイベントをフィルタリングまたは検索します。

4. イベントを選択し、ペイロードを調べます。

   • token フィールドに有効な更新トークン文字列が含まれていることを確認します。
   • liveActivityIDがライブアクティビティインスタンスと一致することを確認します。
   • activityTypeがattributes-typeと一致することを確認します。

5. イベントが見つからない場合：

   • 更新トークンは、SDKによって生成またはキャプチャされませんでした。
   • ユーザーがライブアクティビティ権限を付与したかどうかを確認します。
   • 実際にデバイスで正常に開始されたことを確認します。
   • 更新トークンを取得するために、モバイル SDKが適切に統合されていることを確認します。

6. イベントが見つかった場合は、手順2に進みます。

1. Journey Optimizerの​Customer > Profiles​に移動します。

2. プロファイルを検索して開きます。

3. 「イベント」タブを選択します。

4. liveActivity.updateToken イベントを探します。

5. イベントの詳細を確認します。

   • タイムスタンプが最新であることを確認します（ライブアクティビティが開始されたときに一致）。
   • tokenとliveActivityIDが存在することを確認します。
   • activityTypeが正しいことを確認します。

6. プロファイルにイベントが見つからない場合：

   • 更新トークンイベントはまだプロファイルに取り込まれていない可能性があります。
   • 5～10分待って、もう一度確認してください。
   • 15分経過しても見つからない場合は、イベント取り込みの問題が発生している可能性があります。

7. イベントが見つかった場合、更新トークンは同期されています。 手順3に進みます。

1. Assurance セッションで、更新または終了API呼び出しを実行します。

2. イベントリスト​で、ライブアクティビティ配信イベント（APNs プッシュイベント）を探します。

3. 次を示すイベントを確認します。

   • プッシュ通知がAPNに送信されました。
   • APNからの応答（成功またはエラー）。
   • 配達確認。

4. APNs配信イベントが存在する場合：プッシュ通知が送信されました。 それでもデバイスが更新されない場合、問題はデバイス側にある可能性があります（アプリがプッシュやネットワークの問題を処理しない場合など）。

5. APNs配信イベントが見つからない場合：更新トークンが正しく保存されていないか、Adobe システムのプロファイルに関連付けられていない可能性があります。

6. エラーイベントが存在する場合：特定のエラーの理由（無効なトークン、APNが拒否されたなど）について、エラーの詳細を調べます。

1. Journey Optimizerで​ API Triggered Marketing Campaign ​を開きます。

2. 「オーディエンス」セクションに移動して、次を確認します。

   • キャンペーン用にオーディエンスが選択されます。
   • オーディエンス IDは、API ペイロードで使用されるIDと一致します。
   • オーディエンスには、想定されるプロファイルが含まれています。

3. 「アクション」セクションに移動します。

4. ライブアクティビティ設定​を確認します。

   • IOS アプリの設定は、正しいバンドル IDを使用して設定する必要があります。
   • アクティビティの種類は、API ペイロードのattributes-typeと一致する必要があります。 例えば、ペイロードに"attributes-type": "AirplaneTrackingAttributes"が含まれている場合、キャンペーンはこの同じアクティビティタイプを指定する必要があります。

ブロードキャストペイロードの構造は、単一キャンペーンとは異なります。 ペイロードが正しいブロードキャスト形式に従っていることを確認します。

ブロードキャストの必須フィールド：

{
   "campaignId": "878a11d4-b519-47bd-8313-fecfee19857b",
   "audience": {
      "id": "8c3dbdea-2957-401f-acf0-3966fba1601e"
   },
   "context": {
      "requestPayload": {
      "aps": {
         "input-push-channel": "FEt0NgvLEfEAAOqA6AXdIQ==",
         "content-available": 1,
         "timestamp": 1771829292,
         "event": "update",
         "attributes-type": "AirplaneTrackingAttributes",
         "content-state": { ... },
         "attributes": { ... }
      }
      }
   }
}

一般的なペイロードの問題：

重要なブロードキャスト固有のフィールド：

• input-push-channel:

  • すべてのブロードキャストライブアクティビティに必要です。
  • この特定のブロードキャストインスタンスの一意の識別子として機能します。
  • オーディエンス内のすべてのプロファイルは、このチャネルにリンクされたライブアクティビティを受け取ります。
  • liveActivityData.channelIDのchannelIDと一致する必要があります（手順3を参照）。
  • クライアントがApple Developer Portal上のappID用に作成する必要があります。
  • 特定のappID用に作成されたチャネルのみを、そのアプリのライブアクティビティのブロードキャストに使用できます。

• audience.id:

  • Adobe Experience Platformで作成された有効なオーディエンスセグメントを参照する必要があります。
  • このオーディエンス内のすべてのプロファイルは、ライブアクティビティを対象としています。
  • オーディエンスをアクティブ化し、有効なliveActivityPushNotificationDetailsのプロファイルを含める必要があります。

常に最新のタイムスタンプを使用：

• timestamp フィールドは、常にAPI呼び出しごとに現在のUnix エポック時間（秒単位）である必要があります。
• この要件は、すべてのイベントタイプ（start、update、およびend）に適用されます。
• 更新/終了に重要：古いタイムスタンプを使用すると、更新リクエストと終了リクエストが失敗します。
• ブロードキャスト API呼び出しごとに新しいタイムスタンプを生成します。

任意フィールド：

• dismissal-date：自動却下のUnixのエポックタイム（end イベントにのみ関連）
• alert：通知用にtitleとbodyを含むオブジェクト

完全なAPI仕様については、Adobe Journey Optimizer Messaging API ドキュメント ​を参照してください。

ペイロードフィールドがiOS アプリのActivityAttributes実装と一致していること、およびinput-push-channelがliveActivityDataのchannelIDと一致していることを確認してください。

1. IOS ActivityAttributesの定義を確認します。

カスタム ActivityAttributes構造体は、AdobeのLiveActivityAttributes プロトコルを実装する必要があります。

struct AirplaneTrackingAttributes: LiveActivityAttributes {
   public struct ContentState: Codable, Hashable {
      var journeyProgress: Int
   }

   // Adobe SDK requirement
   var liveActivityData: LiveActivityData

   // Your custom attributes
   var arrivalAirport: String
   var departureAirport: String
   var arrivalTerminal: String
}

1. IOS フィールドをブロードキャスト API ペイロードにマッピングします。

すべてのイベントに対して、attributesとcontent-stateの両方を含めます。

      {
      "aps": {
         "input-push-channel": "FEt0NgvLEfEAAOqA6AXdIQ==",
         "event": "start",
         "timestamp": 1771829292,
         "attributes-type": "AirplaneTrackingAttributes",
         "content-state": {
         "journeyProgress": 0
         },
         "attributes": {
         "arrivalAirport": "DEL",
         "departureAirport": "MUM",
         "arrivalTerminal": "T1",
         "liveActivityData": {
            "channelID": "FEt0NgvLEfEAAOqA6AXdIQ=="
         }
         }
      }
      }

重要：input-push-channelはchannelID​と一致する必要があります

• apsのルートのinput-push-channel値は、liveActivityDataのchannelIDと完全に一致する必要があります。
• 上記の例では、両方の値は"FEt0NgvLEfEAAOqA6AXdIQ=="です。
• このマッチングにより、ブロードキャストインスタンスがライブアクティビティデータにリンクされます。
• 不一致が発生すると、配信エラーが発生します。

主要な検証ポイント：

• すべてのイベントタイプに対して、content-stateにすべてのContentState フィールドを含めます。
• 開始イベントに対してのみ、attributesにすべてのカスタム LiveActivityAttributes フィールドを含めます。
• 開始イベントの場合、liveActivityData.channelIDはinput-push-channelと一致する必要があります。
• フィールド名は大文字と小文字が区別され、正確に一致する必要があります。
• データ型は一致する必要があります（String、Int、Bool、ネストされたオブジェクトなど）。
• 更新/終了イベントの場合は、元の開始イベントと同じinput-push-channelを使用します。

よくある間違い：

Assuranceを使用して、APIの実行とペイロードの配信を検証します。

1. オーディエンスの一部であるテストデバイスでAssurance セッションを開きます。

2. ブロードキャスト API呼び出しを実行します。

3. イベントリスト​で、次を探します。

   • キャンペーン実行イベント：
   • ライブアクティビティ配信イベント：
   • ペイロード検証エラーを示すエラーイベント。

4. イベントペイロードを調べて確認します。

   • ペイロードが正しく処理されました。
   • input-push-channelが存在します。
   • 検証エラーは発生しませんでした。
   • ライブアクティビティは、オーディエンスメンバー向けにAPNに送信されました。

まず、ライブアクティビティを受け取るプロファイルが実際にオーディエンスの一部であるかどうかを確認します。

1. Adobe Experience Platformの​ Audiences ​に移動します。

2. キャンペーンのaudience.idを使用してオーディエンスを検索し、開きます。

3. 参照​または​ サンプルプロファイル ​をクリックして、オーディエンスメンバーを表示します。

4. 名前空間とID値を使用して、テストプロファイルを検索します。

5. オーディエンスにプロファイルが見つからない場合：

   • プロファイルがオーディエンスの基準またはセグメントルールを満たしていません。
   • オーディエンス定義を確認して、メンバーシップ要件を理解します。
   • プロファイルデータまたはオーディエンス定義を更新して、プロファイルを含めます。
   • オーディエンスの評価が完了するのを待ちます（手順2を参照）。

6. オーディエンスにプロファイルが見つかった場合： ステップ 2に進んで、データの鮮度を確認します。

オーディエンスがバッチ評価とストリーミング評価のどちらを使用しているかを特定し、データの鮮度を判断します。

1. オーディエンスの詳細 ページで、評価方法​を確認します。

   • バッチ：毎日1回、スケジュールに従って評価されます。
   • ストリーミング: プロファイルの更新時にリアルタイムで評価されます。
   • Edge: リアルタイムでエッジの場所で評価されました。

評価方法に基づく適切なトラブルシューティング手順に従います。

オーディエンスがバッチ評価を使用している場合：

1. バッチオーディエンスの制限について：

   • バッチオーディエンスは、1日に1回（通常は毎晩）評価されます。
   • オーディエンスのスナップショットは、最大で24時間前になる場合があります。
   • プロファイルが最近登録したライブアクティビティトークンの場合、これらのトークンは現在のスナップショットにない可能性があります。
   • プロファイルの更新は、次のバッチ評価まで反映されません。

2. 最後の評価が発生した際の確認：

   • オーディエンスの詳細で、最終評価 タイムスタンプを探します。
   • プロファイルのliveActivityPushNotificationDetailsがこのタイムスタンプの後に更新された場合、オーディエンスには古いデータがあります。

3. 古いデータを解決：

   1. オプション 1：スケジュールされたバッチ評価を待つ

      • 次のバッチ評価には、更新されたプロファイルデータが含まれます。
      • これは1日に1回自動的に行われます。
      • 緊急性の低いシナリオに最適：

   2. オプション 2: オンデマンドのオーディエンス評価のトリガー

      1. AEPの​ Audiences ​に移動します。
      2. オーディエンスを選択します。
      3. 今すぐ評価​または​ オンデマンドでアクティベート ​をクリックします。
      4. 評価が完了するまで待ちます（オーディエンスサイズによっては数分から数時間かかる場合があります）。
      5. プロファイルがオーディエンススナップショットのデータを更新したことを確認します。
      6. ブロードキャスト API呼び出しを再試行します。

オーディエンスがストリーミング評価を使用している場合：

1. ストリーミングオーディエンスの動作について：

   • ストリーミングオーディエンスは、プロファイルの更新が発生したときにリアルタイムで評価されます。
   • 新しいプロファイル: セグメントの条件を満たす場合は、作成後すぐに選定します。
   • 更新されたプロファイル：更新された直後に選定または選定を解除しました。
   • 既存の変更されていないプロファイル：更新が発生しない限り、再評価されません。

2. 問題の特定：

   • プロファイルが既に存在し、セグメント条件を満たしていても、そのプロファイルに更新が発生しない場合は、新しく作成されたストリーミングオーディエンスに追加できない可能性があります。
   • プロファイルは、トリガーの再評価に対する更新（属性の変更）を受け取る必要があります。

3. 問題の解決：

   • 新しいプロファイルの場合：条件が満たされると、自動的に選定されます。 行動は必要ありません。

   • 最近更新されていない既存のプロファイルの場合：

     • プロファイルのマイナーな更新（例：タイムスタンプフィールドの更新）を行います。
     • ストリーミング評価がトリガーされ、プロファイルがオーディエンスに追加されます。
     • 代替案：既存のプロファイルにバッチオーディエンスまたはエッジオーディエンスを使用します。

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 systematic approach to diagnose why Live activities fail to appear, update, or end even when the API returns HTTP 200, covering profile and token, campaign configuration, payload, and delivery issues for unitary and broadcast use cases.

Intents:

• Distinguish the unitary (API-triggered Transactional) and broadcast (API-triggered Marketing) debugging paths
• Verify profile existence and Live activity push token sync (Scenario 1)
• Validate campaign surface, Activity type, and API payload structure (Scenario 2)
• Analyze delivery failures via campaign reports and message.feedback events (Scenario 3)
• Diagnose unsynced update tokens (Scenario 4) and check execution status via the GET Message Execution API (Scenario 5)
• Troubleshoot broadcast payload and audience-freshness issues (Scenarios 6 and 7) and query the feedback dataset directly (Advanced)

Glossary:

• Push-to-start token: An APNs token generated by iOS 17+ that allows AJO to remotely start a Live activity without the app being open; registered by the mobile SDK and stored on the AEP profile (product-specific)
• Update token: A per-instance APNs token generated when a Live activity starts; required for unitary update and end events (product-specific)
• input-push-channel: A unique channel identifier created on the Apple Developer Portal for broadcast Live activities; acts as the broadcast update token (product-specific)
• liveActivityData: A required property on the Adobe SDK LiveActivityAttributes protocol; contains liveActivityID for unitary or channelID for broadcast (product-specific)
• Broadcast Channel ID: The value of input-push-channel; must exactly match liveActivityData.channelID (product-specific)
• attributeType / attributes-type: The name of the Swift ActivityAttributes struct; stored as attributeType (camelCase) on the profile and sent as attributes-type (hyphenated) in APS JSON — the same value in different representations (product-specific)
• liveActivityPushNotificationDetails: The AEP profile attribute that stores a device’s push-to-start token, appId, platform, and attributeType (product-specific)
• APS payload: The JSON structure sent under context.requestPayload.aps, containing the event, content-state, attributes, and control fields (product-specific)
• Assurance: Adobe Experience Platform Assurance, a real-time debugging tool for connected test devices; not available for production end-user devices (product-specific)

Guardrails:

• Live activities can only be triggered and managed through API Triggered Campaigns.
• The High Throughput option must not be enabled, since it is incompatible with Live activity.
• Assurance sessions are for test and QA devices only; end-user production devices are not connected to Assurance.
• Requirements: a physical iOS device on iOS 16.1 or later; the Xcode Simulator supports local start only (remote push via APNs is not supported on Simulator); remote start from Assurance requires iOS 17.1 or later, a valid push-to-start token, and a valid channel configuration; Adobe Experience Platform Mobile SDK 5.11.0 or later.
• Batch audiences may be up to 24 hours stale (batch evaluation, once daily); this audience-freshness risk is not applicable to unitary use cases.
• The first time a Live activity starts on a device, iOS shows a one-time permission prompt; the user must tap “Allow” for update tokens to be generated and synced.
• input-push-channel must exactly match liveActivityData.channelID; a mismatch causes delivery failures.
• A feedbackStatus of sent confirms hand-off to APNs only, not device rendering; device-side failures and the 8-hour Live activity duration limit are not observable from the dataset.

Terminology:

• Canonical name: API Triggered Campaign — Acronym: n/a — variants: API-triggered Transactional (unitary), API-triggered Marketing (broadcast)
• Synonyms: “attributeType” = “attributes-type” (the same value; camelCase on the profile, hyphenated in APS JSON)
• Synonyms: “Broadcast Channel ID” = “input-push-channel”
• Do not confuse: “Push-to-start token” (starts a Live activity, per profile) ≠ “Update token” (updates or ends a unitary instance, per instance)
• Do not confuse: “Unitary” (API-triggered Transactional, individual profile) ≠ “Broadcast” (API-triggered Marketing, audience segment)
• Do not confuse: execution statuses “PENDING” ≠ “INPROGRESS” ≠ “COMPLETED” ≠ “FAILED”
• Do not confuse: feedbackStatus “sent” ≠ “error” ≠ “exclude” ≠ “delay”
• Do not confuse: la_event value “remotestart” (recorded in the dataset for initial delivery) ≠ “start” (the event field value in the payload)

FAQ:

• Q: Why does the API return 200 OK but the Live activity does not appear? — A 200 confirms the request was accepted, but delivery can still fail at the profile/token, campaign configuration, payload, or APNs stage; work through Scenarios 1 to 3.
• Q: Can I use Assurance for production end-user devices? — No; Assurance sessions are for test and QA devices only. For production diagnostics, use the dataset queries.
• Q: Why do update and end calls fail after the Live activity started? — The per-instance update token may not be synced; the user must have tapped “Allow” on the one-time permission prompt for update tokens to be generated (Scenario 4).
• Q: How do I check execution status programmatically? — Use the GET Message Execution API; for unitary executions the executionId is prefixed with HUOC-, and the status field returns PENDING, INPROGRESS, COMPLETED, or FAILED.
• Q: What does a feedbackStatus of sent mean? — It confirms Journey Optimizer successfully handed the notification to APNs; it does not confirm that the Live activity was rendered on the device.
• Q: Why are some audience members not receiving a broadcast? — The profile may not be in the audience, or a batch audience snapshot may be up to 24 hours stale; trigger on-demand evaluation or ensure a streaming update occurs (Scenario 7).