動的変数リファレンス

動的変数を使うと、最新の商品データや顧客データをバッジのテキスト内に表示できます。お客様が商品を閲覧した時点で、実際の値に置き換えられます。

たとえば、テキストが 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 discount変数

この4つの変数は、アプリの 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 discount変数に値が入るのは、その割引を対象にしたバッジのみです。バッジの Products タブで Products matching conditions を使い、条件 Sami discount is equal to にその割引を指定する必要があります。割引を保存して Create badge をクリックすると、この設定は自動で行われます。

商品レビュー変数

この2つの変数は、ストアで使用しているレビューアプリ(Judge.me、Loox、Junip、CWILL(Trustoo)、LAI Product Reviews、AG Product Reviews)から値を取得します。Insert dynamic text では Advanced タブにあります。

変数	説明	出力例
{product_rating_star}	商品の平均星評価。常に小数第1位まで表示されます	“4.8”
{product_number_of_star}	商品のレビュー数	“126”

注意

レビュー変数に値が入るのは、レビューアプリを対象にしたバッジのみです。バッジの Products タブで Products matching conditions を使い、条件 Product review app is equal to にお使いのアプリを指定する必要があります。指定しないと保存がブロックされ、バナーに該当の変数名が表示されます。詳しくはレビューアプリからバッジを表示するをご覧ください。

ノート

レビューのない商品では、2つの変数とも空になります。そのため、数値のない「stars」だけが表示されることがないよう、アプリはバッジ全体を非表示にします。

補足

ノート

セール変数と自動非表示
{sale} と {sale_amount} では、商品がセール対象でない場合にバッジを自動で非表示にするオプションを使えます。定価の商品に「0%」や「$0.00」と表示されるのを防げます。

ノート

メタフィールド変数
{product_metafield} と {variant_metafield} には DIAMOND プランが必要です。選択すると、ストアのメタフィールド定義がチェックボックスで一覧表示されます。使いたいものにチェックを入れると、{product.metafields.custom.material} のような実際のトークンがアプリによって作成されます。

ノート

カウントダウンタイマー
カウントダウンには GOLD プランと、バッジエディタの Display > Visibility Date & Countdown で設定する終了日が必要です。終了日までの残り時間がリアルタイムで更新されて表示されます。2つのスタイルはそれぞれ別のトークンです。Style 1 は {countdown}、Style 2 は {countdown_2} を挿入するため、挿入する前に Insert dynamic text でスタイルを選択してください。

注意

変数は大文字と小文字が区別されます。波括弧も含めて、表示されているとおりに入力してください。{sale} は使えますが、{Sale} や {SALE} は使えません。

---

次のステップ

• 動的変数の使い方 — バッジのテキストに変数を追加する手順を説明します。
• テキストバッジを作成する — 動的コンテンツを使った最初のテキストバッジを作成します。