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にご契約のお客様にご利用いただけます。ご希望の際は、営業担当者にお問い合わせください。
セッション
セッションは大量に発生するため、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に以下のパラメーター（データポイント）をコールバック送信するよう要求されています。
| プレースホルダー | 情報 |
{api_level} | APIレベル（Androidのみ） |
{city} | 市（端末位置情報） |
{click_attribution_window} | デバイスマッチングのアトリビューションウィンドウ設定（時間） |
{cost_amount} | ユーザーエンゲージメントのコスト（広告費用のトラッキングにのみ使用可能） |
{cost_currency} | コストデータのISO 4217通貨コード（広告費用のトラッキングにのみ使用可能） |
{cost_id_md5} | Adjustの広告費用APIを使用してネットワークが提供する、コストIDのMD5ハッシュ（広告費用のトラッキングにのみ使用可能） |
{cost_type} | キャンペーン課金モデル（広告費用のトラッキングにのみ使用可能） |
{country_subdivision} | 国のデバイスを細分割（例、州） |
{country} | デバイスの2文字の言語コード |
{currency} | Adjust SDKから送信されたオリジナルのISO 4217通貨コード |
{deeplink} | クリックURLに追加されたDeeplink URL |
{device_name} | デバイスのモデル番号 |
{device_type} | デバイスタイプ |
{idfa||gps_adid} | IDFA、取得できない場合はGPS ADID |
{impression_attribution_window} | インプレッションによるデバイスマッチングのための、アトリビューションウィンドウ設定 (時間) |
{ip_address} | デバイス IPアドレス |
{is_reattributed} | 1：過去のソースで1回以上リアトリビューションされたユーザー、 0：過去に一度もリアトリビューションされたことがないユーザー |
{isp} | 端末のインターネットサービスプロバイダー |
{label} | クリック時に送信されるAdjustの「ラベル」パラメータの値 |
{language} | デバイスの2文字の言語コード |
{last_time_spent} | ユーザーの前回のセッション時間（秒単位） |
{lifetime_session_count} | ユーザーのライフタイム全体にわたって記録されたセッション数 |
{match_type} | アトリビューションの方法 |
{mcc} | モバイルカントリーコード（MCC）：デバイスの運用地域を示す3桁のコード。モバイルネットワークコード（MNC）とともに利用してデバイスのキャリアを特定します。 |
{mnc} | モバイルネットワークコード（MNC）：２桁のコード。モバイルカントリーコード（MCC）とともに利用してデバイスのキャリアを特定します。 |
{os_name} | デバイスのOS |
{os_version} | OSのバージョン番号 |
{partner_parameters} | Adjust SDK あるいは S2S のリクエストにより、ポストバックを通じてサードパーティプロバイダに送信されるカスタムパートナーパラメーター |
{postal_code} | IPアドレスのデバイスポスタルコード |
{reattribution_attribution_window} | リアトリビューションにおけるアトリビューションウィンドウ設定（時間） |
{reftag} | Random device reference tag |
{region} | 端末の地域コード |
{revenue_float} | Adjust SDKから送信された収益（全ての通貨単位） |
{revenue_usd_cents} | 収益（米セント） |
{sdk_version} | Adjust SDKバージョン（アプリ毎） |
{session_count} | 現在Adjust SDKで記録されているセッション数 |
{time_spent} | ユーザーの現在のセッション時間（秒単位） |
{timezone} | 端末のタイムゾーン |
{tracking_limited} | 計測が制限されている場合は1、それ以外は0 |
{user_agent} | 受信したユーザーエージェントのローデータ |
{win_adid} | Windowsの広告ID |
{activity_kind} | ユーザーアクティビティの種類 |
{adgroup_name} | トラッカーから取得したアドグループ名 |
{app_id} | アプリID（Store App ID）あるいはGoogle Playストア |
{campaign_name} | トラッカーから取得したキャンペーン名 |
{click_time} | アトリビュートされたクリックのタイムスタンプ |
{connection_type} | インターネットの接続タイプ |
{conversion_duration} | クリックからインストールまたはリアトリビューションまでの時間（秒単位） |
{creative_name} | トラッカーから取得したクリエイティブ名 |
{engagement_time} | エンゲージメントのタイムスタンプ |
{impression_based} | インプレッションベースのエンゲージメントの場合は1、そうでない場合は0 |
{impression_time} | アトリビュートされたインプレッションのタイムスタンプ |
{installed_at} | インストール（初回起動時）のタイムスタンプ |
{is_organic} | オーガニックトラフィックの場合は1、非オーガニックトラフィックの場合は0 |
{last_session_time} | 前回のセッションのタイムスタンプ |
{last_tracker} | リアトリビュートされたユーザーの前回のトラッカー（最新のリアトリビューションの1つ前）の、6文字のAdjustトラッカートークン |
{network_name} | トラッカーから取得したネットワーク名 |
{reattributed_at} | リアトリビューションのタイムスタンプ |
{rejection_reason} | アトリビューションが拒否された理由 |
{tracker} | 6文字のAdjustトラッカートークン |