一般的なライブアクティビティのトラブルシューティング シナリオ troubleshoot-mobile-live

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

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

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

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

イベントが見つからない場合、アプリはMessaging.registerLiveActivitiesを正しく呼び出していません。 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分待ってから、もう一度確認してください。

Androidは、標準のFCM登録トークンをライブアクティビティに使用します。 liveActivity.pushToStart イベントまたは個別のライブアクティビティプッシュトークンがありません。

1. Assuranceで、Events リストを開き、標準のプッシュトークン登録イベントを見つけます。
2. イベントを選択し、そのペイロードを調べて、FCM登録トークンが存在することを確認します。
3. 登録イベントが正常に送信されたことを確認します。
4. Adobe Experience Platformで、プロファイルの「属性」タブを開き、手順2で説明されているように、トークンがpushNotificationDetailsに存在することを確認します。

登録イベントまたはプロファイルトークンが見つからない場合は、アプリがMobileCore.setPushIdentifier(token)を使用してFCM登録トークンをSDKに転送することを確認します。

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

2. pushNotificationDetailsを探します。 AndroidはliveActivityPushNotificationDetailsではなく、このオブジェクトを使用します。attributeType フィールドは必要ありません。

3. トークン設定がこの構造に従っていることを確認します。

   code language-json
   { "pushNotificationDetails": [ { "appId": "com.adobe.marketing.mobile.liveupdatessample", "token": "fcm-registration-token...", "platform": "fcm", "denylisted": false, "identity": {} } ] }

各フィールドを検証：

いずれかのフィールドが正しくない場合は、必要に応じてアプリ設定を修正し、MobileCore.setPushIdentifier(token)を使用してFCM トークンを再度転送し、5 ～ 10分待ってから、プロファイルを再度確認します。

pushNotificationDetailsが見つからない場合、トークンはまだ同期されていません。 Assuranceでトークン登録を確認したら、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": { ... }
            }
         }
      }
   }]
}

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

重要：常に新しいタイムスタンプを使用する

• 各API呼び出しを行った時点で、timestampを現在のUnix エポックタイム（秒単位）に設定します。 これは、すべてのイベントタイプ（start、update、およびend）に適用されます。
• 古いタイムスタンプまたは再利用されたタイムスタンプは、更新リクエストと終了リクエストが失敗するか、デバイスによって無視されます。 以前のリクエストまたはキャッシュされた値のタイムスタンプを​ not ​で再利用してください。

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

• 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. Journey Optimizerで​ キャンペーン ​を開き、アクション メニューに移動します。
2. ライブアクティビティ設定​を確認します。 サーフェスは、プロファイルのpushNotificationDetailsのappIdに一致するパッケージ名でAndroid アプリをターゲットにする必要があります。
3. サーフェスがそのアプリのFCM資格情報を使用していることを確認します。 プロファイルのトークン プラットフォームは"fcm"である必要があります。
4. ペイロードのnotification_channel_idが、アプリで作成された通知チャネルと一致することを確認します。

Android Live アクティビティフィールドをcontext.requestPayload.fcmの下に配置します。

単一の開始ペイロード：

{
   "requestId": "your-request-id",
   "campaignId": "your-campaign-id",
   "recipients": [
      {
         "type": "aep",
         "userId": "your-device-ECID",
         "namespace": "ECID",
         "context": {
            "requestPayload": {
               "fcm": {
                  "notification_id": "flight-DL-321",
                  "timestamp": 1756984054,
                  "notification_channel_id": "live_updates_channel",
                  "priority": "PRIORITY_HIGH",
                  "event_type": "start",
                  "title": "Flight DL-321",
                  "body": "Boarding starts shortly",
                  "critical_text": "25 min",
                  "content_state": {
                     "custom_key_template_type": "progress",
                     "custom_key_journey_start": "DEL",
                     "custom_key_journey_progress": 10,
                     "custom_key_journey_end": "MUM"
                  }
               }
            }
         }
      }
   ]
}

サンプルのタイムスタンプを、現在のUnixのエポック時間（秒単位）に置き換えます。 content_state キーは例であり、アプリのスタイルプロバイダーと一致する必要があります。

ブロードキャストの場合は、audience.idでAPI トリガーのマーケティングキャンペーンを使用し、fcm オブジェクトをcontext.requestPayloadの下に配置します。 ターゲット デバイスが購読しているFCM トピックにtopic_nameを設定します。 開始、更新、終了の各イベントで、トピックとnotification_idを変更しないでください。 Android ブロードキャストペイロードの例を参照してください。

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

タイムスタンプとライフサイクルのチェック：

• 開始、更新、終了イベントごとに、新しいtimestampを秒単位で使用します。 同じ秒内にリクエストが行われた場合でも、同じnotification_id （ブロードキャストの場合はtopic_name）の前の値よりも大きいことを確認します。
• 古いタイムスタンプまたは同じタイムスタンプは無視されます。 キャッシュされたタイムスタンプを再利用しないでください。
• オプションのwhen フィールドは、メッセージの順序ではなく、通知の表示時間を制御します。 適度に最新の状態に保ち、数秒で表現しましょう。
• アクティビティを更新または終了するには、notification_idを変更せずにevent_typeを変更します。 Androidは、3つのライフサイクルイベントすべてに同じFCM登録トークンを使用します。個別の更新トークンは必要ありません。

終了イベントの却下：

event_type: "end"の場合、オプションでdismiss_afterを、完了したライブアクティビティを削除する前に表示し続ける秒数に設定します。 これはエポックタイムスタンプではなく、デュレーションです。

アプリのスタイルプロバイダーは、ライブアクティビティ通知でのcontent_state値のレンダリング方法を決定します。

1. メッセージングとライブアクティビティ拡張機能がアプリに統合されていることを確認します。
2. content_stateの各フィールドが、期待される値の種類を含め、スタイルプロバイダーが処理するキーと一致することを確認します。
3. title、bodyおよびcritical_textに、意図した表示テキストが含まれていることを確認してください。 critical_textはステータスバーチップに使用されています。
4. 通知権限が付与され、notification_channel_idによって識別されたチャネルが存在することを確認します。

よくある間違い：

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

接続されたAndroid テストデバイスでAssuranceを使用します。

1. Assurance セッションを開き、FCM トークン登録が表示されていることを確認します。
2. API呼び出しを実行してライブアクティビティを開始し、同じnotification_idでタイムスタンプを増やす更新イベントと終了イベントを送信します。
3. 処理エラーまたは検証エラーについて、利用可能なSDK イベントとペイロードを確認します。 Android ペイロードでfcmと意図されたライフサイクル値が使用されていることを確認します。
4. プロファイルの「イベント」タブで、一致する「message.feedback」イベントを調べます。 serviceProviderがfcmであることを確認し、配信エラーについてfeedbackStatus、errorCodeおよびerrorMessageを確認してください。
5. 配信に成功してもライブアクティビティがレンダリングされない場合は、デバイス上のアプリログ、スタイルプロバイダーマッピング、通知権限、チャネル設定を調べます。

​ キャンペーンレポート ​に送信エラーが表示されない場合は、この手順をスキップしてください。 それ以外の場合は、Error Reasons テーブルのエラーを次の一般的なAPNs エラーと一致させます。

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. フィードバックイベントが見つからない場合：

   • プッシュ通知が試行されていない可能性があります。
   • プロファイルが​ キャンペーンレポート ​で除外されたかどうかを確認します。

feedbackStatusがsentの場合： Journey OptimizerはAPNに通知を渡しました。 これはデバイスのレンダリングを確認しません。 手順4でデバイス側のチェックを続行します。

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呼び出し頻度の削減

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

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

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

必要な情報：

• キャンペーン ID と名前
• プロファイルの名前空間とID
• API ペイロードからのliveActivityID
• API呼び出しのタイムスタンプ
• 送信統計、エラー理由、除外された理由を示すキャンペーンレポートのスクリーンショット
• 関連するプロファイルイベント （liveActivity.updateToken、単一の更新/終了問題およびmessage.feedback）
• Assuranceセッションの詳細と関連イベントのスクリーンショット
• API リクエストペイロードと応答。資格情報とデバイストークンが墨消し済み
• APNs証明書の詳細（有効期限、環境、バンドル ID）

​ キャンペーンレポート ​に送信エラーが表示されない場合は、この手順をスキップしてください。 それ以外の場合は、Error Reasons テーブルのエラーを次の一般的なFCM エラーと一致させます。

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

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

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

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

5. 調査中のキャンペーンおよびAPI呼び出しタイムスタンプのフィードバックイベントを探します。

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

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
   フィールド	使用可能な値	意味
   feedbackStatus	sent, error, denylist	サービスプロバイダーからの配信の結果
   serviceProvider	fcm	FCMはAndroid プッシュ配信を処理しました
   errorCode	プロバイダーエラーコードまたはnull	配信に失敗した場合のFCM固有のエラーコード
   errorMessage	エラーの説明またはnull	人間が判読可能なエラーメッセージ

7. 場合feedbackStatus: "error":

   • errorCodeとerrorMessageを調べ、手順1から対応するFCM解決を適用します。

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

   • プッシュ通知が試行されていないか、フィードバックがまだ利用できない可能性があります。
   • プロファイルが​ キャンペーンレポート ​で除外されたかどうかを確認します。

feedbackStatusがsentの場合： FCMが通知を受け入れました。 これは、デバイスがライブアクティビティをレンダリングしたことを確認するものではありません。 手順4でデバイス側のチェックを続行します。

接続されたAndroid テストデバイスでAssuranceを使用します。

1. Assurance セッションを開き、API呼び出し中もアクティブのままにします。
2. event_typeをstart、updateまたはendに設定してAPI呼び出しを実行します。
3. イベント リストで、FCMへのリクエストとその応答に対して使用可能なプッシュ配信イベントを調べます。
4. FCMがリクエストを受け入れたか拒否したかを確認し、報告されたエラーの詳細を確認します。
5. 拒否されたリクエストの場合は、手順1のFCM エラーを使用して、トークン、Firebase プロジェクトの資格情報、ペイロードを確認します。 セッションでプロバイダーイベントが使用できない場合は、message.feedback件のイベントとキャンペーンレポートを使用します。

Adobeが正常に配信されたが、デバイスがライブアクティビティを表示または更新しない場合：

• Android アプリログで、プッシュ処理とライブアクティビティのレンダリングエラーを調べます。
• 通知が許可され、昇格された通知がcanPostPromotedNotifications()を使用して許可されていることを確認します。
• POST_NOTIFICATIONSとPOST_PROMOTED_NOTIFICATIONSの権限が付与され、notification_channel_idによって識別されたチャネルが存在することを確認します。
• timestampが最後に処理されたイベントより新しく、notification_idが変更されていないことを確認してください。 ブロードキャストの場合は、デバイスのtopic_nameへのサブスクリプションも確認してください。
• アプリが強制停止されていないことを確認します。
• デバイスにネットワーク接続があることを確認します。
• 複数のデバイスをテストして、デバイス固有の問題を除外します。
• デバイスでAndroid 16.1 （API レベル 36.1）以降が実行されており、アプリでtargetSdk 36が使用されていることを確認します。
• content_state個のキーと値の種類がアプリのスタイルプロバイダーに一致することを確認してください。

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

必要な情報：

• キャンペーン ID と名前
• プロファイルの名前空間とID
• API ペイロードのnotification_idおよびevent_type。ブロードキャストの場合は、topic_nameおよびオーディエンス IDも含まれます
• API呼び出しのタイムスタンプ
• 送信統計、エラー理由、除外された理由を示すキャンペーンレポートのスクリーンショット
• 関連プロファイル message.feedback イベント （FCM エラーコードおよびメッセージを含む）
• Assuranceセッションの詳細と関連イベントのスクリーンショット
• API リクエストペイロードと応答。資格情報とデバイストークンが墨消し済み
• Android パッケージ名、Firebase プロジェクトおよび送信者ID、FCM資格情報設定の詳細。秘密鍵は含まれません
• Android OSのバージョン、デバイスモデル、通知権限のステータス、関連するアプリログ

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": "start",
            "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 ペイロードにマッピングします。

すべてのイベントタイプにcontent-stateを含めます。 liveActivityData.channelIDを含むattributesを開始イベントにのみ含めます：

{
   "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. Journey Optimizerで​ API トリガーマーケティングキャンペーン ​を開きます。

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

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

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

4. ライブアクティビティ設定​が正しいAndroid パッケージをターゲットとし、一致するFCM資格情報を使用していることを確認してください。 Androidでは、アクティビティの種類またはattributes-type フィールドは使用されていません。

Androidの放送では、FCMのトピックを使用しています。 audience.idを含め、fcm オブジェクトを個別の受信者の下ではなくcontext.requestPayloadの下に配置します。

ブロードキャスト開始ペイロードの例：

{
   "requestId": "your-request-id",
   "campaignId": "your-marketing-campaign-id",
   "audience": {
      "id": "your-audience-id"
   },
   "context": {
      "requestPayload": {
         "fcm": {
            "topic_name": "flight_DL321",
            "notification_id": "flight-DL-321",
            "notification_channel_id": "live_updates_channel",
            "timestamp": 1771829292,
            "priority": "PRIORITY_HIGH",
            "event_type": "start",
            "title": "Flight DL-321",
            "body": "Boarding starts shortly",
            "critical_text": "25 min",
            "content_state": {
               "custom_key_template_type": "progress",
               "custom_key_journey_start": "DEL",
               "custom_key_journey_progress": 10,
               "custom_key_journey_end": "MUM"
            }
         }
      }
   }
}

サンプルのタイムスタンプを、現在のUnixのエポック時間（秒単位）に置き換えます。 アプリのスタイルプロバイダーにcontent_state キーを適応させます。

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

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

• topic_name:​は、ターゲットデバイスが購読しているFCM トピックを識別します。 開始、更新、終了の各リクエストに、同じ空でない値を含めます。
• audience.id:​は、Adobe Experience Platformでのキャンペーンのオーディエンスを識別します。 有効なpushNotificationDetailsのメンバーシップとサンプル プロファイルを確認してください。

タイムスタンプとオプションのフィールド：

• 各イベントに対して新しいtimestampをエポック秒で生成し、同じトピックの最後の値よりも厳密に大きいことを確認します。 古い値または等しい値は無視されます。
• whenは、オプションで通知の表示時間をエポック秒に設定します。 メッセージの順序は制御できません。
• event_type: "end"の場合、dismiss_afterは、完了したアクティビティが削除されるまでの表示時間をオプションで指定します。 これはエポックタイムスタンプではなく、デュレーションです。

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

1. FirebaseMessaging.getInstance().subscribeToTopic(topic)を使用して、テストデバイスがtopic_nameで指定されたトピックを正確に購読していることを確認します。
2. サブスクリプションが成功し、インストール済みのAdobe Live アクティビティ拡張機能でサポートされているtopic-subscription トラッキング APIを通じてアプリがレポートすることを確認します。
3. 開始、更新、終了イベント全体でtopic_nameとnotification_idを変更しないでください。
4. content_state個のキーと値の種類がアプリのスタイルプロバイダーと一致することを確認します。
5. 通知権限が付与され、notification_channel_idがアプリで作成されたチャネルと一致することを確認してください。

よくある間違い：

その他のフィールドと例については、Android ブロードキャストペイロードの例を参照してください。

オーディエンスの一部であり、ブロードキャストトピックにサブスクライブしているコネクテッドAndroidテストデバイスでAssuranceを使用します。

1. ブロードキャスト API呼び出しを実行する前に、Assurance セッションを開きます。
2. 同じtopic_nameとnotification_idを持ち、タイムスタンプを増やすリクエストを開始、更新、終了して送信します。
3. Events リストで、使用可能なSDKおよび配信イベントを検査して、ペイロード処理エラーがないか確認します。
4. ペイロードに、意図したfcm オブジェクト、topic_nameおよびevent_typeの値が含まれていることを確認します。
5. キャンペーンレポートと利用可能なmessage.feedback件のイベントを確認して、FCM配信の結果を確認します。 Android serviceProvider値はfcmです。
6. FCMがメッセージを受け入れてもデバイスがアクティビティをレンダリングしない場合は、トピックの購読、通知権限、チャネル設定、およびアプリログを調べます。 プロバイダーの受け入れにより、デバイスレンダリングが確認されない。