我们能为您提供什么帮助?

搜索

从 Data Locker 导出网页端效果衡量报告数据

  • 更新

概览：从 Data Locker 导出两种类型的网页端效果衡量数据报告，以便按合适的层级分析网站表现。您可以使用「终端用户事件」报告分析所有访问和事件，或使用「转化」报告统计唯一的转化锚点（首次访问、再次访问和获客事件）并对其进行归因。

重要提示！您须先订阅 Data Locker，才能使用 Data Locker 中的网页端效果衡量报告。

关于网页端效果衡量报告

Data Locker 提供两种网页端效果衡量报告：终端用户事件报告和转化报告，分别用于满足不同的分析需求。

  • 终端用户事件报告是分析网站活动的主要数据来源：
    • 包含每次网页访问和每个网页事件
    • 将每次访问记录为已归因的应用打开事件
    • 适合生成访问层级和事件层级的报告
  • 转化报告最适合转化层级的分析。转化是归因过程中的关键触点，也是分配营销贡献的依据，决定了归因发生的时间和方式。包括：
    • 首次访问（用户首次访问您的网站）、
    • 再次访问（用户与非自然广告互动后返回网站），以及
    • 获客事件（代表获客的自定义事件，例如注册或首次存款）。
  • 后续发生的所有用户事件都会关联到相应的转化，并沿用这些转化对应的广告系列信息。

Data Locker 的高级报告界面还会将互动和跨平台终端用户事件列为单独的网页端效果衡量报告选项。本文将为您介绍终端用户事件和转化这两种报告，适用于大多数网页端效果衡量分析。

选择网页端效果衡量报告

导出网页端效果衡量数据前，请先在 Data Locker 中选择相应的报告。

  1. 在 AppsFlyer 中，从侧边菜单选择导出 > Data Locker。
  2. 点击 高级报告 标签页。
  3. 从网页端效果衡量报告列表中，选择 终端用户事件 或 转化。
  4. 点击 保存配置。

报告字段

如需了解报告包含哪些字段，请分别下载以下报告示例：

报告示例包含所有报告字段及其值。有关字段定义，请参阅 字段词典。

报告时间和数据时效性

以下信息可帮助您了解新数据何时添加，以及近期发生的事件何时会出现在报告中。

  • 报告更新频率：每小时添加一次新数据。
  • 数据时效性：事件通常在发生后 2 至 3 小时内出现在报告中。

各批次的处理方式如下：

  • 每个批次处理一个 1.5 小时窗口内的事件。
  • 在该窗口内，只有最初 1 小时内发生的事件会被归因。
  • 剩余 30 分钟的数据仅用于为已归因的事件补充客户用户 ID（CUID）。
  • 最近 30 分钟的事件尚未归因，将纳入下一批次。

这些事件何时会出现在报告中？

事件会在处理完成后写入报告。例如，08:00–09:00 的事件在 10:00 批次中完成归因后，将出现在 11:00 报告版本中。

示例：10:00 批次的处理方式

日期 报告可用时间 已归因的网页事件（事件发生时间） 用于为较早事件补充 CUID 的已处理网页事件
2026-01-28 11:00 08:00 – 09:00 09:00–09:30
2026-01-28 12:00 09:00 – 10:00 10:00–10:30
2026-01-28 13:00 10:00 – 11:00 10:00-11:30

从您的云存储桶下载报告数据

如需了解如何从云存储桶下载报告数据，请参阅 Data Locker 文件夹结构。

BI 开发人员注意事项

主要区别：网页端与移动端对比

网页归因与移动归因在标识符和数据逻辑方面均有不同。为提高数据准确性，请在查询中使用以下筛选条件并遵循最佳实践。

比较项 移动端用户 Web
平台筛选条件 platform = 'IOS' 或 platform = 'ANDROID’ platform = 'WEBSITE'
用户标识符（值） appsflyer_id（基于设备） appsflyer_id_value（基于 Cookie）
标识符类型 因设备而异 appsflyer_id_type 始终为 web_id
获客事件 Install 默认为首次访问，但可自定义获客事件
再互动 RE-ENGAGEMENT REVISIT
再归因 支持 不支持——网页端仅有获客和再次访问
应用 ID 应用 ID（例如 id123456789） 带前缀的域名（例如 website-www.example.com）
查询哪个表？

最终用户事件报告适用于大多数分析。该报告包含所有网站事件和访问记录。每次网页访问也会在该报告中记录为经过归因的 SESSION，因此该报告是访问层级和事件层级报告的主要来源。

如果需要统计不含重复事件记录的唯一转化，转化表主要适用于统计首次访问、再次访问和用户获取次数。

应用场景 表 目的
统计访问／应用打开次数 end_user_events 每行对应一次应用打开或一个事件
统计唯一转化次数 conversions 避免重复记录
分析应用内事件 end_user_events，且 end_user_event_type = 'IN_APP' 只有应用内事件具有事件名称
设置查询筛选条件

应用以下筛选条件，确保原始数据查询结果准确。未设置这些筛选条件会导致记录重复，且指标混入不同平台的数据。

  • 按平台筛选（必填）：添加 WHERE platform = 'WEBSITE'，仅保留来自网站的数据，并排除移动端、PC 或 CTV 环境的记录。

  • 按归因贡献筛选（必填）：根据报告视图，AppsFlyer 可能为同一用户操作分配两种不同的归因贡献，导致该操作在 end_user_events 中出现两次。

    当用户具有以下情况时，可能会出现这种情况：

    • 最初的用户获取 (UA)来源，以及之后的
    • 再互动来源。

    在这种情况下，AppsFlyer 可能为同一事件写入两条记录：

    • 主要归因权重：将事件归因于最近一次相关的营销互动。用于统一和再营销视图。

      为避免重复计数，查询 end_user_events 时默认仅使用主要归因记录：

      WHERE platform = 'WEBSITE'
  AND is_primary_attribution = true

    • 次要归因权重：将事件归因回原始获客来源。用于在用户获取视图中衡量生命周期价值 (LTV)。

      同一用户操作可能存储为两条记录（一条具有主要归因权重，另一条具有次要归因权重），因此，如果不添加筛选条件就统计事件，可能会对该操作重复计数。

      以这些查询为模板，在 BigQuery 或其他 BI 工具中分析网页归因数据。

  • 按转化类型筛选（可选）：添加 WHERE conversion_type = 'USER_ACQUISITION' 或 WHERE conversion_type = 'RETARGETING'，以按广告系列类型区分归因数据。

筛选条件汇总表

筛选要求 SQL 逻辑 实施场景
平台限定条件 WHERE platform = 'WEBSITE' 从其他平台记录中筛选出来自网页的数据。
统一视图（避免重复计数） WHERE is_primary_attribution = true AND platform = 'WEBSITE' 优先将归因权重分配给再营销广告系列，而非原始获客广告系列。用于常规报告，以避免重复计数。
仅再营销视图 WHERE conversion_type = 'RETARGETING' AND platform = 'WEBSITE' 仅在分析再营销广告系列表现时使用。
仅用户获取视图 WHERE conversion_type = 'USER_ACQUISITION' AND platform = 'WEBSITE' 仅用于需要将事件关联到首次访问的用户获取视图。
识别和统计终端用户

在网页端效果衡量原始数据中，同一终端用户可能对应两种不同的标识符：

  • customer_user_id：由您设置的稳定标识符（通常用于已登录用户）。
  • appsflyer_id_value：基于 Cookie 的 ID 可能会过期。

为准确识别独立用户并计算用户层级指标，请始终使用：

COALESCE(customer_user_id, appsflyer_id_value)

操作方法如下：

  • 如果存在 customer_user_id，AppsFlyer 会使用该值（首选，稳定）。
  • 如果不存在，AppsFlyer 则使用 appsflyer_id_value。

如需执行以下操作，请使用 COALESCE(customer_user_id, appsflyer_id_value)：

  • 去重统计用户数
  • 按用户分组
  • 筛选特定用户
  • 按用户关联表
  • 计算任何用户层级指标

示例：去重统计用户数

SELECT 
  COUNT(DISTINCT COALESCE(customer_user_id, appsflyer_id_value)) AS unique_users
FROM `end_user_events`
WHERE platform = 'WEBSITE'
  AND is_primary_attribution = TRUE
自然流量与非自然流量

使用 is_organic 字段：

流量类型 筛选条件
自然流量 is_organic = true
非自然 is_organic = false
空值处理
数据类型 空值
字符串 ''（空字符串）
数值 NULL
查询示例
按媒体渠道统计的总访问次数（7 天）

统计归因到各媒体渠道的网站应用打开次数。

SELECT media_source, COUNT(*) AS total_visits
FROM end_user_events
WHERE event_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)
  AND platform = 'WEBSITE'
  AND unified_app_id = 'website-example.com'
  AND is_primary_attribution = true
  AND end_user_event_type = 'SESSION'
GROUP BY media_source
ORDER BY total_visits DESC
按广告系列统计的首次访问和再次访问
SELECT campaign_name, conversion_name, COUNT(*) AS conversion_count
FROM conversions
WHERE event_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)
  AND platform = 'WEBSITE'
  AND unified_app_id = 'website-example.com'
  AND conversion_name IN ('FIRST_VISIT', 'REVISIT')
GROUP BY campaign_name, conversion_name
ORDER BY conversion_count DESC
统计不同事件名称的数量（仅限应用内事件）
SELECT
  event_name,
  COUNT(*) AS event_count
FROM end_user_events
WHERE event_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)
  AND platform = 'WEBSITE'
  AND unified_app_id = 'website-example.com'
  AND is_primary_attribution = true
  AND end_user_event_type = 'IN_APP'
GROUP BY event_name
ORDER BY event_count DESC
按媒体渠道统计去重用户数
SELECT
  media_source,
  COUNT(DISTINCT COALESCE(customer_user_id, appsflyer_id_value)) AS unique_users
FROM end_user_events
WHERE event_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)
  AND platform = 'WEBSITE'
  AND unified_app_id = 'website-example.com'
  AND is_primary_attribution = true
GROUP BY media_source
ORDER BY unique_users DESC
从首次访问到购买的转化率（跨表连接）
WITH first_visits AS (
  SELECT
    COALESCE(customer_user_id, appsflyer_id_value) AS user_id,
    media_source
  FROM conversions
  WHERE event_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
    AND platform = 'WEBSITE'
    AND unified_app_id = 'website-example.com'
    AND conversion_name = 'FIRST_VISIT'
),
purchases AS (
  SELECT DISTINCT
    COALESCE(customer_user_id, appsflyer_id_value) AS user_id
  FROM end_user_events
  WHERE event_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
    AND platform = 'WEBSITE'
    AND unified_app_id = 'website-example.com'
    AND is_primary_attribution = true
    AND end_user_event_type = 'IN_APP'
    AND event_name = 'purchase'
)
SELECT
  fv.media_source,
  COUNT(DISTINCT fv.user_id) AS first_visit_users,
  COUNT(DISTINCT p.user_id) AS purchasers,
  SAFE_DIVIDE(COUNT(DISTINCT p.user_id), COUNT(DISTINCT fv.user_id)) AS conversion_rate
FROM first_visits fv
LEFT JOIN purchases p ON fv.user_id = p.user_id
GROUP BY fv.media_source
ORDER BY conversion_rate DESC
按广告系列统计的收入（过去 7 天）
SELECT
  campaign_name,
  media_source,
  SUM(revenue_usd) AS total_revenue_usd,
  COUNT(*) AS revenue_events
FROM end_user_events
WHERE event_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)
  AND platform = 'WEBSITE'
  AND unified_app_id = 'website-example.com'
  AND is_primary_attribution = true
  AND revenue_usd IS NOT NULL
  AND revenue_usd <> 0.0
GROUP BY campaign_name, media_source
ORDER BY total_revenue_usd DESC
按天统计的自然流量与非自然流量首次访问
SELECT
  DATE(event_time) AS visit_date,
  CASE WHEN is_organic = true THEN 'Organic' ELSE 'Non-Organic' END AS traffic_type,
  COUNT(*) AS first_visits
FROM conversions
WHERE event_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  AND platform = 'WEBSITE'
  AND unified_app_id = 'website-example.com'
  AND conversion_name = 'FIRST_VISIT'
GROUP BY visit_date, traffic_type
ORDER BY visit_date, traffic_type
用户获取与再营销明细
SELECT
  conversion_type,
  conversion_name,
  COUNT(*) AS conversions
FROM conversions
WHERE event_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)
  AND platform = 'WEBSITE'
  AND unified_app_id = 'website-example.com'
GROUP BY conversion_type, conversion_name
ORDER BY conversions DESC
点击 ID 分布（Google、Meta、TikTok 等）
SELECT
  click_id_type,
  COUNT(*) AS events_with_click_id
FROM end_user_events
WHERE event_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)
  AND platform = 'WEBSITE'
  AND unified_app_id = 'website-example.com'
  AND is_primary_attribution = true
  AND click_id_type != ''
GROUP BY click_id_type
ORDER BY events_with_click_id DESC
按转化日期划分用户群组（相当于移动端激活日期）
SELECT
  DATE(event_time__conversion) AS cohort_date,
  media_source,
  COUNT(DISTINCT COALESCE(customer_user_id, appsflyer_id_value)) AS cohort_users
FROM end_user_events
WHERE event_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  AND platform = 'WEBSITE'
  AND unified_app_id = 'website-example.com'
  AND is_primary_attribution = true
GROUP BY cohort_date, media_source
ORDER BY cohort_date, cohort_users DESC

产品线的特点与限制

以下字段不支持网页端数据，并且始终为空：

特性 说明
advertising_id_type、hardware_id_type 等。 两者皆可
agency、site_id、ad_type 两者皆可
platform_group 转化
app_version__conversion end_user_events
所有 __assist_* 字段 转化

另请参阅

Tags