AdMate のオフラインスナップショットの仕組み

AdMate は、プロバイダーにすぐ問い合わせできないときでも、一部の概要データを表示できるようにしています。このオフラインスナップショットにより、一時的なネットワークの問題があってもアプリ、ウィジェット、Apple Watch を活用できますが、スナップショットはある時点で取得したコピーであり、プロバイダーがリアルタイムで保証する値ではありません。

この違いを理解しておけば、キャッシュされた値を確定した収益と取り違えることを防げます。

AdMate

すべての収益を1つのダッシュボードで

複数のアカウントのAdMob、AdSense、RevenueCat、App Store Connectをアプリ、プラットフォーム、国別のフィルターで確認

iPhone、iPad、Mac、Apple Watchで収益、クリック、eCPM、サブスクリプション、インストール、支払いを監視

スナップショットとは

スナップショットは、読み込みに成功したあとに保存される、対応するダッシュボードデータの記録です。概要に必要な値や、アプリの拡張機能が必要とする情報を含むことがあります。正確な内容はサービスや機能によって異なります。

継続して使えることと、すばやく表示することを目的としています。プロバイダーのすべてのレスポンス、トランザクション、財務レポートを完全に写したものではありません。

AdMate がスナップショットを使う理由

プロバイダーの API にはネットワーク接続と認可が必要
ウィジェットは実行時間が限られ、プラットフォームが管理するスケジュールで更新される
Apple Watch は、ペアリングした iPhone から同期されたデータに頼ることがある
短時間の障害中でもダッシュボードを理解できる状態に保つ必要がある
画面ごとにすべてのレポートを何度もダウンロードするのは非効率

より詳細なプロバイダーとのやり取りはメインアプリが担い、拡張機能は対応する共有データを利用します。

オフラインの値を読み取る方法

その値をもとに行動する前に、次のことを確認してください。

どのサービスとアカウントから得た値か
どの期間を表しているか
最後に更新されたのはいつか
指標は推定値か確定値か
デバイスは現在オンラインで認可されているか

鮮度が重要な場合は、メインアプリを開いて更新してください。オフラインのカードが変わっていないからといって、プロバイダー側も変わっていないとは限りません。

ウィジェットと Apple Watch

ウィジェットやウォッチの画面は、ひと目で確認できるデータを優先します。更新や同期の機会は OS が管理しているため、メインアプリより遅れて更新されることがあります。

現在の傾向、最後に確認できた概要、手早く見たい指標など、状況を把握するために使いましょう。照合、アカウントの変更、慎重なトラブルシューティングには、更新済みのメインアプリとプロバイダーの公式レポートを使ってください。

認証情報が変わったあとに起きること

認証情報の期限が切れたり、別の場所でアカウントが削除されたり、アクセス権が変わったりしたあとも、古いスナップショットがしばらく表示されることがあります。これは、古い認可がまだ有効だという意味ではありません。

アプリを開いて更新を試し、プロバイダーのエラーを解決してください。デバイスからアカウントを削除する場合は、そのデバイスを他人に渡す前に、拡張機能と共有していたデータがもう使われていないことを確認してください。

安全なオフラインでの使い方

値は「最後に確認できた値」として扱う
プロバイダーとアカウントの表示を残しておく
異なる時点で取得したスナップショットを組み合わせない
重要な結果を共有する前に更新する
会計にはプロバイダーの確定データを使う
キャッシュされた業務データも機密性が高い場合があるため、デバイスを保護する

古いデータのトラブルシューティング

メインアプリは更新されるのに拡張機能が遅れている場合は、プラットフォームが再読み込みするまで待ち、正しいアカウントが有効になっているか確認してください。メインアプリ自体が更新できない場合は、データを消去する前にネットワーク、認可、プロバイダーの状態を確認します。

最初に再インストールするのは避けてください。不具合の原因となったプロバイダーの権限は直らないまま、役立つ情報が消えてしまうことがあります。

よくある質問

オフラインモードではすべてのトランザクションがダウンロードされますか？

いいえ。スナップショットは一部の概要と共有画面のためのもので、プロバイダーの完全なアーカイブではありません。

ウィジェットとメインアプリの表示が違うのはなぜですか？

取得した時刻や更新のスケジュールが異なる場合があります。最新の表示を見るには、メインアプリを更新してください。

オフラインの金額は確定値ですか？

いいえ。その状態は元のプロバイダーの指標に従っており、推定値である場合があります。

スナップショットを会計に使えますか？

代わりに、プロバイダーの確定書類と支払いの記録を使ってください。