Shapley 值分析

Shapley 值方法是一种算法，用于为众多广告渠道和接触点分配功劳，具体取决于这些渠道和接触点对转化的贡献（根据模型估算得出）。利用 Shapley 值方法，您可以基于模型来估算特定渠道对转化的贡献。

广告数据中心使用的是“简化版 Shapley 值方法”；如需查看完整的详细说明，请参阅 Shapley Value Methods for Attribution Modeling in Online Advertising（适合在线上广告领域用于归因建模的 Shapley 值方法）这篇论文。

注意：Shapley 值模型只能与基于数据传输的表搭配使用：cm_dt_*、dv360_dt_* 和各自的路径表。

隐私保护方面的限制

用于保护隐私的过滤条件会移除用户数少于 50 人的接触点，以及对接触点贡献的功劳过大或过小的离群用户。因此，Shapley 值模型的输出可能会缺少输入接触点表中的一些接触点。

Shapley 值模型每次迭代完成后都会显示隐私权消息。这些消息中包含已滤除的用户和接触点的相关信息。

概述：采用 Shapley 值方法来计算值

1. 创建接触点表和功劳表：
   1. touchpoint_temp_table。
   2. user_credit_temp_table。
2. 使用上述临时表作为参数来调用 ADH.TOUCHPOINT_ANALYSIS 表值函数。

创建接触点表和功劳表

创建接触点表

接触点表中定义了与接触点相关的用户事件。示例数据可能包括但不限于：campaign_id、creative_id、placement_id 或 site_id。

注意：Shapley 值分析目前限定为最多不超过 150 个接触点。

该表必须包含以下列：

列名称	类型
touchpoint	string 任意接触点名称（不得为 NULL 或包含逗号）。
user_id	string 访问接触点的用户的 ID（不得为 NULL 或 0）。
event_time	int 用户访问接触点的时间（不得为 NULL）。

注意：如果不同接触点的总数超过 150 个，或者 user_credit_temp_table 中不存在 user_id，查询将会失败。

用于创建表的示例代码：

CREATE TABLE touchpoint_temp_table
AS (
  SELECT user_id, event.event_time, CAST(event.site_id AS STRING) AS touchpoint
  FROM adh.cm_dt_impressions
  WHERE
    event.event_type IN ('VIEW')
    AND user_id <> '0'
    AND event.campaign_id IN UNNEST(@campaign_ids)

  UNION ALL

    SELECT
      user_id, event.event_time, CAST(event.site_id AS STRING) AS touchpoint
    FROM adh.cm_dt_clicks
    WHERE
      event.event_type IN ('CLICK')
      AND user_id <> '0'
      AND event.campaign_id IN UNNEST(@campaign_ids)
);

创建用户功劳表

用户功劳表中定义了转化事件。对于每位用户，系统只会考虑时间戳早于转化发生时间的事件。

该表必须包含以下列：

列名称	类型
user_id	string 访问接触点的用户的 ID（不得为 NULL 或 0）。
event_time	int 贡献事件发生的时间（不得为 NULL）。
credit	integer 用户贡献的功劳，可以是要分析的任何功劳，例如转化价值、转化次数等。该值必须介于 1 到 100 之间。

注意：如果同一用户有多个转化事件，请像上传任何其他事件一样上传这些事件。应确保没有任何事件使用重复的 user_id 和 event_time 对。

用于创建表的示例代码：

CREATE TABLE user_credit_temp_table AS (
  SELECT
    user_id,
    MAX(event.event_time) AS event_time,
    1 AS credit
  FROM adh.cm_dt_activities_attributed
  WHERE user_id <> '0'
    AND event.campaign_id IN UNNEST(@campaign_ids)
    AND DATE(TIMESTAMP_MICROS(event.event_time)) BETWEEN @start_date AND @end_date
    AND event.activity_id IN UNNEST (@activity_ids)
  GROUP BY user_id
);

表值函数

表值函数是一种将表作为结果返回的函数。因此，您可以像查询普通表一样查询表值函数。

语法

ADH.TOUCHPOINT_ANALYSIS(TABLE touchpoints_tmp_table_name, TABLE credits_tmp_table_name, STRING model_name)

参数

名称
touchpoints_tmp_table_name	客户创建的临时接触点表的名称。该表必须采用包含 touchpoint、user_id 和 event_time 列的架构。
credits_tmp_table_name	客户创建的临时用户功劳表的名称。该表必须采用包含 user_id、credit 和 conversion_time 列的架构。
model	string 其值必须为 SHAPLEY_VALUES。

输出表

输出表将包含以下架构：

列名称	类型
touchpoint	string 接触点名称。
score	integer 针对此接触点计算得出的 Shapley 值得分。

使用表值函数的示例代码

SELECT *
FROM ADH.TOUCHPOINT_ANALYSIS(
  TABLE tmp.touchpoint_temp_table,
  TABLE tmp.user_credit_temp_table,
  'SHAPLEY_VALUES')