文档TargetTarget 指南

配置文件和变量一览表

最近更新: 2025年5月5日
  • 主题:
  • 受众

此页面列出了配置文件脚本中有用的配置文件、变量和参数。

内置配置文件

配置文件注释
user.activeActivities
user.activeCampaigns
返回用户参与的所有营销活动/活动的 ID,即使用户未在当前会话中与营销活动/活动进行交互。
user.pcId
user.sessionId
user.categoryAffinity
user.categoryAffinities返回访客填充的一组喜好。
user.isFirstSession
user.isNewSession
user.daysSinceLastVisit
user.browser用户代理
user.browserType返回浏览器类型,例如safari、chrome等。
user.header所有 user.header 配置文件均从 mbox 请求标头数据内置
user.header('x-forwarded-for')访客所在网络连接的公共 IP 地址。
您可以通过多种方式获取此地址,例如whatismyip.com。 此 IP 地址不是以 10.、192.168. 或 172. 开头的 NAT 地址(内部地址)。
注意:已弃用user.header('x-cluster-client-ip')。
user.header('host')网站主机名
user.header('cookie')访客 Cookie 数据
user.header('user-agent')访客浏览器用户代理
user.header('accept-language')访客语言
user.header('accept-encoding')访客字符编码
user.header('accept')访客语言和字符编码
user.header('connection')服务器连接。例如:keep-live
user.header('referrer')访客当前页面的网站 URL。不适用于 Internet Explorer。
user.getLocal('param_name');检索您使用user.setLocal设置的值。
user.setLocal('param_name','value')在配置文件脚本中创建保留的配置文件值。 这些值就像配置文件脚本一样持续存在,但您只能在设置它的脚本中访问它。
user.get('param_name')
user.parameter从配置文件脚本创建的永久性配置文件属性。还引用“系统”配置文件,如地理位置、访问计数等。
profile.get('param_name')获取要在配置文件脚本中使用的配置文件参数的正确方法是profile.get('param_name')方法。
profile.param('param_name');
profile.parameter('parameter_name');因带有 profile. 前缀而使其具有持久性的 mbox 参数。
profile.browserTime访客的本地浏览器时间。对于系统时间,在配置文件脚本中创建新的日期对象
profile.averageDaysBetweenVisits
profile.sessionCount
profile.mobile.isTablet

访客设备是平板电脑。

注意:此配置文件取代了已弃用的旧版浏览器iPad受众类别。 有关详细信息,请参阅浏览器。

profile.mobile.isMobilePhone

访客设备是移动电话。

注意:此配置文件取代了已弃用的旧版浏览器iPhone受众类别。 有关详细信息,请参阅浏览器。

parameter=通过 mbox 传递的其他值的统称,通常为名称/值对。不具有持久性,除非使用 profile.parameter 或 user.parameter 设定了持久性。

URL 变量

landingreferrerpage
landing.urlreferrer.urlpage.url
landing.domainreferrer.domainpage.domain
landing.protocolreferrer.protocolpage.protocol
landing.paramreferrer.parampage.param
landing.queryreferrer.querypage.query

地域和移动设备运营商配置文件

  • profile.geolocation.country
  • profile.geolocation.state
  • profile.geolocation.city
  • profile.geolocation.zip
  • profile.geolocation.dma
  • profile.geolocation.domainName
  • profile.geolocation.ispName
  • profile.geolocation.connectionSpeed
  • profile.geolocation.mobileCarrier
  • profile.geolocation.latitude
  • profile.geolocation.longitude

Mbox 变量

变量
注释
mbox.name
mbox.param('param_name')

与每个请求一起自动传递的参数:

  • mbox.param('browserHeight')
  • mbox.param('browserTimeOffset')
  • mbox.param('browserWidth')
  • mbox.param('colorDepth')
  • mbox.param('mboxXDomain')
  • mbox.param('mboxTime')
  • mbox.param('screenHeight')
  • mbox.param('screenWidth')

与订单 mbox 一起传递的参数:

  • mbox.param('orderId')
  • mbox.param('orderTotal')
  • mbox.param('productPurchasedId')
mbox3rdPartyId
用于将客户 ID 同步到 Target mboxPCID 的 mbox 参数。客户 ID 是指贵公司用于跟踪访客的 ID,例如 CRM ID、会员 ID 或诸如此类的 ID。然后,可以使用此ID通过配置文件API和客户属性添加信息。
mboxPageValue
在每个 mbox 调用中,都会为页面分配值。
mboxDebug
仅用于调试信息。已添加到at.js所查找的页面URL中。
mboxOverride.browserIp
设置与实际位置不同的地理位置,以便测试在其他位置时的情况。
注意: mboxOverride 参数仅应在测试活动时使用,而不应在生产中使用。使用 Analytics for Target (A4T) 时,使用任何 mboxOverride 参数都可能导致报表不一致。您应使用活动 QA 模式,以确保活动在推送到实时环境之前可以按预期方式运行。

客户属性

可以在配置文件脚本中引用客户属性,格式如下:crs.get('<Datasource Name>.<Attribute name>')。

这些属性还可用作配置文件脚本中的令牌,以及直接用作选件中的令牌,而无需首先设置配置文件脚本。令牌应使用以下格式: ${crs.datasourceName.attributeName}。 请注意,应从任何API调用中移除datasourceName中的空格。

recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654