ROI360 Cost APIの設定によるコストデータの計測

推奨
マーケター マーケター 代理店
最終更新日：

概要： Cost APIを使用すると、アプリ単位またはメディアソースアカウント単位で、集計されたマーケティングコストデータ（コスト関連のLTVパフォーマンス指標を含む）を取得できます。

概要

ROI360では、アプリ単位およびアカウント単位の両方でコスト計測を提供しています。これにより、関係者は個別アプリごとの広告費、またはメディアソースアカウント全体の広告費を粒度別に分析できます。

コスト連携は、メディアソースによって管理場所が異なります。

  • アカウントレベルの連携は、コスト設定で管理されます。これらの連携は、広告アカウントレベルで設定されます。対応しているアドネットワーク一覧をご確認ください。
  • アプリレベルの連携は、コストタブで管理できます。これらの連携は、アプリごとに個別に設定されます。コスト設定でメディアソースが利用できない場合は、アプリレベルのコストタブでコスト連携を設定してください。

 注意

コスト設定へのアクセスはロール権限によって制御されます。コスト設定にアクセスできない場合は、管理者にユーザー管理ページでの役割権限の更新を依頼してください。関連する機能は、コスト接続です。

コストAPIの有効化

コスト連携を有効にするには、アプリレベルとアカウントレベルの2つの方法があります。

アプリレベルでのコスト連携を有効にする（コストタブ）

個々のアプリにメディアソースとの専用コスト接続を設定する：

  1. AppsFlyer管理画面 左メニュー 連携 > 連携済みパートナーへ移動し、アドネットワークを選択します。
  2. 連携管理をクリックします。
  3. 連携広告媒体のコストタブを開きます。
  4. コストデータの取得トグルをオンにします。パートナーに接続するための要件が表示されます。
  5. 連携内容を設定し、広告アカウントにてログイン認証します。認証方法はメディアソースによって異なります。以下のコスト連携方法を参照してください。
  6. 広告媒体のコスト設定にサイトIDマッピングがある場合、ドロップダウンから希望のサイトID設定を選択します。以下のサイトIDマッピングを参照してください。
  7. コストを保存をクリックしてください。
    • コストデータは5～6時間程で管理画面に反映されます。
    • AppsFlyerはパートナーから1日6回（平均約4時間ごとに）データを収集します。
    • コスト設定セクションのメディアソースアカウントは、コストタブを介してアプリレベルで行った操作に従って更新されます。

アカウントレベルでコスト連携を有効にする（コスト設定）

AppsFlyerアカウントの複数またはすべてのアプリのコストを有効にするには、各メディアソースアカウントを一度接続する必要があります。

アカウントレベルでコスト連携を有効にする：

  1. AppsFlyer管理画面 左メニュー 設定 > ROI360 > コスト＆広告収益状況を選択します。
  2. コストデータを取得するメディアソースを選択し、次へをクリックします。
  3. 連携内容を設定し、広告アカウントにてログイン認証します。認証方法はメディアソースによって異なります。 以下のコスト連携方法を参照してください。
  4. コスト連携名を入力（またはカスタマイズ）してください。
  5. このコスト連携に含めるアプリを選択します。
  6. 連携の保存をクリックします。
    • コストデータは5～6時間程で管理画面に反映されます。
    • AppsFlyerはパートナーから1日6回（平均約4時間ごとに）データを収集します。
    • コスト設定でアカウントレベルで行われた更新は 、関連するアプリとメディアソースの連携済みパートナーのコストタブに自動的に適用されます。

 注意

広告主が代理店運用でキャンペーンを実行する場合は、代理店が適切な広告媒体とのコスト連携設定を行います。そうでなければ、広告主と代理店が同じアプリで同じ認証情報を使ってパートナーとの連携設定を行うと、コストデータが重複してしまいます。

コストの連携方法

コスト連携を有効にする方法は、メディアソースのAppsFlyerとの連携モードによって異なります。次のいずれかを指定できます：

  • ログイン認証：<メディアソース>にログインをクリックして、メディアソースのログインウィンドウを開きます。その後、メディアソースのログインプロンプトに従います。
  • 認証情報：メディアソース固有のパラメータ値を入力します。例： API Key
  • なし：上記の指示に従ってコストデータを取得をオンにする以外に、接続設定は不要です。

特定のメディアソースがどのような方法を使用しているかを確認するには、 メディアソースコスト連携テーブルの 連携方法 列を参照してください。

サイトIDのマッピング

一部のメディアソース連携 では、コストデータを連携する際にサイトIDフィールドの反映方法を選択できます。これにより、AppsFlyerの計測リンクの site-id マクロが、メディアソースが期待する値と一致するようになります。

  • デフォルトでは、サイトIDマッピングは、計測リンク上のAppsFlyerのマクロと一致しています。
  • 使用している計測リンクのマクロが、サイトIDマッピングオプションと異なる場合、サイトIDデータは正しく入力されません。

アプリレベルでサイトIDマッピングを設定する：

  1. 連携広告媒体のコストタブで、サイトIDマッピングに移動し、ドロップダウンから設定を選びます。
  2. コストを保存をクリックしてください。変更はUTC時間で翌日から適用されます。

コスト連携の削除

コスト連携は、アプリレベルまたはアカウントレベルで削除できます。削除後、AppsFlyerはアカウントからコストデータを取得することはできません。連携を削除しても過去データに影響はありません。

アプリレベルでのコスト連携を有効にする（コストタブ）

連携はいつでも削除できます。削除すると、AppsFlyerは関連するアカウントからコストデータを取得できなくなります。このアクションは、すでに収集されている過去のコストデータには影響しません。

アプリレベルでコスト連携を削除する：

  1. AppsFlyer管理画面 左メニュー 連携 > 連携済みパートナーに進みます。
  2. 連携広告媒体を選択してください（例：Meta Ads）。
  3. 連携管理をクリックします。
  4. コストタブを開きます。接続済みアカウントの一覧が表示されます。
  5. アクション列で、アカウントにカーソルを合わせて、 接続の削除をクリックします。
  6. 確認のプロンプトが表示されたら、 はい、削除します をクリックします。

アプリレベルで設定されていたコスト連携が、アプリレベルとアカウントレベルの両方から削除されます。その結果、コストデータの収集は直ちに停止します。この変更は、すでに収集されている過去のコストデータには影響しません。

アカウントレベルでコスト連携を有効にする（コスト設定）

アカウントレベルでコスト連携を有効にする：

  1. AppsFlyerのサイドメニューから、設定 > ROI360 > コスト＆広告収益設定 を選択し、連携を削除するメディアソースを選択します。
  2. メディアソースごとの連携リストで、連携レコードの delete.jpeg をクリックします。
  3. 確認のプロンプトが表示されたら、 はい、削除します をクリックします。

アプリレベルで設定されていたコスト連携が、アプリレベルとアカウントレベルの両方から削除されます。その結果、コストデータの収集は直ちに停止します。この変更は、すでに収集されている過去のコストデータには影響しません。

コストAPIを無効にする

コストAPIの無効化はアプリレベルでのみ可能です。

コストAPIを無効にする：

  1. 連携済みパートナーに進んで広告媒体を選択します。
  2. コストタブに移動します。
  3. コストデータの取得トグルをオフにします。
  4. コストを保存をクリックしてください。

 注意

広告主が代理店との関係を終了し、アプリレベルで代理店の権限を無効にしても、代理店がアプリにコストを設定している場合、コストデータは引き続き取得されます。このデータ取得を止めるには、広告主は代理店に、コスト連携を無効にするよう依頼しする必要があります。

コストAPIのステータス

コスト連携の運用ステータスは次の通り表示されます：

  • コスト＆広告収益連携状況：アカウント内の1つ以上のアプリで、コスト連携が有効になっている広告媒体の一覧を要約したページ
  • 連携済みパートナー： 個々のアプリにおける連携状況
  • コスト設定： コスト設定ページでは、コストAPIのステータスをアカウントレベルとアプリレベルの両方で確認できます。詳細については、以下の パートナーコスト連携ステータスを参照してください 。

メディアソースのコスト連携状況の確認（コストタブ）

メディアソースの連携済みパートナーページにあるコストタブ（API経由でのコストデータの取得をサポートしているメディアソースに関連）には、次の項目が表示されます。

  • 選択したアプリのコスト連携のステータス
  • AppsFlyerが一致するコストデータを最後に成功して取得した時刻

選択したアプリの個々のメディアソースのコスト連携ステータスを表示する：

  1. AppsFlyer管理画面 左メニュー 連携 > 連携済みパートナーに進みます。
  2. メディアソースを選択してください。
  3. メディアソースの連携済みパートナーページで、タブバーの上にあるアプリリストから、コストステータスを表示するアプリを選択します。
  4. コストタブをクリックします。ステータスと最後の同期時刻が表示されます。

メディアソースの集約コスト連携ステータス（コスト設定）の表示

メディアソースの集約コスト連携ステータスを表示する手順：

  1. AppsFlyer管理画面 左メニュー 設定 > ROI360 > コスト＆広告収益状況を選択します。
  2. 関連するメディアソースを選択します。
  3. メディアソースページでは、メディアソースアカウントのステータスが ステータス 列に表示されます。アカウントに紐づくすべてのアプリが同じステータスの場合は、そのステータスが表示されます。アプリのステータスが異なる場合、ステータスは Mixedと表示されます。
  4. メディアソースアカウントに関連付けられた特定のアプリのステータスを表示するには、メディアソースアカウントの行をクリックして、コスト連携ページを表示します。
  5. メディアソースに紐づくアプリの一覧でアプリのステータスを表示します。

ステータステーブル

ステータス 備考／必要なアクション
Active（アクティブ） 連携が有効化されており、メディアソースとの接続が正常に完了しています。
Partner API is not returning matching cost data（パートナーAPIが対象のコストデータを送り返していません） 以下の理由で発生する場合があります：
• キャンペーンIDが提供されておらず、コストデータをキャンペーンへ紐づけできない。

• • AppsFlyer経由でパートナーへログインした際、別の広告アカウントを連携している（例：別のMeta広告アカウント）。正しい広告アカウントへ接続しているか確認してください。

パートナーのコスト連携に必要な認証情報の項目に間違いがあります。例：バンドルIDなど。認証情報を確認・修正してください。

• • キャンペーンが停止中で、データが存在しない。
Partner API is not responding（パートナーAPIが応答していません） • 連携先パートナーのサーバーがAppsFlyerからのリクエストへ応答していません。
• 6時間待機してください。ステータスメッセージが継続する場合は、AppsFlyerサポートへお問い合わせください。
Invalid Credentials（認証情報が無効です） • 認証情報が無効なため、AppsFlyerがAPI経由でデータ取得できません。
• 正しい認証情報を使用して再接続してください。
Reach out to your ad network account manager to get access to their reporting API（アドネットワークのアカウントマネージャーに連絡し、レポートAPIへのアクセス権を取得してください。） パートナー側のアカウントマネージャーと連携し、パートナーシステム上でコスト連携を有効化してください。
広告媒体APIがデータを返していません。連携を確認してください。 以下の理由で発生します。
• キャンペーンが停止中で、データが存在しない。
Your account is not enabled on the partner system to get cost（広告媒体システムでアカウントが有効になっていないため、コストが取得できません） 媒体に問い合わせてください。
Mixed status（混合ステータス） このステータスは、「コスト設定 > メディアソース」ページ上で、紐づくアプリごとに異なるステータスが存在する場合のみ表示されます。メディアソースページから連携ページを開くことで、各アプリごとのステータスを確認できます。なお、このステータスはステータスページ上には表示されません。

アカウントレベルのコスト設定に対応しているメディアソース

ROI360利用者は、「コスト設定」および「コスト」タブで、アカウントレベルのコスト連携を作成・編集できます。以下のメディアソースでは、アカウント単位のコスト設定をサポートしています：

メディアソース

項目 連携ID
AdAction3 adaction5_int
Adbloom adbloom_int
AdColony adcolony_int
AdGate Media adgatemedia_int
adjoe GmbH adjoe_int
Adikteev Retargeting trademob_int
Apple Ads iossearchads_int
AppLift applift_int
Blind Ferret Agency blindferret_int
Bluestacks bluestacks_int
ByteDance bytedance_int
Dataseat dataseat_int
Digital Turbine Legacy appia_int
Digital Turbine On Device digitalturbine_int
Domob domobc_int
DV360 dv360_int
GlobalWide Media globalwide_int
Google広告 googleadwords_int
InMobi inmobi_int
InMobi DSP inmobidsp_int
Liftoff Influence jetfuelit_int
Mediaforce mediaforce_int
Meta広告 facebook
Mintegral mintegral_int
Mobupps mobupps_int
Moloco moloco_int
MoPub Acquire crossinstall_int
Opera Mobile operaevent_int
Persona.ly RTB personalyrtb_int
Pinterest pinterest_int
Pinsight pinsight_int
Point2Web point2web_int
Reddit reddit_int
Smadex smadex_int
Snapchat snapchat_int
Tapjoy tapjoy_int
Taptica taptica_int
TUNE hasoffers_int
Unity Ads unityads_int
X（Twitter） twitter

 注意

InCost対応広告ネットワーク経由では、追加のメディアソースも利用可能です。対応しているInCost広告ネットワーク一覧については、CSMへお問い合わせください。

特性と制約事項

特性 備考
代理店 代理店は、「コスト設定」を使用して複数アプリのコスト連携を一括設定することはできません。
将来追加されるアプリへのコスト設定自動引き継ぎ 現在サポートされていません
広告主と代理店の両方が同一アドネットワークへ接続した場合のコストデータ挙動
広告主と代理店の両方が、同一広告ネットワークアカウント（例：Google Ads）に対してコスト連携を設定した場合、コストデータはアトリビューションを受け取った側のアカウントから取得されます。

シナリオ例：
  • 広告主が、広告主側の認証情報を使用してコスト連携を設定
  • 代理店が、代理店側の認証情報を使用してコスト連携を設定
  • アトリビューションは代理店アカウントへ紐づけ

結果

  • ROI360は、代理店接続からコストデータを取得します。
  • 広告主側の接続ステータスは「NO-DATA」と表示されています。