English 中文TürkçeРусскийEspañol日本語

データの相違をトラブルシューティングする

Adapty ユーザーは、異なるソースから得た類似データを比較した際に相違が生じることがあります。特に以下のような比較で発生しやすいです：

  • Adapty チャートとストアレポートの比較
  • Adapty チャートとサードパーティのチャートの比較
  • Adapty 内の異なるチャート同士の比較

トラブルシューティングのアルゴリズム

Adapty と他のプラットフォームの間に生じる相違のほとんどは、想定内であり正常です。異なるソースが同じデータを異なる方法で処理するために発生します。

一方で、Adapty の設定に問題があることを示す場合もあります。

プラットフォーム間でデータが異なると疑われる場合は、生データをエクスポートしてファイルを比較するのが最善です。

  • ストアもデータの処理や表示に関する問題が発生することがあります。最も正確な比較のために、ストアの生トランザクションデータにアクセスしてください。
  • Adapty と別のアナリティクスプラットフォームを比較する場合は、ストアのトランザクションレポートを真実の源として比較の基準にしてください。
  • 限られたデータセットで比較する方が不整合を見つけやすくなります。少量のデータを比較し、特定のプロダクトと 1 日分に絞って確認しましょう。
  • 相違が価格の違いによるものか、イベント数の違いによるものかを特定してください。価格の問題はプロダクトの価格更新で解決できます。イベントの問題はサーバー側の問題を示している可能性があります。
  • イベントフィードを表示して受信イベントを監視してください。予期しない動作に気づくことがあります。

データがどこで乖離しているかを特定したら、以下の一般的な原因を調査してみてください：

サーバー通知と RTDN の問題

ストア接続を正しく設定していない場合、Adapty は必要なイベントデータを受信できません。これは特に、サブスクリプションの更新や請求問題など、ユーザーが直接関与しないイベントに影響します。

できるだけ早くサーバー間の設定を完了し（App Store | Play Store）、ストアが接続を確立するまで待機してください。

不足している App Store Connect のデータは Adapty に手動でアップロードできます。

データの欠落

古いバージョンのアプリを使用しているユーザー

一部のユーザーが Adapty SDK を含まない古いバージョンのアプリを使用している場合、Adapty はそれらのユーザーのデータを受信できません。そのため、Adapty と他のソースの数値が乖離します。

インテグレーションの問題

一部の Adapty インテグレーション（Adjust や AppsFlyer など）は、動作するためにアプリケーションコードの追加が必要です。Adapty ダッシュボードを設定しても、アプリケーションを更新していない場合、必要なデータが Adapty に表示されません。

過去データの欠落

Adapty は、手動でインポートしない限り、アプリケーションの過去データにアクセスできません。チャートの期間が Adapty を導入する前から始まっており、過去データをインポートしていない場合、その値は他のソースと異なります。

データの遅延

Adapty はアプリケーションの経済状況をほぼリアルタイムで分析することを目指しています。ただし、以下の制限と例外があります：

  • Adapty を最初に導入した際、データはすぐに表示されない場合があります。
  • サードパーティプラットフォームとのインテグレーションを有効にした際、データが完全に同期されるまでに遅延が生じる場合があります。
  • Adapty がストアのデータを受信してから、Analytics ページで処理・表示されるまでに15〜30 分かかります。
  • 関係する変数の数が多いため、Adapty とサードパーティ間のデータ交換は常にリアルタイムとは限りません。
  • 一部の高度な指標（コホート予測など）の計算には一定量のデータが必要です。十分なデータが集まったときのみ、Adapty はこれらの計算を実行します。

時間とカレンダー

日付とタイムゾーン

データの相違として認識される最も一般的な原因の一つが、タイムゾーン設定の違いです。

Adapty は UTC タイムゾーンを基準に日数をカウントします。別のプラットフォームが異なるタイムゾーンを使用している場合、計算結果が異なります。スケールを大きくすると差異は小さくなります。

アプリケーションごとにタイムゾーン設定を変更できます。

timezone-setting.webp

Apple の会計カレンダー

Apple は販売期間と支払い日を決定するために独自の会計カレンダーを使用しています。

カレンダーの各「月」は4 週または 5 週で構成されており、隣接するカレンダー月の日数が含まれる場合があります。支払いは通常、販売期間終了後 30〜45 日以内に行われます。

例えば、「2026 年 1 月」の販売期間は、カレンダー月の開始より 4 日前となる 2025 年 12 月 28 日から始まります。この期間の推定支払い日は 3 月 5 日です。

Apple の支払いレポートのデータをカレンダー月と比較しないでください。代わりに、必要な販売期間に対応するカスタム期間を選択してください。

トランザクションの日付

一部のサービス（例：AppsFlyer）では、トランザクションの表示にコホートルールを適用し、トランザクションが発生した日付ではなく、アプリのインストール日に帰属させる場合があります。

収益の計算

手数料と税金

設定によって、Adapty チャートはグロス収益、ストア手数料差し引き後の収益、またはストア手数料と税金差し引き後の収益を表示できます。

revenue-types.webp

一部のストアやサードパーティプラットフォームでは、グロス収益を表示する機能がなかったり、税金を自動的に差し引いたりする場合があります。2 つの異なる収益チャート間で相違が見られる場合は、比較が適切かどうかを確認してください。

キャンセルと返金

プラットフォームによって返金データの表示方法が異なります。Adapty は返金をマイナスの収益として扱います。ユーザーがサブスクリプションを購入し、翌日に返金を申請した場合、両方のイベントが Adapty チャートに反映されます（それぞれ別の日に）。他のプラットフォームでは、返金額を元のトランザクションから差し引く場合があります。

サンドボックス購入

イベントフィードにはサンドボックスアカウントによる購入が表示されます。アナリティクスチャートには表示されません。ただし、過去のインポートデータにサンドボックス購入が含まれている場合、Adapty はそれらを区別できないため、チャートに過去のサンドボックス購入が反映されます。

インストールとダウンロード

ストア（特に Apple App Store）はユーザーのダウンロードを直接追跡できます。統計にはアプリがインストールされたものの、一度も起動されなかったケースが含まれる場合があります。

Adapty はインストールの定義に関わらず、ユーザーがアプリを起動したときのみインストールを記録できます。

install-definitions.webp

国とストア

正確なレポートを確保するために、Adapty はユーザーの国を IP アドレスから推測する場合があります。ストアは常にダウンロードと購入を特定のアプリストアに帰属させます。

両者を明確に区別する必要がある場合は、Country by store account 属性を持つ新しいユーザーセグメントを作成し、セグメントでアナリティクスをフィルタリングできます。

プロダクトの価格

誤ったプロダクト価格が収益の相違を引き起こしている場合、価格を変更しても遡及的には修正されません。既存のトランザクションの価格を変更するには、正しいデータをインポートして強制的に上書きする必要があります。

価格変更後にユーザーが古い購入を復元した場合、Apple は購入価格を誤って報告する場合があります。Adapty が正しい値を反映するには、過去データをインポートする必要があります。

アトリビューションの競合

Adapty は各トランザクションに対して単一のアトリビューションソースのみ使用できます。このデータを後から上書きすることはできません。

セットアップに互いに矛盾する複数のアトリビューションプロバイダーが含まれている場合、2 つの異なるプラットフォーム上の同じトランザクションが 2 つの異なるトラフィックソースを持つように見える場合があります。

用語の違い

プラットフォームによっては、同じ概念に異なる名称を使用している場合があります。収益に関連する指標はプラットフォームによって名称が異なります：

AdaptyApp Store ConnectGoogle Play Console
Gross revenueSalesGross Revenue
Proceeds after store commissionN/AN/A
Proceeds after store commission and taxesProceedsEarnings
ARPPUProceeds per paying userARPPU

他の指標も定義が異なる場合があります：

  • サブスクリプション：
    • Adapty は新規トライアルをサブスクリプションとしてカウントしません。新規サブスクリプションは常に金銭的なトランザクションから開始されます。
    • Google Play Console などの他のプラットフォームでは、最初の支払いが行われる前であっても、各トライアルを新規サブスクリプションとしてカウントする場合があります。
  • リテンション：
    • Adapty はサブスクリプションの更新回数に基づいてリテンションを測定します。
    • App Store Connect は、指定された日にアプリケーションを開いたユーザーをリテインしたとみなします。サブスクリプションを持たないユーザーもカウントされますが、その日にアプリを開かなかったサブスクリプションユーザーはカウントされません。
    • Google Play Console の「Retained Installers」指標は、アプリケーションがユーザーのデバイスにインストールされたままの日数に基づいてリテンションを測定します。アプリを開かないユーザーもこの指標にカウントされます。

新規サブスクリプション指標と subscription_started イベント

新規サブスクリプション指標と subscription_started インテグレーションイベントはそれぞれ異なるものをカウントするため、合計値は一致しません。この指標はトライアルなしで行われた初回購入とトライアルから有料への転換の両方をカウントします。subscription_started イベントはトライアルなしの初回購入のみで発火します。トライアルが有料に転換した場合、Adapty は代わりに trial_converted を送信します。その結果、アプリにトライアル転換がある場合、新規サブスクリプション数は subscription_started イベント数より多くなります。