---
title: "Custom S3"
description: "ユーザー獲得データをカスタム S3 互換ストレージにエクスポートして、高度な分析とレポートに活用できます。"
---

Adapty UA のカスタム S3 互換ストレージとの連携により、ユーザー獲得キャンペーンデータを自分専用の S3 互換ストレージに安全に保存できます。キャンペーンのパフォーマンスデータ、アトリビューションデータ、ユーザー獲得イベントを .csv ファイルとしてカスタム S3 バケットに保存できます。  
この連携を設定するには、S3 互換ストレージのコンソールと Adapty UA ダッシュボードでいくつかの手順を行うだけです。

:::note
Adapty UA はデータを毎日 **24時間ごと**、UTC 4:00 に送信します。

各ファイルには、UTC の前日（カレンダー上の 1 日分）に作成されたイベントのデータが含まれます。たとえば、3 月 8 日の UTC 4:00 に自動エクスポートされるファイルには、3 月 7 日の UTC 00:00:00 〜 23:59:59 に作成されたすべてのイベントが含まれます。
:::

## Custom S3 連携の設定 \{#set-up-custom-s3-integration\}

データの受信を開始するには、Adapty UA で連携を設定します。

1. [**Integrations** -> **Custom S3**](https://app.adapty.io/ua/integrations/custom-s3) に移動します。
2. **Export install events to custom S3** トグルをオンにします。
3. カスタム 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 など）から提供されます。                                                                        |

:::note
S3 バケット名フィールドにネストされたディレクトリを指定することもできます（例：`adapty-ua-events/com.sample-app`）。
:::

## 手動データエクスポート \{#manual-data-export\}

カスタム S3 ストレージへの自動イベントデータエクスポートに加えて、Adapty UA では手動でのファイルエクスポート機能も提供しています。この機能を使用すると、ユーザー獲得データの日付を指定して、S3 バケットに手動でエクスポートできます。これにより、エクスポートするデータとタイミングをより細かく制御できます。

## テーブル構造 \{#table-structure\}

Custom S3 連携では、Adapty UA はインストールイベントの履歴データを格納するテーブルを提供します。このテーブルには、ユーザープロファイル、収益・手取り額、元のストアなど、さまざまなデータポイントに関する情報が含まれています。

:::warning
この構造は今後拡張される可能性があります。弊社や連携先のサードパーティが新しいデータを追加することがあります。このデータを処理するコードは、構造全体に依存せず、特定のフィールドのみを参照するよう、堅牢に設計してください。
:::

イベントのテーブル構造は以下のとおりです。

| カラム                   | 説明                               |
|--------------------------|-------------------------------------------|
| `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 コンテンツパラメーター                     |