アトリビューション連携

Adapty はサードパーティサービスとの情報交換を行い、サブスクリプションイベントを特定のマーケティングキャンペーンに紐付けることができます。これにより、次のことが可能になります。

どのマーケティング戦略が最も多くの収益をもたらしているかを把握できる
アトリビューションで Adapty のサブスクリプションチャートを絞り込める
サードパーティサービスの機能を活用して Adapty のサブスクリプションデータを分析できる

設定方法は以下の2通りです。

統合アトリビューションは最小限のセットアップで利用でき、9つの主要プラットフォームとデータを連携できます。
手動アトリビューションでは、サードパーティサービスのAPIからアトリビューションデータを自分で取得してから、Adaptyに送信する必要があります。

アプリのエコノミーを包括的に把握するには、Adapty Attribution を有効にしてください。

Adapty Attribution は設定が簡単なウェブダッシュボードで、さまざまなソースのデータを統合して効果的なユーザー獲得戦略を見つけ出せます。

データをクリーンに保ちましょう：イベントの重複やアトリビューションの競合を防いでください。新しいデータソースがアナリティクスを汚染しないよう、データの問題を防ぐ セクションのアドバイスに従ってください。

統合アトリビューション

Adaptyは、9つの人気サービスとのアトリビューション統合をすぐに利用できる形で提供しています。これらのプラットフォームはAdaptyからサブスクリプションデータを自動的に受け取り、各購入を処理して、適切なアトリビューションを返します。

各プラットフォームによってワークフローは異なりますが、手順はどれも同様にシンプルです：

自動データ共有を設定する。 Adaptyが選択したプラットフォームと通信できるよう認証します。
Adapty SDKを統合する。 プラットフォームによっては、アトリビューションデータを設定するための追加コードが必要になります。
他のイベント共有サービスやアトリビューションソースを無効にする。 イベントの重複やデータの競合を防ぐためです。

詳細な統合の概要については、各プラットフォームのガイドをご覧ください：

リストを拡充してほしい場合は、機能リクエストを作成して、特定のサービスへの関心をお知らせください。

手動アトリビューション

Adaptyが選択したサービスとの統合アトリビューションを提供していない場合は、アトリビューションソースとデータをやり取りするコードを自分で記述する必要があります。

アトリビューションサービスからデータを取得する。サービスのAPIを使用してアトリビューションデータをリクエストします。
取得したアトリビューションデータを含むディクショナリを作成する。

ディクショナリには以下のキーを含めることができます：
- status（organic、non-organic、または unknown）
- channel
- campaign
- ad_group
- ad_set
- creative

すべてのキーはオプションです。
リストにないキーはAdaptyに無視されます。
各キーの値は最大50文字まで指定できます。

例:

let attribution = [
    "status": "non_organic",
    "channel": "Google Ads",
    "campaign": "Christmas Sale",
    "ad_group": "ad group 1",
    "ad_set": "ad set 1",
    "creative": "creative id 1"
]

アトリビューションデータを設定する: アトリビューションディクショナリを updateAttribution メソッドに渡します。一度アトリビューション値を設定すると、上書きすることはできません。

Adapty.updateAttribution(attribution, source: "custom") { error in
    if error == nil {
        // successful attribution update
    }
}

パラメータ:

attribution（必須）: アトリビューションデータを含むディクショナリ。
source（必須）: アトリビューションソース。アトリビューションプロバイダーが統合アトリビューションをサポートしていない場合は .custom を設定してください。

他のイベント共有サービスとアトリビューションソースを無効化する — イベントの重複やデータの競合を防ぐためです。

データの問題を防ぐ

アトリビューションソースは1つだけ選択してください

複数のプラットフォームとのアトリビューション連携を同時に有効にしないでください。Adapty が受け付けられるアトリビューションソースは一度に1つだけで、一度保存されたアトリビューション値は上書きできません。

複数のアトリビューションソースを有効にした場合、Adapty は最も多くのデータを持つソースを選択しますが、それが必ずしも最適なデータとは限りません。例えば、iOS ではオーガニックでない Apple Search Ads のアトリビューションが常に優先されます。Apple Search Ads のアトリビューションをオフにするには、App Settings -> Apple Search Ads タブを開き、Receive Apple Search Ads attribution スイッチをオフにしてください。

イベントの重複を避ける

Adaptyを使ってリアルタイムのサブスクリプションデータをアトリビューションサービスと共有している場合、同じ目的を果たす他のサービスを無効にする必要があります。FacebookアカウントをAppsFlyer、Adjust、またはBranchに接続している場合、オプトアウトしない限り、これらのサービスにイベントが自動的に転送されます。

イベントが重複するとアナリティクスが歪み、データの解釈が困難になります。Adaptyのイベント共有を設定したら、サードパーティのイベント転送機能をオフにしてください。