ローデータ項目の手引き

計測

Ad

計測リンク

文字列 最大100文字

計測

Ad ID

計測リンク

String型 - 最大24文字まで

計測

Ad type

計測リンク

例：banner、footer

String型 - 最大24文字まで

計測

Adset

計測リンク

文字列最大100文字

計測

Adset ID

計測リンク

広告セットID、広告セットのID。

String型 - 最大24文字まで

計測

Ad placement

計測リンク

CTV.ad placementに入力

String型 64文字

計測

N/A

計測

Campaign ID

計測リンク

計測

Channel

計測リンク

計測

Campaign type

AF

ユーザー獲得経路：

• ユーザー獲得
• オーガニック
• リターゲティング
• 不明

計測

Conversion type

AF

コンバージョンタイプ：

• インストール
• 再インストール (1)
• リエンゲージメント
• 不明 (2)

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

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

計測

Cost currency

計測リンク

計測

Cost model

計測リンク

計測リンク上でレポートされたコストモデル。CPC / CPI / CPM / その他。現状、コスト計測はこのカラムの値に関係なく、CPIベースで計算されます

String型 - 最大20文字まで

計測

Cost value

計測リンク

計測

Keywords

計測リンク

アドネットワークからレポートされた通りのユーザーのオンライン検索で使用された単語（フレーズ）

String型 - 最大100文字まで

計測

Attribution lookback window

計測リンク

特定の広告との接触からインストールが計測されるまでの最大期間。

• ユーザー獲得：クリック計測については、計測リンク上の af_click_lookback パラメーターで設定されます。
• リターゲティング：リターゲティングクリックスルールックバック。

最大3文字まで

計測

Partner

計測リンク

代理店名 / PMD

String型 - 最大50文字まで

計測

Re-engagement window

計測リンク

リターゲティング：イベントがリターゲティングキャンペーンに紐づけられる期間。

注：この項目はリターゲティングキャンペーンでは入力されません。

計測

Site ID

計測リンク

計測

Sub site ID

サブパブリッシャーID

String型 - 最大50文字まで

計測

Sub param [n]

(n=1-5)

計測リンク

計測

Campaign

計測リンク

キャンペーン名

String型 - 最大100文字まで

計測

Is retargeting

計測リンク

• ユーザー獲得: False
• リターゲティング: リターゲティングコンバージョンとイベントに関しては True

Enum型 - 5文字 : boolean型

計測

Media source

計測リンク

イベントまたは restrictedに紐づくメディアソース

String型 - 最大50文字まで

計測

Original URL

計測リンク

• ユーザー獲得: 使用されたクリック／インプレッションURL。リンクがブランドリンクの場合：この項目にはブランドリンクが入力されます。
• リターゲティング：次のいずれかが含まれます：リターゲティングリンク、ディープリンクデータ、SRNの場合は空白

デバイス情報

User agent

計測リンク

デバイス情報

Advertising ID

SDK

• ユーザーがリセット可能なAndroidの広告ID＝GAIDで、
• CTVの場合、これはCTV IDです。例：RIDA または VIDA

デバイス情報

Device ID type

SDK

CTVの場合にCTVプラットフォームIDタイプが入力されます。例：RokuのRIDA

デバイス情報

Android ID

SDK

アプリ

App ID

SDK

• iOS: id123456789
• Android: com.appsflyer.referrersender

iOS: String型 - 最大12文字

Android: String型 - 最大100文字

アプリ

App name

SDK

アプリ

App version

SDK

デバイス情報

AppsFlyer ID

SDK

• アプリがデバイスにインストールされるときにSDKによって生成される一意の ID。このIDは、TLVフローでアプリ内イベントの計測、コンバージョンデータの取得、およびアプリ内イベントを紐づけるために使用されます。
• アプリが削除され再度インストールされた場合、新しいIDが生成されます。iCloudバックアップからアプリを復元しても、インストールとは見なされません。
• CTV の場合、この項目には custom_device_id (広告主が管理するデバイス ID) が入力されます。

iOS：String型 - 最大24文字まで

Android：String型 - 最大33文字まで

アプリ

Bundle ID

SDK

iOS：単一アプリまたはアプリグループをiOSで一致するための識別子（AppleディベロッパーバンドルIDを参照）

Android：アプリ名

注：この項目はAppsFlyer PBAとは関係ありません。

デバイス情報

Carrier

SDK

getSimCarrierIdName() を使用してAndroidから提供されるキャリア名。キャリアマッピングを参照。

デバイスの場所

Country code

AF

• ISO 3166 (alpha-2) を使用した国コード：US、CNなど。
• 実装されるイギリスの国コードは、UKであり、GBではありません。

計測

Custom data

SDK

• SDK または S2S で広告主によって設定される項目で、サードパーティやオーディエンスなどとの連携に最もよく使用されるデータです。
• Android と iOSをご覧ください。

デバイス情報

Customer
user ID

SDK

デバイス情報

Deeplink URL

SDK

デバイス情報

Device category

SDK

• 可能な値は次のとおりです： phone、tablet、other
• Android SDK v4.8.8以降より対応

デバイス情報

Device type

SDK

端末の商用モデル名

[2022年2月2日以降、この項目は入力されなくなりました]

この項目の代わりに、 Device modelを使用すると、同様に入力されます。

例：

• Device model: xiaomi::Redmi Note 8
  Device type: xiaomi-Redmi Note 8
• Device model: iPhone7
  Device type: iPhone 7

String型 - 最大100文字まで

デバイス情報

Device model 

SDK 

デバイス情報

Device download time

SDK

デバイス (Android、iOS) の時計を使用してUTCに変換されたアプリダウンロードの完了時刻。値は常にUTC時刻で表示されます。

形式：yyyy-mm-dd hh:mm:ss.sss

イベント

Event name

AF/SDK

アプリから送信された計測イベントタイプ、またはアプリ内イベント名。計測イベントタイプの例： install、re-engagementなど。

注記！Data Lockerでは、リターゲティングレポートの場合、イベント名は次のように設定されています：retargeting はリエンゲージメントを、install はリアトリビューションを意味します。

イベント

Event revenue

SDK

• Event Revenue Currencyを用いた収益値。
• $-10,000～$+10,000 (もしくはそれと同等) の範囲外の値は、ローデータレポートには表示されますが、集計レポートには含まれません。

イベント

Event revenue currency

SDK

イベント

Event time

SDK

イベント発生時刻

イベント

Event value

SDK

SDKから送信されるイベントの詳細。注記：1,000字以上は送信しないでください。切り捨てられる可能性があります。

デバイス情報

IDFA

SDK

デバイス情報

IDFV

SDK

デバイス情報

IMEI

SDK

計測

Install app store

SDK

計測

Install time

SDK

• ユーザー獲得：インストール後の初回起動。
• リターゲティング：リエンゲージメント／リアトリビューション後の初回起動。

Date Time

デバイスの場所

IP

AF

デバイス情報

Is LAT

SDK

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

iOS：iOS 14以降、LATはAppleにより廃止されます。ATTを使用してユーザーのプライバシーステータスを決定します。またその場合、is_lat の値は無視してください。

iOS 14より前は、true の場合 IDFA は利用できず、値は0に設定されます。

Android：true の場合、ユーザーは興味に基づく広告からオプトアウトしています。これはGAIDの収集を妨げるものではありません。

デバイス情報

Language

SDK

デバイスOSによって設定されデバイスから取得した言語（ロケール）設定。通常、ll-DDの形式になります。llが言語で、DDが方言です。例えば、en-ZA は、南アフリカで使われている英語を意味します。

デバイス情報

OAID

SDK

デバイス情報

ATT

SDK

ATT、別名 att_status は、iOS 14以降で利用でき、次のいずれかからの値が入力されます：ATTrackingManagerによって返された値、S2Sで送信された値、AppsFlyerが決定した値

ATTの値は、次のいずれかになります：not_determined、restricted、denied、authorized、af_unknown、af_authorizedｍaf_unavailable

デバイス情報

Operator

SDK

デバイス情報

OS version

SDK

デバイス情報

Platform

SDK

端末のプラットフォーム：
iOS / Android / Windows Mobile

Enum型 / String型 - 最大8文字まで

アプリ

SDK version

SDK

デバイス情報

WIFI

SDK

true または false

Enum型 - 5文字 : boolean型

デバイス情報

Store reinstall

SDK

Appleアプリストアは、Apple Search Ads経由のユーザーがAppleユーザーIDを使用して再インストールかどうかを判断します：

• 新規ユーザーの場合：false
• 既存ユーザーの再インストールの場合：true

デバイス情報

Amazon Fire ID

SDK

Amazon端末上のユーザーがリセットできる広告ID。

デバイスの場所

City

AF

端末のIPアドレスに基づいたユーザーの最も詳細な場所。通常、値には都市名が入りますが、より正確な市区町村名が入ることもあります。

String型 - 最大100文字まで

計測

Attributed touch time

AF

ユーザー獲得：計測する広告との接触時刻

リターゲティング：成果を紐づけたエンゲージメント時刻。

Date Time

計測

Attributed touch type

AF

ユーザー獲得：可能な値：Click, impression, TV, pre-installed

リターゲティング: クリック、インプレッション

Enum型 - 最大10文字まで

計測

Contributor [n] partner (n=1-3)

AF

代理店名 / PMD名: 常に小文字に変換されます

String型 - 最大50文字まで

計測

Contributor [n] campaign (n=1-3)

AF

計測

Contributor [n] match type (n=1-3)

AF

計測

Contributor [n] media source (n=1-3)

AF

計測

Contributor [n] touch time (n=1-3)

AF

Date Time

計測

Contributor [n] touch type (n=1-3)

AF

可能な値：click、impression、TV

Enum型 - 最大10文字まで

デバイスの場所

DMA

AF

指定されたマーケット地域または地理的領域。  Nielsen社によって定義されています。 ユーザーの所在地を決定します。. 

イベント

Event revenue USD

Event revenue Preferred

Event revenue XXX

AF

収益額。通貨は、使用するレポートツールにより異なります。

preferred または selectedは、アプリ設定で設定されたアプリ固有の通貨を意味します。

Data Locker: 常に USD

エキスポートページ: 選択された通貨

Pull API選択可能：USDまたは、&currency=preferred を使用して選択した通貨

Push API: 常に、USDと選択通貨を含みます

イベント

Event source

AF

計測

HTTP referrer

AF

計測

Is primary attribution

AF

ユーザー獲得: True

リターゲティング：リエンゲージメント期間中に、元々のメディアソース（リエンゲージ以前）と、リエンゲージメントをもたらしたメディソースを計測します。リエンゲージメント期間内に発生したイベントについては、元々のユーザー獲得メディアソースはFALSE（プライマリアトリビューションではない）となり、リエンゲージメントメディアソースはTRUEとなります。

Enum型 - 最大5文字まで

イベント

Is receipt validated

AF

実装されている場合はTRUE / FALSE / NULL、未実装の場合は空欄です。

Enum型 - 最大5文字まで

計測

Match type

AF

計測メソッドのタイプ。可能な値は次のとおりです：

• SRN
• id_matching
• probabilistic
• deeplink
• preinstall
• gp_referrer (Google Play referrer string)
• サードパーティAndroidアプリストアのリファラ

デバイスの場所

Postal code

AF

デバイスの場所

Region

AF

SDKが報告したデバイスIDアドレスを使用

String型 - 最大100文字まで

計測

Retargeting conversion Type

AF

UA：再インストール

リターゲティング：リエンゲージメント、リアトリビューション

廃止前の通知：この項目は将来廃止予定です。conversion_type と campaign_type を使用して、コンバージョンのコンテキストを決定します。

Enum型 - 最大14文字まで

デバイスの場所

State

AF

SDKが報告したデバイスIDアドレスを使用

String型 - 最大100文字まで

計測

Keyword ID

計測リンク

計測

Keyword match type

AF

キーワードマッチタイプはGoogle AdWordsのみで提供されます。

2021年2月15日以降、この項目はApple Search Adsに関してこの項目は入力されなくなりました。

計測

Network account ID

SRN API のみ

広告主のパートナーに関するアカウントID

String型 - 最大100文字まで

Protect360

Rejected reason value

AF

Protect360：ポストアトリビューションのインストール／アプリ内イベントハイジャックに関する有効なコントリビューター（メディアソース）を示しています。contributor[1-3] または organicのいずれかが入力されます。

Data Lockerでは、validation_reason_value と表示されます。

String型 - 最大100文字まで

Protect360

Rejected reason

Protect360

Blocked reason

Protect360

Blocked sub reason

Protect360: ブロック済みインストールの二次理由。例：Reason: install_hijacking。Sub-reason: referer hijack、CTIT_anomalies、validation_rules

Protect360

Blocked reason value

Protect360

Blocked reason rule

計測

Google Play click time

Google Play field

広告クリック後にGooglePlay内のアプリページが読み込まれた時間

ソース元：Google API

Android SDK v.4.8.5以降に対応

例： install_time を gp_click_time と比較。これにより、アプリダウンロードとユーザーが起動するまでにどれだけの時間が経過したかについて洞察を得ることができます。

計測

Google Play install begin time

Google Play store

インストールの開始時刻
データソース：ユーザーの端末。つまり端末に表示されている時間を意味します。

Android SDK V4.8.5から利用可能

計測

Google Play referrer

Google Play store

インストールされたアプリのリファラURL

Android SDK V4.8.5から利用可能

計測

Google Play broadcast referrer

Google Play store

Google PlayのBroadcast Referrer

広告収益

Ad unit

広告収益API

広告の広告収益タイプ

広告収益

Segment

広告収益API

広告収益

Placement

Ad revenue placement

広告収益

Monetization network

広告収益API

広告を配信する広告収益ネットワーク

広告収益

Impressions

広告収益API

ユーザーが広告を見た広告収益の回数

広告収益

Mediation network

広告収益API

AppsFlyerにイベントを送信する広告収益メディエーションネットワーク

計測

Custom dimension

SDK

AppsFlyerが将来的に利用するために準備してあります

アプリ

App type

App clip

値：app_clip、full_app

Protect360

Fraud reason

AF

Protect360: ブロックされた理由をご覧ください。

Protect360

Fraud sub reason

AF

Protect360: ブロックされたサブ理由を参照してください。

Protect360

Is organic

AF

アプリ内イベントがオーガニックインストールに紐づいているかを示します。

Protect360

Detection date

AF

ポストアトリビューションで不正が検知された日付。

計測

Attribution Touch Hour

ポストバック

最も近い時間に切り捨てられたアトリビューションタッチタイム

計測

Install Hour

ポストバック

最も近い時間に切り捨てられたインストール時刻

計測

Event Hour

ポストバック

最も近い時間に切り捨てられたイベント時刻

計測

Store product page

AF