Schema 数据结构
  • 14 Sep 2023
  • 10 阅读时间
  • 黑暗模式
    白天模式

Schema 数据结构

  • 黑暗模式
    白天模式

Article Summary

DataVault Schema 和 Tables

Tenjin 的 DataVault schema 是其功能的核心。来自不同地方的所有信息都可以通过id很好地结合在一起。通过以这种方式组织信息,DataVault 可以轻松地构建准确的模型和分析。


Tables 数据表

详细信息

字段清单

详细信息

(S): Sort Key 排序键

(D): Dist Key 分配键

Column 列Description 描述Example value 例值
created_at (S)创建事件的时间戳2018-07-01 00:00:00
advertising_idiOS 的 IDFA 或 Android 的 Google Advertising ID。小写,不带连字符。29eeb1610fe74997b6d53f02e9711f8c
bundle_id应用的包名 bundle ID(我们会将包名转化为小写)com.tenjin.wordfinder
platform应用发布的平台ios or anroid
os_version设备的操作系统版本8.0
app_version应用版本1.0.3
limit_ad_tracking用户限制广告跟踪 (0 否,1 是)1
app_idTenjin 的内部应用 id。可以与 apps 应用表中的id字段进行连接ee270433-b7da-4e0f-9b03-8dd25d89da49
event_type事件类型为“事件”或“购买”event
event当 event_type=event 事件时,该值为 open或自定义事件名称。open
source_campaign_idTenjin 内部的广告计划 id。可以与 campaigns 广告计划表中的 id 进行连接18a0c1d6-02a2-4188-bbc0-0fe38dbcc37e
acquired_at用户获取的时间戳2018-07-01 00:00:00
price付费事件的原始单价1.99
quantity付费事件的采购数2
product_id付费事件的 product 产品 idcom.tenjin.wordfinder.package50
currency付费事件的货币代码USD
country国家代码US
total_revenue付费事件的总收入(美元) 美分350
revenue付费事件的净收入(美元) 美分245
site_id广告计划的发布者ID(对于付费推广广告)Instagram
developer_device_idiOS 的 IDFV。Android 则为空。小写,不带连字符。b6bc48fe0ce949e4b229ce6c55663fca
purchase_state
  • 0: Unknowable 未知-购买时未收到收据
  • 1: Unverified 未验证-提供了收据,但无法验证
  • 2: Fraudulent 欺诈-提供了假的收据
  • 3: Verified 已验证-收据已成功验证
  • 4: Sandbox 沙盒-收据已在测试沙盒中验证
  • 5: Duplicate 重复 重复-收据已与先前的付费事件一起收到
3
value自定义事件值1
uuid唯一事件 IDa3e3e535-a32c-4887-9c91-3160c91b3876
device设备类型iPad2,5
creative_name素材名称test_creative
ip_address用户 IP 地址71.165.85.114
source_uuid对于付费推广广告,则为点击或展示事件的 UUID。它可以与ad_engagements 表中与“uuid”相连接0df8ccda-372b-4e9e-8fdc-dfa0eb0c333e
loaded_at该条记录被上传到 Data Vault 数据仓库时的时间戳2018-07-01 00:00:00
tracking_statusiOS 设备的 (整数)ATT 状态. 0 => not determined 未确定, 1 => restricted 限制, 2 => denied 拒绝, 3 => authorized 批准3
analytics_installation_id当 Android 设备用户不同意共享其 Google advertising 广告 id 时,用于分析安装的特定标识符。(iOS为空。)小写,无连字符。f024e65f3dd94f16983726bcef192d68
{{customer_user_id}}应用中的 User ID 参数,由 as set by setCustomerUserId SDK methodjdabGcerT32_d
Column 列Description 描述Example value 例值
id广告计划的唯一 ID3b70e477-c151-4167-9174-cca6ffa2c7bc
name广告计划的名称test @bYkiNAbrAOCpzETWviMILo
ad_network_id广告计划归因的广告平台的 id。可以与 ad_networks 广告平台表中的“id”相连接3
app_idTenjin 内部的应用 id。可以和 apps 应用表中的id 相连接ee270433-b7da-4e0f-9b03-8dd25d89da49
remote_campaign_id广告平台使用的 campaign_id 广告计划 ID,通过广告平台的 reporting 报告 API 获得6026825090762
campaign_bucket_id广告计划组中的广告计划组 id。可以与 campaign_buckets 广告计划组表中的 id 字段相连接fbbc74bd-8a73-472a-86f7-5e2a4642a201
updated_at在 Tenjin 的数据库中更新记录的时间戳2018-07-01 00:00:00
loaded_at在 Tenjin 的数据库中上传记录的时间戳2018-07-01 00:00:00
Column 列Description 描述Example value 例值
id广告计划组的唯一 ID3b70e477-c151-4167-9174-cca6ffa2c7bc
name广告计划组的名称test @bYkiNAbrAOCpzETWviMILo
ad_network_id广告系列对应的广告平台的 ID。可以与 ad_networks 广告计划表中的id 字段相连接5
app_idTenjin 内部的应用 id。可以与 apps 应用表中的 id 相连接ee270433-b7da-4e0f-9b03-8dd25d89da49
updated_at在 Tenjin 的数据库中更新记录的时间戳2018-07-01 00:00:00
loaded_at在 Tenjin 的数据库中上传记录的时间戳2018-07-01 00:00:00
Column 列Description 描述Example value 例值
id (S)广告平台的唯一 ID3
name广告平台的名称Facebook
updated_at在 Tenjin 的数据库中更新记录的时间戳2018-07-01 00:00:00
Column 列Description 描述Example value 例值
id应用的唯一 IDee270433-b7da-4e0f-9b03-8dd25d89da49
name应用的名称Word Search
store_id应用的商店 ID887212194
bundle_id应用的包名com.tenjin.wordfinder
updated_at在 Tenjin 的数据库中更新记录的时间戳2018-07-01 00:00:00
loaded_at在 Tenjin 的数据库中上传记录的时间戳2018-07-01 00:00:00
Column 列Description 描述Example value 例值
id广告支出数据的唯一 ID174491158
date (S)这笔花费发生的日期2018-07-01
country这笔广告支出是产生在哪个国家US
campaign_id (D)广告计划的 ID。可以与 campaigns 广告计划表中的id 字段相连接b1d67331-204b-4ee3-9cac-7c0f0f33b5bf
spend美元形式的广告支出金额(单位美分)400
installs报告安装数8
clicks报告点击数10
impressions报告展示数126
original_spend原货币形式下的广告支出金额4
original_currency原货币形式USD
updated_at在 Tenjin 的数据库中更新记录的时间戳2018-07-01 00:00:00
loaded_at在 Tenjin 的数据库中上传记录的时间戳2018-07-01 00:00:00
Column 列Description 描述Example value 例值
id开发者应用的唯一 IDb71ff0ab-f1b4-4ca6-98fc-0064a5b9d1d7
ad_network_id广告计划归因的广告平台的 id。可以与 ad_networks 广告平台表中的“id”相连接1
app_idTenjin 内部的应用 id。可以和 apps 应用表中的 id 字段相连接ee270433-b7da-4e0f-9b03-8dd25d89da49
name开发者广告计划的名称Word Search! Free-ios-Tapjoy
updated_at在 Tenjin 的数据库中更新记录的时间戳2018-07-01 00:00:00
loaded_at在 Tenjin 的数据库中上传记录的时间戳2018-07-01 00:00:00
Column 列Description 描述Example value 例值
id广告变现收入的唯一 ID107852371
date (S)这笔广告变现收入发生的日期2018-07-01
publisher_app_id (D)ID for the publisher campaign. This can be joined with id in the publisher_apps tableb71ff0ab-f1b4-4ca6-98fc-0064a5b9d1d7
country该项指标对应的国家US
revenue美元形式的广告收入金额(单位美分)20000
conversions报告转化数8
clicks报告点击数10
impressions报告展示数126
interstitial_revenue美元形式的插播广告的广告收入(单位美分)20000
interstitial_conversions插播广告的报告转化数8
interstitial_clicks插播广告的报告点击数10
interstitial_impressions插播广告的报告展示数126
banner_revenue美元形式的横幅广告的广告收入(单位美分)20000
banner_conversions横幅广告的报告转化数8
banner_clicks横幅广告的报告点击数10
banner_impressions横幅广告的报告展示数126
native_revenue美元形式的原生广告的广告收入(单位美分)20000
native_conversions原生广告的报告转化数8
native_clicks原生广告的报告点击数10
native_impressions原生广告的报告展示数126
offerwall_revenue美元形式的积分墙广告的广告收入(单位美分)20000
offerwall_conversions积分墙广告的报告转化数8
offerwall_clicks积分墙广告的报告点击数10
offerwall_impressions积分墙广告的报告展示数126
video_revenue美元形式的视频广告的广告收入(单位美分)20000
video_conversions视频广告的报告转化数8
video_clicks视频广告的报告点击数10
video_impressions视频广告的报告展示数126
other_revenue美元形式的其它广告的广告收入(单位美分)20000
other_conversions其它广告的报告转化数8
other_clicks其它广告的报告点击数10
other_impressions其它广告的报告展示数126
updated_at在 Tenjin 的数据库中更新记录的时间戳2018-07-01 00:00:00
loaded_at在 Tenjin 的数据库中上传记录的时间戳2018-07-01 00:00:00
Column 列Description 描述Example value 例值
created_at (S)创建事件的时间戳2018-07-01 00:00:00
advertising_idiOS 的 IDFA 或 Android 的 Google advertising ID。小写,不带连字符29eeb1610fe74997b6d53f02e9711f8c
attributable点击/展示是否被用于归因 true(是) 或者 false(否)true
event_typeclicks(点击) 或者 impressions(展示)clicks
campaign_id广告计划的 ID。可以与 campaigns 广告计划表中的id字段相连接b1d67331-204b-4ee3-9cac-7c0f0f33b5bf
bundle_id应用的包名com.tenjin.wordfinder
platform应用的发布平台ios or anroid
ip_address用户的 IP 地址71.165.85.114
limit_ad_tracking用户限制广告追踪(0,1)
uuid此事件的唯一 ID。可以与 events 事件表的 source_uuid 相连接0df8ccda-372b-4e9e-8fdc-dfa0eb0c333e
app_idTenjin 内部的应用 id。可以和 apps 应用表中的 id 相连接ee270433-b7da-4e0f-9b03-8dd25d89da49
country国家代码US
site_id付费推广广告计划的唯一 IDInstagram
user_agent用户代理Dalvik/2.1.0 (Linux; U; Android 8.0.0; SM-G570M Build/R16NW)
remote_click_id【待定】通过点击 click url(点击归因链接) click id ad-networks passes through the click url.DSGfaa
loaded_at在 Tenjin 的数据库中更新记录的时间戳2018-07-01 00:00:00
tracking_statusiOS 设备的(整数)ATT 状态. 0 => 未确定, 1 => 限制, 2 => 拒绝 3 => 批准3
analytics_installation_id当 Android 设备用户不同意共享其 Google advertising 广告 id 时,用于分析安装的特定标识符。(iOS为空。)小写,无连字符。f024e65f3dd94f16983726bcef192d68
Column 列Description 描述Example value 例值
campaign_id广告计划的 ID。可以和 campaigns 广告计划表中的 id 字段相连接b1d67331-204b-4ee3-9cac-7c0f0f33b5bf
targeting_tag_id广告定向标签的 ID。可以与 targeting_tags 定向标签的 id 字段相连接1
Column 列Description 描述Example value 例值
id (S)广告定向标签的 ID1
display展现在 Tenjin 面板上的定向标签Gender: Male
standard是否为 Tenjin 的默认标签。True 是或者 False 否true
category定向标签的类别Gender
segment定向标签的细分Male
loaded_at在 Tenjin 的数据库中上传记录的时间戳2018-07-01 00:00:00
Column 列Description 描述Example value 例值
date (S)该指标应用的日期2018-11-01
ad_network_idTenjin 内部的广告平台 ID3
platform应用发布平台ios or android
app_idTenjin 内部的应用 IDee270433-b7da-4e0f-9b03-8dd25d89da49
campaign_idTenjin 内部的广告计划 IDb1d67331-204b-4ee3-9cac-7c0f0f33b5bf
country两个字母的国家代码US
site_id子渠道 IDInstagram
daily_active_users日活跃用户unique devices seen105
sessions应用打开的次数23650
iap_revenue应用内付费收入总额(美分)245
reported_spend广告平台 API 报告的花费总额(美分)5323
reported_impressions广告平台 API 报告的展示总和13000
reported_clicks广告平台 API 报告的点击总和3000
reported_installs广告平台 API 报告的安装总和4000
publisher_ad_revenue广告平台 API 报告的广告变现收入总额(美分)2000
tracked_impressionsTenjin 追踪到的总展示13000
tracked_clicksTenjin 追踪到的总点击4000
tracked_installsTenjin 追踪到的总安装3000
loaded_at在 Tenjin 的数据库中上传记录的时间戳2018-07-01 00:00:00
Column 列Description 描述Example value 例值
event_date (S)该指标应用的日期2018-11-01
install_date安装日期2018-10-01
days_since_install安装天数3
platform应用的发布平台ios or anroid
app_idTenjin 内部的应用 IDee270433-b7da-4e0f-9b03-8dd25d89da49
campaign_idTenjin 内部的广告计划 IDb1d67331-204b-4ee3-9cac-7c0f0f33b5bf
country两个字母的国家代码US
site_id子渠道Instagram
daily_active_users日活跃用户 unique devices seen105
sessions应用打开的次数23650
iap_revenue应用内付费收入总额(美分)245
publisher_ad_revenue广告平台 API 报告的广告变现收入总额(美分)2000
loaded_at在 Tenjin 的数据库中上传记录的时间戳2018-07-01 00:00:00

对于 reporting_cohort_metrics 报告群组指标表,请使用 install_date 安装日期和 days_since_install 安装天数两个指标来获取面板上的指标。
比如:

SELECT install_date AS DATE,
       apps.name as app_name,
       ad_networks.name as ad_network,
       country,
       SUM(CASE WHEN days_since_install <= 1 THEN (publisher_ad_revenue + iap_revenue) / 100.0 ELSE 0 END) AS d1_total_LTV,
       SUM(CASE WHEN days_since_install <= 2 THEN (publisher_ad_revenue + iap_revenue) / 100.0 ELSE 0 END) AS d2_total_LTV,
       SUM(CASE WHEN days_since_install <= 3 THEN (publisher_ad_revenue + iap_revenue) / 100.0 ELSE 0 END) AS d3_total_LTV,
       SUM(CASE WHEN days_since_install = 1 THEN daily_active_users ELSE 0 END) AS d1_retained_users,
       SUM(CASE WHEN days_since_install = 2 THEN daily_active_users ELSE 0 END) AS d2_retained_users,
       SUM(CASE WHEN days_since_install = 3 THEN daily_active_users ELSE 0 END) AS d3_retained_users
FROM reporting_cohort_metrics
  LEFT JOIN apps ON apps.id = reporting_cohort_metrics.app_id
  LEFT JOIN bucket_campaign_info ON bucket_campaign_info.id = reporting_cohort_metrics.campaign_id
  LEFT JOIN ad_networks ON ad_networks.id = bucket_campaign_info.ad_network_id
WHERE install_date = '2018-10-11'
GROUP BY 1,
         2,
         3,
         4
LIMIT 10
Column 列Description 描述Example value 例值
id广告计划组的唯一 IDc89abc24-e0fb-47c5-8bd3-10b5aa3a9f52
ad_network_idTenjin 内部的广告平台 ID3
app_idTenjin 内部的应用 IDee270433-b7da-4e0f-9b03-8dd25d89da49
name广告计划组名称或者原始广告计划名称US - TEST
is_bucket是否为广告计划组TRUE or FALSE

请与您的客户经理联系以获取此表。

Column 列Description 描述Example value 例值
id(S)小写字符串的 SK Ad Network ID"cstr6suwn9.skadnetwork"
ad_network_idTenjin 内部的广告平台 ID,整数。可以和ad_networks.id相连接5
updated_at在 Tenjin 的数据库中更新记录的时间戳2021-01-01 00:00:00
loaded_at在 Tenjin 的数据库中上传记录的时间戳2021-01-01 00:00:00

请与您的客户经理联系以获取此表。

Column 列Description 描述Example value 例值
date(S)收到 SK Ad Network 回传的日期2021-01-01
sk_ad_network_id小写字符串的 SK Ad Network ID"cstr6suwn9.skadnetwork"
ad_network_idTenjin 内部的广告平台 ID,整数。可以和ad_networks.id相连接5
sk_app_id整数的 SK App ID。等同于 iOS 应用的 apps.store_id1478027094
app_idTenjin 内部的应用 ID。可以和 apps.id相连接"9668185b-da2e-4638-b15f-e03431377ac5"
sk_campaign_idSK Campaign ID,0-99 之间的整数10
campaign_idTenjin 内部的广告计划 ID。可以和 campaigns.id相连接"61817a78-0a8f-4e83-98c0-8106f7a6ea92"
sk_source_app_id转化来源的应用对应的 id"284882215"
fidelity_type1 for StoreKit Ads, 0 for view-through ads.1
conversion_value转化值,为 0-63 之间的整数33
conversion_value_countconversion_value 转化值出现的次数250
redownload_count重装下载的conversion_value 转化值出现的次数11
assist_count助攻下载的conversion_value 转化值出现的次数2
redownload_assist_count重装下载和助攻下载总计的conversion_value 转化值出现的次数1
loaded_at在 Tenjin 的数据库中上传记录的时间戳2021-01-01 00:00:00

请与您的客户经理联系以获取此表。

Column 列Description 描述Example value 例值
date(S)收到 SK Ad Network 回传的日期2021-01-01
sk_ad_network_id小写字符串的 SK Ad Network ID"cstr6suwn9.skadnetwork"
ad_network_idTenjin 内部的广告平台 ID,整数。可以和ad_networks.id相连接5
sk_app_id整数的 SK App ID。等同于 iOS 应用的 apps.store_id1478027094
app_idTenjin 内部的应用 ID。可以和 apps.id相连接"9668185b-da2e-4638-b15f-e03431377ac5"
sk_campaign_idSK Campaign ID,0-99 之间的整数10
campaign_idTenjin 内部的广告计划 ID。可以和 campaigns.id相连接。 Always null, as Apple does not provide any way to get this value.null
sk_source_app_id转化来源的应用对应的 id"284882215"
fidelity_type1 指 StoreKit Ads 渲染型广告,0 指 view-through ads 浏览型广告1
conversion_value转化值,为 0-63 之间的整数33
conversion_value_countconversion_value 转化值出现的次数250
redownload_count重装下载的conversion_value 转化值出现的次数11
assist_count助攻下载的conversion_value 转化值出现的次数2
redownload_assist_count重装下载和助攻下载总计的conversion_value 转化值出现的次数1
loaded_at在 Tenjin 的数据库中上传记录的时间戳2021-01-01 00:00:00
Column 列Description 描述Example value 例值
created_at (S)创建事件的时间戳2018-07-01 00:00:00
advertising_idiOS 的 IDFA 或 Android 的 Google Advertising ID。小写,不带连字符。29eeb1610fe74997b6d53f02e9711f8c
bundle_id应用的包名 bundle ID(我们会将包名转化为小写)com.tenjin.wordfinder
platform应用发布的平台ios or anroid
os_version设备的操作系统版本8.0
app_version应用版本1.0.3
limit_ad_tracking用户限制广告跟踪 (0 否,1 是)1
app_idTenjin 的内部应用 id。可以与 apps 应用表中的id字段进行连接ee270433-b7da-4e0f-9b03-8dd25d89da49
source_campaign_idTenjin 内部的广告计划 id。可以与 campaigns 广告计划表中的 id 进行连接18a0c1d6-02a2-4188-bbc0-0fe38dbcc37e
acquired_at用户获取的时间戳2018-07-01 00:00:00
price付费事件的原始单价1.99
quantity付费事件的采购数2
product_id付费事件的 product 产品 idcom.tenjin.wordfinder.package50
currency付费事件的货币代码USD
country国家代码US
total_revenue付费事件的总收入(美元) 美分350
revenue付费事件的净收入(美元) 美分245
site_id广告计划的发布者ID(对于付费推广广告)Instagram
developer_device_idiOS 的 IDFV。Android 则为空。小写,不带连字符。b6bc48fe0ce949e4b229ce6c55663fca
purchase_state
  • 0: Unknowable 未知-购买时未收到收据
  • 1: Unverified 未验证-提供了收据,但无法验证
  • 2: Fraudulent 欺诈-提供了假的收据
  • 3: Verified 已验证-收据已成功验证
  • 4: Sandbox 沙盒-收据已在测试沙盒中验证
  • 5: Duplicate 重复 重复-收据已与先前的付费事件一起收到
3
value自定义事件值1
uuid唯一事件 IDa3e3e535-a32c-4887-9c91-3160c91b3876
device设备类型iPad2,5
creative_name素材名称test_creative
ip_address用户 IP 地址71.165.85.114
source_uuid对于付费推广广告,则为点击或展示事件的 UUID。它可以与ad_engagements 表中与“uuid”相连接0df8ccda-372b-4e9e-8fdc-dfa0eb0c333e
loaded_at该条记录被上传到 Data Vault 数据仓库时的时间戳2018-07-01 00:00:00
tracking_statusiOS 设备的 (整数)ATT 状态. 0 => not determined 未确定, 1 => restricted 限制, 2 => denied 拒绝, 3 => authorized 批准3
analytics_installation_id当 Android 设备用户不同意共享其 Google advertising 广告 id 时,用于分析安装的特定标识符。(iOS为空。)小写,无连字符。f024e65f3dd94f16983726bcef192d68

请联系客户经理咨询此数据集的开通

ColumnDescriptionExample value
acquired_attimestamp when the user was acquired2018-11-01 00:00:00
ad_mediation_ad_formatFormat of the Ad unitBanner
ad_mediation_networkNetwork that displayed the adApplovin
ad_mediation_placementNetwork defined placementmy_banner_placement
ad_mediation_providerAd mediation providerApplovin MAX
ad_mediation_revenue_microcentsAd revenue in microscents as provided by the mediation provider22000
advertising_idIDFA for iOS or Google advertising ID for Android. Lower case, without hyphen.29eeb1610fe74997b6d53f02e9711f8c
analytics_installation_idApplication install-specific identifier for Android devices. Used for analytics when a user does not consent to sharing their Google advertising id. (Empty for iOS.) Lower case, without hyphen.f024e65f3dd94f16983726bcef192d68
app_idTenjin's internal app id. It can be joined with id in apps tableee270433-b7da-4e0f-9b03-8dd25d89da49
app_versionapp version1.0.3
bundle_idapp's bundle ID(we convert bundle_id to lowercase)com.tenjin.wordfinder
countrycountry codeUS
created_attimestamp when the event was created2018-11-01 00:00:00
creative_namecreative nametest_creative
customer_user_idUser ID from the app, as set by setCustomerUserId SDK methodjdabGcerT32_d
developer_device_idIDFV for iOS. Empty for Android. Lower case, without hyphenb6bc48fe0ce949e4b229ce6c55663fca
devicedevice typeiPAD 2.5
engaged_atTimestamp for the impression event2018-01-01 00:00:00
ip_addressuser's IP address71.165.85.114
limit_ad_trackinguser's limit ad tracking(0,1)
loaded_attimestamp when the record is updated in DataVault2018-07-01 00:00:00
os_versiondevice's os_version8.0
platformapp's platform8.0
sdk_versionUser's Tenjin SDK version12.2.22
site_idcampaign's publisher ID if the campaign is paid campaigninstagram
source_campaign_idTenjin's internal campaign id for the campaign user is attributed to. It can be joined with id in campaigns table18a0c1d6-02a2-4188-bbc0-0fe38dbcc37e
source_uuidUUID for the impression event if the campaign was paid campaign. It can be joined with uuid in ad_engagements table0df8ccda-372b-4e9e-8fdc-dfa0eb0c333e
tracking_statusinteger for the iOS device's ATT status. 0 => not determined, 1 => restricted, 2 => denied, 3 => authorized3
uuidunique ID for the event. It can be joined with source_uuid events table0df8ccda-372b-4e9e-8fdc-dfa0eb0c333e

回溯期

详细信息

以下这些 tables 数据表的历史数据取决于回溯期。如果你想了解 DataVault 数据仓库的回溯窗口,请联系 Tenjin 的客户经理。

  • events 事件
  • ad_engagements
  • reporting_metrics 报告指标
  • reporting_cohort_metrics 报告群组指标


本文对您有帮助吗?