商品のインポート

Tokenz Dashboard でファイルをアップロードすると、商品を 1 件ずつ作成する代わりに、まとめて追加または更新できます。

製品（Products）を開き、商品をインポート を選択します。商品はライブモードで管理されるため、先にテストモードをオフにしてください。

インポート画面とエラーメッセージは Dashboard の表示言語で表示されます。このガイドでは、日本語表示の画面の文言をそのまま記載しています。

事前準備

商品をインポート ボタンは、ご自身のロールに次の権限がすべて付与されている場合にのみ表示されます。不足している権限は管理者に追加を依頼してください。

形式の選び方

どの形式も同じルールに従います。商品は sku で照合され、インポートは商品の追加または更新のみを行います。ファイルに含まれていない商品が削除されることはありません。

CSV 形式

ファイルのルール

• 文字コードは UTF-8 です。Excel が付加する先頭の BOM（バイトオーダーマーク）の有無は問いません。日本語版 Excel の標準の「CSV」（Shift_JIS）と、Excel の「Unicode テキスト」（UTF-16）も読み込めます。スプレッドシートから CSV を保存するを参照してください。
• 値はカンマで区切ります。セミコロン区切りやタブ区切りのファイルも使えます。区切り文字はヘッダー行から自動で判定されます。
• 価格の小数点にはドットを使います（例: 7.50）。小数点のカンマ（7,50）、通貨記号（¥480）、桁区切り（1,000）を含む値は数値ではないと判定されます。
• ファイルの区切り文字（カンマ。セミコロン区切りやタブ区切りのファイルではセミコロンやタブ）、ダブルクォート、改行を含む値はダブルクォートで囲みます。値の中のダブルクォートは "" と書きます。例（セミコロン区切りのファイル）: gem-pack-500;500 Gems;"500 gems; added instantly.";480;JPY
• 1 行目はヘッダー行である必要があります。ヘッダー名の大文字と小文字は区別されません。スプレッドシートが追加する空の列や空行は無視されます。
• メッセージの行番号はデータ行を数えたものです。ヘッダーのすぐ下の行が 1 行目です。
• CSV と JSON のファイルは最大 25 MB です。行数の上限はありません。

列

真偽値の列（free、publish）には true/false、yes/no、1/0 を使用できます。

例

JPY で価格を設定したゲームアイテム 3 件です。2 行目は引用符の使い方を、3 行目は無料アイテムを示しています。

sku,name,description,price,currency,free,category,taxCategory,publish,image_url
gem-pack-500,500 Gems,"500 gems, added to your account instantly.",480,JPY,false,Gems,virtualCurrency,true,https://cdn.example.com/items/gem-pack-500.webp
starter-bundle,Starter Bundle,"1,200 gems and the ""Rookie"" badge.",1980,JPY,false,Bundles,virtualCurrency,false,https://cdn.example.com/items/starter-bundle.webp
daily-gift,Daily Free Gift,One free reward per day.,,,true,Free gifts,virtualCurrency,true,

スプレッドシートから CSV を保存する

インポート画面の テンプレートをダウンロード から取得したテンプレートに入力し、CSV として保存するのが確実です。

Microsoft Excel

• ファイル > 名前を付けて保存（または コピーを保存）で CSV UTF-8 (コンマ区切り) (*.csv) を選びます。どの言語の環境でも、この形式をおすすめします。
• 日本語版 Excel の標準の CSV (コンマ区切り) は Shift_JIS で保存されます。この形式でもインポートでき、日本語も正しく読み込まれます。
• ヨーロッパの多くの地域など、小数点にカンマを使う地域の Excel は、「CSV」をセミコロン区切りで保存し、価格を 7,50 のように書き出します。セミコロンは自動で判定されますが、小数点のカンマは価格として読み込めません。保存する前に小数点をドットにしてください（Windows 版 Excel では ファイル > オプション > 詳細設定 で システムの区切り文字を使用する をオフにし、小数点の記号 を . にします）。または、価格をドット付きの文字列として入力してください。
• Excel は 123456789012 のような桁数の多い数値の SKU を 1.23457E+11 に変え、先頭のゼロも削除します。SKU を入力する前に sku 列の書式を 文字列 にしてください。指数表記で保存された SKU は、すでに桁が失われているためインポートできません。

Google スプレッドシート

ファイル > ダウンロード > カンマ区切り形式（.csv） を選びます。UTF-8 で保存されるので、そのままインポートできます。

Apple Numbers

ファイル > 書き出す > CSV を選びます。テキストエンコーディング は Unicode (UTF-8) のままにしてください。

JSON 形式

JSON でのインポートには、products.json という名前のマニフェストを 1 つ使用します。画像がすべて URL の場合はそのままアップロードし、画像ファイルを参照する場合は ZIP に含めてアップロードします。

マニフェスト

商品のフィールド

各商品には、価格フィールド（price、free: true、regionPrices）のいずれか 1 つだけを指定します。

例

{
  "version": 1,
  "defaults": {
    "currency": "JPY",
    "taxCategory": "virtualCurrency",
    "publish": false
  },
  "products": [
    {
      "sku": "starter-bundle",
      "name": "Starter Bundle",
      "description": "1,200 gems and the Rookie badge.",
      "price": 1980,
      "category": "Bundles",
      "images": ["images/starter-bundle.webp"]
    },
    {
      "sku": "daily-gift",
      "name": "Daily Free Gift",
      "description": "",
      "free": true,
      "images": ["https://cdn.example.com/items/daily-gift.webp"],
      "publish": true
    },
    {
      "sku": "gem-pack-1200",
      "name": "1,200 Gems",
      "description": "Priced for each region.",
      "regionPrices": { "JP": 980, "US": 6.99, "GB": 5.99 },
      "category": "Gems",
      "images": [
        "images/gem-pack-1200.webp",
        "https://cdn.example.com/items/gem-pack-1200-alt.webp"
      ]
    }
  ]
}

ZIP に画像をまとめる

images/starter-bundle.webp のように相対パスで指定した画像がある場合は、ルートに products.json を置いた ZIP をアップロードします。相対パスは ZIP の中から読み込まれます。

products.zip
  products.json
  images/
    starter-bundle.webp
    gem-pack-1200.webp

価格

価格はすべて、通貨の通常の単位で 0 より大きい数値として指定します（480 円なら 480、4.99 ドルなら 4.99）。CSV と JSON の price、および regionPrices のすべての金額に適用されます。

• 小数点以下の桁数。 通貨が使う桁数より多い小数は指定できません。JPY と KRW には小数がないため、480.5 JPY はエラーになります。USD や EUR など多くの通貨は 2 桁、BHD や KWD など一部の通貨は 3 桁です。通貨ごとの桁数は対応通貨を参照してください。
• 上限。 価格の上限は 99,999,999.99 で、通貨の小数点以下の桁数に合わせて変わります。

プレビューでは何かを書き込む前にすべての価格を確認するため、これらのルールに合わない価格があると、その行を示すメッセージが表示され、インポートは行われません。

画像

• 形式: WebP、PNG、JPEG、GIF。
• 1 枚あたり最大 25 MB です。空のファイルは受け付けられません。
• 画像 URL は一般に公開されている必要があります。ログインが必要な URL や、localhost などのプライベートまたはローカルのアドレスは受け付けられません。
• CSV では image_url に商品ごとに 1 つの URL を指定します。複数の画像や画像ファイルを使う場合は JSON または ZIP を使用してください。
• 商品を更新する際に画像を指定しなかった場合、既存の画像はそのまま残ります。

再インポートと更新

商品は sku で照合されます。

• 新しい sku: 商品が作成されます。
• 既存の sku: ファイルの値で商品が更新されます。これが既定の動作です。
• ファイルにない sku: 商品はそのまま残ります。インポートで商品が削除されることはありません。

既存の商品を変更せずに新しい商品だけを追加するには、インポート前に 新規作成のみ（既存のSKUはスキップ） を選択します。sku がすでに存在する行はスキップされ、結果にスキップとして数えられます。

既存の商品について、インポートでは次の項目は変更されません。

• 既存プランの価格。 同じ請求間隔のプラン（1 回払いの価格など）がすでに異なる価格で存在する場合、その行は現在の価格のままとなります。行のほかの値は更新され、結果に「price not applied」と表示されます。価格を変更するには、Dashboard で商品を開いてそこで変更してください。プランの価格の置き換えは元に戻せない別の操作のため、インポートでは行いません。
• 税区分。 商品の作成時に設定されます。

インポートの手順

1. 商品をインポート を選択し、.csv、products.json、.zip のいずれかのファイルをアップロードします。
2. プレビューを確認します。各行に、作成、更新、スキップのどれになるかと、エラーの有無が表示されます。
3. エラーがあれば修正して、再度アップロードします。ファイルにエラーがある間は何も書き込まれません。
4. インポート を選択します。商品の作成と更新の進行状況が表示されます。
5. 結果を確認します。作成、更新、スキップ、失敗の件数と、失敗した各行の理由が表示されます。

よくあるエラー

インポート画面では、問題ごとに行番号と SKU が表示されます。例: 「3行目（SKU gem-pack-500）: 価格の currency を入力してください（例: USD、JPY）。」JSON ファイルでは、商品は順番で示されます（「2番目の商品（SKU …）」）。問題が残っている間は何も書き込まれません。ファイルを修正して再度アップロードしてください。

ファイルの問題

ファイル全体が読み込めない問題です。

行の問題

インポート後

インポート結果には、失敗した行や、ファイルの内容どおりに変更されなかった行が英語の補足付きで表示されます。

インポート後に文字化けしている場合は、ファイルの文字コードが正しく判定されていません。CSV UTF-8 で保存し直して、再度インポートしてください。

お問い合わせ

インポートしようとしたファイルと、Dashboard に表示されたエラーを添えて Tokenz サポートにお問い合わせください。