機能紹介

検索して挿入するまでの流れ

投稿編集画面の「ぷくリンクを追加」ボタン（クラシックエディタ）、またはブロック「ぷくリンク」（ブロックエディタ）から、同じ検索モーダルが開きます。ここから先の操作は、どちらのエディタでもまったく同じです。

1. 検索する。キーワードを入れて、Amazon・楽天市場・Yahoo!ショッピングのタブを切り替えて探します。楽天とYahoo!は、登録した推しショップだけに絞り込むこともできます。
2. プレビューで確認する。テンプレートを選び、PC・タブレット・スマホの見え方を切り替えて確認できます。各モールのボタンから、実際の商品ページや検索結果を開いて確かめることもできます。
3. 挿入する。記事にはショートコードが入ります。挿入後は結果一覧に戻るので、そのまま次の商品を続けて貼れます。

価格の自動更新と取得日表示

価格は商品コードをキーに、WP-Cronで毎時少しずつ更新されます（既定は24時間キャッシュ）。各モールのAPIにはおおむね1リクエスト／秒のレート制限があるため、一気にではなく分散して取りに行きます。

カードには「楽天市場価格: 43,500円(2026/7/30時点)」のように取得元のモール名と取得日が入ります。いつの価格なのかを読者に伝えられるので、価格が動いても誤解されにくくなります。

価格を表示しない選択もできます

価格の表示は必須ではありません。サイト全体の既定と、カード1枚ごとの上書きの2段構えで決められます。

サイト全体の既定

「表示・デザイン」タブの「価格表示」で、次の3つを個別にオン／オフできます（すべて既定ON）。

価格を出したくない理由はいろいろあります。値動きの激しい商品を扱っている、記事を長く読ませたい、カードを軽く見せたい——どの場合も、設定を変えれば保存済みの全記事に一括で反映されます。記事を貼り直す必要はありません。

カード1枚ごとの上書き

挿入プレビューの「価格表示」から、そのカードだけの扱いを選べます。

「基本は価格を出すが、値動きが激しいこの商品だけは隠す」「価格は普段出さないが、比較記事のこの1枚だけは出す」といった使い分けができます。非表示にしても価格の取得・自動更新・構造化データには影響しません。あとから「表示する」に切り替えれば、最新の価格が出ます。

なお、テキストリンクと比較表用ボタンはそもそも価格を表示しないテンプレートなので、この欄は出ません。

あわせて「口コミ・レビュー」の設定で、★評価と口コミリンクの表示もオン／オフできます。なお★評価が出るのは楽天市場・Yahoo!ショッピングの商品だけで、AmazonはCreators APIがレビュー点数を返さないため「口コミを見る」リンクのみになります（モール別の対応表）。

商品レジストリと健全性チェック

表示された商品は「商品レジストリ」に登録され、直近30日以内に表示があった商品だけが更新対象になります（90日表示がないと登録解除）。使われていない商品のためにAPIを叩き続けることはありません。

また、価格を取得できなくなった商品（販売終了の可能性があるもの）はレポート画面に一覧され、その商品を使っている記事をワンクリックで検索できます。

商品画像ギャラリー

商品に複数の写真があるとき、カードの画像をスワイプで切り替えられます。角度違いや付属品の写真を見せたい商品に向いています。既定はOFFで、使いたいときだけ有効にする機能です。

使える条件

便利な代わりに条件が多い機能です。先に確認してください。

2段階のオプトイン

記事本文が無駄に大きくならないよう、使う商品を自分で選ぶ形にしています。

1. 「表示・デザイン」タブの「商品画像ギャラリー」をONにする（サイト全体の既定。初期値はOFF）。
2. 挿入プレビューで「スワイプ表示用に追加画像を含める」にチェックする（追加画像がある商品のときだけ出ます）。チェックした商品だけ、追加画像のURLが記事に保存されます。

さらに価格表示と同じように、カードごとに「サイト設定に従う／常に表示／常に非表示」で上書きできます。サイト全体はOFFのままこの商品だけ試す、全体はONでもこの商品だけ外す、という使い方ができます。

できないこと

• 画像をタップしての拡大表示（ライトボックス）はありません。各画像は商品ページへのリンクです。
• サムネイル一覧、自動再生（スライドショー）はありません。
• 画像ごとに別のリンク先を設定することはできません。すべて同じ商品ページに飛びます。
• Amazonの追加画像は、APIの返し方によっては取得できないことがあります。その場合は代表画像1枚だけの従来表示になります。
• 左右の矢印はJavaScriptで表示しています。JavaScriptが無効な環境では矢印は出ませんが、スワイプとキーボード操作は使えます。

クラシックとブロック、両方に

ぷくリンクはクラシックエディタ対応を強みとする両エディタ対応です。どちらか一方を切り捨てません。記事に保存される内容もどちらも同じ [pukulink ...] ショートコードなので、あとからエディタを変えても記事は壊れません。

クラシックエディタ

• エディタ上部のメディアボタン行に、ぷくおアイコン付きの「ぷくリンクを追加」ボタンが出ます。
• ビジュアルタブでは、ショートコードのままではなく商品情報カードのプレースホルダーとして表示されます（設定でショートコード表示にも切り替え可）。どのテンプレートで表示されるかもプレースホルダーに出ます。
• ビジュアル／テキストのどちらのモードでも、PC・スマホのどちらからでも使えます。

ブロックエディタ

• ブロック一覧の「＋」から、または /ぷくリンク と入力してブロック「ぷくリンク」を追加します（「商品リンク」でも検索できます）。
• 任意のブロックを選択したときのツールバーにあるぷくおアイコンからも、同じ検索モーダルが開きます。
• 挿入すると「ぷくリンクカード」ブロックとして入り、編集画面でも実際のカードの見た目で表示されます。ツールバーの「カードを編集(商品・紐づけの変更)」から選び直すこともできます。

AIマーカー（クラシックエディタのビジュアルタブ）

AIに書かせた下書きに [pukulink_draft keyword="商品名"] を埋めておくと、クラシックエディタのビジュアルタブでマーカー表示になります。鉛筆ボタンを押して検索済みの結果から選ぶだけで、商品カードに置き換わります。マーカーが残ったまま公開しても、読者には表示されません。AIに渡す指示文の例は、設定画面の「使い方」タブに載せています。

マーカーが記事に複数あるときは、1件確定すると自動で次のマーカーの検索へ進みます。「AIマーカー: 2/5件」のように進捗が出て、いま扱わないものは「このマーカーはスキップ」で飛ばせます（スキップしたマーカーは本文に残るので、あとで処理できます）。商品の選択と挿入の確定はマーカーごとにあなたが行い、まとめて自動挿入されることはありません。

クリック計測とレポート

カードのボタンが押された回数を、モール別に記録します。設定画面の「レポート」タブで、今月と先月の2か月分を「記事×モール×クリック数」の形で確認できます（各月の上位50行まで）。長期の推移を見たい場合は、Google Analytics（gtag）へのイベント送信に対応しているので、そちらで追えます。

記録するのは「どの記事の、どのモールのボタンが、いつ押されたか」だけです。個人を特定する情報は保存しません。詳しくはプライバシーポリシーをご覧ください。

商品の健全性

価格を取得できなくなった商品は、販売終了の可能性があります。レポート画面でその一覧を確認でき、該当商品を使っている記事をワンクリックで検索できます。古いままの商品リンクを見つけて直すための機能です。

できること・できないこと

3モールに対応していますが、各モールのAPIで取れる情報が違うため、できることも違います。あとで「思っていたのと違う」とならないよう、先に表で示します。

モール別の対応

Amazonに★評価が出ないのは、Creators APIがレビュー点数を返さないためです。代わりに「口コミを見る」リンクでAmazonのレビューページへ送れます。逆に楽天・Yahoo!は★評価は出ますが、口コミページへのリンクはありません。

なお★評価と口コミリンクは、最初に選んだモール（メイン）の商品を元に表示されます。つまりAmazonをメインにしたカードは「口コミを見る」リンクのみ、楽天やYahoo!をメインにしたカードは★評価のみになります（Amazonを紐づけただけでは口コミリンクは出ません）。★評価を見せたい商品は楽天かYahoo!から探して挿入するのがコツです。

Yahoo!ショッピングは3モールの中でいちばん制約が多く、JANコードのない商品は挿入時の価格を表示し続けます（ハンドメイド品やセット販売などで起こります）。ギャラリーも使えません。

テンプレート別の対応

エディタによる違い

商品の検索・挿入・編集は、クラシックエディタでもブロックエディタでも同じようにできます。違うのは次の2点だけです。

• AIマーカーはクラシックエディタのビジュアルタブ専用です。ブロックエディタでは [pukulink_draft] のマーカー表示・鉛筆ボタンからの確定が使えません（テキストタブでも使えません）。
• 「編集画面での商品リンク表示」の切り替えはクラシックエディタ専用です。ブロックエディタは常にカード表示になります。

意図的に入れていない機能

「作れるけれど、あえて作っていない」ものもあります。理由も一緒に書きます。

運用面で知っておいてほしいこと

• クリック計測は厳密な数字ではありません。同じ回線・同じ記事・同じモールの連続クリックは1分に1回だけ数えます。公開済みの記事のみが対象で、JavaScriptが動く環境が必要です。おおまかな傾向をつかむための機能と考えてください。
• レポートは今月と先月の2か月分、各月の上位50行までです。長期の推移はGoogle Analytics側で追ってください。
• 価格の履歴は日々記録していますが、表示する画面はまだありません。将来の価格推移グラフに向けたデータ収集です。
• 商品の健全性レポートは各項目20件までの表示です。
• 挿入履歴は最近の50件までです。それより前の商品は検索し直してください。
• 紐づけは1モールにつき1商品までです。