일반적인 라이브 활동 문제 해결 시나리오 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에서 이벤트 목록을 열고 표준 푸시 토큰 등록 이벤트를 찾습니다.
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에서 Campaign​을(를) 열고 작업 메뉴로 이동합니다.
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 호출을 수행하는 시점의 현재 Unix Epoch 시간(초)으로 timestamp을(를) 설정합니다. 이는 모든 이벤트 유형(start, update 및 end)에 적용됩니다.
• 오래되거나 재사용된 타임스탬프로 인해 업데이트 및 종료 요청이 실패하거나 장치에서 무시됩니다. 이전 요청의 타임스탬프나 캐시된 값을 다시 사용하지 마십시오.

선택적 필드(모든 이벤트 유형):

• requestId: 추적에 대한 고유 식별자(권장).
• alert: 알림에 대해 title 및 body이(가) 있는 개체입니다. 업데이트에 주의를 기울이는 데 유용합니다.

정보 dismissal-date:

• 선택 사항입니다. Unix epoch 시간(초). 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 또는 유사한 식별자를 포함)
  • 구조의 모든 사용자 정의 필드

• 필드 이름을 정확히 일치시키십시오(대/소문자 구분).

• 데이터 유형(문자열, 정수, 부울, 중첩된 오브젝트)을 일치시킵니다.

• 중첩된 오브젝트 구조를 유지합니다.

일반적인 실수:

자세한 예제는 라이브 활동 페이지 만들기를 참조하세요.

Assurance을 사용하여 API 실행 및 페이로드 게재 확인:

1. Assurance 세션을 엽니다.

2. 라이브 활동을 트리거하기 위해 API 호출을 실행합니다.

3. 이벤트 목록​에서 다음을 확인하십시오.

   • 캠페인 실행 이벤트.
   • 라이브 활동 전달 이벤트.
   • 페이로드 유효성 검사 오류 이벤트

4. 이벤트 페이로드를 검토하여 다음을 확인합니다.

   • 페이로드가 올바르게 처리되었습니다.
   • 유효성 검사 오류가 발생하지 않았습니다.
   • 라이브 활동이 APNs로 전송되었습니다.

1. Journey Optimizer에서 Campaign​을(를) 열고 작업 메뉴로 이동합니다.
2. 라이브 활동 구성​을 확인하세요. 표면은 프로필의 pushNotificationDetails에 있는 appId과(와) 일치하는 패키지 이름으로 Android 앱을 대상으로 해야 합니다.
3. 표면에 해당 앱에 대한 FCM 자격 증명이 사용되는지 확인합니다. 프로필의 토큰 플랫폼은 "fcm"이어야 합니다.
4. 페이로드의 notification_channel_id이(가) 앱에서 만든 알림 채널과 일치하는지 확인하십시오.

context.requestPayload.fcm 아래에 Android Live 활동 필드를 배치하십시오.

단일 시작 페이로드:

{
   "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 Epoch 시간(초)으로 바꿉니다. content_state 키는 예이며 앱의 스타일 공급자와 일치해야 합니다.

브로드캐스트의 경우 audience.id과(와) 함께 API로 트리거된 마케팅 캠페인을 사용하고 fcm 개체를 context.requestPayload 아래에 배치하십시오. 대상 장치가 구독하는 FCM 항목으로 topic_name을(를) 설정합니다. 시작, 업데이트 및 종료 이벤트에서 주제와 notification_id을(를) 변경되지 않은 상태로 유지합니다. Android 브로드캐스트 페이로드 예제를 참조하십시오.

일반적인 페이로드 문제:

타임스탬프 및 주기 확인:

• 모든 시작, 업데이트 및 종료 이벤트에 대해 Epoch 초 단위의 새로운 timestamp을(를) 사용합니다. 요청이 같은 초 내에 이루어진 경우에도 동일한 notification_id(또는 브로드캐스트의 경우 topic_name)에 대한 이전 값보다 큰지 확인하십시오.
• 이전 또는 동일한 타임스탬프는 무시됩니다. 캐시된 타임스탬프를 재사용하지 마십시오.
• 선택적 when 필드는 메시지 순서 지정이 아니라 알림의 표시 시간을 제어합니다. 그것을 합리적으로 최신 상태로 유지하고 획기적인 초 단위로 표현한다.
• 활동을 업데이트하거나 종료하려면 notification_id을(를) 변경하지 않고 event_type을(를) 변경하십시오. Android은 세 라이프사이클 이벤트 모두에 대해 동일한 FCM 등록 토큰을 사용하므로 별도의 업데이트 토큰이 필요하지 않습니다.

이벤트 종료:

event_type: "end"의 경우 선택적으로 dismiss_after을(를) 제거하기 전에 완료된 라이브 활동이 계속 표시되는 시간(초)으로 설정합니다. epoch 타임스탬프가 아닌 기간입니다.

앱의 스타일 공급자는 라이브 활동 알림에서 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. 게재가 성공하지만 라이브 활동이 렌더링되지 않는 경우 장치에서 앱 로그, 스타일-공급자 매핑, 알림 권한 및 채널 구성을 검사합니다.

캠페인 보고서에 전송 오류가 표시되지 않는 경우 이 단계를 건너뜁니다. 그렇지 않으면 오류 이유 표의 오류를 다음 일반적인 APNs 오류와 일치시키십시오.

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 활동용 APNs여야 함
   errorCode	숫자 코드 또는 null	실패한 경우 APNs 관련 오류 코드
   errorMessage	오류 설명 또는 null	사람이 읽을 수 있는 오류 메시지

7. 경우 feedbackStatus: "error":

   • 특정 APNs 오류에 대해서는 errorCode 및 errorMessage을(를) 확인하십시오.
   • 일반적인 APNs 오류에는 만료된 토큰, 잘못된 인증서, 잘못된 번들 ID가 포함됩니다.

8. 피드백 이벤트가 없는 경우:

   • 푸시 알림이 시도되지 않았을 수 있습니다.
   • 프로필이 캠페인 보고서에서 제외되었는지 확인하십시오.

feedbackStatus이(가) sent인 경우: Journey Optimizer이 APNs에 알림을 전달했습니다. 장치 렌더링은 확인되지 않습니다. 4단계에서 디바이스 측 확인을 계속 진행합니다.

1. Assurance 세션을 열고 API 호출 동안 활성 상태로 유지합니다.

2. API 호출 실행(시작, 업데이트 또는 종료).

3. 이벤트 목록​에서 라이브 활동 전달 이벤트를 찾습니다.

4. APNs 푸시 게재와 관련된 이벤트를 검색합니다.

5. 다음 지표를 확인하십시오.

   • APNs에 대한 푸시 요청: Adobe이 Apple 서버로 푸시를 보냈는지 확인합니다.
   • APNs 응답: APNs가 푸시를 수락했는지 또는 거부했는지 여부를 표시합니다.
   • 게재 상태: 성공 또는 실패 표시

6. 문제가 발견되면 다음의 일반적인 APNs 전달 문제를 참조하십시오.

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   문제	Assurance의 증상	해결 방법
   APNs 인증서 만료됨	인증 오류	새 APNs 인증서 갱신 및 업로드
   잘못된 환경(개발 및 프로덕션)	토큰 불일치 오류	인증서가 앱 빌드 유형과 일치하는지 확인
   번들 ID 불일치	잘못된 번들 식별자	인증서 번들 ID가 앱과 일치하는지 확인
   토큰 만료됨	APNs에서 잘못된 토큰 오류	라이브 활동 토큰 재등록
   속도 제한	요청이 너무 많음	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. 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 호출의 타임스탬프
• 전송 통계, 오류 이유 및 제외된 이유를 보여주는 캠페인 보고서 스크린샷
• FCM 오류 코드 및 메시지를 포함한 관련 프로필 message.feedback 이벤트
• Assurance 세션 세부 정보 및 관련 이벤트 스크린샷
• 자격 증명 및 장치 토큰이 삭제된 API 요청 페이로드 및 응답
• Android 패키지 이름, Firebase 프로젝트 및 발신자 ID, FCM 자격 증명 구성 세부 정보. 개인 키를 포함하지 않음
• Android OS 버전, 장치 모델, 알림 권한 상태 및 관련 앱 로그

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:

  • 모든 브로드캐스트 라이브 활동에 필요합니다.
  • 이 특정 브로드캐스트 인스턴스의 고유 식별자 역할을 합니다.
  • 대상자의 모든 프로필은 이 채널에 연결된 라이브 활동을 수신합니다.
  • liveActivityData.channelID의 channelID과(와) 일치해야 합니다(3단계 참조).
  • 팀이 Apple 개발자 포털에서 appID에 대해 만들어야 합니다.
  • 특정 appID에 대해 만들어진 채널만 해당 앱에서 라이브 활동을 브로드캐스트하는 데 사용할 수 있습니다.

• audience.id:

  • Adobe Experience Platform에서 생성된 유효한 대상 세그먼트를 참조해야 합니다.
  • 이 대상자의 모든 프로필은 라이브 활동을 대상으로 합니다.
  • 대상자를 활성화해야 하며 올바른 liveActivityPushNotificationDetails의 프로필을 포함해야 합니다.

항상 최신 타임스탬프 사용:

• timestamp 필드는 모든 API 호출에 대해 항상 현재 Unix Epoch 시간(초)이어야 합니다.
• 이 요구 사항은 모든 이벤트 유형(start, update 및 end)에 적용됩니다.
• 업데이트/종료에 중요: 오래된 타임스탬프를 사용하면 업데이트 및 종료 요청이 실패합니다.
• 모든 브로드캐스트 API 호출에 대해 새 타임스탬프를 생성합니다.

선택적 필드:

• dismissal-date: 자동 해지를 위한 Unix epoch 시간(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을(를) 포함합니다. 시작 이벤트에만 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과(와) 일치해야 합니다.
• 필드 이름은 대소문자를 구분하며 정확히 일치해야 합니다.
• 데이터 유형은 일치해야 합니다(문자열, 정수, 부울, 중첩된 오브젝트 등).
• 업데이트/종료 이벤트의 경우 원래 시작 이벤트와 동일한 input-push-channel을(를) 사용합니다.

일반적인 실수:

Assurance을 사용하여 API 실행 및 페이로드 게재 확인:

1. 대상의 일부인 테스트 장치에서 Assurance 세션을 엽니다.

2. 브로드캐스트 API 호출을 실행합니다.

3. 이벤트 목록​에서 다음을 찾습니다.

   • 캠페인 실행 이벤트.
   • 라이브 활동 전달 이벤트.
   • 페이로드 유효성 검사 실패를 나타내는 오류 이벤트

4. 이벤트 페이로드를 검사하여 확인:

   • 페이로드가 올바르게 처리되었습니다.
   • input-push-channel이(가) 있습니다.
   • 유효성 검사 오류가 발생하지 않았습니다.
   • 라이브 활동이 대상 구성원을 위해 APNs로 전송되었습니다.

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 Epoch 시간(초)으로 바꿉니다. content_state 키를 앱의 스타일 공급자에 맞게 조정하십시오.

일반적인 페이로드 문제:

중요한 브로드캐스트 관련 필드:

• topic_name: 대상 장치가 구독한 FCM 주제를 식별합니다. 모든 시작, 업데이트 및 종료 요청에 비어 있지 않은 동일한 값을 포함합니다.
• audience.id: Adobe Experience Platform에서 캠페인 대상자를 식별합니다. 올바른 pushNotificationDetails에 대한 멤버 자격 및 샘플 프로필을 확인하십시오.

타임스탬프 및 옵션 필드:

• 모든 이벤트에 대해 epoch 초 단위의 새 timestamp을(를) 생성하고 동일한 주제에 대한 마지막 값보다 엄격하게 커야 합니다. 이전 값 또는 동일한 값은 무시됩니다.
• when은(는) 선택적으로 알림의 표시 시간을 epoch 초 단위로 설정합니다. 메시지 순서를 제어하지 않습니다.
• event_type: "end"의 경우 dismiss_after은(는) 선택적으로 제거 전에 완료된 활동이 표시되는 시간(초)을 지정합니다. epoch 타임스탬프가 아닌 기간입니다.

전체 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이 메시지를 허용하지만 장치가 활동을 렌더링하지 않는 경우 주제 구독, 알림 권한, 채널 구성 및 앱 로그를 검사합니다. 공급자 수락은 장치 렌더링을 확인하지 않습니다.