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 パラメータ