回传宏&功能

以下列表显示 Branch 在 Postback URL 和 Webhooks 中支持的宏和可用功能。当您使用这些宏和函数时,Branch 会在通知指定的回传 URL 之前动态解析/替换它们的相应值。

URL 宏

我们已根据要收集的信息类型对宏进行了分类。

📘

使用函数修改回传宏

您可以使用各种回传 URL 函数对所有回传宏进行哈希/加密/修改。有关适用于以下回传宏的可用回传 URL 函数的信息,请参见下面的 URL 函数宏(URL Function Macros)部分。

回传数据

以下宏表示与回传事件本身相关的高级数据点。

回传数据

${(name)!} | string

Webhook 事件名称:impression / click / web_to_app_auto_redirect / branch_cta_view / sms_sent / open / install / reinstall / web_session_start / pageview / add_to_cart / add_to_wishlist / view_cart / initiate_purchase / add_payment_info / purchase / spend_credits / reserve / click_ad / view_ad / search / view_item / view_items / rate / share / complete_registration / complete_tutorial / achieve_level / unlock_achievement / invite / login / subscribe / start_trial / 还支持自定义名称。

${(customer_event_alias)!} | string

客户提供事件的别名;除了在 name 字段中定义的标准 Branch 名称之外,还使用其他名称。这仅适用于 TUNE 客户。

${(organization_id)!} | fixed64

与事件发生组织相关的 ID;由 Branch 分配。 TUNE 等效宏{advertiser_id}

${(organization_name)!} | string

事件发生组织的名称;在帐户设置过程中提供。 TUNE 等效宏{advertiser_name}

${(tune_site_name)!} | string

TUNE 应用的名称;例如 "Star Sentinel"。 TUNE 等效宏{site_name}

${(tune_site_id)!} | fixed64

与 TUNE 应用相关的 ID;由 TUNE 分配。 TUNE 等效宏{site_id}

${(tune_site_event_id)!} | uint64

与 TUNE app 事件相关的 ID;由 TUNE 分配。 TUNE 等效宏{site_event_id}

${(event_timestamp)!} | fixed64

事件的 UNIX 时间戳(以毫秒为单位);服务器端自动设置。 TUNE 等效宏 {timestamp}.

${(origin)!} | Origin

记录归因的位置:branch / segment / mparticle / tune。

${(id)!} | string

与事件相关的 ID;由 Branch 分配。

<#if attributed>1<#else>0</#if> | bool

事件是否被归因; 1 (true/yes) 或 0 (false/no)

${(days_from_last_attributed_touch_to_event)!} | int32

最后归因触点和事件之间的天数。

${(hours_from_last_attributed_touch_to_event)!} | int32

最后归因触点和事件之间的小时数;上限为24。

${(minutes_from_last_attributed_touch_to_event)!} | int32

最后归因触点和事件之间的分钟数;上限为60。

${(seconds_from_last_attributed_touch_to_event)!} | int32

最后归因触点和事件之间的秒数;上限为60。

${(last_attributed_touch_type)!} | AttributedTouchType

click / web_to_app_redirect / impression

${(last_attributed_touch_timestamp)!} | fixed64

最后归因触点的 UNIX 时间戳(以毫秒为单位);服务器端自动设置。

${(di_match_click_token)!} | fixed64

Branch Flow ID,其被用于 Tune,Appsflyer 等以对点击与安装进行匹配,使用 Android install referrer;设置服务器端,由客户端中继。

${last_cta_view_timestamp)!} | fixed64

上一次 Branch CTA 视图的 UNIX 时间戳(以毫秒为单位)。服务器端自动设置。

<#if deep_linked>1<#else>0</#if> | bool

当前的应用或 Web 会话是否导致用户被深度链接。服务器端自动设置;1 (true/yes) 或 0 (false/no)。

<#if first_event_for_user>1<#else>0</#if> | bool

对于此 Persona (同人用户),这是否是第一次触发此事件。服务器端自动设置;1 (true/yes) 或 0 (false/no)。

${(store_install_begin_timestamp)!} | fixed64

在 Play Store / App Store 中点击安装按钮的时间。

${(referrer_click_timestamp)!} | fixed64

Play Store 启动时间(仅适用于 Android)

<#if existing_user>1<#else>0</#if> | bool

与事件相关的用户是既存用户还是新用户; 1 (true/yes) 或 0 (false/no)

${(webhook_id)!} | fixed64

Webhook 本身的 ID;由 Branch 分配。

${(webhook_partner_key)!} | string

Branch 发送有效负载的机器可读伙伴名称;服务器端自动设置。

${(app_id)!} | string

与事件相关的 Branch 应用 ID;由 Branch 分配。

归因触点数据

以下宏表示与广告 campaign 本身相关的数据点。

归因触点数据

${(last_attributed_touch_data.~id)!} | fixed64

最后归因触点 ID(仅适用于 Quick Link)。服务器端自动设置。

${(last_attributed_touch_data.~campaign)!} | string

为最后归因触点指定的 campaign(名称)。可以由客户端在链接上指定,或者在某些情况下可以在服务器端自动预填充。

${(last_attributed_touch_data.~campaign_id)!} | string

为最后归因触点指定的 campaign ID。服务器端自动设置。

${(last_attributed_touch_data.~campaign_type)!} | string

Google campaign 类型; Google AAP 字段。服务器端自动设置。

${(last_attributed_touch_data.~customer_campaign)!} | string

为最后归因触点指定的客户 campaign。可以由客户端在链接上指定。 TUNE 等效宏 {my_campaign}{my_campaign_name}

${(last_attributed_touch_data.~channel)!} | string

为最后归因触点指定的渠道。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预先填充。

${(last_attributed_touch_data.~feature)!} | string

为最后归因触点指定的功能。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预先填充。

${(last_attributed_touch_data.~stage)!} | string

为最后归因触点指定的阶段。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预先填充。

${(last_attributed_touch_data.~tags)!} | string

为最后归因触点指定的标签。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。

${(last_attributed_touch_data.~advertising_partner_name)!} | string

为最后归因触点指定的可读广告合作伙伴名称。服务器端自动设置。

${(last_attributed_touch_data.~advertising_partner_id)!} | string

为最后归因触点指定的广告合作伙伴 ID。服务器端自动设置或由客户端指定。目前,特定于从 TUNE 迁移的合作伙伴。 TUNE 等效宏 {ad_network_id}

${(last_attributed_touch_data.~secondary_publisher)!} | string

为最后归因触点指定的子发行商。由广告平台传递。

${(last_attributed_touch_data.~secondary_publisher_id)!} | string

为最后归因触点指定的子发行商 ID。由广告平台传递。

${(last_attributed_touch_data.~customer_secondary_publisher)!} | string

为最后归因触点指定的子发行商 ID。由广告平台传递。 TUNE 等效宏 {my_publisher}{my_publisher_name}

${(last_attributed_touch_data.~creative_name)!} | string

为最后归因触点指定的广告素材名称。服务器端自动设置。

${(last_attributed_touch_data.~creative_id)!} | string

为最后归因触点指定的广告素材 ID。服务器端自动设置。

${(last_attributed_touch_data.~ad_set_name)!} | string

为最后归因触点指定的广告集合名称。服务器端自动设置。 TUNE 等效宏 {sub_adgroup_name}

${(last_attributed_touch_data.~ad_set_id)!} | string

为最后归因触点指定的广告集合 ID。服务器端自动设置。 TUNE 等效宏 {sub_adgroup}

${(last_attributed_touch_data.~customer_ad_set_name)!} | string

为最后归因触点指定的客户广告集合名称。可以由客户端在链接上指定。 TUNE 等效宏 {my_adgroup}{my_adgroup_name}

${(last_attributed_touch_data.~ad_name)!} | string

为最后归因触点指定的广告名称。服务器端自动设置。 TUNE 等效宏 {sub_ad_name}

${(last_attributed_touch_data.~ad_id)!} | string

为最后归因触点指定的广告 ID。服务器端自动设置。 TUNE 等效宏 {sub_ad}

${(last_attributed_touch_data.~customer_ad_name)!} | string

为最后归因触点指定的客户广告名称。可以由客户端在链接上指定。 TUNE 等效宏 {my_ad}{my_ad_name}

${(last_attributed_touch_data.~keyword)!} | string

为最后归因触点指定的关键字。服务器端自动设置。 TUNE 等效宏 {sub_keyword_name}

${(last_attributed_touch_data.~keyword_id)!} | string

由 Google 提供的最后触点关键字的唯一 ID。 TUNE 等效宏 {sub_keyword}

${(last_attributed_touch_data.~customer_keyword)!} | string

最后触点的客户关键字。可以由客户端在链接上指定。 TUNE 等效宏 {my_keyword}{my_keyword_name}

${(last_attributed_touch_data.~branch_ad_format)!} | string

最后触点的广告格式。在创建 Branch Link 时选择的广告格式,并将其设置为分析代码。例如,Search,Display,Product Ad,App only。

${(last_attributed_touch_data.~technology_partner)!} | string

最后触点的技术合作伙伴(带有分析标签)。除代理商外,用于促进 campaign 的任何第三方(例如,提供了受众,优化广告效果)。

${(last_attributed_touch_data.~banner_dimensions)!} | string

最后触点的显示横幅尺寸(带有分析标签)

${(last_attributed_touch_data.~placement)!} | string

最后触点的放置,由 Analytics 标签设置。广告在展示 campaign 中出现的实际应用或网站。 TUNE 等效宏 {sub_placement_name}

${(last_attributed_touch_data.~placement_id)!} | string

最后触点的放置 ID,由 Analytics 标签设置。广告在展示 campaign 中出现的实际应用或网站。 TUNE 等效宏 {sub_placement}

${(last_attributed_touch_data.~customer_placement)!} | string

客户指定的最后触点的放置,由 Analytics 标签设置。广告在展示 campaign 中出现的实际应用或网站。 TUNE 等效宏 {my_placement}{my_placement_name}

${(last_attributed_touch_data.~sub_site_name)!} | string

对显示广告网站的引用。由广告平台传递。 TUNE 等效宏 {sub_site_name}

${(last_attributed_touch_data.~customer_sub_site_name)!} | string

客户对显示广告网站的引用。可以由客户端在链接上指定。 TUNE 等效宏 {my_site}{my_site_name}

${(last_attributed_touch_data.~agency)!} | string

最后触点的代理商,由 Analytics 标签设置。代表广告主投放 campaign 的代理商。 TUNE 等效宏 {agency_name}

${(last_attributed_touch_data.~agency_id)!} | string

最后触点的代理商 ID,由 Analytics 标签设置。代表广告主投放 campaign 的代理商。 TUNE 等效宏 {agency_id}

${(last_attributed_touch_data.~tune_publisher_name)!} | string

最后触点的发行商名称。特定于 TUNE 的变量,用于一个客户的广告平台启用。通常,{last_attributed_touch_data_tilde_advertising_partner_name} 是更好使用的字段。TUNE 等效宏 {publisher_name}

${(last_attributed_touch_data.~tune_publisher_id)!} | fixed64

最后触点的发行商 ID。特定于 TUNE 的变量,用于一个客户的广告平台启用。通常,{last_attributed_touch_data_tilde_advertising_partner_name} 是更好使用的字段。TUNE 等效宏 {publisher_id}

${(last_attributed_touch_data.~tune_publisher_sub1)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。 TUNE 等效宏 {publisher_sub1}

${(last_attributed_touch_data.~tune_publisher_sub2)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。 TUNE 等效宏 {publisher_sub2}

${(last_attributed_touch_data.~tune_publisher_sub3)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。 TUNE 等效宏 {publisher_sub3}

${(last_attributed_touch_data.~tune_publisher_sub4)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。 TUNE 等效宏 {publisher_sub4}

${(last_attributed_touch_data.~tune_publisher_sub5)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。 TUNE 等效宏 {publisher_sub5}

${(last_attributed_touch_data.~optimization_model)!} | string

最后触点的优化模型(带有分析标签)。详细描述 campaign 进行优化事件的模型,例如 install,click,event。

${(last_attributed_touch_data.~secondary_ad_format)!} | string

最后触点的次级广告格式,由 Analytics 标签设置或在操作后台 (Dashboard)的广告链接创建流程中设置。广告合作伙伴特定的广告格式,例如 Google 的 Display Engagement Ad。

${(last_attributed_touch_data.~external_touch)!} | string

从第三方发送到 Branch 的点击或展示(视图)ID。用于将归因事件绑定到原始触点。如果归因伙伴是 Google SAN,则这将是 gclid 值。有关更多信息,请参见本表中的 gclid。

${(last_attributed_touch_data.~journey_name)!} | string

受众群体规则/Journey 的 “Campaign 名称”或“标题”。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预先填充。

${(last_attributed_touch_data.~journey_id)!} | string

Journey 的受众群体规则 ID。服务器端自动设置。

${(last_attributed_touch_data.~view_name)!} | string

Branch 视图/模板的“视图名称”或“标题”。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预先填充。

${(last_attributed_touch_data.~view_id)!} | string

Journey 的 Branch 视图 ID。服务器端自动设置。

${(last_attributed_touch_data.+referring_domain)!} | string

用户在登陆具有 Journey 的页面之前访问的 URL domain。这应使用我们用于 "came directly from a URL" 受众筛选器的相同数据源。它由客户端指定。

${(last_attributed_touch_data.dollar_3p)!} | string

设置事件是否源自 Google AMP 或 Facebook Instant Article 上的触点。由客户端指定。

${(last_attributed_touch_data.+web_format)!} | WebFormat

amp / Instant_articles

${(last_attributed_touch_data.+current_features)!} | BranchFeature

当前触点的 Branch 功能(由 Branch 确定)。服务器端自动设置; desktop_deepviews / desktop_journeys / mobile_deepviews / mobile_journeys / ads / email / social / quick_links

${(last_attributed_touch_data.+via_features)!} | BranchFeature

通过归因确定导致此事件的所有 Branch 功能(由 Branch 确定)。例如,如果点击电子邮件链接导致了指向应用的 Journey,则发布的 eo_open 将具有 +via_features: [EMAIL, JOURNEYS]。服务器端自动设置; desktop_deepviews / desktop_journeys / mobile_deepviews / mobile_journeys / ads / email / social / quick_links。

<#if last_attributed_touch_data.dollar_fb_data_terms_not_signed>1<#else>0</#if> | bool

如果未从 Facebook 签署移动数据条款,这意味着我们需要对外部事件隐藏归因相关内容。服务器端自动设置;1 (true/yes) 或 0 (false/no)

${(last_attributed_touch_data.+touch_id)!} | string

归因触点(展示,点击等)ID。

${(last_attributed_touch_data.custom_fields)!} | string

为最后触点指定且未被上述字段捕获的任何深度链接数据,例如 {foo:true,deeplink_path: id/12}. "custom_fields” 不应作为独立对象出现。这些值应包含在 last_attributed_touch_data 中。由客户端指定。

${(last_attributed_touch_data.user_data_ip)!} | string

用户设备的 IP 地址。

${(last_attributed_touch_data.user_data_user_agent)!} | string

User-Agent string 格式,包括产品名称,版本和系统(例如 “Mozilla/5.0 (iPad)”)。

${(last_attributed_touch_data.+device_brand_name)!} | string

用户设备的品牌或制造商(例如 “Apple” 或 “Samsung”);解析通过 HTTP header 发送的用户代理来确定。

${(last_attributed_touch_data.+device_brand_model)!} | string

用户设备的型号(例如 “Droid Pro”);解析通过 HTTP header 发送的用户代理来确定。

用户数据

以下宏表示转化时收集的用户/设备相关数据点。

用户数据

${(user_data.os)!} | OS

注册事件设备的操作系统;ios / android / mac_os / windows / windows_phone / amazon_fire / amazon_fire_tv / tvos / bada / beos / blackberry / bsd / centos / chromium_os / debian / dragonfly / fedora / firefox_os / freebsd / gentoo / gnu / joli / kubuntu / linux / mandriva / meego / mint / netbsd / nintendo / openbsd / os_2 / playstation / rim_tablet_os / sailfish / slackware / solaris / suse / symbian / tizen / ubuntu / unix / zenwalk / other / robots

${(user_data.os_version)!} | string

注册事件设备的操作系统版本;由客户端指定。TUNE 等效宏 {os_version}

${(user_data.os_version_android)!} | string

事件发生设备的操作系统版本(Android);由客户端指定。

${(user_data.environment)!} | Environment

事件发生的运行时环境;full_web / full_app / instant_app / imessage_app

${(user_data.platform)!} | Platform

一个方便维度,使用户可以轻松地查看 web vs 应用, 台式机 vs 移动设备, 以及 iOS vs Android vs 其他;desktop_web / ios_web / ios_app / android_web / android_app / other / robot / windows_app / fire_app / mac_app / android_tv / ios_tv

${(user_data.aaid)!} | string

事件发生设备的 Android / Google 广告 ID。由客户端指定。TUNE 等效宏 {google_aid};哈希版本 {google_aid_alphanumeric_lower}, {google_aid_alphanumeric_lower_md5}, {google_aid_alphanumeric_lower_sha1}, {google_aid_lower}, {google_aid_md5}, {google_aid_md5_lower}, {google_aid_sha1}, {google_aid_sha1_lower}, {google_aid_sha256} 也可以通过以下函数获得。

${(user_data.android_id)!} | string

Android hardware id. Can only be reset by wiping the device. specified by the client. TUNE equivalent macro {android_id}; hashed versions {android_id_md5}, {android_id_sha1} will also available using functions below.

${(user_data.idfa)!} | string

事件发生设备的 iOS 广告 ID。由客户端指定。TUNE 等效宏 {ios_ifa};哈希版本 {ios_ifa_alphanumeric}, {ios_ifa_alphanumeric_lower}, {ios_ifa_alphanumeric_lower_md5}, {ios_ifa_alphanumeric_lower_sha1}, {ios_ifa_lower}, {ios_ifa_md5}, {ios_ifa_md5_lower}, {ios_ifa_sha1}, {ios_ifa_sha1_lower}, {ios_ifa_sha256} 也可以通过以下功能获得。

${(user_data.idfv)!} | string

发生事件设备的操作系统供应商 ID。适用于 Facebook 等供应商:idfv 对于 Facebook 和 Messenger 相同,但对于 Twitter 不同。由客户端指定。 TUNE 等效宏 {ios_ifv};哈希版本 {ios_ifv_alphanumeric}, {ios_ifv_alphanumeric_lower}, {ios_ifv_alphanumeric_lower_md5}, {ios_ifv_alphanumeric_lower_sha1}, {ios_ifv_lower}, {ios_ifv_md5}, {ios_ifv_md5_lower}, {ios_ifv_sha1}, {ios_ifv_sha1_lower}, {ios_ifv_sha256} 也可以使用下面的函数获得。

${(user_data.kindle_aid)!} | string

与 Kindle 设备关联的 ID。TUNE 等效宏 {platform_aid}

${(user_data.windows_aid)!}| string

The Windows Advertising ID. TUNE equivalent macro {windows_aid}.

${(user_data.tune_mat_id)!} | string

TUNE SDK 生成的用户 ID。如果未设置,也可以在服务器端设置。未在客户之间分享。可以附加到 TUNE click,并且具有相同 mat_id 的后续事件可以归因于该 click。TUNE 等效宏 {mat_id}

<#if user_data.limit_ad_tracking>1<#else>0</#if> | bool

如果合作伙伴选择不被广告主追踪。在 iOS 10以上版本上,伴随0s的 idfa;1 (true/yes) 或 0 (false/no)。TUNE 等效宏 {ios_ad_tracking} OR {google_ad_tracking}

<#if user_data.is_jailbroken>1<#else>0</#if> | bool

如果为 true,则发送此事件的电话已越狱。1 (true/yes) 或 0 (false/no)。TUNE 等效宏 {is_jailbroken}

${(user_data.user_agent)!} | string

发生事件的浏览器或应用的用户代理。通常与 webview 关联。TUNE 等效宏 {user_agent}

${(user_data.ip)!} | string

追踪事件的 API 调用所源自的 IP 地址;服务器端自动设置。TUNE 等效宏 {device_ip}

${(user_data.developer_identity)!} | string

开发者为用户指定的身份;由客户端指定。TUNE 等效宏 {user_id}

${(user_data.language)!} | Language

https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes. TUNE equivalent macro {language}.

${(user_data.sdk_version)!} | string

用于追踪此事件的 Branch SDK 版本;它由客户端指定。

${(user_data.http_referrer)!} | string

引荐网址,其指向 Web SDK 所记录 Web 会话开始的当前页面;由客户端指定。

${(user_data.referral_source)!} | string

"Android: activity.getCallingPackage(). iOS:Web referrer,safari referrer,或 bundle_id.

${(user_data.app_version)!} | string

事件发生的应用版本;由客户端指定。TUNE 等效宏 {app_version}

${(user_data.app_version_package)!} | string

TUNE 通过它来查找请求的站点。由于 site_id 较为具体,因此作为首选;由客户端指定。TUNE 等效宏 {site_id}

${(user_data.device_type)!} | 设备类型

TUNE 过去对设备进行了分类,以方便进行汇总分析。与 user_data_platform 相似,添加了 Windows 设备并指定移动设备 vs 平板电脑;desktop / android_phone / android_tablet / ios_phone / ios_tablet / windows_phone / windows_tablet / other / unknown / tv_os。TUNE 等效宏 {device_type}

${(user_data.carrier_name)!} | string

哪个运营商覆盖了事件发生设备。由客户端指定。TUNE 等效宏 {device_carrier}

${(user_data.brand)!} | string

用户设备的制造商或品牌(例如 “Apple” 或 “Samsung”)。TUNE 等效宏 {device_brand}

${(user_data.model)!} | string

发生事件设备的型号。由客户指端定。TUNE 等效宏 {device_model}

${(user_data.geo_continent_code)!} | string

从 IP 地址(如上)派生的大洲代码,服务器端自动设置。

${(user_data.geo_region_code)!} | string

从 IP 地址(上方)派生的区域代码,服务器端自动设置。

${(user_data.geo_region_en)!} | string

从 IP 地址(上方)派生的可读区域,服务器端自动设置。TUNE 等效宏 {region}

${(user_data.geo_dma_code)!} | uint32

The dma code, derived from IP address (above). https://support.google.com/richmedia/answer/2745487?hl=en, set automatically server side.

${(user_data.geo_city_code)!} | uint32

从 IP 地址(如上)派生的城市代码,服务器端自动设置。

${(user_data.geo_city_en)!} | string

从 IP 地址(上方)派生的可读城市,服务器端自动设置。

${(user_data.geo_lat)!} | 悬浮

从 IP 地址(上方)派生的纬度,服务器端自动设置。TUNE 等效宏 {latitude}

${(user_data.geo_lon)!} | 悬浮

从 IP 地址(上方)派生的经度,服务器端自动设置。TUNE 等效宏 {longitude}

${(user_data.geo_country_code)!} | Country

https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes. TUNE equivalent macro {country_code}.

${(user_data.geo_country_en)!} | string

从 IP 地址(上方)派生的国家/地区英文名称,服务器端自动设置。

${(user_data.geo_postal_code)!} | string

从 IP 地址(上方)派生的邮政编码,服务器端自动设置。

${(user_data.browser)!} | string

Web 事件起源浏览器的可读名称。由 User-Agent string 派生。由客户端指定。

${(user_data.cross_platform_id)!} | string

事件发生 Branch Persona (同人用户)的应用范围内唯一标识符。服务器端自动设置。 |

${(user_data.past_cross_platform_ids)!} | string

与此 Branch Persona (同人用户)相关的 cross_platform_id 过去值的列表。启用识别已合并 Persona (同人用户)的功能。服务器端自动设置。

${(user_data.installer_package_name)!} | string

已安装应用的包名;服务器端自动设置。

${(user_data.cpu_type)!} | string

设备使用的中央处理器类型;服务器端自动设置。

${(user_data.build)!} | string

设备的构建版本;服务器端自动设置。

${(user_data.internet_connection_type)!} | string

设备使用的互联网连接类型(例如 Wifi);服务器端自动设置。

${(user_data.screen_width)!} | string

设备屏幕的宽度;服务器端自动设置。

${(user_data.screen_height)!} | string

设备屏幕的高度;服务器端自动设置。

${(user_data.carrier_name)!} | string

设备载体(例如 Verizon)的名称;服务器端自动设置。

事件数据

以下宏表示转化时收集的与用户/设备完成事件相关的数据点。

事件数据

${(event_data.transaction_id)!} | string

合作伙伴指定的 Transaction ID,供其内部使用。由客户端指定。TUNE 等效宏 {advertiser_ref_id}

${(event_data.currency)!} | CurrencyCode

https://en.wikipedia.org/wiki/ISO_4217. TUNE equivalent macro {currency_code}.

${(event_data.revenue)!} | double

合作伙伴指定的事件收入。由客户端指定。TUNE 等效宏 {revenue}

${(event_data.revenue_in_usd)!} | double

基于收入、货币和汇率的美元收入。服务器端自动设置。 TUNE 等效宏 {revenue_in_usd}。|

${(event_data.exchange_rate)!} | double

事件发生时的汇率(可能长达24小时,但通常会在一小时内会更新)。由客户端指定。

${(event_data.shipping)!} | double

与交易相关的运输成本。由客户端指定。

${(event_data.tax)!} | double

与交易相关的总税额。由客户端指定。

${(event_data.coupon)!} | string

随交易兑换的交易优惠券(例如 "SPRING2017 " )。由客户端指定。

${(event_data.affiliation)!} | string

发生交易的商店或联盟关系(例如 Google Store)。由客户端指定。

${(event_data.search_query)!} | string

事件相关搜索查询。由客户端指定。TUNE 等效宏 {search_string}

${(event_data.ad_type)!} | AdType

用户看到或点击的广告类型。由 Facebook 定义,并由客户端指定;banner / interstitial / rewarded_video / native

${(event_data.description)!} | string

事件相关描述,不一定特定于个别内容项目。由客户端指定。

内容项目数据

以下宏表示与转化时收集到的用户/设备完成的事件中的内容相关的数据点

内容项目数据

${(content_items[0].$content_schema)!} | ContentSchema

内容类别/模式。由客户端指定;commerce_auction / commerce_business / commerce_other / commerce_product / commerce_restaurant / commerce_service / commerce_travel_flight / commerce_travel_hotel / commerce_travel_other / game_state / media_image / media_mixed / media_music / media_other / media_video / other / text_article / text_blog / text_other / text_recipe / text_review / text_search_results / text_story / text_technical_doc |

<#if content_items[0].$publicly_indexable>1<#else>0</#if> | bool

true:内容可被索引以供本地(设备)使用;或者 false:无法为本地使用编制索引;由客户端指定;1 (true/yes) 或 0 (false/no)

<#if content_items[0].$locally_indexable>1<#else>0</#if> | bool

true:任何人都可以看到内容;或者 false:无法为公共使用编制索引;由客户端指定;1 (true/yes) 或 0 (false/no)

${(content_items[0].$exp_date!} | fixed64

最后一次,之后此内容不再有效。 null / 0表示没有限制。它由客户端指定。

${(content_items[0].$canonical_identifier)!} | string

用于使 Branch 统一内容/消息。由客户端指定。

${(content_items[0].$og_title)!} | string

所呈现文档标题(也用于搜索)—如果是集合,则是该集合的标题而不是单个项目。由客户端指定。

${(content_items[0].$canonical_url)!} | string

引用公共 Web 内容(移动设备或台式机)的 web URL。最好是一个永久链接,且在其他地方(主网站,AMP 页面等)用作规范 URL。由客户端指定。

${(content_items[0].$og_description)!} | string

说明(针对单个项目)。由客户端指定。

${(content_items[0].$og_image_url)!} | string

图片 URL。由客户端指定。

${(content_items[0].$keywords)!} | string

任何关键字。由客户端指定。

${(content_items[0].$price)!} | double

产品/内容的单价。由客户端指定。

${(content_items[0].$price_in_usd)!} | double

基于价格、货币和汇率的美元单价。由客户端指定或服务器端自动设置。

${(content_items[0].$quantity)!} | double

要订购的商品数量(用于 PURCHASE,ADD_TO_CART 等)。由客户端指定。TUNE 等效宏 {quantity}

${(content_items[0].$value)!} | double

该值是 $price 乘以 $quantity 的乘积。由客户端指定或服务器端自动设置。

${(content_items[0].$value_in_usd)!} | double

基于价格、货币和汇率的美元价值(请参见上面的 $value)。由客户端指定或服务器端自动设置。

${(content_items[0].$sku)!} | string

产品 sku 或产品 ID。由客户端指定。

${(content_items[0].$product_name)!} | string

产品名称。由客户端指定。TUNE 等效宏 [{event_item_names_string}]{event_item_ref_string}{event_item_ref}

${(content_items[0].$product_brand)!} | string

产品的品牌。由客户端指定。

${(content_items[0].$product_variant)!} | string

产品变体(例如 XL)。由客户端指定;animals_and_pets_supplies / apparel_and_accessories / arts_and_entertainment / baby_and_toddler / business_and_industrial / cameras_and_optics / electronics / food_beverage_and_tobacco / furniture / hardware / health_and_beauty / home_and_garden / luggage_and_bags / mature / media / office_supplies / religious_and_ceremonial / software / sporting_goods / toys_and_games / vehicles_and_parts

${(content_items[0].$rating)!} | double

用户对 RATE 事件给出的评分。由客户端指定。

${(content_items[0].$rating_average)!} | double

项目的平均评分。由客户端指定。

${(content_items[0].$rating_count)!} | int64

项目的评分数。由客户端指定。

${(content_items[0].$rating_max)!} | double

项目的最高可能评分(例如5星是最高可能评分)。由客户端指定。

| ${(content_items[0].$address_street)!} | string

客户指定的餐厅、公司、房间(酒店)等的街道地址。

${(content_items[0].$address_city)!} | string

客户指定的餐厅、公司、房间(酒店)等所在的城市。

${(content_items[0].$address_country)!} | string

客户指定的餐厅、公司、房间(酒店)等所在国家/地区代码。

${(content_items[0].$address_postal_code)!} | string

客户指定的餐厅、公司、房间(酒店)等所在地的邮政编码。

${(content_items[0].$latitude)!} | float

客户指定的餐厅、公司、房间(酒店)等所在地的纬度。

${(content_items[0].$longitude)!} | float

客户指定的餐厅、公司、房间(酒店)等所在地的经度。

${(content_items[0].$condition)!} | Condition

对于拍卖,该物品是否是新的,良好的,可以接受的,等等。由客户端指定;new / excellent / good / fair / poor / used / refurbished / other

${(content_items[0].$image_captions)!} | string

与图像相关的标题。由客户端指定。

${(content_items[0].$creation_timestamp)!} | fixed64

内容创建的时间。由客户端指定。

${(content_items[0].$currency)!} | CurrencyCode

https://en.wikipedia.org/wiki/ISO_4217

${(content_items[0].custom_fields)!} | string

合作伙伴指定的 BUO 相关自定义 key-values pairs。由客户端指定。 |

Cohort(同期群)相关数据


以下宏表示基于安装或再次参与活动的同期群用户相关联的数据点。

Cohort(同期群)相关数据

${(install_activity.event_name)!}OR${(reengagement_activity.event_name)!} | string

Cohort(同期群)事件的名称。

<#if install_activity.attributed>1<#else>0</#if> OR <#if reengagement_activity.attributed>1<#else>0</#if> | bool

install/re-engagment 事件是否被归因;1 (true/yes) 或 0 (false/no)

${(install_activity.timestamp)!} OR ${(reengagement_activity.timestamp)!} | fixed64

UTC 中安装/重新参与(reengagement)时间的时间戳(以毫秒为单位)

${(install_activity.touch_data.tilde_advertising_partner_name)!} OR ${(reengagement_activity.touch_data.tilde_advertising_partner_name)!} | string

为最后归因触点指定的可读广告合作伙伴名称。服务器端自动设置。

${(install_activity.touch_data.dollar_3p)!} OR ${(reengagement_activity.touch_data.dollar_3p)!} | string

设置事件是否源自 Google AMP 或 Facebook Instant Article 上的触点。由客户端指定。

${(install_activity.touch_data.tilde_tune_publisher_id)!} OR ${(reengagement_activity.touch_data.tilde_tune_publisher_id)!} | fixed64

最后触点的发行商 ID。 TUNE 特定的变量,用于一个客户的广告平台启用。通常,last_attributed_touch_data_tilde_advertising_partner_name是更好使用的字段。

CTA 视图数据

以下宏表示与 Journeys 或 Deepview 数据相关的数据点,其中没有链接点击。

CTA 视图数据

${(last_cta_view_data.~id)!} | fixed64

上一个 CTA 视图 ID。服务器端自动设置。

${(last_cta_view_data.~campaign)!} | string

为上一个 CTA 视图指定的 campaign(名称)。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。

| ${(last_cta_view_data.~campaign_id)!} | string

为上一个 CTA 视图指定的 campaign ID。服务器端自动设置。

${(last_cta_view_data.~campaign_type)!} | string

Google campaign 类型; Google AAP 字段。服务器端自动设置。

${(last_cta_view_data.~customer_campaign)!} | string

为上一个 CTA 视图指定的客户 campaign。可以由客户端在链接上指定。

${(last_cta_view_data.~channel)!} | string

为上一个 CTA 视图指定的渠道。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。

${(last_cta_view_data.~feature)!} | string

为上一个 CTA 视图指定的功能。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。

${(last_cta_view_data.~stage)!} | string

为上一个 CTA 视图指定的阶段。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。

${(last_cta_view_data.~tags)!} | string

为上一个 CTA 视图指定的标签。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。

${(last_cta_view_data.~advertising_partner_name)!} | string

为上一个 CTA 视图指定的可读广告合作伙伴名称。服务器端自动设置。

${(last_cta_view_data.~advertising_partner_id)!} | string
为上一个 CTA 视图指定的广告合作伙伴 ID。服务器端自动设置或由客户端指定。目前,特定于从 TUNE 迁移的合作伙伴。

${(last_cta_view_data.~secondary_publisher)!} | string

为上一个 CTA 视图指定的子发行商。由广告平台传递。

${(last_cta_view_data.~secondary_publisher_id)!} | string

为上一个 CTA 视图指定的子发行商 ID。由广告平台传递。

${(last_cta_view_data.~customer_secondary_publisher)!} | string

为上一个 CTA 视图指定的子发行商 ID。由广告平台传递。

${(last_cta_view_data.~creative_name)!} | string

为上一个 CTA 视图指定的广告素材名称。服务器端自动设置。 |

${(last_cta_view_data.~creative_id)!} | string

为上一个 CTA 视图指定的广告素材 ID。服务器端自动设置。

${(last_cta_view_data.~ad_set_name)!} | string

为上一个 CTA 视图指定的广告集合名称。服务器端自动设置。 |

${(last_cta_view_data.~ad_set_id)!} | string

为上一个 CTA 视图指定的广告集合 ID。服务器端自动设置。

${(last_cta_view_data.~customer_ad_set_name)!} | string

为上一个 CTA 视图指定的客户广告集合名称。可以由客户端在链接上指定。

${(last_cta_view_data.~ad_name)!} | string

为上一个 CTA 视图指定的广告名称。服务器端自动设置。

${(last_cta_view_data.~ad_id)!} | string

为上一个 CTA 视图指定的广告 ID。服务器端自动设置。

${(last_cta_view_data.~customer_ad_name)!} | string

为上一个 CTA视图指定的客户广告名称。可以由客户端在链接上指定。

${(last_cta_view_data.~keyword)!} | string

为上一个 CTA 视图指定的关键字。服务器端自动设置。

${(last_cta_view_data.~keyword_id)!} | string

由 Google 提供的最后视图的关键字唯一 ID。

${(last_cta_view_data.~customer_keyword)!} | string

最后视图的客户关键字。可以由客户端在链接上指定。

${(last_cta_view_data.~branch_ad_format)!} | string

最后视图的广告格式。在创建 Branch Link 时选择的广告格式,并将其设置为分析标签。例如,Search,Display,Product,App only。

${(last_cta_view_data.~technology_partner)!} | string

最后视图的技术合作伙伴(带有分析标签)。除代理商外,用于增强 campaign 的任何第三方(例如,提供受众,广告素材优化)

${(last_cta_view_data.~banner_dimensions!} | string

最后视图的显示横幅尺寸,带有分析标签。

${(last_cta_view_data.~placement)!} | string

最后视图的放置,带有分析标签。广告在展示 campaign 中显示的实际应用或网站

${(last_cta_view_data.~placement_id)!} | string

最后视图的放置 ID,带有分析标签。广告在展示 campaign 中显示的实际应用或网站

${(last_cta_view_data.~customer_placement)!} | string

客户指定最后视图的放置位置,带有分析标签。广告在展示 campaign 中显示的实际应用或网站

${(last_cta_view_data.~sub_site_name)!} | string

对广告展示网站的引用。由广告平台传递。

${(last_cta_view_data.~customer_sub_site_name)!} | string

客户对广告展示网站的引用。可以由客户端在链接上指定。

${(last_cta_view_data.~agency)!} | string

最后视图的代理商,带有分析标签。代表广告主投放广告 campaign 的代理商。

${(last_cta_view_data.~agency_id)!} | string

最后视图的代理商 ID,带有分析标签。代表广告主投放广告 campaign 的代理商。

${(last_cta_view_data.~tune_publisher_id)!} | fixed64

最后视图的发行商 ID。 TUNE 特定的变量,用于客户的广告平台启用。通常,last_attributed_touch_data_tilde_advertising_partner_name 是更好使用的字段。

${(last_cta_view_data.~tune_publisher_name)!} | string

最后视图的发行商名称。 TUNE 特定的变量,用于客户的广告平台启用。通常,last_attributed_touch_data_tilde_advertising_partner_name 是更好使用的字段。

${(last_cta_view_data.~tune_publisher_sub1)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。

| ${(last_cta_view_data.~tune_publisher_sub2)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。

${(last_cta_view_data.~tune_publisher_sub3)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。

${(last_cta_view_data.~tune_publisher_sub4)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。

${(last_cta_view_data.~tune_publisher_sub5)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。

| ${(last_cta_view_data.~optimization_model)!} | string

最后视图的优化模型,带有分析标签。该模型详细描述 campaign 为其优化事件的模型,例如 install,click,event

${(last_cta_view_data.~secondary_ad_format)!} | string

最后视图的次级广告格式,带有分析标签或在操作后台 (Dashboard)的广告链接创建流程中设置。广告合作伙伴特定的广告格式,例如 Google 的 Display Engagement Ad。

${(last_cta_view_data.~external_touch_id)!} | string

从第三方发送到 Branch 的点击或展示(视图)ID。用于将归因事件绑定到原始触点。如果归因伙伴是 Google SAN,则这将是 gclid 值。有关更多信息,请参见本表中的 gclid。

${(last_cta_view_data.~journey_name)!} | string

受众群体规则/Journey 的 “Campaign 名称”或“标题”。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。

${(last_cta_view_data.~journey_id)!} | string

Journey 的受众群体规则 ID。服务器端自动设置。

${(last_cta_view_data.~view_name)!} | string

Branch 视图/模板的“视图名称”或“标题”。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。

${(last_cta_view_data.~view_id)!} | string

Journey 的 Branch 视图 ID。服务器端自动设置。

${(last_cta_view_data.plus_referring_domain)!} | string

用户在登陆具有 Journey 的页面之前访问的 URL domain。这应使用我们用于 "came directly from a URL" 受众筛选器的相同数据源。它由客户端指定。

${(last_cta_view_data.3p)!} | string

设置事件是否源自 Google AMP 或 Facebook Instant Article 上的触点。由客户端指定。

${(last_cta_view_data.+web_format)!} | WebFormat

amp / Instant_articles

${(last_cta_view_data.+via_features)!} | BranchFeature

当前触点的 Branch 功能(由 Branch 确定)。服务器端自动设置; desktop_deepviews / desktop_journeys / mobile_deepviews / mobile_journeys / ads / email / social / quick_links

${(last_cta_view_data.+touch_id)!} | string

归因触点的(展示,点击等)ID

${(last_cta_view_data.custom_fields)!} | string

为最后视图指定的,且未被上述字段捕获的任何深度链接数据,例如 {foo:true, deeplink_path: 'id/12'}。 "custom_fields" 不应作为独立对象出现。这些值应包含在 last_attributed_touch_data 中。由客户端指定。

自定义数据

以下宏表示与 Branch 预先分配的自定义数据点相关的数据点。

自定义数据

${(custom_data.sub1)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。 |

${(custom_data.sub2)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。

${(custom_data.sub3)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。

${(custom_data.sub4)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。

${(custom_data.sub5)!} | string

通用字段,用于将数据从 click 传递到 install,open 和 conversion 事件。

${(custom_data.content_id)!} | string

应用内事件期间与之交互的内容 ID。

${(custom_data.content_type)!} | string

应用内事件期间与之交互的内容类型。

${(custom_data.date1)!} | string

应用内事件 “reservation” 的检入时间。

${(custom_data.date2)!} | string

应用内事件 “reservation” 的检出时间。

${(custom_data.level)!} | string

已达到事件级别。

${(custom_data.quantity)!} | string

与应用内事件相关的计数;例如,人数或积分消费。

${(custom_data.rating)!} | string

与应用内事件相关的评分;例如4星级。

${(custom_data.transaction_id)!} | string

转化记录的交易 ID。

TUNE 特定数据

以下宏表示与特定参数关联的数据点,这些特定参数已转化为 Branch 格式以供继续使用。

📘

已创建 vs 已存在

该表仅包含为了将 TUNE 数据映射到 Branch 所必须创建的宏。对于可以直接映射到已存在 Branch 数据点的 TUNE 数据点,请参考上表。

TUNE 特定数据

<@urlencode><#if (last_attributed_touch_timestamp)??> <@dateformat output_date_format="yyyy-MM-dd">${last_attributed_touch_timestamp}</@dateformat><#else></#if></@urlencode> | function

格式为 yyyy-MM-DD 的点击日期;TUNE 等效宏 {click_date}

<@urlencode><#if (last_attributed_touch_timestamp)??><@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">${last_attributed_touch_timestamp}</@dateformat><#else></#if></@urlencode> | function

格式为 yyyy-MM-DD HH:MM:SS 的点击日期和时间; TUNE 等效宏 {click_datetime}

<@urlencode><#if (last_attributed_touch_timestamp)??><@dateformat output_date_format="HH:mm:ss">${last_attributed_touch_timestamp}</@dateformat><#else></#if></@urlencode> | function

格式为 HH:MM:SS 的点击时间; TUNE 等效宏 {click_time}

<@urlencode><#if (last_attributed_touch_timestamp)??>${last_attributed_touch_timestamp}<#else></#if></@urlencode> | function

格式为 UNIX 时间戳的点击时间,以毫秒为单位;TUNE 等效宏 {click_timestamp_milliseconds}

<@urlencode><#if (last_attributed_touch_timestamp)??><@dateformat output_date_format="TIMESTAMP_SECONDS">${last_attributed_touch_timestamp}</@dateformat><#else></#if></@urlencode> | function

格式为 UNIX 时间戳的点击时间;TUNE 等效宏 {click_timestamp}

<@urlencode><@dateformat output_date_format="yyyy-MM-dd">${event_timestamp}</@dateformat></@urlencode> | function

格式为 yyyy-MM-DD 的转化日期,用于安装回传;TUNE 等效宏 {conversion_date}

<@urlencode><@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">${event_timestamp}</@dateformat></@urlencode> | function

格式为 yyyy-MM-DD HH:MM:SS 的转化日期和时间,用于安装回传;TUNE 等效宏 {conversion_datetime}

<@urlencode><@dateformat output_date_format="HH:mm:ss">${event_timestamp}</@dateformat></@urlencode> | function

格式为 HH:MM:SS 的转化时间; TUNE 等效宏 {conversion_time}

<@urlencode>${event_timestamp}</@urlencode> | function

格式为 UNIX 时间戳的转化时间,以毫秒为单位;TUNE 等效宏 {conversion_timestamp_milliseconds}

<@urlencode><@dateformat output_date_format="TIMESTAMP_SECONDS">${event_timestamp}</@dateformat></@urlencode> | function

格式为 UNIX 时间戳的转换时间;TUNE 等效宏 {conversion_timestamp}

<@urlencode><@dateformat output_date_format="yyyy-MM-dd">${.now}</@dateformat></@urlencode> | function

格式为 yyyy-MM-DD 的日期; TUNE 等效宏 {date}

<@urlencode><@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">${.now}</@dateformat></@urlencode> | function

格式为 yyyy-MM-DD HH:MM:SS 的日期和时间; TUNE 等效宏 {datetime}

<@firstNotEmpty>${(tune_site_event_id)!}|${(customer_event_alias)!}|${(name)!}</@firstNotEmpty> | function

TUNE 平台中事件的 ID;TUNE 等效宏 {event_id}

<@urlencode><@jsonmap data=content_items></@jsonmap></@urlencode> | function

站点事件项的 JSON 显示有效负载;TUNE 等效宏 {event_items_json}

<#if (customer_event_alias)?? && (customer_event_alias)?has_content>${(customer_event_alias)!}<#else>${(name)!?capitalize}</#if> | function

TUNE 平台中事件的名称;TUNE 等效宏 {event_name}

<@urlencode><#if (last_attributed_touch_type == 'IMPRESSION') && (last_attributed_touch_timestamp)??><@dateformat output_date_format="yyyy-MM-dd">${last_attributed_touch_timestamp}</@dateformat><#else></#if></@urlencode> | function

格式为 yyyy-MM-DD 的展示日期;TUNE 等效宏 {impression_date}

<@urlencode><#if (last_attributed_touch_type == 'IMPRESSION') && (last_attributed_touch_timestamp)??><@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">${last_attributed_touch_timestamp}</@dateformat><#else></#if></@urlencode> | function

格式为 yyyy-MM-DD HH:MM:SS 的展示日期和时间; TUNE 等效宏 {impression_datetime}

<@urlencode><#if (last_attributed_touch_type == 'IMPRESSION') && (last_attributed_touch_timestamp)??><@dateformat output_date_format="HH:mm:ss">${last_attributed_touch_timestamp}</@dateformat><#else></#if> | function

格式为 HH:MM:SS 的展示时间; TUNE 等效宏 {impression_time}

<@urlencode><#if (last_attributed_touch_type == 'IMPRESSION') && (last_attributed_touch_timestamp)??>${last_attributed_touch_timestamp}<#else></#if></@urlencode> | function

格式为 UNIX 时间戳的展示时间,以毫秒为单位;TUNE 等效宏 {impression_timestamp_milliseconds}

<@urlencode><#if (last_attributed_touch_type == 'IMPRESSION') && (last_attributed_touch_timestamp)??><@dateformat output_date_format="TIMESTAMP_SECONDS">${last_attributed_touch_timestamp}</@dateformat><#else></#if></@urlencode> | function

格式为 UNIX 时间戳的展示时间;TUNE 等效宏 {impression_timestamp}

<@urlencode><@dateformat output_date_format="yyyy-MM-dd">${install_activity.timestamp}</@dateformat></@urlencode> | function

格式为 yyyy-MM-DD 的原始安装的转化日期,用于安装后事件回传;TUNE 等效宏 {install_date}

<@urlencode><@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">${install_activity.timestamp}</@dateformat></@urlencode> | function

格式为 yyyy-MM-DD HH:MM:SS 的原始安装的转化日期和时间,用于安装后事件回传;TUNE 等效宏 {install_datetime}

<@urlencode><@dateformat output_date_format="HH:mm:ss">${install_activity.timestamp}</@dateformat></@urlencode> | function

格式为 HH:MM:SS 的原始安装的转化时间,用于安装后事件回传;TUNE 等效宏 {install_time}

<@urlencode>${install_activity.timestamp}</@urlencode> | function

原始安装的转化时间,格式为 UNIX 时间戳(以毫秒为单位),用于安装后事件回传;TUNE 等效宏 {install_timestamp_milliseconds}

<@urlencode><@dateformat output_date_format="TIMESTAMP_SECONDS">${install_activity.timestamp}</@dateformat></@urlencode> | function

原始安装的转化时间,格式为 UNIX 时间戳,用于安装后事件回传;TUNE 等效宏 {install_timestamp}

<#if (last_attributed_touch_data.$3p)?? && ad_network.machine_name?? && (last_attributed_touch_data.$3p)! == (ad_network.machine_name)!>1<#else>0</#if> | function

如果安装或事件与回传伙伴归因于同一伙伴,则设置为1;TUNE 等效宏 {is_attributed}

<#if (first_event_for_user)?? && first_event_for_user>1<#else>0</#if> | function

如果记录的事件是该特定事件用户的第一个日志,则设置为1;TUNE 等效宏 {is_first_event}

<#if (event_data.revenue)?? && (event_data.revenue > 0)>1<#else>0</#if> | function

如果记录的收入大于0的事件是该特定事件用户的第一个日志,则设置为1;TUNE 等效宏 {is_first_purchase}

<#if (install_activity.touch_data.dollar_3p)?? && ad_network.machine_name?? && (install_activity.touch_data.dollar_3p)! == (ad_network.machine_name)!>1<#else>0</#if> | function

如果事件所归因的伙伴与回传伙伴相同,则设置为1;TUNE 等效宏 {is_install_attributed}

<#if (reengagement_activity.attributed)?? && reengagement_activity.attributed>1<#else>0</#if> | function

如果是再次参与事件,则设置为1;TUNE 等效宏 {is_reengagement}

<#if (last_attributed_touch_type)! == 'IMPRESSION'>1<#else>0</#if> | function

如果是展示转化,则设置为1;TUNE 等效宏 {is_view_through}

<#if (user_data.os) == 'IOS'>iOS<#elseif (user_data.os) == 'ANDROID'>Android<#else>${(user_data.os)!}</#if> | function

移动应用的类型(例如 “web”,“ios” 或 “android”);TUNE 等效宏 {mobile_app_type}

<@firstNotEmpty>${(last_attributed_touch_data.publisher_ref_id)!}|${(last_attributed_touch_data.~click_id)!}</@firstNotEmpty> | function

点击时 TUNE 链接中包含的来自第三方系统的引用 ID 值(第三方点击 ID);TUNE 等效宏 {publisher_ref_id}

<@loop data=app.app_bundles val=\"bundle\"><#if user_data.os == bundle.os><#if bundle.os==\"ANDROID\"><@break/><#elseif bundle.os == \"IOS\">${(bundle.ios.itunes_id?substring(2))!}</#if><@break/></#if></@loop> | function

Apple iTunes App ID 的值;在归因分析平台中设置;仅适用于 iOS 应用;TUNE 等效宏 {store_app_id}

<@urlencode><@dateformat output_date_format="HH:mm:ss">${.now}</@dateformat></@urlencode> | function

格式为 HH:MM:SS 的时间; TUNE 等效宏 {time}

{.now?long} | function

格式为 UNIX 时间戳的时间,以毫秒为单位;TUNE 等效宏 {timestamp_milliseconds}

<@urlencode><@dateformat output_date_format=""TIMESTAMP_SECONDS"">${.now}</@dateformat></@urlencode> | function

格式为 UNIX 时间戳的时间;TUNE 等效宏 {timestamp}

URL 函数宏

除了我们的 UR L宏之外,我们还支持将各种 URL 函数与我们的宏结合使用。使用函数可让您更好地控制数据格式化,以供内部使用。

我们根据采取的操作类型和处理的信息类型对功能进行分组。

Hashing/Encoding/etc.

可进行哈希,编码/解码或以其他方式修改另一个宏值的函数宏;例如,唯一标识符的 md5哈希。

Hashing/Encoding/etc.

<@alphanumeric>INPUT_MACRO_HERE</@alphanumeric> | function

从 string 中删除非字母数字字符。

<@base64>INPUT_MACRO_HERE</@base64> | Base64

对内容进行编码。

<@json>INPUT_MACRO_HERE</@json> | JSON

将内容编码为 string。

<@jsonmap>INPUT_MACRO_HERE</@jsonmap> | JSON

对数据进行编码(请确保不要引用)

<@lower>INPUT_MACRO_HERE</@lower>

返回格式为小写且带有冒号的输入值。

<@md5>INPUT_MACRO_HERE</@md5> | MD5

对内容进行编码。

<@sha1>INPUT_MACRO_HERE</@sha1> | SHA1

对内容进行编码。

<@sha256>INPUT_MACRO_HERE</@sha256> | SHA256

对内容进行编码。

<@upper>INPUT_MACRO_HERE</@upper> | function

返回格式为大写且带有冒号的输入值。

<@urldecode>INPUT_MACRO_HERE</@urldecode> | 网址

对内容进行解码。

<@urldecode>INPUT_MACRO_HERE</@urldecode> | 网址

对内容进行解码。

<@urlencode>INPUT_MACRO_HERE</@urlencode> | 网址

对内容进行编码。

Datetime

返回有关另一个宏值的时间信息的函数宏;例如应用内 purchase 事件时间。

Datetime

<@dateformat output_date_format="yyyy-MM-dd">INPUT_MACRO_HERE</@dateformat> | function

返回指定转化的日历时间

<@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">INPUT_MACRO_HERE</@dateformat> | function

返回指定转化的日期

<@dateformat output_date_format="TIMESTAMP_SECONDS">INPUT_MACRO_HERE</@dateformat> | function

返回指定转化的当前 Unix 时间戳(以秒为单位)

<@dateformat output_date_format="TIMESTAMP_MILLIS">INPUT_MACRO_HERE</@dateformat> | function

返回指定转化的当前 Unix 时间戳(以毫秒为单位)

<@iso8601UTCDate>INPUT_MACRO_HERE</@iso8601UTCDate> | function

在 ISO 8601 UTC 中格式化 \DateTime 值。对于缺少的数据或不是 \DateTime 的数据,返回一个空 string。由于 \DateTime 不存储毫秒精度,因此毫秒被硬编码为000

一般操作

执行各种常规操作的函数宏;例如,将布尔值修改为整数。

一般操作

<@countryCodeIso3166>INPUT_MACRO_HERE</@countryCodeIso3166> | function

返回两个字母的 ISO 3166-1 国家/地区代码。请参阅 ISO 3166-1 代码的完整列表。

<@firstNotEmpty>INPUT_MACRO_HERE</@firstNotEmpty> | function

Gets the first value that isn’t empty in a | delimited string.

<@languageIso639>INPUT_MACRO_HERE</@languageIso639> | function

返回两个字母的 ISO 639-1 语言代码。请参阅 ISO 639-1 代码的完整列表。

<@loop data=app.app_bundles val="bundle"><#if user_data.os == bundle.os><#if bundle.os=="ANDROID"><@break/><#elseif bundle.os == "IOS">${(bundle.ios.itunes_id?substring(2))!}</#if><@break/></#if></@loop> | function

Tune 系统中的 getBundle 将返回 ios 站点的 store_app_id 和 android 站点的 package_name。

<@loop>INPUT_MACRO_HERE</@loop>, <@break>, <@sep> | function

在数据中指定的变量周围循环,将每个连续循环分配给 val 中指定的名称。确保不要在数据两边加上引号。

<@rand>INPUT_MACRO_HERE</@rand> | function

返回介于0和2 ^ 31之间的随机值。

<@ternary>INPUT_MACRO_HERE</@ternary> | function

A basic implementation of ternary functionality that uses | to separate parameters This function must receive 4 parameters or nothing will be returned. Given parameter 0 matches parameter 1, parameter 2 will be returned. Given parameter 0 does not match parameter 1, parameter 3 will be returned.

<@truncate>INPUT_MACRO_HERE</@truncate> | function

返回一个缩短为40个字符的值。

<#assign captured>%s</#assign><#if captured>1<#else>0</#if> | function

Tune 系统中的 boolToInt 将布尔 string 强制转换为其整数计数器部分。

<#if (last_attributed_touch_data["~tune_publisher_id"])! == %s>1<#else>0</#if> | function

无论 nstall 或 event 是否归因于与回传合作伙伴相同的伙伴,Tune 系统中的 isAttribute 都会返回。返回1 = true 或 0 = false。

<#if user_data.os == "IOS">0<#elseif user_data.os == "ANDROID">1<#elseif user_data.os == "WINDOWS">2<#else>null</#if> | function

Tune 系统中的 getPlatformAsInt 将以整数 ios = 0, android = 1, windows = 2来获取平台。


这个页面对您有帮助吗?