独自タグ
ご利用について
当機能のご利用は、Javascript等のプログラムの知識がある方のみを対象とさせていただいております。
そのため、ご利用方法につきましては当マニュアルをご参照のうえ、自己責任の範囲でのご利用をお願いいたします。
独自タグとは
独自タグは、Bカートの管理画面のフリースペース等の設定の入力内容として使用することができ、一般画面で入力内容が表示される際に、情報を動的に置き換える(置換する)ことができるBカート独自のタグ(文字列)です。
独自タグの例
※「{{ }}」や「{% %}」で囲まれている部分が独自タグです。
出力値タグ
{{ member.id }}
制御タグ(if)との組み合わせ
{% if member.logged_in %}
こんにちは、{{ member.tanto_last_name }} 様
{% endif %}
主な用途
独自タグを利用することで、Javascriptタグを介してデータ連携を行う外部の広告サービスやアクセス解析サービスなどにデータを送信する際に、Javascriptタグの設定値に、ログイン中の会員IDや注文商品IDなどを設定することができます。
管理画面での設定内容
<script>
var customer_id = {{ member.id }};
</script>
↓ ログイン中の会員IDが「10001」だった場合
一般画面での出力結果
<script>
var customer_id = 10001;
</script>
独自タグの利用手順
1. 独自タグ機能の有効化
まずはじめに、管理画面>各種設定>オプション管理にある設定項目の「独自タグ」で、「利用する」に変更し、設定を保存してください。
2. 独自タグを入力可能な設定項目にタグを入力
独自タグの入力が可能な管理画面の設定項目は以下になります。
(入力フォームの上部に「独自タグ使用可」というラベル表示のある項目)
タグの種類ごとに入力可能な設定項目と出力可能ページが異なります。
利用可能タグの詳細については後述します。
タグの種類 | 入力可能な設定項目 | 出力可能ページ |
---|---|---|
共通タグ |
各種設定 > 基本設定 > タグ出力(headタグ内) 各種設定 > 基本設定 > タグ出力(body開始タグ直後) 各種設定 > 基本設定 > タグ出力(body開始タグ直後)
デザイン管理 > 基本デザイン > ヘッダー フリー HTML スペース デザイン管理 > 基本デザイン > ヘッダーデザイン(HTML使用) デザイン管理 > 基本デザイン > ヘッダーメニュー (600px以上)(HTML) デザイン管理 > 基本デザイン > ヘッダーメニュー (599px以下)(HTML) デザイン管理 > 基本デザイン > フッター(HTML) |
全ページ |
商品情報タグ |
各ページ管理>商品詳細ページ>共通フリースペース |
商品詳細ページ |
注文情報タグ |
各ページ管理>注文完了ページ>フリースペース |
注文完了ページ |
カート情報タグ |
各ページ管理>カートページ>上部フリースペース 各ページ管理>カートページ>下部フリースペース |
カートページ |
3. 出力内容を確認
入力したタグが正しく置換され出力されているか、該当ページの表示やソースコードで確認してください。
(管理画面でのプレビュー機能はございませんので、出力内容は実際のページでご確認ください。)
正しく出力されないケース
- タグに存在しないパラメータを指定した場合場合は、空文字列が出力されます。
→ 例)ログインしていない状態で、ログイン中の会員情報を出力しようとしていた場合 - タグの入力形式が不正な場合は、入力内容がそのまま表示されます。
→ 例)if などの制御構文の記述に誤りがある場合
利用可能なタグの詳細
「Liquid」と同じ入力フォーマットを採用
Bカートの独自タグは、Shopify でも使用されている Liquid というテンプレート言語を基に作成されています。
そのため、出力値のタグの以外のフィルターや、条件分岐(if文)・繰り返し(for文)などの制御構文も Liquid と同じようにご利用いただけます(オブジェクトとプロパティはBカート独自の内容になります)。
入力例
- デフォルト値の設定
こんにちは、{{ member.tanto_last_name | default: "ゲスト" }} 様
- ユーザーがログインしている場合のみ名前(姓)を表示
{% if member.logged_in %}
こんにちは、{{ member.tanto_last_name }} 様
{% endif %}
利用できるすべての入力形式は Liquidの公式ドキュメント をご確認ください。
※ 尚、最新バージョンのフィルターなど、一部の機能がご利用いただけない場合があります。
利用できる出力値(パラメータ)タグ
出力値のタグには、全ページに出力できるタグ(共通タグ)と、一部のページでしか出力できないタグ(商品詳細ページタグ、注文完了ページタグ)があります。
- 【共通タグ】は、利用中のユーザー、サイト、ページ固有の情報の識別用途
-
【商品情報タグ】は、商品詳細ページでの商品情報と連携するサービスとのデータ連携用途
-
【注文情報タグ】は、注文完了ページでのアクセス解析等のサービスとのコンバージョンデータ(注文情報、注文商品情報)連携用途
- 【カート情報タグ】は、カートページでの商品情報と連携するサービスとのデータ連携用途
でご利用いただくことを想定しております。
共通タグ
項目名 |
入力例(タグ) |
出力内容 |
出力例 |
---|---|---|---|
ショップ情報 |
|||
ショップ名 |
{{ shop.name }} |
各種設定>基本設定>ショップ名 |
なんでも卸 |
ショップのトップページURL |
{{ shop.url }} |
(システムで自動生成) |
https://xxx.i10.bcart.jp |
ページ情報 |
|||
現在のページの識別文字列 |
{{ page.slug }} |
(システムで自動生成) |
cart |
現在のページのURL |
{{ page.url }} |
(システムで自動生成) |
https://xxx.i10.bcart.jp/cart.php |
ログイン情報 |
|||
ログイン状態 |
{{ member.logged_in }} |
(システムで自動生成) |
ログイン中(会員)なら “1” |
ログイン会員情報(※未ログイン(非会員)の場合は空) |
|||
Bカート会員ID |
{{ member.id }} |
(システムで自動採番) |
10000 |
貴社独自会員ID |
{{ member.ext_id }} |
会員管理>会員情報>貴社独自会員ID |
example123 |
代理店ID |
{{ member.agent_id }} |
会員管理>会員情報>代理店ID |
example123 |
親会員ID |
{{ member.parent_id }} |
会員管理>会員情報>親会員ID |
example123 |
配送先ID |
{{ member.destination_code }} |
会員管理>会員情報>配送先ID |
example123 |
営業担当者ID |
{{ member.salesman_id }} |
会員管理>会員情報>営業担当者 |
5 |
価格グループID |
{{ member.price_group_id }} |
会員管理>会員情報>価格グループ |
1 |
表示グループID |
{{ member.view_group_id }} |
会員管理>会員情報>表示グループ |
1 |
会社名 |
{{ member.comp_name }} |
会員管理>会員情報>会社名 |
株式会社サンプル |
会社名カナ |
{{ member.comp_name_kana }} |
会員管理>会員情報>会社名カナ |
カブシキガイシャサンプル |
部署名 |
{{ member.department }} |
会員管理>会員情報>部署名 |
営業部 |
担当者姓 |
{{ member.tanto_last_name }} |
会員管理>会員情報>担当者(姓) |
山田 |
担当者名 |
{{ member.tanto_first_name }} |
会員管理>会員情報>担当者(名) |
一郎 |
担当者姓カナ |
{{ member.tanto_last_name_kana }} |
会員管理>会員情報>担当者カナ(姓) |
ヤマダ |
担当者名カナ |
{{ member.tanto_first_name_kana }} |
会員管理>会員情報>担当者カナ(名) |
イチロウ |
メールアドレス |
{{ member.email }} |
会員管理>会員情報>メールアドレス |
example@example.com |
電話番号 |
{{ member.tel }} |
会員管理>会員情報>電話番号 |
03-1111-1111 |
携帯番号 |
{{ member.mobile_phone }} |
会員管理>会員情報>携帯番号 |
090-1111-1111 |
郵便番号 |
{{ member.zip }} |
会員管理>会員情報>郵便番号 |
111-1111 |
住所(都道府県) |
{{ member.pref }} |
会員管理>会員情報>住所 |
東京都 |
住所(市区町村) |
{{ member.address1 }} |
会員管理>会員情報>住所 |
○○区△町 |
住所(町域・番地) |
{{ member.address2 }} |
会員管理>会員情報>住所 |
3-24 |
住所(ビル・建物名) |
{{ member.address3 }} |
会員管理>会員情報>住所 |
〇〇ビル |
所持ポイント |
{{ member.point }} |
会員管理>会員情報>ポイント |
500 |
登録日 |
{{ member.created_at }} |
会員管理>会員一覧>登録日 |
2021-11-11 |
会員カスタム項目 |
{{ member.customs }} |
(配列データ)別表「ログイン会員情報>会員カスタム項目」参照 |
|
ログイン会員情報>会員カスタム項目 |
|||
(配列データ) |
{% for member_custom in member.customs %} |
会員管理>会員カスタム項目 |
(配列データ) |
ID |
{{ member_custom.field_id }} |
会員管理>会員カスタム項目>ID |
1 |
項目名 |
{{ member_custom.name }} |
会員管理>会員カスタム項目>項目名 |
実店舗の有無 |
値 |
{{ member_custom.value }} |
会員管理>会員情報>{カスタム項目名} |
あり |
商品情報タグ
項目名 |
入力例(タグ) |
出力内容 |
出力例 |
---|---|---|---|
Bカート商品ID |
{{ product.id }} |
商品管理>商品一覧>Bカート商品ID |
123 |
商品管理番号 |
{{ product.main_no }} |
商品管理>商品基本情報編集>商品管理番号 |
COL-1008 |
商品名 |
{{ product.name }} |
商品管理>商品基本情報編集>商品管理番号 |
コルビジェ風クラシックソファー2人掛け |
カテゴリID |
{{ product.category_id }} |
商品管理>商品基本情報編集>メインカテゴリ |
5 |
カテゴリ名 |
{{ product.category_name }} |
商品管理>商品基本情報編集>メインカテゴリ |
ソファ(2人掛け) |
特集1のID |
{{ product.feature1_id }} |
商品管理>商品基本情報編集>特集1 |
10 |
特集1の名前 |
{{ product.feature1_name }} |
商品管理>商品基本情報編集>特集1 |
新生活応援特集 |
特集2のID |
{{ product.feature2_id }} |
商品管理>商品基本情報編集>特集2 |
11 |
特集2の名前 |
{{ product.feature2_name }} |
商品管理>商品基本情報編集>特集2 |
コルビジェ特集 |
特集3のID |
{{ product.feature3_id }} |
商品管理>商品基本情報編集>特集3 |
12 |
特集3の名前 |
{{ product.feature3_name }} |
商品管理>商品基本情報編集>特集3 |
店長イチオシ商品 |
商品特徴 |
{{ product.tags }} |
(配列データ)別表「商品情報>商品特徴」参照 |
|
画像URL |
{{ product.image_url }} |
商品管理>商品基本情報編集>商品画像 |
https://files.bcart.jp/example/uploads/products/example.jpg |
ダウンロードファイルURL |
{{ product.file_download_url }} |
商品管理>商品基本情報編集>ダウンロードファイル |
https://files.bcart.jp/example/uploads/downloads/example.jpg |
商品基本カスタム項目 |
{{ product.customs }} |
(配列データ)別表「商品情報>商品基本カスタム項目」参照 |
|
商品セット |
{{ product.sets }} |
(配列データ)別表「商品情報>商品セット」参照
|
|
商品情報>商品特徴 |
|||
(配列データ) |
{% for tag in product.tags %} |
商品管理>商品特徴 |
(配列データ) |
ID |
{{ tag.id }} |
商品管理>商品特徴>ID |
5 |
識別文字列 |
{{ tag.slug }} |
商品管理>商品特徴>識別文字列 |
hot |
表示名 |
{{ tag.name }} |
商品管理>商品特徴>表示名 |
人気急上昇 |
商品情報>商品基本カスタム項目 |
|||
(配列データ) |
{% for product_custom in product.customs %} |
商品管理>商品基本カスタム項目 |
(配列データ) |
項目ID |
{{ product_custom.field_id }} |
商品管理>商品基本カスタム項目>ID |
3 |
項目名 |
{{ product_custom.name }} |
商品管理>商品基本カスタム項目>項目名 |
自社品番 |
値 |
{{ product_custom.value }} |
商品管理>商品基本情報>{カスタム項目名} |
ABC123 |
商品情報>商品セット |
|||
(配列データ) |
{% for set in product.sets %} |
商品管理>セット情報 |
(配列データ) |
商品セットID |
{{ set.id }} |
商品管理>セット情報>BカートセットID |
1234 |
品番 |
{{ set.product_no }} |
商品管理>セット情報>品番 |
COL-1008-6 |
セット名 |
{{ set.name }} |
商品管理>セット情報>セット名 |
6点セット |
JANコード |
{{ set.jan_code }} |
商品管理>セット情報>JANコード |
1234567890123 |
ロケーション番号 |
{{ set.location_no }} |
商品管理>セット情報>ロケーション |
a-123 |
配送グループID |
{{ set.shipping_group_id }} |
商品管理>セット情報>配送グループ |
1 |
商品セットカスタム項目 |
{{ set.customs }} |
(配列データ)別表「商品情報>商品セット>商品セットカスタム項目」参照 |
|
商品情報>商品セット>商品セットカスタム項目 |
|||
(配列データ) |
{% for product_set_custom in set.customs %} |
商品管理>商品セットカスタム項目 |
(配列データ) |
項目ID |
{{ product_set_custom.field_id }} |
商品管理>商品セットカスタム項目>ID |
3 |
項目名 |
{{ product_set_custom.name }} |
商品管理>商品セットカスタム項目>項目名 |
自社品番 |
値 |
{{ product_set_custom.value }} |
商品管理>セット情報>{カスタム項目名} |
ABC123 |
注文情報タグ
項目名 |
入力例(タグ) |
出力内容 |
出力例 |
---|---|---|---|
受注情報 |
|||
受注番号 |
{{ order.code }} |
受注情報>受注番号 |
12345678901 |
受注日時 |
{{ order.orderd_at }} |
受注情報>受注日時 |
2021-07-07 09:46:41 |
注文者 会員ID |
{{ order.customer_id }} |
受注情報>Bカート会員ID |
10001 |
注文者 貴社独自会員ID |
{{ order.customer_ext_id }} |
受注情報>貴社独自会員ID |
example123 |
注文者 親代理店ID |
{{ order.customer_parent_id }} |
受注情報>親代理店ID |
example123 |
注文者 営業担当者ID |
{{ order.customer_salesman_id }} |
受注情報>営業担当者 |
5 |
注文者 会社名 |
{{ order.customer_comp_name }} |
受注情報>会社名 |
株式会社サンプル |
注文者 部署名 |
{{ order.customer_department }} |
受注情報>部署名 |
営業部 |
注文者名 |
{{ order.customer_name }} |
受注情報>担当者 |
山田一郎 |
注文者 電話番号 |
{{ order.customer_tel }} |
受注情報>電話番号 |
03-1111-1111 |
注文者 携帯番号 |
{{ order.customer_mobile_phone }} |
受注情報>携帯番号 |
090-1111-1111 |
注文者 メールアドレス |
{{ order.customer_email }} |
受注情報>メールアドレス |
example@example.com |
注文者 価格グループ名 |
{{ order.customer_price_group_name }} |
受注情報>価格グループ名 |
通常会員 |
注文者 郵便番号 |
{{ order.customer_zip }} |
受注情報>郵便番号 |
111-1111 |
注文者 都道府県 |
{{ order.customer_pref }} |
受注情報>都道府県 |
東京都 |
注文者 市町区村 |
{{ order.customer_address1 }} |
受注情報>住所(市町区村) |
○○区△町 |
注文者 町域・番地 |
{{ order.customer_address2 }} |
受注情報>住所(町域・番地) |
3-24 |
注文者 ビル・建物名 |
{{ order.customer_address3 }} |
受注情報>住所(ビル・建物名) |
〇〇ビル |
注文者 会員カスタム項目 |
{{ order.customer_customs }} |
(配列データ)「受注情報>注文者 会員カスタム項目」参照 |
|
決済方法 |
{{ order.payment }} |
受注情報>決済方法 |
銀行振込 |
商品本体価格合計(税抜) |
{{ order.total_price }} |
受注情報>計(商品総額) |
300000 |
商品消費税合計 |
{{ order.tax }} |
受注情報>消費税(商品総額にかかる消費税額の合計) |
30000 |
決済手数料(税込) |
{{ order.payment_fees }} |
受注情報>決済手数料(税込) |
550 |
送料(税込) |
{{ order.shipping_cost }} |
受注情報>送料(税込) |
1100 |
ポイント利用 |
{{ order.use_point }} |
受注情報>ポイント利用 |
1000(※利用額を正の値で出力します) |
受注総額(税込) |
{{ order.final_price }} |
商品本体価格合計(税抜) + 商品消費税合計 + 決済手数料(税込) + 送料(税込) – ポイント利用 |
330650 |
アンケート1 |
{{ order.enquete1 }} |
コンテンツ>各ページ管理>注文ページ>受注時アンケート1〜5 |
1 |
アンケート2 |
{{ order.enquete2 }} |
||
アンケート3 |
{{ order.enquete3 }} |
||
アンケート4 |
{{ order.enquete4 }} |
||
アンケート5 |
{{ order.enquete5 }} |
||
受注商品 |
{{ order.products }} |
(配列データ)「受注情報>受注商品」参照 |
|
受注情報>注文者 会員カスタム項目 |
|||
(配列データ) |
{% for order_customer_custom in order.customer_customs %} |
会員管理>会員カスタム項目 |
(配列データ) |
項目ID |
{{ order_customer_custom.field_id }} |
(システムで自動採番) |
1 |
項目名 |
{{ order_customer_custom.name }} |
会員管理>会員カスタム項目>項目名 |
実店舗の有無 |
値 |
{{ order_customer_custom.value }} |
会員管理>会員情報>{項目名} |
あり |
受注情報>受注商品 |
|||
(配列データ) |
{% for order_product in order.products %} |
受注管理>受注商品情報 |
(配列データ) |
受注商品ID |
{{ order_product.id }} |
(システムで自動採番) |
12345 |
受注数 |
{{ order_product.order_pro_count }} |
受注管理>受注商品情報>受注数 |
2 |
商品ID |
{{ order_product.product_id }} |
受注管理>受注商品情報>Bカート商品ID |
123 |
商品管理番号 |
{{ order_product.main_no }} |
受注管理>受注商品情報>商品管理番号 |
COL-1008 |
商品名 |
{{ order_product.product_name }} |
受注管理>受注商品情報>商品名 |
コルビジェ風クラシックソファー2人掛け |
品番 |
{{ order_product.product_no }} |
受注管理>受注商品情報>品番 |
COL-1008-5 |
JANコード |
{{ order_product.jan_code }} |
受注管理>受注商品情報>JANコード |
1234567890123 |
ロケーション番号 |
{{ order_product.location_no }} |
受注管理>受注商品情報>商品管理番号 |
a-123 |
商品セットID |
{{ order_product.product_set_id }} |
受注管理>受注商品情報>BカートセットID |
1234 |
商品セット名 |
{{ order_product.set_name }} |
受注管理>受注商品情報>セット名 |
5点セット |
単価 |
{{ order_product.unit_price }} |
受注管理>受注商品情報>単価 |
30000 |
入数 |
{{ order_product.set_quantity }} |
受注管理>受注商品情報>入数 |
5 |
単位 |
{{ order_product.set_unit }} |
受注管理>受注商品情報>単位 |
点 |
配送サイズ |
{{ order_product.shipping_size }} |
受注管理>受注商品情報>配送サイズ |
200 |
税率 |
{{ order_product.tax_rate }} |
受注管理>受注商品情報>税率 |
0.1 |
税区分 |
{{ order_product.tax_type_id }} |
標準税率対象なら”1″ |
1 |
商品基本カスタム項目 |
{{ order_product.product_customs }} |
(配列データ)別表「受注情報>受注商品>商品基本カスタム項目」参照 |
|
商品セットカスタム項目 |
{{ order_product.product_set_customs }} |
(配列データ)別表「受注情報>受注商品>商品セットカスタム項目」参照 |
|
商品オプション |
{{ order_product.product_options }} |
(配列データ)別表「受注情報>受注商品>商品オプション」参照 |
|
受注情報>受注商品>商品基本カスタム項目 |
|||
(配列データ) |
{% for order_product_custom in order_product.product_customs %} |
商品管理>商品基本カスタム項目 |
(配列データ) |
項目ID |
{{ order_product_custom.field_id }} |
商品管理>商品基本カスタム項目>ID |
3 |
項目名 |
{{ order_product_custom.name }} |
商品管理>商品基本カスタム項目>項目名 |
自社管理番号 |
値 |
{{ order_product_custom.value }} |
受注管理>受注商品情報>{カスタム項目名} 商品管理>商品基本カスタム項目 |
1 |
受注情報>受注商品>商品セットカスタム項目 |
|||
(配列データ) |
{% for order_product_custom in order_product.product_set_customs %} |
商品管理>商品基本カスタム項目 |
(配列データ) |
項目ID |
{{ order_product_set_custom.field_id }} |
商品管理>商品セットカスタム項目>ID |
3 |
項目名 |
{{ order_product_set_custom.name }} |
商品管理>商品セットカスタム項目>項目名 |
自社品番 |
値 |
{{ order_product_set_custom.value }} |
受注管理>受注商品情報>{カスタム項目名} 商品管理>商品基本カスタム項目 |
1 |
受注情報>受注商品>商品オプション |
|||
(配列データ) |
{% for product_option in order_product.product_options %} |
商品管理>商品オプション |
(配列データ) |
項目ID |
{{ order_product_option.field_id }} |
商品管理>商品オプション>ID |
3 |
項目名 |
{{ order_product_option.name }} |
商品管理>商品オプション>項目名 |
自社品番 |
値 |
{{ order_product_option.value }} |
受注管理>受注商品情報>商品オプション>{項目名} 商品管理>商品オプション |
1 |
カート情報タグ
項目名 | 入力例(タグ) | 出力内容 | 出力例 |
---|---|---|---|
(配列データ) |
{% for cart_product in cart.products %} {{ cart_product.set_id }} {% endfor %} |
カートページ>商品内容 欄の注文商品に記載された商品の配列 |
(配列データ) 繰り返し処理と組み合わせて出力 |
カート商品セットID |
{{ cart_product.set_id }} |
カートページ>商品内容 欄の注文商品の商品セットID |
1 |
カート商品品番 |
{{ cart_product.product_no }} |
カートページ>商品内容 欄の注文商品の商品セットの品番 |
COL-1008-6 |
カート商品名 |
{{ cart_product.product_name }} |
カートページ>商品内容 欄の注文商品の商品名 |
コルビジェ風クラシックソファー2人掛け |
カート商品セット名 |
{{ cart_product.set_name }} |
カートページ>商品内容 欄の注文商品の商品セット名 |
6点セット |
カート商品画像URL |
{{ cart_product.image_url }} |
カートページ>商品内容 欄の注文商品の商品画像 |
https://files.bcart.jp/example/uploads/products/example.jpg |