パラメータ追加例

下記の例のように、パラメータ記述を追加します。

<script>
  var poplink3 = {
    uid: "01234567890abcdefghijklmnopqrstuv", //弊社からご案内したuidを転記
    target: "#TARGET", //INPUTタグに指定したidを記述
   suggestCount: 10, //「候補語サジェスト」を10個表示
   displayItemSummary: false, //商品説明を表示しない
   gaType: "gtag", //Googleアナリティクスで測定（拡張eコマース機能を使用）
	 ;          ※2022.10現在、GA4では計測できません。GA4をご利用の際には削除してください。
   deviceType: 'pc011', //サジェストを左寄せで表示
  };
  (function() {
    var s = document.createElement("script");
    s.charset = "utf-8";
    s.src = "//poplink-f.probo.biz/pl3/poplink3.js";
    document.getElementsByTagName("head")[0].appendChild(s);
  })();
</script>

uid

uid: "a0b1c2d3e4f5g6h7i8j9k0lmnopqrstuv",

サジェストのサービスの識別コード(UID)を指定します。UIDは弊社よりお知らせいたします。(必須）

target

target: "#TARGET",

検索ボックスの要素をCSSセレクタの書式で指定します。(必須）

displayTarget

displayTarget: "#SUGGEST";

デザイン上の都合で、検索ボックスとは離れた場所にサジェストを表示したい場合に使用します。
指定したIDを持つ要素に表示できます。上例では「SUGGEST」というidを持つ要素の場所に表示します。

deviceType

deviceType: { desktop: 'pc011r', mobile: 'sphs' },

レスポンシブサイトの場合に、PCとmobile（スマートフォン）の表示タイプを（一度に）指定・変更できます。（サジェストリンクそのものはレスポンシブ対応ではありません。）表示についてはサジェストリンク独自に判定されます。
デバイス最適化サイトの場合は以下のようにそれぞれのデバイスタイプのみ記載してください。

deviceType: 'sphs',

deviceTypeに設定できる値は以下となります。設定によってサジェストリンクにあらかじめ用意されたデザインで表示されます。

sphsについては以下をご覧ください。

• 「候補語サジェスト」の最大表示数（suggestCount）のデフォルトは20です。
• 「商品検索サジェスト」の最大表示数（searchCount）のデフォルトは10です。
• 「商品検索サジェスト」の表示（useSearch）をfalse（非表示）に設定できません。
• searchHeader（商品表示の見出し）を指定できません。
• 「商品検索サジェスト」の商品名（displayItemTitle）」または「商品検索サジェスト」の商品説明（displayItemSummary）」のいずれかをtrueにできます。

suggestCount

suggestCount: 5,

「候補語サジェスト」を表示する最大数を指定します。数値は1から20までの範囲で指定できます。

useSearch

useSearch: true,

「商品検索サジェスト」を表示します。falseを指定した場合、「商品検索サジェスト」を表示しません。（スマートフォン用の「sphs」では指定できません。）

searchCount

searchCount: 3,

「商品検索サジェスト」を表示する最大数を指定します。数値は1から10までの値を指定できます。（PCのみ）

displayItemImage

displayItemImage: true,

「商品検索サジェスト」に商品画像を表示します。falseを指定した場合、画像を表示しません。

displayItemSummary

displayItemSummary: true,

「商品検索サジェスト」に商品説明を表示します。falseを指定した場合、商品説明を表示しません。

displayItemTitle

displayItemTitle: true,

「商品検索サジェスト」に商品名を表示します。falseを指定した場合、商品名を表示しません。

displaySearchHeader

displaySearchHeader: ture,

「商品検索サジェスト」に、商品表示の見出しを表示します。見出しは、SearchHeaderTextパラメータで指定されている文字列が使用されます。falseを指定した場合、商品表示の見出しを表示しません。

searchHeaderText

searchHeaderText: "商品検索",

商品表示の見出しに表示される文字列を指定します。文字列が1行に収まらない場合、改行して表示されます。SearchHeaderにfalseが指定されている場合は、商品表示の見出しを表示しません。

searchAutoDisplay

searchAutoDisplay: true,

falseを指定した場合は、エンドユーザーが「候補語サジェスト」にフォーカスするまで「商品検索サジェスト」を表示しません。「商品検索サジェスト」が自動的に表示されなくなります。

closeImage

closeImage: "//poplink-f.probo.biz/pl3/images/close.png",

スマートフォンで表示されるサジェストを閉じるボタンの画像をURLで指定します。

gaType

2022.10現在、GA4では計測できません。GA4をご利用の際にはご利用いただけません。

gaType: "gtag",

Googleアナリティクスのイベントデータとして測定できます。グローバルサイトタグ (gtag.js)を使用している場合は「gaType: "gtag",」、ユニバーサルアナリティクス (analytics.js) を使用している場合は「 gaType: "universal",」と指定します。

Google Analytics設定（コマースクリエイター）をご利用の場合は、「gaType: "gtag",」を指定いただいた上で、以下のように、サジェストリンクのタグの前にGoogleアナリティクスのタグを記述してください。「, { 'send_page_view': false }」が必須となります。
下記の「トラッキング ID」と記載された部分に、Googleアナリティクスの「トラッキングID」を入力してください。

<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'トラッキング ID', { 'send_page_view': false });

  var poplink3 = {
    uid: "01234567890abcdefghijklmnopqrstuv", //弊社からご案内したuidを転記
    target: "#TARGET", //INPUTタグに指定したidを記述
   gaType: "gtag", //Googleアナリティクスで測定（拡張eコマース機能を使用）
   deviceType: 'pc011'
  };
  (function() {
    var s = document.createElement("script");
    s.charset = "utf-8";
    s.src = "//poplink-f.probo.biz/pl3/poplink3.js";
    document.getElementsByTagName("head")[0].appendChild(s);
  })();
</script>

下記のようにGoogleアナリティクスに記述されます。Googleアナリティクス＞レポート＞イベントで確認いただけます。「上位のイベント」レポートなどをご覧ください。

「候補語サジェスト」の自動抽出

• サジェストされるキーワード（「候補語サジェスト」）は自動抽出されます。
  対象は「商品名」「商品説明」です。連携の優先度は、(1)商品名・(2) 商品説明の順です。
  
  ＜「商品名」として連携される管理画面項目（優先度順）＞
  1.運用＞商品管理＞商品新規登録・商品基本情報編集-外部連携用項目の設定［商品名（連携用）］
  2.運用＞商品管理＞商品情報（Google）-Googleデータフィード設定-基本項目［商品名（title）］
  3.運用＞商品管理＞商品新規登録・商品基本情報編集-商品基本情報編集［商品名］
  
  ＜「商品説明」として連携される管理画面項目（優先度順）＞
  1.運用＞商品管理＞商品新規登録・商品基本情報編集-外部連携用項目の設定［商品説明（連携用）］
  2.運用＞商品管理＞商品情報（Google）-Googleデータフィード設定-基本項目［商品説明（description）］
  3.［コマースクリエイターのみ］運用＞商品管理＞商品情報（コメント設定）-商品コメント(コマースクリエイター)［商品説明（大）］
  4.運用＞商品管理＞商品新規登録・商品基本情報編集-外部連携用項目の設定-商品名(連携用)
  5.運用＞商品管理＞商品情報（Google）-Googleデータフィード設定-基本項目［商品名］
  6.運用＞商品管理＞商品新規登録・商品基本情報編集-商品基本情報編集［商品名］


• キーワード（「候補語サジェスト」）として判断されるのは「日本語」のみです。
• キーワードの文字数は3文字から最大25文字になります。
• 半角英数字やハイフンなどの記号を含むキーワードには対応しておりません。
• 単語と単語の間にスペースを入れた検索（複数語）には対応しておりません。
• and検索/or検索（複数語）には対応しておりません。
• 商品名が長い場合、末尾が「…」に変換されます。
• 登場回数が1回しかない言葉は「候補語サジェスト」にならない場合がございます。
• 任意の「候補語サジェスト」を設定する機能はありません。「候補語サジェスト」の抽出については、サジェストリンクの解析システムが自動的に行います。
• 「候補語サジェスト」の抽出については、サジェストリンクの解析システムの改善により予期せず変更される場合があります。