商品SNS自動投稿プラグイン (X/Twitter & Facebook対応)

📖

マニュアル・設定方法

➔

SNS自動投稿プラグイン(SnsAutoPost)は、EC-CUBE 4で商品の登録・更新を行う際に、FacebookページおよびTwitter/Xへ商品情報を自動(または手動)で投稿できるプラグインです。

新商品の周知やSNSからの集客を自動化し、ECサイトのSNSマーケティング運用にかかる手間を大幅に削減します。

主な特徴と機能

• 自動投稿 & 手動即時投稿機能:
  管理画面で商品を保存した際に自動でSNSへ投稿。商品編集画面からのワンクリック手動即時投稿にも対応しています。


• 商品ごとの個別設定 & 予約投稿機能:
  商品ごとに自動投稿の許可/禁止や投稿モード(毎回/初回のみ)を柔軟に設定可能。指定日時での「予約投稿」により、発売日に合わせた投稿プロモーションが可能です。


• プラットフォーム別テンプレート & GA4 UTM自動付与:
  Facebook、Twitter/Xそれぞれの文字数制限や文化に合わせた個別テンプレートを自由に作成可能。商品URLにGoogle Analytics(GA4)用のUTMパラメータを自動付与するため、効果測定も簡単です。


• CSV大量登録時の安心な非同期キュー処理:
  CSVでの一括登録時や予約投稿時は、APIの呼び出し制限(Rate Limit)やサーバーのタイムアウトを防止するため、自動でバックグラウンド処理(Cron)へフォールバックします。

管理画面からワンクリックで自動投稿のON/OFFを切り替え可能!
共通投稿テンプレートを自由にカスタマイズでき、商品登録・更新時に魅力的なSNS投稿を瞬時に生成します。

■ 主な設定機能と特長

• 商品保存時の自動投稿制御:
  「商品保存時に自動投稿する」にチェックを入れるだけで、新規商品登録時や更新時に各SNSへ自動連携されます(商品編集画面ごとに個別制御も可能)。
  
• 豊富なテンプレート埋め込み変数:
  本文には以下の変数を自由に組み合わせてテンプレートを作成できます。
  
  • {name}:商品名
  • {price}:販売価格(税込)
  • {description}:商品説明文(最大300文字)
  • {description_short}:商品説明短縮(最大100文字・文字数制限のあるX/Twitterに最適)
  • {url}:商品詳細ページのURL
• GA4(Google アナリティクス)UTMパラメータ自動付与:
  投稿内の商品URLには、プラットフォーム別のUTMタグ(例: ?utm_source=facebook&utm_medium=sns_auto_post&utm_campaign=product_123)が自動で付与されます。
  これにより、Google アナリティクス上で「どのSNSから何件アクセスがあり、どれだけ売上に繋がったか」を正確に測定・分析できます。
  

Facebookページへの自動投稿を誰でもかんたんに設定できる2ステップ設計!
煩雑なアクセストークンの手動発行・コピペ作業を極力減らし、OAuth認証によるスムーズな連携を実現しています。

■ Facebook連携の特長と設定手順

• ステップ1:App ID / App Secret の入力(画面内ガイド付き)
  Meta for Developersで作成したアプリの「App ID」と「App Secret」を入力します。
  管理画面内に折りたたみ式の手順ガイド(画像付きの分かりやすい解説)が内蔵されているため、初めてFacebook APIを設定する方でも迷わずセットアップできます。
  
• ステップ2:OAuthによる1クリック自動連携(Page ID & Token自動取得)
  Facebookログインボタンを押して連携を承認するだけで、プラグインが「Page ID」と「Page Access Token(ページ投稿用トークン)」を自動取得・保存します。
  難しいGraph API Explorer等の操作は一切不要です。
  
• 連携状態の可視化&ページ切り替え:
  連携が完了すると「🟢 連携済み」バッジと現在連携中のPage IDが表示されます。複数のFacebookページを管理している場合でも、「別のページと連携」ボタンからいつでも簡単に投稿先ページを変更可能です。
  

X(旧Twitter)への自動ポストに対応!
X Developer Portalから取得したAPIキーを入力するだけで、商品の宣伝ポストを自動・手動で即座にタイムラインへ発信できます。

■ X / Twitter連携の特長と設定手順

• OAuth 1.0a APIキーの入力(マッピング表付きガイド内蔵):
  X Developer Portalで発行される4つのキー(API Key, API Secret, Access Token, Access Token Secret)を入力します。
  画面内に「Developer Portalの項目名と入力欄の対応表」が用意されているため、キーの入力間違いを防ぎます。
  
• テスト投稿機能で事前確認が可能:
  設定画面下部の「Twitter/Xテスト投稿」ボタンをクリックすると、設定したAPIキーが正しく機能しているかをその場でテストできます。
  本番運用前に接続状態を確認できるため、投稿トラブルを未然に防ぎます。
  
• API仕様やエラー対策のアラート表示:
  X APIのプラン仕様(Basicプランや従量課金クレジット)や権限設定(Read and Write)、エラー402対策などの重要な注意点が画面内に明記されており、安心して運用を開始できます。
  

投稿の成功・失敗を一目で把握できる充実したログ管理機能を搭載!
各SNSへの投稿結果がリアルタイムに記録され、万が一のエラー時も原因を素早く特定・対処できます。

■ 投稿履歴画面の主な特長

• リアルタイムな成否ステータス表示:
  対象商品名、投稿先SNS(Facebook / Twitter/X)、成功(緑)・失敗(赤)のステータス、実行日時が一覧でクリアに可視化されます。
  
• 投稿先へのダイレクトリンク(投稿を見る ↗):
  投稿に成功した履歴には、実際のFacebook投稿やXのポストへの直接リンクが表示されるため、公開後の見栄えや反映状況をワンクリックで確認できます。
  
• 詳細なエラーメッセージで原因特定が容易:
  API制限やトークン切れ、残高不足(例: エラー 402: APIクレジット不足)などの失敗理由が具体的に表示されるため、トラブルシューティングに迷いません。
  
• ログ削除・メンテナンス機能:
  「履歴を削除」ボタンにより、不要になった過去の投稿ログをいつでもクリーンアップ可能です。
  

商品編集画面から、商品ごとに細かなSNS配信コントロールが可能!
全体設定に縛られず、キャンペーン商品や特定の商品だけ特別な文面で投稿したり、公開タイミングをコントロールできます。

■ 商品個別設定の主な特長

• 選べる3つの投稿モード:
  
  • 全体設定に従う:プラグイン基本設定のルールをそのまま適用します。
  • 初回保存時のみ投稿:新規登録時のみ自動投稿し、その後の価格や説明文の修正時は重複投稿を防ぎます。
  • 保存のたびに投稿:セールや再入荷など、更新のたびにSNSへ最新情報を発信します。
• 配信先SNSの個別ON/OFF切り替え:
  「この商品はXのみ投稿し、Facebookは除外する」といった柔軟な配信先選択が可能です。
  
• 日時指定の「予約投稿」に対応:
  発売開始日時やセール開始日時に合わせて未来の日時を指定可能。Cronと連動して指定時刻に自動投稿されます。
  
• プラットフォーム別の個別投稿テンプレート&文字数カウンター:
  X用・Facebook用で別々のテンプレートを設定可能。ワンクリックで変数を挿入できるボタンや、X向け280文字リアルタイムカウンターも搭載しています。
  
• 投稿履歴の確認&ステータスリセット:
  最終投稿日時が表示され、「ステータスリセット」を行うことで過去に投稿済みとなった商品でも再度自動投稿の対象に戻すことができます。
  

・EC-CUBE 4.3系（Symfony 6）環境において、プラグインのインストール時および有効化時に発生していたサービス自動解決（Autowiring / ContainerInterface）に関するエラーを修正しました。
・コントローラーおよび依存サービスのDI設定（services.yaml）を4.3系の仕様に合わせて最適化し、MySQLおよびPostgreSQL環境での安定した動作に対応しました。