Custom S3
Adapty UA のカスタム S3 互換ストレージとの連携により、ユーザー獲得キャンペーンデータを自分専用の S3 互換ストレージに安全に保存できます。キャンペーンのパフォーマンスデータ、アトリビューションデータ、ユーザー獲得イベントを .csv ファイルとしてカスタム S3 バケットに保存できます。
この連携を設定するには、S3 互換ストレージのコンソールと Adapty UA ダッシュボードでいくつかの手順を行うだけです。
Adapty UA はデータを毎日 24時間ごと、UTC 4:00 に送信します。
各ファイルには、UTC の前日（カレンダー上の 1 日分）に作成されたイベントのデータが含まれます。たとえば、3 月 8 日の UTC 4:00 に自動エクスポートされるファイルには、3 月 7 日の UTC 00:00:00 〜 23:59:59 に作成されたすべてのイベントが含まれます。
Custom S3 連携の設定
データの受信を開始するには、Adapty UA で連携を設定します。
- Integrations -> Custom S3 に移動します。
- Export install events to custom S3 トグルをオンにします。
- カスタム S3 ストレージと Adapty UA プロファイルを接続するために必要なフィールドを入力します。
| フィールド | 説明 |
|---|---|
| Access Key ID | S3 互換ストレージサービスへのユーザーまたはアプリケーションのアクセスを認証するための一意の識別子です。ストレージプロバイダーのコンソールで確認できます。 |
| Secret Access Key | Access Key ID と組み合わせて、S3 互換ストレージサービスへのアクセスを認証するためのプライベートキーです。ストレージプロバイダーのコンソールで確認できます。 |
| S3 Bucket Name | ストレージ環境内の特定の S3 バケットを識別するグローバルに一意の名前です。S3 バケットは、ファイルや画像などのデータオブジェクトをクラウドに保存・取得できるシンプルなストレージサービスです。 |
| Region（省略可） | Management Console からリージョンを取得してください。 |
| Folder Inside the Bucket（省略可） | 選択した S3 バケット内に作成したいフォルダーの名前です。S3 はオブジェクトキープレフィックス（フォルダー名に相当）を使ってフォルダーを擬似的に表現していることに注意してください。 |
| Custom Endpoint URL | S3 互換ストレージサービスのエンドポイント URL です。ストレージプロバイダー（MinIO、DigitalOcean Spaces、Wasabi など）から提供されます。 |
S3 バケット名フィールドにネストされたディレクトリを指定することもできます（例：adapty-ua-events/com.sample-app）。
手動データエクスポート
カスタム S3 ストレージへの自動イベントデータエクスポートに加えて、Adapty UA では手動でのファイルエクスポート機能も提供しています。この機能を使用すると、ユーザー獲得データの日付を指定して、S3 バケットに手動でエクスポートできます。これにより、エクスポートするデータとタイミングをより細かく制御できます。
テーブル構造
Custom S3 連携では、Adapty UA はインストールイベントの履歴データを格納するテーブルを提供します。このテーブルには、ユーザープロファイル、収益・手取り額、元のストアなど、さまざまなデータポイントに関する情報が含まれています。
この構造は今後拡張される可能性があります。弊社や連携先のサードパーティが新しいデータを追加することがあります。このデータを処理するコードは、構造全体に依存せず、特定のフィールドのみを参照するよう、堅牢に設計してください。
イベントのテーブル構造は以下のとおりです。
| カラム | 説明 |
|---|---|
adapty_profile_id | Adapty プロファイルの一意の識別子 |
install_id | インストールの一意の識別子 |
created_at | レコード作成タイムスタンプ（ISO 8601） |
installed_at | アプリインストールタイムスタンプ（ISO 8601） |
store | アプリストア（ios、android） |
country | ユーザーの国コード（ISO 3166-1 alpha-2） |
ip_address | クライアントの IP アドレス |
idfa | iOS の広告識別子（IDFA） |
idfv | iOS のベンダー識別子（IDFV） |
gaid | Google 広告 ID（Android） |
android_id | Android デバイス ID |
app_set_id | Android App Set ID |
bundle_id | アプリのバンドル識別子（例：com.example.app） |
device_brand | デバイスのブランド（例：Apple、Samsung） |
device_model | デバイスのモデル（例：iPhone15,2） |
os_version | OS のメジャーバージョン |
app_version | Adapty SDK が報告するアプリバージョン |
sdk_version | Adapty SDK のバージョン |
channel | アトリビューションチャネル |
campaign_id | キャンペーン識別子 |
campaign_name | キャンペーン名 |
adset_id | 広告セット識別子 |
adset_name | 広告セット名 |
ad_id | 広告識別子 |
ad_name | 広告名 |
keyword_id | キーワード識別子 |
keyword_name | キーワード名 |
asa_org_id | Apple Search Ads の組織 ID |
asa_keyword_match_type | ASA キーワードマッチタイプ（Exact、Broad） |
asa_attribution | ASA アトリビューションデータ（JSON 文字列） |
asa_conversion_type | ASA コンバージョンタイプ |
asa_country_or_region | ASA の国またはリージョン |
asa_creative_set_name | ASA クリエイティブセット名 |
fbclid | Facebook クリック ID |
ttclid | TikTok クリック ID |
utm_source | UTM ソースパラメーター |
utm_medium | UTM メディアパラメーター |
utm_campaign | UTM キャンペーンパラメーター |
utm_term | UTM タームパラメーター |
utm_content | UTM コンテンツパラメーター |