概要:この記事では、データフィールド(ローデータ項目の仕様)を説明します。この辞書は、フィールドの意味、フォーマット、利用可能なタイミングを理解するために支援します。
概要
ローデータ項目のディクショナリテーブルには、AppsFlyerの各種レポートで利用できるローデータ項目が一覧表示されます。AppsFlyerでローデータ項目が追加されるたびに、テーブルは常に更新されます。
辞書表の列は以下の通りです:
- フィールドグループ: フィールドの利用に基づく論理的なグループ化。注意!広告収益グループのフィールドは、ローデータレポートで独自の列として表示されるか、イベント値の一部として扱われます。
-
名前:
- Data LockerおよびPush APIレポートで表示されるフィールド名。
- [n] という表記は、同じフィールドの複数のインスタンスが存在し、そのインスタンス番号が異なることを意味します。例えば、Sub Param [n] は、Sub Param 1, Subparam 2, ..., Sub Param5を意味します。n 値の範囲は (n=1-5) として表記します。
-
フィールド名:
- データ出力画面およびPull APIから提供されるレポートで使用されるフィールド名。
- [n] という表記は、同じフィールドの複数のインスタンスが存在し、そのインスタンス番号が異なることを意味します。例えば、Sub Param [n] は、Sub Param 1, Subparam 2, ..., Sub Param5を意味します。n 値の範囲は (n=1-5) として表記します。
-
ソース:フィールド内容の元のソースの場所。例えば:
- リンク:計測リンク(AppsFlyerアトリビューション計測リンクの構造とパラメーターを参照)や、関連する場合はSRNからのAPIレスポンス。
- SDK:アプリ内のSDKを通じて収集されます。
- AF:AppsFlyerによって生成されます。
- その他多数
-
説明
- 一部のフィールドは、イベントのコンテキスト、例えばユーザー獲得やリターゲティングキャンペーンの結果に応じて異なる意味を持ちます。
-
フォーマット:フィールドタイプと長さ。
- 文字列:文字列の最大長。長さ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 形式です。CSVファイルをExcelで開くと、日付フィールドはコンピュータの日時設定を使用してフォーマットされます。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
- UTCでのタイムスタンプフィールドの形式:
- 形式が
- 列挙型 n 文字:列挙フィールドには特定の値のみを含めることができます。例えば、コスト通貨は3文字で、指定された通貨コードのみを含めることができます。
-
列挙型 5 文字ブール値:フィールドの値は
TRUEまたはFALSEのいずれかです。
ヒント
- 表を並べ替えるには、列名をクリックします。
- 表をダウンロードすることもできます。
- ダウンロードしたCSVには、上記のフィールドに加えて追加のフィールドが含まれます:
-
AppsFlyerのメインレポートスキーマの一部:
- AppsFlyerレポートは大部分が同じスキーマから構築され、同じフィールドが含まれています。
- レポートや、データがアドネットワーク、広告主、デバイスプラットフォームから収集されたかどうかに応じて、一部のフィールドにはnullまたは空の値が設定されることがあります。
- ビジネスインテリジェンスシステムを設定する際、特定のレポートが常にnullまたは空の値を返す場合でも、すべての主要なAppsFlyerスキーマフィールドを設定することをお勧めします。これにより、データが利用可能になったとき簡単に取り込むことができます。
- フィールドがメインのAppsFlyerレポートスキーマの一部でない場合は、特定のレポートにのみ含まれます。例:SKANレポート
- レポート取得方法:特定のフィールドがPush API、データ出力 / Pull API、およびData Locker経由で利用可能かどうかを示します。注釈:フィールドがメインのAppsFlyerレポートスキーマの一部であっても、特定の方法で取得するレポートの一部ではない場合があります。たとえば、配置フィールドはメインのAppsFlyerスキーマの一部ですが、Data Locker、Pull API、またはデータ出力画面経由で配信されるレポートにのみ表示され、Push API経由では表示されません。
-
AppsFlyerのメインレポートスキーマの一部:
ローデータ項目の手引き
| フィールドグループ | 名前 | フィールド名 | ソース | 説明 | 形式 |
|---|---|---|---|---|---|
| アトリビューション | ad_id | Ad id | リンク | String | |
| アトリビューション | ad_id__assist_1 | AF |
|
String | |
| アトリビューション | ad_name | Ad name | リンク | String | |
| アトリビューション | ad_name__assist_1 | AF |
|
String | |
| SKAN | ad_network_ad_id | Ad ID | アドネットワーク | 広告ID | String |
| SKAN | ad_network_ad_name | Ad name | アドネットワーク | 広告名 | 文字列 |
| SKAN | ad_network_adset_id | Adset ID | アドネットワーク | Adset ID | String |
| SKAN | ad_network_adset_name | Adset name | アドネットワーク | Adset name | String |
| SKAN | ad_network_campaign_id | Campaign ID | アドネットワーク | アドネットワークからAppsFlyerにレポートされたキャンペーンID | String |
| SKAN | ad_network_campaign_name | Campaign | アドネットワーク | アドネットワークからAppsFlyerにレポートされたキャンペーン名 | String |
| SKAN | ad_network_channel | Channel | アドネットワーク | フィールドはレポートに追加されますが、必ず値が入るわけではありません。 | String |
| SKAN | ad_network_creative | Creative | アドネットワーク |
|
文字列 |
| SKAN | ad_network_name | Ad network name | アドネットワーク |
|
文字列 |
| SKAN | ad_network_source_app_id | Ad network source app ID | アドネットワーク | アドネットワークによってレポートされたパブリッシャーアプリID。コストの調整を支援するために使用します - アドネットワークによってレポートされます。パブリッシャーアプリがこのデータの基を提供します。 | String |
| SKAN | ad_network_timestamp | Ad network timestamp | アドネットワーク |
|
タイムスタンプ |
| デバイス情報 | ad_personalization_enabled | Ad personalization enabled | SDK | ユーザーが、Googleによるパーソナライズ広告でのユーザレベルのデータ使用に同意しているか(true)、否か(false)を示します。 | ブール値 |
| アトリビューション | ad_placement | Ad placement | リンク | CTV広告の配置に入力 | 文字列 |
| 広告収益 | ad_revenue_ad_type | Ad revenue ad type | 広告収益SDK | 表示された広告の種類 | 文字列 |
| 広告収益 | ad_revenue_custom_parameters | Ad revenue custom parameters | 広告収益SDK | アプリ内に表示される広告に対して広告主が広告収益SDK経由で提供するカスタムパラメーター。 | 文字列 |
| アトリビューション | 広告タイプ | Ad type | リンク |
|
String |
| 広告収益 | ad_unit | Ad unit | 広告収益API | A/Bテスト実施時の広告収益広告セグメント名 | 文字列 |
| デバイス情報 | ad_user_data_enabled | Ad user data enabled | SDK | ユーザーが、計測およびパーソナライズされた広告にGoogleがユーザーレベルのデータを使用できるようにすることに同意したか(true)、否か(false)を示します。 | ブール値 |
| アトリビューション | adset_id | Adset id | リンク |
|
String |
| アトリビューション | adset_id__assist_1 | AF |
|
String | |
| アトリビューション | adset_name | Adset name | リンク | String | |
| アトリビューション | adset_name__assist_1 | AF |
|
String | |
| デバイス情報 | advertising_id | Advertising ID for Android devices | SDK |
|
String |
| アトリビューション | advertising_id_type | Advertising ID type | リンク | advertising_id_value フィールドに提供される広告IDのタイプを指定します。一般的なタイプには、IDFA(iOS)とGAID(Android)があります。 | String |
| アトリビューション | advertising_id_value | Advertising ID value | リンク |
|
String |
| アトリビューション | af_ad | Ad | リンク | 広告名 | String |
| アトリビューション | af_ad_id | 広告ID | リンク | 広告ID | 文字列/整数 |
| アトリビューション | af_ad_type | Ad type | リンク | 例: バナー、フッター | String |
| アトリビューション | af_adset | Adset | リンク | 広告セット名。1つ以上の広告を含むグループを識別します。 | String |
| アトリビューション | af_adset_id | Adset ID | リンク | 広告セットIDは、1つ以上の広告を含むグループを識別します。 | 文字列 |
| SKAN | af_attribution_flag | AF attribution flag | AF | シングルソースオブトゥルース(SSOT)メカニズムが有効の場合:trueであれば、インストールはAppsFlyerとSKANの両方によって帰属されます。false:インストールはAppsFyer計測でオーガニックとして計測されていることを示します。skad_conversion_valueがnullの場合:フラグはtrueまたはfalseのいずれかになります(推定値 に基づきます)。 | Boolean |
| アトリビューション | af_attribution_lookback | Attribution lookback window | リンク |
|
文字列 |
| アトリビューション | af_c_id | Campaign ID | リンク | Campaign ID | String |
| アプリ内課金 | af_cancelation_date_ms | AppsFlyerの購入検証 | キャンセルの日付 | ||
| アトリビューション | af_channel | Channel | リンク | メディアソースチャネル。例:Googleの例ではYouTube、Meta広告の例ではInstagram。 | 動的列挙文字列 |
| アトリビューション | af_cost_currency | Cost Currency | リンク | ISO-4217に準拠した3文字の通貨コード(USD、EUR)。(デフォルトはUSDです)。 | String |
| アトリビューション | af_cost_model | Cost model | リンク | コストモデルはアトリビューションリンクで報告されます。CPC/CPI/CPM/その他。現在、この値に関係なく、すべてのコストはCPIに基づいて計算されます。 | 文字列 |
| アトリビューション | af_cost_value | Cost value | リンク | コスト通貨の金額。小数点以下4桁まで許可されます。例:320.5095 | String |
| Subscription | af_cuids | CUIDs | AppsFlyerの購入検証 |
|
|
| IAPサブスクリプション | af_discount_id | Discount ID | AppsFlyerの購入検証 | 初回購入時にユーザーに提示されるオファーID。割引コードがある場合にのみIDが提供されます。 | |
| Subscription | af_discount_type | Discount type | AppsFlyerの購入検証 |
ユーザーが利用した割引の種類想定値:
|
|
| アトリビューション | af_engagement_destination | Engagement destination | AF | Webランディングページ、モバイルアプリ(ディープリンクまたはアプリストア経由)、その他の遷移先タイプ(CTV、PC、コンソールなど)など、広告からリンクされる遷移先のカテゴリを示します。 | String |
| IAPサブスクリプション | af_environment | Environment | AppsFlyerの購入検証 | データが受信された環境(本番またはサンドボックス) | |
| Subscription | af_expires_date_ms | Subscription expiration date | 現在のサブスクリプション請求サイクルの有効期限 | ||
| アトリビューション | af_keywords | Keywords | リンク | ユーザーのオンライン検索で使用された単語。アドネットワークの報告によると | String |
| IAPサブスクリプション | af_net_revenue | Net revenue | True Revenue API | すべての要因を考慮して計算された純収益。af_net_revenue_factorsを参照してください。 | |
| IAPサブスクリプション | af_net_revenue_country | Net revenue country | True Revenue API |
|
|
| IAPサブスクリプション | af_net_revenue_factors | Net revenue factors | True Revenue API |
|
|
| IAPサブスクリプション | af_net_revenue_postal_code | Net revenue postal code | True Revenue API |
|
|
| IAPサブスクリプション | af_net_revenue_subdivision | Net revenue subdivision | True Revenue API |
|
|
| IAPサブスクリプション | af_net_revenue_tax_exclusive | Net revenue tax exclusive | True Revenue API |
|
|
| IAPサブスクリプション | af_net_revenue_tax_name | Net revenue tax name | True Revenue API |
|
|
| IAPサブスクリプション | af_net_revenue_tax_rate | Net revenue tax rate | True Revenue API |
|
|
| IAPサブスクリプション | af_offer_id | Offer ID | AppsFlyerの購入検証 | 割引価格やプロモーション価格など、関連する取引に適用されるオファーID。 | String |
| IAPサブスクリプション | af_original_transaction_id | Original transaction ID | AppsFlyerの購入検証 |
|
|
| Subscription | af_period_type | Subscription period type | AppsFlyerの購入検証 |
|
|
| IAPサブスクリプション | af_product_id | Product ID | AppsFlyerの購入検証 | サブスクリプションプロダクトID | |
| アトリビューション | af_prt | Partner | リンク | 代理店識別子。SKANの場合、入力されない可能性があります | String |
| IAPサブスクリプション | af_purchase_date_ms | Purchase date | AppsFlyerの購入検証 | レポートされたプロダクトIDのアプリ内イベントの購入日 | |
| アプリ内課金 | af_purchase_option_id | Purchase option ID | AppsFlyerの購入検証 | トランザクションに関連付けられた購入オプションID。 | String |
| アプリ内課金 | af_purchase_option_type | Purchase option type | AppsFlyerの購入検証 | 取引の購入オプションタイプ。設定可能な値 (Android): buy, rent | String |
| アプリ内課金 | af_purchase_state | Purchase state | AppsFlyerの購入検証 |
想定される値:
|
|
| IAPサブスクリプション | af_purchase_token | Purchase token | AppsFlyerの購入検証 |
|
|
| IAPサブスクリプション | af_reason | Reason | AppsFlyerの購入検証 |
キャンセルまたは解約関連のイベントで、ユーザーが解約またはキャンセルした理由。想定される値:
|
|
| アトリビューション | af_reengagement_window | Reengagement window | リンク |
|
String |
| IAPサブスクリプション | af_refunded_transaction_ids | Refund ransaction ID | AppsFlyerの購入検証 |
|
|
| アトリビューション | af_siteid | Site ID | リンク | 媒体ID | String |
| IAPサブスクリプション | af_store | Store | AppsFlyerの購入検証 | サブスクリプション製品を購入したアプリストア | |
| アトリビューション | af_sub[n] (n=1-5) | Sub param [n] | リンク | 広告主によってアトリビューションリンクに設定されたパラメータ | 文字列 |
| アトリビューション | af_sub_siteid | Subsite ID | リンク | サブパブリッシャーID | 文字列 |
| Subscription | af_subscription_ownership_type | Subscription ownership type | AppsFlyerの購入検証 | FAMILY_SHARED は、ユーザーがファミリー共有でアクセスできることを意味します。PURCHASED:有料ユーザーが購入を行ったことを意味します。 | |
| IAPサブスクリプション | af_transaction_id | Transaction ID | AppsFlyerの購入検証 |
|
|
| アトリビューション | agency | Agency | リンク | String | |
| アトリビューション | agency__assist_1 | AF |
|
String | |
| デバイス情報 | amazon_aid | Amazon Fire ID | SDK | Amazonデバイス上のユーザーがリセット可能な広告ID。 | String |
| デバイス情報 | android_id | Android ID | SDK | 永続的デバイスID | 文字列 |
| アトリビューション | app_group_id | App group ID | AF | クロスプラットフォーム計測用のOneLinkテンプレートに属する関連アプリ | 文字列 |
| アプリ | app_id | App ID | SDK |
AppsFlyer内の一意のアプリ識別子。例:
|
String |
| アプリ | app_name | App name | SDK | 広告主が設定 | 文字列 |
| アトリビューション | app_store_id | App store ID | AF | アプリストアに表示されるアプリID | 文字列 |
| アプリ | app_type | App type | アプリクリップ | 値: app_clip、full_app | 文字列 |
| アプリ | app_version | App version | SDK | 広告主が設定 | 文字 |
| デバイス情報 | appsflyer_id | AppsFlyer ID | SDK |
|
String |
| デバイス情報 | appsflyer_id_type | AppsFlyer ID Type | SDK |
|
String |
| デバイス情報 | appsflyer_id_value | AppsFlyer ID Value | SDK |
|
String |
| デバイス情報 | att | ATT | SDK |
|
文字列 |
| アトリビューション | attributed_touch _time | Attributed touch time | AF |
|
日付と時間 |
| アトリビューション | attributed_touch_type | Attributed touch type | AF |
エンゲージメントを分類します。エンゲージメントがインストールと一致した後、AppsFlyerによって設定されます。
|
列挙型 |
| Protect360 | blocked_reason | Blocked reason | AF | Protect360:インストールがブロックされる理由。例: install_hijacking、ボット | 文字列 |
| Protect360 | blocked_reason_rule | Blocked reason rule (非推奨) | AF | 非推奨 | 文字列 |
| Protect360 | blocked_reason_value | Blocked reason value | AF | Protect360:ブロックに関する追加情報。例:サイトID、検証ルール名 | 文字列 |
| Protect360 | blocked_sub_reason | Blocked sub reason | AF | Protect360:インストールがブロックされる特定のサブ理由。例:理由: install_hijacking。サブ理由: リファラハイジャック、CTIT_anomalies、validation_rules | 文字列 |
| アプリ | bundle_id | Bundle ID | SDK |
|
String |
| アトリビューション | campaign | Campaign | リンク | キャンペーン名 | String |
| アトリビューション | campaign_id | Campaign id | リンク | String | |
| アトリビューション | campaign_id__assist_1 | AF |
|
String | |
| アトリビューション | campaign_name | Campaign name | リンク | String | |
| アトリビューション | campaign_name__assist_1 | AF |
|
String | |
| アトリビューション | campaign_type | Campaign type | AF |
ユーザーを引き付けるソース:
(1)メディアソースに紐付けられていないアプリ内イベント/セッション。もしくは、プライバシーポリシーまたはGDPRのリクエストによりデータを削除します。 |
String |
| アトリビューション | campaign_type | Campaign type | キャンペーンがユーザー獲得、リターゲティング、その他のタイプのいずれかであるかを指定します。 | String | |
| アトリビューション | campaign_type__assist_3 | AF |
|
String | |
| デバイス情報 | carrier | Carrier | SDK | Androidが提供するキャリア名は getSimCarrierIdName() を使用しています。キャリアマッピングも参照。 | String |
| アトリビューション | channel | Channel | リンク |
|
String |
| アトリビューション | channel__assist_1 | AF |
|
String | |
| デバイスの位置情報 | city | City | AF | デバイスIPに基づくユーザーの最も粒度の細かい場所。通常、価値には都市名が含まれますが、より正確な地区や自治区の場合もあります。 | String |
| 端末ロケーション | continent | Continent | AF |
|
String |
| アトリビューション | contributor[n]_af_prt(n=1-3) | Contributor[n] partner | AF | 代理店またはPMD - 常に小文字に変換されます | 文字列 |
| アトリビューション | contributor[n]_campaign(n=1-3) | Contributor[n] campaign | AF | コントリビューターキャンペーン | 文字列 |
| アトリビューション | contributor[n]_engagement_type (n=1-3) | Contributor[n] engagement type | AF | 可能な値: preload、click_to_download、click_to_app、engaged_click、engaged_view、view、listening、click_unspecified、 impression_unspecified | 列挙型 |
| アトリビューション | contributor[n]_match_type(n=1-3) | Contributor[n] match type | AF | 可能な価値は一致タイプと同じです。 | 文字列 |
| アトリビューション | Contributor [n] media source (n=1-3) | Contributor[n] media source | AF | コントリビューターのメディアソース | 文字列 |
| アトリビューション | contributor[n]_touch_time(n=1-3) | Contributor[n] touch time | AF | コントリビューターの広告接触時刻 | 日時 |
| アトリビューション | contributor[n]_touch_type(n=1-3) | Contributor[n] touch type | AF | 可能な値: クリック、インプレッション | 列挙型 |
| アトリビューション | contributor_[n]_engagement_type | Contributor[n] engagement type | AF | コントリビューターのエンゲージメントタイプ | 列挙型 |
| アトリビューション | conversion_name | Conversion Name | AF |
|
String |
| アトリビューション | conversion_type | Conversion type | AF |
コンバージョンの種類:
(1) conversion_type=再インストール かつ campaign_type=リターゲティングは、retargeting_conversion_type=re-attribution と同等です。 (2) メディアソースに帰属しないアプリ内イベント/セッション。 |
String |
| アトリビューション | cost_currency | Cost Currency | リンク |
|
String |
| アトリビューション | cost_model | Cost model | リンク |
|
String |
| アトリビューション | cost_value | Cost value | リンク |
|
金額 |
| デバイスの位置情報 | country_code | Country code | AF |
|
列挙型 |
| 金額関連 | currency_customer | Currency Customer | N/A |
|
String |
| アトリビューション | custom_data | Custom data | SDK | 広告主がSDKまたはS2Sで設定したデータは、サードパーティやオーディエンスとの連携に最もよく利用されます。AndroidおよびiOSを参照してください。 | 文字列 |
| アトリビューション | custom_dimension | Custom dimension | SDK | AppsFlyerの将来の使用のために予約済み | String |
| デバイス情報 | customer_user_id | Customer user ID | SDK |
|
String |
| デバイス情報 | 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 | 報告されたユーザーエージェント |
使用されるデバイスタイプ: タブレット、携帯電話、デスクトップ、テレビ、セットトップボックス、ゲームコンソール、メディアプレイヤー、不明なデバイスカテゴリー。
|
文字列 |
| デバイス情報 | 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などです。 | 列挙型 |
| デバイス情報 | device_model | Device model | SDK | デバイスの商用モデル名。例: xiaomi::RedmiまたはiPhone7 | 文字列 |
| デバイス情報 | device_type | Device Type | SDK |
|
文字列 |
| SKAN | did_win | iOS |
|
Boolean | |
| デバイスの位置情報 | dma | DMA | AF | 指定市場エリアまたは地理的エリア。ニールセン企業によって定義されます。ユーザーの位置を特定する。 | String |
| 顧客生涯価値イベント | end_user_event_type | End User Event Type | N/A |
|
列挙型 |
| アトリビューション | engagement_destination | Engagement Destination | AF | 広告からリンクされる遷移先のカテゴリを示します。これは、Webランディングページ、ディープリンクまたはアプリストアページを介して到達したモバイルアプリ、またはCTV、PC、コンソールなどの他のデスティネーションタイプです。 | |
| アトリビューション | engagement_subtype | Engagement Subtype | AF |
|
String |
| アトリビューション | engagement_subtype__assist_1 | AF |
|
String | |
| アトリビューション | engagement_type | Engagement type | AF | 可能な値: preload、click_to_download、click_to_app、engaged_click、engaged_view、view、listening、click_unspecified、 impression_unspecified | String |
| アトリビューション | engagement_type__assist_1 | AF |
|
String | |
| イベント | event_name | Event name | AF/SDK |
|
文字列 |
| イベント | event_revenue | Event revenue | SDK |
|
文字列 |
| SKAN | event_revenue | Event revenue | AF | 計算式: [特定のイベントの価値の合計(USD)] / [特定の日に発生したイベントの数] | Float |
| イベント | event_revenue_currency | Event revenue currency | SDK | SDKに報告されるイベント収益通貨コード。 | 文字列 |
| イベント | event_revenue_usd* | Event revenue USD | AF |
|
文字列 |
| イベント | event_revenue_xxx | Event revenue selected currency |
|
文字列 | |
| アトリビューション | event_source | Event source | AF | SDKまたはS2Sのいずれか | 列挙型 |
| イベント | event_time | Event time | ポストバック | イベント時間は最も近い時間に切り捨てられます | 日時 |
| イベント | event_time | Event time | SDK | イベントが発生した時間 | 日時 |
| イベント | event_time__assist_1 | AF |
|
TIMESTAMP | |
| イベント | event_time__attribution | AF |
|
TIMESTAMP | |
| 時間 | event_time__conversion | N/A |
|
日時 | |
| イベント | event_type | Event type | AF/SDK | アトリビューション イベントの種類。アトリビューションイベントタイプの例: インストール、リエンゲージメントなど。 | 文字列 |
| PBAイベント | event_url | Event URL | Web SDK | イベントが発生したウェブページのURL (元のURLはウェブサイト訪問時と同じ) | String |
| SKAN | event_uuid | AF | 重複ポストバックを識別するためのユニークなランダム識別子 | String | |
| イベント | event_value | Event value | SDK | SDKから送信された詳細なイベント内容。注記:1000文字を超えないように送信してください。切り捨てられる可能性があります。 | 文字列 |
| SKAN | event_value | Event value | S2S |
|
文字列 (JSON) |
| SKAN | fidelity_type | Fidelity type |
|
整数型(Integer) | |
| Protect360 | fraud_reason | Fraud reason | AF | Protect360:ブロックされた理由を参照してください。 | 文字列 |
| Protect360 | fraud_sub_reason | Fraud sub reason | AF | Protect360:ブロックされたサブ理由を参照してください。 | 文字列 |
| デバイス情報 | gdpr_applies | GDPR applies | SDK | ユーザがDMA管轄に該当するか(true)、否か(false)を示します。 | ブール値 |
| アトリビューション | gp_broadcast_referrer | Google Play broadcast referrer | Google Playストア | Google Play ブロードキャストリファラー | 文字列 |
| アトリビューション | gp_click_time | Google Play click time | Google Play フィールド |
|
タイムスタンプ |
| アトリビューション | gp_install_begin | Google Play install begin time | Google Playストア |
|
タイムスタンプ |
| アトリビューション | gp_referrer | Google Play referrer | Google Playストア |
|
文字列 |
| アトリビューション | hardware_id_type | Hardware id type | hardware_id_value で指定されたハードウェア識別子のタイプを示します。 | String | |
| アトリビューション | hardware_id_value | Hardware id value |
ユーザーがリセットできないデバイスレベルの一意の識別子(例:Android ID、IMEI)。値は、hardware_id_type フィールドで指定されたタイプに対応します。
|
String | |
| アトリビューション | http_referrer | HTTP referrer | AF | AppsFlyerクリックURLにリンクされたウェブページのアドレスを識別します。リファラーを確認することで、リクエストの発信元を確認できます。 | 文字列 |
| デバイス情報 | idfa | IDFA | SDK | iOSデバイスでユーザーがリセット可能な広告IDが見つかりました。IDFAが利用できない場合は、通常はゼロが入力されます。 | 文字列 |
| デバイス情報 | idfv | IDFV | SDK | iOSが提供するベンダーID | 文字列 |
| デバイス情報 | imei | IMEI | SDK | 永続的デバイスID | 文字列 |
| 広告収益 | impressions | Impressions | 広告収益API | ユーザーが広告を見た回数 | 文字列 |
| アトリビューション | install_app_store | Install App Store | SDK | アプリがダウンロードされたAndroidストア(詳細) | String |
| SKAN | install_date | Install date | iOS | ポストバック到着時刻をもとにAppsFlyerが推定します。 | 時間文字列(Time String) |
| アトリビューション | install_time | Install time | ポストバック |
|
日時 |
| SKAN | install_type | Install type | iOS | 新規インストール | 文字列 |
| SKAN | interval | Interval | AF | アクティビティ期間の間隔。 | 整数 |
| デバイスの位置情報 | ip | IP | AF | IPV4またはIPV6のIPアドレス。AppsFlyerはIPアドレスを使用してユーザーの所在地を特定します。必要に応じて、広告主はレポートとポストバックから、IPアドレスをマスクすることができます。 | String |
| アトリビューション | ip_address_type | Ip address type | ip_address_value 項目で指定された IP アドレスのフォーマットを指定します(例:IPv4、IPv6)。 | String | |
| アトリビューション | ip_address_value | Ip address value | AF | String | |
| デバイス情報 | is_lat | Limit ad tracking | SDK |
追跡型広告の制限(LAT):
|
列挙型ブール値 |
| Protect360 | is_organic | Is organic | AF | アプリ内イベントがオーガニックインストールに関連付けられているかを示します。 | 文字列 |
| アトリビューション | is_primary_attribution | Is primary attribution | AF | UA:TRUE リターゲティング:リエンゲージメント期間中は、元のメディアソース(リエンゲージメント前)と、リエンゲージメントメディアソースの両方にアトリビューションします。イベントがリエンゲージメント期間内にある場合。元のメディアソースはFALSE(プライマリアトリビューションではない)になります。リエンゲージメントメディアソースはTRUEになります。詳細はこちら |
列挙型 |
| イベント | is_receipt_validated | Is receipt validated | AF | SDKに実装されている場合はTRUE\/FALSE\/NULL、それ以外の場合は空 | 列挙型 |
| アトリビューション | is_retargeting | Is retargeting | リンク |
|
列挙型ブール値 |
| Protect360 | is_tagged | AppsFlyer | 検知がタグ付けされたかどうかを示します。 | String | |
| アトリビューション | keyword_id | Keyword ID | リンク | アドネットワークから返されたキーワードID。これはaf_keywordのIDです。 | 文字列 |
| アトリビューション | keyword_match_type | Keyword match type | AF |
|
文字列 |
| アトリビューション | keywords | Keywords | リンク |
|
String |
| アトリビューション | keywords_id | リンク |
|
String | |
| デバイス情報 | language | Language | SDK | 端末OSによって設定された、端末から取得した 言語設定(+地域情報)。.通常、形式はll-DDです。ここで、llは言語、DDは方言です。例えば、en-ZA は、南アフリカで使われている英語を意味します。 | String |
| アトリビューション | match_type | Match type | AF |
計測方法のタイプ。可能な値は次の通りです:
|
String |
| SKAN | max_event_counter | Max event counter | AF | ユーザーが特定のアプリ内イベントを実行した回数を決定するために次の式を使用します: [(min_event_counter + max_event_counter) / 2 を切り上げ]。注記!最も近い整数に切り上げてください。 例: A. min = 0 で max = 1 の場合:平均は 0.5 です。切り上げると結果は 1 です。 B. min = 5 で max = 10 の場合、平均は 7.5 として切り上げると結果は 8 になります。 |
整数 |
| SKAN | max_revenue | Max revenue | AF | 収益は常に skad_revenue フィールドで提供されます。SKAN 4 またはカスタムモードを使用する場合、イベントに関連付けられたバケット範囲は、min_revenue と max_revenue によって記述され、skad_revenue の計算に用いられます。 | 実数 |
| SKAN | max_time_post_install | Max time post-install | AF |
|
整数型(Integer) |
| SKAN | measurement_window | SKAN measurement window | AF | アクティビティ期間の長さ。デフォルト:24時間 | 整数型(Integer) |
| PBA アトリビューション | media_channel | Media channel | Web SDK | ウェブサイト訪問に帰属したメディアチャネル | 文字列 |
| アトリビューション | media_source | Media source | リンク | イベントが紐づけられたメディアソース名、もしくはrestricted | String |
| アトリビューション | media_source__assist_1 | AF |
|
String | |
| アトリビューション | media_type | Media type | AF |
リンクを含む広告の配置は次の通りです。
|
文字列 |
| 広告収益 | mediation_network | Mediation Network | 広告収益API | 広告収益のメディエーションネットワークがAppsFlyerにイベントをレポーティング | 文字列 |
| SKAN | min_event_counter | Min event count | AF | イベントをユーザーが実行した回数を計算するために使用する。ユーザーが特定のアプリ内イベントを実行した回数を判断するために、次の数式を使用する: [round up (min_event_counter + max_event_counter) / 2] 。注記!最も近い整数に切り上げてください。 例: A. min = 0 で max = 1 の場合:平均は 0.5 です。切り上げると結果は 1 です。 B. min = 5 で max = 10 の場合、平均は 7.5 として切り上げると結果は 8 になります。 |
整数 |
| SKAN | min_revenue | Min revenue | AF | 収益は常に skad_revenue フィールドで提供されます。SKAN 4 またはカスタムモードを使用する場合、イベントに関連付けられたバケット範囲は、min_revenue と max_revenue によって記述され、skad_revenue の計算に用いられます。 | 実数 |
| SKAN | min_time_post_install | Min time post-install | AF |
|
整数 |
| 広告収益 | monetization_network | Monetization network | 広告収益API | 広告を送信するアドネットワーク | String |
| アトリビューション | network_account_id | Network account ID | リンク | アドネットワークの広告主アカウントID | 文字列 |
| デバイス情報 | oaid | OAID | SDK | 一部のAndroidデバイスでユーザーがリセット可能なIDで、通常GAIDの代替として使用されます。 | 文字列 |
| デバイス情報 | operator | Operator | SDK | SIM MCCMNCから派生したモバイルオペレーター名。ユーザーがAndroidのgetNetworkOperatorName()を使用したネットワークに登録している場合に利用できます。 | String |
| アトリビューション | original_url | Original URL | リンク |
|
文字列(URL) |
| デバイス情報 | os_version | OS version | SDK | デバイスのOSバージョン | String |
| 広告収益 | placement | Placement | 広告収益API | アプリ内で広告が表示される場所 | 文字列 |
| デバイス情報 | platform | Platform | SDK | デバイスプラットフォーム:Android、ios、Windowsphone、Smartcast、tizen、roku、webos、vidaa、playstation、xbox、switch、Steam、Epic、Nativepc、quest | 列挙型 |
| アプリ | platform_group | Platform Group | AF |
|
String |
| デバイス情報 | platform_user_id_type | SDK |
|
String | |
| デバイス情報 | platform_user_id_value | SDK |
|
String | |
| デバイスの位置情報 | postal_code | Postal code | AF | SDKが報告したデバイスのIPアドレスを使用します。SKANの場合、2021年8月30日以降は常にnull | String |
| プロダクトライン | product_line_id | Product Line ID | N/A |
|
String |
| プロダクトライン | product_line_name | Product Line Name | N/A |
|
String |
| PBA | query_params | Query params | リンク |
リダイレクトURLのクエリパラメータ(? の後) URLにクエリパラメータがない場合、値はnullです。 |
文字列 |
| デバイス情報 | raw_consent_data | Raw consent data | SDK | 広告主からAppsFlyerに送信された完全な未処理の同意 DMA データを持つJSON オブジェクトを返します。 | String |
| デバイスの位置情報 | region | Region | AF | SDKが報告したデバイスのIPアドレスを使用します。SKANでは、country_codeに基づいて決定されます | 文字列 |
| Protect360 | rejected_reason | Rejected reason | AF | Protect360:廃止予定。現在はブロックされた理由が含まれています。 | 文字列 |
| Protect360 | rejected_reason_valuein data locker: validation_reason_value | Rejected reason value | AF |
|
文字列 |
| アトリビューション | retargeting_conversion_type | Retargeting conversion type | AF |
|
列挙型 |
| 金額関連 | revenue_usd | Revenue USD | N/A |
|
数値 |
| 金額関連 | revenue_value_customer | Revenue Value Customer | N/A |
|
数値 |
| アプリ | sdk_version | SDK version | SDK | AppsFlyer SDKバージョン | 文字列 |
| 広告収益 | segment | Segment | 広告収益API | 広告収益セグメント名 | 文字列 |
| アトリビューション | site_id | Site id | リンク | String | |
| アトリビューション | site_id__assist_1 | AF |
|
String | |
| SKAN | skad_ad_network_id | Ad network ID | iOS | ポストバックが送信されたアドネットワークのID | 文字列 |
| SKAN | skad_ambiguous _event | Ambiguous event | AF | true の場合、広告主が管理画面で SKAN の設定を変更してから最初の 72 時間以内にiOSポストバックが受信されました。 SKANが採用しているさまざまなタイマーのため、AppsFlyerはイベントを正確にマッピングできません。 |
Boolean |
| SKAN | skad_app_id | App ID | iOS | アプリID | String |
| SKAN | skad_attribution_signature | Attribution signature | iOS | アドネットワークによってSKANポストバックに追加された署名 | String |
| SKAN | skad_campaign_id | Campaign ID | iOS | 広告を掲載するために使用されるキャンペーンID。範囲 0~100 | 整数型(Integer) |
| SKAN | skad_coarse_conversion_value | Coarse conversion value | iOS |
|
文字列 |
| SKAN | skad_conversion_value | Conversion value | iOS |
|
整数型(Integer) |
| SKAN | skad_did_win | Did win | iOS |
|
ブール値 |
| SKAN | skad_fidelity_type | Fidelity type | iOS |
|
整数型(Integer) |
| SKAN | skad_mode | SKAN mode | AF |
iOSポストバックをデコードするために使用されるコンバージョン計測モード。含まれる値:
|
文字列 |
| SKAN | skad_postback_sequence_index | Postback sequence index | iOS |
|
整数型(Integer) |
| SKAN | skad_redownload | Redownload | iOS | trueの場合:アプリは再ダウンロードであることを指します。 | Boolean |
| SKAN | skad_revenue | Revenue | iOS | イベント収益額(USD) | Float型(Float) |
| SKAN | skad_source_app_id | Source app ID | iOS |
|
文字列 |
| SKAN | skad_source_domain | Source domain | iOS |
|
文字列 |
| SKAN | skad_source_identifier | Source identifier | iOS |
|
String |
| SKAN | skad_transaction_id | SKAN transaction ID | iOS | Appleから付与されたポストバックID | 文字列 |
| SKAN | skad_version | SKAN transaction ID | iOS | SKAN transaction ID | 文字列 |
| SKAN | source_app_id | AF | サイトID。広告が配信されたアプリのID。skad_source_app_idと同様。 | String | |
| デバイスの位置情報 | state | State | AF | SDKに報告されたデバイスのIPアドレスを使用します。 | String |
| IAPサブスクリプション | store_commission | Store commission | True Revenue API |
|
|
| アトリビューション | store_product_page | Store product page | AF | ユーザーがリダイレクトされたAndroidまたはAppleアプリストア(iOS 15+)のカスタム商品ページ。 | String |
| アトリビューション | store_product_page_id | リンク |
|
String | |
| デバイス情報 | store_reinstall | Store reinstall | SDK |
|
列挙型ブール値 |
| アトリビューション | sub_param_1 | リンク |
|
String | |
| アトリビューション | sub_site_id | Sub site id | リンク |
|
String |
| Protect360 | tagged_additional_data | AF | タグ付きタイプごとに関連するデータが入力される動的フィールド。例:タグ付けされた理由が「new release」の場合、関連するリリースパッケージのパッケージ番号が反映されます。 | String | |
| Protect360 | tagged_type | AF | 検知フラグを立てたタグの種類を表します。タグ付けタイプの例:新規リリース、アプリ評価など | String | |
| Protect360 | tagged_validation_reason_value | AF | 検知が実装モードかつリアルタイムの場合に、アトリビューションを受け取る正当なコントリビューターを記載します。 | String | |
| SKAN | timestamp | Timestamp | アドネットワーク | ポストバックがAppsFlyerに到達した時間 Google広告とMeta広告の場合、これはそれぞれのAPIからAppsFlyerがデータを取得する時間です。 |
Timestamp |
| アトリビューション | total_candidates | Total Candidates |
AF |
コンバージョン時に特定のデバイスで評価されたエンゲージメント(クリック、インプレッション、その他のエンゲージメントタイプ)の総数を表します。
|
String |
| アトリビューション | unified_app_id | Unified app id | SDK | String | |
| デバイス情報 | user_agent | User Agent | リンク | URLまたはデバイスのユーザーエージェント | String |
| アトリビューション | vendor_id_type | Vendor id type | ベンダーIDのタイプ(例:iOSのIDFV) | String | |
| アトリビューション | vendor_id_value | Vendor id value | SDK | String | |
| PBA - イベント | web_event_type | Web event type | Web SDK | Webイベントの種類(訪問、イベントなど) | 文字列 |
| デバイス情報 | Wi-Fi | WIFI | SDK | TRUE または FALSE に設定 | 列挙型ブール値 |