Adapty アトリビューションのカスタム S3
Adapty AttributionとカスタムのカスタムのカスタムのカスタムのカスタムのS3互換ストレージとの連携により、ユーザー獲得キャンペーンデータを自社のS3互換ストレージソリューションに安全に保存できます。キャンペーンのパフォーマンスデータ、アトリビューションデータ、ユーザー獲得イベントを、カスタムS3バケットに.csvファイルとして保存できます。この連携を設定するには、S3互換ストレージのコンソールとAdapty Attributionダッシュボードでいくつかの簡単な手順を行う必要があります。
Adapty アトリビューションのエクスポートは、カレンダーの1日につき1セットのファイルを出力します。エクスポートスケジューラーは1日3回（02:00、04:00、06:00 UTC）実行されます。各実行では、前日のエクスポートジョブがまだ存在しない場合はそれを作成し、以前の実行が失敗していた場合は再試行します。そのため、データは通常 02:00 の実行後に届き、それ以降の実行は追加データのためではなく、失敗時のリカバリーとして機能します。
各ファイルには、UTC基準で前日のカレンダー上の1日に作成されたイベントのデータが含まれます。たとえば、3月8日にエクスポートされたデータには、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 ソースパラメータ |
utm_medium | UTM メディアパラメータ |
utm_campaign | UTM キャンペーンパラメータ |
utm_term | UTM タームパラメータ |
utm_content | UTM コンテンツパラメータ |
click_time | アトリビューションされたクリックのタイムスタンプ（Unix 秒）。インストールにクリックが紐づいていない場合は空。 |