下面的列表显示了Branch在回发URL和Webhooks中支持的宏和可用功能。当您使用这些宏和函数时，Branch会在通知指定的回发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函数与我们的宏结合使用。使用函数可让您更好地控制如何格式化数据以供内部使用。
我们根据采取的操作类型和处理的信息类型将功能分组。
哈希/编码/等
可以散列，编码/解码或以其他方式修改另一个宏的值的函数宏；例如，唯一标识符的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 天前