=== affilun === Contributors: rioriost Tags: affiliate, product links, product card, amazon, rakuten Requires at least: 6.6 Tested up to: 7.0 Requires PHP: 8.1 Stable tag: 0.7.9 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Amazon、楽天市場、Yahoo!ショッピング、メルカリ向けの商品リンクと商品カードを管理する、日本語サイト向けのアフィリエイト支援プラグインです。 == Description == affilun（あふぃるん）は、日本のアフィリエイト運用で使われる Amazon アソシエイト、楽天市場、Yahoo!ショッピング、メルカリなどの商品リンクを WordPress 内で管理し、投稿に再利用できる商品カードとして表示するためのプラグインです。 プラグイン本体のローカル機能は、ライセンスキー、無料トライアル、有料プラン、利用クォータなしで利用できます。商品データの保存、商品カードの表示、各プロバイダー設定、基本的なリンク生成は WordPress 内で動作します。 任意で affilun Cloud を設定すると、AI支援、記事下書き生成、リンクヘルスチェック、キャンペーン候補、売れ筋アフィリエイト候補、プラン確認などのマネージド機能を利用できます。これらの Cloud 機能は外部 SaaS として提供され、処理は affilun Cloud サーバー上で行われます。 = 主な機能 = * アフィリエイト用の商品レコードを WordPress 内に保存・管理。 * Gutenberg ブロックまたはショートコードで商品カードを表示。 * Amazon、楽天市場、Yahoo!ショッピング、メルカリ、ASP ルーティングテンプレートの設定。 * 保存済み ASIN がある場合、Amazon Partner Tag 付きの標準商品詳細ページリンクを生成。 * ボタンラベル、表示テンプレート、リンク属性、プロバイダー別の表示設定を WordPress 内に保存。 * 任意の affilun Cloud API キーと対象プランを設定した場合のみ Cloud 機能を利用。 = affilun Cloud との境界 = WordPress.org で配布されるこのプラグインは GPL ライセンスの WordPress プラグインです。ローカルの商品管理、商品カード表示、保存済み設定、基本的なリンク生成は WordPress 内で動作します。 affilun Cloud は任意の外部 SaaS です。Cloud 機能には、有料プラン、利用量制限、プラン確認、Stripe Checkout、Cloud API キー発行、AI支援、記事下書き生成、リンクヘルスチェック、キャンペーン候補、売れ筋アフィリエイト候補などが含まれる場合があります。Cloud 機能を利用しない場合でも、ローカル機能は利用できます。 affilun Cloud のサーバー実装、課金システム、ホストされた処理、外部 API 中継サービスは、このプラグイン配布物には含まれません。Cloud の利用規約、料金、データ保持、削除に関する情報は https://affilun.st/ を確認してください。 == Installation == 1. WordPress 管理画面の「プラグイン」からインストールするか、プラグインファイルを `/wp-content/plugins/affilun/` にアップロードします。 2. WordPress 管理画面で affilun を有効化します。 3. affilun の設定画面を開きます。 4. 利用したいプロバイダーと任意サービスだけを設定します。 5. ブロックエディターで affilun 商品カードブロックを追加し、保存済み商品を選択して公開します。 == Frequently Asked Questions == = WooCommerce は必要ですか？ = いいえ。affilun はアフィリエイト商品リンク用のプラグインであり、WooCommerce は不要です。 = affilun Cloud は必須ですか？ = いいえ。商品管理、商品カード表示、プロバイダー設定、基本的なリンク生成は WordPress 内で動作します。affilun Cloud は任意で、AI支援、記事下書き生成、リンクヘルスチェック、キャンペーン候補、売れ筋アフィリエイト候補、プラン確認などの Cloud 機能を使う場合だけ設定します。 = 投稿本文や商品データは AI サービスへ送信されますか？ = affilun Cloud が設定され、かつ Cloud AI 機能を実行した場合に限り、選択した処理に必要な投稿本文の抜粋や商品コンテキストが affilun Cloud の AI 関連エンドポイントへ送信されます。Cloud AI 機能を設定・利用しない場合、このプラグインが投稿本文や商品コンテキストを affilun Cloud AI エンドポイントへ送信することはありません。 AI の出力は提案であり、公開前にサイト運営者が内容、正確性、各アフィリエイトプログラムの規約、法令上の表示要件を確認してください。 = Amazon API の利用資格がなくても Amazon リンクを使えますか？ = はい。保存済み Amazon ASIN がある場合、設定済み Partner Tag を `tag=` として付与した標準の商品詳細ページ URL を生成できます。商品検索や詳細な商品データ取得には、対応する Amazon API の利用資格が必要です。 = 訪問者をトラッキングしますか？ = affilun は、保存済み商品カードの表示・クリックに関するローカルのクリックイベントと日次集計を WordPress データベースに保存する場合があります。これらはサイト自身の管理・レポート用途です。 ローカルクリックイベントには、プロバイダー、ボタンキー、対象 URL のハッシュ、商品 ID、投稿 ID、表示バリアント、ユーザーエージェントのハッシュ、参照元ホスト、日時などが含まれる場合があります。日次集計は、日付やカード・リンク単位の集計クリック数を保存します。 affilun は訪問者のクリックデータを affilun Cloud や外部アクセス解析サービスへ送信しません。商品カード、ローカルクリックレポート、任意の Cloud 機能を使う前に、サイトのプライバシーポリシーと適用法令を確認してください。 商品カードは、保存済みの商品画像 URL を表示する場合があります。プロバイダーや保存済みデータによっては、訪問者のブラウザーが外部プロバイダーまたは CDN ドメイン（例: メルカリアンバサダー画像 URL）へ画像リクエストを送信し、IP アドレス、ユーザーエージェント、リファラーなどが当該外部サービスに伝わる可能性があります。 = ドキュメントやサポート情報はどこにありますか？ = ドキュメント、サポート情報、利用規約、プライバシー情報は https://affilun.st/ で提供しています。 == External Services == affilun は、関連機能が設定され実行された場合に限り、外部サービスと通信します。各プロバイダーを有効化する前に、当該サービスの規約、プライバシーポリシー、アフィリエイトプログラム規約を確認してください。affilun が対応する主なプロバイダーは日本向けサービスです。 = Amazon Creators API / Amazon アソシエイト = 目的: Amazon 商品検索、商品データ取得、Partner Tag 付きリンク生成。 有効化して利用した場合に送信されるデータ: 検索キーワード、ASIN、マーケットプレイス、Creators API 認証情報、Partner Tag。 規約: https://affiliate-program.amazon.com/help/operating/agreement プライバシー: https://www.amazon.com/gp/help/customer/display.html?nodeId=468496 = 楽天市場 API = 目的: 楽天市場の商品検索、商品データ取得、アフィリエイトリンク生成。 有効化して利用した場合に送信されるデータ: 検索キーワード、商品 ID、Application ID、Affiliate ID。 規約: https://webservice.rakuten.co.jp/guide/rule プライバシー: https://privacy.rakuten.co.jp/ = Yahoo!ショッピング API と ValueCommerce ルーティング情報 = 目的: Yahoo!ショッピングの商品検索、商品データ取得、リンク生成。 有効化して利用した場合に送信されるデータ: 検索キーワード、商品 ID、Client ID、Yahoo!ショッピング関連設定。ValueCommerce の自由テキストリンク HTML スニペットを設定した場合、affilun はリンク生成に必要な sid / pid のみを抽出して保存します。 Yahoo! JAPAN Developer Network ガイドライン: https://developer.yahoo.co.jp/guideline/ LINEヤフー株式会社利用規約: https://www.lycorp.co.jp/ja/company/terms/ LINEヤフー株式会社プライバシーポリシー: https://www.lycorp.co.jp/ja/company/privacypolicy/ ValueCommerce 利用規約: https://www.valuecommerce.ne.jp/st_affiliate/terms.html ValueCommerce プライバシーポリシー: https://www.valuecommerce.co.jp/privacy_policy/ = メルカリ = 目的: メルカリアンバサダー `afid` を設定したメルカリ検索リンクまたは商品リンクの生成。 有効化して利用した場合に送信されるデータ: 検索キーワード、メルカリ URL、`afid`。 訪問者側のブラウザーリクエスト: 保存済みメルカリ商品の主画像 URL がない場合、商品カードが `ambassador-system.mercari.com` 上のメルカリアンバサダー画像 URL を読み込むことがあります。 規約: https://static.jp.mercari.com/tos プライバシー: https://static.jp.mercari.com/privacy = affilun Cloud = 目的: AI支援、商品キーワード正規化、記事下書き生成、キャンペーン候補、収益機会候補、売れ筋アフィリエイト候補、リンクヘルスチェック、プラン確認、Cloud API キー検証、利用状況取得などの任意 SaaS 機能。 サービスエンドポイント: affilun Cloud は `https://api.affilun.st/api/v1` を使用します。古い保存設定に `https://cbl.rio.st` または `https://cbl.rio.st/api/v1` が含まれる場合、プラグインはそれらの旧エイリアスを affilun Cloud 本番エンドポイントへ正規化します。 設定して利用した場合に送信されるデータ: サイト URL、サイト名、管理者メールアドレス、Cloud API キー、選択プランのコンテキスト、有効化されたアフィリエイトプロバイダーキー、選択した処理に必要な投稿抜粋または本文の一部、商品リンクメタデータ、レビュー元 URL、リンクヘルス入力。 Free 状態は接続確認用です。Cloud AI、記事下書き、リンクヘルス、収益機会、売れ筋アフィリエイト候補などのマネージド機能は affilun Cloud サーバー上で実行されるため、有料プランまたは Stripe トライアル中のプランが必要です。売れ筋アフィリエイト候補の取得は、サイトの月次 Cloud 利用クォータを消費しません。 利用規約: https://affilun.st/cloud-subscription-terms/ プライバシー: https://affilun.st/privacy/ = Stripe Checkout = 目的: affilun Cloud プランの支払いフロー。 管理者が checkout を開始した場合に送信されるデータ: メールアドレス、サイト情報、選択プラン、checkout session 情報。 規約: https://stripe.com/legal/ssa プライバシー: https://stripe.com/privacy = 外部の商品画像 = 商品カードと管理画面プレビューは、WordPress に保存された商品画像 URL を表示する場合があります。これらの URL は、プロバイダー、マーケットプレイス、アフィリエイトネットワーク、CDN などのドメインを指すことがあります。該当画像を含むページが閲覧されると、訪問者のブラウザーは外部ドメインへ画像をリクエストし、IP アドレス、ユーザーエージェント、リファラーなどのリクエスト情報が外部サービスへ送信される可能性があります。 = WordPress 内に保存されるデータ = affilun は以下のデータを WordPress データベースに保存する場合があります。 * プロバイダー設定: Amazon 認証情報、Partner Tag、楽天認証情報、Yahoo!認証情報、メルカリ `afid`、有効/無効状態。 * 商品レコード: 商品名、プロバイダー商品 ID、ASIN、価格、在庫状況、画像 URL、商品 URL、アフィリエイト URL、同期状態、日時。 * 表示設定: テンプレート、ボタンラベル、リンク属性、表示オプション。 * ASP ルーティング設定: もしも、ValueCommerce、その他ルーティング URL テンプレート。 * affilun Cloud 設定: Cloud API キー、サイト ID、エンドポイント、選択プラン、Cloud 接続状態。 * 運用データ: ログ、同期ジョブ、監査イベント、リンクヘルス結果、収益機会ステータス、ローカルキャッシュされた売れ筋アフィリエイト候補、ローカルクリックイベント、クリック/表示の日次集計。 * ローカルクリックメタデータ: プロバイダー、ボタンキー、対象 URL ハッシュ、商品 ID、投稿 ID、表示バリアント、ユーザーエージェントハッシュ、参照元ホスト、日時、日次集計数。 API キーとアフィリエイト識別子は WordPress データベースに保存され、管理者権限を持つユーザーが管理します。公開ページには出力されません。 == ASP Routing == Yahoo!ショッピングのアフィリエイト計測は、Yahoo!ショッピング設定の Yahoo Developer Client ID と ValueCommerce 自由テキストリンク HTML スニペットで設定します。affilun はそのスニペットからリンク生成に必要な sid / pid のみを抽出して保存します。 affilun は、カスタム ASP や移行用途向けの高度な ASP ルーティングテンプレートも任意でサポートします。テンプレートでは `{url}`、`{encoded_url}`、`{provider}`、`{product_id}` などのプレースホルダーを使用できます。 ASP ルーティングを有効にすると、商品ボタン URL は設定された中継 ASP URL に変換される場合があります。各テンプレートが関連 ASP の規約と計測要件に適合していることは、サイト運営者が確認してください。 == Uninstall == WordPress 管理画面からプラグインを削除すると、`uninstall.php` がアンインストール処理を実行します。 現在の方針では、プロバイダー認証情報、affilun Cloud API キー、Cloud 接続設定、ローカルクリック集計オプション、cron カーソル、worker ID、予約済み affilun cron hook など、秘密情報または運用状態を持つオプションを削除します。 商品、ログ、監査、同期、リンクヘルス、分析、クリック集計のカスタムテーブルは、将来明示的な削除設定が導入されない限り保持されます。必要な商品データや設定は、プラグイン削除前にバックアップしてください。 == Changelog == = 0.7.9 = * キュー投入された Cloud AI 投稿スキャン失敗について投稿単位の診断情報を追加し、Cloud Tools に最新のジョブエラーを表示するようにしました。 * WordPress.org 掲載向けの説明文と同梱 readme を、日本語サイト向けの内容に更新しました。 * WordPress.org プラグインディレクトリ向けのバナー画像を追加しました。 = 0.7.8 = * 大量選択時に長い管理画面リクエストへ依存しないよう、Cloud AI 投稿スキャンを WP-Cron のバックグラウンド処理にしました。 = 0.7.7 = * 投稿利用状況の検索 SQL で、投稿テーブル名に識別子プレースホルダーを使うようにしました。 = 0.7.5 = * Cloud AI 投稿スキャンでメルカリ検索を行わないようにし、合成検索リンク結果が自動的に商品カードとして保存されないようにしました。 = 0.7.4 = * サイト側のリンク色カスタマイズがプロバイダーボタンの文字色を上書きしないよう、商品カードのボタン文字色を修正しました。 = 0.7.3 = * Cloud AI スキャンの一括選択で、リクエストサニタイズ後も選択済み投稿 ID が保持されるようにしました。 * Cloud AI スキャン結果通知に、選択数、スキャン数、スキップ数、空選択数を表示するようにしました。 = 0.7.2 = * 手動更新後に有効化処理が走らなかった場合でも、管理画面読み込み時に AFFILUN 管理者権限を補完してサブメニュー表示を復旧するようにしました。 = 0.7.1 = * 管理画面 POST 処理を、明示的な権限確認、nonce 確認、サニタイズ済み入力で強化しました。 * 管理画面プレビュー出力と textarea 値を WordPress の文脈別エスケープで保護しました。 * WordPress.org Plugin Check に向けて、SQL レビュー対象と REST ルート権限コールバックを強化しました。 = 0.7.0 = * WordPress.org 配布コードが有料プラン制限付きローカル機能を含まないよう、実験的なローカル最適化管理画面を削除しました。 * 残っていた管理画面インライン JavaScript を WordPress enqueue API に移し、REST ルート単位の権限コールバックを追加しました。 * WordPress 向けの接頭辞を `affilun` 識別子へ統一しました。 * render template に直接アクセス防止を追加し、ソースレビュー用に composer.json を配布物へ保持しました。 * ローカルプラグイン機能はライセンスやプランなしで利用でき、affilun Cloud は任意の外部 SaaS であることを明確化しました。 = 0.6.4 = * Cloud AI アフィリエイトスキャン判定 API を追加し、プロバイダー検索結果を記事との関連性と同一商品らしさで評価できるようにしました。 * Cloud Tools AI スキャンで、プロバイダー API 検索は WordPress 側で実行し、Cloud は AI 候補選定とクォータ計上を担当するようにしました。 * Cloud プラン、利用量、プラグイン側フォールバックカタログ表示に合わせて、AI スキャン専用の feature/cost 識別子を追加しました。 = 0.6.3 = * 既存投稿の AI スキャンを、アフィリエイトリンクがない投稿向けの Cloud Tools ワークフローへ移動しました。 * Cloud キーワード抽出からの商品カード自動挿入と、プロバイダー商品検索を追加しました。 * 移行リライトをプレビュー、バックアップ、リライトの手順に整理しました。 = 0.6.2 = * コンテンツ内で検出された既存アフィリエイトリンクデータを affilun 商品として取り込む案内を設定画面に追加しました。 * CSV インポート/エクスポートは affilun が出力した商品 CSV のみに対応することを明確化しました。 = 0.6.1 = * Cloud リンクヘルスの手動チェック操作を Cloud Tools と Affiliate Management から削除しました。 * Cloud リンクヘルスチェックを、Cloud 設定済みサイト向けの日次自動バッチに変更しました。 * アフィリエイト商品一覧/編集 UI を簡素化し、JPY 価格表示を正規化しました。 = 0.6.0 = * affilun Cloud 売れ筋アフィリエイト候補取得とローカル候補キャッシュを追加しました。 * Cloud Tools に売れ筋アフィリエイト候補を表示するセクションを追加しました。 * 任意の Cloud 候補機能に関する説明を追加しました。 = 0.5.6 = * 0.5.6 リリース向けに WordPress.org 提出メタデータを更新しました。 * WordPress 7.0 までの互換性メタデータを更新しました。 * Plugin Directory 審査向けに、外部サービス、ローカルクリック計測、外部商品画像、affilun Cloud の規約/プライバシー説明を拡充しました。 = 0.5.5 = * affilun Cloud の収益機会・キャンペーン候補ワークフローを追加し、強化しました。 * リンクヘルス結果の処理、永続化、古い結果の保護を追加しました。 * Cloud プラン/利用量表示、記事下書きワークフローのメッセージ、プロバイダー状態処理を改善しました。 * 管理画面から実行される同期、スキャン、Cloud 更新操作の nonce と権限チェックを強化しました。 = 0.5.4 = * Cloud 接続、プロバイダー設定、商品管理ワークフローを改善しました。 * リリースパッケージングと検証ツールを改善しました。 = 0.5.3 = * 初期の商品カード、プロバイダー、リリース候補パッケージングを追加しました。 == Upgrade Notice == = 0.7.9 = 0.7.9 のまま、WordPress.org 掲載向けの説明文と同梱 readme を日本語サイト向けの内容に更新しました。プラグイン本体のバージョンは変更していません。 = 0.7.0 = 有料プラン制限付きの実験的ローカル管理画面を削除し、WordPress 向け接頭辞を `affilun` に更新し、WordPress.org 審査対応を改善しました。ローカルの商品管理と商品カードは affilun Cloud なしで利用できます。 = 0.6.4 = AI スキャンは、商品カード挿入前にプロバイダー検索候補を affilun Cloud へ送信し、関連性と同一商品らしさを評価するようになりました。 = 0.6.3 = Cloud Tools に、アフィリエイトリンクがない投稿向けの AI スキャンを追加しました。移行リライトはプレビュー、バックアップ、リライトの構成になりました。 = 0.6.2 = コンテンツ内で検出された既存アフィリエイトリンクデータを設定画面から取り込めるようになりました。CSV インポート/エクスポートは affilun が出力した商品 CSV のみに対応します。 = 0.6.1 = Cloud リンクヘルスチェックは Cloud 設定済みサイトで自動実行されます。対応が必要な商品は Affiliate Management 画面で確認してください。 = 0.6.0 = 任意の affilun Cloud 売れ筋アフィリエイト候補機能を追加しました。更新後は Cloud 設定を確認し、プラグインのデータベース移行を実行してください。 = 0.5.6 = AI、記事下書き、リンクヘルス、収益機会、売れ筋アフィリエイト候補、ローカルクリックレポート機能を有効化する前に、更新された外部サービス説明と任意の affilun Cloud 設定を確認してください。