Appreciate DSP by Digital Turbineの設定
Appreciate DSP by Digital TurbineはAdjustと連携されたアドネットワークです。Adjustとの連携により、Appreciate DSP by Digital Turbineは自動コールバックを通してアトリビューションとアプリ内イベントデータを受信できます。
ここでは、Appreciate DSP by Digital Turbineとのアプリ計測を設定する方法を説明します。 連携の有効化、キャンペーンリンクの作成、Adjustが Appreciate DSP by Digital Turbineと共有できるデータを選択する方法をご確認ください。
事前準備
要件
- Adjustアカウントの管理者、編集者またはカスタム編集者のアクセス権限。
- Adjust SDK v4.0.0以降を実装することで、SDKパラメーターをAppreciate DSP by Digital Turbineパラメーターにマッピングできます。この機能を使用するには、以下のリンク先のガイドに従ってください。
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
認証情報
APPRECIATE YID
- 認証情報を確認するには、Appreciate DSP by Digital Turbineの担当者にお問い合わせください。
Campaign LabでAppreciate DSP by Digital Turbineとアプリを選択
- Campaign Lab にて、 パートナー（Partner） を選択します。
- 新規パートナー（New partner） > Appreciate DSP by Digital Turbine を選択します。 次へ（Next） を選択して、次の画面に移動します。
- アプリの選択（App selection） 画面で、リンクを作成したいアプリを選択し、 Appreciate DSP by Digital Turbineのデータ共有をするため連携を有効化します。
- 次（NEXT） を選択します。
データ共有を有効化
データ共有を有効化すると、Appreciate DSP by Digital Turbineとの連携が有効化されます。データ共有を有効化する方法：
- APPRECIATE YIDを入力します。
Appreciate DSP by Digital Turbineとのデータ共有を有効化すると、デフォルトでは、Appreciate DSP by Digital Turbineに以下のデータが自動送信されます：
- インストール
- セッション
- イベント
- 拒否されたインストール
データ共有オプションの設定
マルチプラットフォームアプリで複数のプラットフォームを対象にデータ共有を有効にしている場合は、以下のことが可能です：
- プラットフォーム固有の設定を使用（Use platform-specific settings） を選択すると、プラットフォームレベルでデータ共有オプションを個別に設定できます。
- グローバル設定を使用（Use global settings） を選択して、複数のプラットフォームに同じデータ共有設定を行います。
デフォルトで共有するデータ（What will be shared by default?） にて、Adjustがデフォルトで Appreciate DSP by Digital Turbineと共有するアクティビティを確認してください。
- インストール
- セッション
- イベント
- 拒否されたインストール
追加データの送信
コールバックによりAppreciate DSP by Digital Turbineと共有するデータ量とタイプを選択します。 Appreciate DSP by Digital Turbineはこの情報を使用して、パフォーマンスを最適化することができます。
- 共有するデータソース（What sources of data do you want to share?）にて、Appreciate DSP by Digital Turbineと共有するデータのアトリビューションソースを選択します：
- 全てのアトリビューションソースのデータ
- Appreciate DSP by Digital Turbineにアトリビュートされたデータのみ
広告費用
広告費用を共有すると、 Appreciate DSP by Digital Turbineはユーザーの広告費用データを受信できます。これによりAppreciate DSP by Digital Turbineは広告費用データを使用して、ターゲティングとキャンペーンを最適化できます。
Adjustは、コールバックで受信した広告費用データのみをAppreciate DSP by Digital Turbineに送信します。このデータは、Appreciate DSP by Digital Turbineに適用される以下のソリューションから取得したものです。
Appreciate DSP by Digital Turbineが完全な広告費用データを必要としている場合は、Appreciate DSP by Digital Turbine向けに広告費用 サードパーティストレージ エクスポートを設定できます。
この機能は、AdjustのSpendWorksにご契約のお客様にご利用いただけます。ご希望の際は、営業担当者にお問い合わせください。
広告収益（広告ビュー由来）
広告収益を共有すると、 Appreciate DSP by Digital Turbineはユーザーの広告収益データを受信できます。 これによりAppreciate DSP by Digital Turbineは広告収益データを使用して、ターゲティングとキャンペーンを最適化できます。
この機能はAdjustの広告収益パッケージにご契約のお客様にご利用いただけます。ご希望の際は、営業担当者にお問い合わせください。
広告収益をAppreciate DSP by Digital Turbineに共有するには1つ以上の 広告収益ソース を選択してください。
- このフィールドを空にした場合は、連携された全てのメディエーションソースの広告収益データを送信します。
セッション
セッションは大量に発生するため、Adjustはセッションコールバックを自動送信していません。 セッションを共有することで、 Appreciate DSP by Digital Turbineはアプリのセッションアクティビティを受信するようになります。
アプリ内収益（アプリ内購入由来）
アプリ内収益を共有すると、 Appreciate DSP by Digital Turbineは収益イベントデータと収益額を受信することができます。このデータを共有するには、収益が発生するイベントをマッピングしてください。
イベントのマッピング
共有するイベントを、Appreciate DSP by Digital Turbineが受信できる値にマッピングします。マッピングされていないイベントのデータは、Appreciate DSP by Digital Turbineと共有されません。
各イベントをマッピング
マルチプラットフォームアプリの場合、プラットフォームごとに異なるイベントをAppreciate DSP by Digital Turbineと共有することができます。これにより、次のことが可能になります。
- 各イベントを設定し、それぞれのプラットフォームのキャンペーン戦略を管理できます。
- プラットフォームごとにデータ共有をカスタマイズします。
イベントのマッピング（Map events） にて、以下の手順に従って、Appreciate DSP by Digital Turbineに直接送信するアプリ内イベントを選択します。
イベントのマッピング（Map event） を選択します。
Adjustイベント リストで、 Appreciate DSP by Digital Turbineと共有するAdjustイベントを選択します。
パートナーイベント（Partner event） で、Adjustイベントに対応するAppreciate DSP by Digital Turbineイベントを選択します。
シングルプラットフォームアプリおよびマルチプラットフォームアプリで、単一のプラットフォームでのみデータ共有が有効になっている場合は、そのプラットフォームでのみデータ共有オプションを設定します。マルチプラットフォームアプリの場合、複数のプラットフォームでデータ共有が有効化されている場合は、以下のことが可能です。
- プラットフォーム固有のマッピングを使用する（Use platform-specific mapping） を選択して、プラットフォームレベルで各イベントをマッピングするか、特定のプラットフォームのイベントをマッピングしないようにします。
- グローバルマッピングを使用 して、全てのプラットフォームに同じイベントをマッピングします。
パートナーイベント（Partner event） リストで、Adjustイベントをマッピングするカスタムイベント名を選択するか、入力します。
適用（Apply） を選択します。
Appreciate DSP by Digital Turbineは連携されているイベントごとにアプリ内イベントのデータを受信するようになります。
全てのイベントをマッピング
Appreciate DSP by Digital Turbineが全てのイベントの自動マッピングをサポートしている場合、 イベントのマッピング（Map events） で、 全てのイベントをマッピング（Map all events） を選択します。これにより、個々のイベントをマッピングする時間を節約できます。
Appreciate DSP by Digital Turbineは連携されているイベントごとにアプリ内イベントのデータを受信するようになります。
パラメーターのマッピング
通常、カスタムデータをAppreciate DSP by Digital Turbineと共有するには、パラメーターをマッピングする必要があります。
パートナーパラメーター（Adjust SDKバージョン4.0以降で使用可能）によって、Adjustはアプリからカスタムデータポイントを収集し、Appreciate DSP by Digital Turbineに送信することができます。 これにより、Appreciate DSP by Digital Turbineは連携しているイベントごとにカスタムイベントの詳細を受信するようになります。
Adjust SDKに新しいパートナーパラメーターを追加する前に、要件に合うパートナーパラメーターが存在していないことを確認してください。
パートナーパラメーターをAppreciate DSP by Digital Turbineに共有するには、以下の手順に従って設定してください。
AdjustのSDKでパートナーパラメーターを実装します。
- 全てのSDK開発プラットフォームのリンクについては、事前準備をご確認ください
データ共有オプションの設定（Set your data sharing option） で、 パラメーター を選択します。
パラメーターのマッピング（Map parameters） では、SDKで定義したパートナーパラメーターをネットワークに送信する方法を指定できます。
- パラメーターのマッピング（Map parameters） を選択します。
- SDKパラメーター（SDK parameter） フィールドで、ネットワークと共有するSDKパラメーターの名前を入力します。
- パートナーパラメーター（Partner parameter） フィールドで、SDKパラメーターに対応するネットワークパラメーターを入力します。
Adjust SDK内でパートナーパラメーターを設定し、ダッシュボードでパラメーター共有を設定しない場合、AdjustはAdjust SDKで指定されているパラメーターを転送します。
リンクと設定の管理
以下を設定することができます：
リンクを作成しAppreciate DSP by Digital Turbineと共有
設定のレビュー（Setup review） 画面にて 、選択内容を確認できます。設定前に戻って、以下の変更も行えます：
- 選択したアプリ
- データ共有オプション
- リンク構造パラメーター
- ユーザーの遷移先
- アトリビューション設定
リンクの作成（Create link） を選択し、クリックURL、インプレッションURL、QRコード、リンクトークンを作成します。リンクを作成することで、データの共有やAppreciate DSP by Digital Turbineとの連携も可能になります。
リンクを作成したら、Appreciate DSP by Digital Turbineと共有してキャンペーンに利用できます。
パートナー固有の設定手順
Appreciate DSPは、Appreciate DSPにアトリビュートされたキャンペーンデータのみに対する、キャンペーンレベルの情報を受信します。
Appreciate DSP by Digital Turbineに転送されるパラメーター一覧
Adjustは、Appreciate DSP by Digital Turbineに以下のパラメーター（データポイント）をコールバック送信するよう要求されています。
| Placeholder | Information |
{api_level} | API level (Android only) |
{city} | Device city |
{click_attribution_window} | Attribution window settings for device matching (hours) |
{cost_amount} | Cost of the user engagement (available for ad spend tracking only) |
{cost_currency} | ISO 4217 currency code of the cost data (available for ad spend tracking only) |
{cost_id_md5} | An MD5 hash of the cost ID provided by a network using our ad spend API (available for ad spend tracking only) |
{cost_type} | The campaign pricing model (available for ad spend tracking only) |
{country_subdivision} | Device subdivision of country, e.g., state |
{country} | Device two-character country code |
{currency} | Original ISO 4217 currency code sent from Adjust SDK |
{deeplink} | Deeplink URL appended to click URL |
{device_name} | Device model number |
{device_type} | Device type |
{idfa||gps_adid} | IDFA, or GPS ADID if IDFA is empty |
{impression_attribution_window} | Attribution window settings for impression matching (hours) |
{ip_address} | Device IP address |
{is_reattributed} | 1 if user was reattributed at least once from an earlier source. 0 if user has never been reattributed |
{isp} | Device internet service provider |
{label} | Value of the Adjust "label" parameter sent on click |
{language} | Device two-character language code |
{last_time_spent} | Length of user's last session, in seconds |
{lifetime_session_count} | Number of sessions recorded across entire user lifetime |
{match_type} | Attribution method |
{mcc} | Mobile country code: three-digit code identifying a device's country. Use with the mobile network code to identify a device's carrier. |
{mnc} | Mobile network code: two-digit code. Use with the mobile country code to identify a device's carrier. |
{os_name} | Device operating system |
{os_version} | Operating system version number |
{partner_parameters} | Custom partner parameters collected by the Adjust SDK or S2S request and transmitted to third party providers via postbacks |
{postal_code} | Device postal code of IP address |
{reattribution_attribution_window} | Attribution window settings for reattribution (hours) |
{reftag} | Random device reference tag |
{region} | Device region code |
{revenue_float} | Revenue, as sent from Adjust SDK, in whole currency units |
{revenue_usd_cents} | Revenue, in US cents |
{sdk_version} | Adjust SDK version (per app) |
{session_count} | Number of sessions recorded by current Adjust SDK |
{time_spent} | Length of user's current session, in seconds |
{timezone} | Device time zone |
{tracking_limited} | 1 if tracking is limited, 0 if not |
{user_agent} | Incoming raw user agent |
{win_adid} | Windows advertising identifier |
{activity_kind} | Type of user activity |
{adgroup_name} | Adgroup name, as taken from the tracker |
{app_id} | Store App ID or Google Play Store |
{campaign_name} | Campaign name, as taken from the tracker |
{click_time} | Attributed click timestamp |
{connection_type} | Internet connection type |
{conversion_duration} | Time between click and install or reattribution in seconds |
{creative_name} | Creative name, as taken from the tracker |
{engagement_time} | Engagement timestamp |
{impression_based} | 1 if impression-based engagement, 0 if not |
{impression_time} | Attributed impression timestamp |
{installed_at} | Install (i.e., first app open) timestamp |
{is_organic} | 1 if organic traffic, 0 if non-organic |
{last_session_time} | Last session timestamp |
{last_tracker} | 6-character Adjust tracker token of a reattributed user's previous tracker |
{network_name} | Network name, as taken from the tracker |
{reattributed_at} | Reattribution timestamp |
{rejection_reason} | Reason for a rejected attribution |
{tracker} | 6-character Adjust tracker token |
{is_redownload} | Indicates whether this app activity is the first one recorded after the app was redownloaded (1 = yes |
{redownload_exclusion_window} | The redownload exclusion window (hours) setting configured for the app in the dashboard |
{redownload_inactivity_period} | The redownload inactivity window (hours) setting configured for the app in the dashboard |