오케스트레이션된 캠페인에서 변수 사용 variables-oc

이 페이지에서: 신호 또는 전역 정의에서 변수를 설정하고 이를 사용하여 오케스트레이션된 캠페인에서 타깃팅, 조건 및 테스트 활동 논리를 추진하는 방법을 알아봅니다.

변수를 설정하는 방법 set

오케스트레이션된 캠페인에서는 타깃팅을 유도하는 변수, 테스트 조건 및 기타 캔버스 논리를 사용하여 작업할 수 있습니다. 이러한 값은 다음 두 위치에서 제공될 수 있습니다.

NOTE
지금은 변수에서 text 값만 지원합니다.
변수는 캔버스 논리(규칙, 조건)을 구동하며 메시지 개인화에 사용할 수 없습니다.

캔버스에서 변수 사용 use

변수는 캔버스의 다음 위치에서 사용할 수 있습니다.

  • 규칙 빌더 — 규칙에 대한 표현식 편집기를 열고 이벤트 변수 선택기를 사용하여 변수를 선택하고 해당 참조를 표현식에 삽입합니다. 표현식을 편집하는 방법 알아보기

    아래 예에서는 이름이 brand인 변수가 전달되었으며 규칙이 이 변수를 필터 조건으로 사용합니다.

    이벤트 변수의 브랜드 변수를 사용하는 규칙 빌더 조건 {modal="regular"}

  • 테스트 활동 — 조건을 정의할 때 조건 유형 드롭다운에 모집단 수​와(과) 함께 범위의 모든 변수가 나열됩니다. 테스트 분기의 기반으로 사용할 변수를 선택하십시오. 테스트 활동을 구성하는 방법을 알아봅니다

    아래 예제에서는 channel 변수를 사용하여 해당 값에 따라 흐름을 다른 전환으로 라우팅합니다.

    채널 변수를 나열하는 테스트 활동 조건 유형 드롭다운 {modal="regular"}

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 set variables from a signal or from global definitions in an Orchestrated campaign, and how to use them to drive targeting, conditions, and Test activity logic on the canvas.

Intents:

  • Understand the two sources of variables in an Orchestrated campaign: signal parameters and global variables.
  • Pass parameters through a signal so they become variables for that triggered run.
  • Define global variables directly on the campaign using the Edit variables menu.
  • Insert a variable reference into a rule builder expression using the event variables picker.
  • Use a variable as the condition type for a Test activity branch.

Glossary:

  • Variable: a value that drives targeting, Test conditions, and other canvas logic in an Orchestrated campaign (product-specific)
  • Signal: the source of variables when the campaign schedule is set to Triggered by a signal; parameters passed when firing the campaign become variables for that run (product-specific)
  • Global variables: name–value pairs defined directly on the campaign using the Edit variables menu, requiring no API or signal (product-specific)
  • Event variables: the picker in the rule builder’s expression editor used to select a variable and insert its reference into an expression (product-specific)
  • Condition type: the drop-down in the Test activity that lists all variables in scope alongside Population count, used to select a variable as the basis for a test branch (product-specific)

Guardrails:

  • Variables support text values only.
  • Variables drive canvas logic (rules, conditions) and cannot be used for message personalization.

Terminology:

  • Canonical name: variable
  • Do not confuse: “Global variables” (defined directly on the campaign via the Edit variables menu) ≠ “signal” parameters (passed when firing a triggered campaign, becoming variables for that run).
  • Do not confuse: “event variables” (the picker in the rule builder used to select a variable) ≠ “variable” (the value itself that the picker lets you select).

FAQ:

  • Q: Where can variables in an Orchestrated campaign come from? — From a signal (parameters passed when firing a triggered campaign) or from global variables (name–value pairs defined directly on the campaign via the Edit variables menu).
  • Q: Do I need an API or a signal to define global variables? — No, global variables are defined directly on the campaign using the Edit variables menu, with no API or signal required.
  • Q: What type of values do variables support? — Text values only.
  • Q: Can variables be used for message personalization? — No, variables drive canvas logic such as rules and conditions, and cannot be used for message personalization.
  • Q: How do I insert a variable into a rule builder expression? — Open the expression editor for a rule and use the event variables picker to select a variable and insert its reference.
  • Q: How do I use a variable in a Test activity? — In the condition type drop-down, select a variable (listed alongside Population count) to use it as the basis for a test branch.

Related pages:

  • To trigger an Orchestrated campaign using a signal and pass parameters that become variables: Learn how to trigger an Orchestrated campaign using a signal (orchestrated/trigger-orchestrated-campaign.md)
  • To define global variables directly on the campaign: Learn how to define global variables in Orchestrated campaigns (orchestrated/global-variables.md)
  • To use the event variables picker and insert a variable reference into a rule expression: Learn how to edit expressions (orchestrated/edit-expressions.md)
  • To use a variable as the condition type in a Test activity: Learn how to configure the Test activity (orchestrated/activities/test.md)

Personas:

  • marketer: Can set variables from a signal passed when firing a triggered campaign, or from global variables defined on the campaign using the Edit variables menu. Can insert a variable reference into a rule builder expression using the event variables picker. Can select a variable in the Test activity Condition type drop-down to use it as the basis for a test branch. Where: “Use variables in the canvas”.

Onboarding:

  • Level: Intermediate
  • First minimal step: Set the campaign schedule to Triggered by a signal and pass parameters, or define global variables on the campaign using the Edit variables menu.
  • Success check: The variable is listed in the event variables picker or in the Test activity Condition type drop-down, available for use in the canvas.
  • Next: To pass parameters through a signal so they become variables for a triggered run: Trigger an Orchestrated campaign using a signal (orchestrated/trigger-orchestrated-campaign.md); To define global variables directly on the campaign using the Edit variables menu: Define global variables in Orchestrated campaigns (orchestrated/global-variables.md)
recommendation-more-help
journey-optimizer-help