如需创建 OneLink Smart Script：

1. 在 AppsFlyer 中，从侧边菜单中选择 Engage > Web-to-app > Smart Script。
2. 对于新用户
   1. 点击 开始使用 按钮。
   2. 从第 4 步开始，完成各步骤操作。
3. 点击页面顶部的 + New Smart Script 按钮。
4. 按照屏幕提示为您的智能脚本命名。
5. 选择一个 OneLink 模板作为脚本基础。该模板包含基础跳转设置。
6. 映射传出 URL 应包含的参数。这些参数基于传入 URL 的参数。注意：媒体渠道 (pid) 参数为必填项。
   1. 选择要映射的传出参数/维度。
      通常，这是不可更改的 AppsFlyer 参数名称，但在某些情况下，您需要输入您自己的参数名称。
   2. 确定并配置传出参数的值应基于以下任一项：
      • 传入 URL 参数：列出一个或多个您希望由传出 URL 参数替换的传入 URL 参数。传入 URL 参数的值将成为您的传出 URL 参数的值。
        • 示例：any_param_name、utm_param_name。如果在传入 URL 中找到 utm_param_name，则其值将用作您所选传出 URL 参数的值。
        • 智能脚本会按从左到右的顺序搜索参数列表，并将第一个匹配项映射到传出 URL 参数。
        • 开发者将此参数列表称为键。
      • 默认值：当未找到传入 URL 参数，或者您未列出任何传入 URL 参数时，输入您希望用作传出参数值的默认值。
        • 示例：对于传出参数，如果传入 URL 参数列表中包含 any_paramname、utm_paramname，而列表中的这两个参数都未找到，则会使用默认值作为传出参数的值。
      • 覆盖值：配置传入 URL 中的一个或多个值，以及要用来替换它们的传出 URL 值。
        • 示例：对于广告系列参数，如果传入 URL 中的值为 campaign_name，则可将传出 URL 中的值更改为 new_campaign_name。
   3. [可选] 点击 + New parameter 以映射其他参数。查看您可以使用的所有其他参数（参数配置）。
7. 选择如何在您的网站上实施智能脚本：
   • 将脚本嵌入您的网站。
   • 使用 Google Tag Manager。
8. 点击 Test，在智能脚本测试页面上测试该脚本。请确保生成的传出 URL 正确。
9. 点击
   1. Save 以保存您的更改
   2. Save and Generate 以保存并生成脚本
      1. 点击 Download script。
10. 如果您选择将脚本嵌入网站：将脚本发送给您的网站开发者进行实施，并告知他们如何处理生成的传出 URL。例如，将其放在您移动网站的 CTA 按钮下方，或在桌面网站上展示二维码。开发者说明
11. 如果您选择使用 Google Tag Manager：
    1. 在 Google Tag Manager 中，创建一个新代码标记，为该代码标记命名，点击 Tag Configuration，然后选择 Custom HTML。
    2. 在 HTML 框中，粘贴生成的智能脚本代码。
    3. 点击 Triggering，创建一个新触发器，为其命名，并选择触发器配置（例如，所有页面浏览）。查看 GTM 文档，了解更多
    4. 点击保存
    5. 告知您的网站开发者如何处理生成的出站 URL。例如，将其放置在移动网站的 CTA 按钮下方，或在桌面网站上显示二维码。开发人员相关说明
12. 已保存的脚本可在下拉菜单中查看。

如需编辑或删除脚本：

1. 点击 Smart Script 名称旁边的下拉箭头 。
   您可以在此查看所有已保存的脚本
   
   
    
2. 点击您要编辑的脚本旁边的铅笔图标
   1. 按照如何创建 OneLink Smart Script中的步骤操作
3. 点击垃圾桶图标以删除智能脚本

如需复制脚本：

1. 前往您要复制的智能脚本
2. 点击顶部横幅上的复制按钮
3. 按照如何创建 OneLink Smart Script中的步骤操作

OneLink Smart Script 使用参数，根据传入 URL 的参数以及脚本中定义的参数生成传出 URL。 afParameters 参数由多个用于归因和深度链接的其他参数组成，每个参数都包含一个结构（开发者称之为配置对象），其中包含键、覆盖值和默认值，如下表所示。

OneLink Smart Script 使用参数，根据传入 URL 的参数以及脚本中定义的参数生成传出 URL。

用于实现智能脚本的参数（参数及其值）

下表介绍了技术能力较强的营销人员或开发者可在智能脚本中实施的参数。

在智能脚本中实施的高级参数（参数和值）

设置脚本以支持 UTM 参数：

1. 列出传入 URL 中的 UTM 参数（例如：utm_source 和 utm_campaign），并将其与传出 URL 中的参数（例如：media_source 和 campaign）进行匹配。 
2. 将这些内容提供给网页开发者，并写入 参数列表 中。
    

结果：传入参数（utm_source 和 utm_campaign）中的值将用于填充传出链接中参数（media_source 和 campaign）的值。 

Google Ads 广告系列安装归因的常规流程（此类广告系列带有 GCLID 参数）要求点击您广告的用户被重定向到应用商店页面 URL。 

由于在这种情况下，您会将来自 Google Ads 的用户重定向到网页/落地页，因此脚本会从 Google Ads 安装广告系列 URL 中提取 GCLID 参数，并将其放入传出 URL 中。从智能脚本 2.9.0 版本开始，只要可用，GCLID、WBRAID 和 GBRAID 参数都会按原样自动转发到由智能脚本生成的传出 URL 中。

您也可以将点击 ID 映射到其他传出参数（af_sub[1-5]），以便在 AppsFlyer 原始数据报告中查看这些数据。

 

注意！

• 这适用于安装广告系列。对于非 ACI 搜索广告系列（即再互动广告系列），尽管智能脚本有输出结果，Google 仍可能被归因为媒体渠道。 
• 如果找到 GCLID，脚本会查找传入参数 keyword。如果找到，脚本会将 keyword 的值作为 af_keywords 的值放入传出 URL 中。

前提条件: 在 Google 数据面板中，启用自动标记。 
启用自动标记后， URL 中会包含 GCLID 参数。

设置脚本以将 Google Ads GCLID 映射到其他参数：

1. 在传出 URL 中选择一个用于包含 GCLID 的参数。
   最佳实践：选择 af_sub[1-5]，这样数据就会显示在 AppsFlyer 原始数据报告中。
2. 将此内容提供给网页开发者，并写入 参数列表中。结果是，在传出 URL 中，GCLID 将作为 af_sub[1-5] 参数的值。
    

如需将这些安装通知给 Google Ads ：

推荐：设置 Google 网页对接。此对接支持针对安装的自动回传。 

如果您尚未完成对接：

1. 通过 CSV 从 af_sub[1-5] 参数中获取 GCLID 数据，或通过 Push API 实时获取每次安装的 GCLID 数据。
2. 通过 手动或通过 Google Ads API 将 GCLID 数据上传到 Google。

Meta 广告会携带点击 ID，称为 FBCLID。从智能脚本 2.8.1 版本开始，如有 FBCLID，智能脚本会在其生成的传出 URL 中按原样自动转发该值。您也可以将点击 ID 映射到其他传出参数，以便在 AppsFlyer 原始数据报告中查看这些数据。

如需设置脚本以将 FBCLID 映射到其他参数： 

1. 在传出 URL 中选择一个用于承载 FBCLID 的参数。 
   最佳实践：选择 af_sub[1-5]，这样数据就会显示在 AppsFlyer 原始数据报告中。
2. 将此内容提供给网页开发者，供其填写到参数列表中。结果是，在传出 URL 中，FBCLID 将作为 af_sub[1-5] 参数的值。
    

TikTok、X（原 Twitter）和 Snap 广告活动的安装归因依赖于各广告平台特有的点击 ID 参数；这些参数会附加到广告点击中，用于将安装及安装后事件与其来源广告进行匹配。

当流量首次重定向到网页或落地页时，应保留并转发点击 ID，以确保正确归因。在这种情况下，智能脚本会捕获传入的点击 ID 参数，并将其附加到它生成的传出 URL 中。

点击 ID 会在安装时被捕获，并用于与该安装相关的后续事件。

从智能脚本 2.10.0 版本开始，以下“点击 ID”参数（如可用）会由智能脚本在其生成的传出 URL 中自动按原样转发：

• TikTok：ttclid
• X（前身为 Twitter）：twclid
• Snap：ScCid

您还可以将这些点击 ID 映射到其他传出参数（例如 af_sub1-af_sub5），以便在 AppsFlyer 原始数据报告中使用这些数据。

请参阅以下相关的 Web 对接文章： 

• 抖音 
• Snap 

像 Snapchat 或 X Ads 这样的 SRN，其运作方式与 Google Ads 或 Meta Ads 这类跨平台广告不同。这些 SRN 的广告系列会将用户引导至 Web/落地页，您的计费依据是点击带来的潜在客户，而与由此产生的任何移动用户无关。 

对于这些 SRN，脚本设置方式与自有媒体或您可能使用的其他媒体渠道链接相同。 

设置脚本：

1. 列出传入链接中的媒体渠道和广告系列参数名称。
2. 将这些内容提供给 Web 开发者，作为 list of arguments 。
   SRN/媒体渠道类型应为传入 URL 中的媒体渠道值。脚本会找到该值，并将其用作 Web/落地页下载按钮后方的传出 OneLink URL 中的 media_source 值。如果您想更改传出的 media_source，请在提供给 Web 开发者的参数列表中提供传入的媒体渠道值以及要覆盖的 media_source 值。

结果：对于这些 SRN/媒体渠道，传入链接中媒体渠道参数和广告系列参数的值将用于填充传出链接中的 media_source and campaign 参数值。 

当媒体渠道为点击广告平台时，可以使用 AppsFlyer 归因链接。在 AppsFlyer 中设置此类链接时，您可以添加一个 重定向 URL 路径（af_r）参数，并填入指向您的移动网页端的目标 URL 路径，以实现 Web 广告系列到 App 的归因。您可能不希望脚本创建传出的 OneLink URL，因为这样可能会丢失原始点击中的部分数据。

操作：使用 urlSkipList 参数列出 af_r 参数。

结果：当智能脚本在传入链接中发现 af_r 参数时，智能脚本不会生成传出 URL，开发者必须决定将哪个链接作为传出 URL，并完成相应实现。

Web referrer 映射可帮助您了解用户是从哪个页面进入您的网站的（例如来自自然搜索结果），从而丰富您可用于分析源自智能脚本网页至应用流程的安装和再互动的数据。

您可以将智能脚本设置为从您的落地页或网站 HTTP 标头的 Referer 字段收集此信息。此字段包含这样一个页面的基础 URL：用户点击了该页面上的某个链接后，被带到您的网页。

设置脚本以收集 Web referrer

1. 打开智能脚本页面
2. 在 Web referrer mapping 区域中，为 Web referrer 值选择传出 URL 参数键：
   • af_channel - 参数会呈现在数据面板和原始数据中
   • af_sub1-5 - 参数会呈现在原始数据中的 af_sub1-5 列以及 original URL 列下。
   • 自定义参数 - 由参数名称和值组成。该参数会呈现在原始数据中的 original URL 列下。

如需了解如何使用 Universal Links 和 App Links 对再互动进行自然搜索归因，请参阅此处。

本文中的大多数使用场景都与来自移动设备的用户有关。因此，当他们从移动网页端被引导至应用商店时，可以立即下载您的应用。

但是，不应立即将桌面用户发送到应用商店，因为他们的设备（台式机或笔记本电脑）与移动应用下载不兼容。 

为桌面用户设置脚本：

• 在您的 OneLink 模板中，为在桌面设备上点击链接时设置目标 URL。该 URL 应重定向到专用的网页/落地页。该落地页可包含一个 Web 表单，用户可填写其详细信息，以接收包含应用下载链接的短信或 email。您需要自行创建网页表单，并在脚本中提供其 URL。 

结果：脚本会检测用户所使用的设备或平台。如果是桌面端，脚本会生成一个传出 OneLink URL，将用户重定向到您专用的网页/落地页。

另请参见桌面端到应用转化。

智能脚本会在您的网页上显示二维码，而不是显示带有链接的按钮。 

要显示二维码：

1. 设置智能脚本时，请确保您使用的是 Smart Script 2.6+。
2. 请让您的开发者按照相关说明，使用智能脚本结果创建二维码。
3. [最佳实践] 请告知开发者：
   • 自定义二维码，例如在二维码中央添加您的应用 Logo，并自定义颜色。
   • 当用户在桌面端时显示二维码，当用户在移动端时显示带有链接的按钮。 

结果：脚本会显示二维码，而不是显示带有 URL 的按钮。

OneLink Smart Script 可用于统计您网站上的曝光。为此，开发者需要 调用曝光函数。随后，安装会通过浏览型归因归因到这些曝光。

注意：

• 曝光统计是在正常的智能脚本生成 URL 点击统计之外额外进行的。 Smart Script 可用于统计点击、曝光，或同时统计两者。
• 通过 Smart Script 实现的浏览型归因仅适用于移动设备，不适用于桌面端。

要将新安装归因于这些曝光（即浏览型归因）： 

1. 设置 Smart Script 时，请确保您使用 Smart Script 2.3+。
2. 请告知您的开发者在 Smart Script 中调用曝光函数。
3. 请确保 已启用浏览型归因。

如果用户浏览网站上的其他页面，用于生成 OneLink 链接的传入 URL 还会生效吗？

是的。传入 URL 参数会在整个会话期间存储，并应用于由 Smart Script 生成的 OneLink 链接的传出参数。如需了解更多实施信息，请参阅我们的开发者中心。

为什么通过 Google Tag Manager 实施 Smart Script 时会报错？

有时，您在 AppsFlyer 中生成 Smart Script 并尝试将其插入 Google Tag Manager（GTM）时，会显示「JavaScript too long」错误。如果发生这种情况，请删除 GTM 标签并重新创建一个。

我可以添加未列出的参数吗？

是的。在您的 OneLink Smart Script 页面中，点击 + 新参数 以映射其他参数。

• 新参数可以是自定义参数，也可以是下拉菜单中未列出的 AppsFlyer 预留参数。
  • 查看您可使用的所有附加参数（参数配置）。
• 使用下拉菜单中的「自定义」选项，并将您的参数添加到 传出 URL 参数 字段中。

例如，要将 is_retargeting 添加为参数，应在 mapping for 字段中选择「自定义参数」，然后将 is_retargeting 参数添加到 传出 URL 参数 字段中。

广告组和其他参数未显示在下拉菜单中

我们建议您在创建或添加新参数时，关闭浏览器中已启用的所有广告拦截器。有时，如果某个选项中包含「广告」一词，广告拦截器会将其移除。

Smart Script 支持哪些浏览器？

Smart Script 使用 Javascript，应可在所有浏览器上运行。