使用 Floodlight 数据

以下示例脚本使用了 Floodlight 数据来为自定义出价算法提供信息：

• 销售收入 Floodlight 代码
• 使用一组 Floodlight 的加权转化
• 自定义 Floodlight 变量

销售收入 Floodlight 代码

您可以使用 total_conversion_value 创建自定义出价脚本，该脚本会针对 Floodlight 销售代码所跟踪的销售收入进行优化。

真实情景示例

某个电子商务广告客户想针对交易价值（而非总交易次数）来优化出价。为满足该广告客户的需求，您使用了 Floodlight 销售代码和交易价值来跟踪付款确认活动。

示例脚本

以下脚本会返回 Floodlight 销售代码所跟踪的值：

• Floodlight_ID：指定活动 ID。
• model_id：
  • 如果您已在广告客户一级设置了归因模型，请指定归因模型 ID。
  • 否则，请指定 0 以使用最终接触归因。

return (total_conversion_value(Floodlight_ID, model_id)

使用一组 Floodlight 的加权转化

您可以使用 sum_aggregate 优化 3 个不同的转化活动（各个活动的价值互不相同），以针对多项转化的价值求和：

• 如果某次展示促成了多次不同的转化：系统会在将价值归因于此次展示时汇总这些转化的价值。
• 如果某次展示促成了与同一活动 ID 对应的多次转化：系统会先汇总转化次数，然后再将所得的总次数与转化权重相乘。

真实情景示例

• 某个汽车制造商正在跟踪小型货车、SUV 和轿车产品页面上的转化情况。为了针对价值来优化出价，各个类别被分配了互不相同的价值。
• 某个公益组织想针对捐款事件来优化出价，因为捐款事件很少见。他们可以添加漏斗上端活动，并为这些事件分配较低的权重，以提高转化次数。例如，点击“详细了解该组织”和“查看您可以提供的帮助”。

示例脚本

以下脚本使用 sum_aggregate 返回 3 个不同的转化活动，各个活动的价值互不相同：

• Floodlight_ID1、Floodlight_ID2、Floodlight_ID3：指定各活动 ID。例如：123456、456789、78901。
• model_id：
  • 如果您已在广告客户一级设置了归因模型，请指定归因模型 ID。
  • 否则，请指定 0 以使用最终接触归因。
• weighting_1、weighting_2、weighting_3：为每个转化活动指定权重。例如：100、5 或 0.2。

return sum_aggregate([
        ([total_conversion_count(Floodlight_ID_1, model_id)>0], total_conversion_count(Floodlight_ID_1, model_id)*weighting_1),
        ([total_conversion_count(Floodlight_ID_2, model_id)>0], total_conversion_count(Floodlight_ID_2, model_id)*weighting_2),
        ([total_conversion_count(Floodlight_ID_3, model_id)>0], total_conversion_count(Floodlight_ID_3, model_id)*weighting_3)
])

用于优化多项转化活动的变体

优化多项转化活动的方式不尽相同。

• 您可以通过移除或添加新条件来更改加权转化活动的数量。
• 您可以使用 max_aggregate 来指定价值最高的转化事件的价值。
• 如需为第一个匹配的转化事件（基于脚本中的转化事件排序）分配价值，请使用 first_match_aggregate。

示例脚本

以下示例脚本会为转化事件分配较高的价值，但为点击事件分配较低的价值：

return max_aggregate([
    ([click], weight_1),
    ([total_conversion_count(Floodlight_ID_1, model_id)>0], weight_2)])

示例脚本

以下示例脚本会为点击型转化事件分配较高的价值，但为浏览型转化事件分配较低的价值：

return sum_aggregate([
    ([click, total_conversion_count(Floodlight_ID_1, model_id)>0], weight_1),
    ([not click, total_conversion_count(Floodlight_ID_1, model_id)>0], weight_2)])

自定义 Floodlight 变量

您可以使用 conversion_custom_variable 创建一个脚本，以针对单个 Floodlight 活动的单个自定义 Floodlight 变量来优化出价。

在自定义出价脚本中使用 u 变量时，必须先与 Display & Video 360 共享这些变量：

1. 依次转到资源 > Floodlight 活动组。
2. 选择一个 Floodlight 活动。
3. 对于自定义 Floodlight 变量，请选择“查看”图标。
4. 选中 u 变量旁边的复选框。

真实情景示例

某个汽车租赁连锁店想针对车辆预订数量来优化出价。他们通过一个 Floodlight 代码来跟踪预订确认活动，并通过一个自定义 Floodlight 变量来跟踪预订的天数。

示例脚本

以下脚本示例会针对单个 Floodlight 活动的单个自定义 Floodlight 变量来优化出价。若有转化事件发生，该脚本会返回一个字符串；若无转化事件发生，该脚本会返回 None。所有未促成转化的展示事件的价值均为 0。所有未被模型归因的展示事件都会返回为 None，而且其价值会被视为 0：

• Floodlight_ID：指定活动 ID。
• model_id：
  • 如果您已在广告客户一级设置了归因模型，请指定归因模型 ID。
  • 否则，请指定 0 以使用最终接触归因。
• u_variable_index：指定活动 ID 的自定义 Floodlight u 变量索引。

_uvar = conversion_custom_variable(Floodlight_ID, model_id, u_variable_index)

if _uvar != None and _uvar != "":
    return float(_uvar)

return 0