下面的列表显示了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(正确/是)或0(错误/否)。 |
<#if first_event_for_user>1<#else>0</#if> | bool 如果这是此角色的第一次,则已触发此事件。自动设置服务器端; 1(正确/是)或0(错误/否)。 |
${(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等效宏 |
${(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 上次触摸的显示横幅的尺寸(由分析标记设置) |
${(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 受众群体规则/旅程的“广告系列名称”或“标题”。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预先填充。 |
${(last_attributed_touch_data.~journey_id)!} | string Journey的受众群体规则ID。服务器端自动设置。 |
${(last_attributed_touch_data.~view_name)!} | string 分支视图/模板的“视图名称”或“标题”。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预先填充。 |
${(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确定)。例如,如果单击电子邮件链接导致了一个通往应用程序的旅程,则发布的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 归因触摸的(印象,点击等)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 Brand or make of user's device (such as “Apple” or “Samsung”); determined by parsing the user-agent sent via HTTP headers. |
${(last_attributed_touch_data.+device_brand_model)!} | string Model of the user's device (such as “Droid Pro”); determined by parsing the user-agent sent via HTTP headers. |
User Data
以下宏表示与转换时收集的用户/设备关联的数据点。
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等效宏 |
${(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等效宏 |
${(user_data.android_id)!} | string Android hardware id. Can only be reset by wiping the device. specified by the client. TUNE equivalent macro |
${(user_data.idfa)!} | string 事件发生设备的iOS广告ID。由客户指定。 TUNE等效宏 |
${(user_data.idfv)!} | string 发生事件的设备的操作系统供应商ID。适用于Facebook等供应商:idfv适用于Facebook和Messenger,但不同。由客户指定。 TUNE等效宏 |
${(user_data.kindle_aid)!} | string 与Kindle设备关联的ID。 TUNE等效宏 |
${(user_data.windows_aid)!}| string The Windows Advertising ID. TUNE equivalent macro |
${(user_data.tune_mat_id)!} | string TUNE SDK生成的用户ID。如果未设置,也可以在服务器端设置。未在客户之间共享。可以附加到TUNE点击,并且具有相同mat_id的后续事件可以归因于该点击。 TUNE等效宏 |
<#if user_data.limit_ad_tracking>1<#else>0</#if> | bool 如果合作伙伴选择不被广告商跟踪。在iOS 10+上,伴随idfa为0; 1(正确/是)或0(错误/否)。 TUNE等效宏 |
<#if user_data.is_jailbroken>1<#else>0</#if> | bool 如果为true,则发送此事件的电话已越狱。 1(正确/是)或0(错误/否)。 TUNE等效宏 |
${(user_data.user_agent)!} | string 发生事件的浏览器或应用程序的用户代理。通常与网络视图关联。 TUNE等效宏 |
${(user_data.ip)!} | string 跟踪事件的API调用所源自的IP地址;自动设置服务器端。 TUNE等效宏 |
${(user_data.developer_identity)!} | string 开发者为用户指定的身份;由客户指定。 TUNE等效宏 |
${(user_data.language)!} | Language https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes. TUNE equivalent macro |
${(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等效宏 |
${(user_data.app_version_package)!} | string TUNE使用它来查找请求所针对的站点。首选site_id,因为它更具体;由客户指定。 TUNE等效宏 |
${(user_data.device_type)!} | 设备类型 TUNE过去对设备进行了分类,以进行便利性汇总分析。与user_data_platform相似,增加了Windows设备并指定了手机与平板电脑;桌面/ android_phone / android_tablet / ios_phone / ios_tablet / windows_phone / windows_tablet /其他/未知/ tv_os。 TUNE等效宏 |
${(user_data.carrier_name)!} | string 哪个运营商覆盖了发生事件的设备。由客户指定。 TUNE等效宏 |
${(user_data.brand)!} | string 用户设备的品牌或品牌(例如“ Apple”或“ Samsung”)。 TUNE等效宏 |
${(user_data.model)!} | string 发生事件的设备的型号。由客户指定。 TUNE等效宏 |
${(user_data.geo_continent_code)!} | string 从IP地址(如上)派生的大洲代码会自动在服务器端设置。 |
${(user_data.geo_region_code)!} | string 从IP地址(上方)派生的区域代码会自动在服务器端设置。 |
${(user_data.geo_region_en)!} | string 从IP地址(上方)派生的人类可读区域会自动设置服务器端。 TUNE等效宏 |
${(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)!} | 浮动 从IP地址得出的纬度(上方)会自动在服务器端设置。 TUNE等效宏 |
${(user_data.geo_lon)!} | 浮动 从IP地址得出的经度(上述),自动在服务器端设置。 TUNE等效宏 |
${(user_data.geo_country_code)!} | 国家 https://zh.wikipedia.org/wiki/List_of_ISO_3166_country_codes 。 TUNE等效宏 |
${(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等效宏 |
${(event_data.currency)!} | 货币代码 https://zh.wikipedia.org/wiki/ISO_4217 。 TUNE等效宏 |
${(event_data.revenue)!} | 双 合作伙伴为活动指定的收入。由客户指定。 TUNE等效宏 |
${(event_data.revenue_in_usd)!} | 双 基于收入,货币和汇率的美元收入。自动设置服务器端。 TUNE等效宏 |
${(event_data.exchange_rate)!} | 双 事件发生时的汇率(可能长达24小时,但通常在一小时内会更新)。由客户指定。 |
${(event_data.shipping)!} | 双 与交易相关的运输成本。由客户指定。 |
${(event_data.tax)!} | 双 与交易相关的总税额。由客户指定。 |
${(event_data.coupon)!} | string 随交易兑换的交易优惠券(例如" SPRING2017 " )。由客户指定。 |
${(event_data.affiliation)!} | string 发生此交易的商店或从属关系(例如Google Store)。由客户指定。 |
${(event_data.search_query)!} | string 与事件关联的搜索查询。由客户指定。 TUNE等效宏 |
${(event_data.ad_type)!} | 广告类型 用户看到或点击的广告类型。由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等效宏 |
${(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等效宏 |
${(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 |
${(content_items[0].custom_fields)!} | string 与BUO关联的合作伙伴指定的自定义键值对。由客户指定。 | |
同期群组相关数据
。
以下宏表示基于安装或重新参与活动与同类用户相关联的数据点。
同期群组相关数据 |
---|
${(install_activity.event_name)!}OR${(reengagement_activity.event_name)!} | string 同期群活动的名称。 |
<#if install_activity.attributed>1<#else>0</#if> OR <#if reengagement_activity.attributed>1<#else>0</#if> | bool 安装/重新参与事件是否归因; 1(是/是)或0(是/否) |
${(install_activity.timestamp)!} OR ${(reengagement_activity.timestamp)!} | fixed64 以UTC为单位的安装/重新啮合时间的时间戳记(以毫秒为单位) |
${(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视图指定的广告系列(名称)。可以由客户端在链接上指定,也可以在某些情况下自动在服务器端预填充。 |
| ${(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 |
${(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.3p)!} | string 设置事件是否源自触点Google AMP或Facebook Instant Article。由客户指定。 |
${(last_cta_view_data.+web_format)!} | 网络格式 amp / Instant_articles |
${(last_cta_view_data.+via_features)!} | Branch功能 当前触点的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, |
自订资料
以下宏表示与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的宏。对于可以直接映射到预先存在的Branch数据点的TUNE数据点,请参考上表。
TUNE特定数据 |
---|
点击日期格式为yyyy-MM-DD; TUNE等效宏 {click_date} |
点击的日期和时间,格式为yyyy-MM-DD HH:MM:SS; TUNE等效宏 {click_datetime} |
点击时间格式为HH:MM:SS; TUNE等效宏 {click_time} |
单击时间,格式为UNIX时间戳,以毫秒为单位; TUNE等效宏 {click_timestamp_milliseconds} |
单击时间格式为UNIX时间戳; TUNE等效宏 {click_timestamp} |
转换日期格式为yyyy-MM-DD,用于安装回发; TUNE等效宏 {conversion_date} |
格式为yyyy-MM-DD HH:MM:SS的转换日期和时间,用于安装回发; TUNE等效宏 {conversion_datetime} |
转换时间格式为HH:MM:SS; TUNE等效宏 {conversion_time} |
转换时间格式为UNIX时间戳,以毫秒为单位; TUNE等效宏 {conversion_timestamp_milliseconds} |
转换时间格式为UNIX时间戳; TUNE等效宏 {conversion_timestamp} |
日期格式为yyyy-MM-DD; TUNE等效宏 {date} |
日期和时间格式为yyyy-MM-DD HH:MM:SS; TUNE等效宏 {datetime} |
TUNE平台中事件的ID; TUNE等效宏 {event_id} |
站点事件项的JSON显示有效负载; TUNE等效宏 {event_items_json} |
TUNE平台中事件的名称; TUNE等效宏 {event_name} |
展示日期格式为yyyy-MM-DD; TUNE等效宏 {impression_date} |
展示日期和时间,格式为yyyy-MM-DD HH:MM:SS; TUNE等效宏 {impression_datetime} |
展示时间格式为HH:MM:SS; TUNE等效宏 {impression_time} |
展示时间的格式为UNIX时间戳(以毫秒为单位); TUNE等效宏 {impression_timestamp_milliseconds} |
展示时间的格式为UNIX时间戳; TUNE等效宏 {impression_timestamp} |
格式为yyyy-MM-DD的原始安装的转换日期,用于安装后事件回发; TUNE等效宏 {install_date} |
格式为yyyy-MM-DD HH:MM:SS的原始安装的转换日期和时间,用于安装后事件回发; TUNE等效宏 {install_datetime} |
格式为HH:MM:SS的原始安装的转换时间,用于安装后事件回发; TUNE等效宏 {install_time} |
原始安装的转换时间,格式为UNIX时间戳(以毫秒为单位),用于安装后事件回发; TUNE等效宏 {install_timestamp_milliseconds} |
原始安装的转换时间,格式为UNIX时间戳,用于安装后事件回发; TUNE等效宏 {install_timestamp} |
如果安装或事件与回发伙伴属于同一伙伴,则设置为1;否则,设置为1。 TUNE等效宏 {is_attributed} |
如果记录的事件是该特定事件的用户的第一个日志,则设置为1;否则,设置为1。 TUNE等效宏 {is_first_event} |
如果记录的收入大于0的事件是该特定事件的用户的第一个日志,则将其设置为1;否则,将其设置为1。 TUNE等效宏 {is_first_purchase} |
如果事件所赋予的伙伴与回发伙伴相同,则设置为1;否则,设置为1。 TUNE等效宏 {is_install_attributed} |
如果事件是重新参与,则设置为1;否则,设置为1。 TUNE等效宏 {is_reengagement} |
如果是浏览型转化,则设置为1;否则,设置为1。 TUNE等效宏 {is_view_through} |
移动应用的类型(例如“网络”,“ ios”或“安卓”); TUNE等效宏 {mobile_app_type} |
点击时TUNE链接中包含的来自第三方系统的参考ID值(第三方点击ID); TUNE等效宏 {publisher_ref_id} |
Apple iTunes App ID的值;在归因分析平台中设置;仅适用于iOS应用; TUNE等效宏 {store_app_id} |
时间格式为HH:MM:SS; TUNE等效宏 {time} |
时间格式为UNIX时间戳,以毫秒为单位; TUNE等效宏 {timestamp_milliseconds} |
时间格式为UNIX时间戳; TUNE等效宏 {timestamp} |
URL函数宏
除了我们的URL宏之外,我们还支持将各种URL函数与我们的宏结合使用。使用函数可让您更好地控制如何格式化数据以供内部使用。
我们根据采取的操作类型和处理的信息类型将功能分组。
哈希/编码/等
可以散列,编码/解码或以其他方式修改另一个宏的值的函数宏;例如,唯一标识符的md5哈希。
哈希/编码/等 |
---|
从字符串中删除非字母数字字符。 |
编码内容。 |
将内容编码为字符串。 |
对数据进行编码(请确保不要引用) |
返回以小写字母分隔的小数点形式的输入值。 |
编码内容。 |
编码内容。 |
编码内容。 |
返回格式为大写且带有冒号的输入值。 |
解码内容。 |
解码内容。 |
编码内容。 |
约会时间
返回有关另一个宏的值的日期时间信息的函数宏;例如应用内购买活动的时间。
约会时间 |
---|
返回指定转换的日历日期 |
返回指定转换的日期 |
返回指定转换的当前Unix时间戳(以秒为单位) |
返回指定转换的当前unixt时间戳(以毫秒为单位) |
在ISO 8601 UTC中格式化\ DateTime值。对于缺少的数据或不是\ DateTime的数据,返回一个空字符串。由于\ DateTime不存储毫秒精度,因此毫秒被硬编码为000 |
一般动作
执行各种常规操作的函数宏;例如,将布尔值修改为整数。
一般动作 |
---|
返回ISO 3166-1两个字母的国家/地区代码。请参阅ISO 3166-1代码的完整列表。 |
Gets the first value that isn’t empty in a | delimited string. |
返回ISO 639-1两种字符的语言代码。请参阅ISO 639-1代码的完整列表。 |
Tune ' s系统中的getBundle将返回ios站点的store_app_id和android站点的package_name。 |
在数据中指定的变量周围循环,将每个连续的变量分配给val中指定的名称。确保不要在数据两边加上引号。 |
返回介于0和2 ^ 31之间的随机值。 |
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. |
返回一个缩短为40个字符的值。 |
Tune ' s系统中的boolToInt将布尔值字符串强制转换为其整数计数器部分。 |
无论install或事件是否属于与回发伙伴相同的伙伴,都将在Tune '的系统中获取isAttributed;返回1 = true或0 = false。 |
Tune ' s系统中的getPlatformAsInt将获得平台,其整数为ios = 0,android = 1,windows = 2。 |
2个月前更新