Adapty アトリビューションでのディファードディープリンク

ディファードディープリンクを使用すると、ユーザーが広告をクリックしてアプリをインストールした際に、カスタムデータをアプリに渡すことができます。たとえば、インストール後の初回起動時に、アプリ内の特定の場所へユーザーを誘導することが可能です。

Important

Adapty SDK バージョン 4.1 以降、Adapty アトリビューションはデフォルトで無効になっています。onInstallationDetailsSuccess コールバックは、SDK のアクティベーション時に Adapty アトリビューションを有効化した後にのみ発火します。

動作の仕組みは次のとおりです。

  1. ユーザーが広告をクリックすると、Adapty はクリックデータを保存します。
  2. Adapty がインストールイベントを登録すると、クリックからの遅延データを取得します。
  3. ユーザーがアプリをインストールして初めて起動すると、Adapty は保存されたデータを取得し、アプリがカスタムパラメータを受け取ります。これにより、アプリコード内でさまざまな値に応じた処理を行えます。

Adapty は以下の遅延データパラメータをサポートしています:

  • ios_deferred_data
  • android_deferred_data
  • deferred_data_sub[1-10]

遅延データパラメータを追加するには、キャンペーン設定でリンクにパラメータを付加してください:

  1. Integrations -> Meta/TikTok Ads ページからキャンペーンを開くか、Tracking links ページからトラッキングリンクを開きます。キャンペーンで使用するクリックリンクをコピーしてください。
ua-lnk.webp
  1. 広告プラットフォーム(Meta、TikTok、Google Ads など)で、広告の遷移先 URL フィールドにリンクを貼り付け、遅延データパラメーターを追加クエリパラメーターとして & を先頭に付けて追記します。たとえば、インストール後に iOS ユーザーを「Welcome」画面に誘導するには、&ios_deferred_data=welcome を追加します。最終的な遷移先 URL は次のようになります:
https://api-ua.adapty.io/api/v1/attribution/click?adpt_cid=__ADAPTY__ID__&ios_deferred_data=welcome&campaign_id=__CAMPAIGN_ID__&adset_id=__AID__&ad_id=__CID__&campaign_name=__CAMPAIGN_NAME__&adset_name=__AID_NAME__&ad_name=__CID_NAME__&redirect_url=__APP_LINK__
  1. アプリのコードでパラメーターを処理します。なお、遅延データのパラメーターは payload パラメーターに含まれており、payload パラメーターはエスケープされた JSON であるため、アプリのコード内でパースする必要があります。

たとえば、ios_deferred_datawelcome のインストールを処理する方法は次のとおりです。