商品の登録

TentuPlayコンソールでAIショップオファーを設定する最初のステップについて説明します。

事前準備事項

AIショップのオファーが動作するには、商品情報ファイルと呼ばれるファイルが必要であり、すべてのオファー設定はこの商品情報ファイルに基づいて行われます。オンラインショッピングサイトに商品を登録するように、AIショップオファーの設定はこの商品情報ファイルをショップに追加することから始まります。

商品情報ファイルとは？

商品情報ファイルとはAIオファーに表示させる商品に関する詳細情報が含まれたCSV拡張子のテキストファイルのことです。

TentuPlayコンソールからサンプルファイルをダウンロードすることができます。

  1. TentuPlayコンソールのAI In-Game Shop ＞ AI Store運営 ＞ 設定/管理 ＞ 情報のアップロード タブをクリックします。

  2. 「サンプルファイル」と書かれた行にあるダウンロードをクリックしてsample.csvファイルをダウンロードします。

それでは、sample.csvファイルを詳しく見てみましょう。

sample csv
sample.csv

先頭行の項目は商品情報を構成する要素を示します。

名前 説明 必須

purchasable_slug

販売する商品名

この値はTentuPlayのevent methodに記録する名前で、ゲーム内で使用する販売商品の識別子と同じ値である必要があります。

必須

store

アプリストアプロバイダー名

storeの文字列は区別可能なアプリストア名であれば何でも結構です（例：android、ios、appstore、playstore）。

必須

product_index

ゲームデベロッパーが管理するプロモーションまたは商品別の固有Index

オプション

start_datetime

プロモーションや商品有効期間の開始日時

オプション

end_datetime

プロモーションや商品有効期間の終了日時

オプション

purchase_link

商品購入先のリンク

オプション

  • 値を指定しない場合はセルを空欄にしてください。

  • start_datetime, end_datetimeについて

    • start_datetimeとend_datetimeはプロモーションや商品の販売期限がある場合に使用するカラムです。 販売期限のない商品の場合はstart_datetimeを空欄にするか、遠い過去の日付（例：1970-01-01）に指定してください。

    • start_datetimeとend_datetimeの日付方式はISO 8601形式になります。時間帯（timezone）が適用されるため、注意してください。（例：2021-09-23 19:30+09:00）

商品情報ファイルのアップロード

TentuPlayサーバーに商品情報ファイルをアップロードし、AIショップに商品を追加することができます。

  1. sample.csvファイルのフォーマットに合わせて新しい商品情報ファイルを作成します。

  2. AI In-Game Shop ＞ AI Store運営 ＞ 設定/管理 ＞ 情報のアップロードタブをクリックします。

  3. ファイルのアップロードをクリックして作成したCSVファイルを選択し、開くをクリックしてファイルをアップロードします。

    800
    ファイルが正常にアップロードされた場合の例

  • アップロードに成功したファイルを再度ダウンロードし、ファイルが正しいかどうかを確認することができます。

  • アップロード済みの商品情報ファイルを差し替えるには、更新したファイルを再度アップロードしてください。既存のファイルは新しいファイルで上書きされます。