FastOGプラットフォームガイド
FastOGは、誰かがあなたのページの1つを共有したときに表示される画像を生成します。対象は商品、カテゴリ、ホームページ、ブログ記事などです。静的なデフォルト画像を、ライブのカバー画像に置き換えます。商品写真、現在の価格、評価、ロゴ、そして任意で選んだ見出しが含まれます。
このガイドは全体像を示す地図です。各機能が何をするのか、各プラットフォームでどこを変更するのか、そしてどのプランに含まれるのかを説明します。API、HMAC署名、フレームワーク別のチュートリアルについては、APIリファレンスから始めてください。
FastOG の実行環境
| プラットフォーム | アプリの場所 | マーチャントが開くもの |
|---|---|---|
| WooCommerce | WordPress 管理画面 → FastOG | カバーを編集する Studio、プランを変更する Plan、チケットを作成する Support、接続に関する Tools |
| Shopify | Shopify 管理画面 → Apps → FastOG | Covers、Plan、Support。詳細な接続情報はアプリの下部にあります |
| Wix | Wix ダッシュボード → Apps → FastOG | Covers、Customize、Plans |
アプリを初めて開くと、短いセットアップが表示されます。カバーを設定するページタイプを選択し、初期の見た目を選びます。どちらも後から変更できます。セットアップの内容に永続的なものはありません。
カバー画像が選ばれる仕組み
FastOG は、共有されるページの URL に署名します。リクエストにはストアとページタイプが含まれ、サーバーはそのページタイプに保存されたルールを適用します:
- ページタイプのルール — 商品、コレクション/カテゴリ、ホーム、ブログ記事について Covers で編集したカバー画像です。
- より具体的なルールが一致する場合 — タグ、カテゴリ、ベンダー、コレクションに対するルールは、ページタイプのルールより優先されます。
- 商品ごとのカバー画像が保存されている場合 — 最も具体的なルールです。Pro 以上で利用できます。
いずれにも一致しない場合、ページはテーマの画像を保持します。各プラットフォームではページタイプごとに独自のカバー画像が設定されるため、商品のカバー画像を変更してもホームページには影響しません。
カバーとページタイプ
カバー（Shopify、Wix）または FastOG → Studio（WooCommerce）を開き、プレビューの上でページタイプを選択します。
| プラットフォーム | ページタイプ |
|---|---|
| WooCommerce | 商品、カテゴリ、ホーム、ブログ記事 |
| Shopify | 商品、コレクション、ホーム、ブログ記事 |
| Wix | 商品、コレクション、ホーム、ブログ記事、サイトページ |
各タブには独自の見た目、独自のコピー、独自のライブスイッチがあります。あるページタイプを保存しても、別のページタイプが変わることはありません。プレビューは実際のカバーです。ライブページが使用するのと同じテンプレートと props からレンダリングされます。
WooCommerce では、商品編集画面にも小さなカバーパネルが表示されるため、商品から離れることなくカバーを確認・変更できます。Shopify では同じ理由で、管理画面の商品ページに FastOG ブロックが表示されます。Wix ではすべてがアプリ内に収まります。
見た目を選択する
見た目とは、カバーが描画するレイアウト、つまりテンプレートのことです。ピッカーにはカタログ全体が表示され、ロックされた見た目には、それを解除できるプランが示されます。
| プラン | 見た目 |
|---|---|
| Community | 無料セット |
| Starter | 厳選された Starter セット |
| Pro | すべてのテンプレート |
| Scale | すべてのテンプレート、加えて優先レンダリング |
ロックされた見た目は選択肢ではなくショーウィンドウです。プレビューは可能で、アップグレードのプロンプトにはそれを解除できるプランが示されます。保存はサーバー側で拒否されるため、プレビューと実際のカバーが食い違うことはありません。
同じピッカーはセットアップウィザードから開始する場合にも使用され、あるページタイプの見た目を、他のページタイプに影響を与えずに変更できます。
コピーとスタイル
見た目に続いて、エディターには2つのフィールドグループがあります:
- コンテンツ — 見出し、サブタイトル、バッジ、特徴の行、画像など、そのテンプレートが出力するすべてのもの。空のままにしたフィールドは、テンプレートが埋められる場合にはストア自身のデータにフォールバックします。
- スタイル — テーマ、色、フォント、パターン、仕上げ。スタイルはテンプレートごとに異なります。あるレイアウトで意味をなす値が、別のレイアウトに強制されることはありません。
WooCommerce と Shopify では、すべてのプランでストア全体のルールのコピーとスタイルを編集できます。Wix では、自由形式のコンテンツとスタイルのフィールドは Pro カスタムビルダーの機能です。Starter は見た目を選択し、プリセットの固定フィールドは自由に編集するのではなく表示されるだけです。
Pro 限定の商品ごとのエディターは、同じフィールドを1つのアイテムに適用したもの（下記参照）に、ロゴのオーバーライドを加えたものです。
決して埋められないとマークされたフィールドは、FastOG がでっち上げることを拒否するものです。よくあるのは評価です。空の星の行が偽の平均値で埋められることはありません。
ライブシグナル
ライブシグナルは、入力するコピーではなく、カバーの下にあるスイッチです。これらは、共有時にFastOGがすでに把握している値をカバーに描画してよいかどうかを決定します:
| シグナル | 表示内容 | プラン |
|---|---|---|
| 価格 | 現在の価格。商品がセール中の場合、比較価格の取り消し線を含みます | すべてのプラン |
| セール | セールリボン / 比較価格の表示 | すべてのプラン |
| 在庫 | 残りわずか（「残り3点」）および売り切れ | すべてのプラン |
| 評価とレビュー数 | ストアの実際の平均評価とレビュー数 | Starter以上 |
| 評価の下限 | 最低評価または最低レビュー数を下回る場合、星の行を完全に非表示にします | Pro以上 |
このスイッチの狙いは、レイアウトにフィールドを残しつつ、データが弱いときには非表示にできるようにすることです。レビューが2件しかない3.1星の商品は、価格の隣に弱い星の行を表示するよりも、星の行を表示しないほうが通常は適切です。
シグナルをオフにしても何も削除されません。値は引き続きストアから読み取られ、カバーがそれを出力しないだけです。再びオンにすると、次回のレンダリングで再び表示されます。
商品ごと・アイテムごとのカバー
商品ごとのカバーは、1つのアイテムに対して保存されるカバーで、ページタイプのルールの上に重ねて適用されます。これは Pro および Scale の機能です。
| プラットフォーム | 開く場所 |
|---|---|
| WooCommerce | 商品編集画面 → FastOG cover パネル → Customize cover |
| Shopify | Shopify 管理画面で商品を開く → FastOG 商品ブロック → Customize cover |
| Wix | アイテム単位ではまだ利用できません。ページタイプのカバーを使うか、すべての商品で見栄えがするルックを使用してください |
Pro では、その1つの商品に対してルック、コピー、バッジ、スタイルを変更できます。オーバーライドのない商品は、引き続きページタイプのルールを使用します。商品のオーバーライドを解除すると共有カバーに戻りますが、保存された選択内容は破棄されず保持され、後でプランが変更された場合にも引き継がれます。
商品パネルは Studio へのリンクも備えているため、その商品に専用のカバーが不要な場合は、ストア全体のルールにワンクリックでアクセスできます。
商品ライン向けのルール
スコープ付きルールは、商品グループ（タグ、カテゴリ、商品タイプ、コレクション（Shopify）、ベンダー）の商品カバーを調整するものです。これは Scale の機能です。
Covers → Covers for specific products を開きます（見出しは WooCommerce と Shopify で同じです）。ルールを追加し、スコープと見た目を選択して保存します。一致する商品にはルールの見た目とコピーが使われ、それ以外の商品はページタイプのカバーを維持します。
最も具体的な一致が優先されるため、順序を管理する必要はありません。ルールカウンターには、プランの許容量のうち使用済みの数が表示されます。ルールはいつでも削除できます。Wix はまだスコープ付きルールに対応していません。
キャンペーンとスケジュールされた復帰
スケジュールされた復帰はキャンペーンの安全な半分です。Black Friday や季節限定のカバーを今公開し、その前に公開されていたカバーへ戻す日時を選べます。復帰の半分は すべてのプラン（Community を含む）で利用できます。
スケジュールされた開始は Scale の半分です。Scale ではキャンペーンカバーが公開される日付も設定できます。Scale 未満では開始は一時停止され、デザインと日付は保持されるため、アップグレードすれば再開できます。どちらの切り替えも 5 分ごとにチェックされ、時刻にはフィールドの下に表示されるタイムゾーンが使用されます。
どちらの半分にも終了が必要です。開始があって終了がないキャンペーンは決して元に戻らないため、フォームはそれを受け付けません。終了をクリアするとキャンペーンはキャンセルされます。プランの失効によって削除されるものはありません。日付とデザインは保持されます。
PNG をエクスポートする
PNG をダウンロード アクションは、表示中のカバーを 1200×630 でレンダリングしてダウンロードします。これは WooCommerce と Shopify では Pro および Scale の機能です。Wix ではまだ提供されていません。
ファイルはエディター自身のテンプレートと props から生成されるため、別のエクスポート用テンプレートではなくプレビューと一致します。マーケットプレイスの出品、デッキ、ライブ URL を使用できない手動投稿などにご利用ください。
プラン、カバレッジ、制限
FastOG が販売するのはカバレッジであり、レンダリングのクレジットではありません。プランは、ご自身のカタログ項目の数と一連の機能をカバーするものであり、レンダリング回数に上限はありません。
| Community | Starter | Pro | Scale | |
|---|---|---|---|---|
| 価格 | 無料 | 月額 $19 | 月額 $49 | 月額 $119 |
| カバー項目数 | 100 | 250 | 1,000 | 無制限 |
| ページタイプ | すべて | すべて | すべて | すべて |
| ルック | 無料セット | 厳選セット | すべて | すべて |
| 価格、セール、在庫 | あり | あり | あり | あり |
| 評価（星＋件数） | — | あり | あり | あり |
| 評価の下限 | — | — | あり | あり |
| 商品ごとのカバー | — | — | あり | あり |
| メタフィールドのマッピング | — | — | あり | あり |
| PNG エクスポート | — | — | あり | あり |
| 商品ラインのルール | — | — | — | あり |
| キャンペーン開始 | — | — | — | あり |
| スケジュール復帰 | あり | あり | あり | あり |
| 優先レンダリング | — | — | — | あり |
カバレッジパネルには、プランがカバーする項目の数が、商品、カテゴリ、ホーム、ブログ投稿ごとに分類されて表示されます。カタログが上限を超えて成長した場合、パネルには次のプランとその上限が表示されます。レンダリングが通知なく停止することはありません。Plan（WooCommerce、Shopify）または Plans（Wix）からアップグレードしてください。
年払いは同じティアで、12 か月分を 10 か月分の料金で利用できます。Wix は Wix 経由で請求され、WooCommerce と Shopify はアプリ内のプランビュー経由で請求されます。
Wix は同じ料金体系を使用しますが、商品ごとのオーバーライド、スコープ付きルール、PNG エクスポートはまだ提供されていません。Wix でもプランによってカバレッジ、ルック、評価、カスタムビルダーが制御されます。
ヘルスチェックとキャッシュの更新
アプリは短いヘルスチェックを実行し、完全なリストは Details / What we checked の背後に保持します。これは、プレビューを実際に壊す問題に答えるものです:
- FastOG はこのストアのデータとカタログを読み取れますか？
- ストアフロントの
og:imageは FastOG を指していますか、それともテーマや SEO プラグインが優先されていますか？ - サンプル商品は実在しますか、そしてプレビューはそれを使用していますか？
- 署名キーと接続はまだ有効ですか？
各検出結果には、修正方法が存在する場合はそれが添えられます。report はサポートメッセージにコピーするブロックです。これは解釈するためではなく、貼り付けるために設計されています。
カバーが変更されたからといって、プラットフォームがそのカバーを再読み込みしたとは限りません。署名付き URL は決定的であるため、画像自体は更新されます。キャッシュされるのは、プラットフォーム側のページプレビューのコピーです。再スクレイピングするか、プラットフォームのキャッシュが切れるまで待ってください — キャッシュガイド と Facebook の強制更新 を参照してください。ページの og:image がまだテーマのものである場合、ヘルスチェックは別のプラグインまたはテーマが優先されていることを示します。
サポート
セットアップ、カバー配信、請求、製品に関する問題にはサポートをご利用ください。影響を受けているページまたは製品、期待していた動作、実際に起きたことを記載してください。ヘルスレポートを添付するのが最も早い方法です。これは非同期の製品サポートであり、ライブチャットや一般的な相談ではありません。
チケットを作成する前に、ヘルスチェックをお試しください。よくある原因（未接続、カバーを配信していない、SEO プラグインが og:image を上書きしている、プラットフォームのキャッシュが古い）を検出できます。
1ページでわかるトラブルシューティング
| 症状 | 最初に確認すること |
|---|---|
| 共有リンクに画像がない | ヘルスチェック → ストアフロントはog:image FastOG ですか？ ページタイプは対象に含まれていますか？ |
| プレビューに古い価格が表示される | プラットフォームのキャッシュです。ライブ URL はレンダリングごとに署名されます。ページを再スクレイピングしてください |
| カバーの見た目が正しくない | ページタイプのルール、スコープ付きルール、または商品ごとの上書き（最も具体的なものが優先されます） |
| ロックされた見た目が保存できない | より上位のプランに属しています。ピッカーにプラン名が表示されます |
| 評価が表示されない | 商品にまだレビューがない、プランが Starter 未満、または評価スイッチがオフになっています |
| 商品ごとの変更が反映されない | 商品ごとのカバーは Pro/Scale の機能で、それ未満のプランではサーバーが保存を拒否します |
| WhatsApp でカバーがぼやける | OG 画像のサイズ と WhatsApp のプレビュー を参照してください |