신호를 사용하여 오케스트레이션된 캠페인 트리거 trigger-signal

이 페이지에서: REST API 또는 다른 캠페인의 종료 활동에서 신호로 오케스트레이션된 캠페인을 트리거하는 방법과 타깃팅, 조건 및 표현식의 변수가 되는 페이로드 매개 변수를 전달하는 방법을 알아봅니다.

고정된 일정 대신 신호로 오케스트레이션된 캠페인을 시작할 수 있습니다. 캠페인이 신호를 받으면 실행되며 페이로드에 매개 변수를 전달할 수 있습니다. 타겟팅, 조건 또는 표현식에 변수로 사용할 수 있습니다.

신호는 다음 중 하나에서 올 수 있습니다.

이 페이지에서는 신호(일정, 매개 변수, 테스트, 게시)를 수신하는 캠페인을 설정하는 방법과 API 또는 종료 활동에서 실행하는 방법에 대해 설명합니다. 변수를 사용할 수 있게 되면 규칙 및 테스트 조건에 변수를 사용하는 방법에 대한 자세한 내용은 오케스트레이션된 캠페인에서 변수 사용을 참조하세요.

트리거 끝점(경로, 헤더, 본문, 응답 및 오류)에 대한 전체 REST 사양은 Adobe Journey Optimizer API 설명서의 오케스트레이션된 캠페인 API 트리거를 참조하십시오.

신호를 사용하여 오케스트레이션된 캠페인을 트리거하는 엔드투엔드 프로세스:

NOTE
신호를 사용하여 오케스트레이션된 캠페인을 트리거하려면 Publish orchestrated campaigns 권한(orchestrated-campaign.publish)이 필요합니다. 기본 제공 권한을 참조하세요.

신호에 의해 트리거될 캠페인 예약 configure-signal

일정 대신 신호에서 시작하도록 오케스트레이션된 캠페인을 설정하려면 다음 단계를 수행합니다.

  1. 신호를 사용하여 트리거할 오케스트레이션된 캠페인을 엽니다.

  2. 예약 구성을 엽니다. 오케스트레이션된 캠페인을 예약하는 방법을 알아보세요.

  3. 캠페인이 일정에 따라 실행되지 않고 신호를 대기하도록 신호에 의해 트리거됨​을(를) 선택하십시오.

    신호 옵션으로 트리거된 예약 메뉴 {modal="regular"}

신호 페이로드에 대한 매개 변수 추가(선택 사항) parameters

트리거 신호에서 매개 변수를 전달하고 실행 컨텍스트(예: 타깃팅, 조건 또는 표현식)의 캠페인에서 사용할 수 있습니다. 먼저 일정 설정에서 각 매개 변수를 정의한 다음, 트리거 API를 호출하거나 업스트림 캠페인의 종료 활동에서 매개 변수를 매핑할 때 해당 값을 전달합니다(아래 참조).

  1. 캠페인 일정을 열고 매개 변수 추가​를 선택합니다.

  2. 신호 페이로드에서 전송할 각 매개 변수의 이름과 데이터 형식을 정의합니다. 테스트 모드에서 캠페인을 트리거할 때 사용할 테스트 값​을 제공할 수도 있습니다. 트리거된 캠페인을 테스트하는 방법을 알아봅니다.

    매개 변수를 추가하여 신호의 페이로드 매개 변수를 정의합니다 {modal="regular"}

NOTE
REST API에 의해 트리거된 오케스트레이션된 캠페인의 경우 스케줄러에 정의되지 않은 API 호출에서 매개 변수를 전달하면 API 호출이 계속 성공하고 매개 변수가 전파되므로 표현식에 사용할 수 있습니다. 하지만 오케스트레이션된 캠페인 인터페이스는 이 인터페이스를 사용하는 데 도움이 되지 않습니다. 예를 들어 테스트 활동에서는 스케줄러에 정의되지 않은 매개 변수를 나열하거나 표시하지 않습니다.

캠페인 테스트 build-and-test

캔버스에서 캠페인을 빌드한 다음 REST API를 통해 신호를 전송하여 게시하기 전에 초안​에서 테스트하십시오.

  • REST API에 의해 트리거된 오케스트레이션된 캠페인 - 아래 단계를 사용하여 초안에서 캠페인을 실행하고 게시 전에 타깃팅, 매개 변수 및 게재 논리의 유효성을 검사합니다.

  • 종료 활동으로 트리거된 오케스트레이션된 캠페인 — 전체 체인을 초안에서 처음부터 끝까지 실행할 수 없습니다. 업스트림 캠페인이 게시되면 해당 종료 활동은 게시된 다운스트림 캠페인만 시작합니다. 두 캠페인이 게시되기 전에 다운스트림 측면을 테스트하려면 해당 캠페인을 초안​에 보관하고, 스케줄러에서 신호 매개 변수에 대해 테스트 값​을 설정(신호 페이로드에 대한 매개 변수 추가)한 다음 아래 API 단계를 따르십시오. 트리거 API 호출은 런타임에 End 활동과 동일한 페이로드를 사용하므로 다운스트림 캠페인을 게시하고 업스트림 End 활동(다른 캠페인의 종료 활동에서 트리거)을 구성하기 전에 매개 변수 라우팅 및 캔버스 논리를 확인할 수 있습니다.

  1. 캔버스에서 활동(대상, 타기팅, 게재)을 추가하고 연결합니다. 캠페인 활동을 조율하는 방법 알아보기

  2. 신호에서 매개 변수를 정의한 경우 이를 캔버스 논리(예: 조건 또는 타깃팅)에 연결할 수 있습니다. 이 예제에서는 “channel” 매개 변수가 Test 활동의 조건으로 사용됩니다.

    테스트 활동에서 조건으로 사용되는 채널 매개 변수

    표현식 편집기에서 신호 매개 변수를 사용하려면(예: 대상 작성 활동에서 쿼리를 작성하려면) 표현식 필드에 $(vars/@<parameterName>)을(를) 입력하십시오. <parameterName>을(를) 스케줄러에 정의된 매개 변수 이름(예: $(vars/@channel))으로 바꾸십시오. 식 편집기로 작업하는 방법을 알아봅니다.

  3. 캠페인 스케줄러를 열고 API 요청 복사​를 선택하고 형식(cURL 또는 HTTP 요청)을 선택합니다.

    복사된 정보에는 오케스트레이션된 캠페인 ID, 샌드박스 이름, 조직 ID 및 일부를 추가한 경우 매개변수에 대한 테스트 값이 포함됩니다.

    예약 구성의 API 요청 옵션 복사

    accordion
    매개 변수 및 테스트 값이 있는 샘플 cURL 요청
    code language-bash
    POST https://platform.adobe.io/ajo/campaign-orchestration/orchestratedCampaigns/1c7529c7-7a8c-491a-a2c6-3d8131d2e17d/trigger
    
    Headers:
    Authorization: Bearer ## Access token ##
    Content-Type: application/json
    x-api-key: ## Provide API Key here ##
    x-api-version: 1
    x-gw-ims-org-id: 123456ABCDEFG@LumaOrg
    x-sandbox-name: prod
    
    Body:
    {
    "variables": {
       "channel": "sms"
    }
    }
    
  4. 캠페인을 시작하려면 시작​을 클릭하세요.

  5. 스케줄러에서 복사한 샘플 요청을 사용하여 트리거 API 호출을 보냅니다. 요청 및 응답 세부 정보는 오케스트레이션된 캠페인 API 트리거를 참조하십시오.

테스트 결과가 만족스러우면 캠페인을 게시하십시오.

캠페인 게시 및 트리거 publish

캠페인을 테스트한 후 게시하면 응용 프로그램이나 다른 캠페인의 종료 활동에서 신호를 받을 수 있습니다. 캠페인 시작 및 모니터링에 대해 자세히 알아보세요.

그런 다음 REST API 또는 다른 캠페인의 End 활동에서 트리거할 수 있습니다. 아래 섹션을 참조하십시오.

REST API를 사용하여 신호 보내기 publish-api

게시 후 자체 애플리케이션에서 캠페인을 트리거할 때마다 다음 단계를 따르십시오.

  1. 캠페인 스케줄러를 열고 API 요청 복사​를 선택하고 형식(cURL 또는 HTTP 요청)을 선택합니다.

    복사된 정보에는 오케스트레이션된 캠페인 ID, 샌드박스 이름, 조직 ID 및 일부를 추가한 경우 매개 변수가 포함됩니다.

    예약 구성에서 API 요청 복사

  2. 시스템에서 트리거 API를 호출합니다. 라이브 끝점 사양에 대해서는 오케스트레이션된 캠페인 API 트리거를 참조하십시오.

    note important
    IMPORTANT
    실시간 오케스트레이션된 캠페인의 경우 스로틀 가드레일은 두 API 트리거 실행 사이에 최소 1시간 간격을 적용합니다. 해당 간격이 경과하기 전에 API를 다시 호출하는 경우 API가 HTTP 429(요청이 너무 많음)를 반환합니다. 이 가드레일은 초안 버전을 테스트하도록 트리거할 때 적용되지 않습니다.

    신호 페이로드에 매개 변수를 추가한 경우 API 호출에 전달하는 값은 캠페인이 실행될 때 캠페인 이벤트 변수로 노출됩니다. 이를 검사하려면 캠페인 캔버스 도구 모음에서 캠페인 로그를 엽니다. 작업 탭에서 신호에 해당하는 작업을 식별하고 연필 아이콘을 클릭하여 관련 이벤트 변수에 액세스합니다. 로그 및 작업에 액세스하는 방법을 알아봅니다.

    캠페인 이벤트 변수를 사용할 수 있는 로그 및 작업 화면 {modal="regular"}

다른 캠페인의 종료 활동에서 신호 보내기 signal-end

이 경로를 사용하여 오케스트레이션된 캠페인을 연결합니다. 업스트림 캠페인이 분기를 완료하면 End 활동이 이미 신호에 의해 트리거됨(으)로 설정된 다운스트림 캠페인으로 신호를 보냅니다. 이를 통해 더 작은 캠페인을 재사용하고 각 호출자의 다른 페이로드를 전달할 수 있습니다.

NOTE
  • 동일한 캔버스에서 여러 End 활동을 사용하고 각 활동을 구성하여 다른 다운스트림 캠페인을 트리거할 수 있습니다.
  • 여러 캠페인이 동일한 다운스트림 캠페인을 트리거할 수 있습니다. 각 호출은 다른 페이로드를 전송할 수 있습니다.

먼저 실행해야 하는 캠페인에 대해 다음 단계를 수행합니다.

  1. 신호를 보내야 하는 오케스트레이션된 캠페인을 열고 다운스트림 캠페인이 시작되기 전에 완료해야 하는 분기의 끝에서 End 활동을 선택합니다.

  2. 외부 신호 섹션에서 트리거할 다운스트림 캠페인을 선택하십시오.

  3. 필요한 경우 매개 변수를 추가합니다. 다운스트림 캠페인의 일정과 동일한 이름을 사용하고 각 값을 설정합니다.

  4. 게시하기 전에 초안 모드에서 다운스트림 캠페인을 테스트하려면 캠페인 테스트 섹션의 단계에 따라 REST API로 초안에서 트리거하십시오.

다운스트림 캠페인은 라이브여야 End 활동에서 이를 참조하는 업스트림 캠페인을 게시할 수 있습니다. 대상 캠페인이 게시되지 않은 상태에서 신호를 보내면 실행이 실패합니다. 다운스트림 캠페인을 게시한 다음 필요에 따라 다시 시작하거나 재개합니다.

AI Knowledge Reference

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 explains how to trigger an Orchestrated campaign with a signal from the REST API or from another campaign’s End activity, and how to pass payload parameters that become variables for targeting, conditions, and expressions.

Intents:

  • Schedule an Orchestrated campaign to start on a signal instead of a fixed schedule.
  • Define parameters for the signal payload, with test values for use in test mode.
  • Build and test the campaign in Draft before publishing, including copying a sample API request.
  • Publish the campaign and trigger it from the REST API.
  • Chain campaigns by configuring an End activity to send a signal to a downstream campaign.
  • Inspect campaign event variables passed in a trigger signal from the campaign logs.

Glossary:

  • Triggered by a signal: the schedule option that makes a campaign wait for a signal instead of running on a schedule (product-specific)
  • End activity: the campaign activity, placed at the end of a branch, that can send a signal to a downstream campaign through its External signal section (product-specific)
  • External signal: the section of the End activity where the downstream campaign to trigger is selected (product-specific)
  • Test values: values defined for signal parameters in the scheduler, used when the campaign is triggered in test mode (product-specific)
  • Copy API request: the scheduler option that copies the orchestrated campaign ID, sandbox name, organization ID, and parameter values, in cURL or HTTP Request format (product-specific)

Guardrails:

  • To trigger an Orchestrated campaign using a signal, you need the Publish orchestrated campaigns permission (orchestrated-campaign.publish).
  • For a live orchestrated campaign, a throttle guardrail enforces a minimum interval of one hour between two API trigger executions (hard limit); calling the API again before that interval has elapsed returns HTTP 429 (Too many requests). This guardrail is not applied when you trigger a draft version to test it.
  • For Orchestrated campaigns triggered by the REST API, if you pass a parameter in the API call that has not been defined in the scheduler, the API call still succeeds and the parameter is propagated and can be used in expressions; however, the orchestrated campaign interface will not help you use it — for example, the Test activity will not list or show parameters that were not defined in the scheduler.
  • You cannot run the full chain end-to-end in draft for campaigns triggered by an End activity: once the upstream campaign is published, its End activity only starts a published downstream campaign.
  • The downstream campaign must be live before you can publish the upstream campaign that references it in an End activity; if the signal is sent while the target campaign is not published, execution will fail.
  • You can use several End activities on the same canvas, each configured to trigger a different downstream campaign.
  • Several campaigns can trigger the same downstream campaign, and each call can send a different payload.

Terminology:

  • Canonical name: Triggered by a signal — variant: signal.
  • Do not confuse: “End activity” signal (sent at runtime to a published downstream campaign) ≠ REST API trigger call used to test a draft downstream campaign before both campaigns are published.

FAQ:

  • Q: How do I make a campaign start from a signal instead of a schedule? — Open the schedule configuration and select Triggered by a signal.
  • Q: Where do I define parameters for the signal payload? — In the campaign scheduler, using Add parameter, where you can also set Test values for test mode.
  • Q: What happens if I pass a parameter in the API call that was not defined in the scheduler? — The API call still succeeds and the parameter is propagated for use in expressions, but the Test activity will not list or show it.
  • Q: How often can I call the trigger API for a live campaign? — A throttle guardrail enforces a minimum interval of one hour between two API trigger executions; calling again sooner returns HTTP 429 (Too many requests). This guardrail does not apply when triggering a draft version to test it.
  • Q: Can I test the full chain from an upstream End activity to a downstream campaign before publishing both? — No; once published, an End activity only starts a published downstream campaign. To test the downstream side first, keep it in Draft, set Test values for its signal parameters, and trigger it directly with the REST API using the same payload the End activity would send.
  • Q: What must be true of the downstream campaign before I publish the upstream campaign’s End activity that references it? — The downstream campaign must be live; if the signal is sent while it is not published, execution will fail.

Personas:

  • developer: Can trigger a published Orchestrated campaign by calling the trigger API, and pass parameters in the payload that become variables for targeting, conditions, and expressions. Can copy a sample cURL or HTTP Request from the campaign scheduler, including the campaign ID, sandbox name, organization ID, and parameter values. The page states that a throttle guardrail enforces a minimum one-hour interval between two API trigger executions for a live campaign. Where: “Send the signal with the REST API”.

Onboarding:

  • Level: Intermediate
  • First minimal step: Open the schedule configuration and select Triggered by a signal.
  • Success check: In the Tasks tab of the campaign logs, you can access the event variables passed in the trigger signal.
  • Previous: Opening the schedule configuration to set up the Orchestrated campaign: Create and schedule Orchestrated campaigns with Journey Optimizer (orchestrated/create-orchestrated-campaign.md); Adding and connecting activities on the campaign canvas: Create Orchestrated campaigns with Adobe Journey Optimizer (orchestrated/orchestrate-activities.md)
  • Next: Using signal parameters as variables in targeting, conditions, or expressions: Use variables in Orchestrated campaigns (orchestrated/variables-orchestrated-campaigns.md); Publishing and monitoring the campaign after testing it: Start and monitor Orchestrated campaigns with Adobe Journey Optimizer (orchestrated/start-monitor-campaigns.md)
recommendation-more-help
journey-optimizer-help