Adapty アトリビューションのカスタム S3
Adapty Attributionとカスタムのs3互換ストレージとの統合により、ユーザー獲得キャンペーンデータを独自のS3互換ストレージに安全に保存できます。キャンペーンのパフォーマンスデータ、アトリビューションデータ、ユーザー獲得イベントを.csvファイルとしてカスタムS3バケットに保存できます。
この統合を設定するには、S3互換ストレージのコンソールとAdapty Attributionダッシュボードでいくつかの簡単な手順を実行する必要があります。
Adapty Attributionは、UTC 4:00に24時間ごとにデータを送信します。 各ファイルには、UTC で前日の 1 日分（カレンダー上）に作成されたイベントのデータが含まれます。たとえば、3 月 8 日の 4:00 UTC に自動エクスポートされたデータには、3 月 7 日の 00:00:00 ～ 23:59:59 UTC に作成されたすべてのイベントが含まれます。
Custom S3 インテグレーションのセットアップ
データの受信を開始するには、Adapty Attribution でインテグレーションを設定します。
- Integrations -> Custom S3 に移動します。
- Export install events to custom S3 トグルをオンにします。
- 必須フィールドに入力して、カスタム S3 ストレージと Adapty Attribution プロファイルの接続を構築します。 | フィールド | 説明 | |:----------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Access Key ID | S3互換ストレージサービスへのアクセスを認証するための一意の識別子です。ストレージプロバイダーのコンソールで確認できます。 | | Secret Access Key | Access Key IDと組み合わせて、S3互換ストレージサービスへのアクセスを認証するための秘密鍵です。ストレージプロバイダーのコンソールで確認できます。 | | S3 Bucket Name | ストレージ環境内の特定のS3バケットを識別するグローバルに一意の名前です。S3バケットはシンプルなストレージサービスで、ファイルや画像などのデータオブジェクトをクラウドに保存・取得できます。 | | Region（任意） | Management ConsoleでRegionを確認してください。 | | 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 バケットに手動でエクスポートできます。これにより、エクスポートするデータとタイミングをより細かく制御できます。
テーブル構造
カスタム S3 インテグレーションでは、Adapty Attribution がインストールイベントの履歴データを保存するテーブルを提供します。このテーブルには、ユーザープロファイル、収益と手取り額、オリジンストアなど、さまざまなデータが含まれています。
この構造は、Adapty または連携するサードパーティによる新しいデータの追加に伴い、今後拡張される可能性があります。このデータを処理するコードは、構造全体に依存せず、特定のフィールドのみを参照するよう、堅牢に実装してください。
イベントのテーブル構造は以下のとおりです。
| カラム | 説明 |
|---|---|
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 source パラメータ |
utm_medium | UTM medium パラメータ |
utm_campaign | UTM campaign パラメータ |
utm_term | UTM term パラメータ |
utm_content | UTM content パラメータ |