TEMPLATES
組み込みテンプレート
どの経路でも、表示するのは公開ゲートを通ったデータ(publishable.js / .json)だけ。価格ラベル・確認日時・送料・条件付き特典・PR 表記は削らないでください。
A
経路 A|新しくサイトを作る
starter/:サーバー不要の静的サイト。そのままホスティングに置けるスターターの構成
| ファイル | 役割 |
|---|---|
index.html | PR 表記バー、ページ枠。ハッシュルート(#/ トップ、#/articles 記事一覧、#/a/slug 記事、#/about このサイトについて) |
app.js | トップ(キャンペーン → 特典 → 商品 → 新着記事)、記事ページ(公開日・更新日・変更内容)の描画 |
ae-render.js | 商品カード・特典の描画部品。hide_after を過ぎたものを表示中でも自動で隠す(60 秒ごと)。記事本文の {{product:ID}} を商品カードに置き換え |
style.css | 商品部品の .ae- と、.ae-site 内のページスタイル。配色・余白はここで変更 |
data/publishable.js | validator.js --out が生成。手で編集しない |
手順
- キットを AI ツールで開き、クイックスタートの「最初のプロンプト」を貼る
- 供給パックを
data/dataset.jsonに変換(prompts/01) node validator.js data --mode production --out starter/data/publishable.js --strict- サイト名・配色・ページ構成を調整(prompts/07)
starter/を静的ホスティングに公開
B
経路 B|既存ブログ・WordPress に組み込む
3 ファイルをアップロードして、記事に数行貼るだけ
starter/style.css・starter/ae-render.js・starter/data/publishable.jsを、サイトの静的ファイル置き場(例:/ae/)にアップロード- 記事に次を貼る(WordPress はブロックエディタの「カスタム HTML」ブロック)
記事に貼るコード
<link rel="stylesheet" href="/ae/style.css"> <!-- 商品カード(ID は dataset.json の products[].id) --> <div data-ae-product="PR-A"></div> <!-- 使える特典の一覧 --> <div data-ae-offers></div> <script src="/ae/publishable.js"></script> <script src="/ae/ae-render.js"></script>
- 期限切れ・鮮度切れの商品と特典は、ページを開いたままでも自動で隠れます(公開データにない ID は何も表示されません)
- データ更新は「供給パック更新 → validator →
publishable.jsを上書きアップロード」だけ。記事は書き換え不要 - 本文に固定価格を書いている既存記事は、カード表示に置き換えるか「◯月◯日時点」と明記
- 外部スクリプトを使えない CMS では、
displayの文言から静的 HTML を生成して貼る。この場合は更新のたびに貼り直しが必要(prompts/08)
!
既存サイトのテーマと見た目が衝突する場合は、
.ae- で始まるクラスだけを調整してください。価格ラベル・確認日時・送料・条件付き特典・PR 表記の表示を消すと、誤認の原因になります。C
経路 C|SNS 中心
公開可データの
display 文言から投稿を作る(prompts/05)| チャネル | 形式 | 必ず入れるもの |
|---|---|---|
| X / Threads | 1 投稿 1 特典。条件・期限・確認時刻を 1 行で | PR 表記、価格ラベル、確認日時、チャネル用に発行した無加工リンク、期限切れ時の対応(削除・追記) |
| カルーセル:結論 → 価格(ラベル付き)→ 条件付き特典 → 注意点 | ||
| LINE | 週 1 回のまとめ。期限が近い順 | |
| YouTube / TikTok | 開封・使用シーン。価格は概要欄にラベルと確認日時付き |
投稿テンプレート(X / Threads)
#PR {title_ja}
{display.price_label_ja}:{display.price_text_ja}({display.verified_label_ja})
{display.price_breakdown_ja}
{display.conditional_offers[0].text_ja があれば「条件付き:…」}
{display.shipping_label_ja}
{affiliate_url(チャネル用に発行したものを無加工で)}記入例(架空のサンプルデータ)
#PR 【サンプル】マグネット式モバイルバッテリー 10000mAh 検証済み割引後の商品価格:3,680円(2026-11-18 09:30 JST 確認) ページ価格 3,980円 → ストアクーポン −300円 条件付き:15,000円以上の購入で 1,198円引き 送料:要確認 https://s.click.aliexpress.com/e/_SAMPLEA1
チャネル別の計測は、ポータル・公式ツール・開通設定済み S2S の実際の経路を
channels に記録します。通常は公式リンク無加工、S2S は許可された af / cn / cv / dp のみ(af は登録が必要)。接続の詳細を確認。静的サイトは S2S 受信・API 署名を行うサーバーではありません。01
ホスティングと更新
静的ファイルなので、どの静的ホスティングでも動きます
- Cloudflare Pages、GitHub Pages、Netlify などに
starter/を置くだけ - 更新は「供給パック更新 →
validator.js --mode production --strict→ 再デプロイ」。--strictは誤りがあると終了コード 2 で止まるので、自動化しても誤ったデータが出ません - 定期的な再ビルド(例:特典は 12 時間以内)を設定しない場合でも、画面側の
hide_afterで期限切れは隠れます。ただし「新しい特典の反映」は再ビルドしないと行われません
更新コマンドの例
node validator.js data --mode production --out starter/data/publishable.js --strict \ && npx wrangler pages deploy starter --project-name=<あなたのプロジェクト名>