설명서 Journey Optimizer Journey Optimizer 안내서

표현식 조각 활용 use-expression-fragments

마지막 업데이트: 2026년 5월 28일

주제:
{"id":"fda7be7c-b81e-42c0-95a9-616e5b893c03"}

작성 대상:

{"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

이 페이지에서: 개인화 편집기에서 식 조각을 삽입 및 재사용하고, 암시적 변수를 사용하여 작업하고, 루프 내에서 조각을 사용하고, 편집 가능한 필드를 사용자 지정하고, Adobe Journey Optimizer에서 상속을 중단하는 방법에 대해 알아봅니다.

style

shade-box

개인화 편집기를 사용하는 경우 현재 샌드박스에 만들거나 저장한 모든 표현식 조각을 활용할 수 있습니다.

조각은 Journey Optimizer 캠페인 및 여정에서 참조할 수 있는 재사용 가능한 구성 요소입니다. 이 기능을 사용하면 마케팅 사용자가 개선된 디자인 프로세스에서 콘텐츠를 빠르게 조합하는 데 사용할 수 있는 여러 사용자 지정 콘텐츠 블록을 미리 빌드할 수 있습니다. 조각에 대해 자세히 알아보기

➡️ 이 비디오에서 조각을 관리, 작성 및 사용하는 방법을 알아봅니다.

표현식 조각 사용 use-expression-fragment

콘텐츠에 표현식 조각을 추가하려면 아래 단계를 수행합니다.

NOTE

주어진 게재에서 최대 30개의 조각을 추가할 수 있습니다. 조각은 최대 1개 수준까지만 중첩할 수 있습니다.

개인화 편집기를 열고 왼쪽 창에서 조각 단추를 선택합니다.

목록에는 현재 샌드박스에서 조각으로 생성되거나 저장된 모든 표현식 조각이 표시됩니다. 조각을 만드는 방법 알아보기
만든 날짜별로 정렬됩니다. 최근에 추가된 표현식 조각이 목록에 먼저 표시됩니다.

이 목록을 새로 고칠 수도 있습니다.

note
NOTE
콘텐츠를 편집하는 동안 일부 조각이 수정되거나 추가된 경우 목록이 최신 변경 내용으로 업데이트됩니다.

표현식 조각 옆에 있는 + 아이콘을 클릭하여 해당 조각 ID를 편집기에 삽입합니다.

note caution
CAUTION
콘텐츠에 초안 또는 라이브 조각을 추가할 수 있습니다. 그러나 초안 상태의 조각을 사용 중인 경우에는 여정 또는 캠페인을 활성화할 수 없습니다. 여정 또는 캠페인 게시 시 초안 조각에 오류가 표시되며 이를 승인해야 게시할 수 있습니다.

조각 ID가 추가되면 해당 식 조각을 열고 인터페이스에서 편집하면 변경 내용이 동기화됩니다. 해당 조각 ID를 포함하는 모든 초안 또는 라이브 여정/캠페인에 자동으로 전파됩니다.
조각 옆에 있는 추가 작업 단추를 클릭합니다. 화면에 표시되는 메뉴에서 조각 보기를 선택하여 해당 조각에 대한 자세한 정보를 확인합니다. 조각 ID도 표시되며 여기에서 복사할 수 있습니다.
상황별 메뉴에서 조각 열기 옵션을 사용하거나 조각 정보 창에서 해당 콘텐츠 및 속성을 편집할 수 있습니다. 조각을 편집하는 방법을 알아보세요
그런 다음 개인화 편집기의 모든 개인화 및 작성 기능을 사용하여 평소와 같이 콘텐츠를 사용자 지정하고 유효성을 검사할 수 있습니다.

일부 경우에는 변수만 계산하면 되므로 표현식 조각의 콘텐츠를 숨길 수 있습니다. 이렇게 하려면 render 특성을 사용하고 false(으)로 설정합니다. 예:

code language-none
`Hi {{profile.person.name.firstName\|fragment id='ajo:fragmentId/variantId' mode ='inline' render=false}}`

NOTE

여러 줄 바꿈이 포함된 식 조각을 만들어 SMS 또는 푸시 콘텐츠에서 사용하면 줄 바꿈이 유지됩니다. 따라서 메시지를 보내기 전에 SMS 또는 푸시 메시지를 테스트하십시오.

암시적 변수 사용 implicit-variables

암시적 변수는 기존 조각 기능을 향상시켜 콘텐츠 재사용 가능성 및 스크립팅 사용 사례의 효율성을 개선합니다. 조각은 입력 변수를 사용하고 캠페인 및 여정 콘텐츠에 사용할 수 있는 출력 변수를 만들 수 있습니다.

예를 들어 이 기능은 현재 캠페인 또는 여정을 기반으로 이메일의 추적 매개 변수를 초기화하고 이러한 매개 변수를 이메일 콘텐츠에 추가된 개인화된 링크에 사용하는 데 사용할 수 있습니다.

다음과 같은 사용 사례가 가능합니다.

조각에 입력 변수를 사용합니다.

조각이 캠페인/여정 작업 컨텐츠에서 사용되는 경우 조각 외부에 선언된 변수를 활용할 수 있습니다. 아래는 한 예입니다.

캠페인 콘텐츠에서 선언된 utm_content 변수 위에 있는 것을 볼 수 있습니다. Hero 블록 조각을 사용하면 utm_content 매개 변수 값을 추가할 링크가 표시됩니다. 최종 결과는 https://luma.enablementadobe.com?utm_campaign= Product_launch&utm_content= start_shopping입니다.
조각의 출력 변수를 사용합니다.

조각 내에서 계산되거나 정의된 변수는 콘텐츠에서 사용할 수 있습니다. 다음 예에서 조각 F1은(는) 변수 집합을 선언합니다.

이메일 콘텐츠에서 다음과 같은 개인화를 가질 수 있습니다.

조각 F1은 utm_campaign 및 utm_content 변수를 초기화합니다. 그러면 메시지 콘텐츠의 링크에 이러한 매개 변수가 추가됩니다. 최종 결과는 https://luma.enablementadobe.com?utm_campaign= Product_launch&utm_content= start_shopping입니다.

NOTE

런타임 시 시스템은 조각 내의 항목을 확장한 다음 개인화 코드를 위쪽에서 아래쪽으로 해석합니다. 이를 염두에 두면 보다 복잡한 사용 사례를 달성할 수 있습니다. 예를 들어 아래에 있는 다른 조각 F2에 변수를 전달하는 조각 F1이 있을 수 있습니다. 시각적 조각 F1이 중첩된 표현식 조각 F2에 변수를 전달할 수도 있습니다.

루프 내에서 표현식 조각 사용 fragments-in-loops

{{#each}} 루프 내에서 식 조각을 사용할 때는 변수 범위 지정 작동 방식을 이해하는 것이 중요합니다. 표현식 조각은 메시지 콘텐츠에 정의된 전역 변수에 액세스할 수 있지만 루프별 변수를 매개 변수로 수신할 수는 없습니다.

지원되는 패턴: 전역 변수 사용 global-variables-in-loops

표현식 조각은 루프 내에서 조각이 호출되는 경우에도 조각 외부에 정의된 전역 변수를 참조할 수 있습니다. 반복적인 컨텍스트에서 조각을 사용해야 할 때 권장되는 방법입니다.

예: 루프 내에서 전역 변수가 있는 조각 사용

메시지 콘텐츠에서 전역 변수를 정의하고 이를 참조하는 조각을 사용합니다.

{% let globalDiscount = 15 %}

{{#each context.journey.actions.GetProducts.items as |product|}}
  <div class="product">
    <h3>{{product.name}}</h3>
    <p>Price: ${{product.price}}</p>
    {{fragment id='ajo:fragment123/variant456' mode='inline'}}
  </div>
{{/each}}

표현식 조각(fragment123)에서 globalDiscount 변수를 참조할 수 있습니다.

<p class="discount-info">Save {{globalDiscount}}% on all items!</p>

이 패턴이 작동하는 이유는 루프 컨텍스트에 관계없이 조각 내를 포함하여 메시지 전체에서 전역 변수에 액세스할 수 있기 때문입니다.

지원되지 않음: 루프 변수를 조각 매개 변수로 전달 loop-variables-limitations

현재 반복 항목(예: 위의 예에서 product)을 매개 변수로 식 조각에 전달할 수 없습니다. 조각은 주변 {{#each}} 블록에서 루프 범위 변수에 직접 액세스할 수 없습니다.

예: 작동하지 않는 항목

{{#each context.journey.actions.GetProducts.items as |product|}}
  <!-- This will NOT work as expected -->
  {{fragment id='ajo:fragment123/variant456' mode='inline' currentProduct=product}}
{{/each}}

현재 구현에서는 루프별 변수에 대한 매개 변수 전달이 지원되지 않으므로 조각이 product을(를) 매개 변수로 받아서 내부적으로 사용할 수 없습니다.

권장 해결 방법 fragments-in-loops-workarounds

루프의 데이터와 함께 표현식 조각을 사용해야 하는 경우 다음 접근 방식을 고려하십시오.

메시지에 직접 논리 포함: 루프별 논리에 조각을 사용하는 대신 {{#each}} 블록 내에 바로 개인화 코드를 추가하십시오.

code language-handlebars

{{#each context.journey.actions.GetProducts.items as |product|}}
  <div class="product">
    <h3>{{product.name}}</h3>
    <p>Price: ${{product.price}}</p>
    {{#if product.price > 100}}
      <span class="premium-badge">Premium Product</span>
    {{/if}}
  </div>
{{/each}}

루프 외부의 조각 사용: 조각 콘텐츠가 루프에 종속되지 않으면 반복 블록 앞 또는 뒤에서 조각을 호출하십시오.

code language-handlebars

{{fragment id='ajo:fragment123/variant456' mode='inline'}}

{{#each context.journey.actions.GetProducts.items as |product|}}
  <div class="product">
    <h3>{{product.name}}</h3>
    <p>Price: ${{product.price}}</p>
  </div>
{{/each}}

여러 개의 전역 변수를 설정합니다: 반복을 통해 조각에 다른 값을 전달해야 하는 경우 각 조각 호출 전에 전역 변수를 설정하십시오(유연성이 제한됨).

NOTE

상황별 데이터를 반복하고 루프를 사용하여 작업하려면 모범 사례, 문제 해결 팁 및 고급 패턴을 포함하는 상황별 데이터 반복에 대한 포괄적인 안내서를 참조하십시오.

편집 가능한 필드 사용자 지정 customize-fields

변수를 사용하여 표현식 조각의 특정 부분을 편집할 수 있게 만든 경우 특정 구문을 사용하여 해당 기본값을 무시할 수 있습니다. 조각을 사용자 지정할 수 있게 만드는 방법을 알아보세요

필드를 사용자 정의하려면 다음 단계를 수행합니다.

조각 메뉴에서 코드에 조각을 삽입합니다.
변수의 기본값을 재정의하려면 구문 끝에 있는 <fieldId>="<value>" 코드를 사용하십시오.

아래 예에서는 ID가 "sports"인 변수의 값을 “yoga” 값으로 재정의합니다. 스포츠 변수가 참조되는 모든 곳에서 조각 콘텐츠에 "요가"가 표시됩니다.

전자 메일을 만들 때 편집 가능한 필드를 표현식 조각에 추가하고 해당 값을 재정의하는 방법을 보여 주는 예는 이 섹션에서 확인할 수 있습니다.

동적 조각 해상도 사용 dynamic-resolution

디자인 타임에 조각 ID를 정적으로 포함하는 대신 수신자별로 런타임 시 조각 ID를 동적으로 확인할 수 있습니다. 이렇게 하면 다른 프로필이 프로필 속성, 데이터 세트 조회 또는 컨텍스트 데이터를 기반으로 동일한 캠페인이나 여정 내에서 완전히 다른 콘텐츠 블록을 받을 수 있습니다.

동적 조각 사용 방법 알아보기

상속 중단 break-inheritance

개인화 편집기에 조각 ID를 추가하면 원본 표현식 조각에 대한 변경 사항이 동기화됩니다.

그러나 표현식 조각의 콘텐츠를 편집기에 붙여넣을 수도 있습니다. 상황별 메뉴에서 조각 붙여넣기를 선택하여 해당 콘텐츠를 삽입합니다.

이 경우 원본 조각의 상속이 끊어집니다. 조각의 콘텐츠가 편집기에 복사되며, 변경 사항은 더 이상 동기화되지 않습니다.

이 요소는 더 이상 원본 조각에 연결되지 않는 독립 실행형 요소가 됩니다. 코드의 다른 요소로 편집할 수 있습니다.

빠른 참조 quick-reference

이 단원에는 이 주제와 관련된 해석, 검색 및 질문 답변을 지원하기 위한 구조화된 지식이 포함되어 있습니다.

이해를 돕기 위해 이 정보를 이 페이지의 설명서와 통합해야 합니다. 두 소스 모두 독립적으로 사용하기 위한 것은 아닙니다. 이 페이지에서는 기능에 대해 설명하지만, 용어, 의도, 적용 가능성 및 제약 조건을 명확히 하는 데 도움이 되는 추가 컨텍스트를 제공합니다.

개요

TL;DR

이 페이지에서는 암시적 변수, 루프 내 조각 사용, 편집 가능한 필드, 동적 해결 방법 및 상속 해제 등 개인화 편집기에서 표현식 조각을 삽입, 사용자 지정 및 관리하는 방법에 대해 설명합니다.

의도

조각 메뉴에서 표현식 조각을 삽입하고 자동 변경 전달 이해
암시적 변수 사용: 입력 변수(조각 외부로 선언됨, 내부에 사용됨) 및 출력 변수(조각 내부로 선언됨, 주변 메시지 콘텐츠에 사용됨)
루프 내의 표현식 조각 사용 — 조각 액세스에 전역 변수를 활용합니다. 루프 범위 변수를 매개 변수로 전달하는 제한 사항을 이해합니다.
<fieldId>="<value>" 구문을 사용하여 사용자 지정 가능한 조각의 편집 가능한 필드를 재정의합니다.
프로필 속성, 데이터 세트 조회 또는 컨텍스트 데이터를 기반으로 런타임 시 조각 ID를 동적으로 해결
조각 콘텐츠를 편집기에 바로 붙여넣어 상속 중단

용어집

표현식 조각: 캠페인 및 여정에서 ID가 참조하는 재사용 가능한 개인화 표현식 구성 요소입니다. 조각의 변경 사항은 이를 참조하는 모든 콘텐츠에 자동으로 전파됩니다. (제품별)
암시적 변수: 조각 기능을 확장하는 변수 — 입력 변수(캠페인/여정 콘텐츠에서 선언됨, 조각 내에서 사용됨) 및 출력 변수(조각 내에서 선언됨, 주변 메시지 콘텐츠에서 사용 가능). (제품별)
입력 변수: 조각이 내부적으로 참조하고 사용할 수 있는 조각 외부(캠페인 또는 여정 컨텐츠에서)에 선언된 변수입니다.
출력 변수: 조각 호출 후 주변 메시지 콘텐츠에서 사용할 수 있게 되는 조각 내에서 선언되거나 계산되는 변수입니다.
편집 가능한 필드: 조각 소스를 편집하지 않고 삽입 사용자가 <fieldId>="<value>" 구문을 사용하여 기본값을 재정의할 수 있도록 하는 조각 변수가 노출됩니다. (제품별)
동적 조각 확인: 디자인 타임에 정적 조각 ID를 포함하는 대신 런타임 시 조각 ID를 확인하는 기능(프로필 특성, 데이터 세트 조회 또는 컨텍스트 데이터 기반)입니다. (제품별)
상속 중단: 상황별 메뉴에서 "조각 붙여넣기"를 사용하면 조각의 콘텐츠가 원본 조각과 더 이상 동기화되지 않는 독립 실행형 요소로 편집기에 복사됩니다. (제품별)

용어

정식 이름: 식 조각 — 변형: 조각, 식 조각
동의어: “조각 ID” = 식에서 조각을 참조하는 데 사용되는 식별자입니다.
ID별로 조각을 삽입하면(참조됨, 변경 내용이 모든 콘텐츠에 자동으로 전파됨) 상속/붙여넣기 조각(편집기로 복사된 콘텐츠, 독립 실행형 요소, 더 이상 원본에 연결되지 않음≠이 중단됩니다.
혼동하지 마십시오. 입력 변수(조각 외부로 선언됨, 내부에서 사용됨)≠ 출력 변수(조각 내부로 선언됨, 주변 메시지 콘텐츠에서 외부에서 사용됨)입니다.
혼동하지 마십시오. 초안 조각(콘텐츠에 추가할 수 있지만 승인될 때까지 여정/캠페인 게시를 차단함) ≠ 라이브 조각(완전히 게시됨, 활성 여정 및 캠페인에 안전함)

보호 기능 및 제한 사항

주어진 게재에서 최대 30개의 조각을 추가할 수 있습니다.
조각은 최대 1개 수준까지만 중첩할 수 있습니다.
초안 상태의 조각이 포함된 여정 또는 캠페인은 활성화하거나 게시할 수 없습니다. 게시하기 전에 초안 조각을 승인해야 합니다.
표현식 조각은 루프 범위 변수(현재 {{#each}} 반복 항목)를 매개 변수로 수신할 수 없습니다. 이는 알려진 제한 사항입니다. 해결 방법으로 전역 변수 또는 인라인 논리를 사용하십시오.
여러 줄 바꿈이 포함된 조각을 SMS나 푸시 콘텐츠에서 사용하는 경우 줄 바꿈이 유지됩니다. 전송하기 전에 콘텐츠를 테스트합니다.

FAQ

Q: 한 번에 몇 개의 조각을 추가할 수 있습니까?

최대 30개 조각.

Q: 조각이 다른 조각 내에 중첩될 수 있습니까?

네, 하지만 최대 1단계까지만 중첩됩니다.

Q: 여정 또는 캠페인에서 초안 조각을 사용하면 어떻게 됩니까?

초안 조각을 콘텐츠에 추가할 수 있지만, 조각이 승인되고 상태가 라이브로 변경될 때까지 여정 또는 캠페인을 활성화하거나 게시할 수 없습니다.

Q: 식 조각이 현재 루프 항목(예: {{#each}}의 product)을 매개 변수로 받을 수 있습니까?

아니요. 표현식 조각은 루프 범위 변수를 매개 변수로 수신할 수 없습니다. 루프 외부에 선언된 전역 변수(조각이 액세스할 수 있음)를 사용하거나 조각을 사용하는 대신 루프 내에 직접 개인화 논리를 포함합니다.

Q: 상속을 중단하는 이유는 무엇이며 언제 사용해야 합니까?

상속을 중단한다는 것은 상황별 메뉴에서 "조각 붙여넣기"를 사용하여 조각의 콘텐츠를 편집기에 직접 복사하는 것을 의미합니다. 붙여넣은 콘텐츠는 원래 조각과 더 이상 동기화되지 않는 독립형 요소가 됩니다. 편집 가능한 필드에서 허용하는 범위를 넘어 콘텐츠를 사용자 정의해야 할 때 이를 사용합니다. 원래 조각에 대한 향후 변경 사항은 이 사본에 전파되지 않습니다.

recommendation-more-help

journey-optimizer-help