常見的上線活動疑難排解案例 troubleshoot-mobile-live

您可以使用Assurance來驗證Token註冊：

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中，開啟​ 事件 ​清單，然後找到標準推播權杖註冊事件。
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中確認Token註冊後，請等待5-10分鐘，然後重新檢查設定檔。

1. 在Journey Optimizer中，開啟您的​ 行銷活動 ​並導覽至​ 動作 ​功能表。
2. 檢查您的​上線活動設定。 您必須使用符合設定檔liveActivityPushNotificationDetails中appId的套件組合識別碼，為iOS應用程式設定表面。 例如，如果您的設定檔有"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。
• 過時或重複使用的時間戳記會導致更新和結束請求失敗或被裝置忽略。 請​ 不 ​重複使用先前請求或快取值的時間戳記。

選用欄位（所有事件型別）：

• requestId：追蹤的唯一識別碼（建議）。
• 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" } } }

驗證檢查清單：

• 在content-state中包含所有ContentState欄位（所有事件型別都需要）。

• 在attributes中包含所有LiveActivityAttributes欄位（僅限開始事件），包括：

  • liveActivityData （必要；通常包含liveActivityID或類似的識別碼）
  • 結構中的所有自訂欄位

• 完全符合欄位名稱（區分大小寫）。

• 符合資料型別（String、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金鑰為範例，必須符合您應用程式的樣式提供者。

對於廣播，使用API觸發的行銷活動搭配audience.id，並將fcm物件放在context.requestPayload下。 將topic_name設為目標裝置訂閱的FCM主題。 在開始、更新和結束事件中保持主題和notification_id不變。 請參閱Android廣播裝載範例。

常見承載問題：

時間戳記和生命週期檢查：

• 對每個開始、更新和結束事件，在Epoch秒內使用新的timestamp。 確保大於相同notification_id的上一個值（或廣播的topic_name），即使同一秒內提出請求亦然。
• 系統會忽略較舊或相等的時間戳記。 請勿重複使用快取的時間戳記。
• 選用的when欄位控制通知的顯示時間，而不是訊息順序。 保持適度的最新狀態，並在紀元秒內加以表示。
• 若要更新或結束活動，請變更event_type，同時保留notification_id不變。 Android會對所有三個生命週期事件使用相同的FCM註冊權杖；不需要個別更新權杖。

結束事件解除：

對於event_type: "end"，可選擇將dismiss_after設定為移除前，已完成的「上線」活動應保持可見的秒數。 這是持續時間，而非紀元時間戳記。

應用程式的樣式提供者會決定content_state值在即時活動通知中的呈現方式。

1. 確認Messaging和Live Activities擴充功能已整合至應用程式。
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. 如果傳送成功但即時活動未呈現，請檢查應用程式記錄、樣式提供者對應、通知許可權和裝置上的頻道設定。

如果行銷活動報告未顯示傳送錯誤，請略過此步驟。 否則，請比對​ 錯誤原因 ​資料表中的錯誤與下列常見的APN錯誤：

1. 導覽至Journey Optimizer中的​客戶 > 設定檔。

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"：

   • 檢查errorCode和errorMessage是否有特定的APN錯誤。
   • 常見的APN錯誤包括過期的權杖、無效的憑證、錯誤的套件組合ID。

8. 若找不到意見反應事件：

   • 可能尚未嘗試推播通知。
   • 檢查設定檔是否已排除在行銷活動報告中。

如果feedbackStatus是sent： Journey Optimizer已傳遞通知給APN。 這不會確認裝置轉譯。 繼續進行步驟4中的裝置端檢查。

1. 開啟Assurance工作階段，並在API呼叫期間將其維持作用中。

2. 執行API呼叫（開始、更新或結束）。

3. 在​ 活動清單 ​中，尋找已上線活動傳遞活動。

4. 搜尋與APN推送傳遞相關的事件。

5. 檢查下列指標：

   • 推送要求至APN：確認Adobe已傳送推送要求至Apple的伺服器
   • APN回應：顯示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憑證
   錯誤的環境（開發環境vs生產環境）	權杖不符錯誤	確保憑證符合應用程式建置型別
   套件組合ID不相符	無效的套件組合識別碼	驗證憑證套件組合ID是否與應用程式相符
   權杖已到期	來自APN的InvalidToken錯誤	重新註冊即時活動權杖
   速率限制	請求次數過多	降低API呼叫頻率

如果Adobe顯示傳送成功，但裝置未顯示已上線的活動：

• 檢查iOS裝置記錄檔中的即時活動錯誤。
• 確認應用程式位於前景或背景（未終止）。
• 確認裝置具有網路連線。
• 在多個裝置上測試以排除裝置特定問題。
• 確認iOS版本為16.1或更新版本。

如果您已完成所有步驟，但問題仍未解決，請聯絡Adobe客戶服務，聯絡：

必要資訊：

• 行銷活動 ID 和名稱
• 設定檔名稱空間和ID
• 來自API裝載liveActivityID
• API呼叫的時間戳記
• 顯示傳送統計資料、錯誤原因和排除原因的行銷活動報告熒幕擷取畫面
• 相關的設定檔事件（liveActivity.updateToken用於單一更新/結束問題，以及message.feedback）
• Assurance工作階段詳細資料和相關事件熒幕擷取畫面
• API要求裝載和回應，包含已編輯的憑證和裝置權杖
• APNs憑證詳細資料（到期、環境、套件組合ID）

如果行銷活動報告未顯示傳送錯誤，請略過此步驟。 否則，請比對​ 錯誤原因 ​資料表中的錯誤與下列常見的FCM錯誤：

1. 導覽至Journey Optimizer中的​客戶 > 設定檔。

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. 執行API呼叫，並將event_type設定為start、update或end。
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作業系統版本、裝置型號、通知許可權狀態和相關應用程式記錄檔

1. 在Journey Optimizer中開啟​API觸發的行銷活動。

2. 導覽至​ 對象 ​區段並驗證：

   • 已為行銷活動選取閱聽眾。
   • 對象ID符合您的API裝載中使用的對象ID。
   • 對象包含預期的設定檔。

3. 導覽至​ 動作 ​區段。

4. 檢查​上線活動設定：

   • 必須使用正確的套件識別碼為iOS應用程式設定設定。
   • 活動型別必須符合您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:

  • 所有廣播Live活動皆需要。
  • 作為此特定廣播執行個體的唯一識別碼。
  • 對象中的所有設定檔都會收到連結至此管道的已上線活動。
  • 必須符合liveActivityData.channelID中的channelID （請參閱步驟3）。
  • 您的團隊必須在Apple開發人員入口網站中為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傳訊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。 包含attributes （包含liveActivityData.channelID）僅適用於開始事件：

{
   "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。
• 欄位名稱會區分大小寫，且必須完全相符。
• 資料型別必須相符（字串、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的範例設定檔。

時間戳記和選擇性欄位：

• 對每個事件在Epoch秒內產生新的timestamp，並確保它嚴格大於相同主題的最後一個值。 系統會忽略較舊或相等的值。
• when可選擇設定通知的顯示時間（以epoch秒為單位）。 它無法控制訊息順序。
• 針對event_type: "end"，dismiss_after可選擇指定移除前已完成活動仍可見的秒數。 這是持續時間，而非紀元時間戳記。

如需完整API規格，請參閱Adobe Journey Optimizer傳訊API檔案。

1. 確認測試裝置使用FirebaseMessaging.getInstance().subscribeToTopic(topic)訂閱topic_name中指定的主題。
2. 確認訂閱是否成功，以及應用程式是否透過其已安裝的Adobe Live活動擴充功能支援的主題訂閱追蹤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. 在​ 事件 ​清單中，檢查可用的SDK和傳遞事件中是否有裝載處理錯誤。
4. 確認承載包含預期的fcm物件、topic_name和event_type值。
5. 檢閱行銷活動報告和可用的message.feedback個事件以確認FCM傳遞結果。 Android serviceProvider值為fcm。
6. 如果FCM接受訊息，但裝置未轉譯活動，請檢查主題訂閱、通知許可權、頻道設定和應用程式記錄。 提供者接受並不確認裝置轉譯。