アトリビューション連携

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

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

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

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

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

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

Warning

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

統合アトリビューション

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

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

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

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

Adjust、AppsFlyer、Branch、Singular では 合成イベント(トライアルやサブスクリプションが最初の数日間を生き残ったことを示すシグナル)を受け取ることもできます。Meta および TikTok キャンペーンについては、Adapty アトリビューションが代わりに Qualified trials を提供しています。

Note

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

手動アトリビューション

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

  1. アトリビューションサービスからデータを取得する。サービスのAPIを使用してアトリビューションデータをリクエストします。

  2. 取得したアトリビューションデータを含むディクショナリを作成する。

    ディクショナリには以下のキーを含めることができます:

    • status(organic、non-organic、または unknown)
    • channel
    • campaign
    • ad_group
    • ad_set
    • creative
Important
  • キーはすべて省略可能です。
  • リストにないキーは Adapty に無視されます。
  • 各キーの値は最大 50 文字です。

例:

  1. アトリビューションデータを設定する:

    アトリビューションの辞書を updateExternalAttribution メソッド(SDK バージョン 4.1 より前は updateAttribution という名前)に渡します。Adapty がアトリビューションの値を保存した後は、上書きできません:

Adapty.updateExternalAttribution(attribution, source = AdaptyAttributionSource.CUSTOM) { error ->
    if (error == null) {
        // attribution data accepted for processing
    }
}
Info

appliedExternalAttributionProviders は Apple Ads からのアトリビューションのみを報告します。他のプロバイダからのアトリビューションはユーザープロファイルで確認でき、セグメントフィルターでも利用できますが、ここにはまだ表示されません。

パラメーター:

  • attribution (必須): アトリビューションデータを含むディクショナリ。
    • provider (必須; SDK バージョン 4.1 より前は source という名前): アトリビューションプロバイダー。お使いのアトリビューションプロバイダーが統合アトリビューションをサポートしていない場合はカスタム値を使用してください — iOS では .custom、Android および Kotlin Multiplatform では AdaptyExternalAttributionProvider.CUSTOM、Unity では AdaptyExternalAttributionProvider.Custom、Flutter では AdaptyExternalAttributionProvider.custom、Capacitor および React Native では文字列 'custom'。SDK バージョン 4.1 より前は文字列 "custom" を渡してください。
  1. 他のイベント共有サービスやアトリビューションソースを無効化する。イベントの重複やデータの競合を防ぐためです。

データの問題を防ぐ

1つのアトリビューションソースを選択する

複数のプラットフォームとのアトリビューション連携を同時に有効にしないでください。Adapty が受け付けられるアトリビューションソースは1つのみであり、プロファイルの保存済みアトリビューションを変更できるのはプロファイル作成後15分以内に限られます。

複数のアトリビューションソースを有効にした場合、Adapty はデータ量が最も多いソースを選択しますが、それが必ずしも最良のデータとは限りません。

例えば、iOS ではオーガニックでない Apple Search Ads のアトリビューションが常に優先されます。Apple Search Ads のアトリビューションをオフにするには、App Settings -> Apple Search Ads タブを開き、Receive Apple Search Ads attribution スイッチをオフにしてください。

プロファイルにアトリビューションが設定された後、プロファイル作成から15分以上経過してAdaptyに届いたアトリビューションデータは、アトリビューションプロバイダー側で後からインストールの再アトリビューションが行われた場合でも、既存のアトリビューションを変更しません。プロファイルのアトリビューションを完全な状態に保つには、アトリビューションSDKからデータが返され次第、すぐにAdaptyへ全アトリビューションデータを送信してください。

イベントの重複を避ける

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

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