ローデータ項目の手引き

概要:ローデータ項目の辞書(ローデータにおける各項目の仕様)を説明します。この情報は、フィールドの意味、書式設定方法、およびフィールドがいつ使用可能になるかを理解するのに役立ちます。

ローデータ項目の手引き 

次の表は、様々なAppsFlyerのレポートで使用可能なローデータ項目をリスト化したディクショナリです。この表は、AppsFlyerに追加のローデータ項目が追加されるにつれて、更新されていきます。

ディクショナリテーブルの列は次の通りです:  

  • 項目グループ: 項目の使用目的に基づく論理的なグループ化。注意!広告収益グループのフィールドは、ローデータレポートに独自の列として表示されるか、Event Value(イベント値)の一部として入力されます。 
  • 項目名
    • ローデータ出力画面またはPull API経由のレポートで使用される項目名。
    • [n] という表記は、同じファイル内に複数のインスタンスがあることを意味し、その違いはインスタンス番号です。例えば、Sub Param [n] は、Sub Param 1、Sub Param 2、...Sub Param 5 まであり、n の値は (n=1-5) と示されています。 
  • API名
    • Data Lockerおよび PushAPIレポートに表示される項目名。
    • [n] という表記は、同じファイル内に複数のインスタンスがあることを意味し、その違いはインスタンス番号です。例えば、Sub Param [n] は、Sub Param 1、Sub Param 2、...Sub Param 5 まであり、n の値は (n=1-5) と示されています。 
  • ソース:項目コンテンツの元のソースの場所。例:
  • 詳細
    • 一部に項目は、例えばユーザー獲得やリターゲティングキャンペーンの結果など、イベントの内容に応じて異なる意味を持ちます。
  • 形式:項目の種類と長さ
    • 文字列:文字列の最大長。1024文字の文字数制限、またはこちらに記載されているフィールドの長さの制限を超えないようにしてください。
    • 日付時刻
      • 形式:yyyy-mm-dd hh:mm:ss例えば、2019-09-17 00:09:25データを表示するタイムゾーンは、次の通り、データ取得方法によって異なります。
        • ローデータ出力画面:アプリで設定されているタイムゾーン。
        • Push API:時刻項目には selected_time_zone のオプションがあり、アプリ指定のタイムゾーンの値が紐づきますが、このパラメーターがない場合は、UTCで表示されます。
        • Master API:デフォルトはアプリ設定画面で選択されたタイムゾーンです。
        • Data Locker:UTC
      • CSVファイルの日付項目の形式は、yyyy-mm-dd です。ExcelでCSVファイルを開くと、日付項目はコンピューターの日付と時刻の設定を使用して書式設定されます。表示形式はExcelで変更できます。書式設定されていない値を表示するには、エディターを使用してファイルを開いてください。
      • Push API:
        • UTCでのタイムスタンプ項目:形式 - yyyy-mm-dd hh:mm:ss.sss  / 例:2019-09-17 00:09:25.123 
        • 選択したタイムゾーンでのタイムスタンプ項目:形式 - yyyy-mm-dd hh:mm:ss.sss±th:tm / 例:2019-01-20 04:51:16.000+0000
    • Enum型 - n文字:Enum型の項目には特定の値のみを含めることができます。例えば、cost currencyは3文字で、指定された通貨コードのみを含むことができます。
    • Enum型 - 5文字 boolean型:項目の値は、TRUEまたはFALSEのいずれかです。

 ヒント

  • 表を並び替えるには、列名をクリックします。
  • テーブルをダウンロードすることもできます。
  • ダウンロードしたCSVには、上記の項目に加えて次の項目が含まれています:
    • 主要なAppsFlyerレポートのスキーマの一部
      • AppsFlyerレポートの大部分は、同じスキーマから構成され、同じ項目を含んでいます。
      • 一部の項目には、レポートに応じて、またデータがアドネットワークや広告主、デバイスプラットフォームなどから収集されるかどうかに応じて、Null または空の値が入力される場合があります。  
      • BIシステムを設定する際は、特定のレポートが常に Null または空の値として返される場合でも、全ての主要なAppsFlyerスキーマの項目を設定するのがベストです。これにより、データが利用可能になった時に簡単にデータを取り込むことができます。  
      • 項目が主要なAppsFlyerレポートのスキーマの一部でない場合は、その項目は特定のレポートにのみ含まれます。例:SKANレポート
    • レポートの配信方法:特定の項目が、Push API、ローデータ出力 / Pull API、およびData Lockerを介して使用できるかどうかを示します。注記:項目が主要なAppsFlyerレポートのスキーマの一部である場合でも、特定の方法で配信されるレポートの一部ではない場合があります。例えば、プレースメント項目は主要なAppsFlyerスキーマの一部ですが、Data Locker、Pull API、またはローデータ出力画面経由で取得されたレポートにのみ表示され、Push APIを介して配信されたレポートには表示されません。
項目グループ カラム名 API名 データソース 詳細 形式
計測 Ad af_ad 計測リンク 広告名 文字列
SKAN Ad ID ad_network
_ad_id
アドネットワーク Ad ID 文字列
計測 Ad ID af_ad_id 計測リンク Ad ID String/Int
SKAN Ad name ad_network
_ad_name
アドネットワーク Ad name 文字列
SKAN Ad network ID skad_ad
_network_id
iOS ポストバックが送信されたアドネットワークのID 文字列
SKAN Ad network name ad_network
_name
アドネットワーク
  • アドネットワークからAppsFlyerにレポートされたアドネットワーク名
  • この項目が空のときは、アドネットワークが入力しなかった(もしくは、できなかった)場合です。
  • skad_ad_network_idの値を使用することで、アドネットワーク名の補完が可能です。この表を使用してください。
文字列
SKAN Ad network source app ID ad_network_source_app_id アドネットワーク アドネットワークによりレポートされたパブリッシャーのアプリID。コストの調整に使用してください。アドネットワークによりレポートされます。パブリッシャーアプリがこのデータの基礎を提供します。 文字列
SKAN Ad network timestamp ad_network
_timestamp
アドネットワーク
  • アドネットワークがポストバックを受信した時刻
  • Google 広告の場合、この項目は入力されません。
タイムスタンプ
計測 Ad placement ad_placement 計測リンク CTV ad placementに入力 文字列
広告収益 Ad revenue ad type ad_ revenue_ad_type 広告収益SDK 表示された広告のタイプ 文字列
広告収益 Ad revenue custom parameters ad_revenue_custom_parameters 広告収益SDK アプリに表示される広告の広告収益SDKを介して広告主が提供するカスタムパラメーター 文字列
計測 Ad type af_ad_type 計測リンク 例:banner、footer 文字列
広告収益 Ad unit ad_unit 広告収益API 広告収益、A/B テスト実施時の広告セグメント名 文字列
計測 Adset af_adset 計測リンク 広告セット名:1つ以上の広告を含むグループを識別します。 文字列
SKAN Adset ID ad_network
_adset_id
アドネットワーク Adset ID 文字列
計測 Adset ID af_adset_id 計測リンク 広告セットID:1つ以上の広告を含むグループを識別します。 文字列
SKAN Adset name ad_network
_adset_name
アドネットワーク Adset name 文字列
デバイス情報 Advertising ID for Android devices advertising_id SDK
  • ユーザーがリセット可能なAndroidの広告ID=GAID
  • CTVの場合、これはCTV IDです。例:RIDA または VIDA
文字列
SKAN AF attribution flag af_attribution
_flag
AF SSOTモードがオンの時:true の場合、インストールはAppsFlyerとSKANの両方で計測されます。false の場合、インストールはAppsFlyerでは計測されていません。skad_conversion_value が null の場合、フラグは true または falseのいずれかになります (モデリングに基づく) 。 Boolean型
デバイス情報 Amazon Fire ID amazon_aid SDK Amazon端末上のユーザーがリセットできる広告ID 文字列
SKAN Ambiguous event skad_ambiguous
_event
AF true の場合、広告主が管理画面上でSKANの設定を変更してから最初の72時間以内にiOSポストバックを受信したことを示します。
SKANで採用されている様々なタイマーの仕様により、AppsFlyerではこのイベントを正確にマッピングすることはできません。
Boolean型
デバイス情報 Android ID android_id SDK 永続的なデバイスID 文字列
アプリ App ID app_id SDK AppsFlyerで使用される一意のアプリ識別子。例:
  • iOS:id123456789
  • Android:com.appsflyer.referrersender
文字列
SKAN App ID skad_app_id iOS App ID 文字列
アプリ App name app_name SDK 広告主が設定 文字列
アプリ App type app_type App clip 値:app_clip、full_app 文字列
アプリ App version app_version SDK 広告主が設定 文字
デバイス情報 AppsFlyer ID appsflyer_id SDK
  • アプリがデバイスにインストールされるときにSDKによって生成される一意の IDです。このIDは、TLVフローでアプリ内イベントの計測、コンバージョンデータの取得、およびアプリ内イベントを紐づけるために使用されます。
  • アプリが削除され再度インストールされた場合、新しいIDが生成されます。iCloudバックアップからアプリを復元しても、インストールとは見なされません。
  • CTVの場合、この項目には custom_device_id (広告主が管理するデバイスID) が入力されます。
文字列
デバイス情報 ATT att SDK
  • ATT、別名 att_statusは iOS14以降で利用でき、以下のいずれかの値が入力されます:ATTrackingManagerが返送した値、S2Sが送信した値、AppsFlyerが決定した値
  • ATTは、次のいずれかになります:not_determined、restricted、denied、authorized、af_unknown、af_authorizedmaf_unavailable
文字列
計測 Attributed touch time attributed_touch
_time
AF
  • 新規獲得:計測する広告との接触時刻
  • リターゲティング:計測したエンゲージメントの時刻
Date Time
計測 Attributed touch type attributed_touch
_type
AF
  • UA:含まれる値:click、download、impression、pre-install
  • リターゲティング:click、impression
Enum
計測 Attribution lookback window af_attribution
_lookback
計測リンク
  • 特定の広告との接触からインストールが計測されるまでの最大期間。
  • ユーザー獲得:クリックの計測の場合、af_click_lookback計測リンクパラメーターを設定します。
  • リターゲティング:アプリの設定でリターゲティングのクリックスルールックバック期間を設定します。
文字
SKAN Attribution signature skad_attribution
_signature
iOS アドネットワークによってSKANポストバックに追加された署名 文字列
Protect360 Blocked reason blocked_reason AF Protect360:インストールがブロックされた理由。例:install_hijacking、bots 文字列
Protect360 Blocked reason rule (deprecated) blocked_reason
_rule
AF 非推奨 文字列
Protect360 Blocked reason value blocked_reason
_value
AF Protect360:ブロックに関する追加情報。例:Site ID、検証ルール名 文字列
Protect360 Blocked sub reason blocked_sub
_reason
AF Protect360:ブロック済みインストールのsub-reason。例:install_hijacking。Sub-reason:referer hijack、CTIT_anomalies、 validation_rules 文字列
アプリ Bundle ID bundle_id SDK 文字列
SKAN Campaign ad_network
_campaign
_name
アドネットワーク アドネットワークからAppsFlyerにレポートされたキャンペーン名 文字列
計測 Campaign campaign 計測リンク キャンペーン名 文字列
SKAN Campaign ID ad_network
_campaign_id
アドネットワーク アドネットワークからAppsFlyerにレポートされたキャンペーンID 文字列
計測 Campaign ID af_c_id 計測リンク Campaign ID 文字列
SKAN Campaign ID skad_campaign
id
iOS 広告を公開するために使用されるキャンペーンID。範囲:0~100 整数
計測 Campaign type campaign_type AF ユーザー獲得経路:
  • UA(非オーガニックインストール)
  • Organic(オーガニックインストール)
  • Retargeting(リターゲティング)
  • Unknown(不明)(1)
(1) アプリ内イベント/セッションは、どのメディアソースにも紐づいていません。または、 プライバシーポリシーまたはGDPRの要求によりデータが削除されます。
文字列
デバイス情報 Carrier carrier SDK Android がgetSimCarrierIdName()を使用して提供するキャリア名。キャリアマッピングも参照してください 文字列
SKAN Channel ad_network
_channel
アドネットワーク フィールドはレポートに追加されますが、必ずしも入力されるとは限りません 文字列
計測 Channel af_channel 計測リンク メディアソースチャネル。例:GoogleにおけるYouTube、Meta広告におけるInstagramなど Dynamic Enum型
デバイスの場所 City city AF 端末のIPアドレスに基づいたユーザーの最も詳細な場所。通常、値には都市名が入りますが、より正確な市区町村名が入ることもあります。 文字列
SKAN Coarse conversion value skad_coarse
_conversion
_value
iOS
  • 値:low / medium / high
  • SKANバージョン3の場合:値は null となります。
文字列
計測 Contributor[n] campaign contributor[n]
_campaign
(n=1-3)
AF アシストキャンペーン 文字列
計測 contributor3_engagement_type contributor[n]_engagement_type (n=1-3) AF 想定値:preload、click_to_download、 click_to_app、engaged_click、engaged_view、view、 listening Enum
計測 Contributor[n] match type

contributor[n]
_match_type
(n=1-3)

AF 想定値は、match typeと同じです。 文字列
計測 Contributor[n] media source contributor[n]
_media_source
(n=1-3)
AF アシストメディアソース 文字列
計測 Contributor[n] partner contributor[n]
_af_prt
(n=1-3)
AF 代理店名 / PMD名:常に小文字に変換されます。 文字列
計測 Contributor[n] touch time contributor[n]
_touch_time
(n=1-3)
AF アシストのタッチ時間 日時
計測 Contributor[n] touch type contributor[n]
_touch_type
(n=1-3)
AF 想定値:click、impression Enum
計測 Conversion type conversion_type AF

コンバージョンタイプ:

  • Install(インストール)
  • Reinstall(再インストール)(1)
  • Re-engagement(リエンゲージメント) 
  • Unknown(不明) (2)

(1) conversion_type= reinstall and campaign_type=retargeting がretargeting_conversion_type=re-attribution と同等である場合。

(2) アプリ内イベント/セッションは、どのメディアソースにも紐づいていません。

文字列
SKAN Conversion value skad_conversion
_value
iOS
  • iOSからレポートされるコンバージョン値。範囲:0~63
  • nullの場合、iOS自体がこのフィールドに値を入力しなかったことを示します。
整数
計測 Cost Currency af_cost_currency 計測リンク ISO-4217準拠する3文字の通貨コード(例:USD、EUR)。デフォルトはUSD(米ドル)です。 文字列
計測 Cost Model af_cost_model 計測リンク 計測リンク上でレポートされたコストモデル。CPC / CPI / CPM / その他。現状、コスト計測はこのカラムの値に関係なく、CPIに従って計算されます。 文字列
計測 Cost Value af_cost_value 計測リンク コスト通貨での金額。小数点以下は、4桁まで許可。例:320.5095 文字列
デバイスの場所 Country code country_code AF
  • ISO 3166 (alpha-2)を使用した国コード。例:US、CN
  • 実装されるイギリスの国コードは、UKであり、GBではありません。
Enum
SKAN Creative ad_network
_creative
アドネットワーク
  • 値は、アドネットワークから受信したデータ拡張に基づきます。
  • SKANバージョン3の場合:値は null となります。
文字列
Subscription CUIDs af_cuids AppsFlyer購入SDKコネクタ
  • ARSのコンテキストでは、このパラメーターにすべてのCUIDを持つ配列が含まれます。
  • CUIDの配列は、端末IDに関係なく表示されるため、同じCUIDを複数の端末IDに対して表示できます。
 
計測 Custom data custom_data SDK SDK または S2S で広告主によって設定される項目で、サードパーティやオーディエンスなどとの連携に最もよく使用されるデータです。AndroidおよびiOSを参照してください。 文字列
計測 Custom dimension custom
_dimension
SDK AppsFlyerが将来的に利用するために準備してあります 文字列
デバイス情報 Customer user ID customer
_user_id
SDK アプリ所有者により設定された一意のアプリユーザーID。 文字列
デバイス情報 Deeplink URL deeplink_url SDK ユーザーがディープリンクでリダイレクトされる特定のアプリ内画面へのパス。ディープリンクとディファードディープリンクに使用します。
これは計測リンクの af_dp 値を含みます。
文字列
Protect360 Detection date detection_date AF ポストアトリビューションで不正が検知された日付。 文字列
デバイス情報 Device category device_category 報告されたユーザーエージェント

使用デバイスの種類:Tablet / mobile_phone / desktop / tv / set_top_box / games_console / media_player / unknown_device_category


「unknown_device_category」の値は、AppsFlyerがデバイスのユーザーエージェントを検出できない場合に生成されます。これは、AppsFlyerがデバイスの特性を特定しようとしたが、既知のカテゴリに分類できなかったことを示しています。

文字列
デバイス情報 Device download time device_download
_time
SDK 端末のAndroid/iOSの時計を使用し、UTCに変換したアプリのダウンロード完了時間。値は常にUTC時間で表示されます。
形式:
yyyy-mm-dd hh:mm:ss.sss<>
日時
デバイス情報 Device ID type device_id_type SDK CTVの場合にCTVプラットフォームIDタイプが入力されます。例:RokuのRIDA Enum
デバイス情報 Device model device_model SDK 端末の商用モデル名。例:xiaomi::Redmi、iPhone7 文字列
デバイス情報 Device Type device_type SDK
  • 端末の商用モデル名。
  • [2022年2月2日以降、この項目は入力されなくなりました]
  • この項目の代わりに、 Device modelを使用すると、同様に入力されます。
  • 例:
    • デバイスモデル: xiaomi::Redmi Note 8
    • デバイスタイプ: xiaomi-Redmi Note 8
    • デバイスモデル: iPhone7
    • デバイスタイプ: iPhone 7
文字列
SKAN Did win skad_did_win iOS
  • インストールに貢献または成果が紐づくキャンペーンを区別するために使用されます。
  • true の場合、インストールをもたらした成果がこのキャンペーンに紐づいています。
  • false の場合、キャンペーンはインストールに貢献していると認識されますが、SKANダッシュボードやレポートには含まれません。
  • nullの場合、iOS自体がこのフィールドに値を入力しなかったことを示します。(古いiOSバージョンまたはSKAdNetworkバージョンだったため)
Boolean型
IAP(アプリ内購入)
Subscription
Discount ID af_discount_id AppsFlyer購入SDKコネクタ 最初の購入時にユーザーに提示されたオファー ID。IDは、割引コードがある場合にのみ入力されます。  
Subscription Discount type af_discount_type AppsFlyer購入SDKコネクタ ユーザーが利用したディスカウントの種類。想定値:
  • iOS:
    • introductory
    • subscription
  • Android:
    • intro price
    • one_time_code
    • vanity_code
 
デバイスの場所 DMA dma AF 指定された市場地域または地理的地域。Nielsen社によって定義されています。ユーザー位置情報の決定 文字列
IAP(アプリ内購入)
Subscription
Environment af_environment AppsFlyer購入SDKコネクタ データの受信元の環境(実稼働環境またはサンドボックス)  
計測 Engagement type engagement_type AF 想定値:preload、click_to_download、 click_to_app、engaged_click、engaged_view、view、 listening 文字列
イベント Event hour event_time ポストバック 最も近い時間に切り捨てで計測されたイベント時刻 日時
イベント Event name event_name AF/SDK
  • アプリから送信された計測イベントタイプ、またはアプリ内イベント名。計測イベントタイプ。例:install、re-engagement など。
  • Data Lockerでは、リターゲティングレポートの場合、イベント名は次のように設定されています:retargetingはリエンゲージメントを、installはリアトリビューションを意味します。SKANレポートの場合、アプリ内イベント名はAppsFlyerで設定されたとおりです。
  • SRN Reportの場合、これはMeta広告で設定されたアプリ内イベント名です。
文字列
イベント Event revenue event_revenue SDK
  • Event Revenue Currencyを用いた収益値。
  • $-1,000,000~$+1,000,000 (もしくはそれと同等) の範囲外の値は、ローデータレポートには表示されますが、集計レポートには表示されません。
文字列
SKAN Event revenue event_revenue AF 計算式:[USDでの特定イベントの値の合計] ÷ [特定の日に発生したイベントの数] Float型
イベント Event Revenue Currency event_revenue
_currency
SDK SDKに報告されたイベントの収益通貨コード 文字列
イベント Event revenue selected currency event_revenue
_xxx
 
  • 収益額。通貨は、使用するレポートツールにより異なります。
  • preferred またはselectedは、アプリ設定で設定されたアプリ固有の通貨を意味します。
  • Data Locker:常にUSD
  • エキスポートページ:選択された通貨
  • PullAPIが選択可能:米ドルまたは&currency=preferredを使用して選択された通貨。
  • Push API: 常に、USDと選択した通貨を含みます
文字列
イベント Event revenue USD event_revenue
_usd*
AF
  • 収益額。通貨は、使用するレポートツールにより異なります。
  • preferred またはselectedは、アプリ設定で設定されたアプリ固有の通貨を意味します。
  • Data Locker:常にUSD
  • エキスポートページ:選択された通貨
  • PullAPIが選択可能:米ドルまたは&currency=preferredを使用して選択された通貨。
  • Push API: 常に、USDと選択した通貨を含みます
文字列
計測 Event source event_source AF SDKまたはS2S Enum
イベント Event time event_time SDK イベント発生時刻 日時
イベント Event type event_type AF/SDK 計測イベントタイプ。計測イベントタイプ。例:install、re-engagement など。 文字列
PBAイベント Event URL event_url ウェブSDK イベントが発生したWebページのURL(Webサイト訪問時のオリジナルURLと同じ) 文字列
イベント Event value event_value SDK SDKから送信されるイベントの詳細。注:1000文字までにしてください。文字が切られる可能性があります。 文字列
SKAN Event value event_value S2S
  • デフォルト値:null
  • カスタムデコード、またはS2S経由のイベント送信を実装しているアプリによって設定された文字列が含まれます
  • 広告主側のシステムで利用しているもので、AppsFlyer側では利用していません。
文字列 (JSON)
SKAN Fidelity type fidelity_type  
  • 計測に影響する、広告表示方法の違いを区別します。0と1の値を使用して次のように指定されます:
    • ビュースルー広告 (0)
    • ストアキットレンダリング広告 (1)
    • SKANバージョンが2.2より前の場合は、項目の値を無視してください。
整数
SKAN Fidelity type skad_fidelity
_type
iOS
  • 計測に影響する、広告表示方法の違いを区別します。0と1の値を使用して以下のように指定されます:
    • ビュースルー広告 (0)
    • ストアキットレンダリング広告 (1)
    • SKANバージョンが2.2より前の場合は、項目の値を無視してください。フィールドはレポートに追加されますが、必ずしも入力されるとは限りません
整数
Protect360 Fraud reason fraud_reason AF Protect360:ブロックされた理由を参照してください。 文字列
Protect360 Fraud sub reason fraud_sub
_reason
AF Protect360:ブロックされたサブ理由を参照してください。 文字列
計測 Google Play broadcast referrer gp_broadcast_
_referrer
Google Play store Google PlayのBroadcast Referrer 文字列
計測 Google Play click time gp_click_time Google Play field
  • 広告クリック後にGooglePlay内のアプリページが読み込まれた時間
  • タイムソース:Google API
  • Android SDK v.4.8.5以降に対応
  • 例: install_timeとgp_click_timeを比較してください。これにより、アプリダウンロードとユーザーが起動するまでにどれだけの時間が経過したかについて洞察を得ることができます。
タイムスタンプ
計測 Google Play install begin time gp_install_begin Google Play store
  • インストールが開始される時刻
  • タイムソース:Google API
  • Android SDK v.4.8.5以降に対応
タイムスタンプ
計測 Google Play referrer gp_referrer Google Play store
  • インストールされたアプリのリファラ-URL
  • Android SDK v.4.8.5以降に対応
文字列
計測 HTTP referrer http_referrer AF AppsFlyerのClick URLが貼られたWebページのアドレスを特定します。リファラーを確認することで、どこでリクエストが発生したかが分かります。 文字列
デバイス情報 IDFA idfa SDK ユーザーがリセット可能なiOSデバイスの広告ID。IDFAが利用できない場合、0が入力されます。 文字
デバイス情報 IDFV idfv SDK iOSから提供されるベンダーID 文字
デバイス情報 IMEI imei SDK 永続的なデバイスID 文字
広告収益 Impressions impressions 広告収益API ユーザーが広告を見た回数 文字列
計測 Install App Store install_app_store SDK アプリがダウンロードされたAndroidストア(詳細 文字列
SKAN Install date install_date iOS ポストバック到着時刻をもとにAppsFlyerが推定します。 時間文字列
計測 Install time install_time ポストバック
  • UA:インストール後の初回起動。
  • リターゲティング:リエンゲージメント/リアトリビューション後の最初の起動
日時
SKAN Install type install_type iOS 新規インストール 文字列
SKAN Interval interval AF アクティビティ期間のインターバル。 整数
デバイスの場所 IP ip AF IPV4またはIPV6のIPアドレス。AppsFlyerはこのアドレスを使用してユーザーの位置情報を把握します。必要に応じて、広告主はレポートとポストバックから、IPアドレスをマスクすることができます。 文字列
Protect360 Is organic is_organic AF アプリ内イベントがオーガニックインストールに紐づいているかどうかを示します。 文字列
計測 Is primary attribution is_primary
_attribution
AF ユーザー獲得(新規インストール):True

リターゲティング:リエンゲージメント期間中に、オリジナルのメディアソース(リエンゲージ前)と、リエンゲージメントメディソースの両方を計測します。リエンゲージメント期間内に発生したイベントについては、オリジナルのユーザー獲得メディアソースはFALSEとなり(プライマリアトリビューションではない)、リエンゲージメントメディアソースはTRUEとなります。
詳細
Enum
イベント Is receipt validated is_receipt
_validated
AF SDKに実装されている時は、TRUE/FALSE/NULL、未実装の場合は空欄です。 Enum
計測 Is retargeting is_retargeting 計測リンク Enum boolean型
計測 Keyword ID keyword_id 計測リンク アドネットワークから返されるKeyword ID。af_keyword に紐づくID。 文字列
計測 Keyword match type keyword_match
_type
AF
  • キーワードマッチタイプはGoogle AdWordsのみで提供されます。
  • 2021年2月15日以降、Apple Search Adsに関してはこの項目は入力されなくなりました。
文字列
計測 Keywords af_keywords 計測リンク ユーザーがオンライン検索の際に使用した単語。 アドネットワークからレポートされたもの 文字列
デバイス情報 Language language SDK 端末OSによって設定され、端末から取得した 言語設定(+地域情報)。通常、ll-DD形式になります。llは言語、DDは方言です。例えば、en-ZA は、南アフリカで使われている英語を意味します。 文字列
デバイス情報 Limit ad tracking is_lat SDK

広告トラッキング制限 (LAT):

  • iOSiOS 14以降、LATはAppleにより廃止されます。ATTを使用してユーザーのプライバシーステータスを決定します。またその場合、is_latの値は無視してください。
    iOS 14より前は、trueの場合IDFA は利用できず、値は0に設定されます。
  • Android:true に設定されている場合、ユーザーはインタレストベース広告をオプトアウトしています。GAIDはデータを収集せず、代わりにゼロを表示します。
Enum boolean型
計測 Match type match_type AF

計測方法のタイプ。表示される値は次のとおりです:

文字列
SKAN Max event counter max_event
_counter
AF ユーザーが特定のアプリ内イベントを実行する回数を決めるには、[round up (min_event_counter + max_event_counter) / 2]という数式を使用してください。注意!値は最も近い整数に繰り上げる必要があります。
例:
A.最小=0、最大=1の場合、平均は0.5です。切り上げると1になります。
B.最小=5、最大=10 の場合、平均は7.5です。切り上げると8になります。
整数
SKAN Max revenue max_revenue AF 収益は常に項目skad_revenueで提供されます。SKAN4、またはCustomモードを使用する場合、イベントに関連付けられ、skad_revenue の計算に使用されるバケットの範囲は、min_revenueとmax_revenue で記述されます。 実数
SKAN Max time post-install max_time
_post_install
AF
  • カスタムコンバージョンの場合:AppsFlyerはインストール時刻を、「ポストバック到着時刻-36h-平均 (min_time_post_install + max_time_post_install)」のように計算します。ただし、CV=0の場合、平均 (min_time_post_install + max_time_post_install) は0と見なされます。
  • デコード変換の場合:min_time_post_installの値はmax_time_post_installで設定されている値よりも1時間短くなります。これは、デコード変換マッピングでユーザーが設定した hours_from_installと同じです。
整数
PBA計測 Media channel media_channel Web SDK Webサイト訪問が起因するメディアチャネル 文字列
計測 Media source media_source 計測リンク イベントまたはrestrictedに紐づくメディアソース 文字列
広告収益 Mediation Network mediation
_network
広告収益API AppsFlyerにイベントを送信する広告収益メディエーションネットワーク 文字列
SKAN Min event count min_event
_counter
AF ユーザーがイベントを実行した回数を計算するために使用します。ユーザーが特定のアプリ内イベントを実行する回数を決めるには、[round up (min_event_counter + max_event_counter) / 2] という数式を使用してください。注意!値は最も近い整数に繰り上げる必要があります。
例:
A.最小=0、最大=1の場合、平均は0.5です。切り上げると1になります。
B.最小=5、最大=10 の場合、平均は7.5です。切り上げると8になります。
整数
SKAN Min revenue min_revenue AF 収益は常に項目skad_revenueで提供されます。SKAN4、またはCustomモードを使用する場合、イベントに関連付けられ、skad_revenue の計算に使用されるバケットの範囲は、min_revenueとmax_revenue で記述されます。 実数
SKAN Min time post-install min_time
_post_install
AF
  • カスタムコンバージョンの場合:AppsFlyerはインストール時刻を、「ポストバック到着時刻-36h-平均 (min_time_post_install + max_time_post_install)」のように計算します。ただし、CV=0の場合、平均 (min_time_post_install + max_time_post_install) は0と見なされます。
  • デコード変換の場合:min_time_post_installの値はmax_time_post_installで設定されている値よりも1時間短くなります。これは、デコード変換マッピングでユーザーが設定した hours_from_installと同じです。
整数
広告収益 Monetization network monetization
_network
広告収益API 広告を配信する広告収益ネットワーク 文字列
IAP(アプリ内購入)
Subscription
Net revenue af_net_revenue True Revenue API すべての要因に基づいて計算された純収益。af_net_revenue_factorsを参照してください。  
IAP(アプリ内購入)
Subscription
Net revenue country af_net_revenue
_country
True Revenue API
  • 税が適用される2文字のISO国コード
  • 例:GB
 
IAP(アプリ内購入)
Subscription
Net revenue factors af_net_revenue
_factors
True Revenue API
  • レポートされた af_net_revenueの額を生成するすべての考慮に入れるべき理由を表す配列
  • 値の例: store_commission
 
IAP(アプリ内購入)
Subscription
Net revenue postal code af_net_revenue
_postal_code
True Revenue API
  • 文字列または/および数字
  • 例:L4J8E3
 
IAP(アプリ内購入)
Subscription
Net revenue subdivision af_net_revenue
_subdivision
True Revenue API
  • 一部の国では、追加の州/下位区分が存在する可能性があります。これは、ISO 3166-2サブディビジョンコードに従って実行されます。
  • 国コードとサブディビジョンコードが含まれます。
  • 例:US-CA
 
IAP(アプリ内購入)
Subscription
Net revenue tax exclusive af_net_revenue
_tax_exclusive
True Revenue API
  • Boolean型パラメータ、true または false。
  • Falseの場合、税金は収益額に含まれていることを意味します。
  • Trueの場合、記載された収益額に税金が加算されることを意味します。例えば、USAまたはカナダでは、表示される価格に税金は含まれていません。
 
IAP(アプリ内購入)
Subscription
Net revenue tax name af_net_revenue
_tax_name
True Revenue API
  • 特定の税の種類を示す顧客の請求書に表示される税の名前。
  • 例:消費税、VAT、GST
 
IAP(アプリ内購入)
Subscription
Net revenue tax rate af_net_revenue
_tax_rate
True Revenue API
  • 徴収された税率を表す小数点以下4桁までの数値
  • 例:7.25
 
計測 Network account ID network
_account_id
計測リンク 広告ネットワークの広告主アカウント ID 文字列
デバイス情報 OAID oaid SDK 一部のAndroid端末でGAIDの代わりに利用されている、ユーザーがリセット可能なID 文字
デバイス情報 Operator operator SDK SIM MCCMNCから派生したモバイルオペレーター名。ユーザーがAndroidgetNetworkOperatorName()を使用したネットワークに登録している場合に利用できます。 文字列
IAP(アプリ内購入)
Subscription
Order ID af_order_id AppsFlyer購入SDKコネクタ
  • トランザクションの注文ID
  • Androidのみ
 
IAP(アプリ内購入)
Subscription
Original transaction ID af_original
_transaction_id
AppsFlyer購入SDKコネクタ
  • 元のトランザクション ID
  • iOSのみ
 
計測 Original URL original_url 計測リンク
  • UA:使用されたクリック/インプレッションURL。リンクがブランドリンクの場合:この項目にはブランドリンクが入力されます。
  • リターゲティング:次のいずれかが含まれます。リターゲティングリンク、ディープリンクデータ、SRNの場合は空です。
ストリング (URL)
デバイス情報 OS version os_version SDK デバイスのOSバージョン 文字列
計測 Partner af_prt 計測リンク 代理店識別子。SKANは、入力できない可能性があります。 文字列
広告収益 Placement placement 広告収益API アプリ内のどこに広告が表示されるか 文字列
デバイス情報 Platform platform SDK 端末のプラットフォーム:OS/Android/Windows Mobile Enum
デバイスの場所 Postal code postal_code AF SDKが報告したデバイスIDアドレスを使用。SKANは、2021年8月30日以降、常にnullになります。 文字列
SKAN Postback sequence index skad_postback
_sequence_index
iOS
  • 値はSKAN期間を示します (0、1、または2)
  • SKAN3の場合、値は0です
整数
IAP(アプリ内購入)
Subscription
Product ID af_product_id AppsFlyer購入SDKコネクタ サブスクリプションのプロダクトID  
IAP(アプリ内購入)
Subscription
Purchase date af_purchase
_date_ms
AppsFlyer購入SDKコネクタ レポートされたプロダクトIDアプリ内イベントの購入日  
IAP(アプリ内購入) Purchase state af_purchase_state AppsFlyer購入SDKコネクタ 想定値:
  • Purchased(購入済み)
  • Canceled(キャンセル)
  • Pending (承認待ち)
 
IAP(アプリ内購入)
Subscription
Purchase token af_purchase
_token
AppsFlyer購入SDKコネクタ
  • トランザクションの購入トークン
  • Androidのみ
 
PBA Query params query_params 計測リンク

リダイレクトURL上のクエリパラメーター (?の後)。
例:https://www.brandpitt.com/signin?utm_source=Google
&utm_term=shoes
&utm_campaign=cool
&c=summer
&af_siteid=publisher
&af_sub1=helloworld
&af_keyword=shoes

URLにクエリパラメーターがない場合、この値はnull になります

文字列
IAP(アプリ内購入)
Subscription
Reason af_reason AppsFlyer購入SDKコネクタ

キャンセルまたは解約関連のイベントにおける、ユーザーが解約またはキャンセルした理由。含まれる値:

  • iOS:
    • cancel_intent(意図的な解約)
    • billing_issue(請求問題)
    • declined_price_increase
    • product_unavailable(サービス利用不可)
  • Android:
    • I don't use this service enough(このサービスを利用していません)
    • Technical issues(テクニカル問題)
    • Cost-related reasons(コスト問題)
    • I found a better app(他に良いアプリを見つけた)
    • その他
  • サブスクリプション再開イベントで、ユーザーがサブスクリプションを再開した理由。含まれる値(Android): paused、resumed
    disabled, enabled auto-renew(自動更新の無効 / 有効)
  • 返金関連のイベントでユーザーが払い戻しを受けた理由:含まれる値(iOS) - 1:アプリの問題
    0:その他
 
SKAN Redownload skad
_redownload
iOS trueの場合、アプリは再ダウンロードされたことを意味します Boolean型
計測 Reengagement window af_reengagement
_window
計測リンク
  • リターゲティング:イベントがリターゲティングキャンペーンに計測される期間
  • 注:このフィールドはリターゲティングキャンペーンでは入力されません。
文字列
IAP(アプリ内購入)
Subscription
Refund ransaction ID af_refunded
_transaction_ids
AppsFlyer購入SDKコネクタ
  • 返金されたすべてのトランザクションIDの配列
  • iOSのみ
 
デバイスの場所 Region region AF SDKからレポートしたデバイスIDアドレスを使用。SKANはcountry_codeに応じて決まります 文字列
Protect360 Rejected reason rejected_reason AF Protect360:将来的に廃止が予定されています。現在ブロックの理由が含まれています。 文字列
Protect360 Rejected reason value rejected
_reason_value
Data Lockerの場合:validation
_reason_value
AF
  • Protect360:Protect360:ポストアトリビューションでのインストール/アプリ内イベンのトハイジャックに関する有効なコントリビューター(メディアソース)を示しています。contributor[1-3]またはorganicのいずれかが入力されます。
  • Data Lockerでは、validation_reason_value と表示されます。
文字列
計測 Retargeting conversion type retargeting
_conversion_type
AF
  • UA:再インストール
  • リターゲティングRe-engagement / Re-attribution
  • 非推奨化予定:このフィールドは将来的に廃止される予定です。conversion_typeとcampaign_typeを使用して、コンバージョンのコンテキストを決定します。
Enum
SKAN Revenue skad_revenue iOS USD(米ドル)でのイベント収益額。 Float型
アプリ SDK version sdk_version SDK AppsFlyer SDKのバージョン 文字列
広告収益 Segment segment 広告収益API 広告収益の広告セグメント名 文字列
計測 Site ID af_siteid 計測リンク パブリッシャーID 文字列
SKAN SKAN measurement window measurement
_window
AF アクティビティウィンドウの期間デフォルト:24h 整数
SKAN SKAN mode skad_mode AF iOSポストバックをデコードするために使用されたコンバージョン計測モード。選択肢:
  • custom_decode
  • revenue
  • イベント
  • skan4
  • custom_encode
  • エンゲージメント
文字列
SKAN SKANトランザクションID skad
_transaction_id
iOS Apple提供のポストバックID 文字列
SKAN SKANバージョン skad_version iOS SKANバージョン 文字列
SKAN Source app ID ad_network
_source_app_id (1)
アドネットワーク アドネットワークによりレポートされたパブリッシャーのアプリID。コストの調整に使用してください。アドネットワークによりレポートされます。このデータはパブリッシャーアプリにより提供されます。フィールドはレポートに追加されますが、必ずしも入力されるとは限りません 文字列
SKAN Source app ID skad_source
_app_id
iOS
  • サイトID - 広告を掲載するアプリです。
  • 項目の入力は、プライバシーのしきい値によって異なります
文字列
SKAN Source domain skad_source
_domain
iOS
  • 値は計測可能なWeb広告のソースを表示しています。
  • SKANバージョン3の場合:値は null となります。
文字列
SKAN Source identifier skad_source
識別子
iOS
  • 値は最大4桁です
  • SKAN3は、値はnullとなります。
文字列
デバイスの場所 State State AF SDKからレポートされたデバイスIPアドレスを使用 文字列
IAP(アプリ内購入)
Subscription
Store af_store AppsFlyer購入SDKコネクタ サブスクリプションサービスを購入したアプリストア(例:Google Play/App Store)  
IAP(アプリ内購入)
Subscription
commission af_revenue_usd True Revenue API
  • 購入されたサービスからストアが受け取るコミッションの割合(%)
  • 10進数で表示されます。
  • 例:30
 
計測 Store product page store_product
_page
AF ユーザーがリダイレクトされたAndroidまたはAppleアプリストア(iOS 15以降)のカスタムプロダクトページ。 文字列
デバイス情報 Store reinstall store_reinstall SDK
  • Appleアプリストアは、Apple Search Ads経由のユーザーがAppleユーザーIDを使用した再インストールかどうかを判断します:
  • 新規ユーザーの場合:false
  • 再インストールの場合:true
Enum boolean型
計測 Sub param [n] af_sub[n] (n=1-5) 計測リンク 広告主が計測リンクに入力したパラメータ 文字列
計測 Sub site ID af_sub_siteid 計測リンク Sub-publisher ID 文字列
Subscription Subscription expiration date af_expires
_date_ms
  現在のサブスクリプション請求サイクルの有効期限  
Subscription Subscription ownership type af_subscription
_ownership_type
AppsFlyer購入SDKコネクタ FAMILY_SHARED:ユーザーが家族での共有を介してアクセスできることを意味します。PURCHASED:有料ユーザーが購入を行ったことを意味します。  
Subscription Subscription ownership type af_period_type AppsFlyer購入SDKコネクタ
  • サブスクリプションまたはトライアル期間の種類
  • 可能な値:trial、intro、normal
 
SKAN Timestamp timestamp アドネットワーク AppsFlyerがポストバックを受信した時刻
Google広告とMeta広告の場合、AppsFlyerがそれぞれGoogle Ads APIとMeta広告APIからデータを取得する時です。
Timestamp
IAP(アプリ内購入)
Subscription
Transaction ID af_transaction_id AppsFlyer購入SDKコネクタ
  • トランザクションID
  • iOSのみ
 
デバイス情報 User Agent user_agent 計測リンク URL/デバイス ユーザーエージェント 文字列
デバイス情報 WIFI wifi SDK TRUEまたはFALSEのいずれかに設定します。 Enum boolean型
IAP(アプリ内購入)   af_cancelation
_date_ms
AppsFlyer購入SDKコネクタ キャンセル日  
SKAN   did_win iOS
  • インストールにアシストまたは成果が紐づくキャンペーンを区別するために使用されます。
  • true の場合、インストールをもたらした成果がこのキャンペーンに紐づいています。
  • false の場合、キャンペーンはインストールに貢献していると認識されますが、SKANダッシュボードやレポートには含まれません。
  • nullの場合、iOS自体がこのフィールドに値を入力しなかったことを示します。(古いiOSバージョンまたはSKAdNetworkバージョンだったため)
Boolean型
SKAN   event_uuid AF パートナーが重複したポストバックを識別できるようにする、ユニークな識別子です。 文字列
SKAN   source_app_id AF サイトID。広告が掲載されたアプリです。この項目は、skad_source_app_id と同じです 文字列