API連携パートナー向けのCTV-CTV サーバー間計測の設定

AdjustのCTV間でのSAN連携により、コネクテッドTV（CTV）アプリのインストールを促進するAPI連携ネットワークで実施しているキャンペーンの効果を計測できます。

ここでは、AdjustをSANのネットワークパートナーに接続し、サーバー間（S2S）でデータを送信する方法について説明します。

事前準備

以下のCTV-CTVパートナーはAPI連携パートナーとして機能するため、サーバー間設定が必須となります。

  • Amazon Fire TV
  • Roku Endemic Media
  • Vizio

連携の詳細

API連携ネットワークとのサーバー間連携とAdjust SDKを組み合わせて使用することはできません。

AdjustはAPI連携ネットワークに全てのアプリのインストールに関するデータを送信し、API連携パートナーは独自のエンゲージメントデータを基にアトリビューションを行います。Adjustはこのデータを確認し、最後のエンゲージメントのソースを確認します。

グロースソリューション:
CTV-CTV計測は、CTV AdVisionにご契約のお客様にご利用いただけます。詳細については、Adjustの担当者にお問い合わせください。

1. CTVアプリを追加する

CTVアプリのキャンペーンを計測するには、まずアプリをAdjustダッシュボードに追加する必要があります。

この手順の詳細については、 CTVアプリの設定ガイドをご覧ください。

2. ネットワーク設定

Adjustダッシュボードで連携を有効化すると、Adjustはネットワークに対し、アトリビューションのためのアクティビティデータの転送を即時に開始します。

連携を有効化するには、Adjustダッシュボードで以下の手順に従ってください。

  1. Campaign Lab​ で、 パートナー ( Partners )​ を選択します。
  2. 新規パートナー（New partner）​ を選択します。
  3. パートナーの選択（Partner selection）​ 画面で、ネットワークを選択し、 次（Next）​ を選択します。
  4. アプリの選択（App selection）​ 画面で、アプリを選択して、 次（Next）​ を選択します。

次に、以下の手順に従ってデータ共有オプションを設定します。これが完了したら設定を確認し、アプリのネットワークを有効にします。

データ共有を有効化

ネットワークとデータを共有して、キャンペーンを最適化します。 データ共有（Data sharing）​ 画面で、Adjustがデータ共有を開始できるようにするには、ネットワーク固有の認証情報を入力する必要があります。各ネットワークに必要な認証情報と共有オプションの詳細については、以下をご覧ください。

Amazon Fire
Roku
Vizio
  • AmazonアプリID：​ アプリIDは、Amazon開発者コンソールで確認できます。Amazonの設定手順に従い、セキュリティプロファイル管理（Security Profile Management）に移動し、Web設定（Web Settings）タブを選択して、完全なクライアントIDからアプリIDをコピーします。
    • クライアントIDの例：amzn1.devportal.mobileapp.1234a5b67c8901d2e3456789012f3456
    • アプリIDの例：1234a5b67c8901d2e3456789012f3456

データ共有を有効にすると、デフォルトでは、全てのアトリビューションソースのインストールおよびリアトリビューションデータが送信されます。これには、Amazon Fireにアトリビュートされたデータ、他のネットワークにアトリビュートされたデータ、オーガニックデータが含まれます。さらに、以下のデータもAmazon Fireと共有できます。

  • セッション
  • イベント（Events）

イベントのマッピング

Adjustが記録した各アプリ内イベントの下に、ドロップダウンメニューのあるフィールドが表示されます。ドロップダウンメニューを使用して、Adjustイベントにマッピングする事前定義済みのネットワークイベントを選択します。カスタムイベントは送信できません。

Amazon Fire
Roku
Vizio
  • カートに入れる（Add to cart）
  • 広告開始（Ad start）
  • 広告終了（Ad finish）
  • アプリエンゲージメント（App engagement）
  • アプリの初回起動（App open）
  • バナーへのインタラクション（Banner interaction）
  • ケーブルの認証（Cable authentication）
  • メールへのインタラクション（Email interaction）
  • メールのロード（Email load）
  • ゲームへのインタラクション（Game interaction）
  • ゲームのロード（Game load）
  • アプリ内リファラル（In App refferal）
  • インストール
  • レベル達成（Level achieved）
  • マーケティングランディングページ（Marketing landing page）
  • その他（Other）
  • 購入されたプロダクト（Product purchased）
  • 購入ボタン（Purchase button）
  • サブスクリプションボタン（Subscription button）
  • サブスクリプションページ（Subscription page）
  • サブスクリプション再開（Subscription restart）
  • サブスクリプション開始（Subscription start）
  • 調査開始（Survey start）
  • 調査終了（Survery finish）
  • トライアル登録ページ（Trial sign up page）
  • トライアル開始（Trial start）
  • 動画開始（Video start）
  • 動画終了（Video finish）
  • ウィジェットへのインタラクション（Widget interaction）
  • ウィジェットのロード（Widget load）

3. サーバー間（S2S）連携

警告:
この機能をご利用いただくには、まずはじめにAdjustが機能を有効化する必要があります。担当のアカウントマネージャーまたはsupport@adjust.comにお問い合わせください。

Adjustダッシュボードでネットワークを設定したら、Adjustとのサーバー間連携を設定できます。つまり、S2S APIコールでは、Adjustのアプリ内セッションとイベントデータのみが送信されます。

サポートされているデバイスID

IDIDタイプ形式
Amazon FireFIRE_ADIDAmazon Fire広告ID小文字、ハイフンあり
RokuとVizioIDFARawのGoogle広告ID大文字、ハイフンあり
GPS_ADIDRawのGoogle広告ID小文字、ハイフンあり
FIRE_ADIDAmazon Fire広告ID小文字、ハイフンあり
WIN_ADIDWindows広告IDハイフンなし
RIDARaw Vizio広告ID
  • Vizioデバイスのユーザーは、ターゲティング広告を表示させないために、いつでもこれをリセットするか無効にすることができます。
小文字、ハイフンあり
OAIDRaw Huawei広告ID小文字、ハイフンあり

要件

  • アプリ内ソリューションの要件の詳細については、Adjustのサーバー間アトリビューションチェックリストをご覧ください。
  • Adjustサーバーへのリクエストは、デバイスで発生したのと同じ連続した順番で行われる必要があります。
  • リクエストには必ずos_nameを含めてください。例：
    • android
    • ios
    • fire-tv
    • roku
    • tizen
    • vizio

セッションの送信

セッションは、Adjustの全てのアトリビューションと計測の基となるものです。ユーザーがバックグラウンドからアプリの利用を再開した時、またはアプリを起動した時にトリガーされます。

Adjustにセッションを送信する際は、S2SセッションAPIを使用してください。

エンドポイントhttps://s2s.adjust.com/session

アプリ内イベントの送信

Adjustにアプリ内イベントを送信する際は、S2SイベントAPIを使用してください。

エンドポイントhttps://s2s.adjust.com/event

4. データをエクスポートする

レポート構造

Amazon Fire
Roku
Vizio
  • ネットワーク = Amazon
  • キャンペーン = campaign_name
  • アドグループ = ad_name
  • クリエイティブ = creative_id

分析、BIシステム用にデバイスレベルのデータを取得するには、ローデータエクスポートを設定してください。

プレースホルダー

以下のプレースホルダーを使用して、ローデータエクスポートで特定のネットワークデータポイントを取得できます。

Amazon Fire
Roku
Vizio
プレースホルダー説明
{fire_adid}Fire OSの広告ID

Amazonキャンペーンから共有されなかったデータ

Amazonとの法的契約により、Adjustは特定のアクティビティに関するAmazonキャンペーンのローデータを提供しません。これには、サーバーコールバックとクラウドストレージアップロードの両方でエクスポートされたデータが含まれます。影響を受けるアクティビティは以下のとおりです。

  • クリック
  • インプレッション
  • API 連携パートナーのクリック（SAN clicks）
  • API 連携パートナーのインプレッション（SAN impressions）

以下のサービスには影響しません：

  • Adjustのクリック、インプレッション、SANクリック、SANインプレッション計測。
  • クリックおよびインプレッションの集計レポート。
  • レポートサービスでのクリックおよびインプレッションの集計データの取得。
  • Amazon Fireにアトリビュートされたインストールとポストインストールのローデータおよび集計データのレポートとエクスポート。

ご不明な点がございましたら、Amazonの担当者までお問い合わせください。