回发宏&函数

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

URL宏

我们已根据要收集的信息类型将宏分为几类。

使用函数修改回发宏

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

回发数据

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

全宏 参数类型 定义/返回值
${(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应用事件关联的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 Tune,Appsflyer等使用Android安装引荐来源网址将Branch点击与安装匹配的流ID;由服务器端设置,由客户端中继。
${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 是否是此用户的第一次触发此事件。服务器端自动设置; 1 (true/yes) 或 0 (false/no)
${(store_install_begin_timestamp)!} fixed64 在Play商店/ App Store中点击安装按钮的时间。
${(referrer_click_timestamp)!} fixed64 Play商店启动时间(仅适用于Android)
<#if existing_user>1<#else>0</#if> bool 与事件关联的用户是既存用户还是新用户; 1(是/是)或0(是/否)
${(webhook_id)!} fixed64 Webhook本身的ID;由Branch分配。
${(webhook_partner_key)!} string Branch向其发送有效负载的机器可读伙伴名称;服务器端自动设置。
${(app_id)!} string 与事件关联的Branch应用的ID;由Branch分配。

归因触点数据

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

全宏 参数类型 定义/返回值
${(last_attributed_touch_data.~id)!} fixed64 最后归属的触点的ID(仅适用于快速链接)。服务器端自动设置。
${(last_attributed_touch_data.~campaign)!} string 为最后一次归因触点指定的广告系列(名称)。可以由客户端在链接上指定,或者在某些情况下可以在服务器端自动预填充。
${(last_attributed_touch_data.~campaign_id)!} string 为最后一次归因触点指定的广告系列ID。自动设置服务器端。
${(last_attributed_touch_data.~campaign_type)!} string Google广告系列的类型; Google AAP字段。服务器端自动设置。
${(last_attributed_touch_data.~customer_campaign)!} string 为最后一次归因触点指定的客户活动。可以由客户端在链接上指定。 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链接时选择的广告格式,并将其设置为分析代码。例如,搜索,展示,产品广告,仅应用。
${(last_attributed_touch_data.~technology_partner)!} string 上次接触的技术合作伙伴(带有分析标签)。 '秒用于增强广告系列的任何第三方(例如,提供受众,创意优化),代理商除外
${(last_attributed_touch_data.~banner_dimensions)!} string 最后触点的显示横幅的维度,由Analytics(分析)标记设置。
${(last_attributed_touch_data.~placement)!} string 上次触点的位置,由Analytics标签设置。广告在实际的应用或网站上展示。 TUNE等效宏${sub_placement_name}
${(last_attributed_touch_data.~placement_id)!} string 上次触点的放置ID,由Analytics标签设置。广告在实际的应用或网站上展示。 TUNE等效宏${sub_placement}
${(last_attributed_touch_data.~customer_placement)!} string 客户指定了最后一个触点的位置,该位置由分析标签设置。广告在实际的应用或网站上展示。 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标签设置。代表广告客户投放广告系列的代理商。 TUNE等效宏${agency_name}
${(last_attributed_touch_data.~agency_id)!} string 上次联系的代理商ID,由Analytics标签设置。代表广告客户投放广告系列的代理商。 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 通用字段,用于将数据从点击传递到安装,打开和转换事件。 TUNE等效宏${publisher_sub1}
${(last_attributed_touch_data.~tune_publisher_sub2)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。 TUNE等效宏${publisher_sub2}
${(last_attributed_touch_data.~tune_publisher_sub3)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。 TUNE等效宏${publisher_sub3}
${(last_attributed_touch_data.~tune_publisher_sub4)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。 TUNE等效宏${publisher_sub4}
${(last_attributed_touch_data.~tune_publisher_sub5)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。 TUNE等效宏${publisher_sub5}
${(last_attributed_touch_data.~optimization_model)!} string 最后触点的优化模型,由分析标记设置。详细描述活动针对其进行优化的事件的模型,例如安装,点击,事件
${(last_attributed_touch_data.~secondary_ad_format)!} string 上次触点的辅助广告格式,由分析标记设置或在仪表板上的广告链接创建流程中设置。广告合作伙伴特定的广告格式,例如Google的展示广告。
${(last_attributed_touch_data.~external_touch)!} string 从第三方发送到Branch的点击或展示(视图)的ID。用于将归因事件与原始联系联系起来。如果归属伙伴是Google SAN,则这将是gclid值。有关更多信息,请参见本表中的gclid。
${(last_attributed_touch_data.~journey_name)!} string 受众群体规则/Journey (路径图谱) 的"广告系列名称"或"标题" 。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。
${(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的域。这应该使用与我们用于"数据源直接来自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 /广告/电子邮件/社交/快速链接
${(last_attributed_touch_data.+via_features)!} BranchFeature 通过归因确定导致此事件的所有Branch功能(由Branch确定)。例如,如果点击电子邮件链接导致了一个通往应用程序的Journey (路径图谱) ,则已发布的eo_open将具有+ via_features:[EMAIL,JOURNEYS]。自动设置服务器端; desktop_deepviews / desktop_journeys / mobile_deepviews / mobile_journeys /广告/电子邮件/社交/快速链接
<#if last_attributed_touch_data.dollar_fb_data_terms_not_signed>1<#else>0</#if> bool 如果未从Facebook签署移动数据条款。这意味着我们需要对外部事件隐藏与归因相关的所有内容。自动设置服务器端; 1(是/是)或0(是/否)
${(last_attributed_touch_data.+touch_id)!} string 归因触点' s(展示,点击等)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 用户代理字符串格式,包括产品名称,版本和系统(例如“ Mozilla / 5.0(iPad)”)。
${(last_attributed_touch_data.+device_brand_name)!} string 用户'的设备的品牌或品牌(例如“ Apple”或“ Samsung”)。
${(last_attributed_touch_data.+device_brand_model)!} string 用户'的设备的型号(例如“ Droid Pro”)。

User Data

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

全宏 参数类型 定义/返回值
${(user_data.os)!} OS 注册事件的设备的操作系统; ios / android / mac_os / Windows / Windows_phone / amazon_fire / amazon_fire_tv / tvos / bada / beos / blackberry / bsd / centos / chrome_os / debian / dragonfly / fedora / firefox_os / freebsd / gentoo / gnu / joli / kubuntu / linux / mandriva meego /薄荷/ netbsd /任天堂/ openbsd / os_2 / playstation / rim_tablet_os / sailfish / slackware / solaris / suse / symbian / tizen / ubuntu / unix / zenwalk /其他/机器人
${(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,应用程序,台式机,移动设备以及iOS,Android和其他应用程序; desktop_web / ios_web / ios_app / android_web / android_app /其他/ 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硬件ID。只能通过擦拭设备来重置。由客户指定。 TUNE等效宏${android_id} ;散列的版本${android_id_md5}, {android_id_sha1} 也可以使用以下功能获得。
${(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 发生事件的设备的iOS供应商ID。适用于Facebook等供应商:对于Facebook和Messenger,idfv相同,但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 Windows广告ID。 TUNE等效宏${windows_aid}
${(user_data.tune_mat_id)!} string TUNE SDK生成的用户ID。如果未设置,也可以在服务器端设置。未在客户之间共享。可以附加到TUNE点击,并且具有相同mat_id的后续事件可以归因于该点击。 TUNE等效宏${mat_id}
<#if user_data.limit_ad_tracking>0<#else>1</#if> bool 如果合作伙伴选择不被广告商跟踪。在iOS 10+上,伴随idfa为0; 1(正确/是)或0(错误/否)。 TUNE等效宏${ios_ad_tracking} OR ${google_ad_tracking}
<#if user_data.is_jailbroken>1<#else>0</#if> bool 如果为true,则发送此事件的电话已越狱。 1(正确/是)或0(错误/否)。 TUNE等效宏${is_jailbroken}
${(user_data.user_agent)!} string 发生事件的浏览器或应用程序的用户代理。通常与网络视图关联。 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://zh.wikipedia.org/wiki/List_of_ISO_639-1_codes 。 TUNE等效宏${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:网络引荐来源网址,野生动物园引荐来源网址或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)!} DeviceType TUNE过去对设备进行了分类,以进行便利性汇总分析。与user_data_platform相似,增加了Windows设备并指定了手机与平板电脑;桌面/ android_phone / android_tablet / ios_phone / ios_tablet / windows_phone / windows_tablet /其他/未知/ 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 dma代码,源自IP地址(上述)。 https://support.google.com/richmedia/answer/2745487?hl=zh-CN ,服务器端自动设置。
${(user_data.geo_city_code)!} uint32 从IP地址(如上)派生的城市代码会在服务器端自动设置。
${(user_data.geo_city_en)!} string 从IP地址(上方)派生的人类可读城市会服务器端自动设置。
${(user_data.geo_lat)!} float 从IP地址得出的纬度(上方)会自动在服务器端设置。 TUNE等效宏${latitude}
${(user_data.geo_lon)!} float 从IP地址得出的经度(上述),自动在服务器端设置。 TUNE等效宏${longitude}
${(user_data.geo_country_code)!} Country https://zh.wikipedia.org/wiki/List_of_ISO_3166_country_codes 。 TUNE等效宏${country_code}
${(user_data.geo_country_en)!} string 从IP地址(上方)派生的英文国家/地区名称会自动在服务器端设置。
${(user_data.geo_postal_code)!} string 从IP地址(上方)派生的邮政编码会自动在服务器端设置。
${(user_data.browser)!} string Web事件起源的浏览器的可读名称。源自用户代理字符串。由客户指定。
${(user_data.cross_platform_id)!} string 发生此事件的Branch角色的应用程序范围内的唯一标识符。自动设置服务器端。
${(user_data.past_cross_platform_ids)!} string 与此Branch角色关联的过去cross_platform_id值的列表。启用识别已合并在一起的角色。自动设置服务器端。
${(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 合作伙伴指定的交易ID,供其内部使用。由客户指定。 TUNE等效宏${advertiser_ref_id}
${(event_data.currency)!} CurrencyCode https://en.wikipedia.org/wiki/ISO_4217 。 TUNE等效宏${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定义。客户指定;标语/非页内广告/奖励视频/本机
${(event_data.description)!} string 与事件关联的描述,不一定特定于任何单个内容项。由客户指定。

内容项目数据

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

全宏 参数类型 定义/返回值
${(content_items[0].$content_schema)!} 内容模式 内容的类别/架构。客户指定; 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_re / text_re
<#if content_items[0].$publicly_indexable>1<#else>0</#if> bool true:可以为本地(设备)使用编制索引;或者false:无法为本地使用编制索引;客户指定; 1(是/是)或0(是/否)
<#if content_items[0].$locally_indexable>1<#else>0</#if> bool true:任何人都可以看到内容;或者false:无法索引以供公共使用;客户指定; 1(是/是)或0(是/否)
${(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 URL,它引用公共Web(移动或台式机)上的内容。最好是一个永久链接,并在其他地方(主网站,AMP页面等)用作规范URL。由客户指定。
${(content_items[0].$og_description)!} string 说明(针对单个项目)。由客户指定。
${(content_items[0].$og_image_url)!} string 图片网址。由客户指定。
${(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 基于价格,货币和汇率的美元价值(请参见上面的$值)。由客户端指定或自动设置在服务器端。
${(content_items[0].$sku)!} string 产品sku或产品ID。由客户指定。
${(content_items[0].$product_name)!} string 产品'的名称。由客户指定。 TUNE等效宏[{event_item_names_string}] OR ${event_item_ref_string} OR ${event_item_ref}
${(content_items[0].$product_brand)!} string 产品' s品牌。由客户指定。
${(content_items[0].$product_variant)!} string 产品变型(例如XL)。客户指定;动物和宠物用品/服装和配件/艺术娱乐类/照相机和光学/电子产品/食品饮料和烟草/家具/硬件/健康和美容/家庭用品和玩具/运动用品/办公用品/玩具/玩具/办公用品/玩具/玩具/办公用品/玩具/玩具/办公用品/玩具/玩具/办公用品/玩具/游戏
${(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 对于拍卖,该物品是客户指定的新物品,好物品,可接受物品等;新/优秀/好/一般/差/二手/翻新/其他
${(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关联的合作伙伴指定的自定义键值对。由客户指定。

同期群组相关数据

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

全宏 参数类型 定义/返回值
${(install_activity.event_name)!} OR ${(reengagement_activity.event_name)!} 同期群活动的名称。
<#if install_activity.attributed>1<#else>0</#if> OR <#if reengagement_activity.attributed>1<#else>0</#if> 布尔 安装/重新参与事件是否归因; 1(是/是)或0(是/否)
${(install_activity.timestamp)!} OR ${(reengagement_activity.timestamp)!} 固定64 以UTC为单位的安装/重新啮合时间的时间戳记(以毫秒为单位)
${(install_activity.touch_data.tilde_advertising_partner_name)!} OR ${(reengagement_activity.touch_data.tilde_advertising_partner_name)!} 为上一次归属的触点指定的可读广告伙伴名称。自动设置服务器端。
${(install_activity.touch_data.dollar_3p)!} OR ${(reengagement_activity.touch_data.dollar_3p)!} 设置事件是否源自触点Google AMP或Facebook Instant Article。由客户指定。
${(install_activity.touch_data.tilde_tune_publisher_id)!} OR ${(reengagement_activity.touch_data.tilde_tune_publisher_id)!} 固定64 最后一次触点的发布者ID。 TUNE特定的变量,用于一个客户'的广告网络启用。通常,last_attributed_touch_data_tilde_advertising_partner_name是更好使用的字段。

CTA查看数据

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

全宏 参数类型 定义/返回值
${(last_cta_view_data.~id)!} fixed64 上一个CTA视图的ID。服务器端自动设置。
${(last_cta_view_data.~campaign)!} string 为上一个CTA视图指定的广告系列(名称)。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。
${(last_cta_view_data.~campaign_id)!} string 为上一个CTA视图指定的广告系列ID。服务器端自动设置。
${(last_cta_view_data.~campaign_type)!} string Google广告系列的类型; Google AAP字段。服务器端自动设置。
${(last_cta_view_data.~customer_campaign)!} string 为上一次CTA视图指定的客户广告系列。可以由客户端在链接上指定。
${(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链接时选择的广告格式,并将其设置为分析代码。例如,搜索,展示,产品广告,仅应用。
${(last_cta_view_data.~technology_partner)!} string 上次查看的技术合作伙伴(已设置分析标签)。 '秒用于增强广告系列的任何第三方(例如,提供受众,创意优化),代理商除外
${(last_cta_view_data.~banner_dimensions!} string 最后一个视图的显示横幅的尺寸,由Analytics标签设置。
${(last_cta_view_data.~placement)!} string 最后一个视图的位置,与Analytics标签一起设置。广告在展示广告系列中展示的实际应用或网站
${(last_cta_view_data.~placement_id)!} string 最后一个视图的放置ID,由Analytics标签设置。广告在展示广告系列中展示的实际应用或网站
${(last_cta_view_data.~customer_placement)!} string 客户指定了最后一个视图的放置位置,该位置已设置为分析标记。广告在展示广告系列中展示的实际应用或网站
${(last_cta_view_data.~sub_site_name)!} string 对显示广告的网站的引用。由广告网络传递。
${(last_cta_view_data.~customer_sub_site_name)!} string 客户对显示广告的网站的引用。可以由客户端在链接上指定。
${(last_cta_view_data.~agency)!} string 最后一个视图的代理商,由Analytics标签设置。代表广告客户投放广告系列的代理商。
${(last_cta_view_data.~agency_id)!} string 最后一个视图的代理商ID,由Analytics标签设置。代表广告客户投放广告系列的代理商。
${(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 通用字段,用于将数据从点击传递到安装,打开和转换事件。
${(last_cta_view_data.~tune_publisher_sub2)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。
${(last_cta_view_data.~tune_publisher_sub3)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。
${(last_cta_view_data.~tune_publisher_sub4)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。
${(last_cta_view_data.~tune_publisher_sub5)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。
${(last_cta_view_data.~optimization_model)!} string 最后一个视图的优化模型,由分析标记设置。详细描述活动针对其进行优化的事件的模型,例如安装,点击,事件
${(last_cta_view_data.~secondary_ad_format)!} string 最后一个视图的辅助广告格式,由分析标记设置或在信息中心中的广告链接创建流程中设置。广告合作伙伴特定的广告格式,例如Google的展示广告。
${(last_cta_view_data.~external_touch_id)!} string 从第三方发送到Branch的点击或展示(视图)的ID。用于将归因事件与原始联系联系起来。如果归属伙伴是Google SAN,则这将是gclid值。有关更多信息,请参见本表中的gclid。
${(last_cta_view_data.~journey_name)!} string 受众群体规则/Journey (路径图谱) 的"广告系列名称"或"标题" 。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。
${(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的域。这应该使用与我们用于"数据源直接来自URL "受众过滤器的数据源相同的数据源。由客户指定。
${(last_cta_view_data.<span class="notranslate">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 /广告/电子邮件/社交/快速链接
${(last_cta_view_data.+touch_id)!} string 归因触点' s(展示,点击等)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 通用字段,用于将数据从点击传递到安装,打开和转换事件。
${(custom_data.sub2)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。
${(custom_data.sub3)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。
${(custom_data.sub4)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。
${(custom_data.sub5)!} string 通用字段,用于将数据从点击传递到安装,打开和转换事件。
${(custom_data.content_id)!} string 应用内事件期间与之交互的内容的ID。
${(custom_data.content_type)!} string 应用内事件期间与之互动的内容类型。
${(custom_data.date1)!} string 应用内事件“预订”的签到时间。
${(custom_data.date2)!} string 应用内事件“预订”的结帐时间。
${(custom_data.level)!} string 已达到活动级别。
${(custom_data.quantity)!} string 与应用内事件相关的计数;例如,客人数或积分消费。
${(custom_data.rating)!} string 与应用内事件相关的评分;例如4星级。
${(custom_data.transaction_id)!} string 转化记录的交易ID。

TUNE特定数据

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

已创建与已存在

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

Branch宏 TUNE宏 定义/返回值
<@urlencode><#if (last_attributed_touch_timestamp)??><@dateformat output_date_format="yyyy-MM-dd">${last_attributed_touch_timestamp}</@dateformat><#else></#if></@urlencode> ${click_date} 点击日期格式为yyyy-MM-DD。
<@urlencode><#if (last_attributed_touch_timestamp)??><@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">${last_attributed_touch_timestamp}</@dateformat><#else></#if></@urlencode> ${click_datetime} 点击的日期和时间,格式为yyyy-MM-DD HH:MM:SS。
<@urlencode><#if (last_attributed_touch_timestamp)??><@dateformat output_date_format="HH:mm:ss">${last_attributed_touch_timestamp}</@dateformat><#else></#if></@urlencode> ${click_time} 点击时间格式为HH:MM:SS。
<@urlencode><#if (last_attributed_touch_timestamp)??>${last_attributed_touch_timestamp}<#else></#if></@urlencode> ${click_timestamp_milliseconds} 点击以UNIX时间戳记格式的时间(以毫秒为单位)。
<@urlencode><#if (last_attributed_touch_timestamp)??><@dateformat output_date_format="TIMESTAMP_SECONDS">${last_attributed_touch_timestamp}</@dateformat><#else></#if></@urlencode> ${click_timestamp} 点击格式化为UNIX时间戳的时间。
<@urlencode><@dateformat output_date_format="yyyy-MM-dd">${event_timestamp}</@dateformat></@urlencode> ${conversion_date} 转换日期格式为yyyy-MM-DD;用于安装回发。
<@urlencode><@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">${event_timestamp}</@dateformat></@urlencode> ${conversion_datetime} 转换日期和时间格式为yyyy-MM-DD HH:MM:SS;用于安装回发。
<@urlencode><@dateformat output_date_format="HH:mm:ss">${event_timestamp}</@dateformat></@urlencode> ${conversion_time} 转换时间格式为HH:MM:SS。
<@urlencode>${event_timestamp}</@urlencode> ${conversion_timestamp_milliseconds} 转换时间格式为UNIX时间戳(以毫秒为单位)。
<@urlencode><@dateformat output_date_format="TIMESTAMP_SECONDS">${event_timestamp}</@dateformat></@urlencode> ${conversion_timestamp} 转换时间格式为UNIX时间戳。
<@urlencode><@dateformat output_date_format="yyyy-MM-dd">${.now}</@dateformat></@urlencode> ${date} 日期格式为yyyy-MM-DD。
<@urlencode><@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">${.now}</@dateformat></@urlencode> ${datetime} 日期和时间格式为yyyy-MM-DD HH:MM:SS。
`<@firstNotEmpty>${(tune_site_event_id)!} $ {(customer_event_alias)!} $ {(名)!} / @ firstNotEmpty ` ${event_id} TUNE平台中事件的ID。
<@urlencode><@jsonmap data=content_items></@jsonmap></@urlencode> ${event_items_json} JSON显示站点事件项的有效负载。
<#if (customer_event_alias)?? && (customer_event_alias)?has_content>${(customer_event_alias)!}<#else>${(name)!?capitalize}</#if> ${event_name} TUNE平台中事件的名称。
<@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> ${impression_date} 展示日期格式为yyyy-MM-DD。
<@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> ${impression_datetime} 展示日期和时间,格式为yyyy-MM-DD HH:MM:SS。
<@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> ${impression_time} 展示时间格式为HH:MM:SS。
<@urlencode><#if (last_attributed_touch_type == 'IMPRESSION') && (last_attributed_touch_timestamp)??>${last_attributed_touch_timestamp}<#else></#if></@urlencode> ${impression_timestamp_milliseconds} 展示时间的格式为UNIX时间戳(以毫秒为单位)。
<@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> ${impression_timestamp} 展示时间的格式为UNIX时间戳。
<@urlencode><@dateformat output_date_format="yyyy-MM-dd">${install_activity.timestamp}</@dateformat></@urlencode> ${install_date} 原始安装的转换日期格式为yyyy-MM-DD;应该在安装后事件回发中使用。
<@urlencode><@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">${install_activity.timestamp}</@dateformat></@urlencode> ${install_datetime} 原始安装的转换日期和时间,格式为yyyy-MM-DD HH:MM:SS;应该在安装后事件回发中使用。
<@urlencode><@dateformat output_date_format="HH:mm:ss">${install_activity.timestamp}</@dateformat></@urlencode> ${install_time} 原始安装的转换时间格式为HH:MM:SS;应该在安装后事件回发中使用。
<@urlencode>${install_activity.timestamp}</@urlencode> ${install_timestamp_milliseconds} 原始安装的转换时间,格式为UNIX时间戳(以毫秒为单位);应该在安装后事件回发中使用。
<@urlencode><@dateformat output_date_format="TIMESTAMP_SECONDS">${install_activity.timestamp}</@dateformat></@urlencode> ${install_timestamp} 原始安装的转换时间,格式为UNIX时间戳;应该在安装后事件回发中使用。
<#if (last_attributed_touch_data.$3p)?? && ad_network.machine_name?? && (last_attributed_touch_data.$3p)! == (ad_network.machine_name)!>1<#else>0</#if> ${is_attributed} 如果安装或事件与回发伙伴属于同一伙伴,则设置为1;否则,设置为1。否则设置为0。
<#if (first_event_for_user)?? && first_event_for_user>1<#else>0</#if> ${is_first_event} 如果记录的事件是该特定事件的用户的第一个日志,则设置为1;否则,设置为1。否则设置为0。
<#if (event_data.revenue)?? && (event_data.revenue > 0)>1<#else>0</#if> ${is_first_purchase} 如果记录的收入大于0的事件是该特定事件的用户的第一个日志,则将其设置为1;否则,将其设置为1。否则设置为0。
<#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> ${is_install_attributed} 如果事件所赋予的伙伴与回发伙伴相同,则设置为1;否则,设置为1。否则设置为0。
<#if (reengagement_activity.attributed)?? && reengagement_activity.attributed>1<#else>0</#if> ${is_reengagement} 如果事件是再次参与,则设置为1;否则,设置为1。否则设置为0。
<#if (last_attributed_touch_type)! == 'IMPRESSION'>1<#else>0</#if> ${is_view_through} 如果是浏览型转化,则设置为1;否则,设置为1。否则设置为0。
<#if (user_data.os) == 'IOS'>iOS<#elseif (user_data.os) == 'ANDROID'>Android<#else>${(user_data.os)!}</#if> ${mobile_app_type} 移动应用的类型(例如“网络”,“ ios”或“安卓”)。
`<@firstNotEmpty>${(last_attributed_touch_data.publisher_ref_id)!} $ {(last_attributed_touch_data。〜click_id)!} / @ firstNotEmpty ` ${publisher_ref_id} Value of the reference ID from a third-party system (third-party click ID) included in TUNE link on click.
<@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> ${store_app_id} Apple iTunes App ID的值;在归因分析平台中设置;仅对iOS应用有效。
<@urlencode><@dateformat output_date_format="HH:mm:ss">${.now}</@dateformat></@urlencode> ${time} 时间格式为HH:MM:SS。
${.now?long} ${timestamp_milliseconds} 时间格式为UNIX时间戳(以毫秒为单位)。
"<@urlencode><@dateformat output_date_format=""TIMESTAMP_SECONDS"">${.now}</@dateformat></@urlencode>
" ${timestamp} 时间格式为UNIX时间戳。

URL函数宏

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

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

哈希/编码/等

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

功能标签 描述
<@alphanumeric>INPUT_MACRO_HERE</@alphanumeric> 从字符串中删除非字母数字字符。
<@base64>INPUT_MACRO_HERE</@base64> Base64对内容进行编码。
<@json>INPUT_MACRO_HERE</@json> JSON将内容编码为字符串。
<@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> 返回格式为大写且带有冒号的输入值。
<@urldecode>INPUT_MACRO_HERE</@urldecode> URL解码内容。
<@urlencode>INPUT_MACRO_HERE</@urlencode> URL对内容进行编码。

约会时间

返回有关另一个宏的值的日期时间信息的函数宏;例如应用内购买活动的时间。

功能标签 描述
<@dateformat output_date_format="yyyy-MM-dd">INPUT_MACRO_HERE</@dateformat> 返回指定转换的日历日期
<@dateformat output_date_format="yyyy-MM-dd HH:mm:ss">INPUT_MACRO_HERE</@dateformat> 返回指定转换的日期
<@dateformat output_date_format="TIMESTAMP_SECONDS">INPUT_MACRO_HERE</@dateformat> 返回指定转换的当前Unix时间戳(以秒为单位)
<@dateformat output_date_format="TIMESTAMP_MILLIS">INPUT_MACRO_HERE</@dateformat> 返回指定转换的当前unixt时间戳(以毫秒为单位)
<@iso8601UTCDate>INPUT_MACRO_HERE</@iso8601UTCDate> 在ISO 8601 UTC中格式化\ DateTime值。对于缺少的数据或不是\ DateTime的数据,返回一个空字符串。由于\ DateTime不存储毫秒精度,因此毫秒被硬编码为000

一般动作

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

功能标签 描述
<@countryCodeIso3166>INPUT_MACRO_HERE</@countryCodeIso3166> 返回ISO 3166-1两个字母的国家/地区代码。请参阅ISO 3166-1代码的完整列表。
<@firstNotEmpty>INPUT_MACRO_HERE</@firstNotEmpty> 获取第一个不为空的值 分隔字符串。
<@languageIso639>INPUT_MACRO_HERE</@languageIso639> 返回ISO 639-1两种字符的语言代码。请参阅ISO 639-1代码的完整列表。
<@loop data=app.app_bundles val="bundle"><#if user_data.os == bundle.os><#if bundle.os=="ANDROID">${(bundle.android.package_name)!}<@break/><#elseif bundle.os == "IOS">${(bundle.ios.itunes_id?substring(2))!}</#if><@break/></#if></@loop> Tune ' s系统中的getBundle将返回ios站点的store_app_id和android站点的package_name。
<@loop>INPUT_MACRO_HERE</@loop>, <@break>, <@sep> 在数据中指定的变量周围循环,将每个连续的变量分配给val中指定的名称。确保不要在数据两边加上引号。
<@rand>INPUT_MACRO_HERE</@rand> 返回介于0和2 ^ 31之间的随机值。
<@ternary>INPUT_MACRO_HERE</@ternary> 使用的三元功能的基本实现 分隔参数此函数必须接收4个参数,否则将不返回任何内容。给定参数0与参数1匹配,将返回参数2。给定参数0与参数1不匹配,将返回参数3。
<@truncate>INPUT_MACRO_HERE</@truncate> 返回一个缩短为40个字符的值。
<#assign captured>%s</#assign><#if captured>1<#else>0</#if> Tune ' s系统中的boolToInt将布尔值字符串强制转换为其整数计数器部分。
<#if (last_attributed_touch_data["~tune_publisher_id"])! == %s>1<#else>0</#if> 无论install或事件是否属于与回发伙伴相同的伙伴,都将在Tune '的系统中获取isAttributed;返回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> Tune ' s系统中的getPlatformAsInt将获得平台,其整数为ios = 0,android = 1,windows = 2。

更新3 天前

回发宏&函数


建议的编辑仅限于API参考页

您只能建议对Markdown正文内容进行修改,而不能建议对API规范进行修改。