Adaptyへの過去データのインポート
Adapty SDKをインストールしてアプリをリリースすると、Profilesセクションでユーザーやサブスクライバーを確認できます。しかし、既存のインフラからAdaptyへの移行が必要だったり、既存のデータをAdaptyで確認したいという場合はどうすればよいでしょうか?
データのインポートは必須ではありません
Adapty SDKを統合したアプリをユーザーが開くと、過去のユーザーへのアクセスレベルの付与と購入イベントの復元が自動的に行われます。このケースでは、過去のデータをインポートする必要はありません。ただし、大量の過去のトランザクションがある場合は、データをインポートすることで正確な分析が可能になります。一般的には移行に必須ではありませんが、インポートによって分析精度が向上します。
サポートがトランザクションの apple_original_transaction_id または google_purchase_token をインポートすると、Adapty はその後に届く App Store および Play のサーバー通知を自動的に同じプロファイルに紐付けます。ユーザーがアプリを先に開く必要はありません。
Webhookやその他のインテグレーションがサブスクリプションイベントで報酬(例:仮想通貨)を付与する場合、インポートを開始する前にインテグレーション設定でそのインテグレーションのExclude Historical Eventsを有効にしてください。有効にしないと、インポートされた過去の購入履歴がインテグレーションイベントを再発火させ、報酬付与のWebhookがユーザーがすでに持っている購入に対して報酬を二重に付与してしまいます。詳しくはAdaptyへのインテグレーションのMigrationをご覧ください。
Adaptyにデータをインポートするには:
- トランザクションをCSVファイルにエクスポートしてください(iOS、Android、Stripeは別々のファイルにしてください)。詳細な要件については、以下のインポートファイル形式のセクションを参照してください。
- いずれかのファイルが1 GBを超える場合は、約100行のデータサンプルを用意してください。
- すべてのファイルをGoogle Driveにアップロードしてください(圧縮しても構いませんが、ファイルは分けたままにしておいてください)。
- iOSのトランザクションについては、StoreKit 1を使用している場合でも、App settingsのIn-app purchase APIセクションにIssuer ID、Key ID、およびPrivate key(.P8ファイル)が入力されていることを確認してください。詳しい手順については、Adaptyにアプリ内課金キーを追加するを参照してください。
- メールまたはAdapty Dashboardのオンラインチャットを通じて、リンクをチームと共有してください。
既存のデータと重複する場合でも、過去のデータをインポートしても重複が作成されることはありません。ご安心ください。
Androidの既知の制限事項
- アクティブなサブスクリプションのみが復元されます。期限切れのトランザクションは復元されません。
- サブスクリプションの最新の更新のみが復元されます。購入の全チェーンは復元されません。
- 購入後にプロダクト価格が変更された場合、現在の価格が使用されるため、価格が正しく表示されないことがあります。
Androidトランザクションの件数が多い場合、デフォルトのAPI制限を超えないよう、インポートを開始する前にGoogle Play Developer APIのクォータ増加をリクエストする必要があるかもしれません。
インポートファイルの形式
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_id | iOS では必須 | オリジナルトランザクションID(OTID)(詳細)。StoreKit 2 のインポートメカニズムで使用されます。1人のユーザーが複数の OTID を持つ場合がありますが、インポートを成功させるには少なくとも1つを指定すれば十分です。 注意: このインポートを行うには、Adapty ダッシュボードにアプリ内課金 API の認証情報を設定する必要があります。設定方法はこちらをご確認ください。 |
| google_product_id | Google では必須 | Google Play ストアのプロダクト ID |
| google_purchase_token | Google では必須 | ユーザーと購入したアプリ内プロダクトのプロダクト ID を表す一意の識別子 |
| google_is_subscription | Google では必須 | 指定可能な値は 1 | 0 |
| stripe_token | Stripe では必須 | 一意の購入を表す 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) |
| 任意 | ユーザーのメールアドレス | |
| 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 個のカスタム属性を定義します:
形式: 形式における二重引用符と一重引用符の使い方に注意してください。ブール値と整数は浮動小数点数に変換されます。 |
必須フィールド
各プラットフォームには、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 ダッシュボードのオンラインチャットよりお問い合わせください。