Net Revenue APIを使用した税率およびストア手数料率の設定

プレミアム機能
推奨
マーケター
最終更新日：

概要：Net Revenue APIを使用して、アプリごとにストア手数料率および税率ルールをカスタマイズすることで、AppsFlyerにおけるアプリ内課金およびサブスクリプションの純収益（Net revenue）の算出方法を設定できます。これにより、標準とは異なるストア手数料や特定の税制が適用される場合でも、実際の収益を正確にレポートへ反映できます。

ROI360のストア収益機能では、アプリ内課金およびサブスクリプションの総収益（Gross revenue）からストア手数料および税金を自動控除し、純収益を算出します。デフォルト設定では、App StoreおよびGoogle Playにおける標準的な手数料率および税率ルールが適用されます。ストア手数料が異なる場合や、特別な税制が適用される国で事業を展開している場合は、Net Revenue APIを使用してデフォルト設定を上書きしてください。

Net Revenue APIは、アプリごとにストア手数料率および税率ルールを設定できる2つのREST APIで構成されています。

  • ストア手数料率:1つまたは複数のアプリに対して、手数料率の作成・更新・取得・削除が可能です。各アプリは、各種ストアプログラムに基づいた個別の手数料率を設定できます。
  • 税率ルール:特定のアプリに対してカスタム税率ルールの作成または取得が可能です。

純収益の算出方法の詳細については、「ネット収益」をご参照ください。

 注意

純収益はローデータレポートでのみ表示されます。ダッシュボードでは、購入およびサブスクリプションの総収益のみが表示されます。

税率ルールの更新

ROI360で計測されたすべての取引には、デフォルトの税率設定に基づき税金がレポートされます。税込価格の国では、表示価格に税金が含まれているため、税金を控除した後に純収益が算出されます。例えば英国では、税額とストア手数料の合計が控除されます。一方、米国のように税抜価格が適用される国では、表示価格に税金が含まれないため、revenueおよびnet revenueパラメータにはデフォルトで税金は含まれません。

Net Revenue APIを使用して税率ルールを設定するには、以下の手順に従ってください。

  1. ROI360ストア収益設定で以下を完了してください：

    iOS

    Android

  2. 次の情報を開発者に共有してください：
    • 認証キーとして使用するAPI V2トークン
    • 計算対象となる税金を指定するパラメータおよび値（下表参照）
  3. 開発者には、Tax rates REST APIを使用して税率ルールを作成するよう指示してください。本APIはPOSTリクエストのボディにJSONファイルを受け付けます。このJSONファイルには、サポート対象のすべての国とそのデフォルト税率が含まれています。開発者はこのファイルを編集するか、そのまま使用できます。

Tax Rate APIパラメータ

パラメータ 必須 備考
tax_name 必須
  • 顧客請求書に表示される税の名称 
  • （例：Sales、VAT、GST）
tax_rate 必須
  • 0より大きい数値。 小数点以下最大4桁までの税率
  • （例：7.25）
tax_exclusive 任意
  • Boolean（true/false）。 
  • false：税は売上金額に含まれる。 
  • true：税は表示売上に加算される（例：米国やカナダ）。
  • デフォルトはfalse。
country 任意
subdivision 任意
  • 国によっては州・地域単位の指定が可能。 
  • ISO 3166-2コードに準拠。 
  • 国コード＋地域コードを含める必要あり。 
  • 例：US-CA
postal_code 任意
  • 英数字の文字列。 
  • 例：L4J8E3
deduction_order 任意
  • Enum（列挙型）：0, 1, 2 
    • 0：総収益から先にストア手数料を差し引き、その残額から税を控除。 
    • 1：総収益から先に税を差し引き、その残額からストア手数料を控除。 
    • 2：総収益から税とストア手数料を同時に控除。

ストア手数料率の設定

デフォルトでは、AppsFlyerは標準のストア手数料ロジックに基づいて純収益を算出します。アプリが割引手数料や特別な手数料体系の対象となっている場合は、Net Revenue APIを使用してアプリ単位で手数料率を上書きしてください。

例：

  • アプリが以下のような割引プログラムの対象となっている場合：
    • Apple App Store Small Business Program（手数料15%）
    • Google Play 15%サービス手数料（年間収益USD 100万まで）
  • ストア手数料が途中で変更される場合：（AppsFlyerはストア上での手数料ステータスを把握できないため、Net Revenue APIを使用して手動で更新する必要があります。） 例：
    • 割引手数料の適用開始時に手数料率を変更
    • 割引が終了した場合にデフォルトロジックへ戻す

Net Revenue APIによるストア手数料の更新

Net Revenue APIでは、以下の操作が可能です。

  • GETリクエスト：　アカウント配下のアプリに設定されている手数料率を取得
  • POSTリクエスト：　指定した手数料率でカスタム手数料を設定
  • DELETEリクエスト：　該当アプリのカスタム設定を削除し、デフォルトロジックへ戻す

API使用前に、以下を完了してください。

  1. ROI360ストア収益設定で以下を完了してください：

    iOS

    Android

  2. 事前準備：
    • 認証キーとして使用するAPI V2トークン
    • 適用するストア手数料率（サポートしている値: 1% 〜 30%）
    • カスタム手数料を適用するApp ID（複数可）
  3. 設定に関する注意事項：
    • ストア手数料はアプリ単位で設定します
    • 設定可能な値は1%～30%です
    • 設定は新たに受信するイベントにのみ適用されます
    • カスタム手数料が未設定の場合、AppsFlyerはデフォルトのストア手数料ロジックを使用します

リクエスト構造および具体例の詳細については、Net Revenue APIドキュメントを参照してください。