アトリビューション連携

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

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

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

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

Tip

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

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

Warning

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

統合アトリビューション

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

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

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

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

Note

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

手動アトリビューション

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

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

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

Important

すべてのキーはオプションです。
リストにないキーは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"
]

アトリビューションデータを設定する: アトリビューションディクショナリを updateExternalAttribution メソッド（SDK バージョン 4.1 より前は updateAttribution という名前）に渡します。Adapty がアトリビューション値を保存した後は、上書きすることができません。
```
Adapty.updateExternalAttribution(attribution, provider: .custom) { error in
    if error == nil {
        // attribution data accepted for processing
    }
}
```

Info

成功の結果は、バックエンドがアトリビューションデータを非同期処理のために受け付けたことを示すものであり、すでにプロファイルに適用されたことを意味するわけではありません。呼び出しが成功した直後に AdaptyProfile.appliedExternalAttributionProviders にプロバイダーが表示されることを期待せず、代わりにプロファイルの更新を待ってください。

パラメーター：

attribution（必須）: アトリビューションデータを含む辞書。
- provider（必須; SDK バージョン 4.1 以前は source という名前）: アトリビューションプロバイダー。アトリビューションプロバイダーが連携済みアトリビューションをサポートしていない場合は、.custom（SDK 4.1 以降）を使用してください。それ以前のバージョンでは、文字列 "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のイベント共有を設定したら、サードパーティのイベント転送機能をオフにしてください。