Adaptyへの過去データのインポート

Adapty SDKをインストールしてアプリをリリースすると、Profilesセクションでユーザーやサブスクライバーを確認できます。しかし、既存のインフラからAdaptyへの移行が必要だったり、既存のデータをAdaptyで確認したいという場合はどうすればよいでしょうか?

Note

データのインポートは必須ではありません

Adapty SDKを統合したアプリをユーザーが開くと、過去のユーザーへのアクセスレベルの付与と購入イベントの復元が自動的に行われます。このケースでは、過去のデータをインポートする必要はありません。ただし、大量の過去のトランザクションがある場合は、データをインポートすることで正確な分析が可能になります。一般的には移行に必須ではありませんが、インポートによって分析精度が向上します。

サポートがトランザクションの apple_original_transaction_id または google_purchase_token をインポートすると、Adapty はその後に届く App Store および Play のサーバー通知を自動的に同じプロファイルに紐付けます。ユーザーがアプリを先に開く必要はありません。

Warning

Webhookやその他のインテグレーションがサブスクリプションイベントで報酬(例:仮想通貨)を付与する場合、インポートを開始する前にインテグレーション設定でそのインテグレーションのExclude Historical Eventsを有効にしてください。有効にしないと、インポートされた過去の購入履歴がインテグレーションイベントを再発火させ、報酬付与のWebhookがユーザーがすでに持っている購入に対して報酬を二重に付与してしまいます。詳しくはAdaptyへのインテグレーションのMigrationをご覧ください。

Adaptyにデータをインポートするには:

  1. トランザクションをCSVファイルにエクスポートしてください(iOS、Android、Stripeは別々のファイルにしてください)。詳細な要件については、以下のインポートファイル形式のセクションを参照してください。
  2. いずれかのファイルが1 GBを超える場合は、約100行のデータサンプルを用意してください。
  3. すべてのファイルをGoogle Driveにアップロードしてください(圧縮しても構いませんが、ファイルは分けたままにしておいてください)。
  4. iOSのトランザクションについては、StoreKit 1を使用している場合でも、App settingsのIn-app purchase APIセクションにIssuer ID、Key ID、およびPrivate key(.P8ファイル)が入力されていることを確認してください。詳しい手順については、Adaptyにアプリ内課金キーを追加するを参照してください。
  5. メールまたはAdapty Dashboardのオンラインチャットを通じて、リンクをチームと共有してください。

既存のデータと重複する場合でも、過去のデータをインポートしても重複が作成されることはありません。ご安心ください。

Androidの既知の制限事項

  1. アクティブなサブスクリプションのみが復元されます。期限切れのトランザクションは復元されません。
  2. サブスクリプションの最新の更新のみが復元されます。購入の全チェーンは復元されません。
  3. 購入後にプロダクト価格が変更された場合、現在の価格が使用されるため、価格が正しく表示されないことがあります。
Note

Androidトランザクションの件数が多い場合、デフォルトのAPI制限を超えないよう、インポートを開始する前にGoogle Play Developer APIのクォータ増加をリクエストする必要があるかもしれません。

インポートファイルの形式

Tip

RevenueCatから移行する場合、RevenueCatのエクスポートファイルをそのまま送信できます。変換は不要です。エクスポート手順についてはRevenueCatのドキュメントを参照してください。

以下のルールに従ったファイルでデータを準備してください:

  • ファイル形式は .CSV です。
  • Android、iOS、Stripe のインポートファイルはそれぞれ別のファイルです。
  • すべてのインポートファイルに必須カラムが含まれています。
  • インポートファイルのカラムにはヘッダーがあります。
  • カラムのヘッダーは、下の表の Column name カラムに記載されているとおりです。タイプミスがないか確認してください。
  • 必須でないカラムはファイルから省略できます。データがない項目のために空のカラムを追加しないでください。
  • インポートファイルには、表に記載されていない余分なカラムを含めないでください。含まれている場合は削除してください。
  • 値はカンマで区切ってください。
  • 値を引用符で囲まないでください。
  • 1 人のユーザーに複数の apple_original_transaction_id がある場合は、apple_original_transaction_id ごとに別の行として追加してください。そうしないと、消耗型アイテムの購入を復元できない場合があります。

サンプルファイルとして、iOSおよびAndroidのファイルをご利用ください。

インポートファイルの利用可能なカラム

カラム名必須/任意説明
user_id必須ユーザーのID
apple_original_transaction_idiOS では必須

オリジナルトランザクションID(OTID)(詳細)。StoreKit 2 のインポートメカニズムで使用されます。1人のユーザーが複数の OTID を持つ場合がありますが、インポートを成功させるには少なくとも1つを指定すれば十分です。

注意: このインポートを行うには、Adapty ダッシュボードにアプリ内課金 API の認証情報を設定する必要があります。設定方法はこちらをご確認ください。

google_product_idGoogle では必須Google Play ストアのプロダクト ID
google_purchase_tokenGoogle では必須ユーザーと購入したアプリ内プロダクトのプロダクト ID を表す一意の識別子
google_is_subscriptionGoogle では必須指定可能な値は 1 | 0
stripe_tokenStripe では必須一意の購入を表す Stripe オブジェクトのトークン。Stripe のサブスクリプション(sub_...)またはペイメントインテント(pi_...)のトークンを指定できます。
subscription_expiration_date任意サブスクリプションの有効期限日(次回請求日)。タイムゾーン付きの日時形式(2020-12-31T23:59:59-06:00)
created_at任意プロファイル作成の日時(2019-12-31 23:59:59-06:00)
birthday任意ユーザーの生年月日(形式:2000-12-31)
email任意ユーザーのメールアドレス
gender任意ユーザーの性別
phone_number任意ユーザーの電話番号
country任意ISO 3166-1 alpha-2 形式
first_name任意ユーザーの名
last_name任意ユーザーの姓
last_seen任意タイムゾーン付きの日時(2020-12-31T23:59:59-06:00)
idfa任意広告識別子(IDFA)。Apple がユーザーのデバイスに割り当てるランダムなデバイス識別子。iOS アプリにのみ適用されます。
idfv任意ベンダー識別子(IDFV)。同一デベロッパーが開発したすべてのアプリに割り当てられる一意のコード。iOS アプリにのみ適用されます。
advertising_id任意広告 ID。Android OS が割り当てる一意のコードで、広告主がユーザーのデバイスを識別するために使用することがあります。
amplitude_user_id任意Amplitude のユーザー ID
amplitude_device_id任意Amplitude のデバイス ID
mixpanel_user_id任意Mixpanel のユーザー ID
appmetrica_profile_id任意AppMetrica のユーザープロファイル ID
appmetrica_device_id任意AppMetrica のデバイス ID
appsflyer_id任意AppsFlyer の一意の識別子
adjust_device_id任意Adjust のデバイス ID
facebook_anonymous_id任意Facebook にログインしていない状態でアプリやウェブサイトを利用したユーザーに対して Facebook が生成する一意の識別子
branch_id任意Branch の一意の識別子
attribution_source任意アトリビューションのソースインテグレーション(例:appsflyer)
attribution_status任意organic
attribution_channel任意トランザクションをもたらしたアトリビューションチャネル
attribution_campaign任意トランザクションをもたらしたアトリビューションキャンペーン
attribution_ad_group任意トランザクションをもたらしたアトリビューションの広告グループ
attribution_ad_set任意トランザクションをもたらしたアトリビューションの広告セット
attribution_creative任意広告やマーケティングキャンペーンで使用される具体的なビジュアルまたはテキスト要素。クリック、コンバージョン、インストールなどの目標アクションの達成に対する効果を測定するために追跡されます。
custom_attributes任意キーと値の形式の JSON 辞書として最大 30 個のカスタム属性を定義します:
  • key:(文字列)カスタム属性の名前
  • value:(文字列、整数、浮動小数点数、またはブール値)カスタム属性の値

形式:"{'string_value': 'some_value', 'float_value': 123.0, 'int_value': 456}"

形式における二重引用符と一重引用符の使い方に注意してください。ブール値と整数は浮動小数点数に変換されます。

必須フィールド

各プラットフォームには、user_idと対応するプラットフォーム固有の購入を識別するデータという2つの必須フィールドグループがあります。プラットフォームごとの必須フィールドは下記の表を参照してください。

プラットフォーム必須フィールド
iOS

user_id

apple_original_transaction_id

Android

user_id

google_product_id

google_purchase_token

google_is_subscription

Stripe

user_id

stripe_token

これらのフィールドがなければ、Adaptyはトランザクションを取得できません。

正確なコホートアナリティクスのために、created_atを指定してください。指定しない場合、インストール日は最初の購入日と同じとみなされます。

データをAdaptyにインポートする

インポートファイルをご用意の上、support@adapty.io または Adapty ダッシュボードのオンラインチャットよりお問い合わせください。