동적 변수 참조

동적 변수는 배지 텍스트 안에 실시간 제품 및 고객 데이터를 표시합니다. 고객이 제품을 볼 때 실제 값으로 대체됩니다.

예를 들어 텍스트가 Save {sale}!인 배지는 25% 할인 중인 제품에서 **Save 25%!**로 표시됩니다.

변수 참조 표

변수	설명	출력 예시	요금제
{product_vendor}	제품 공급업체 이름	“Nike”	FREE
{product_type}	제품 유형	“T-Shirt”	FREE
{product_sku}	제품 SKU	“SKU-12345”	FREE
{inventory}	총 재고 수량	“42”	FREE
{sale}	할인율	“25%”	FREE
{sale_amount}	할인 금액	“$10.00”	FREE
{product_variant_count}	옵션 수	“3”	FREE
{customer_order_total}	고객의 총 주문 수	“5”	FREE
{customer_spent_total}	고객의 총 구매 금액	“$250.00”	FREE
{product_rating_star}	제품의 평균 별점	“4.8”	FREE
{product_number_of_star}	제품의 리뷰 수	“126”	FREE
{product_metafield}	제품 메타필드 값	(다양함)	DIAMOND
{variant_metafield}	옵션 메타필드 값	(다양함)	DIAMOND
{countdown}	종료일까지 카운트다운, 스타일 1	“12Days 20Hrs 50Mins”	GOLD
{countdown_2}	같은 카운트다운의 스타일 2, 각 단위가 상자로 표시됨	“12 : 20 : 50”	GOLD

Sami 할인 변수

이 네 가지 변수는 앱의 Discounts 페이지에서 만든 할인에서 값을 가져옵니다. Insert dynamic text에서는 Sami Discount 탭에 모여 있습니다.

변수	설명	출력 예시
{sami_discount_value_percent}	제품에 적용된 Sami 할인의 할인율	“20%”
{sami_discount_value_amount}	제품에 적용된 Sami 할인의 할인 금액	“Save 10.00”
{sami_discount_code}	제품에 적용된 Sami 할인의 할인 코드(코드 할인만 해당)	“SUMMER20”
{sami_new_price}	Sami 할인이 적용된 후의 제품 가격	“Now 40.00”

주의

Sami 할인 변수는 해당 할인으로 범위가 지정된 배지에서만 값을 가집니다. 배지의 Products 탭에서 Products matching conditions를 사용하고, 조건을 Sami discount is equal to 해당 할인으로 설정해야 합니다. 할인을 저장하고 Create badge를 클릭하면 자동으로 설정됩니다.

제품 리뷰 변수

이 두 변수는 스토어에서 사용하는 리뷰 앱(Judge.me, Loox, Junip, CWILL(Trustoo), LAI Product Reviews, AG Product Reviews)에서 값을 가져옵니다. Insert dynamic text에서는 Advanced 탭에 있습니다.

변수	설명	출력 예시
{product_rating_star}	제품의 평균 별점, 항상 소수점 한 자리로 표시	“4.8”
{product_number_of_star}	제품의 리뷰 수	“126”

주의

리뷰 변수는 리뷰 앱으로 범위가 지정된 배지에서만 값을 가집니다. 배지의 Products 탭에서 Products matching conditions를 사용하고, 조건을 Product review app is equal to 사용 중인 앱으로 설정해야 합니다. 설정하지 않으면 저장이 차단되고 배너에 해당 변수 이름이 표시됩니다. 리뷰 앱의 배지 표시하기를 참고하세요.

참고

리뷰가 없는 제품은 두 변수 모두 값이 비어 있습니다. 이 경우 앞에 숫자 없이 “stars”만 표시되지 않도록 앱이 배지를 아예 숨깁니다.

참고 사항

참고

할인 변수와 자동 숨김
{sale}과 {sale_amount}는 제품이 할인 중이 아닐 때 배지를 자동으로 숨기는 옵션을 지원합니다. 정가 제품에 “0%“나 “$0.00”이 표시되는 것을 방지합니다.

참고

메타필드 변수
{product_metafield}와 {variant_metafield}는 DIAMOND 요금제가 필요합니다. 하나를 선택하면 스토어의 메타필드 정의가 체크박스로 표시됩니다. 원하는 항목을 선택하면 앱이 {product.metafields.custom.material} 같은 실제 토큰을 만들어 줍니다.

참고

카운트다운 타이머
카운트다운은 GOLD 요금제가 필요하며, 배지 편집기의 Display > Visibility Date & Countdown에서 end date를 설정해야 합니다. 실시간으로 업데이트되어 해당 날짜까지 남은 시간을 표시합니다. 두 스타일은 별개의 토큰입니다. Style 1은 {countdown}을, Style 2는 {countdown_2}를 삽입하므로, 삽입하기 전에 Insert dynamic text에서 스타일을 선택하세요.

주의

변수는 대소문자를 구분합니다. 중괄호를 포함해 표시된 그대로 입력하세요. {sale}은 작동하지만 {Sale}이나 {SALE}은 작동하지 않습니다.

---

다음 단계

• 동적 변수 사용하기 — 배지 텍스트에 변수를 추가하는 방법을 단계별로 알아봅니다.
• 텍스트 배지 만들기 — 동적 콘텐츠가 들어간 첫 텍스트 배지를 만들어 보세요.