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

Google Cloud Storage 連携の設定方法

ステップ 1. Google Cloud Storage の認証情報を作成する

このガイドでは、Google Cloud Platform コンソールで必要な認証情報を作成する手順を説明します。

Adapty Attribution が指定したバケットにローデータレポートをアップロードするには、サービスアカウントのキーと、対応するバケットへの書き込みアクセス権が必要です。サービスアカウントのキーを提供し、バケットへの書き込みアクセスを許可することで、Adapty Attribution がプラットフォームからストレージ環境へローデータレポートを安全かつ効率的に転送できるようになります。

2.1. サービスアカウントの作成

1. Google CloudアカウントのIAMセクションに移動し、対象のプロジェクトを選択するか、新しいプロジェクトを作成します。

2. 次に、「+ CREATE SERVICE ACCOUNT」ボタンをクリックして、Adapty アトリビューション用の新しいサービスアカウントを作成します。

3. アクセス権限は後の手順で付与するため、最初のステップではフィールドに必要事項を入力してください。このページの詳細については、こちらのドキュメントをご参照ください。

4. プライベートJSONキーを作成してダウンロードするには、KEYSセクションに移動し、「ADD KEY」ボタンをクリックします

5. DETAILS セクションで、先ほど作成したサービスアカウントに紐づいている Email の値を見つけ、コピーしてください。この情報は、後続の手順でアカウントを認証し、バケットへの書き込みを許可するために必要になります。

2.2. バケットの権限を設定する

6. Google Cloud StorageのBucketsページに移動し、既存のバケットを選択するか、Adapty アトリビューションのユーザー獲得データレポートを保存するための新しいバケットを作成します。
7. PERMISSIONSセクションに移動し、アクセスを付与するオプションを選択します。

8. PERMISSIONS セクションで、先ほど第5ステップで取得したサービスアカウントのメールアドレスを入力し、Storage Object Creator ロールを選択します
9. 最後に SAVE をクリックして変更を適用します

10. バケット名は後で使用するため、必ず控えておいてください。

11. これらの手順が完了すると、Google Cloud Console での必要なセットアップが完了です！最後のステップとして、バケット名を入力し、Adapty アトリビューションで使用するための JSON ファイルをダウンロードします。

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

1. Integrations -> Google Cloud Storage に移動します
2. Export install events to Google Cloud Storage トグルをオンにします
3. Google Cloud Storage と Adapty Attribution 間の接続を構築するために、必要なフィールドを入力します: | フィールド | 説明 | |:------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Google Cloud service account key file | ダウンロードしたプライベート JSON キーファイル。 | | Google Cloud bucket name | データを保存する Google Cloud Storage 上のバケット名。Google Cloud Storage 環境内で一意である必要があり、スペースを含めることはできません。 | | Folder inside the bucket | バケット内でデータを保存するフォルダ名。バケット内で一意である必要があり、データの整理に利用できます。このフィールドへの入力は任意です。 |

手動データエクスポート

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

テーブル構造

Google Cloud Storage 連携では、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 source パラメータ
utm_medium	UTM medium パラメータ
utm_campaign	UTM campaign パラメータ
utm_term	UTM term パラメータ
utm_content	UTM content パラメータ