설명서Journey OptimizerJourney Optimizer 안내서

라이브 활동 만들기 create-mobile-live

마지막 업데이트: 2026년 9월 7일

작성 대상:

  • 초보자
  • 사용자

이 페이지에서: 개별 사용자 또는 대상의 라이브 활동을 원격으로 시작, 업데이트 및 종료할 수 있도록 Journey Optimizer에서 API 트리거 캠페인을 빌드합니다.

style
shade-box

모바일 구성을 구성하고 Adobe Experience Platform mobile SDK을 구현한 후 Journey Optimizer에서 라이브 활동을 만들 수 있습니다.

  1. 캠페인 메뉴에 액세스한 다음 캠페인 만들기​를 클릭합니다.

  2. API 트리거됨 캠페인 유형을 선택하십시오.

    • 대상자 기반 캠페인에 대해 API 트리거 마케팅 선택

    • 개별 캠페인에 대해 API 트리거 트랜잭션​을(를) 선택하십시오.

    note important
    IMPORTANT
    API 트리거 트랜잭션​의 경우 높은 처리량 옵션을 사용할 수 없습니다.

  3. 속성 섹션에서 Campaign의 제목 및 설명​을(를) 편집합니다.

  4. 작업 섹션에서 라이브 활동​을 선택하고 새 구성을 선택하거나 만드십시오.

    이 페이지에서 실시간 활동 구성에 대해 자세히 알아보세요.

  5. 콘텐츠 실험 구성을 시작하고 처리를 만들어 성능을 측정하고 대상 대상에 가장 적합한 옵션을 식별하려면 실험 만들기​를 클릭하십시오. 자세히 알아보기

  6. 대상자 탭에서 ID 유형​을 선택합니다. 자세히 알아보기.

    note
    NOTE
    API 트리거 마케팅 캠페인의 경우 API 페이로드에서 APNs channelID 구독을 확인하기 전에 첫 번째 세그먼테이션으로 작동하는 기존 대상을 선택할 수 있습니다.

  7. 캠페인은 특정 날짜 또는 되풀이되는 빈도로 실행되도록 디자인됩니다. 이 섹션에서 캠페인의 일정​을 구성하는 방법을 알아보세요.

  8. 구성이 완료되면 활성화 검토​를 클릭한 다음 활성화​를 클릭합니다.

  9. 캠페인이 활성화되면 제공된 cURL 요청​을(를) 템플릿으로 사용하여 라이브 활동 시작, 업데이트 또는 종료 이벤트를 트리거합니다. 실행 전에 특정 데이터로 샘플 페이로드를 업데이트합니다.

    페이로드에 포함할 캠페인 ID 식별자도 복사하십시오.

    ➡️ OAuth 토큰 및 API 키를 포함한 인증 요구 사항은 API 트리거된 캠페인 설명서를 참조하십시오.

    accordion
    단일 사용 사례에 대한 페이로드의 예(API 트리거 트랜잭션 캠페인)

    이 페이로드 예는 API 트리거 트랜잭션 캠페인 유형을 사용하는 개별 캠페인에 대한 것입니다. 다음 페이로드 예제의 필드 대부분은 필수이므로 requestId, dismissal-date 및 alert만 선택 사항입니다.

    code language-json 
    {
    "requestId": "your-request-id",
    "campaignId": "your-campaign-id",
    "recipients": [
{
    "type": "aep",
    "userId": "testemail@gmail.com",
    "namespace": "email",
    "context": {
     "requestPayload": {
    "aps": {
    "content-available": 1,
    "timestamp": 1756984054,              // current epoch time
    "dismissal-date": 1756984084,         // optional – auto remove when event="end"
    "event": "update",                    // start | update | end

    // Fields from FoodDeliveryLiveActivityAttributes
    "content-state": {
      "orderStatus": "Delivered"
    },

    "attributes-type": "FoodDeliveryLiveActivityAttributes",
    "attributes": {
      "restaurantName": "Pizza",
      "liveActivityData": {
        "liveActivityID": "orderId1"       // customer reference ID
      }
    },

    "alert": {
      "title": "Order Delivered!",
      "body": "Your pizza has arrived."
    }
  }
}
}
}
]
}
    accordion
    브로드캐스트 사용 사례(API 트리거 마케팅 캠페인)에 대한 페이로드의 예

    이 페이로드 예제는 API 트리거 마케팅 캠페인 유형을 사용하는 대상자 기반 캠페인에 대한 것입니다.

    code language-json 
    {
    "requestId": "123400000",
    "campaignId": "d32e6f6c-56df-4a98-a2c0-6db6008f8f32",
    "audience": {
        "id": "508f9416-52d0-4898-ba47-08baaa22e9c7"
    },
    "context": {
        "requestPayload": {
            "aps": {
                "input-push-channel": "V+8UslywEfAAAOq9SbTrLg==",  //apns-channel-id
                "content-available": 1,
                "timestamp": 1770808339,
                "event": "update",   // start | update | end

                // Fields from GameScoreLiveActivityAttributes
                "content-state": {
                    "homeTeamScore": 33,
                    "awayTeamScore": 49,
                    "statusText": "Wingdom keeps scoring!"
                },
                "attributes-type": "GameScoreLiveActivityAttributes",
                "attributes": {
                    "liveActivityData": {
                        "channelID": "V+8UslywEfAAAOq9SbTrLg=="   //apns-channel-id, must match the "input-push-channel" value
                    }
                },
                "alert": {
                    "title": "This is the title for game",
                    "body": "This is the body for body"
                }
            }
        }
    }
}

라이브 활동을 디자인한 후 기본 제공 보고서를 통해 라이브 활동의 영향을 측정하는 방법을 추적할 수 있습니다.

TIP
라이브 활동이 예상대로 나타나거나 업데이트되지 않으면 라이브 활동 문제 해결에서 단계별 디버깅 지침을 참조하십시오.

실행 메타데이터로 사용자 지정 데이터 추가 metadata

AVAILABILITY
executionMetadata은(는) API 트리거 트랜잭션 캠페인에만 사용할 수 있습니다.

선택적 executionMetadata 필드를 사용하여 주문 ID, 충성도 계층 또는 지역 코드와 같은 프로필에 자신의 사용자 지정 데이터​를 첨부하십시오. Journey Optimizer은 실행과 함께 이 데이터를 저장하므로 나중에 라이브 활동 피드백 데이터 세트​에서 검색하고 게재 결과를 비즈니스 레코드에 일치시킬 수 있습니다.

API를 통해 이 데이터를 보내려면 executionMetadata 필드에 대한 메시징 API 참조를 참조하십시오. 장치에서 값을 다시 읽으려면 API 트리거에서 실행 메타데이터를 받는 방법에 대한 Mobile SDK 안내서를 참조하십시오.

실행 메타데이터로 사용자 지정 데이터를 추가하려면:

  • userId 및 namespace 옆의 프로필에 executionMetadata을(를) 추가합니다. 문자열 키와 문자열 값만 허용됩니다. 문자열을 보내지 않고 모든 비문자열 값을 문자열로 변환하십시오.

  • 값은 전송된 그대로 기록됩니다. executionMetadata은(는) 개인화 식을 지원하지 않으므로 {{...}} 식은 확인되지 않고 리터럴 텍스트로 처리됩니다. 항상 최종 리터럴 값을 전송해야 합니다.

  • 각 프로필은 최대 50개의 키/값 쌍​을 전달할 수 있으며, 모든 키 및 값에 대해 결합된 크기 제한은 2KB​입니다. 이 제한을 초과하는 메타데이터는 삭제되지만 라이브 활동은 계속 전달됩니다. 페이로드를 보고 목적에 필요한 정보로 제한합니다.

JSON 예

이 예제에서 orderId, tier, restaurant 및 region은(는) 고유한 값입니다. 라이브 활동이 트리거되면 피드백 데이터 세트에서 다시 읽어 게재를 주문 레코드에 연결할 수 있습니다.

code language-json 
{
    "requestId": "your-request-id",
    "campaignId": "your-campaign-id",
    "recipients": [
        {
            "type": "aep",
            "userId": "testemail@gmail.com",
            "namespace": "email",
            "executionMetadata": {
                "orderId": "A-123",
                "tier": "gold",
                "restaurant": "PizzaPlace",
                "region": "EU"
            },
            "context": {
                "requestPayload": {
                    "aps": {
                        "content-available": 1,
                        "timestamp": 1756984054,
                        "dismissal-date": 1756984084,
                        "event": "update",
                        "content-state": {
                            "orderStatus": "Delivered"
                        },
                        "attributes-type": "FoodDeliveryLiveActivityAttributes",
                        "attributes": {
                            "restaurantName": "PizzaPlace",
                            "liveActivityData": {
                                "liveActivityID": "orderId1"
                            }
                        },
                        "alert": {
                            "title": "Order Delivered!",
                            "body": "Your pizza has arrived."
                        }
                    }
                }
            }
        }
    ]
}

사용 방법 비디오

Adobe Journey Optimizer로 iOS 라이브 활동을 구성하여 iPhone 잠금 화면 및 Dynamic Island에서 다양한 실시간 업데이트를 제공하는 방법에 대해 알아봅니다.

https://video.tv.adobe.com/v/3479871?captions=kor&learn=on
recommendation-more-help
journey-optimizer-help