どのようにお手伝いできますか?

検索

ROI360の広告費APIの設定と広告費データの計測

  • 更新

アプリ単位またはメディアソースのアカウント単位で広告費APIを利用し、広告費に関連するLTV（顧客生涯価値）ベースの成果指標を含む、マーケティング広告費の集計データを取得します。

概要

ROI360は、アプリ単位とアカウント単位の両方で広告費を計測できます。アプリごとの詳細な広告費や、メディアソースのアカウント全体の広告費を分析できます。

広告費連携の管理場所は、メディアソースによって次の2つに分かれます。

  • アカウント単位の連携は、［広告費設定］で管理します。広告アカウント単位で連携を設定します。対応するアドネットワークの一覧を参照してください。
  • アプリ単位の連携は、［広告費］タブで管理します。アプリごとに個別に連携を設定します。メディアソースが［広告費設定］にない場合は、アプリ単位の［広告費］タブで連携を設定してください。

広告費設定へのアクセスは、ロールの権限によって制御されます。［広告費設定］を開けない場合は、［ユーザー管理］ページでロールの権限を更新するよう、管理者に依頼してください。該当する権限は［広告費連携］です。

広告費APIの有効化

広告費連携は、アプリ単位またはアカウント単位のいずれかの方法で有効にできます。

アプリ単位での広告費連携の有効化（広告費タブ）

特定のアプリに対してメディアソースとの広告費連携を設定するには、次の手順を実行します。

  1. AppsFlyerのサイドメニューから［コラボレーション］＞［パートナー連携］＞［有効な連携］を選択し、パートナーを選択します。
  2. ［連携を管理］をクリックします。
  3. 連携済みパートナーの［広告費］タブを開きます。
  4. ［広告費データを取得］をオンにします。パートナーとの接続に必要な項目が表示されます。
  5. パートナーとの広告費連携を設定し、認証を行います。認証方法はメディアソースによって異なります。以下の広告費の連携方法を参照してください。
  6. パートナーの広告費設定に［サイトIDマッピング］がある場合は、ドロップダウンから使用するサイトIDの設定を選択します。以下のサイトIDマッピングを参照してください。
  7. ［広告費設定を保存］をクリックします。
    • 5～6時間以内に、ダッシュボードに広告費データが表示され始めます。
    • AppsFlyerは、平均4時間に1回、1日6回パートナーからデータを取得します。
    • ［広告費設定］内のメディアソースアカウントには、アプリ単位の［広告費］タブで行った変更が反映されます。
アカウント単位での広告費連携の有効化（広告費設定ページ）

メディアソースのアカウントを一度接続すれば、AppsFlyerアカウント内の複数またはすべてのアプリで広告費連携を有効にできます。

アカウント単位で広告費連携を有効にするには、次の手順を実行します。

  1. AppsFlyerのサイドメニューから［設定］＞［ROI360］＞［広告費設定］を開きます。
  2. 広告費データを取得するメディアソースを選択し、［次へ］をクリックします。
  3. メディアソースとの広告費連携を設定し、認証を行います。認証方法はメディアソースによって異なります。以下の広告費の連携方法を参照してください。
  4. 広告費連携の名前を入力、または変更します。
  5. この広告費連携の対象に含めるアプリを選択します。
  6. ［連携を保存］をクリックします。
    • 5～6時間以内に、ダッシュボードに広告費データが表示され始めます。
    • AppsFlyerは、平均4時間に1回、1日6回メディアソースからデータを取得します。
    • アカウント単位の［広告費設定］で行った変更は、該当するアプリとメディアソースの［有効な連携］にある［広告費］タブにも自動的に反映されます。

代理店にキャンペーン運用を委託している場合は、広告主ではなく代理店が対象パートナーとの連携を行うことを推奨します。同じアプリに対して、広告主と代理店の両方が同じ認証情報でメディアソースと連携すると、広告費データが重複するためです。

広告費の連携方法

広告費連携を有効にする方法は、メディアソースとAppsFlyerの連携方式によって異なります。次のいずれかの方法を使用します。

  • ログイン：［<media source>にログイン］をクリックし、メディアソースのログインウィンドウを開きます。その後、メディアソースの案内に従ってログインします。
  • 認証情報：APIキーなど、メディアソース固有のパラメータの値を入力します。
  • なし：上記の手順で［広告費データを取得］をオンにする以外に、接続設定は不要です。

各メディアソースの方式は、メディアソースの広告費連携一覧の［連携方法］列で確認できます。

サイトIDマッピング

一部のメディアソースの連携では、広告費を報告する際にサイトIDフィールドに設定する値を選択できます。これにより、AppsFlyerのアトリビューションリンクに含まれるsite-idマクロを、メディアソースが想定する値に合わせられます。

  • デフォルトでは、サイトIDマッピングはアトリビューションリンク内のAppsFlyerマクロに合わせて設定されています。
  • アトリビューションリンクで使用するマクロと、サイトIDマッピングで選択した値が異なると、サイトIDデータが正しく入力されません。

アプリ単位でサイトIDマッピングを設定するには：

  1. 連携済みパートナーの［広告費］タブで［サイトIDマッピング］に移動し、ドロップダウンから設定を選択します。
  2. ［広告費設定を保存］をクリックします。変更はUTCの翌日から有効になります。

広告費連携の削除

広告費連携は、アプリ単位またはアカウント単位で削除できます。削除すると、AppsFlyerはそのアカウントから広告費データを取得できなくなります。連携を削除しても、過去のデータには影響しません。

アプリ単位での広告費連携の削除（広告費タブ）

連携はいつでも削除できます。

アプリ単位で広告費連携を削除するには：

  1. AppsFlyerのサイドメニューから［コラボレーション］＞［パートナー連携］＞［有効な連携］に移動します。
  2. 連携済みパートナー（Meta広告など）を選択します。
  3. ［連携を管理］をクリックします。
  4. ［広告費］タブを開きます。接続済みアカウントの一覧が表示されます。
  5. ［操作］列で対象アカウントにカーソルを合わせ、［接続を削除］をクリックします。
  6. 確認メッセージが表示されたら、［はい、削除します］をクリックします。

アプリ単位で設定されていた広告費連携が、アプリ単位とアカウント単位の両方から削除されます。広告費データの収集は直ちに停止します。すでに収集した過去の広告費データには影響しません。

アカウント単位での広告費連携の削除（広告費設定ページ）

アカウント単位で広告費連携を削除するには：

  1. AppsFlyerのサイドメニューから［設定］＞［ROI360］＞［広告費設定］を選択し、連携を削除するメディアソースを選択します。
  2. メディアソースの連携一覧で、対象の連携をクリックします。
  3. 確認メッセージが表示されたら、［はい、削除します］をクリックします。

アカウント単位で設定されていた広告費連携が、アプリ単位とアカウント単位の両方から削除されます。広告費データの収集は直ちに停止します。すでに収集した過去の広告費データには影響しません。

広告費APIの無効化

広告費APIを無効にできるのは、アプリ単位のみです。

広告費APIをオフにするには：

  1. ［有効な連携］に移動し、メディアソースを選択します。
  2. ［広告費］タブを開きます。
  3. ［広告費データを取得］をオフにします。
  4. ［広告費設定を保存］をクリックします。

広告主が代理店との取引を終了し、アプリ単位で代理店権限をオフにしても、代理店側にそのアプリの広告費設定がある場合、広告費データの取得は継続します。取得を停止するには、広告主から代理店に、広告費連携をオフにするよう依頼する必要があります。

広告費APIのステータス

広告費連携の稼働状況は、以下で確認できます。

メディアソースの広告費連携状況の確認（広告費タブ）

メディアソースの［有効な連携］ページの［広告費］タブには、以下が表示されます（API経由の広告費取得に対応するメディアソースが対象）。

  • 選択したアプリの広告費連携のステータス。
  • そのアプリと一致する広告費データを、AppsFlyerが最後に正常に取得した日時。

選択したアプリのメディアソース別の広告費連携状況を確認するには：

  1. AppsFlyerのサイドメニューから［コラボレーション］＞［パートナー連携］＞［有効な連携］に移動します。
  2. メディアソースを選択します。
  3. メディアソースの［有効な連携］ページで、タブバーの上にあるアプリ一覧から、広告費のステータスを確認するアプリを選択します。
  4. ［広告費］タブをクリックします。ステータスと最終同期日時が表示されます。
メディアソース全体の広告費連携状況の確認（広告費設定ページ）

メディアソース全体の広告費連携状況を確認するには：

  1. AppsFlyerのサイドメニューから［設定］＞［ROI360］＞［広告費設定］を選択します。
  2. 対象のメディアソースを選択します。
  3. メディアソースのページの［ステータス］列で、メディアソースアカウントのステータスを確認できます。アカウントに紐づくすべてのアプリが同じステータスであれば、そのステータスが表示されます。アプリごとにステータスが異なる場合は、［ステータス混在］と表示されます。
  4. メディアソースアカウントに紐づく特定のアプリの状況を確認するには、対象アカウントの行をクリックして［広告費連携］ページを表示します。
  5. メディアソースに紐づくアプリ一覧で、アプリのステータスを確認します。
ステータス一覧
ステータス 補足／必要な対応
有効 連携が有効で、メディアソースに正常に接続されています。
APIから一致する広告費データが返されない 考えられる原因：
• キャンペーンIDが提供されていないため、広告費をキャンペーンと照合できません。

• AppsFlyerからパートナーにログインする際に、別の広告アカウント（別のMeta広告アカウントなど）を連携しました。正しいパートナーの広告アカウントを連携していることを確認してください。

• パートナーの広告費連携に設定した認証情報のフィールドのいずれかに誤りがあります。例えば、バンドルIDなどです。連携の認証情報を確認し、修正してください。

• キャンペーンが一時停止されており、データがありません。
パートナーのAPIから応答がない • 連携済みパートナーのサーバーがAppsFlyerに応答していません。
• 6時間待ってください。同じステータスメッセージが表示され続ける場合は、AppsFlyerサポートにお問い合わせください。
認証情報が無効 • 認証情報が無効なため、AppsFlyerがAPI経由でデータを取得できません。
• 正しい認証情報で再接続してください。
レポートAPIへのアクセスについて、アドネットワークの担当者にお問い合わせください。 パートナーの担当者と連携し、パートナー側のシステムで広告費連携を有効にしてください。
パートナーのAPIからデータが返されていません。連携設定を確認してください。 考えられる原因：
• キャンペーンが一時停止されており、データがありません。
パートナー側のシステムで、このアカウントによる広告費データの取得が有効になっていない パートナーにお問い合わせください。
ステータス混在 紐づくアプリのステータスが異なる場合にのみ、広告費設定＞メディアソースページに表示されます。メディアソースページから連携ページを開くと、アプリごとのステータスを確認できます。このステータスは、ステータスダッシュボードには表示されません。

アカウント単位の広告費設定に対応するメディアソース

ROI360をご利用のお客様は、［広告費設定］と［広告費］タブで、アカウント単位の広告費連携を作成・編集できます。次のメディアソースが、アカウント単位の広告費設定に対応しています。

対応するメディアソース
表示名 連携ID
AdAction3 adaction5_int
Adbloom adbloom_int
AdColony adcolony_int
AdGate Media adgatemedia_int
adjoe GmbH adjoe_int
Adikteev Retargeting trademob_int
Apple Search Ads iossearchads_int
AppLift applift_int
AppLovin applovin_int
Aura aura_int
Blind Ferret Agency blindferret_int
Bluestacks bluestacks_int
ByteDance bytedance_int
Chartboost chartboost_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
TikTok tiktokglobal_int
TUNE hasoffers_int
Unity Ads unityads_int
X (Twitter) twitter

InCost対応アドネットワークを通じて、その他のメディアソースも利用できます。 InCost対応アドネットワークの全一覧は、担当のカスタマーサクセスマネージャー（CSM）にお問い合わせください。

仕様と制限事項

項目 説明
代理店 代理店は、広告費設定から複数のアプリの広告費連携を一括で設定することはできません。
アカウント単位の広告費設定を、今後追加するアプリに自動適用する機能 現在は非対応
広告主と代理店が同じアドネットワークに接続した場合の広告費データ
広告主と代理店の両方が同じアドネットワークアカウント（Google広告など）の広告費連携を設定した場合、成果が紐づいたアカウントから広告費データを取得します。

例：
  • 広告主が、自社の認証情報で広告費連携を設定します。
  • 代理店が、代理店の認証情報で広告費連携を設定します。
  • 成果は代理店アカウントに紐づいています。

結果：

  • ROI360は、代理店の連携から広告費データを取得します。
  • 広告主の連携には「データなし」と表示されます。
Google広告費連携の自動切断 ［データなし］または［認証情報が無効］のステータスが365日を超えて連続した広告費連携は、自動的に切断されます。 Googleの連携にのみ適用されます。
TikTokの広告主ID一覧の設定

広告主ID一覧は、アドネットワーク側のTikTokユーザーに紐づく広告主IDのみを使用して、アカウント単位で設定してください。

アドネットワーク側のユーザーに紐づかない広告主IDを一覧に追加しても、そのIDの広告費データは返されません。

 

Tags