---
title: "データの相違をトラブルシューティングする"
description: "データの乖離の原因を探る"
---

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

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

## トラブルシューティングのアルゴリズム \{#troubleshooting-algorithm\}

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

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

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

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

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

## サーバー通知と RTDN の問題 \{#issues-with-server-notifications-and-rtdn\}

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

できるだけ早くサーバー間の設定を完了し（[App Store](enable-app-store-server-notifications) | [Play Store](enable-real-time-developer-notifications-rtdn)）、ストアが接続を確立するまで[待機](#data-delays)してください。

不足している App Store Connect のデータは Adapty に[手動でアップロード](importing-historical-data-to-adapty)できます。

## データの欠落 \{#missing-data\}

### 古いバージョンのアプリを使用しているユーザー \{#users-with-out-of-date-app-versions\}

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

### インテグレーションの問題 \{#integration-issues\}

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

### 過去データの欠落 \{#missing-historical-data\}

Adapty は、[手動でインポート](importing-historical-data-to-adapty)しない限り、アプリケーションの過去データにアクセスできません。チャートの[期間](controls-filters-grouping-compare-proceeds#set-the-date-range)が Adapty を導入する前から始まっており、過去データをインポートしていない場合、その値は他のソースと異なります。

## データの遅延 \{#data-delays\}

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

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

## 時間とカレンダー \{#time-and-calendar\}

#### 日付とタイムゾーン \{#dates-and-timezones\}

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

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

アプリケーションごとに[タイムゾーン設定を変更](general#3-reporting-timezone)できます。

#### Apple の会計カレンダー \{#the-apple-fiscal-calendar\}

Apple は販売期間と支払い日を決定するために独自の[会計カレンダー](https://adapty.io/apple-fiscal-calendar/)を使用しています。

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

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

Apple の支払いレポートのデータをカレンダー月と比較しないでください。代わりに、必要な販売期間に対応する[カスタム期間](controls-filters-grouping-compare-proceeds#set-the-date-range)を選択してください。

#### トランザクションの日付 \{#transaction-dates\}

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

## 収益の計算 \{#revenue-calculation\}

### 手数料と税金 \{#fees-and-taxes\}

[設定](controls-filters-grouping-compare-proceeds#display-gross-or-net-revenue)によって、Adapty チャートは**グロス収益**、**ストア手数料差し引き後の収益**、または**ストア手数料と税金差し引き後の収益**を表示できます。

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

### キャンセルと返金 \{#cancellations-and-refunds\}

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

## サンドボックス購入 \{#sandbox-purchases\}

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

## インストールとダウンロード \{#installs-and-downloads\}

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

Adapty は[インストールの定義](general#4-installs-definition-for-analytics)に関わらず、ユーザーがアプリを起動したときのみインストールを記録できます。

## 国とストア \{#country-and-store\}

正確なレポートを確保するために、Adapty はユーザーの国を IP アドレスから[推測する場合があります](controls-filters-grouping-compare-proceeds#filter-and-group-data)。ストアは常にダウンロードと購入を特定のアプリストアに帰属させます。

両者を明確に区別する必要がある場合は、`Country by store account` 属性を持つ[新しいユーザーセグメントを作成](segments)し、[セグメントでアナリティクスをフィルタリング](controls-filters-grouping-compare-proceeds#filter-and-group-data)できます。

## プロダクトの価格 \{#product-pricing\}

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

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

## アトリビューションの競合 \{#attribution-conflicts\}

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

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

## 用語の違い \{#differences-in-terminology\}

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

| Adapty | App Store Connect | Google Play Console |
|--------|-------------------|----------------------|
| **Gross revenue** | Sales | Gross Revenue |
| **Proceeds after store commission** | N/A | N/A |
| **Proceeds after store commission and taxes** | Proceeds | Earnings |
| **ARPPU** | Proceeds per paying user | ARPPU |

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

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

## 新規サブスクリプション指標と `subscription_started` イベント \{#new-subscriptions-metric-vs-the-subscription_started-event\}

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