アフィリエイト商品表示・WordPressプラグイン
プログラマー班長アフィリエイト商品表示・WordPressプラグインは、
- Amazonの商品
- 楽天市場の商品
これら商品を、アフィリエイト対象の商品として表示します。
商品の指定は、キーワードで指定します。
当プラグインに関する状況
別のブログ(www.goods-memo.net)にて、アフィリエイト商品表示・WordPressプラグインを使用しています。
例えば投稿記事の記事下で、Amazonや楽天市場の商品を、アフィリエイト商品として表示しています。
アマゾンのPA-API v5について、動作確認しました。2023年7月当時。
別のブログにて、アマゾンの売上実績がない場合は、
アマゾンのPA-API v5に関する開発は、中止となります。PA-API v5が使用不可となるからです。
アフィリエイト商品表示・WordPressプラグイン
アフィリエイト商品を表示するWordPress用のプラグインです。
以下のアフィリエイトサービスを使って、商品を表示します。
- アマゾンの「Product Advertising API」。
- 楽天市場の「楽天市場商品検索API」。
表示する商品の指定は、キーワードで指定します。
当プラグインのソースコード
github.comサイト内で公開しています。
フリーソフトのように、自由にお使いください。
https://github.com/goods-memo/goods-memo-affiliate
当プラグインについて、開発環境、ローカルテストの環境
Visual Studio Code : IDE(統合開発環境)
https://azure.microsoft.com/ja-jp/products/visual-studio-code/
Visual Studio Codeの拡張機能 : PHP Debug
XAMPP : PHP 開発環境（PHP、Apache、MySQLなど）
https://www.apachefriends.org/jp/index.html
Xdebug : PHPの拡張機能、デバッグエンジン
https://xdebug.org/wizard
アフィリエイト商品表示・WordPressプラグインについて、ショートコードの属性
| ショートコードの属性名 | ショートコードの属性値 |
|---|---|
| service | アフィリエイトサービス名。 以下の文字列。 amazon rakuten |
| operation | 未作成。 |
| search_index | 未作成。 |
| keyword | 商品を検索するキーワード。 任意の文字列。 |
| number | 表示する商品数。 0以上の数値。 |
| item_title_length | 商品名の表示文字数。 0以上の数値。 |
| item_review_length | 商品説明の表示文字数。 0以上の数値。 |
アマゾンのアフィリエイト商品の表示について
アマゾンのアフィリエイト商品を表示する、ショートコードの例
[goodsmemo_affiliate service="amazon" keyword="SDカード" number="1"]- service属性：amazon
- keyword属性：SDカード
- number属性：1（商品の表示件数）
アマゾンのアフィリエイト商品の表示内容
以下のいずれかを表示します。
- Product Advertising API 利用不可の時、「表示するHTML」。
- Product Advertising API 利用できる時、「Product Advertising APIから取得した商品情報」。
Product Advertising API 利用不可の時、「表示するHTML」の例
アフィリエイト商品表示・WordPressプラグインの設定画面に、「表示するHTML」の設定項目があります。
- 当プラグインの「アフィリエイトの設定」
- アマゾンの設定
- Product Advertising API 利用不可の時、「表示するHTML」
- アマゾンの設定
ここで、任意のHTMLを設定します。
例えば、以下のように設定します。
例：アマゾンの検索結果・アフィリエイトリンクのaタグ
<a href="https://www.amazon.co.jp/s?k=GOODS_MEMO_ENCODED_SEARCH_KEYWORD& ... （省略）
&tag=GOODS_MEMO_ASSOCIATE_TAG& ...（省略）
&language=ja_JP&ref_=as_li_ss_tl">
「GOODS_MEMO_SEARCH_KEYWORD」の商品を検索する
</a>アマゾンのアフィリエイトで、売上実績がある場合
売上実績の発生がある場合は、PA-APIを利用して商品を表示します。
例：キーワードが「SDカード」の場合。
アマゾンのアフィリエイトで、売上実績がない場合
売上実績の発生がない場合は、PA-APIを利用できません。
例：発送済み商品売上が過去30日以内に発生していない場合など。
PA-APIのエラーの例：
HTTP Response: 503 Service Unavailable
You are submitting requests too quickly. Please retry your requests at a slower rate.
PA-APIを利用できない場合は（503エラーの場合は）、
Product Advertising API 利用不可の時、「表示するHTML」の項目に設定したHTMLを、自動的に表示します。
キーワードが「ダイエット サプリメント」の場合、「表示するHTML」の例
なお、アマゾンのアフィリエイトリンク経由で再び売上が発生した場合、
PA-APIを再び利用できる（PA-APIが復活する）可能性があります。
Product Advertising APIから、多くのリクエストを送信した場合
PA-APIから「HTTP 429 Too Many Requests レスポンスステータスコード」を通知された場合、
「売上実績がない場合」と同じ処理をします。
PA-APIのエラーの例：
Error Message: [429] Client error
Error Type: TooManyRequests
Error Message: The request was denied due to request throttling. Please verify the number of requests made per second to the Amazon Product Advertising API.
楽天のアフィリエイト商品の表示について
楽天のアフィリエイト商品を表示する、ショートコードの例
[goodsmemo_affiliate service="rakuten" keyword="SDカード" number="1"]- service属性：rakuten
- keyword属性：SDカード
- number属性：1（商品の表示件数）
楽天のアフィリエイト商品の表示内容
「楽天市場商品検索APIから取得した商品情報」を表示します。
例：キーワードが「SDカード」の場合。
アフィリエイト商品表示・WordPressプラグインについて、「管理画面」の「アフィリエイトの設定」
当プラグインの「アフィリエイトの設定」を表示するには、WordPress管理画面の以下のメニューを選択してください。
- WordPress管理画面
- 「設定」メニュー
- 「アフィリエイト商品表示（グッズ・メモランダム作成）」メニュー
- 「設定」メニュー
以上のメニューを選択後、「アフィリエイトの設定」が表示されます。
- アマゾンの設定
- 楽天の設定
これらの各項目を入力して、「変更を保存」ボタンを選択してください。
アフィリエイト商品表示・WordPressプラグインを、「新規追加」または「更新」した場合
当プラグインにおいて「新規追加」や「更新」をした際、
「管理画面」の「アフィリエイトの設定」において、「変更を保存」ボタンを選択してください。
ワードプレスのデータベースに対して、「設定の初期値」を書き込むためです。
「アフィリエイトの設定」の「アマゾンの設定」
「アマゾンの設定」の設定項目
| アマゾンの設定項目 | アマゾンの設定値 |
|---|---|
| Product Advertising API ホスト | 入力例 webservices.amazon.co.jp |
| Product Advertising API アクセスキー | あなたのアクセスキー |
| Product Advertising API アソシエイトタグ | あなたのアソシエイトタグ |
| Product Advertising API シークレットキー | あなたのシークレットキー |
| Product Advertising API リージョン | 入力例 us-west-2 |
| 商品名の表示文字数（目安の文字数） | 入力例 80 |
| 商品情報のキャッシュ時間（秒） | 入力例 86400。 0の場合、キャッシュを無効にします（キャッシュを使いません）。 |
| 商品説明の表示文字数（目安の文字数） | 入力例 120 |
| 商品説明から削除する文字列のJSON配列（空の配列[]） | 入力例 ["＜p＞","＜/p＞","＜b＞","＜br /＞"] 全角の＜＞を用いたタグを削除します。 |
| 商品説明で改行する文字列のJSONオブジェクト（空のオブジェクト{}） | 入力例{"●":"<br>●","■":"<br>■","◆":"<br>◆","★":"<br>★","【":"<br>【","。":"。<br>"}探す文字列が連続している場合、最後の探す文字列だけ、置き換えます。 探す文字列が●、置き換える文字列が<br>●の場合、 ●●●については、 ●●<br>●と置き換えます。 |
| アダルト商品（ItemInfo の ProductInfo の IsAdultProductで判断） | アダルト商品を表示する場合にチェックを入れます。 |
| SearchItems の Resources Parameter（開発用：JSON配列。空の配列[]） | 通常、初期値のままで良いです。 入力例： [ "Images.Primary.Large", "Images.Primary.Medium", "Images.Primary.Small", "ItemInfo.ByLineInfo", "ItemInfo.Classifications", "ItemInfo.Features", "ItemInfo.ProductInfo", "ItemInfo.Title", "Offers.Listings.MerchantInfo", "Offers.Listings.Price", "Offers.Summaries.LowestPrice" ] |
| Product Advertising API 利用不可の時、「表示するHTML」 | 例えば、アマゾンのアフィリエイトリンクのaタグを入力します。 以下の予約された文字列は、アソシエイトタグなどに置換されます。 GOODS_MEMO_ASSOCIATE_TAG：「アソシエイトタグ」に置換されます。 GOODS_MEMO_SEARCH_KEYWORD：「キーワード」に置換されます。 GOODS_MEMO_ENCODED_SEARCH_KEYWORD：「URLエンコードされたキーワード」に置換されます。 |
| 「表示するHTML」の表示設定 | 常に表示する場合、チェックを入れます。 チェックを入れた場合、PA-APIの「エラー有る無し」に関係なく、常に「表示するHTML」を表示します。 |
「アフィリエイトの設定」の「楽天の設定」
「楽天の設定」の設定項目
| 楽天の設定項目 | 楽天の設定値 |
|---|---|
| 楽天市場商品検索API ホスト名 | 入力例 app.rakuten.co.jp |
| 楽天市場商品検索API リクエストURLのパス | 入力例 services/api/IchibaItem/Search/20220601 |
| 楽天アプリID/デベロッパーID | あなたの楽天アプリID または、あなたのデベロッパーID |
| 楽天アフィリエイトID | あなたの楽天アフィリエイトID |
| 商品名の表示文字数（目安の文字数） | 入力例 80 |
| 商品情報のキャッシュ時間（秒） | 入力例 86400。 0の場合、キャッシュを無効にします（キャッシュを使いません）。 |
| 商品説明の表示文字数（目安の文字数） | 入力例 120 |
| 商品説明から削除する文字列のJSON配列（空の配列[]） | 入力例 ["＜p＞","＜/p＞","＜b＞","＜br /＞"] 全角の＜＞を用いたタグを削除します。 |
| 商品説明で改行する文字列のJSONオブジェクト（空のオブジェクト{}） | 入力例{"●":"<br>●","■":"<br>■","◆":"<br>◆","★":"<br>★","【":"<br>【","。":"。<br>"}探す文字列が連続している場合、最後の探す文字列だけ、置き換えます。 探す文字列が●、置き換える文字列が<br>●の場合、 ●●●については、 ●●<br>●と置き換えます。 |
【まとめ記事】へのリンク
【まとめ記事】アマゾンの商品を表示する場合、「アフィリエイト商品表示・WordPressプラグイン」のPHPソースコード解説
「アフィリエイト商品表示・WordPressプラグイン」を用いて、アマゾンの商品を表示する処理について、PHPソースコードを解説しています。
ちょっとためになる、自作プログラムのソースコード解説 
【まとめ記事】楽天市場の商品を表示する場合、「アフィリエイト商品表示・WordPressプラグイン」のPHPソースコード解説
「アフィリエイト商品表示・WordPressプラグイン」を用いて、楽天市場の商品を表示する処理について、PHPソースコードを解説しています。