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

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 アトリビューションがバケットへ生データレポートをアップロードできるようにするには、対象バケットへの書き込み権限を持つユーザーのアクセスキー ID とシークレットアクセスキーを提供する必要があります。

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

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

4. 次のステップでは、Add user to group オプションを選択し、Create group ボタンをクリックしてください。

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

7. グループの作成が完了したら、それを選択して次のステップに進んでください

8. このセクションの最後のステップですので、Create User ボタンをクリックして次に進んでください。

9. 最後に、認証情報を .csv 形式でダウンロードするか、ダッシュボードから直接コピー＆ペーストすることができます。

ステップ 2. Adapty Attribution でインテグレーションを設定する

1. Integrations -> Amazon S3 に移動します。
2. Export install events to Amazon S3 トグルをオンにします。
3. Amazon S3 と Adapty Attribution プロファイルの接続を構築するために、以下のフィールドを入力します。 | フィールド | 説明 | |:-----------------------------| :----------------------------------------------------------- | | Access Key ID | AWS サービスへのアクセスを認証するために使用される一意の識別子です。このIDはダウンロードした csv ファイル に記載されています。 | | Secret Access Key | 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 アトリビューションはインストールイベントの履歴データを保存するテーブルを提供します。このテーブルには、ユーザープロファイル、収益と手取り額、オリジンストアなど、さまざまなデータポイントの情報が含まれています。

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

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