AliExpress 日本向け SOP
AliExpress 日本向けアフィリエイト SOP v2.0.0

確認できた情報で作り、
自分の成果で見直す。

実際の商品・特典を集める → 根拠と条件を検証する → サイト・ブログ・SNS に配信する → 自分が利用を許諾された成果データで次の改善を決める。日本向けサイト運営のための手順です。

このキット自体は AliExpress API に接続しません。サンプルは架空で、アクセス・売上・報酬の増加を保証するものではありません。

02

キットを保存して試す

まずは ブラウザで検証。スターターは架空データの動作例で、本番公開用ではありません。単一 HTML は手順と検証をオフラインで読めます。スターターの実行には ZIP の展開が必要です。

展開したキットでサンプルを確認するNode.js 18 以上・追加パッケージ不要
ae-affiliate-kit フォルダで実行
node test.js
node validator.js sample --now 2026-11-18T12:00:00+09:00 --out starter/data/publishable.js
ALIEXPRESS · JAPAN

AE のデータ接続

対象は AliExpress 日本向けアフィリエイトです。淘宝・天猫・DS の仕様ではありません。商品候補の取得、指定 SKU の確認、公式転リンク、成果計測を別工程として扱います。

i
このキットはデータ整形・検証・静的表示を提供します。あなたの API アプリを開通したり、実データへ自動接続したりした状態ではありません。認証・署名・S2S 受信には別途サーバー側の実装が必要です。
01

公式 API の経路

候補取得と、公開できる商品かの確認を分ける
  1. AliExpress Portals 登録後、Tools → API から申請。同じアカウントで Open Platform の Affiliates アプリを作成し、審査・オンライン化・権限を確認します。
  2. 各インターフェースの公共パラメータ・署名・認可を確認します。/auth/token/create は認可コードを token に交換する API。全 Affiliate API がこの認可を必要とするとは限りません。任意の app_signature とシステム署名 sign は別です。
  3. 日本向けは言語 JA、通貨 JPY、配送国 JP を各 API の仕様に従って指定。言語欄に JP を入れたり、別 API に同じ国パラメータ名をコピーしたりしません。
  4. 返った候補を、同じ商品・SKU・配送先・購入条件で再確認してから 01 取り込みへ。取得できない値は不明のまま残します。
実際に使い分ける Affiliate API用途・権限・限界
公式インターフェース役割公開前の追加確認
product.queryキーワード・カテゴリ等で商品候補検索。国引数は ship_to_countryアフィリエイト商品とマーケティング対象商品は同じ集合ではない。検索に出ないだけで非対象・下架と判定しない
productdetail.get商品 ID の詳細。国引数は country商品レベルの価格・販売数は選択 SKU の価格・在庫ではない
hotproduct.queryマーケティング対象の候補人気という選定情報は、在庫・日本配送・最終価格の保証ではない
product.sku.detail.get
product.shipping.get
product.smartmatch
SKU 詳細、配送、推薦。2025 年ガイドでは追加権限の申請対象アプリの現行権限とレスポンスを確認。基本 API だけで全 SKU 在庫が取得できるとは書かない。smartmatch の個人情報項目を無断収集しない
featuredpromo.get
featuredpromo.products.get
キャンペーン情報/その商品候補キャンペーン情報と商品一覧を分離。商品プールを永久保存したまま公開しない
link.generate元の商品 URL と Tracking ID で公式リンク生成source_values・tracking_id・promotion_link_type を確認。返却の promotion_link を保存
order.get / order.list / order.listbyindex自分の許諾された成果の確認支払・精算、注文状態、金額単位、時刻定義をそろえる。非公開数値を外部記事に転記しない

表の各名称には aliexpress.affiliate. が付きます。古いガイドの取得件数・QPS を現行上限として固定せず、使用するインターフェースの最新仕様を確認してください。

02

API 未開通:商品ページと Portals

ブラウザで確認できた事実だけを取り込む
  1. 自分のアカウントで通常どおり商品ページを開き、配送先を日本、通貨を JPY にして指定 SKU を選択。商品 ID と SKU ID は文字列で記録します。
  2. 同じ SKU の表示価格・販売可能在庫・日本配送・送料・確認時刻を確認。商品全体の最低価格や全 SKU 合計在庫で代用しません。
  3. 必要な場合は F12 の Network / Preview で、自分に利用が許諾された正常な商品レスポンスの必要項目だけ確認。Cookie・Token・認証ヘッダー・HAR 全体を AI や公開ファイルに渡しません。
  4. Portals の通常の確認機能で現在のアフィリエイト資格を確認し、公式リンクを生成。商品ページの URL とは別に保存します。
  5. 通信失敗・ログイン切れ・仕様変更・CAPTCHA・利用制限が出たら停止し、通常の再ログインや人手確認に戻ります。固定 Token、ログイン偽装、署名偽装、制限回避コードを配布・実行しません。
F12 レスポンスを安全に解析する送信・認証なし

以下は保存済み JSON のローカル解析器です。現行レスポンスで構造が違えば unknown。リクエスト発行やブラウザ API の再送はしません。F12 にコピーすると AESourceNormalizer を利用できます。返却値は完成 dataset ではありません。

観察済みの構造解析の条件
PRICE.skuIdStrPriceInfoMap[sku_id].salePriceLocal指定 SKU のキーのみ。通貨設定の証拠は別途確認。小数を勝手に整数へ丸めない
SKU.skuPaths[].skuIdStr / skuId / skuStock完全一致する SKU の非負整数在庫。複数レコードが矛盾したら unknown。明示的 0 のみ在庫切れ
isSuccess / isAffiliateItemPortals ページ応答。isSuccess=true かつ資格値が明示された時だけ Y / N。それ以外は unknown。安定した公開 Open API とは扱わない
F12 にコピー/Node.js で実行:ローカル解析器
'use strict';

function idText(value) {
  if (typeof value === 'number' && !Number.isSafeInteger(value)) return null;
  var text = typeof value === 'string' || typeof value === 'number' ? String(value) : '';
  return /^[0-9]{6,25}$/.test(text) ? text : null;
}
function explicitBool(value) {
  if (value === true || value === 1 || value === 'true' || value === '1') return true;
  if (value === false || value === 0 || value === 'false' || value === '0') return false;
  return null;
}
function integerStock(value) {
  if (typeof value !== 'number' && typeof value !== 'string') return null;
  if (typeof value === 'string' && !/^\d+$/.test(value)) return null;
  var n = Number(value);
  return Number.isSafeInteger(n) && n >= 0 ? n : null;
}
function jpyPrice(value) {
  if (typeof value === 'number') return Number.isFinite(value) && value > 0 ? value : null;
  if (typeof value !== 'string') return null;
  var text = value.trim().replace(/,/g, '');
  var m = text.match(/^(?:JPY\s*|[¥¥]\s*)?(\d+(?:\.\d+)?)(?:\s*円)?$/i);
  var n = m ? Number(m[1]) : NaN;
  return Number.isFinite(n) && n > 0 ? n : null;
}
function normalizePortal(data) {
  var success = explicitBool(data && data.isSuccess);
  var affiliate = explicitBool(data && data.isAffiliateItem);
  return {
    source: 'portal_page_response',
    affiliate_status: success === true && affiliate !== null ? (affiliate ? 'affiliate' : 'non_affiliate') : 'unknown',
    business_success: success,
    missing_fields: success !== true || affiliate === null ? ['current_affiliate_confirmation'] : []
  };
}
function normalizePdp(data, skuId) {
  var sku = idText(skuId);
  if (!sku) throw new Error('sku_id must be an exact decimal string');
  var map = data && data.PRICE && data.PRICE.skuIdStrPriceInfoMap;
  var info = map && Object.prototype.hasOwnProperty.call(map, sku) ? map[sku] : null;
  var paths = data && data.SKU && data.SKU.skuPaths;
  var matches = Array.isArray(paths) ? paths.filter(function (p) { return p && idText(p.skuIdStr != null ? p.skuIdStr : p.skuId) === sku; }) : [];
  var stocks = matches.map(function (p) { return integerStock(p.skuStock); });
  var stock = stocks.length && stocks.every(function (n) { return n !== null && n === stocks[0]; }) ? stocks[0] : null;
  var price = info ? jpyPrice(info.salePriceLocal) : null;
  var missing = ['jp_delivery_confirmation', 'currency_context_JPY', 'current_affiliate_confirmation', 'official_promotion_link', 'captured_at'];
  if (price === null) missing.push('selected_sku_price');
  if (stock === null) missing.push('selected_sku_stock');
  if (price !== null && !Number.isInteger(price)) missing.push('integer_JPY_price_confirmation');
  return { source: 'product_page_response', sku_id: sku, observed_local_price: price, observed_sku_stock: stock,
    stock_status: stock === null ? 'unknown' : stock > 0 ? 'in_stock' : 'out_of_stock', missing_fields: missing };
}
function normalizeApi(data) {
  if (!data || typeof data !== 'object' || Array.isArray(data)) throw new Error('pass one product object, not the response envelope');
  var item = idText(data.product_id);
  var currency = typeof data.target_sale_price_currency === 'string' ? data.target_sale_price_currency : null;
  var price = currency === 'JPY' ? jpyPrice(data.target_sale_price) : null;
  return {
    source: 'affiliate_api_product_object', item_id: item,
    title_ja_candidate: typeof data.product_title === 'string' ? data.product_title : null,
    api_price_candidate: price, api_price_currency: currency,
    product_page_url: typeof data.product_detail_url === 'string' ? data.product_detail_url : null,
    promotion_link_candidate: typeof data.promotion_link === 'string' ? data.promotion_link : null,
    sku_id: null, stock_status: 'unknown', ship_to_jp: null, affiliate_status: 'unknown',
    missing_fields: ['successful_response_context', 'selected_sku_price_stock', 'jp_delivery_confirmation', 'current_affiliate_confirmation', 'image_rights', 'captured_at'].concat(item ? [] : ['exact_product_id'])
  };
}
var sourceNormalizer = { normalizePortal: normalizePortal, normalizePdp: normalizePdp, normalizeApi: normalizeApi };
if (typeof module === 'object' && module.exports) module.exports = sourceNormalizer;
else globalThis.AESourceNormalizer = sourceNormalizer;

if (typeof require === 'function' && require.main === module) {
  try {
    var args = process.argv.slice(2);
    if (!['portal', 'pdp', 'api'].includes(args[0]) || !args[1]) throw new Error('usage: node source-normalizer.js portal|pdp|api saved.json [sku_id]');
    var data = JSON.parse(require('fs').readFileSync(args[1], 'utf8'));
    var result = args[0] === 'portal' ? normalizePortal(data) : args[0] === 'pdp' ? normalizePdp(data, args[2]) : normalizeApi(data);
    console.log(JSON.stringify(result, null, 2));
  } catch (e) {
    console.error(e.message);
    process.exitCode = 1;
  }
}
node source-normalizer.js pdp saved-pdp.json 指定SKU_ID
node source-normalizer.js portal saved-check.json
node source-normalizer.js api saved-product.json

F12 では、保存した必要部分をオブジェクト変数にして AESourceNormalizer.normalizePdp(商品応答, "指定SKU_ID") または normalizePortal(Portals応答) を呼びます。解析結果の不足項目・根拠・公式リンクを 01 で契約へ取り込みます。確認できない値を 0 / N / 下架に置換しません。

03

実レスポンス → キットの契約

独自 JSON を「AE のネイティブ API 仕様」と呼ばない
取得元キットへの取り込み取り違えないもの
product_id同じ商品を照合して item_id に文字列保存SKU ID、JavaScript の精度が失われた長い数値
product_detail_url / promotion_link商品ページ証拠/affiliate_url・link_policy.original_url商品ページをそのまま成果リンクと呼ばない
sale_price / app_sale_price / target_sale_price候補価格。指定 SKU と購入条件を確認して page_price へ最終決済額、全ユーザー共通価格、券の自動重複適用
lastest_volume / code_quantity販売数/Code 残数として別に扱うstock_status へ転記しない
現在の資格/マーケティング対象affiliate_status・affiliate_verified_at/is_hot_product過去注文の資格値を現在の商品資格の証拠にしない。検索欠落も非対象の証明ではない
券の利用条件・実際の決済確認offers と scenario。適用しない特典は条件付き表示本キットの順次割引モデルを AE 全券共通のルールと呼ばない

契約のキーが未確認でも保存可能とは限りません。null を許可しない数値は仮値で埋めず、不足を報告して下書きに留めます。公開ゲートは根拠の実在やアカウント権限そのものをオンライン検証する機能ではありません。

04

公式リンクと S2S

遷移できること、計測できること、報酬が精算されたことは別

通常:Portals/公式転リンク API の返却を原本として保存し、無加工で使用。公式原本に存在するクエリを一律に削除しません。既定の許可ホストは s.click.aliexpress.com。未知の公式形態は原本を保って人が確認します。

S2S:Portals の S2S 設定で自分の受信サーバーとフィールドを設定した場合、公式に許可された透伝を利用できます。静的 HTML だけでは受信できません。

パラメータ用途・条件
afSID。サブアフィリエイト登録済みの場合のみ
cn / cvキャンペーン/クリエイティブ識別。受信側の対応フィールドを設定する
dp動的識別子。クリック ID の透伝に使える。メール・会員 ID 等の個人情報を公開 URL に入れない

キットでは link_policy.mode=s2s、s2s_configured=true、af 利用時は sub_affiliate_registered=true。原本を変更せず許可キーだけ追加し、未知・重複・空値を拒否します。値の文字種・長さ制限は本キット独自の保守的なゲートであり AE の全仕様ではありません。

支払通知と精算を混ぜないS2S / 注文 API
  • S2S の order_id は子注文 ID。親注文・買い手 ID と同一視しません。
  • effect_pay_time は米国太平洋時間の処理時刻で、実支払時刻から遅れる場合があります。America/Los_Angeles で夏時間を考慮。全 API の日時を一律 PST と決めつけません。
  • order_amount は USD、dollars / cents は設定で確認。local_order_amout は原フィールドの綴りのまま受信し、通貨と単位を別に記録します。
  • commission_fee は支払時点の見込報酬。exchange_rate の 0 / 1 を実際の為替レートとして計算しません。
  • API の支払ベースは PaymentCompletedTime と対象状態、精算は CompletedSettlementTime + CompletedSettlement を区別。現在の仕様で確認します。
  • 接続テストはサーバー到達・マッピング確認。実際の帰属・無効注文・精算結果は自分の許諾されたレポートで別に確認します。

運用は 成果レビューへ。内部報告、他パートナーの非公開数値、社内システムの照会方法、認証情報は外部向け生成物に含めません。

05

根拠と更新範囲

資料の記載と、現行アプリでの実行確認を分ける

参考:API Product Guidance(English、2025-03-07 更新)、S2S Product Guidance(English、2024-10-11 更新)の外部提供可能な技術事項。原資料の内部リンク・識別子・連絡先・認証例は転載していません。公開ドキュメント確認日:2026-11-18。SKU 詳細本文にはログインが必要なため、現行の全フィールドを取得・実行確認したとはしていません。

公式 Getting Started / 公式 HTTP ガイド。使用時は最新仕様・アカウント権限・利用規約を再確認してください。

HANDBOOK

戦略ハンドブック

何を・どの順で・なぜやるのか。5 つのモジュールはすべて「GMV のどの要素を動かすか」に結びついています。

01

役割と責任

誤りは「入れない」「止める」「早く気づく」の 3 段で防ぐ
担い手やることやらないこと
運営側供給パック(商品プール・特典・キャンペーン・素材の利用条件)を、根拠と確認日時つきで提供非公開の数値を社外向けに渡すこと
あなた(パートナー)価格・在庫・特典の確認、リンク発行、公開判断、成果データの振り返り確認していない値を「たぶん」で埋めること
AIデータの整形、価格シナリオの計算、記事・投稿の生成、サイトの描画、週次レビューの下書き価格・在庫・期限・実績値の推測や生成、リンクの加工
バリデータ契約チェック、価格の再計算、しきい値・併用・期限・鮮度・表現・リンクの検査、公開可データの出力「公開してよい理由」を作ること(止めるのが仕事)
02

供給パック

AI の出力品質は、入力の確かさで上限が決まる
パック中身契約確認の目安
商品プールitem_id・SKU・タイトル・カテゴリ・ストア・ページ価格・在庫・日本配送・送料・税products人気・セール中 6 時間/通常 72 時間
特典種類・割引(定額/率・上限)・利用条件額・対象範囲・対象ユーザー・期間・併用可否offers12 時間
キャンペーン名称・期間・関連特典campaigns24 時間
素材画像 URL と利用権限(公式 API 提供/ストア許諾/自分で撮影)products.image権限が変わったとき
リンクポータル/公式ツールで発行したアフィリエイトリンク(無加工)products.affiliate_url発行時
根拠ページ確認・スクリーンショット・ポータル出力などの記録。社外に出せないものは internalevidence各値の確認時
成果自分のアカウントの訪問・クリック・注文・売上(許諾範囲)週次レビューで使用週 1 回
03

GMV の分解

GMV = 訪問数 × 出口クリック率 × クリック後の成約率 × 平均注文額
要素主に効くモジュール典型的な打ち手
訪問数④ 配信と新規層開拓、③ 定番記事検索意図に合う定番ページ、SNS での速報、初心者ガイドで未経験層を取り込む
出口クリック率② 価格、③ コンテンツ価格の根拠と確認日時を価格の横に置く、CTA を判断材料の直後に置く
クリック後の成約率① 商品プール、② 価格在庫・日本配送が確かな商品だけ載せる、記事価格と商品ページの差をなくす
平均注文額② 価格、③ セール攻略しきい値(例:15,000円以上)を「条件付き特典」として正しく案内、関連商品の提示
!
同じ GMV の減少でも、原因は複数ありえます。1 つの要素だけを見て結論を出さず、成果レビューの手順で分解してください。
①

モジュール 1|商品プール

成約率の上限は「何を載せるか」で決まる

載せる条件(すべて満たすこと)

  • 在庫 in_stock・日本配送 true が確認済み(unknown は公開しない)
  • 確認日時が鮮度の範囲内(人気 6 時間/通常 72 時間)
  • 現在のアフィリエイト資格 affiliate_status=affiliate と確認日時が有効。マーケティング対象 is_hot_product とは別
  • 同じ指定 SKU の価格・在庫・日本配送を照合済み。API の商品最低価格や販売数を代用しない
  • 公式生成リンクを保存。通常は無加工、設定済み S2S のみ許可追記(接続の説明)
  • 画像の利用権限が確認済み

優先順位づけ(prompts/02)

日本の読者の需要・価格の根拠の強さ・確実性(在庫・配送・送料)・レビューの質で採点し、P0(今すぐ推す)/P1(定番)/P2(様子見)に分けます。採点は「載せるかどうか」ではなく「どこに・どの順で載せるか」を決めるためのものです。条件を満たさない商品は、点数に関係なく公開されません。

②

モジュール 2|価格の最適値

「誰が・何点・どの特典で」買う価格なのかを明示する

使ってよい価格ラベル

ラベル意味例
ページ価格商品ページに表示されている 1 点の価格(特典なし)ページ価格 3,980円
検証済み割引後の商品価格条件を満たす特典を、確認済みの順序で適用した 1 点の価格3,680円(ストアクーポン −300円)
◯点購入時の検証済み合計複数点でしきい値を満たす場合の合計。按分方法を併記2点で 14,762円(1点あたり約 7,381円・均等按分)
条件付き特典今の購入条件では満たさない特典。価格には含めず別表示15,000円以上の購入で 1,198円引き

誤りの例と正しい表示

✕ 誤り(P07 で止まる)
ページ価格 3,980円の商品に、15,000円以上が条件の 1,198円引きクーポンを適用して「2,782円」と表示。
単品では条件を満たさないため、読者はこの価格で買えません。クリック後の離脱と信頼低下に直結します。
○ 正しい表示
検証済み割引後の商品価格:3,680円
ページ価格 3,980円 → ストアクーポン −300円(3,000円以上)
条件付き特典:15,000円以上の購入で 1,198円引き
送料:要確認/2026-11-18 09:30 JST 確認

キットの計算モデル

以下は本キットの保守的なモデルで、AliExpress の全クーポン共通仕様ではありません。実際の券条件・決済画面で同じ結果を確認できない場合は、割引を適用せず「ページ価格+条件付き特典」に戻します。API 取得価格だけでは最終金額・併用・全員への適用を保証できません。

  • 特典は 適用順 に計算し、各特典の利用条件額は「直前までの割引後金額」と比べる
  • 率の割引は端数切り捨て、上限があれば上限まで
  • 2 つ以上の特典を重ねるには、双方の stackable_with に相手が含まれ、かつ併用を実際に確認済み(stacking_verified: true)であること
  • 対象ユーザー(新規・会員・アプリ限定など)が購入条件と一致しない特典は使わない
  • 送料・税は価格に混ぜない。不明なら「要確認」
  • 相場の参考価格は 30 日以内の根拠があるときだけ比較表示(超えると自動で隠れる)

手順の詳細は prompts/03 価格シナリオ。バリデータが再計算し、表示価格との差が 1 円を超えると P08 で止まります。

③

モジュール 3|成約につながるコンテンツ

読者が購買のどの段階にいるかで、型を選ぶ
型読者の段階主に動かす要素必須条件プロンプト
クーポン速報買う直前クリック率・成約率有効な特典が 1 つ以上、期限の表示04a
セール攻略セール前〜期間中注文額・成約率キャンペーン期間、特典の条件と併用可否04b
カテゴリ定番・選び方比較検討訪問数(検索)・クリック率更新日と変更内容の記録04c
実購入レビュー最終確認成約率・再訪問購入記録、良い点と注意点の両方04d
はじめてガイド未経験・不安新規の訪問数・成約率配送・支払い・返品の公式情報への案内04e
最小構成:トップに「クーポン速報」、資産ページとして「カテゴリ定番」、大型セール時に「セール攻略」。実購入レビューは購入記録ができてから追加します。
④

モジュール 4|配信と新規層開拓

訪問数は GMV の入口。セールが終わっても止まらない導線を作る
  • チャネルごとに役割を分ける:検索(定番・選び方)、SNS(速報・期限の案内)、LINE/メール(セール前の予告)、動画(使い方・開封)
  • 新規層:AliExpress を使ったことのない読者には「はじめてガイド」を入口にし、配送・支払い・返品の不安を先に解消
  • 計測:ポータル・公式ツール・設定済み S2S の実際の経路を記録。S2S の公式透伝 af / cn / cv / dp を使う場合は設定と権限を確認。任意のパラメータを加えれば計測される、とはしません
  • 投稿のルール:PR 表記・確認日時・公式リンクの保存と許可範囲の利用は必須。公開可データ以外から投稿を作らない(prompts/05)
⑤

モジュール 5|優位パターンと失敗パターン

「参考事例」と「検証済み事例」を分けて扱う

日本の Amazon・楽天の発信者・公式紹介例は 日本の実例へ。観察・作者申告・表彰・増分効果を区別して、AE の商品と条件で試します。

AE 紹介サイトの構造例成果未検証の参考

以下は公開されている紹介サイトの構成を観察したもので、成果の数値は確認していません。自分のサイトで試す場合は「仮説」として 実験テンプレート に登録し、自分のデータで判定してください。

観察した型構成仮説(なぜ効きそうか)観察例
カード式クーポン一覧割引額・条件・期限・コード+「使う」ボタンコードを探す手間が減り、購買直前の離脱が減るGamepedia
ストア別クーポン集約ストアごとの券リスト+明細表+PR 表記同じストアでのまとめ買いを促し、注文額が上がるしゅけガジェット
セール攻略目次+クーポン表(重ね使いの条件)+事前のカート追加の案内セール開始直後の取りこぼしが減るtonchikiroku
カテゴリ定番(更新日つき)ジャンル別のおすすめ+更新日と変更内容セール外の検索流入の土台になる(順位の保証はない)katsukichi-life
良い点も失敗も書くレビュー買って良かった点・失敗した点・配送日数信頼が上がり、推薦の成約率と再訪問が上がるmenmi-danna-blog

失敗パターン(キットが自動で止めるもの)

失敗GMV へのダメージ止める仕組み
条件を満たさない特典を価格に入れるクリック後の即離脱、信頼の低下P07P08P10P14
期限切れの特典を載せ続ける「使えないサイト」と思われ、再訪問が落ちるO01O03O05+画面の自動非表示
在庫・日本配送が不明な商品を推す成約しないクリックが増えるP01P02P03
根拠のない「最安値」「No.1」表示規制のリスク、苦情P17A05
PR 表記なしステマ規制違反A01+スターターが全ページに表示
未許可のリンク改変・未設定の計測成約しても成果が付かないP18CH01
購入記録のないレビュー/理由のない更新日変更信頼の低下A03A04

検証済み事例は、自分の成果データで判定したものだけを 事例テンプレート に記録します。

JAPAN · REFERENCE CASES

日本の実例から、AE で試す

参考にするのは購入判断を助ける構造です。Amazon・楽天の API、券、帰属期間、配信ルールを AliExpress に移植するものではありません。

!
「効果が証明された」とはしていません。公式紹介・表彰、作者の自己申告、公開ページの構成、因果的な GMV 改善は別の証拠です。今回、第三者が再計算できる CTR / CVR / GMV の増分は確認できませんでした。
01

5 つの参考ケース

公開資料の調査日:2026-11-18
発信者・プラットフォーム参考にする構造証拠の種類
マクリン/Amazon 等比較・実測・購入入口発信者ページ。公式認定ではない
ゴリミー/Amazon特典条件+予算別案内発信者ページの検索索引。全文未取得
トバログ/Amazon・楽天使用期間・長所と短所作者自述の歴史事例。全文未取得
Happy Life Home⁺/楽天生活場面の撮影楽天公式紹介の検索索引。全文未取得
えぬ/楽天 ROOMテーマ別コレクション公式表彰の検索索引。全文未取得

一部原ページは取得失敗または 403。索引で確認できた内容を全文検証済みとは扱わず、引用・公開日・現行の内容を使う前に原ページで再確認してください。

マクリン|比較から購入判断へ発信者一手情報

Anker 比較ページ、個別実測ページ、運営・参加プログラム情報。比較ページのサイト名・購入ボタンは取得確認済み。詳細な実測・製品提供の開示は検索索引での確認に留まります。正確な初回公開日は未確認。

観察:比較、寸法などの判断材料、商店別入口。個別記事の索引には「製品を提供いただいたうえで執筆」の記載があります。提供品を自購入と書き換えません。

AE の実験:同じ SKU・同じ価格条件で、用途別比較を先に置く案と単純一覧を比較。主指標は商品入口 CTR、副指標は帰属 CVR と返金を考慮した GMV / 訪問。

移植しないもの:Amazon の画像・価格を AE ボタンの根拠に使わない。AE の型番・容量・互換性を自分の根拠で再確認。実測データのない AI 評価は生成しない。

ゴリミー|特典条件と予算で整理索引確認・全文未取得

特典の解説、予算別の選び方、広告方針。検索索引の表示日は 2026-10-15 / 2026-10-19、本文取得は 403 のためページ内の日付を独立確認していません。

索引での観察:「ポイント還元はエントリーが必要なものが多い」、商品を「5万円以上・1万〜5万円・1万円以下」で整理する構成。ランキング根拠や売上効果は未確認。

AE の実験:同じ商品集合で予算ナビを追加し、条件付き特典を価格から分離。主指標は有効な商品クリック、副指標は帰属 CVR・GMV。クリック増だけで採用を決めない。

移植しないもの:Prime 会員資格、Amazon ポイント、イベント日程を AE 特典として書かない。AE の券の残数・対象ユーザー・期限は独立確認。

トバログ|使用期間と短所を示す2017 年の歴史事例

GPD Pocket 使用レビュー、運営方針。索引表示日 2017-12-28。本文は 403 のため全文未取得。

作者自述・索引での観察:「購入してから…大体一か月くらい」、良いところ/悪いところ、Amazon・楽天の入口。作者の購入申告であり、本調査で注文記録を独立確認したものではありません。

AE の実験:実際に保有・購入した同じ SKU で、使用期間、適する読者、注意点を追加。主指標は帰属 CVR、副指標は返金・GMV。長所だけの推薦と比較します。

移植しないもの:古い端末のレビューを現行の別 SKU の測定として扱わない。価格・配送・バッテリーなど現在の情報を再確認。キットの実購入型は自分の購入記録が必要。

miho/Happy Life Home⁺|生活場面の写真楽天公式の紹介例

楽天公式の成功例インタビュー、本人ブログの公開記事。公式紹介は 2017/02 配信の歴史事例。索引確認のみで、本文と正確な初回公開日は未取得です。

公式紹介の索引:「スマホ撮影からカメラ撮影に変更!」、晴れた日の撮影・背景のぼかし等。公式紹介された事実と撮影方法であり、カメラ変更による売上増の因果証拠ではありません。

AE の実験:文案・商品・配置を固定し、自分の明瞭な使用場面写真だけを変更。主指標 CTR、副指標 CVR。高価な機材の購入自体を成長施策としません。

移植しないもの:他者の写真や楽天商品素材を転載しない。自撮影・ストア許諾・AE の許可された素材だけを使用。

えぬ/楽天 ROOM|テーマのコレクション公式表彰・増分未検証

楽天 ROOM 公式結果ページ、公開アカウント。索引に「グランプリ/えぬさん」「えぬの#買ってよかった2025」「コレクションを見る」。集計は 2026-01-10 時点の記載、正確な公開日と全文は未取得。

観察:テーマ別の集合と単品推薦。表彰は確認できる参考情報ですが、SNS からの導流・アルゴリズム効果・売上増を証明しません。

AE の実験:自分のサイトで「通勤」「家事」「持ち運び」等の集合 → 単品根拠 → 公式購入入口を作り、SNS と検索を別々に計測。主指標 GMV / 訪問、副指標 CVR・返品。

移植しないもの:ROOM の推薦アルゴリズム、フォロー関係、表彰、ポイントを AE が提供すると書かない。

02

実例を制作ラインへ移す

1 実験 1 変更、参考と検証済みを区別
1 仮説
何を移すか
用途比較、注意点、条件前置き、テーマ集合から 1 つ選ぶ。出典と証拠の種類を残す。
2 制作
AE の事実で作り直す
同じ SKU・日本配送・JPY・特典条件・権利・PR を確認。04c / 04d / 05 へ入力。
3 判定
自分の成果で評価
同一定義・同一商品集合で比較。帰属は増分ではない。対照群がない前後比較は限界を記載。

実験テンプレートに登録し、失敗・保留も 事例記録に残します。小サンプルの目安はキットの既定値であり、統計的有意差を保証しません。

03

他プラットフォームの規則は持ち込まない

参考構造と、利用規約・データ許諾は別
  • Amazon のプログラムポリシー:価格・在庫・画像には取得方法・利用・更新の条件があります。Amazon 素材を AE 商品の広告根拠に流用しません。旧 PA API の解説を現行の AE 接続手順として配布しません。
  • 楽天の利用ガイド、SNS ガイド、広告表示:帰属期間・短縮・閉じたチャネルでの送信条件を AE に転記しません。AE と各配信先の現行規則を確認します。
  • このページの外部記事は参考資料であり、キットの推薦商品・公式成果リンクではありません。非公開の実績値、他者の購入記録や写真を転載しません。
PROMPTS

プロンプト集

すべてのプロンプトは「目的 → 入力 → 処理 → 出力 → 受け入れ基準」の同じ形です。キットのフォルダを AI ツールで開いて使うのが基本ですが、ここからコピーしても同じ内容です(キットのファイルから自動生成しています)。

01

共通ルール:AGENTS.md

Codex などはフォルダを開くと自動で読みます。読まれない場合は「AGENTS.md を読んで従って」と最初に指示
共通ルールを読む・コピーするAGENTS.md
AGENTS.md
# AGENTS.md — AliExpress アフィリエイト AI 成長キット v2

このフォルダで作業する AI エージェント(Codex / Qoder / Claude Code など)は、以下を**必ず**守ってください。
目的は「成約につながる正確な情報を、速く・継続的に出すこと」です。見た目のサイトを作ることは手段です。

## 1. データの扱い(最重要)

1. **データを作らない。** 価格・在庫・クーポン・期限・送料・レビュー・実績値を推測・補完・生成しない。不明な値は `null` のまま残し、`missing_fields` に書く。
2. **使ってよいデータ**は「公開情報」と「サイト運営者または運営側が許諾を得て、その用途での利用が認められたプラットフォームデータ」のみ。非公開のレポートや数値を記事・SNS・画面に転記しない(`evidence.visibility = "internal"` は参照のみ)。
3. データは `schema/*.schema.json` の契約に従う。スキーマの必須キーを残す。`null` 可の未確認値は null、それ以外の欠落は不足として報告して下書きに留める(仮値で埋めない)。
4. 状態は三値。`unknown` は `expired` / `out_of_stock` と同じではないが、**確認できるまで公開しない**。
5. 対象は **AliExpress 日本向けアフィリエイト**。淘宝・天猫・DS API の仕様を流用しない。この JSON は本キットの正規化契約であり、AE API の生レスポンスではない。
6. 商品 ID と SKU ID は文字列で保存し、指定 SKU の価格・在庫・日本配送を確認する。商品全体の最低価格・合計在庫で代用しない。API の `lastest_volume` は販売数、Code の `code_quantity` は利用残数であり、在庫ではない。
7. `affiliate_status` は現在の根拠で `affiliate / non_affiliate / unknown` を記録し、`affiliate_verified_at` を添える。検索に出ない・通信失敗・フィールド欠落を非アフィリエイトと判定しない。`is_hot_product`(マーケティング対象)とは別に扱う。
8. 内部データ、他のパートナーの非公開実績、社内システムの照会方法・SQL・テーブル名、認証情報、個人のファイルパスを外部向け生成物に含めない。API 署名や S2S 受信は静的サイトではなく、許諾されたサーバー側で処理する。

## 2. 公開ゲート(バリデータが最終判断)

- 公開前に必ず実行する:
  `node validator.js <データ> --mode production --out <出力>/publishable.json --strict`
- サイト・記事・SNS 投稿に使ってよいのは **`publishable.json` に含まれるレコードだけ**。元データを直接描画しない。
- あなたの判断(`publish_decision`)は参考意見。バリデータが `error` を出したものは公開しない。
- `is_sample: true` のデータは本番に出さない。
- 画面では `display.hide_after` を過ぎたレコードを非表示にする(再ビルドを待たない)。

## 3. 価格表示

- 商品価格のラベルは「ページ価格」「検証済み割引後の商品価格」「◯点購入時の検証済み合計」。未適用の特典は「条件付き特典」として価格とは別に表示する。
- しきい値(例:15,000円以上)を満たさないクーポンを単品価格に入れない。条件付き特典として別表示する。
- 複数点購入の合計を出す場合は点数と按分方法を明記する(`display.per_unit_note_ja`)。
- 送料が不明なら「送料:要確認」。確認できていない「送料込み」「最安値」「No.1」は使わない。
- 価格の横に確認日時(`display.verified_label_ja`)を表示する。

## 4. リンクと計測

- 基本は公式生成リンクを無加工で使用し、`link_policy.original_url` に原本、`mode: "official_original"` を保存する。公式原本に存在するクエリを一律に削除しない。
- 例外は開通・設定済み S2S の公式透伝 af / cn / cv / dp。`mode: "s2s"`、`s2s_configured: true` を記録する。af は登録済みサブアフィリエイトのみ(`sub_affiliate_registered: true`)。元リンクを変えず、重複キーや未知パラメータを追加しない。
- dp 等に個人情報を入れない。opaque なクリック ID を使い、対応表は非公開に保つ。キットの文字種制限は保守的な公開ゲートであり、AE の全パラメータ仕様そのものではない。
- チャネル別計測はポータル・公式ツール・設定済み S2S の実際の構成を `channels` に記録する。計測方法が none の場合は tracking_value を null にする。
- 遷移、S2S 接続テスト、支払通知、成果帰属、精算完了は別々に確認する。クリック成功や接続テストで報酬を保証しない。

## 5. 表現・コンプライアンス

- すべてのページ・投稿に PR 表記(アフィリエイト広告を含む旨)を入れる。
- 実購入レビューは購入記録(`purchase_record`)がある場合のみ。
- 画像は権利が確認できたもの(`image.rights ≠ unknown`)のみ。
- 更新日は実質的な変更があったときだけ変え、`update_note_ja` に内容を書く。
- 構造化データや更新日でリッチリザルト・順位向上が保証されるとは書かない。

## 6. 出力フォーマット(全プロンプト共通)

作業結果は次の JSON エンベロープで返す(コードやファイル変更とは別に):

```json
{
  "task": "04a_coupon_flash",
  "publish_decision": "publish | draft | block",
  "content": "生成物(Markdown / HTML / 投稿文)",
  "data_patch": [],
  "evidence_refs": ["EV-..."],
  "missing_fields": ["products[PR-X].shipping_fee"],
  "reasons": ["判断理由を短く"],
  "human_review": ["人が確認すべき点"]
}
```

根拠が足りない場合は `block` ではなく `draft` とし、何が足りないかを `missing_fields` に具体的に書く。

## 7. 作業の進め方

1. `README.md` を読み、ユーザーの経路(新規サイト/既存サイト/SNS)を確認する。
2. データ → `node validator.js` → `publishable.json` → 生成・描画、の順を崩さない。
3. 変更後は `node test.js` と `node validator.js sample --now 2026-11-18T12:00:00+09:00` が通ることを確認する。
4. 各シナリオの詳細手順は `prompts/` を参照。
02

出力エンベロープ

AI の作業結果を同じ形で受け取り、人とバリデータが確認しやすくする
キー中身確認のポイント
task実行したプロンプト名
publish_decisionpublish / draft / blockAI の意見。最終判断はバリデータの結果とあなた
content生成物(Markdown / HTML / 投稿文)価格文言が display のものと一致しているか
data_patchdataset.json への変更推測で埋めた値がないか
evidence_refs使った根拠の ID内容の主張すべてに根拠があるか
missing_fields確認できなかった項目次に確認する作業リストとして使う
reasons / human_review判断理由/人が見るべき点公開前に必ず目を通す
根拠が足りないときは block ではなく draft にして、何が足りないかを missing_fields に具体的に書かせます。止めるだけでなく「次に何を確認すれば公開できるか」がわかる状態にするためです。
03

どのプロンプトをいつ使うか

番号順がおおよその作業順です
段階プロンプト使うとき
供給01 供給パックの取り込み
02 商品の優先順位づけ
03 価格シナリオの作成
新しい商品・特典を受け取ったとき/価格・特典が変わったとき
生産04a クーポン速報
04b セール攻略
04c カテゴリ定番・選び方
04d 実購入レビュー
04e はじめてガイド
読者の購買段階に合わせて記事を作るとき
配信05 配信と拡散SNS・LINE・メールに展開するとき
成長06 週次レビュー週 1 回、成果データで改善点を決めるとき
サイト07 新規サイトの構築
08 既存サイトへの組み込み
最初の構築時/デザイン・構成を変えるとき
04

シナリオ別プロンプト

クリックで展開。右上のボタンでコピー
01 供給パックの取り込み(supply intake)prompts/01_supply_intake.md
prompts/01_supply_intake.md
# 01 供給パックの取り込み(supply intake)

## 目的
運営側や自分で集めた商品・特典・素材・キャンペーン情報を、契約どおりの `data/dataset.json` に変換する。ここで誤った値を入れると後工程すべてが誤るため、**推測で埋めない**ことが最優先。

## 入力
- 供給パック(CSV / スプレッドシート / テキスト / スクリーンショットの書き起こし など)
  - 商品プール:item_id、SKU、タイトル、カテゴリ、ストア、ページ価格、在庫、日本配送、送料
  - 特典:種類、割引額/率、上限、利用条件額、対象(サイト/ストア/商品)、対象ユーザー、期間、併用可否
  - 素材:画像 URL と利用権限
  - キャンペーン:名称、期間、関連特典
  - リンク:ポータル/公式ツールで生成済みのアフィリエイトリンク
- 確認日時と根拠(ページ確認、スクリーンショット、ポータル出力 など)

## 処理
1. `schema/` の契約を読み、各値を対応するキーに入れる。**必須キーを残し、null 可の不明値は `null`**。null 不可の欠落は不足として報告し、仮値を入れず下書きに留める。
2. 状態は三値で記録:在庫 `in_stock / out_of_stock / unknown`、特典 `active / expired / unknown`。確認できない場合は `unknown`。
3. 日時はタイムゾーン付き(例 `2026-11-18T09:30:00+09:00`)。
4. 根拠ごとに `evidence` を 1 件作成。社外に出せない資料は `visibility: "internal"`。
5. 価格シナリオ(`scenario`)は `prompts/03_price_scenario.md` に従って作る。迷ったら `price_type: "page_price"`・特典なしで登録し、特典は `conditional_offer_ids` に入れる。
6. `affiliate_url` と `link_policy.original_url` に公式生成リンクを保存する。通常は `mode: "official_original"`、`s2s_configured: false`、`sub_affiliate_registered: false`。開通・設定済み S2S の場合のみ `mode: "s2s"` とし、許可された af / cn / cv / dp を追記する(af はサブアフィリエイト登録が必要)。未知パラメータを生成・削除しない。
   - 本 JSON はキットの正規化契約であって AE の生レスポンスではない。`product_id` → `item_id` は同じ商品であることを確かめて変換する。長い ID は文字列。
   - 日本の設定は JA / JPY / JP。`product.query` の国は `ship_to_country`、`productdetail.get` は `country`。他のインターフェースへ同じ引数名を流用しない。
   - 基本 API の target_sale_price 等を選択 SKU の page_price と同一視しない。SKU と日本配送を照合する。lastest_volume / code_quantity を在庫に使わない。
   - `affiliate_status`、`affiliate_verified_at`、`is_hot_product` を分離する。Portals 確認は isSuccess=true かつ isAffiliateItem が明示された場合のみ判定。検索欠落・エラーは unknown。
   - API 未開通なら商品ページ・Portals の通常操作で確認し、許諾されたレスポンスから必要項目だけ抽出する。`source-normalizer.js` は保存 JSON のローカル解析専用。認証・リクエスト送信・制限回避は行わない。
7. `node validator.js data --now <確認時刻>` を実行し、エラーを一覧化する。

## 出力
- `data/dataset.json` の差分(`data_patch`)
- エンベロープ(`AGENTS.md` §6)。`missing_fields` に未確認項目を具体的に列挙(例:`products[PR-12].ship_to_jp`)。

## 受け入れ基準
- [ ] スキーマエラー(S00)が 0 件
- [ ] 推測で埋めた値がない(不明は null/unknown)
- [ ] すべての商品・特典に根拠(evidence_ids)がある
- [ ] 公式リンク原本を保存し、通常無加工・設定済み S2S の許可追記のみ
- [ ] 同じ SKU・日本配送・JPY・現在のアフィリエイト資格を確認し、検索欠落や通信失敗を N / 在庫ゼロに置換していない
- [ ] 業務ルールのエラーは「データの誤り」か「本当に公開できない状態」かを区別して報告している
02 商品の優先順位づけ(scoring)prompts/02_scoring.md
prompts/02_scoring.md
# 02 商品の優先順位づけ(scoring)

## 目的
公開可能な商品の中から、**成約につながりやすい順**に掲載・記事化の優先度を決める。GMV は「訪問数 × アフィリエイト出口クリック率 × クリック後の成約率 × 平均注文額」で分解でき、各要素に効く商品を選ぶ。

## 入力
- `publishable.json`(バリデータ通過済みのデータのみ)
- 任意:自分のサイト・アカウントの成果データ(許諾された範囲。クリック、注文、売上 など)
- 任意:季節・イベント・検索需要などの公開情報

## 処理
1. 各商品を次の観点で 1〜5 点で評価し、**根拠を一文ずつ**添える。
   | 観点 | 主に効く要素 | 例 |
   |---|---|---|
   | 需要・時期 | 訪問数 | 季節需要、セール期間、検索されやすい用途 |
   | 価格の分かりやすさ | クリック率 | 検証済み割引後価格がある、条件付き特典が明確 |
   | 特典の使いやすさ | 成約率 | しきい値が低い、対象が全員、期限に余裕 |
   | 確実性 | 成約率 | 在庫・日本配送・送料が確認済み |
   | 内容との相性 | クリック率 | 比較・選び方・レビュー記事を作れる情報量 |
   | 注文額 | 平均注文額 | セット購入やしきい値到達の提案がしやすい |
   | 自分の実績 | 全体 | 過去のクリック・成約(十分なサンプルがある場合のみ) |
2. 実績データが少ない場合(目安:クリック 100 未満)は「実績」を評価に使わず、`reasons` にその旨を書く。
3. 合計点ではなく、**どの要素を伸ばす商品か**(集客用/成約用/単価向上用)を分類する。

## 出力
- 優先順位表(商品 ID、分類、各観点の点数と根拠、推奨コンテンツ種別 04a〜04e)
- エンベロープ。社外に出せない数値は `content` に含めない。

## 受け入れ基準
- [ ] 公開可データ以外の商品が含まれていない
- [ ] 点数ごとに根拠があり、推測と事実が区別されている
- [ ] 小さいサンプルで結論を出していない
- [ ] 非公開の実数値を本文に転記していない
03 価格シナリオの作成(price scenario)prompts/03_price_scenario.md
prompts/03_price_scenario.md
# 03 価格シナリオの作成(price scenario)

## 目的
「いくらで買えるか」を、**誰が・何点・どの特典で**買う場合の価格なのかを明示して記録する。条件を満たさない特典を単品価格に入れる誤り(例:15,000円以上の条件があるクーポンを 3,980円の商品に適用して 2,782円と表示)を防ぐ。

## 入力
- 商品:SKU、ページ価格(1点)、在庫、日本配送、送料、税の扱い
- 特典:種類、割引(定額/率・上限)、利用条件額、対象範囲、対象ユーザー、期間、併用可否と検証有無

## 処理
1. 同じ AliExpress 商品・SKU、日本配送、JPY、アプリ/Web、アカウント条件をそろえてから、`quantity`(点数)、`ship_to: "JP"`、`eligibility`(全員/新規/会員/アプリ)を決める。API の sale_price / app_sale_price / target_sale_price だけで最終購入価格や全クーポン併用を断定しない。以下の順次割引・しきい値・端数処理は本キットの計算モデルであり、AE 全クーポン共通の仕様ではない。実際の条件と決済画面が一致しない場合は割引価格を公開せず、ページ価格+条件付き特典に戻す。
2. 適用できる特典だけを `applied_offer_ids` に**適用順**で入れる。各特典は次をすべて満たすこと:
   - 期間内・status=active・確認から 12 時間以内
   - 対象範囲(サイト/ストア/商品)に該当
   - 対象ユーザーが `eligibility` と一致(または全員)
   - 利用条件額 ≤ 直前までの割引後金額(ページ価格 × 点数 から順に計算)
   - 2 つ以上なら、互いに `stackable_with` に含まれ、`stacking_verified: true`
3. 条件を満たさない特典は `conditional_offer_ids` に入れ、価格には含めない。
4. 計算:定額は額面、率は「金額 × 率」の端数切り捨て、上限があれば上限まで。
5. `display_price` = 計算結果(`quantity` 点の合計)。`price_type` は特典ありなら `verified_discounted_price`、なしなら `page_price`。
6. 送料・税は価格に混ぜない。不明なら `null`(画面に「要確認」と出る)。
7. `node validator.js` で再計算と照合(P06〜P10, P14, P15)。

## 出力
- `products[].scenario` の差分と、計算過程(例:`3,980円 → ストアクーポン −300円 → 3,680円`)
- エンベロープ

## 受け入れ基準
- [ ] P07(しきい値未達)・P08(不一致)・P10(併用未検証)・P14(対象ユーザー不一致)が 0 件
- [ ] 表示ラベルが「ページ価格/検証済み割引後の商品価格/◯点購入時の検証済み合計」のいずれか
- [ ] 複数点の場合、点数と按分方法が表示される
- [ ] 送料・税を確認せずに「送料込み」「税込」と書いていない
04a クーポン速報(coupon flash)prompts/04a_coupon_flash.md
prompts/04a_coupon_flash.md
# 04a クーポン速報(coupon flash)

## 目的
「今使える特典」を素早く正確に伝え、購入直前の人のクリックと成約を取る。速報は鮮度が命なので、**期限と確認日時を必ず見せる**。

## 入力
- `publishable.json` の `offers`(必須 1 件以上)と、対象の `products`
- 任意:`campaigns`

## 処理
1. 特典ごとに「条件(いくら以上・誰が)」「割引」「期限」「コード(あれば)」を 1 行で書く。表記は `offers[].display.text_ja` と `until_ja` を使う。
2. 商品を紹介する場合は `{{product:ID}}` で埋め込み、価格は `display` の値だけを使う。条件付き特典は「条件付き」と明記。
3. しきい値がある特典は、到達の目安(例:同じストアで 2 点購入)を**事実として計算できる範囲で**示す。
4. 冒頭に「確認日時」と「期限」を置く。
5. 記事レコードを作る:`type: "coupon_flash"`、`offer_ids` 必須、`pr_disclosure: true`。

## 出力
- `articles[]` 追加分(`title_ja`、`slug`、`body_md` など)
- エンベロープ

## 受け入れ基準
- [ ] すべての特典に期限と条件が書かれている
- [ ] 期限切れ・未確認の特典を含まない(A02 が 0 件)
- [ ] 「最安値」「必ず安い」などの表現がない(A05)
- [ ] 価格は publishable の `display` と一致
- [ ] PR 表記あり
04b セール攻略(sale guide)prompts/04b_sale_guide.md
prompts/04b_sale_guide.md
# 04b セール攻略(sale guide)

## 目的
大型セールの前〜期間中に「いつ・何を・どの特典で買うか」をまとめ、セール流入を成約に変える。

## 入力
- `publishable.json` の `campaigns`(必須)、関連 `offers`、`products`
- 任意:前回セールでの自分の成果(許諾範囲)

## 処理
1. 構成:①期間と開始時刻(JST)②使える特典と条件 ③しきい値の到達方法 ④カテゴリ別おすすめ(`{{product:ID}}`)⑤注意点(在庫・価格変動・送料)。
2. 開始前の特典はバリデータが除外するため、「開始後に確認して更新」と書き、推測の割引額を書かない。
3. 価格は確認時点のものと明記。セール開始後は再検証→再ビルドする。
4. 記事レコード:`type: "sale_guide"`、`campaign_id` 必須。

## 出力
- `articles[]` 追加分、更新予定(いつ再検証するか)
- エンベロープ

## 受け入れ基準
- [ ] 期間・時刻が JST で正しい
- [ ] 未開始・未確認の特典額を書いていない
- [ ] 各商品の価格ラベルと確認日時が表示される
- [ ] 更新時は `update_note_ja` に変更内容を記録
04c カテゴリ定番・選び方(category evergreen)prompts/04c_category_evergreen.md
prompts/04c_category_evergreen.md
# 04c カテゴリ定番・選び方(category evergreen)

## 目的
「何を基準に選べばよいか」で検索・比較している人を、納得したうえで商品ページへ送る。長く読まれる記事なので、**価格は埋め込みカードに任せ、本文に価格を固定で書かない**。

## 入力
- `publishable.json` の同カテゴリ `products`(2 件以上推奨)
- 公開されている仕様情報(容量、重さ、サイズ、対応規格 など)

## 処理
1. 構成:①結論(用途別の選び方を 2〜3 行)②選ぶ基準(3〜5 項目)③用途別のおすすめ(`{{product:ID}}`)④比較表(仕様のみ。価格は入れない)⑤購入前の注意(配送日数・送料・保証は要確認)。
2. 仕様は根拠のある値だけ。不明な項目は「記載なし」。
3. 他社比較をする場合は `market_ref`(参考価格)の範囲のみ。比較元と確認日を書く。
4. 記事レコード:`type: "category_evergreen"`。
5. 日本の Amazon / 楽天の実例から用途比較・予算ナビ・注意点等を参考にしてよいが、他社の価格・画像・特典・帰属ルールは流用しない。実例の効果は未検証の仮説として記録し、自分のデータで検証する。

## 出力
- `articles[]` 追加分
- エンベロープ。仕様の根拠が不足していれば `draft`

## 受け入れ基準
- [ ] 本文に固定価格を書いていない(カードで表示)
- [ ] 仕様に根拠がある/不明は不明と書いている
- [ ] 最上級表現なし、PR 表記あり
04d 実購入レビュー(honest review)prompts/04d_honest_review.md
prompts/04d_honest_review.md
# 04d 実購入レビュー(honest review)

## 目的
実際に買って使った体験で、購入をためらう理由(品質・届くまでの日数・サイズ感)を解消する。

## 入力
- 購入記録(`purchase_record`:購入日時と根拠 ID)— **必須**
- 自分で撮影した写真(`image.rights: "own_photo"`)、使用期間、使用条件
- `publishable.json` の該当商品

## 処理
1. 構成:①結論(向いている人/向いていない人)②購入情報(購入日・注文から到着までの日数・購入時の価格は「購入時点」と明記)③良かった点 ④気になった点(必ず書く)⑤現在の価格(`{{product:ID}}`)。
2. 体験していないことは書かない。メーカー説明は「メーカー記載」と区別する。
3. 提供品の場合はその旨を明記し、実購入と呼ばない。購入記録がない提供品はこの実購入型ではなく、category_evergreen 等で提供・実測条件を開示する。参考ケースの作者の購入申告を自分の purchase_record に転記しない。
4. 記事レコード:`type: "honest_review"`、`purchase_record` 必須。

## 出力
- `articles[]` 追加分
- エンベロープ。購入記録がなければ `block`(A03)

## 受け入れ基準
- [ ] 購入記録と根拠がある
- [ ] 気になった点が書かれている
- [ ] 購入時価格と現在価格が区別されている
- [ ] PR 表記(提供品なら提供の旨も)あり
04e はじめての AliExpress ガイド(beginner guide)prompts/04e_beginner_guide.md
prompts/04e_beginner_guide.md
# 04e はじめての AliExpress ガイド(beginner guide)

## 目的
初めての人の不安(届くまでの日数、送料・関税、支払い、返品、クーポンの使い方)を解消し、初回購入につなげる。

## 入力
- AliExpress の公開ヘルプ・規約ページ(URL と確認日)
- 任意:`publishable.json` の初心者向け商品・新規ユーザー向け特典

## 処理
1. 構成:①3 分でわかる流れ ②届くまでの目安と確認方法 ③送料・税・手数料(商品ページで要確認)④支払い方法 ⑤返品・返金の窓口 ⑥クーポンの使い方(条件・対象ユーザー・期限の見方)⑦初めてにおすすめの商品(`{{product:ID}}`)。
2. 制度・手数料・日数は公開情報の範囲で、確認日を書く。断定できないものは「商品ページで確認」と案内。
3. 新規ユーザー向け特典は「新規ユーザー限定」と明記(価格シナリオの `eligibility: "new_user"`)。
4. 記事レコード:`type: "beginner_guide"`。制度変更時は更新し `update_note_ja` を記録。

## 出力
- `articles[]` 追加分、参照した公開ページの一覧
- エンベロープ

## 受け入れ基準
- [ ] 制度・日数・手数料に出典と確認日がある
- [ ] 「必ず届く」「関税はかからない」などの断定がない
- [ ] 対象ユーザー限定の特典に対象が明記されている
05 配信と拡散(distribution)prompts/05_distribution.md
prompts/05_distribution.md
# 05 配信と拡散(distribution)

## 目的
サイト外(X / Instagram / Threads / LINE / YouTube / TikTok など)で、新しい層に届け、サイトや商品ページへの有効な流入を増やす。

## 入力
- `publishable.json` の `products` / `offers` / `articles`
- `channels`(チャネルごとの計測方法:ポータルで発行した sub ID など)
- 任意:チャネル別の過去成果(許諾範囲)

## 処理
1. チャネルごとに形式を変える:
   | チャネル | 形式の例 |
   |---|---|
   | X / Threads | 1 投稿 1 特典。条件・期限・確認時刻を 1 行で |
   | Instagram | カルーセル:結論 → 価格(ラベル付き)→ 条件付き特典 → 注意点 |
   | LINE | 週 1 回のまとめ。期限が近い順 |
   | YouTube / TikTok | 開封・使用シーン。価格は概要欄にラベルと確認日時付き |
2. すべての投稿に PR 表記(例:`#PR`、「広告を含みます」)を入れる。
3. 公式生成リンクを使用する。通常は無加工。開通・設定済み S2S のみ af / cn / cv / dp の公式透伝を使用でき、af はサブアフィリエイト登録が必要。元リンクを `link_policy.original_url` に保存し、公開用の dp にメール・ユーザー ID など個人情報を入れない。チャネルは `tracking_method: "s2s"` または公式ツールの実際の設定を記録する。接続テスト・遷移成功・支払通知・精算完了を区別する。
4. 価格・期限は投稿時点の `display` 値のみ。投稿後に期限切れになった場合の対応(削除・追記)を決めておく。
5. 破圈(新しい層への拡散)のための切り口:用途別(通勤・キャンプ・推し活 など)、悩み別、季節行事別。根拠のない話題化(誇張・煽り)はしない。

## 出力
- チャネル別の投稿案(本文、ハッシュタグ、使用リンクの識別名、投稿推奨時刻、期限切れ時の対応)
- エンベロープ

## 受け入れ基準
- [ ] 全投稿に PR 表記
- [ ] 価格にラベルと確認日時
- [ ] 公式原本を保存し、通常は無加工、S2S は許可された追記のみ。計測方法が `channels` に記録済み
- [ ] 期限切れ時の対応が決まっている
06 週次レビュー(weekly review)prompts/06_weekly_review.md
prompts/06_weekly_review.md
# 06 週次レビュー(weekly review)

## 目的
成果データで「どこが詰まっているか」を見つけ、次の 1 週間の改善を 1〜3 個に絞る。

## 入力
- 自分のアカウントの成果(許諾範囲):ページ/投稿別の訪問、アフィリエイト出口クリック、注文、売上、キャンセル・返金
- 計測定義:重複の扱い、帰属期間、キャンセル・返金の扱い、反映の遅れ(何日前までを確定とみなすか)
- 前週に実施した変更の記録

## 処理
1. **定義をそろえる**。前週と定義が違う場合は比較しない。反映の遅れがある直近日は除外する。
   - AliExpress API の支払ベース分析は PaymentCompletedTime と対象状態、精算済み報酬は CompletedSettlementTime + CompletedSettlement を区別する。現在の仕様・権限で確認し、未精算を精算済みと呼ばない。
   - S2S の order_id は子注文。effect_pay_time は米国太平洋時間の処理時刻で、実際の支払時刻とずれる場合がある。America/Los_Angeles で夏時間を扱う。commission_fee は支払時点の見込報酬。
   - order_amount は USD、dollars / cents は受信設定で確認。local_order_amout(原フィールドの綴り)と currency を分けて保存する。exchange_rate の 0 / 1 を実際の為替レートと解釈しない。
   - 自分の許諾されたデータだけを私的に分析する。内部レポート、他のパートナーの数値、社内システムの照会手順を出力しない。
2. 分解:GMV = 訪問数 × 出口クリック率 × クリック後の成約率 × 平均注文額。
3. 詰まりの候補を**複数**挙げる(一つの原因と決めつけない):
   | 症状 | 考えられる原因(例) | 次に確認すること |
   |---|---|---|
   | 訪問が少ない | 需要とずれた題材、検索意図と不一致、配信不足 | 流入元別の内訳、題材の季節性 |
   | クリック率が低い | 価格・特典が伝わらない、CTA の位置、期待とずれた商品 | 価格ラベルの表示位置、記事内の位置別クリック |
   | 成約率が低い | 在庫・価格の変化、条件付き特典の誤解、送料・配送日数、商品とのミスマッチ、計測遅れ | 確認日時からの経過、商品ページとの差、反映遅延 |
   | 注文額が低い | しきい値の案内不足、関連商品の不足 | しきい値到達の提案有無 |
4. サンプルが小さい場合(目安:クリック 100 未満、注文 10 未満)は**判断を保留**し、観察を続ける。少数成果だけで掲載停止などを判断しない。ただし誤価格・在庫不明など公開ゲート上の停止はサンプル数に関係なく行う。この閾値はキットの目安で、AE 規則や統計的有意差の保証ではない。
5. 改善案は「仮説・変更内容・見る指標・期間・判定基準」で書く(`loop` の実験テンプレート)。

## 出力
- 今週のまとめ(定義、分解結果、詰まり候補と根拠、保留事項)
- 次週の実験 1〜3 件
- エンベロープ。非公開の数値は社外向け文章に転記しない

## 受け入れ基準
- [ ] 定義がそろっている/そろわない比較をしていない
- [ ] 原因を一つに決めつけていない
- [ ] 小さいサンプルで結論を出していない
- [ ] 実験に判定基準と期間がある
07 新規サイトの構築(static site)prompts/07_static_site.md
prompts/07_static_site.md
# 07 新規サイトの構築(static site)

## 目的
`starter/` をもとに、自分のサイトとして公開できる状態にする。**サイトはデータを表示する器**であり、公開判断はバリデータが行う。

## 入力
- `starter/`(index.html, app.js, ae-render.js, style.css)
- `starter/data/publishable.js`(`node validator.js data --mode production --out starter/data/publishable.js --strict` で生成)
- サイト名、テーマ(カテゴリ・読者)、デザインの希望

## 処理
1. サイト名・説明・配色を変更。PR 表記(ヘッダーと記事)と「このサイトについて」は残す。
2. ページ構成の例:トップ(キャンペーン → 特典 → 商品 → 新着記事)、記事一覧、記事、カテゴリ別一覧、このサイトについて。
3. 商品・特典の表示は `ae-render.js` の関数(`productCard`、`offerItem`)を使い、価格・ラベル・確認日時・条件付き特典・送料表示を削らない。
4. 期限切れの自動非表示(`display.hide_after`)を外さない。
5. 必要なら静的ページ生成(記事ごとの HTML)に拡張してよいが、データは publishable のみを使う。
6. 構造化データを入れる場合も、検索結果での表示や順位の向上を前提にしない。
7. 静的ホスティング(Cloudflare Pages、GitHub Pages、Netlify など)への公開手順を示し、外部公開の確認を得てから `starter/` を公開。データ更新のたびに validator → 再デプロイ。
8. API 認証・署名・S2S 受信は公開 JavaScript に入れない。静的表示だけで実 API や通知が接続済みと説明しない。商品情報は AE の現在資格・同じ SKU・日本配送を通過したもののみ。

## 出力
- 変更したファイル一覧と差分
- 公開手順(ビルド・デプロイのコマンド)
- エンベロープ

## 受け入れ基準
- [ ] `publishable.js` 以外のデータを読んでいない
- [ ] 価格ラベル・確認日時・送料表示・条件付き特典・PR 表記が全カードにある
- [ ] `hide_after` による非表示が動く(`--now` を未来にして確認)
- [ ] リンクに `rel="sponsored"` が付き、URL が無加工
- [ ] スマートフォン幅で崩れない
08 既存サイトへの組み込み(existing site)prompts/08_existing_site.md
prompts/08_existing_site.md
# 08 既存サイトへの組み込み(existing site)

## 目的
すでに運営しているブログ・比較サイト・まとめサイトに、検証済みの商品カードと特典一覧を差し込み、既存の流入を成約につなげる。

## 入力
- 既存サイトの仕組み(WordPress、はてなブログ、静的サイト、独自 CMS など)
- `publishable.js`、`ae-render.js`、`style.css`
- 差し込みたい記事と商品 ID

## 処理
1. 3 ファイルをサイトの静的ファイル置き場(例 `/ae/`)にアップロード。
2. 記事に貼る:
   ```html
   <link rel="stylesheet" href="/ae/style.css">
   <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>
   ```
3. 既存サイトの CSS と衝突する場合は `.ae-` で始まるクラスだけを調整。表示項目(価格ラベル、確認日時、送料、条件付き特典、PR 表記)は削らない。
4. 既存記事に本文で固定価格を書いている場合は、カード表示に置き換えるか「◯月◯日時点」と明記。
5. 外部スクリプトを使えない CMS では、validator の出力(`display`)から静的 HTML を生成して貼る。この場合は更新時に貼り直しが必要なことを `human_review` に書く。
6. データ更新の流れ:供給パック更新 → validator → `publishable.js` を上書きアップロード。

## 出力
- 対象 CMS 向けの手順と貼り付けコード
- 置き換えた記事の一覧
- エンベロープ

## 受け入れ基準
- [ ] カードが表示され、期限切れは自動で消える
- [ ] 既存記事の PR 表記がある
- [ ] 固定価格の記述が残っていない、または時点が明記されている
- [ ] リンクが無加工
TEMPLATES

組み込みテンプレート

どの経路でも、表示するのは公開ゲートを通ったデータ(publishable.js / .json)だけ。価格ラベル・確認日時・送料・条件付き特典・PR 表記は削らないでください。

A

経路 A|新しくサイトを作る

starter/:サーバー不要の静的サイト。そのままホスティングに置ける

スターターの構成

ファイル役割
index.htmlPR 表記バー、ページ枠。ハッシュルート(#/ トップ、#/articles 記事一覧、#/a/slug 記事、#/about このサイトについて)
app.jsトップ(キャンペーン → 特典 → 商品 → 新着記事)、記事ページ(公開日・更新日・変更内容)の描画
ae-render.js商品カード・特典の描画部品。hide_after を過ぎたものを表示中でも自動で隠す(60 秒ごと)。記事本文の {{product:ID}} を商品カードに置き換え
style.css商品部品の .ae- と、.ae-site 内のページスタイル。配色・余白はここで変更
data/publishable.jsvalidator.js --out が生成。手で編集しない

手順

  1. キットを AI ツールで開き、クイックスタートの「最初のプロンプト」を貼る
  2. 供給パックを data/dataset.json に変換(prompts/01)
  3. node validator.js data --mode production --out starter/data/publishable.js --strict
  4. サイト名・配色・ページ構成を調整(prompts/07)
  5. starter/ を静的ホスティングに公開
B

経路 B|既存ブログ・WordPress に組み込む

3 ファイルをアップロードして、記事に数行貼るだけ
  1. starter/style.css・starter/ae-render.js・starter/data/publishable.js を、サイトの静的ファイル置き場(例:/ae/)にアップロード
  2. 記事に次を貼る(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 / Threads1 投稿 1 特典。条件・期限・確認時刻を 1 行でPR 表記、価格ラベル、確認日時、チャネル用に発行した無加工リンク、期限切れ時の対応(削除・追記)
Instagramカルーセル:結論 → 価格(ラベル付き)→ 条件付き特典 → 注意点
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=<あなたのプロジェクト名>
DATA CONTRACT

データ契約・検証

AI が読み書きするデータの形を固定し、公開してよいかどうかをコードで判定します。これは本キットの正規化契約で、AE API の生レスポンスではありません。実データとの対応は AE のデータ接続へ。契約は validator.js が正本で、JSON Schema はそこから書き出しています。

01

エンティティ

1 つの dataset.json に 6 種類のレコード+ meta
エンティティ役割主なキー
evidence根拠(いつ・何を見て確認したか)type source captured_at visibility(public / internal)
offersクーポン・特典discount_type discount_value max_discount min_spend scope eligibility starts_at expires_at status stackable_with stacking_verified
campaignsセール・キャンペーンstarts_at ends_at offer_ids
products商品と価格シナリオaffiliate_status affiliate_verified_at is_hot_product link_policy sku_id page_price stock_status ship_to_jp shipping_fee affiliate_url image.rights freshness_tier scenario market_ref
articles記事(Markdown)と参照先type status(draft / ready)pr_disclosure product_ids offer_ids purchase_record published_at updated_at update_note_ja
channels配信チャネルと計測方法type tracking_method(portal_sub_id / official_tool / s2s / none)tracking_value

記入の決まり

  • 必須キーはスキーマで定義。null 可の不明値は null。それ以外の不足は下書きで報告し、仮値で埋めない
  • 状態は三値:在庫 in_stock / out_of_stock / unknown、特典 active / expired / unknown。unknown は失効と同じではないが、確認できるまで公開しない
  • 日時はタイムゾーン付き:2026-11-18T09:30:00+09:00。表示は JST に変換される
  • 金額は円の整数。率は 0〜99
  • 根拠の参照:商品・特典・キャンペーンは evidence_ids が 1 件以上必要。internal の根拠は検証に使われるが、公開データからは取り除かれる
  • サンプル:各レコードの is_sample: true のデータは本番モードで必ず止まる

バリデータが付け足す表示用フィールド(display)

公開可データには、画面にそのまま出せる文言が追加されます。AI やテンプレートは価格文言を自作せず、これを使います。

フィールド例
price_label_ja / price_text_ja検証済み割引後の商品価格 / 3,680円
price_breakdown_jaページ価格 3,980円 → ストアクーポン −300円
per_unit_note_ja1点あたり約7,381円(均等按分)
conditional_offers[]15,000円以上の購入で 1,198円引き(それぞれに hide_after)
shipping_label_ja / tax_label_ja送料:要確認
verified_label_ja2026-11-18 09:30 JST 確認
hide_afterこの時刻を過ぎたら画面から自動で隠す(鮮度と、依存する特典の期限のうち早いほう)
02

ルールコード

errorは公開対象から除外、warningは公開可(表示を調整)、infoは参考
共通・根拠・特典・キャンペーンS / G / E / O / C
S00スキーマ違反(型・必須・列挙・null 可否)。構造違反のレコードは業務ルールの検査をスキップ
S01ID の重複
G01サンプルデータを本番モードで使用
E01根拠の取得日時が未来
O01status が expired
O02status が unknown(確認できるまで非公開)
O03status が active でも有効期限を過ぎている
O04開始前、または開始と終了の順序が不正
O05確認から 12 時間以上、または確認日時が未来
O06 O06対象ユーザーが不明(価格に適用不可)/根拠がない
O07〜O09割引の型と値、範囲指定などの条件付き制約
C01 C02キャンペーン終了/確認から 24 時間以上、または確認日時が未来
C03 C03特典が見つからない/公開不可の特典を表示から除外
C04根拠がない
商品と価格P
P01 P02在庫が in_stock でない/日本配送が確認できない
P03確認から時間が経ちすぎ(hot 6 時間/standard 72 時間)
P04根拠がない
P06適用した特典が見つからない・公開不可・対象範囲外
P07利用条件額を満たしていない特典を価格に適用
P08再計算した価格と display_price が 1 円を超えて不一致
P09price_type と適用特典の組み合わせが不正
P10併用の相互指定がない、または併用が未確認
P11画像の利用権限が未確認
P12相場の参考価格が 30 日以上、または確認日時が未来(比較表示を自動で隠す)
P13送料・税の扱いが不明(「要確認」と表示)
P14特典の対象ユーザーが購入条件と一致しない
P15 P15条件付き特典が公開不可で除外/適用済みと条件付きの重複
P17根拠を示せない最上級表現(最安値・No.1 など)
P18許可外 URL・公式原本との不一致・未設定 S2S・未登録 af・未知/重複追記。公式原本のクエリは一律禁止しない。S2S は設定済み af / cn / cv / dp のみ許可
P19指定 SKU の価格・在庫が未確認
P20現在のアフィリエイト資格が対象外・unknown・確認日時欠落/未来/鮮度切れ
記事・チャネルA / CH
A00下書き(公開対象外)
A01PR 表記がない
A02公開不可の商品・特典・キャンペーンを参照
A03実購入レビューに購入記録がない
A04更新日の変更に変更内容(update_note_ja)がない、または日付の順序が不正
A05 A05最上級表現は除外。断定・期限表現(「必ず」「絶対」「今だけ」など)は根拠と期限を要確認
A06有効な特典がないクーポン速報
A07参照先が見つからない
CH01計測方法が none なのに値がある(設定済み公式計測を記録するか null に戻す)
CH02sub ID の形式が不正

依存関係も追跡します。例:特典が unknown(O02)→ それを適用した商品が P06 → その商品を参照する記事が A02 で、すべて公開対象から外れます。

03

ブラウザで検証を試す

データはこのページの中だけで処理され、どこにも送信されません

基準時刻を空にすると現在時刻で判定します。サンプルは 2026-11-18 12:00 JST を想定しています(時間が経つと鮮度切れで除外されるのは正常な動作です)。

04

JSON Schema

2020-12。条件付き制約は if / then と x-rule・x-message-ja で記述

Ajv など一般的な検証器でも使えます(独自キーワードは ajv.addVocabulary(['x-rule','x-message-ja']) で登録)。ただし価格の再計算・期限・鮮度・依存関係などの業務ルールは validator.js でのみ検査されます。

article.schema.jsonJSON Schema 2020-12
schema/article.schema.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "article.schema.json",
  "title": "article",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "type",
    "title_ja",
    "slug",
    "product_ids",
    "offer_ids",
    "campaign_id",
    "pr_disclosure",
    "published_at",
    "updated_at",
    "update_note_ja",
    "purchase_record",
    "body_md",
    "status",
    "is_sample"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
    },
    "type": {
      "enum": [
        "coupon_flash",
        "sale_guide",
        "category_evergreen",
        "honest_review",
        "beginner_guide"
      ]
    },
    "title_ja": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
    },
    "product_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
      },
      "uniqueItems": true
    },
    "offer_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
      },
      "uniqueItems": true
    },
    "campaign_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "pr_disclosure": {
      "type": "boolean"
    },
    "published_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "update_note_ja": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 200,
      "description": "更新日を変える場合の実質的な変更内容"
    },
    "purchase_record": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": false,
      "required": [
        "purchased_at",
        "evidence_id"
      ],
      "properties": {
        "purchased_at": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601。タイムゾーン必須(例: 2026-11-18T09:30:00+09:00)"
        },
        "evidence_id": {
          "type": "string",
          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
        }
      }
    },
    "body_md": {
      "type": "string",
      "minLength": 1
    },
    "status": {
      "enum": [
        "draft",
        "ready"
      ]
    },
    "is_sample": {
      "type": "boolean",
      "description": "サンプルデータは true。production モードでは公開不可"
    }
  },
  "allOf": [
    {
      "if": {
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "const": "honest_review"
          }
        }
      },
      "then": {
        "properties": {
          "purchase_record": {
            "type": "object"
          }
        }
      },
      "x-rule": "A03",
      "x-message-ja": "実購入レビューには購入記録が必須"
    },
    {
      "if": {
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "const": "coupon_flash"
          }
        }
      },
      "then": {
        "properties": {
          "offer_ids": {
            "type": "array",
            "minItems": 1
          }
        }
      },
      "x-rule": "A06",
      "x-message-ja": "クーポン速報には offer_ids が必須"
    },
    {
      "if": {
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "const": "sale_guide"
          }
        }
      },
      "then": {
        "properties": {
          "campaign_id": {
            "type": "string"
          }
        }
      },
      "x-rule": "A06",
      "x-message-ja": "セール攻略には campaign_id が必須"
    }
  ]
}
campaign.schema.jsonJSON Schema 2020-12
schema/campaign.schema.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "campaign.schema.json",
  "title": "campaign",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "name_ja",
    "starts_at",
    "ends_at",
    "offer_ids",
    "verified_at",
    "evidence_ids",
    "is_sample"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
    },
    "name_ja": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "starts_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601。タイムゾーン必須(例: 2026-11-18T09:30:00+09:00)"
    },
    "ends_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601。タイムゾーン必須(例: 2026-11-18T09:30:00+09:00)"
    },
    "offer_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
      },
      "uniqueItems": true
    },
    "verified_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601。タイムゾーン必須(例: 2026-11-18T09:30:00+09:00)"
    },
    "evidence_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
      },
      "uniqueItems": true
    },
    "is_sample": {
      "type": "boolean",
      "description": "サンプルデータは true。production モードでは公開不可"
    }
  }
}
channel.schema.jsonJSON Schema 2020-12
schema/channel.schema.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "channel.schema.json",
  "title": "channel",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "type",
    "name",
    "tracking_method",
    "tracking_value",
    "is_sample"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
    },
    "type": {
      "enum": [
        "website",
        "blog",
        "deal_site",
        "x",
        "instagram",
        "threads",
        "line",
        "youtube",
        "tiktok",
        "other"
      ]
    },
    "name": {
      "type": "string",
      "minLength": 1
    },
    "tracking_method": {
      "enum": [
        "portal_sub_id",
        "official_tool",
        "s2s",
        "none"
      ]
    },
    "tracking_value": {
      "type": [
        "string",
        "null"
      ]
    },
    "is_sample": {
      "type": "boolean",
      "description": "サンプルデータは true。production モードでは公開不可"
    }
  },
  "allOf": [
    {
      "if": {
        "required": [
          "tracking_method"
        ],
        "properties": {
          "tracking_method": {
            "const": "none"
          }
        }
      },
      "then": {
        "properties": {
          "tracking_value": {
            "const": null
          }
        }
      },
      "x-rule": "CH01",
      "x-message-ja": "tracking_method=none なのに値がある:設定済み公式計測を記録するか値を null にしてください"
    },
    {
      "if": {
        "required": [
          "tracking_method"
        ],
        "properties": {
          "tracking_method": {
            "const": "portal_sub_id"
          }
        }
      },
      "then": {
        "properties": {
          "tracking_value": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_]{1,32}$"
          }
        }
      },
      "x-rule": "CH02",
      "x-message-ja": "ポータルで設定した sub ID を英数字で記録"
    }
  ]
}
dataset.schema.jsonJSON Schema 2020-12
schema/dataset.schema.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "dataset.schema.json",
  "title": "dataset",
  "type": "object",
  "required": [
    "meta",
    "evidence",
    "offers",
    "campaigns",
    "products",
    "articles",
    "channels"
  ],
  "properties": {
    "meta": {
      "type": "object"
    },
    "evidence": {
      "type": "array",
      "items": {
        "$ref": "evidence.schema.json"
      }
    },
    "offers": {
      "type": "array",
      "items": {
        "$ref": "offer.schema.json"
      }
    },
    "campaigns": {
      "type": "array",
      "items": {
        "$ref": "campaign.schema.json"
      }
    },
    "products": {
      "type": "array",
      "items": {
        "$ref": "product.schema.json"
      }
    },
    "articles": {
      "type": "array",
      "items": {
        "$ref": "article.schema.json"
      }
    },
    "channels": {
      "type": "array",
      "items": {
        "$ref": "channel.schema.json"
      }
    }
  },
  "additionalProperties": false
}
evidence.schema.jsonJSON Schema 2020-12
schema/evidence.schema.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "evidence.schema.json",
  "title": "evidence",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "type",
    "source",
    "captured_at",
    "url",
    "note_ja",
    "visibility",
    "is_sample"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
    },
    "type": {
      "enum": [
        "page_capture",
        "screenshot",
        "api_response",
        "portal_export",
        "manual_check"
      ]
    },
    "source": {
      "enum": [
        "public_page",
        "authorized_portal",
        "authorized_api",
        "operator_supply"
      ],
      "description": "公開情報、または用途が許諾されたデータのみ"
    },
    "captured_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601。タイムゾーン必須(例: 2026-11-18T09:30:00+09:00)"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "^https://"
    },
    "note_ja": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 500
    },
    "visibility": {
      "enum": [
        "public",
        "internal"
      ],
      "description": "internal は出力に含めない(根拠の存在のみ参照)"
    },
    "is_sample": {
      "type": "boolean",
      "description": "サンプルデータは true。production モードでは公開不可"
    }
  }
}
offer.schema.jsonJSON Schema 2020-12
schema/offer.schema.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "offer.schema.json",
  "title": "offer",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "type",
    "label_ja",
    "discount_type",
    "discount_value",
    "currency",
    "min_spend",
    "max_discount",
    "scope",
    "store_id",
    "product_ids",
    "eligibility",
    "code",
    "starts_at",
    "expires_at",
    "status",
    "stackable_with",
    "stacking_verified",
    "verified_at",
    "evidence_ids",
    "is_sample"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
    },
    "type": {
      "enum": [
        "platform_coupon",
        "store_coupon",
        "auto_discount",
        "promo_code"
      ]
    },
    "label_ja": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "discount_type": {
      "enum": [
        "fixed",
        "percent"
      ]
    },
    "discount_value": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "currency": {
      "const": "JPY"
    },
    "min_spend": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0,
      "description": "利用条件の注文金額(円)。条件なしは null"
    },
    "max_discount": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1
    },
    "scope": {
      "enum": [
        "site",
        "store",
        "product"
      ]
    },
    "store_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "product_ids": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
      }
    },
    "eligibility": {
      "enum": [
        "all",
        "new_user",
        "member",
        "app_only",
        "unknown"
      ]
    },
    "code": {
      "type": [
        "string",
        "null"
      ]
    },
    "starts_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601。タイムゾーン必須(例: 2026-11-18T09:30:00+09:00)"
    },
    "expires_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601。タイムゾーン必須(例: 2026-11-18T09:30:00+09:00)"
    },
    "status": {
      "enum": [
        "active",
        "expired",
        "unknown"
      ],
      "description": "unknown は expired と同じではない。未確認として非公開"
    },
    "stackable_with": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
      },
      "uniqueItems": true
    },
    "stacking_verified": {
      "type": "boolean"
    },
    "verified_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601。タイムゾーン必須(例: 2026-11-18T09:30:00+09:00)"
    },
    "evidence_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
      },
      "uniqueItems": true
    },
    "is_sample": {
      "type": "boolean",
      "description": "サンプルデータは true。production モードでは公開不可"
    }
  },
  "allOf": [
    {
      "if": {
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "const": "promo_code"
          }
        }
      },
      "then": {
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1
          }
        }
      },
      "x-rule": "O08",
      "x-message-ja": "promo_code はコード文字列が必須"
    },
    {
      "if": {
        "required": [
          "discount_type"
        ],
        "properties": {
          "discount_type": {
            "const": "percent"
          }
        }
      },
      "then": {
        "properties": {
          "discount_value": {
            "type": "number",
            "maximum": 99
          }
        }
      },
      "x-rule": "O07",
      "x-message-ja": "割引率は 99% 以下"
    },
    {
      "if": {
        "required": [
          "discount_type"
        ],
        "properties": {
          "discount_type": {
            "const": "fixed"
          }
        }
      },
      "then": {
        "properties": {
          "discount_value": {
            "type": "integer"
          }
        }
      },
      "x-rule": "O07",
      "x-message-ja": "定額割引は整数(円)"
    },
    {
      "if": {
        "required": [
          "scope"
        ],
        "properties": {
          "scope": {
            "const": "store"
          }
        }
      },
      "then": {
        "properties": {
          "store_id": {
            "type": "string",
            "minLength": 1
          }
        }
      },
      "x-rule": "O09",
      "x-message-ja": "scope=store には store_id が必須"
    },
    {
      "if": {
        "required": [
          "scope"
        ],
        "properties": {
          "scope": {
            "const": "product"
          }
        }
      },
      "then": {
        "properties": {
          "product_ids": {
            "type": "array",
            "minItems": 1
          }
        }
      },
      "x-rule": "O09",
      "x-message-ja": "scope=product には product_ids が必須"
    }
  ]
}
product.schema.jsonJSON Schema 2020-12
schema/product.schema.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "product.schema.json",
  "title": "product",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "item_id",
    "sku_id",
    "title_ja",
    "category_ja",
    "store_id",
    "affiliate_url",
    "link_source",
    "link_generated_at",
    "link_policy",
    "affiliate_status",
    "affiliate_verified_at",
    "is_hot_product",
    "image",
    "stock_status",
    "ship_to_jp",
    "shipping_fee",
    "tax_included",
    "page_price",
    "currency",
    "scenario",
    "market_ref",
    "freshness_tier",
    "verified_at",
    "evidence_ids",
    "is_sample"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
    },
    "item_id": {
      "type": "string",
      "pattern": "^[0-9]{6,20}$"
    },
    "sku_id": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "^[0-9]{6,25}$",
      "description": "指定 SKU。不明は null として保存できるが公開不可"
    },
    "title_ja": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "category_ja": {
      "type": "string",
      "minLength": 1
    },
    "store_id": {
      "type": "string",
      "minLength": 1
    },
    "affiliate_url": {
      "type": "string",
      "pattern": "^https://",
      "description": "公式生成原本、または設定済み S2S の許可追記リンク"
    },
    "link_source": {
      "enum": [
        "portal",
        "official_api",
        "official_tool"
      ]
    },
    "link_generated_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601。タイムゾーン必須(例: 2026-11-18T09:30:00+09:00)"
    },
    "link_policy": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "mode",
        "original_url",
        "s2s_configured",
        "sub_affiliate_registered"
      ],
      "properties": {
        "mode": {
          "enum": [
            "official_original",
            "s2s"
          ]
        },
        "original_url": {
          "type": "string",
          "pattern": "^https://"
        },
        "s2s_configured": {
          "type": "boolean"
        },
        "sub_affiliate_registered": {
          "type": "boolean"
        }
      }
    },
    "affiliate_status": {
      "enum": [
        "affiliate",
        "non_affiliate",
        "unknown"
      ]
    },
    "affiliate_verified_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "is_hot_product": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "マーケティング対象。アフィリエイト資格とは別"
    },
    "image": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "url",
        "rights"
      ],
      "properties": {
        "url": {
          "type": "string",
          "pattern": "^https://"
        },
        "rights": {
          "enum": [
            "official_api",
            "store_permitted",
            "own_photo",
            "unknown"
          ]
        }
      }
    },
    "stock_status": {
      "enum": [
        "in_stock",
        "out_of_stock",
        "unknown"
      ]
    },
    "ship_to_jp": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "shipping_fee": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0,
      "description": "日本向け送料(円)。不明は null →「送料:要確認」"
    },
    "tax_included": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "page_price": {
      "type": "integer",
      "minimum": 1,
      "description": "検証時点の商品ページ表示価格(SKU・1点)"
    },
    "currency": {
      "const": "JPY"
    },
    "scenario": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "quantity",
        "ship_to",
        "eligibility",
        "applied_offer_ids",
        "conditional_offer_ids",
        "price_type",
        "display_price"
      ],
      "properties": {
        "quantity": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10
        },
        "ship_to": {
          "const": "JP"
        },
        "eligibility": {
          "enum": [
            "all",
            "new_user",
            "member",
            "app_only"
          ]
        },
        "applied_offer_ids": {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
          },
          "uniqueItems": true,
          "description": "適用順。各しきい値は直前までの割引後金額で判定"
        },
        "conditional_offer_ids": {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
          },
          "uniqueItems": true,
          "description": "価格に含めず「条件付き」として別表示する特典"
        },
        "price_type": {
          "enum": [
            "page_price",
            "verified_discounted_price"
          ]
        },
        "display_price": {
          "type": "integer",
          "minimum": 0,
          "description": "quantity 点の合計額。バリデータが再計算して照合"
        }
      },
      "allOf": [
        {
          "if": {
            "required": [
              "price_type"
            ],
            "properties": {
              "price_type": {
                "const": "page_price"
              }
            }
          },
          "then": {
            "properties": {
              "applied_offer_ids": {
                "type": "array",
                "maxItems": 0
              }
            }
          },
          "x-rule": "P09",
          "x-message-ja": "page_price の場合 applied_offer_ids は空"
        },
        {
          "if": {
            "required": [
              "price_type"
            ],
            "properties": {
              "price_type": {
                "const": "verified_discounted_price"
              }
            }
          },
          "then": {
            "properties": {
              "applied_offer_ids": {
                "type": "array",
                "minItems": 1
              }
            }
          },
          "x-rule": "P09",
          "x-message-ja": "verified_discounted_price には適用特典が 1 つ以上必要"
        }
      ]
    },
    "market_ref": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": false,
      "required": [
        "price",
        "source_ja",
        "checked_at"
      ],
      "properties": {
        "price": {
          "type": "integer",
          "minimum": 1
        },
        "source_ja": {
          "type": "string",
          "minLength": 1
        },
        "checked_at": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601。タイムゾーン必須(例: 2026-11-18T09:30:00+09:00)"
        }
      }
    },
    "freshness_tier": {
      "enum": [
        "hot",
        "standard"
      ]
    },
    "verified_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601。タイムゾーン必須(例: 2026-11-18T09:30:00+09:00)"
    },
    "evidence_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{1,63}$"
      },
      "uniqueItems": true
    },
    "is_sample": {
      "type": "boolean",
      "description": "サンプルデータは true。production モードでは公開不可"
    }
  }
}
05

コマンド

Node.js 18 以上。追加パッケージ不要
validator.js
# 検証のみ(ディレクトリなら dataset.json、なければエンティティ別ファイルを読む)
node validator.js data

# 本番:エラーがあれば終了コード 2、公開可データを出力
node validator.js data --mode production --out site/data/publishable.json --strict

# ブラウザ用(window.AE_PUBLISHABLE = …)
node validator.js data --mode production --out starter/data/publishable.js

# 時刻を固定して再現(サンプル・テスト用)
node validator.js sample --now 2026-11-18T12:00:00+09:00

# 機械可読の結果 / JSON Schema の書き出し
node validator.js data --json
node validator.js --schemas schema
PUBLISH RULES

公開・更新ルール

誤った価格や期限切れの特典は、1 回でも読者の信頼を失わせ、クリック後の成約率を下げます。ここにあるルールの多くはバリデータとテンプレートが自動で守りますが、人が判断する部分も明記しています。

01

公開ゲート

公開前に毎回。AI の判断ではなく、コマンドの結果で決める
公開前チェックリスト
  1. node validator.js data --mode production --out …/publishable.js --strict が終了コード 0
  2. サイト・記事・投稿に使ったのは publishable のレコードだけ(元データを直接描画していない)
  3. 各レコードの is_sample が true のデータが含まれていない(G01)
  4. warning(送料不明・相場の参考価格切れなど)の表示が意図どおり
  5. AI のエンベロープの missing_fields と human_review を確認した
  6. 全ページ・全投稿に PR 表記がある
  7. リンクを 1 本以上クリックし、商品ページに遷移できる(※成果の帰属はこれでは確認できない)
02

鮮度(確認からの有効時間)

時間を過ぎたレコードは、再確認して verified_at を更新するまで公開されない
対象既定値超えたとき
人気・セール中の商品(freshness_tier: hot)6 時間商品を除外(P03)
通常の商品(standard)72 時間商品を除外(P03)
クーポン・特典12 時間特典を除外(O05)→ それを使った商品・記事も除外
キャンペーン24 時間キャンペーンを除外(C02)
相場の参考価格30 日比較表示だけを隠す(P12、商品は公開可)

これらは本キットの保守的な既定値であり、AliExpress 公式の更新保証ではありません。現在のアフィリエイト資格も同じ鮮度で確認します。既定値は validateDataset(data, { freshness: { hot: 3 } }) のように短くできます。長くする場合は、その間に価格・在庫が変わらないことを確認できる根拠が必要です。

03

期限切れの自動非表示

カウントダウンが 0 になっても、それだけでは「掲載をやめた」ことにならない
1 ビルド時
バリデータが除外
期限切れ・鮮度切れ・unknown・条件未達は publishable に入らない。
2 表示中
画面が自動で隠す
各レコードの display.hide_after(鮮度と、依存する特典の期限のうち早いほう)を過ぎると、ページを開いたままでも消える。
3 定期
再確認・再ビルド
特典は 12 時間以内を目安に再確認して再ビルド。新しい特典の反映と、HTML に残った情報の撤去はここで行う。
!
2 だけでは不十分な場面:SNS 投稿・メール・画像化した価格表・外部スクリプトを使えない CMS に貼った静的 HTML は自動で消えません。期限切れ時の対応(削除・「終了しました」の追記)を投稿時に決めておいてください。
04

リンクと計測

成約しても成果が付かないのは、GMV の直接の損失
  • 基本は公式生成リンクを原本保存し、link_policy.mode=official_original で無加工使用。公式原本に存在するクエリを一律に削除しない
  • 開通・設定済み S2S の公式透伝 af / cn / cv / dp は許可。mode=s2s、s2s_configured=true、af は登録済みサブアフィリエイトのみ。元リンクを保存し、個人情報・未知・重複キーを追記しない(詳細)
  • 許可ホストの既定値は s.click.aliexpress.com。他の公式形式は原本と現行仕様を確認し、allowedLinkHosts を明示設定。未知の形式をパラメータ削除で修復しない
  • 計測方法を channels に記録する。遷移・S2S 接続テスト・支払通知・帰属・精算は別々の確認。自分の許諾されたレポートで確認する
05

表現・画像・記事

景品表示法(ステルスマーケティング規制を含む)を前提に
項目ルール自動チェック
PR 表記すべてのページ・記事・投稿に「広告を含みます」等の表記A01
最上級・断定根拠を示せない「最安値」「日本一」「No.1」「100%保証」などは使わない。「必ず」「絶対」「今だけ」「永久」も避けるP17A05
価格ラベル付き・確認日時付き。送料・税を確認せずに「送料込み」「税込」と書かないP07P08P13
実購入レビュー購入記録がある場合だけ。良い点と注意点の両方を書くA03
更新日実質的な変更があったときだけ変え、変更内容を記録A04
画像利用権限が確認できたもの(運営提供・ストア許諾・自分で撮影)のみP11
検索での表示構造化データや更新日で、リッチリザルトや順位の向上が保証されるとは書かない人が確認
06

データの境界

何を使ってよく、何を外に出してはいけないか
使ってよいのは、公開情報と、パートナーまたは運営側が許諾を得て、その用途での利用が認められたプラットフォームデータのみです。非公開のレポートを、許可なく外部に開示してはいけません。
  • 非公開資料を根拠にした場合は evidence.visibility: "internal"。検証には使われますが、公開データからは取り除かれます
  • 成果データは自分のアカウントの範囲で使い、記事・SNS・画面に数値を転記しない
  • 他のパートナーやサイトの成果を推測して書かない。内部データ、社内システムの照会方法・SQL・テーブル名、認証情報、個人ファイルパスを外部向け生成物に含めない
  • データの取り方が違えば数字も操作方法も変わります。比較するときは計測定義をそろえる(成果レビュー)
07

問題が起きたとき

誤った情報を見つけたら、直す前にまず止める
状況すぐにやることその後
価格・特典が商品ページと違う当該商品を公開入力から外し、特典は未確認なら status=unknown で再ビルド。参照記事も公開から除外。価格問題を在庫切れと記録しない。SNS は削除または訂正再確認して verified_at を更新。原因(確認漏れ・条件の読み違い)を記録
在庫切れ・日本配送不可になったstock_status / ship_to_jp を更新して再ビルド代わりの商品を 02 で選び直す
リンクが遷移しないポータルでリンクを再発行して差し替え発行元(link_source)と発行日時を記録
読者からの指摘事実を確認し、誤りなら訂正と訂正日を記事に明記記事の update_note_ja に変更内容を残す
GROWTH LOOP

成果レビュー

作って終わりにしない。成果データで「どこが詰まっているか」を見つけ、次の 1 週間の改善を 1〜3 個に絞ります。手順は prompts/06 週次レビュー と同じです。

01

指標の定義

GMV = 訪問数 × 出口クリック率 × クリック後の成約率 × 平均注文額
指標定義取得元
訪問数ページ・投稿の閲覧数(セッション or ページビュー。どちらかに固定)サイト解析、SNS の分析画面
出口クリック率アフィリエイトリンクのクリック数 ÷ 訪問数サイト解析のクリックイベント、ポータルのクリック数
クリック後の成約率注文数 ÷ アフィリエイトリンクのクリック数ポータルのレポート
平均注文額売上 ÷ 注文数ポータルのレポート

計測の定義をそろえる

定義が週ごとに違うと、改善したのか計測が変わったのか区別できません。最初に次を決めて固定し、変えた場合はその前後を比較しません。

  • 重複:同じ人の複数クリック・複数注文をどう数えるか
  • 帰属期間:クリックから何日以内の注文を成果とみなすか(ポータルの仕様に従う)
  • キャンセル・返金:差し引くか、別に数えるか
  • 反映の遅れ:何日前までを確定とみなすか。直近の未確定日は比較から外す
  • 期間:曜日の偏りを避けるため、7 日単位で比べる。セール期間は通常期と分けて比べる
AliExpress の支払・精算・時刻定義API / S2S
  • API は PaymentCompletedTime と対象状態で支払ベースを分析し、CompletedSettlementTime + CompletedSettlement で精算済み報酬を別集計。使用時の仕様を確認する。
  • S2S order_id は子注文、effect_pay_time は米国太平洋時間の処理時刻で実支払時刻とずれる場合がある。America/Los_Angeles で夏時間を考慮する。
  • order_amount の USD と dollars / cents 設定、local_order_amout の通貨を確認。commission_fee は見込報酬、精算済みではない。exchange_rate の 0 / 1 を為替レートとして使わない。
  • 他社の帰属期間を流用しない。帰属 GMV の増加を、その施策による純増と断定しない。非公開レポート・内部データ・社内システムの照会手順は外部に出さない。

接続とフィールドの根拠。

02

詰まりの診断

原因を 1 つに決めつけず、候補を並べて確認する
症状考えられる原因(例)次に確認すること使うもの
訪問が少ない需要とずれた題材、検索意図との不一致、配信不足、季節性流入元別の内訳、題材の季節性02 / 04c / 05
クリック率が低い価格・特典が伝わらない、CTA の位置、期待とずれた商品価格ラベルの表示位置、記事内の位置別クリック03 / 04*
成約率が低い在庫・価格の変化、条件付き特典の誤解、送料・配送日数、商品とのミスマッチ、計測の遅れ確認日時からの経過、商品ページとの差、反映の遅れvalidator / 01 / 03
注文額が低いしきい値の案内不足、関連商品の不足条件付き特典の表示有無、関連商品の配置03 / 04b
!
小さいサンプルで結論を出さない:目安としてクリック 100 未満、または注文 10 未満の場合は判断を保留し、観察を続けます。少数の成果だけを理由に大きな方針転換をしないでください。ただし誤価格・在庫不明などの安全停止はサンプル数に関係なく行います。この目安はキットの既定値であり、AE の規則や統計的有意差の保証ではありません。
03

実験テンプレート

改善案は「仮説・変更内容・見る指標・期間・判定基準」で書く
experiment.md
## 実験 ID:EXP-YYYYMMDD-01
- 仮説:(例)価格の横に確認日時と内訳を置くと、出口クリック率が上がる
- 根拠:(観察した事実。参考事例なら「参考事例・未検証」と書く)
- 対象:(ページ/投稿/チャネル。sub ID など計測方法)
- 変更内容:(何を、どこで、どう変えたか。1 実験 1 変更)
- 主指標:(例)出口クリック率
- 副指標・ガードレール:(例)クリック後の成約率が下がっていないこと
- 期間:(例)7 日 × 2(変更前 / 変更後。セール期間をまたがない)
- 最小サンプル:クリック 100 以上かつ注文 10 以上(どちらかが未達なら判断保留)
- 判定基準:(例)主指標が変更前より明確に高く、ガードレールが悪化していなければ採用
- 結果:(採用 / 不採用 / 保留。数値は自分の記録にだけ残す)
- 次の行動:
04

事例の記録

「参考事例」と「検証済み事例」を混ぜない
REFERENCE
参考事例
他サイトの観察、一般的な知見。効果は未検証の仮説として扱い、実験テンプレートに登録してから試す。
VERIFIED
検証済み事例
自分のデータで、定義をそろえ、最小サンプルを満たして判定したもの。うまくいかなかった結果も記録する。
case.md
## 事例 ID:CASE-YYYYMMDD-01
- 区分:参考事例 / 検証済み事例
- 型:(クーポン速報 / セール攻略 / カテゴリ定番 / 実購入レビュー / はじめてガイド / SNS / その他)
- 状況:(時期、チャネル、対象カテゴリ)
- やったこと:
- 結果:(検証済みなら実験 ID と判定。参考事例なら「未検証」)
- 効いた・効かなかった理由の仮説:
- 再現の条件・注意:
- テンプレートやプロンプトに反映したこと:
記録した事例は、プロンプトの「処理」や「受け入れ基準」に反映していくと、あなたのサイト専用の制作ラインとして育ちます。データ契約を変えない限り、過去のプロンプトとコンテンツはそのまま再利用できます。
05

運用のリズム

速さと正確さを両立させる最小限のサイクル
頻度やること使うもの
毎日(セール中は 6〜12 時間ごと)特典・人気商品の再確認 → validator → 再デプロイ。SNS の期限切れ投稿を処理01 / 03 / validator / 05
週 1 回成果の分解、詰まりの診断、次週の実験 1〜3 件を決める。通常商品の再確認06 / 実験テンプレート
大型セール前キャンペーン・特典の取り込み、セール攻略記事、LINE/メールの予告01 / 04b / 05
大型セール後期限切れの撤去確認、セール中の実験の判定、事例の記録validator / 06 / 事例テンプレート
月 1 回定番記事の見直し(実質的な変更がある場合だけ更新日を変える)、相場の参考価格の更新04c / 03