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

検索

UAパートナー向けROI360ガイド

  • 更新

概要：AppsFlyerは、広告収益、アプリ内購入、自動更新サブスクリプションに関する網羅的で正確なデータを、レポートとポストバックを通じてUAパートナーに提供します。パートナーは、この情報を取り込んでユーザー獲得（UA）キャンペーンの最適化に活用できます。

はじめに

AppsFlyerは、パートナーとアプリストア（Apple App StoreおよびGoogle Playストア）の両方から収益情報を受信します。受信したデータには、検証、正規化、アトリビューション、プロパティやディメンションの追加といった一連の処理が行われます。  AppsFlyerは、この情報をUAパートナーに送信できます。これらの処理が完了すると、AppsFlyerは追加情報を付与したアトリビューション済みデータをUAパートナーに送信します。 UAパートナーは、この情報をユーザー獲得キャンペーンの最適化や、広告主に提供するサービスの改善に活用できます。

パートナーに提供される収益データの種類

アプリから得られる収益には、次の2種類があります。

  • 広告収益：バナー広告やインタースティシャル広告など、アプリ内に広告が表示されるたびに発生する収益です。広告主への課金方式にかかわらず算出できます。
  • アプリ内購入・自動更新サブスクリプション：アプリ内購入やサブスクリプション関連の取引が行われるたびに発生するストア収益です。

UAパートナーへの収益情報の提供方法

AppsFlyerは、アプリ内広告、アプリ内購入、サブスクリプションの収益情報を、次の方法でパートナーに提供します。

  • Ad Revenue UA Signalsレポート：広告収益イベントをデバイス単位で集計したレポートです。前日分のデータを含むレポートが、毎日Data Lockerで提供されます。
  • 広告収益ポストバック：ユーザーのデバイスで広告インプレッションが発生するたびに、AppsFlyerからパートナーに広告収益イベントの詳細を含むポストバックが送信されます。
  • ストア収益ポストバック：購入イベントまたはサブスクリプションイベントが発生するたびに、AppsFlyerからパートナーに収益イベントの詳細を含むポストバックが送信されます。

パートナー向けROI360の設定

UA Signalsレポートと、広告収益・ストア収益のポストバックを受信するために、パートナー側で必要な設定を説明します。

ROI360 UA Signalsレポートの利用を開始する

パートナーがData Locker経由でレポートを受信できるようにするには、次の設定が必要です。

AppsFlyerからROI360のポストバックを受信する

ポストバックを受信するには、AppsFlyerのパートナー連携担当チームに連絡してください。担当チームが、AppsFlyerプラットフォームでROIアプリ内収益ポストバックの値を設定します。

AppsFlyerのパートナーサポートに連絡するには、管理画面の［ヘルプ］メニューを開き、［サポートに問い合わせる］を選択してください。

alt

UAネットワーク向けROI360 UA Signalsレポート

このレポートは、網羅的で正確な収益データをCSV／Parquet形式で、UAパートナーのS3バケットに毎日配信します。データはイベント発生日の翌日（X+1）に提供されます。各レコードには、広告収益イベントをデバイス単位で集計したデータが入ります。

UA Signalsレポートは、広告収益ポストバックのようにリアルタイムでデータを提供するものではありません。一方、データの正確性と網羅性に優れています。インプレッションの収益額は、時間の経過とともに変わることがあるためです。特に、リアルタイム入札ではなく通常のCPM入札で販売された広告インプレッションの収益データで、この傾向が見られます。

レポートのデータソース

広告主の連携方法に応じて、以下のいずれかからデータを取得します。

  1. AdRevenue SDK連携：パートナーがユーザーのデバイスに読み込んだインプレッション単位の収益データを、広告主が共有する方式です。データはほぼリアルタイムでAppsFlyerに送信されます。
  2. S2S APIによるデバイス単位の連携：広告主がAppsFlyer管理画面の連携済みパートナーでパートナーの認証情報を設定すると、ROI360の広告収益機能が広告主に代わってデバイス単位の広告収益データを取得できます。
  3. 上記2つを組み合わせ、速報性と正確性を両立する方式（Freshness to Accuracy）。注意：広告主からAppsFlyerへのデータ送信は、広告主の権限設定と、広告主がROI360 Advancedの契約者であるかどうかによって異なります。

レポートデータの処理

AppsFlyerのROI360広告収益機能は、以下の処理を行います。

  1. データの正規化
  2. インストールのメディアソースへのアトリビューションと、データへの追加情報の付与
  3. 広告収益イベントの生成
  4. イベントのデバイス単位での集計

レポートデータの配信方法

デバイス単位のデータが、毎日Data Lockerのレポートに書き込まれます。

レポートデータの更新タイミング

毎日21:00（UTC）に、Data Lockerバケットのh=23フォルダーにデータが書き込まれます。

レポートのフィールド

フィールド 説明
Version UNIXタイムスタンプ（秒）。例：1661315124
app_id AppsFlyerプラットフォーム上のアプリID。
install_time インストールのタイムスタンプ。形式：YYYY-MM-DD HH:MM:SS。例：2020-08-16 11:22:33。iOS 14以降のデバイスで同意していないユーザーの場合、または広告主が高プライバシーモード（AP）を有効にしている場合、インストール時刻は最も近い正時に丸められます。
campaign, campaign_id, adset_name, adset_id, ad_name, ad_name, ad_id, site_id ユーザー獲得がデータの受信先パートナーにアトリビューションされた場合にのみ、値が入ります。
idfa, idfv, advertising_id 広告収益化イベントが複数ある場合、IDFA、IDFV、advertiser_idなど、同じデバイスIDが複数の行に表示されることがあります。 iOS 14以降のデバイスで同意していないユーザーの場合、または広告主が高プライバシーモード（AP）を有効にしている場合は表示されません。
platform デバイスのプラットフォーム：iOS、Android、Windows Mobile。
country ISO 3166（alpha-2）に基づく国コード。例：US、CN。
original_url iOS 14以降のデバイスで同意していないユーザーの場合、または広告主が高プライバシーモード（AP）を有効にしている場合は表示されません。ユーザー獲得がデータの受信先パートナーにアトリビューションされた場合にのみ、値が入ります。
mediation_network 対象のインプレッションに関連付けられたメディエーションネットワーク。ネットワークの一覧を確認
ad_unit 2023年第3四半期に提供予定：対象のインプレッションに関連付けられた収益化用のad_unit。
placement 2023年第3四半期に提供予定：対象のインプレッションに関連付けられた収益化用のplacement。

レポートデータのサンプルをダウンロード

レポートをダウンロード

アプリ内広告収益（IAA）のポストバック

IAAポストバックは、AppsFlyerがパートナーに収益情報を送信するもう1つの方法です。 Ad Revenue UA Signalsレポートと比べた主な利点は速報性です。IAAの収益データをほぼリアルタイムで共有できます。これに対し、Ad Revenue UA Signalsレポートでは、イベント発生日の翌日（X+1）にデータが提供されます。

ただし、リアルタイムのデータは、X+1のデータと比べて正確性が劣ります。

  • リアルタイムのIAAポストバックデータは、UA SignalsレポートのX+1のデータに比べ、正確性が平均で±5%低くなります。
  • リアルタイムのIAAポストバックデータは、UA SignalsレポートのX+1のデータに比べ、網羅性が平均で±7%低くなります。

IAAポストバックのデータソースは？

IAAポストバックには、パートナーがユーザーのデバイスに読み込んだインプレッション単位のデータが使用されます。このデータは、広告主がデバイスに組み込んだROI360 Ad Revenue SDKを通じてAppsFlyerに共有されます。 SDK APIを使用すると、アプリ開発者は、インプレッション単位の収益データ（ILRD）、通貨、メディエーションプラットフォーム、収益化ソースなどのパラメータを含むインプレッションイベントを送信できます。

広告主のデバイスからAppsFlyerへのデータ送信は、広告主の権限設定と、広告主がROI360 Advancedの契約者であるかどうかによって異なります。

IAAポストバックデータの処理

AppsFlyer ROI360は、受信したインプレッション単位のデータごとに、以下の処理を行います。

  1. データの正規化。
  2. インストールのメディアソースへのアトリビューションと、データへの追加情報の付与。
  3. af_ad_revenueイベントの生成。

ポストバックデータの配信方法

AppsFlyerとパートナーの既存のポストバック設定を通じて、イベントが追加パラメータとしてパートナーに送信されます。

アプリ内購入（IAP）のポストバック

ROI360のアプリ内購入ポストバックでは、各取引の検証と重複排除を行い、さらにストア手数料と売上税を差し引くことで、収益レポートの精度を高めます。

IAPポストバックのデータソース

IAPポストバックには、以下のデータが使用されます。

  1. デバイスでアプリ内購入または自動更新サブスクリプションのイベントが発生するたびに、ROI360 Purchase SDKが読み取る取引単位のデータ。

  2. 受信したApp StoreおよびGoogle Play（RTDN）のサーバー通知も、AppsFlyerの購入・サブスクリプション収益の処理ロジックによって処理されます。

    • SDKですでに報告されている取引の通知は、検証のうえ処理されます。
    • 未報告の取引に関する通知は、AppsFlyerに報告されません。

    注意：広告主からAppsFlyerへのデータ送信は、広告主の権限設定と、広告主がROI360 Advancedの契約者であるかどうかによって異なります。

IAPポストバックデータの処理

AppsFlyer ROI360は、受信した取引単位のデータごとに、以下の処理を行います。

  1. AppsFlyerは、該当するストアで購入またはサブスクリプションを検証し、不正でないことを確認します。
    • 検証に成功すると、購入またはサブスクリプションを記録します。
    • レシートの検証に失敗した場合、イベントはブロックされたアプリ内イベントのローデータレポートに表示されます。このレポートはProtect360の契約者が利用できます。
  2. iOSのファミリー共有に関連する取引も含め、取引の重複を排除します。
  3. AppsFlyerは、ストア手数料と税金を考慮して純収益（True Revenue）を算出します。
  4. 検証・処理済みの取引について、内部的な購入イベントまたはライフサイクルイベントを生成します。

ポストバックの配信方法

IAPイベントは、AppsFlyerとパートナーの既存のポストバック連携を通じてパートナーに送信されます。

IAPイベントの種類

ROI360の契約者は、以下の収益が発生するイベントの名前を共有できます。

イベント名

イベント名 説明
af_purchase ユーザーが購入したときに記録されます。
af_purchase_refund 購入に対して払い戻しが行われたときに記録されます。
af_ars_trial_converted トライアル期間の終了後、通常価格での更新が開始されたときに記録されます。
af_ars_subscription_started 割引価格または通常価格のサブスクリプションが開始されたときに記録されます。
af_ars_subscription_resumed 解約または払い戻し済みのサブスクリプションが、通常価格で再開されたときに記録されます。
af_ars_subscription_refunded サブスクリプションの利用者に払い戻しが行われたときに記録されます。
af_ars_subscription_renewed サブスクリプションが自動更新されたときに記録されます。
af_ars_subscription_xgraded 利用者が別の製品にアップグレード、ダウングレード、またはクロスグレードしたときに記録されます。

Tags