English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

配置 Adapty 网页像素

如果您通过网页漏斗或落地页获取用户，Adapty 网页像素可以将每次访问与带来它的广告关联起来。像素会为每位访客分配一个点击 ID。当访客付款时，您将该点击 ID 随交易一起传递，Adapty 归因就会将购买匹配到具体的广告系列、广告组和广告。

该像素适用于 Meta Ads、TikTok for Business 和 Google Ads 广告系列。在 Google Ads 中，它适用于其他广告系列，不适用于应用广告系列。

Note

如果你的漏斗运行在 FunnelFox 上，则无需使用该像素。请参阅将 FunnelFox 与 Adapty 归因集成。

工作原理

页面加载时，像素会执行以下操作：

  • 为访客分配一个 click_id，并在浏览器中存储 7 天。
  • 从页面 URL 中捕获广告信号：Meta（fbclid）、TikTok（ttclid）和 Google（gclid、gbraid、wbraid）的点击 ID，以及广告系列、广告组、广告标识符与名称，还有 utm_* 参数。
  • 在后台将 click_id 和捕获到的信号发送给 Adapty。

结账时，你只需将 click_id 附加到交易中。Adapty 会将其与像素已发送的信号进行匹配，并自动识别广告渠道。

Tip

像素仅匹配广告访问数据。若要将购买记录同步至 Adapty 归因，请连接 Stripe 或 Paddle。

开始之前

将 Meta Ads、TikTok for Business 或 Google Ads 连接到 Adapty 归因，并添加广告系列配置。Adapty 会为每个广告系列配置生成像素代码片段，因此你需要先完成配置才能复制该片段。

像素从落地页 URL 中读取广告数据，因此你的广告必须携带 Adapty 的追踪参数。若未携带这些参数，Adapty 只能将购买归因到广告网络，而无法归因到具体的广告系列、广告组或广告。请参阅为 Web 漏斗标记广告 URL。

安装像素代码

  1. 在 Adapty Attribution 中，打开你的 Meta Ads、TikTok 或 Google Ads 广告系列配置。
  2. 展开 Web funnel 区域，复制 Pixel snippet 字段的值。在 Meta Ads 和 TikTok 配置中，该区域位于 General 标签页。
Pixel snippet field in the Web funnel section of a campaign configuration in Adapty Attribution
  1. 将该代码片段粘贴到漏斗每个页面的 <head> 标签中：
<script async src="https://api-ua.adapty.io/pixel/loader.js" data-code="YOUR_CODE"></script>

data-code 用于标识您的应用和活动，是一个公开标识符，不是密钥。

像素会写入第一方 Cookie 和 localStorage 条目，并在页面加载时读取广告点击 ID。您是漏斗的数据控制者，负责承担相应的法律依据。

默认情况下，像素在页面加载时即开始运行。如需在用户授权后再启动，请在代码片段中添加 data-consent="denied" —— 在您通过 Cookie 横幅授予同意之前，像素不会存储或发送任何数据：

window.adaptyPixel.grantConsent();  // start capture
window.adaptyPixel.revokeConsent(); // clear stored state and stop
window.adaptyPixel.getConsent();    // 'granted' | 'denied'
Warning

对欧盟/欧洲经济区流量，请在获得用户同意后再启用像素追踪。根据 ePrivacy 规定，浏览器存储需事先取得用户同意，第一方归因像素不在豁免范围之内。

该代码片段以异步方式加载，因此在 <script> 标签后的下一行代码中 window.adaptyPixel 尚不存在。请从您的同意横幅回调中调用同意 API，或在提前调用时加上 if (window.adaptyPixel) { ... } 守卫判断。

使用说明

  • 单页漏斗：客户端导航保持相同的 click_id，因此构建为单页应用的漏斗无需额外配置即可正常工作。
  • Click ID 稳定性：在页面加载时或结账时读取 click_id 返回的值相同。如果访客从新广告重新进入漏斗，则以最新的广告点击为准。
  • 续订：仅将 click_id 附加到初始交易。Adapty 通过订阅本身归因试用转化和订阅续订。