アプリ内製品
当社の API を使用して、アプリケーションのアプリ内製品のすべての側面を プログラムで 管理できます。
アプリ内製品 セクションにアクセスするには、アプリ に移動し、管理したいアプリをクリックして、アプリ内製品 タブに移動します。
そこから、新しいアプリ内製品の追加、既存の製品の編集、およびその提供状況の管理を行うことができます。
自動アプリ内製品
アプリが同じパッケージ名で Google Play でも利用可能な場合、アプリ内製品の自動同期 トグルを有効にできます。これにより、ユーザーが Aptoide Connect にまだリストされていないアイテムを購入するたびに、アプリ内製品の一覧が自動的に更新されます。
製品が自動同期によって追加されると、その価格は最新の状態に保つために 毎週 更新されます。手動で追加されたアプリ内製品の価格は Google Play と同期されず、ご自身で更新する必要があります。これが適用される国 をクリックすると、当社がお客様に代わって Google Play から価格を取得できる国の一覧を確認できます。
この機能は現在、次の国での価格取得をサポートしています: ブラジル (BR)、ドイツ (DE)、フランス (FR)、イギリス (GB)、香港 (HK)、インドネシア (ID)、アイルランド (IE)、インド (IN)、日本 (JP)、韓国 (KR)、メキシコ (MX)、ロシア (RU)、スウェーデン (SE)、および アメリカ合衆国 (US)。これらのうちの 1 つをデフォルト通貨として選択でき、アプリ内製品が自動的にインポートされる際の参照価格として使用されます。
国固有の価格は、取得された値が通貨換算による副産物ではなく 意図的に設定された価格 のように見える場合にのみ保存されます。価格は、次のいずれかのパターンに一致する場合に意図的なものとして扱われます。
- 末尾の桁が
5または9である小数点以下 2 桁 — 例:0.99、1.49、12.25、99.95、123.45。 - 小数点以下 1 桁 (オプションで末尾にゼロが続く) — 例:
1.5、2.7、14.5、25.50、9.900。 - 次のいずれかである 整数 (オプションで
.0、.00などが続く):0から29の間 — 例:5、15、29。または0、5、または9で終わる — 例:30、45、99、1000、1500。
これらのパターンのいずれにも一致しない値 (例: 1.37、33、41.23、10.51) は、通貨換算の結果であると見なされて破棄されます。その場合、国別価格は保存されず、購入時に参照価格から動的に換算されます。
これは、意図的に設定された価格ではなく通貨換算のように見える値を除外するために設計された ヒューリスティック です。完全ではなく、少数の正当な価格がスキップされたり、少数の換算された値が通過してしまったりする可能性がありますが、実際の価格の大多数を正しく分類します。
Google Play は、一部の国では 税抜 の価格を、他の国では 税込 の価格を返します。自動価格取得に依存する場合は、保存される値が国によっては現地の税金をすでに含んでいる場合とそうでない場合があることに留意してください。
CSV を介したアプリ内製品のプリロード
アプリ内製品の一覧を事前に入力するには、プリロード (CSV) オプションを使用できます。これにより、Google Play から事前に取得したい SKU を含む CSV ファイル をアップロードでき、ユーザーが購入を試みる前に製品情報が利用可能になります。
CSV ファイルには、ヘッダーが Product ID の単一の列と、その後に 1 行につき 1 つの SKU が含まれている必要があります。例:
Product ID
sword.01
sword.02
ファイルをアップロードした後、新しい製品がアプリ内製品の一覧に表示されるまでに最大 5 分かかる場合があります。同期の問題を避けるために、すべての SKU が有効であり、Google Play で使用されている識別子と一致していることを確認してください。
手動アプリ内製品
アプリが同じパッケージ名で Google Play で利用できない場合、または アプリ内製品の自動同期 トグルを無効にした場合、アプリのアプリ内製品の管理を完全に制御できます。
製品価格を設定する方法は 2 つあります。
- 個別 – 正確な管理のために製品を 1 つずつ追加します。
- 一括インポート – CSV ファイルをアップロードして、複数の製品の価格を効率的に設定します。
アプリ内製品を個別に追加する
アプリに 1 つのアプリ内製品を追加するには、「追加」ボタンをクリックします。
モーダルが表示され、ID、タイトル、説明、参照価格 を含むアプリ内製品の詳細を入力できます。すべての情報を入力したら、追加 をクリックしてプロセスを完了します。
ID には、小文字、数字、アンダースコア (_)、およびピリオド (.) のみを含めることができます。
参照価格 は、特定の国の価格が設定されていない場合に使用されます。そのような場合、購入金額は取引時に参照価格を換算することで自動的に計算されます。
アプリ内製品を個別に編集する
アプリ内製品を編集する際には、複数の言語で ステータス、タイトル、説明 を更新したり、参照価格 を設定したり、国別価格 を管理したりできます。
一括インポートによるアプリ内製品の追加/編集
Google Play からエクスポートされた CSV ファイル、または Aptoide Connect 上の別のアプリからの CSV ファイルをインポートすることで、Aptoide Connect でアプリ内製品を管理できます。これにより、複数のアプリケーション間で製品リストを簡単に複製できます。
CSV ファイルをインポートするには:
- アプリ内製品タブに移動します。
- メニューの上部にある CSV インポートをクリックします。
- ファイルをアップロードします。
また、現在の製品リストをエクスポートし、それを使用して別のアプリケーションに同じ製品を入力することで、アプリ間の一貫性を確保することもできます。
CSV の 1 行目は、列ヘッダー Product ID,Published State,Price,Language; Title; Description である必要があります。このヘッダー行が欠けているファイルはインポートに失敗します。アプリ内商品の登録時に CSV インポートが失敗します をご参照ください。
ファイルを整理する方法の例は次のとおりです。
Product ID,Published State,Price,Language; Title; Description
sword.020,published,EUR; 5,en; Sword 1; Big sword 1
フィールドは次のように定義されます。
- Product ID: 製品の一意の ID。小文字、数字、アンダースコア (_)、およびピリオド (.) のみを含めることができます。例:
sword.020 - Published State: 製品のステータス。
publishedまたはnot publishedのいずれか。 - Price: 製品の価格。最初のエントリは参照価格で、有効な通貨コード と数値を使用します (例:
EUR; 5)。追加のエントリは国別価格で、有効な国コード と数値を使用します (例:US; 10)。 - Language: タイトルと説明のための有効な言語コード。例:
en - Title: エンドユーザーに表示される製品の名前。タイトルを表示したくない場合は、null を使用します。
例:
Sword 1 - Description: エンドユーザーに表示される製品の説明。説明を表示したくない場合は、null を使用します。
例:
Big sword 1
アップロードするファイルは .csv ファイルである必要があります。Notepad や VS Code など、構造をそのまま維持できるプログラムを使用してファイルを編集することをお勧めします。
同じ CSV 行内で、1 つの製品に複数の価格を追加できます。
Product ID,Published State,Price,Language; Title; Description
sword.020,published,USD; 5; BR; 2; PT; 5,en; Sword 1; Big sword 1
- 参照価格: 5 USD
- ブラジル (BR) の価格: 2 BRL
- ポルトガル (PT) の価格: 5 EUR
既存の製品を更新するには、Product ID を同じに保ち、他のフィールドを変更します。既存の価格を削除せずに新しい価格を一括で追加するには、CSV に現在の価格を含めます。そうしないと、欠落している価格は置き換えられます。
Product ID が変更されない限り、CSV をインポートすると他のすべてのフィールドが更新されます。これにより、アプリ内製品の一括更新が可能になります。
当社は CSV 形式の Google Play の製品もサポートしています。Google Play から製品リストをダウンロードし、当社のプラットフォームに直接インポートできます。