仕組みを知る›商品情報の連携方法とは

商品情報の連携方法とは連携項目をページから読み取る方法

連携項目を商品ページからどう読み取るかを決める方法です。項目ごとに読み取り方法を1つ決め、初期設置リクエストシートの「連携項目&方式」タブに記入します。シートは準備するものにあります。

連携方法

CSS Selectorを推奨します。商品情報をHTMLに表示していないサイトでは、JSON-LDやJavaScript変数のほうが安定します。以下は推奨順です。

CSS Selector(推奨)

ページのHTMLに<a id="product_no">PerfittShoe</a>のようなタグがあれば、CSS Selectorとして#product_noを記入します。Perfittはその要素のテキストを読み、<input>は値を、<img>は画像URLを読みます。セレクタをカンマ区切りで複数書くと、先に見つかったものを使います。

セレクタの書き方はMDN CSSセレクターを参照してください。

値の読み取りを試す Selectorを入力すると、Perfittが商品ページから読み取る値をその場で確認できます。
例

一致する領域がないため、読み取る値がありません。

PERFITT
パーフェクトフィット ニットブースト ワン
¥8,900
モック画面です。実際のサイトでもPerfittは同じ方法で読み取ります。

商品ページの構造が変わるとセレクタが壊れます。サイトをリニューアルする際は、事前にPerfitt担当者にお知らせください。

JSON-LD(schema.org)

検索エンジン向けに<script type="application/ld+json">を入れているサイトは多くあります。その中の最上位のキー名(sku、name、imageなど)を記入すると、Perfittが値を読みます。ページデザインが変わっても壊れにくい方法です。

商品ページのHTML
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "sku": "PerfittShoe",
  "name": "パーフェクトフィット ニットブースト ワン",
  "image": "https://shop.example.com/images/perfitt-shoe.jpg"
}
</script>

brandのように値がオブジェクト({ "name": "..." })のキーは、そのままでは読めません。そのような項目は別の方法を使うか、担当者にご相談ください。

JavaScript変数・関数(window)

ページのスクリプトがグローバル変数に商品情報を持っている場合、変数名とその中のキーを記入します。下の例ではproductInfoとidです。値が変数そのものなら変数名だけを記入します。

グローバル関数が値を返す場合(例:window.getProductId())は関数名を記入します。返された値は文字列として使います。

商品ページのスクリプト
window.productInfo = {
  id: 'PerfittShoe',
  brand: 'PERFITT',
  name: 'パーフェクトフィット ニットブースト ワン',
};

URLクエリ

ページのURLがhttps://shop.example.com/product?product_no=PerfittShoeなら、キー名としてproduct_noを記入します。

ブラウザストレージ(localStorage · sessionStorage · Cookie)

ページがブラウザストレージに値を保存している場合、そのキー名を記入します。保存された値がJSONなら、内側のキーまで指定して1階層下の値を読めます。Cookieの場合はCookie名を記入します。開発者ツールのApplicationタブでは次のように見えます。

Application › Local Storage
KeyValue
product_noPerfittShoe
product_nameパーフェクトフィット ニットブースト ワン
localStorageに保存された値。キー名product_noを記入するとPerfittShoeを読みます。

固定値(VALUE)

ページから読み取れない項目は固定値として設定します。例えば単一ブランドのサイトは商品ページにブランド名がないため、brand項目をPERFITTのような固定値にします。

値の描画が遅いページ

商品情報をJavaScriptで後から描画するサイトでは、ページを開いた直後に値がないことがあります。そのような項目にはPerfittが待機時間(通常5秒)を設定し、0.5秒ごとに読み直します。待機時間を過ぎても値がなければ、その項目は空のまま進みます。描画が遅い項目があれば担当者にお知らせください。さらに遅い場合は手動実行モードで値を直接渡すほうが確実です。

サイズ選択の領域(任意)

商品ページのサイズ選択領域(セレクトボックスやサイズボタン)のCSS Selectorを教えていただくと、Perfittがその商品の販売サイズと在庫切れの有無も読み取ります。推薦サイズを実際に販売しているサイズの範囲内に限定し、在庫切れのサイズを除外するために使います。

  • サイズ選択領域のCSS Selector(例:.product-size-options li)
  • 在庫切れサイズの表し方(例:クラス.sold-out)
このページは役に立ちましたか?