FAQ・トラブルシューティング
よくある質問と、接続テストのエラー別の対処方法です。ここになければ、ブログのお問い合わせからご連絡ください。
基本的なこと
無料で使えますか?
はい。ぷくリンクは無料で、GPLv2 or later のもとで配布しています。機能制限版ではなく、このサイトで紹介している機能はすべて使えます。
どこからインストールできますか?
WordPress管理画面の「プラグイン > 新規追加」でPukulink と検索してインストールできます。WordPress.org公式ディレクトリで配布しているので、更新も管理画面から通知されます。ZIPを直接入れたい場合はダウンロードページからどうぞ。
「ぷくリンク」と日本語で検索しても見つかりません。公式ディレクトリの検索は英語の情報をもとにしているため、英字の「Pukulink」で検索してください。
表示を日本語にしたい/英語にしたい。
ぷくリンクの表示言語は、WordPressの「設定 > 一般 > サイトの言語」に従います。日本語にすれば管理画面も公開ページの商品カード(「Amazon価格:」「口コミを見る」などの文言)も日本語になり、English にすれば英語になります。
翻訳は WordPress の翻訳プラットフォーム(translate.wordpress.org)から配布されます。翻訳が更新されたときは、管理画面の「更新」ページで翻訳の更新が案内されることがあります。
ボタンの文言(「Amazonで見る」など)だけは、翻訳とは別に「設定 > ぷくリンク > 表示・デザイン」で自由に変更できます。
ブロックエディタだけでも使えますか?
使えます。ブロック一覧の「+」から、または /ぷくリンク と入力してブロックを追加してください。「商品リンク」でも検索できます。クラシックエディタ対応を強みにしていますが、ブロックエディタを切り捨てているわけではありません。
3モールすべてのAPIを設定しないと使えませんか?
いいえ。楽天だけ、Yahoo!だけでも動きます。設定していないモールのボタンは表示されません。まず1つだけ試すなら、審査なしで即日Client IDが出るYahoo!ショッピングが始めやすいです。
ボタンは出るのに成果がつきません。
アフィリエイトIDの入れ忘れがいちばん多い原因です。楽天市場・Yahoo!ショッピングは、APIのIDだけでも商品検索とカード表示ができてしまうため、アフィリエイトID(楽天アフィリエイトID/バリューコマースの sid・pid)が未入力でもボタンが出ます。その場合、リンク先は素の店舗URLになり成果になりません。
v2.6.5以降は、この状態を設定画面で警告します。「設定 > ぷくリンク > API設定」タブで、有効にしたモールのアフィリエイトIDが入っているか確認してください。
他の商品リンクプラグインから乗り換えられますか?
記事に入っている他プラグインのショートコードを、ぷくリンクが自動で読み替えることはしていません。乗り換える場合は、ぷくリンクで改めて商品を検索して挿入してください。商品コードの取り違えを避けるための判断です。
スマホの管理画面からも使えますか?
使えます。検索モーダルはスマホでは全画面表示になり、そのまま検索して挿入できます。
やめるとき・引っ越すとき
プラグインを無効化したら、記事はどうなりますか?
ショートコードがそのまま文字として表示されます。表示だけでも残したい場合は、テーマの functions.php に次を追加すると、最低限のテキストリンクとして表示され続けます。
// ぷくリンク停止後も [pukulink] を最低限のリンクとして表示する
add_shortcode( 'pukulink', function ( $atts ) {
$a = shortcode_atts( array( 't' => '', 'rurl' => '', 'yurl' => '', 'asin' => '' ), $atts, 'pukulink' );
$url = $a['rurl'] ? $a['rurl'] : ( $a['yurl'] ? $a['yurl'] : ( $a['asin'] ? 'https://www.amazon.co.jp/dp/' . rawurlencode( $a['asin'] ) : '' ) );
if ( '' === $url || '' === $a['t'] ) {
return esc_html( $a['t'] );
}
return '<a href="' . esc_url( $url ) . '" target="_blank" rel="nofollow noopener">' . esc_html( $a['t'] ) . '</a>';
} );
add_shortcode( 'pukulink_draft', '__return_empty_string' );
記事の中には何が保存されていますか?
ショートコードだけです。中身は商品名・商品コード(ASIN / 楽天itemCode / JANコード)・素の商品URL・価格・取得日などで、プラグイン固有のHTMLやアフィリエイトIDは記事に保存されません。
[pukulink shop="rakuten" t="商品名" kw="検索リンク用キーワード" img="https://..." pr="1980"
rate="4.5" rv="12" rcode="shop:10000001" rurl="https://item.rakuten.co.jp/..."
tp="standard" amz="1" rk="1" yh="1" pr_show="0" d="2026-07-07"]
カードごとの上書きをしたときだけ付く属性もあります。
pr_show… 価格表示(1=表示する/0=表示しない。指定なしはサイト設定に従う)imgs… 商品画像ギャラリーの追加画像URL(|区切り、最大4件)gallery_show… ギャラリー表示(1=常に表示/0=常に非表示。指定なしはサイト設定に従う)
アフィリエイトIDでのリンク組み立ては表示のたびに行うため、IDやデザインを変更すると全記事に一括で反映されます。
データをバックアップ・持ち出しできますか?
「レポート」タブのエクスポートから、設定・商品台帳・挿入履歴・クリック集計・価格履歴をJSONで保存できます。Secret Key等の秘密鍵は含まれません。
価格の更新について
価格はいつ更新されますか?
WP-Cronが毎時実行され、直近30日以内に表示された商品のうち、設定したキャッシュ時間(既定24時間)を過ぎたものを少しずつ更新します。各APIのレート制限(おおむね1リクエスト/秒)を守るため、一度に全部は取りに行きません。
価格を表示したくないのですが、消せますか?
消せます。方法は2つあります。
- サイト全体: 「表示・デザイン」タブの「価格表示」で、「価格を表示する」「価格の取得日を表示する」「注記を表示する」の3つを個別にオフにできます。設定は保存済みの全記事に一括で反映されるので、記事を貼り直す必要はありません。
- カード1枚ごと: 挿入プレビューの「価格表示」で「設定に従う/表示する/表示しない」を選べます。全体設定と逆の扱いにしたいカードだけ上書きできます。
非表示にしても価格の取得・自動更新・構造化データには影響しません。あとから「表示する」に戻せば、最新の価格が出ます。
なお、Amazon商品を価格つきで掲載する場合は、アソシエイト・プログラム運営規約の観点からも取得日の表示をONのままにしておくのが安全です。
価格が更新されません。
次の順に確認してください。
- アクセスが少ないサイトではありませんか。WP-Cronはページへのアクセスをきっかけに動くため、訪問がないと走りません。サーバーのcronで
wp-cron.phpを定期実行してください(設定例)。 - Yahoo!の商品ではありませんか。Yahoo!ショッピングはJANコードを持つ商品のみ自動更新されます。JANコードがない商品は、挿入時の価格を表示し続けます。
- その商品は最近表示されましたか。30日以内に表示があった商品だけが更新対象です(90日表示がないと登録解除されます)。
- 接続テストは通りますか。APIの認証が切れていると更新できません。
価格が取得できなくなった商品を探せますか?
「レポート」タブの「商品の健全性」で一覧できます。販売終了の可能性がある商品を確認し、その商品を使っている記事をワンクリックで検索できます。
接続テストのエラー
Amazon
| 症状 | 対処 |
|---|---|
| 認証に失敗する | Client ID / Client Secret の前後に空白が入っていないか確認します。資格情報バージョン(3.3 / 2.3)が実際の発行内容と合っているかも確認してください。 |
| 利用資格がないと表示される | アソシエイト・セントラルで現在の利用資格を確認してください。この状態でも、キーワード入りのAmazon検索リンクとしては挿入できます。6時間ごとに自動再試行されます。 |
| 旧PA-APIのキーを入れている | PA-API v5 は2026年5月15日に廃止済みです。Access Key / Secret Key は使えません。Creators API の Client ID / Client Secret を発行してください。 |
楽天市場
| 症状 | 対処 |
|---|---|
| 認証または許可ウェブサイトの確認に失敗する | アプリケーションID・アクセスキー(pk_ 〜)・楽天ウェブサービスに登録した許可ウェブサイトの3点を確認します。許可ウェブサイトの登録漏れがいちばん多い原因です。 |
| 旧APIの終了に関するエラーが出る | アクセスキーが未設定です。旧APIは2026年8月17日に終了しました。アクセスキーがないと楽天の検索・価格更新は動きません。楽天の設定手順にしたがって、新仕様のアプリを登録し直してください。 |
| リクエスト上限に達した | 1秒以上おいて再試行してください。 |
Yahoo!ショッピング
| 症状 | 対処 |
|---|---|
| 認証または認可に失敗する | デベロッパーネットワークで発行したClient IDと、アプリケーションの状態を確認してください。 |
| 一時的に利用が制限されている | 1秒以上おいて再試行してください。 |
| 成果がつかない | バリューコマースの sid / pid が未入力か、桁違いの可能性があります。MyLinkコードから貼り直してください。 |
計測とプライバシー
クリック計測は何を記録していますか?
「どの記事の、どのモールのボタンが、いつ押されたか」だけです。個人を特定する情報は保存しません。Google Analytics(gtag)へのイベント送信を有効にした場合は、そのイベントがGAに送られます。詳しくはプライバシーポリシーをご覧ください。
APIキーが開発者に送信されることはありますか?
ありません。Client Secret等の認証情報を、プラグイン開発者が運営するサーバーや各サービス以外の送信先へ送ることはしていません。通信先はすべてプライバシーポリシーに開示しています。
既知の制限
モール別・テンプレート別の対応表は機能紹介ページの「できること・できないこと」にまとめています。ここでは運用上つまずきやすいものを挙げます。
モールによる差
- Amazonの商品検索には利用資格が必要です。2025年11月に条件が厳格化され、直近30日で10件以上の適格販売が目安とされています。登録したばかりの段階では検索が使えない可能性が高く、その場合Amazonボタンは検索リンクになります。
- Amazonの商品検索には、Creators API の Client ID / Client Secret とアソシエイトIDの3つが必要です。アソシエイトID(もしも経由なら
a_id)が未設定の場合は、Amazonボタン自体が表示されません。 - Amazonは★評価・レビュー件数が出ません。Creators APIが返さないためです(「口コミを見る」リンクは出ます)。逆に楽天・Yahoo!は★評価が出ますが口コミリンクはありません。
- Yahoo!ショッピングの価格自動更新は、JANコードを持つ商品のみが対象です。ない場合は挿入時の価格を表示し続けます。
- Yahoo!ショッピングは商品画像ギャラリーに非対応です(APIが複数画像を返さないため)。
- 推しショップ(店舗指定検索)は楽天市場・Yahoo!のみです。Amazonには店舗の概念がないため対応していません。
計測・レポート
- クリック計測は厳密な数字ではありません。同じ回線・記事・モールの連続クリックは1分に1回、対象は公開済み記事のみ、JavaScriptが動く環境が必要です。
- レポートは今月と先月の2か月分、各月の上位50行までです。
- 価格の履歴は記録していますが、表示する画面はまだありません(将来の価格推移グラフ用のデータ収集です)。
- 挿入履歴は最近の50件までです。
その他
- 各APIにはレート制限(おおむね1リクエスト/秒)があるため、価格更新は毎時少しずつ行われます。
- アクセスが少ないサイトではWP-Cronが動きにくく、価格更新が遅れることがあります。
- プラグインを無効化すると、ショートコードがそのまま表示されます。
- クラシックエディタで使う場合は Classic Editor プラグインが必要です(WordPress本体からは外れています)。
- マルチサイト環境での動作は検証していません。
- v2.0.0は旧版との互換コードを持たない独立したプラグインです。旧版の記事カード・設定・履歴・クリック集計は引き継がれません。
解決しましたか?
ここに載っていない不具合を見つけたら、WordPressのバージョン・PHPのバージョン・使っているエディタ・エラーメッセージを添えてご連絡いただけると助かります。