Adapty UA の Amazon S3 インテグレーションを使用すると、ユーザー獲得キャンペーンデータを一か所に安全に保存できます。キャンペーンのパフォーマンスデータ、アトリビューションデータ、ユーザー獲得イベントを .csv ファイルとして Amazon S3 バケットに保存できます。
このインテグレーションを設定するには、AWS コンソールと Adapty UA ダッシュボードでいくつかの簡単な手順を行う必要があります。

Amazon S3 インテグレーションのセットアップ方法

データの受信を開始するには、以下の認証情報が必要です：

1. アクセスキー ID
2. シークレットアクセスキー
3. S3 バケット名
4. S3 バケット内のフォルダ名

ステップ 1. Amazon S3 認証情報の作成

このガイドでは、AWS コンソールで必要な認証情報を作成する方法を説明します。

1.1. アクセスポリシーの作成

1. AWS コンソールの IAM ポリシーダッシュボード に移動します
2. Create Policy オプションを選択します

3. ポリシーエディターで以下の JSON を貼り付け、adapty-s3-integration-test をご自身のバケット名に変更します：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowListObjectsInBucket",
            "Effect": "Allow",
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::adapty-s3-integration-test"
        },
        {
            "Sid": "AllowAllObjectActions",
            "Effect": "Allow",
            "Action": "s3:*Object",
            "Resource": [
                "arn:aws:s3:::adapty-s3-integration-test/*",
                "arn:aws:s3:::adapty-s3-integration-test"
            ]
        },
        {
            "Sid": "AllowBucketLocation",
            "Effect": "Allow",
            "Action": "s3:GetBucketLocation",
            "Resource": "arn:aws:s3:::adapty-s3-integration-test"
        }
    ]
}

4. ポリシーの設定が完了したら、タグを追加することもできます（省略可能）。その後、Next をクリックして最終ステップに進みます
5. このステップでポリシーに名前を付け、Create policy ボタンをクリックして作成を完了します

1.2. IAM ユーザーの作成

Adapty UA が生データレポートをバケットにアップロードできるようにするには、特定のバケットへの書き込みアクセス権を持つユーザーのアクセスキー ID とシークレットアクセスキーを提供する必要があります。

1. IAM コンソールに移動し、ユーザーセクション を選択します
2. Add users ボタンをクリックします

3. ユーザーに名前を付け、Access key – Programmatic access を選択して、権限の設定に進みます

4. 次のステップで Add user to group オプションを選択し、Create group ボタンをクリックします

5. ユーザーグループに名前を付け、先ほど作成したポリシーを選択します
6. ポリシーを選択したら、Create group ボタンをクリックしてプロセスを完了します

7. グループを正常に作成したら、それを選択して次のステップに進みます

8. このセクションの最終ステップですので、Create User ボタンをクリックして進みます

9. 最後に、認証情報を .csv 形式でダウンロードするか、ダッシュボードから直接コピーして貼り付けることができます

ステップ 2. Adapty UA でのインテグレーション設定

1. Integrations -> Amazon S3 に移動します
2. Export install events to Amazon S3 トグルをオンにします
3. 以下のフィールドに入力して、Amazon S3 と Adapty UA プロファイルの接続を設定します：

フィールド	説明
Access Key ID	AWS サービスへのユーザーまたはアプリケーションのアクセスを認証するための一意の識別子です。この ID はダウンロードした csv ファイル で確認できます。
Secret Access Key	アクセスキー ID と組み合わせて AWS サービスへのアクセスを認証するためのプライベートキーです。このキーはダウンロードした csv ファイル で確認できます。
S3 Bucket Name	AWS クラウド内の特定の S3 バケットを識別するグローバルに一意の名前です。S3 バケットは、ファイルや画像などのデータオブジェクトをクラウドに保存・取得できるシンプルなストレージサービスです。
Folder Inside the Bucker	選択した S3 バケット内に作成したいフォルダの名前です。S3 はオブジェクトキープレフィックス（実質的にフォルダ名）を使用してフォルダをシミュレートしていることにご注意ください。
Region（省略可能）	AWS マネジメントコンソールの IAM ユーザーアカウントでリージョンを確認できます。

手動データエクスポート

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

テーブル構造

AWS 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 広告識別子（Identifier for Advertisers）
idfv	iOS ベンダー識別子（Identifier for Vendors）
gaid	Google 広告 ID（Android）
android_id	Android デバイス ID
app_set_id	Android App Set ID
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 コンテンツパラメータ