Show Menu
主题×

核心扩展

核心扩展是随 Launch 一起发布的默认扩展。
使用本参考可了解有关使用此扩展构建规则时可用的选项的信息。

核心扩展事件类型

本主题介绍核心扩展中可用的事件类型。
有关可以为多个不同事件类型设置的选项的信息,请参阅 选项

浏览器

Tab Blur

选项卡失去焦点时会触发该操作。
没有适用于此事件类型的设置。

Tab Focus

选项卡获得焦点时会触发该操作。
没有适用于此事件类型的设置。

表单

Blur

表单失去焦点时会触发该操作。
请参阅下面的 选项

Focus

表单获得焦点时会触发该操作。
请参阅下面的 选项

Submit

提交表单时会触发该操作。
请参阅下面的 选项

键盘

Key Press

按下某个键时会触发该事件。
请参阅下面的 选项

媒体

Media Ended

媒体结束时会触发该事件。
请参阅下面的 选项

Media Loaded Data

媒体加载数据时会触发该事件。
请参阅下面的 选项

Media Pause

暂停媒体时会触发该事件。
请参阅下面的 选项

Media Play

播放媒体时会触发该事件。
请参阅下面的 选项

Media Stalled

媒体停止时会触发该事件。
请参阅下面的 选项

Media Time Played

如果媒体已播放指定的时长,则会触发该事件。
请参阅下面的 选项
此外,还应指定在特定时间段后触发该事件。

Media Volume Changed

如果音量升高或降低,则会触发该事件。
请参阅下面的 选项

移动设备

Orientation Change

如果设备的方向发生更改,则会触发该事件。
没有适用于此事件类型的设置。
此外,还应指定在特定时间段后触发该事件。

Zoom Change

如果用户执行放大或缩小操作,则会触发该事件。
没有适用于此事件类型的设置。

鼠标

Click

如果点击指定的元素,则会触发该事件。
(可选)您可以为元素指定在触发该事件之前必须为 true 的属性值。
如果元素是链接,您还可以指定是否将导航延迟到规则运行为止。单击复选框时,将会打开一个字段,您可以在其中输入所需的延迟(以毫秒为单位)。这会指定 Launch 在等待标记在已点击链接上触发时经过多长时间,才移至下一个页面。默认值为 100 毫秒。较长的延迟可提高跟踪准确性。Adobe 建议将延迟设置为等于或少于 500 毫秒,用户将不会察觉到这段延迟。Launch 将等待指定的时间,但如果信标先行触发,则延迟会被缩短。(也就是说,用户并不会总是等待延迟的全部时长。)
此外,还应指定在特定时间段后触发该事件。
有关高级选项,请参阅下面的 选项

Hover

如果用户将鼠标悬停在指定元素上,则会触发该事件。
请参阅下面的 选项
此外,还应配置规则是立即触发还是在指定的毫秒数后触发。

其他

Custom Event

如果发生自定义事件类型,则会触发该事件。
您可以命名在其他位置定义的 JavaScript 函数,并将其用于该事件。
指定自定义事件类型的名称,然后按照下面 选项 中所述配置其他设置。

Data Element Changed

如果指定的数据元素发生更改,则会触发该事件。
输入数据元素名称。您可以从列表中选择数据元素,方法是单击相应图标,然后选择数据元素。

Direct Call

旨在绕过事件检测和查找系统。
直接调用规则最适合您希望准确告知 Launch 当前发生事件的情况。此外,它们还适用于 Launch 在 DOM 中检测不到事件的情况,例如与 Adobe Flash 有关的事件。
指定 _satellite.track 字符串。

Element Exists

如果存在指定的元素,则会触发该事件。
请参阅下面的 选项

Enters Viewport

如果用户进入指定的视区,则会触发该事件。
请参阅下面的 选项
此外,还应配置规则是立即触发还是在指定的毫秒数后触发。

History Change

如果发生 pushState 或 hashchange,则会触发该事件。
没有适用于此事件类型的设置。

Time Spent on Page

如果用户在页面上停留指定的秒数,则会触发该事件。
指定触发该事件之前必须经过的秒数。

页面加载

DOM Ready

当 DOM 已就绪并且用户可以与页面交互时会触发该事件
没有适用于此事件类型的设置。

Library Loaded (Page Top)

加载 Launch 库后会立即触发该事件。
没有适用于此事件类型的设置。

Page Bottom

调用 _satellite.pageBottom(); 后会触发该事件。异步加载 Launch 库时,不应使用此事件类型。
没有适用于此事件类型的设置。

Window Loaded

当浏览器调用了 onLoad 并且页面完成了加载时会触发该事件。
没有适用于此事件类型的设置。

选项

每个表单事件类型都使用以下设置:

Specific Elements \| Any Element

  • 如果选择 Specific Elements ,则会显示用于选择元素和属性值的选项。
  • 如果选择 Any Element ,则无需显示其他选项来缩小元素范围。

Elements matching the CSS selector

输入用于标识将会触发事件的元素的 CSS 选择器。

And having certain property values

如果选择此选项,则以下参数将变为可用:
  • property=value
    指定属性的值
  • Regex
    如果 property=value 是正则表达式,则启用此选项。
  • Add
    添加其他 property=value 对。

Advanced options (Bubbling)

  • 即使事件源自子元素,也运行此规则
  • 即使事件已触发针对子元素的规则,也允许运行此规则
  • 此规则运行后,阻止事件触发针对父元素的规则

核心扩展条件类型

此部分介绍核心扩展中可用的条件类型。

数据

Custom Code

指定必须作为事件条件存在的任何自定义代码。使用内置代码编辑器输入自定义代码。
  1. 单击 Open Editor
  2. 键入自定义代码。
  3. 单击 Save
将自动提供一个名为 event 的变量,您可以从自定义代码中引用该变量。 event 对象将包含有关触发规则的事件的有用信息。确定哪些事件数据可用的最简单方法是从自定义代码中将 event 记录到控制台:
console.log(event);
return true;

在浏览器中运行规则,并在浏览器控制台中检查已记录的事件对象。了解了哪些信息可用后,您便可以将其用于自定义代码中的程序化决策。

Value Comparison

比较两个值以确定此条件是否返回 true。
假设您有一个包含多个条件的规则,此条件可能会返回 true,但是由于其他条件评估为 false 或其中一个例外评估为 true,因此该规则仍不会触发。
  1. 提供一个值。
  2. 选择运算符。有关更多详细信息,请参阅下面的值比较运算符列表。
  3. (如果需要)选择比较是否应区分大小写。
  4. 提供另一个要比较的值。
可以使用以下值比较运算符:
Equal: ​如果使用非严格比较后认为两个值相等,则该条件会返回 true(在 JavaScript 中,运算符为 ==)。值可以是任何类型。在值字段中输入 true false null undefined 之类的词时,该词将作为字符串进行比较,而不会转换为其 JavaScript 等效字符。
Does Not Equal: ​如果使用非严格比较后认为两个值不相等,则该条件会返回 true(在 JavaScript 中,运算符为 !=)。值可以是任何类型。在值字段中输入 true false null undefined 之类的词时,该词将作为字符串进行比较,而不会转换为其 JavaScript 等效字符。
Contains: ​如果第一个值包含第二个值,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 false。
Does Not Contain: ​如果第一个值不包含第二个值,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 true。
Starts With: ​如果第一个值以第二个值开头,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 false。
Does Not Start With: ​如果第一个值不以第二个值开头,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 true。
Ends With: ​如果第一个值以第二个值结尾,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 false。
Does Not End With: ​如果第一个值不以第二个值结尾,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 true。
Matches Regex: ​如果第一个值匹配正则表达式,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 false。
Does Not Match Regex: ​如果第一个值不匹配正则表达式,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 true。
Is Less Than: ​如果第一个值小于第二个值,则该条件会返回 true。表示数字的字符串将转换为数字。除数字或可转换字符串之外的任何其他值都会导致该条件返回 false。
Is Less Than Or Equal To: ​如果第一个值小于或等于第二个值,则该条件会返回 true。表示数字的字符串将转换为数字。除数字或可转换字符串之外的任何其他值都会导致该条件返回 false。
Is Greater Than: ​如果第一个值大于第二个值,则该条件会返回 true。表示数字的字符串将转换为数字。除数字或可转换字符串之外的任何其他值都会导致该条件返回 false。
Is Greater Than Or Equal To: ​如果第一个值大于或等于第二个值,则该条件会返回 true。表示数字的字符串将转换为数字。除数字或可转换字符串之外的任何其他值都会导致该条件返回 false。
Is True: ​如果提供的值是值为 true 的布尔值,则该条件会返回 true。如果您提供的值是任何其他类型,则不会将该值转换为布尔值。除值为 true 的布尔值之外的任何其他值都会导致该条件返回 false。
Is Truthy: ​如果提供的值在转换为布尔值后为 true,则该条件会返回 true。有关 truthy 值的示例,请参阅 MDN 的 Truthy 文档
Is False: ​如果提供的值是值为 false 的布尔值,则该条件会返回 true。如果您提供的值是任何其他类型,则不会将该值转换为布尔值。除值为 false 的布尔值之外的任何其他值都会导致该条件返回 false。
Is Falsy: ​如果提供的值在转换为布尔值后为 false,则该条件会返回 true。有关 falsy 值的示例,请参阅 MDN 的 Falsy 文档

Variable

指定要使事件触发操作而必须存在的 JavaScript 变量名称和值。
  1. 指定 JavaScript 变量名称。
  2. 指定必须作为事件条件存在的变量值。
  3. (可选)如果这是正则表达式,则启用 Regex。

参与度

Landing Page

指定用户必须登陆才能触发事件的页面。
  1. 指定登陆页面。
  2. (可选)如果这是正则表达式,则启用 Regex。

New/Returning Visitor

指定要使事件触发操作,访客应该是新访客还是回访访客。
选择下列选项之一:
  • New Visitor
  • Returning Visitor

Page Views

配置在触发操作之前访客必须查看页面的次数。
  1. 选择页面查看次数是必须大于、等于还是小于指定的值。
  2. 指定用于确定是否满足条件的页面查看次数。
  3. 通过选择以下任一选项来配置何时计数页面查看次数:
    • Lifetime
    • Current Session

Sessions

如果用户的会话数满足指定的标准,则会触发操作。
  1. 选择会话数是必须大于、等于还是小于指定的值。
  2. 指定用于确定是否满足条件的会话数。

Time On Site

如果用户的会话数满足指定的标准,则会触发操作。
配置在触发操作之前访客必须在网站上停留的时长。
  1. 选择访客在网站上停留的分钟数是必须大于、等于还是小于指定的值。
  2. 指定用于确定是否满足条件的分钟数。

Traffic Source

如果用户的会话数满足指定的标准,则会触发操作。
指定要使操作能够触发,必须为 true 的访客流量源。
  1. 指定流量源。
  2. (可选)如果这是正则表达式,则启用 Regex。

其他

Date Range

指定日期范围。选择发生事件的日期和时间范围以及时区。

Max Frequency

指定条件会返回 true 的最大次数。您可以从下列选项中进行选择:
  • Page view
  • Sessions
  • Visitor
  • Seconds
  • Minutes
  • Days
  • Weeks
  • Months

Sampling

指定条件会返回 true 的次数百分比。

技术

Browser

选择要使操作能够触发,访客必须使用的浏览器。
选择以下一种或多种浏览器:
  • Chrome
  • Firefox
  • Internet Explorer/Edge
  • Internet Explorer Mobile
  • Mobile Safari
  • OmniWeb
  • Opera
  • Opera Mini
  • Opera Mobile
  • Safari

Device Type

选择要使操作能够触发,访客必须使用的设备类型。
选择以下一种或多种设备类型:
  • Android
  • Blackberry
  • 台式机
  • iPad
  • iPhone
  • iPod
  • Nokia
  • Windows Phone

Operating System

选择要使操作能够触发,访客必须使用的操作系统。
选择以下一种或多种操作系统:
  • Android
  • Blackberry
  • iOS
  • Linux
  • MacOS
  • Maemo
  • Symbian OS
  • Unix
  • Windows

Screen Resolution

选择要使操作能够触发,访客必须在其设备上使用的屏幕分辨率。
  1. 选择访客设备的屏幕分辨率宽度是必须大于、等于还是小于指定的值。
  2. 指定屏幕分辨率宽度所需的像素数。
  3. 选择访客设备的屏幕分辨率高度是必须大于、等于还是小于指定的值。
  4. 指定屏幕分辨率高度所需的像素数。

Window Size

选择要使操作能够触发,访客必须在其设备上使用的窗口大小。
  1. 选择访客设备的窗口大小宽度是必须大于、等于还是小于指定的值。
  2. 指定窗口大小宽度所需的像素数。
  3. 选择访客设备的窗口大小高度是必须大于、等于还是小于指定的值。
  4. 指定窗口大小高度所需的像素数。

URL

Domain

指定访客的域。

Hash

指定 URL 中必须存在的一个或多个哈希模式。
使用 OR 连接多个哈希模式。
  1. 指定哈希模式。
  2. (可选)如果这是正则表达式,则启用 Regex。
  3. 添加任何其他哈希模式。

Path

指定 URL 中必须存在的一个或多个路径。
使用 OR 连接多个路径。
  1. 指定路径。
  2. (可选)如果这是正则表达式,则启用 Regex。
  3. 添加任何其他路径。

Protocol

指定 URL 中使用的协议。
选择下列选项之一:
  • HTTP
  • HTTPS

Subdomain

指定 URL 中必须存在的一个或多个子域。
使用 OR 连接多个子域。
  1. 指定子域。
  2. (可选)如果这是正则表达式,则启用 Regex。
  3. 添加任何其他子域。

URL Parameter

指定 URL 中使用的 URL 参数。
  1. 指定 URL 参数名称。
  2. 指定用于 URL 参数的值。
  3. (可选)如果这是正则表达式,则启用 Regex。

核心扩展例外类型

此部分介绍核心扩展中可用的例外类型。

数据

Custom Code

指定必须作为事件条件存在的任何自定义代码。使用内置代码编辑器输入自定义代码。
  1. 单击 Open Editor
  2. 键入自定义代码。
  3. 单击 Save
将自动提供一个名为 event 的变量,您可以从自定义代码中引用该变量。 event 对象将包含有关触发规则的事件的有用信息。确定哪些事件数据可用的最简单方法是从自定义代码中将 event 记录到控制台:
console.log(event);
return true;

在浏览器中运行规则,并在浏览器控制台中检查已记录的事件对象。了解了哪些信息可用后,您便可以将其用于自定义代码中的程序化决策。

Value Comparison

比较两个值以确定此例外是否返回 true。
假设您有一个包含多个条件的规则,此条件可能会返回 true,但是由于其他条件评估为 false 或其中一个例外评估为 true,因此该规则仍不会触发。
  1. 提供一个值。
  2. 选择运算符。有关更多详细信息,请参阅下面的值比较运算符列表。
  3. (如果需要)选择比较是否应区分大小写。
  4. 提供另一个要比较的值。
可以使用以下值比较运算符:
Equal: ​如果使用非严格比较后认为两个值相等,则该条件会返回 true(在 JavaScript 中,运算符为 ==)。值可以是任何类型。在值字段中输入 true false null undefined 之类的词时,该词将作为字符串进行比较,而不会转换为其 JavaScript 等效字符。
Does Not Equal: ​如果使用非严格比较后认为两个值不相等,则该条件会返回 true(在 JavaScript 中,运算符为 !=)。值可以是任何类型。在值字段中输入 true false null undefined 之类的词时,该词将作为字符串进行比较,而不会转换为其 JavaScript 等效字符。
Contains: ​如果第一个值包含第二个值,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 false。
Does Not Contain: ​如果第一个值不包含第二个值,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 true。
Starts With: ​如果第一个值以第二个值开头,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 false。
Does Not Start With: ​如果第一个值不以第二个值开头,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 true。
Ends With: ​如果第一个值以第二个值结尾,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 false。
Does Not End With: ​如果第一个值不以第二个值结尾,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 true。
Matches Regex: ​如果第一个值匹配正则表达式,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 false。
Does Not Match Regex: ​如果第一个值不匹配正则表达式,则该条件会返回 true。数字将转换为字符串。除数字或字符串之外的任何其他值都会导致该条件返回 true。
Is Less Than: ​如果第一个值小于第二个值,则该条件会返回 true。表示数字的字符串将转换为数字。除数字或可转换字符串之外的任何其他值都会导致该条件返回 false。
Is Less Than Or Equal To: ​如果第一个值小于或等于第二个值,则该条件会返回 true。表示数字的字符串将转换为数字。除数字或可转换字符串之外的任何其他值都会导致该条件返回 false。
Is Greater Than: ​如果第一个值大于第二个值,则该条件会返回 true。表示数字的字符串将转换为数字。除数字或可转换字符串之外的任何其他值都会导致该条件返回 false。
Is Greater Than Or Equal To: ​如果第一个值大于或等于第二个值,则该条件会返回 true。表示数字的字符串将转换为数字。除数字或可转换字符串之外的任何其他值都会导致该条件返回 false。
Is True: ​如果提供的值是值为 true 的布尔值,则该条件会返回 true。如果您提供的值是任何其他类型,则不会将该值转换为布尔值。除值为 true 的布尔值之外的任何其他值都会导致该条件返回 false。
Is Truthy: ​如果提供的值在转换为布尔值后为 true,则该条件会返回 true。有关 truthy 值的示例,请参阅 MDN 的 Truthy 文档
Is False: ​如果提供的值是值为 false 的布尔值,则该条件会返回 true。如果您提供的值是任何其他类型,则不会将该值转换为布尔值。除值为 false 的布尔值之外的任何其他值都会导致该条件返回 false。
Is Falsy: ​如果提供的值在转换为布尔值后为 false,则该条件会返回 true。有关 falsy 值的示例,请参阅 MDN 的 Falsy 文档

Variable

指定要使事件触发操作而不能存在的 JavaScript 变量名称和值。
  1. 指定 JavaScript 变量名称。
  2. 指定不能作为事件条件存在的变量值。
  3. (可选)如果这是正则表达式,则启用 Regex。

参与度

Landing Page

指定要触发事件,用户不能登陆的页面。
  1. 指定登陆页面。
  2. (可选)如果这是正则表达式,则启用 Regex。

New/Returning Visitor

指定要使事件触发操作,访客不应是新访客还是不应是回访访客。
选择下列选项之一:
  • New Visitor
  • Returning Visitor

Page Views

配置要阻止触发操作,访客必须查看页面的次数。
  1. 选择页面查看次数是必须大于、等于还是小于指定的值。
  2. 指定用于确定是否满足例外条件的页面查看次数。
  3. 通过选择以下任一选项来配置何时计数页面查看次数:
    • Lifetime
    • Current Session

Sessions

如果用户的会话数满足指定的标准,则不会触发操作。
  1. 选择会话数是必须大于、等于还是小于指定的值。
  2. 指定用于确定是否满足条件的会话数。

Time On Site

配置要阻止触发操作,访客必须在网站上停留的时长。
  1. 选择访客在网站上停留的分钟数是必须大于、等于还是小于指定的值。
  2. 指定用于确定是否满足条件的分钟数。

Traffic Source

指定要阻止触发操作,必须为 true 的访客流量源。
  1. 指定流量源。
  2. (可选)如果这是正则表达式,则启用 Regex。

其他

Date Range

指定日期范围。选择发生事件的日期和时间范围以及时区。

Max Frequency

指定条件会返回 true 的最大次数。您可以从下列选项中进行选择:
  • Page view
  • Sessions
  • Visitor
  • Seconds
  • Minutes
  • Days
  • Weeks
  • Months

Sampling

指定条件会返回 true 的次数百分比。

技术

Browser

选择要使操作能够触发,访客不能使用的浏览器。
选择以下一种或多种浏览器:
  • Chrome
  • Firefox
  • Internet Explorer/Edge
  • Internet Explorer Mobile
  • Mobile Safari
  • OmniWeb
  • Opera
  • Opera Mini
  • Opera Mobile
  • Safari

Device Type

选择要使操作能够触发,访客不能使用的设备类型。
选择以下一种或多种设备类型:
  • Android
  • Blackberry
  • 台式机
  • iPad
  • iPhone
  • iPod
  • Nokia
  • Windows Phone

Operating System

选择要使操作能够触发,访客不能使用的操作系统。
选择以下一种或多种操作系统:
  • Android
  • Blackberry
  • iOS
  • Linux
  • MacOS
  • Maemo
  • Symbian OS
  • Unix
  • Windows

Screen Resolution

选择要使操作能够触发,访客不能在其设备上使用的屏幕分辨率。
  1. 选择访客设备的屏幕分辨率宽度是必须大于、等于还是小于指定的值。
  2. 指定屏幕分辨率宽度所需的像素数。
  3. 选择访客设备的屏幕分辨率高度是必须大于、等于还是小于指定的值。
  4. 指定屏幕分辨率高度所需的像素数。

Window Size

选择要使操作能够触发,访客不能在其设备上使用的窗口大小。
  1. 选择访客设备的窗口大小宽度是必须大于、等于还是小于指定的值。
  2. 指定窗口大小宽度所需的像素数。
  3. 选择访客设备的窗口大小高度是必须大于、等于还是小于指定的值。
  4. 指定窗口大小高度所需的像素数。

URL

Domain

指定将阻止触发操作的访客域。

Hash

指定 URL 中不能存在的一个或多个哈希模式。
使用 OR 连接多个哈希模式。
  1. 指定哈希模式。
  2. (可选)如果这是正则表达式,则启用 Regex。
  3. 添加任何其他哈希模式。

Path

指定 URL 中不能存在的一个或多个路径。
使用 OR 连接多个路径。
  1. 指定路径。
  2. (可选)如果这是正则表达式,则启用 Regex。
  3. 添加任何其他路径。

Protocol

指定 URL 中不能使用的协议。
选择下列选项之一:
  • HTTP
  • HTTPS

Subdomain

指定 URL 中不能存在的一个或多个子域。
使用 OR 连接多个子域。
  1. 指定子域。
  2. (可选)如果这是正则表达式,则启用 Regex。
  3. 添加任何其他子域。

URL Parameter

指定 URL 中不能使用的 URL 参数。
  1. 指定 URL 参数名称。
  2. 指定用于 URL 参数的值。
  3. (可选)如果这是正则表达式,则启用 Regex。

核心扩展操作类型

此部分介绍核心扩展中可用的操作类型。

Custom Code

提供在触发事件并评估条件后运行的代码。
  1. 命名操作代码。
  2. 选择用于定义操作的语言:
    • JavaScript
    • HTML
  3. 选择是否要全局执行操作代码。
  4. 单击 Open Editor。
  5. 编辑代码,然后单击 Save。
选择 JavaScript 作为语言时,将自动提供一个名为 event 的变量,您可以从自定义代码中引用该变量。 event 对象将包含有关触发规则的事件的有用信息。确定哪些事件数据可用的最简单方法是从自定义代码中将 event 记录到控制台:
console.log(event);

在浏览器中运行规则,并在浏览器控制台中检查已记录的事件对象。了解哪些信息可用后,您便可以将其用于自定义代码中的程序化决策,将一段 event 对象发送到服务器等。

Custom Code 操作处理

适用于所有 Launch 用户的核心扩展包含用于执行用户提供的 JavaScript 或 HTML 的 Custom Code 操作。通常,了解如何处理具有 Custom Code 操作的规则对用户很有用。

使用 page top 或 page bottom 事件的规则

自定义操作的代码会嵌入在主 Launch 库中。该代码将使用 document.write 写入文档。如果规则具有多个 Custom Code 操作,则该代码将按规则中配置的顺序写入。

使用除 page top 或 page bottom 以外的任何事件的规则

自定义操作的代码将从服务器加载并使用 Postscribe 写入文档。如果规则具有多个 Custom Code 操作,则该代码将从服务器并行加载,但会按照规则中配置的顺序写入。
虽然在加载页面后使用 document.write 通常会出现问题,但对于通过 Custom Code 操作提供的代码来说,这并不是问题。无论何时执行代码,您都可以在 Custom Code 操作中使用 document.write。

自定义代码验证

Launch 代码编辑器中使用的验证器可识别开发人员编写的代码中存在的问题。经过缩小的代码(例如从代码管理器中下载的 AppMeasurement.js 代码)可能会被 Launch 验证器错误地标记为存在问题,这通常可以忽略不计。

核心扩展数据元素类型

数据元素类型由扩展决定。对于可创建的类型,没有任何限制。
以下部分介绍核心扩展中可用的数据元素类型。其他扩展则使用其他数据元素类型。

常量

随后可在操作或条件中引用的任何常数字符串值。

示例:

string

自定义代码

通过单击 Open Editor 并将代码插入编辑器窗口,可以将自定义 JavaScript 输入到用户界面中。
编辑器窗口中需要一个返回语句,以指示应该将什么值用作数据元素值。如果不包括返回语句或返回了值 null undefined ,则将使用数据元素的默认值作为数据元素值。
示例:
var pageType = $('div.page-wrapper').attr('class').split('')[1];
if (window.location.pathname == '/') {
  return 'homepage';
} else {
  return pageType;
}

如果在规则执行时检索自定义代码数据元素,则将自动提供一个名为 event 的变量,您可以从自定义代码中引用该变量。 event 对象将包含有关触发规则的事件的有用信息。确定哪些事件数据可用的最简单方法是从自定义代码中将 event 记录到控制台:
console.log(event);
return true;

在浏览器中运行规则,并在浏览器控制台中检查已记录的事件对象。了解可能使用您的数据元素的各种规则下哪些信息可用后,您便可以将其用于自定义代码中的程序化决策,或返回一段 event 对象作为数据元素的值。

DOM 属性

可以检索任何元素值,例如 div 或 H1 标记。

示例:

CSS 选择器链:
id#dc logo img
获取以下元素的值:
src

JavaScript 变量

可以使用路径字段引用任何可用的 JavaScript 对象或变量。
当您在标记中包含 JavaScript 变量或对象属性,并且希望在 Launch 中收集这些值以与任何扩展或规则一起使用时,一种获取这些值的方式是在 Launch 中使用数据元素。这样,您就可以在整个规则中引用数据元素,并且如果数据源发生更改,您只需在 Launch 中的一处位置更改对该源(数据元素)的引用即可。
例如,假定您的标记包含一个名为 Page_Name 的 JavaScript 变量,如下所示:
<script>
  //data layer
  var Page_Name = "Homepage"
</script>

在 Launch 中创建数据元素时,只需提供该变量的路径。
如果您使用数据收集器对象作为数据层的一部分,则只需在路径中使用点表示法来引用要捕获到数据元素中的对象和属性即可,如 _myData.pageName digitalData.pageName 等。

示例:

window.document.title

本地存储

在 Local Storage Item Name 字段中提供本地存储项目的名称。
本地存储允许浏览器将信息从一个页面存储到另一个页面 ( https://www.w3schools.com/html/html5\_webstorage.asp )。本地存储的工作方式与 Cookie 非常类似,只是其存储空间更大,存储方式更灵活。
使用提供的字段指定您为本地存储项目创建的值,例如 lastProductViewed.

页面信息

使用这些数据点捕获页面信息,以将其用在规则逻辑中,或者将信息发送到 Analytics 或外部跟踪系统。
您可以选择以下任一页面属性,以将其用在数据元素中:
  • URL
  • 主机名
  • 路径名
  • 协议
  • 反向链接
  • 标题

查询字符串参数

在 URL Parameter 字段中指定单个 URL 参数。
只有名称部分是必填的,任何类似于“?”或“=”的特殊指示符都应被忽略。

示例:

contentType

随机数

使用此数据元素可生成一个随机数。随机数通常用于对数据采样或创建 ID,例如点击 ID。随机数也可用于对敏感数据进行模糊或加盐处理。一些示例可能包括:
  • 生成点击 ID
  • 将数字连接到用户令牌或时间戳以确保唯一性
  • 对 PII 数据执行单向哈希处理
  • 随机确定在网站上显示调查请求的时间
指定随机数的最小值和最大值。
默认值:
最小值:0
最大值:1000000000

会话存储

在 Session Storage Item Name 字段中提供会话存储项目的名称。
会话存储类似于本地存储,不同之处在于,会话存储在会话结束后会丢弃数据,而本地存储或 Cookie 则可以保留数据。

访客行为

与页面信息类似,此数据元素使用常见行为类型来丰富规则或数据收集中的逻辑。
选择以下任一访客行为属性:
  • 登陆页面
  • 流量源
  • 网站逗留分钟数
  • 会话计数
  • 会话页面查看计数
  • 存留期页面查看计数
  • 是新访客
一些常见用例包括:
  • 当访客在网站上停留五分钟后,显示调查结果
  • 如果访问的是登陆页面,则填充 Analytics 量度
  • 在 X 个会话计数后向访客显示新选件
  • 如果访客是首次来访访客,则显示新闻稿注册页面