指标与细分
本文档概述了每种实体类型分析可用的指标,以及每种指标可用的细分。
指标组 | |||||||
---|---|---|---|---|---|---|---|
实体 | ENGAGEMENT |
BILLING |
VIDEO |
MEDIA |
WEB_CONVERSION |
MOBILE_CONVERSION |
LIFE_TIME_VALUE_MOBILE_CONVERSION |
ACCOUNT |
✔* | ||||||
FUNDING_INSTRUMENT |
✔* | ✔ | |||||
CAMPAIGN |
✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
LINE_ITEM |
✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
PROMOTED_TWEET |
✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
MEDIA_CREATIVE |
✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
ORGANIC_TWEET |
✔ | ✔ |
*ENGAGEMENT
指标系列中的部分指标在账号和支付手段级别不可用。请参见 ENGAGEMENT
部分以获取详情。
按指标组划分的可用指标
ENGAGEMENT
指标 | 说明 | 细分可用 | 数据类型 | 对账号/支付手段可用 |
---|---|---|---|---|
engagements |
互动总数 | ✔ | 整数数组 | ✔ |
impressions |
展示总数 | ✔ | 整数数组 | ✔ |
retweets |
转推总数 | ✔ | 整数数组 | ✔ |
replies |
回复总数 | ✔ | 整数数组 | ✔ |
likes |
喜欢总数 | ✔ | 整数数组 | ✔ |
follows |
关注总数 | ✔ | 整数数组 | ✔ |
card_engagements |
卡片互动总数 | ✔ | 整数数组 | |
clicks |
点击总数,包含收藏和其他互动 | ✔ | 整数数组 | |
app_clicks |
应用安装或打开尝试次数 | ✔ | 整数数组 | |
url_clicks | 广告中链接或网站卡片的总点击量,包括赚取的点击量。 | ✔ | 整数数组 | |
qualified_impressions |
合格展示总数 | ✔ | 整数数组 |
BILLING
指标 | 说明 | 细分可用 | 数据类型 |
---|---|---|---|
billed_engagements |
计费互动总数 | ✔ | 整数数组 |
billed_charge_local_micro |
微观层面总支出 | ✔ | 整数数组 |
VIDEO
有关视频指标定义更改的注意事项:
根据 MRC 标准,VIDEO
指标组中的 video_total_views
指标将报告 50% 画面播放至少 2 秒的所有观看量。
我们对原始视频观看量的定义(全画面播放至少 3 秒)将继续作为 VIDEO
指标组中的新 video_3s100pct_views
指标提供。要继续根据原始观看量定义出价并付费,请使用新提供的 VIEW_3S_100PCT
bid_unit。
指标 | 说明 | 细分可用 | 数据类型 |
---|---|---|---|
video_total_views |
视频观看量总数 | ✔ | 整数数组 |
video_views_25 |
视频至少看完 25% 的观看量总数。 | ✔ | 整数数组 |
video_views_50 |
视频至少看完 50% 的观看量总数。 | ✔ | 整数数组 |
video_views_75 |
视频至少看完 75% 的观看量总数。 | ✔ | 整数数组 |
video_views_100 |
视频至少看完 100% 的观看量总数。 | ✔ | 整数数组 |
video_cta_clicks |
行动号召的总点击量 | ✔ | 整数数组 |
video_content_starts |
视频回放播放总数 | ✔ | 整数数组 |
video_3s100pct_views |
全画面播放至少 3 秒的观看量总数(原为 video_total_views ) |
✔ | 整数数组 |
video_6s_views |
视频至少看完 6 秒钟的观看量总数 | ✔ | 整数数组 |
video_15s_views |
视频至少看完 15 秒钟或总时长 95% 的观看量总数 | ✔ | 整数数组 |
MEDIA
指标 | 说明 | 细分可用 | 数据类型 |
---|---|---|---|
media_views |
视频、Vine、GIF 和图像等媒体观看量(自动播放和点击)总数。 | ✔ | 整数数组 |
media_engagements |
视频、Vine、GIF 和图像等媒体点击总数。 | ✔ | 整数数组 |
WEB_CONVERSION
指标 | 说明 | 细分可用 | 数据类型 |
---|---|---|---|
conversion_purchases |
PURCHASE 类型的转化数量及对应的销售金额和订单数量 | 仅限于 PLATFORMS |
JSON 对象 |
conversion_sign_ups |
SIGN_UP 类型的转化数量及对应的销售金额和订单数量 | 仅限于 PLATFORMS |
JSON 对象 |
conversion_site_visits |
SITE_VISIT 类型的转化数量及对应的销售金额和订单数量 | 仅限于 PLATFORMS |
JSON 对象 |
conversion_downloads |
DOWNLOAD 类型的转化数量及对应的销售金额和订单数量 | 仅限于 PLATFORMS |
JSON 对象 |
conversion_custom |
CUSTOM 类型的转化数量及对应的销售金额和订单数量 | 仅限于 PLATFORMS |
JSON 对象 |
MOBILE_CONVERSION
移动转化统计数据仅适用于启用了 MACT 的广告商账号。
指标 | 说明 | 细分可用 | 数据类型 |
---|---|---|---|
mobile_conversion_spent_credits |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 SPENT_CREDIT 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_installs |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 INSTALL 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_content_views |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 CONTENT_VIEW 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_add_to_wishlists |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 ADD_TO_WISHLIST 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_checkouts_initiated |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 CHECKOUT_INITIATED 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_reservations |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 RESERVATION 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_tutorials_completed |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 TUTORIAL_COMPLETED 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_achievements_unlocked |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 ACHIEVEMENT_UNLOCKED 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_searches |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 SEARCH 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_add_to_carts |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 ADD_TO_CART 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_payment_info_additions |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 PAYMENT_INFO_ADDITION 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_re_engages |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 RE_ENGAGE 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_shares |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 SHARE 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_rates |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 RATE 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_logins |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 LOGIN 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_updates |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 UPDATE 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_levels_achieved |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 LEVEL_ACHIEVED 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_invites |
按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 INVITE 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_key_page_views |
按 post_view 和 post_engagement 划分的 KEY_PAGE_VIEW 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_downloads | 按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 DOWNLOAD 类型的移动转化明细 |
✔ | JSON 对象 |
mobile_conversion_purchases | 按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 PURCHASE 类型的移动转化明细 | ✔ | JSON 对象 |
mobile_conversion_sign_ups | 按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 SIGN_UP 类型的移动转化明细 |
✔ | JSON 对象 |
mobile_conversion_site_visits | 按 post_view、post_engagement、assisted、order_quantity 以及 sale_amount 划分的 SITE_VISIT 类型的移动转化明细 |
✔ | JSON 对象 |
LIFE_TIME_VALUE_MOBILE_CONVERSION
终身移动转化统计数据仅适用于启用了 MACT 的广告商账号。
指标 | 说明 | 细分可用 | 数据类型 |
---|---|---|---|
mobile_conversion_lifetime_value_purchases |
PURCHASE 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_sign_ups |
SIGN_UP 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_updates |
UPDATE 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_tutorials_completed |
TUTORIAL_COMPLETED 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_reservations |
RESERVATION 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_add_to_carts |
ADD_TO_CART 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_add_to_wishlists |
ADD_TO_WISHLIST 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_checkouts_initiated |
CHECKOUT_INITIATED 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_levels_achieved |
LEVEL_ACHIEVED 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_achievements_unlocked |
ACHIEVEMENT_UNLOCKED 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_shares |
SHARE 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_invites |
INVITE 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_payment_info_additions |
PAYMENT_INFO_ADDITION 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_spent_credits |
SPENT_CREDIT 类型的移动转化明细 | JSON 对象 | |
mobile_conversion_lifetime_value_rates |
RATE 类型的移动转化明细 | JSON 对象 |
细分
细分报告支持检索由给定定位类型值划分的指标。细分只能通过异步分析查询完成,因为其复杂性显著增加。
MEDIA_CREATIVE
或 ORGANIC_TWEET
实体不支持细分。
一些细分类型需要传入额外的参数。这些参数在下方有记录。
按 CITIES
或 POSTAL_CODES
进行细分时,API 将仅返回目标位置。地区和大都市细分将返回目标位置和非目标位置。
细分类型 | 是否需要 country 参数 |
是否需要 platform 参数 |
---|---|---|
AGE |
||
APP_STORE_CATEGORY |
||
AUDIENCES |
||
CITIES |
✔ | |
CONVERSATIONS |
||
CONVERSION_TAGS |
||
DEVICES |
✔ | |
EVENTS |
||
GENDER |
||
INTERESTS |
||
KEYWORDS |
||
LANGUAGES |
||
LOCATIONS |
||
METROS |
✔ | |
PLATFORMS |
||
PLATFORM_VERSIONS |
✔ | |
POSTAL_CODES |
✔ | |
REGIONS |
✔ | |
SLIDES |
||
SIMILAR_TO_FOLLOWERS_OF_USER |
||
TV_SHOWS |