本文へスキップ

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/バリューコマースの sidpid)が未入力でもボタンが出ます。その場合、リンク先は素の店舗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のままにしておくのが安全です。

価格が更新されません。

次の順に確認してください。

  1. アクセスが少ないサイトではありませんか。WP-Cronはページへのアクセスをきっかけに動くため、訪問がないと走りません。サーバーのcronで wp-cron.php を定期実行してください(設定例)。
  2. Yahoo!の商品ではありませんか。Yahoo!ショッピングはJANコードを持つ商品のみ自動更新されます。JANコードがない商品は、挿入時の価格を表示し続けます。
  3. その商品は最近表示されましたか。30日以内に表示があった商品だけが更新対象です(90日表示がないと登録解除されます)。
  4. 接続テストは通りますか。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 を発行してください。

Amazonの設定手順を見る →

楽天市場

症状対処
認証または許可ウェブサイトの確認に失敗するアプリケーションID・アクセスキー(pk_ 〜)・楽天ウェブサービスに登録した許可ウェブサイトの3点を確認します。許可ウェブサイトの登録漏れがいちばん多い原因です。
旧APIの終了に関するエラーが出るアクセスキーが未設定です。旧APIは2026年8月17日に終了しました。アクセスキーがないと楽天の検索・価格更新は動きません。楽天の設定手順にしたがって、新仕様のアプリを登録し直してください。
リクエスト上限に達した1秒以上おいて再試行してください。

楽天の設定手順を見る →

Yahoo!ショッピング

症状対処
認証または認可に失敗するデベロッパーネットワークで発行したClient IDと、アプリケーションの状態を確認してください。
一時的に利用が制限されている1秒以上おいて再試行してください。
成果がつかないバリューコマースの sid / pid が未入力か、桁違いの可能性があります。MyLinkコードから貼り直してください。

Yahoo!の設定手順を見る →

計測とプライバシー

クリック計測は何を記録していますか?

「どの記事の、どのモールのボタンが、いつ押されたか」だけです。個人を特定する情報は保存しません。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のバージョン・使っているエディタ・エラーメッセージを添えてご連絡いただけると助かります。