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. キャンペーンがMeta AdsまたはTikTokで実施している場合は、Integrations > Meta AdsまたはTikTok Adsでトラッキングリンクを確認してください。別のプラットフォームを対象としている場合は、Integrations > Customを開いてください。使用するリンクをコピーします。
ua-lnk.webp
  1. 広告プラットフォーム(Meta、TikTok、Google Ads など)で、広告のリンク先 URL フィールドにそのリンクを貼り付け、遅延データパラメーターを追加のクエリパラメーターとして & を先頭に付けて追加します。たとえば、インストール後に iOS ユーザーを「Welcome」画面に遷移させる場合は、&ios_deferred_data=welcome を追加します。最終的なリンク先 URL は次のようになります。
https://api-ua.adapty.io/api/v1/attribution/c/YOUR_CODE?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__&ios_deferred_data=welcome
  1. アプリのコードでパラメーターを処理します。なお、遅延データのパラメーターは payload パラメーターに含まれており、payload パラメーターはエスケープされた JSON であるため、アプリのコード内でパースする必要があります。

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