在跟踪任何 Javascript 事件之前,您需要包含我们的全局代码片段。
这可以在导航中的 Settings > Tracking Codes
中找到。
它可以放置在页面的任何位置,每个页面应该只包含一次。
跟踪转化事件
首先,请注意我们在offer来源和offer部分提供的全局代码片段中已经包含了转化事件代码。
如果您的页面是一个感谢页面,您不关心跟踪浏览,只关心转化,您可以使用这个代码片段来实现。
这段代码包含转化收入和交易ID的占位符。
这两个都是可选的 -- 如果您不传递收入值,它将使用offer的默认值。如果使用联盟网络,您通常会让offer来源将动态支付/交易ID注入代码中(尽管最好使用postback URL)。
注意:在您检索的代码片段中,根据offer来源,大写的值应该被替换为真实值,如果不知道则完全省略,例如CONVERSION_VALUE等。
Javascript事件代码
可以使用以下基本转化事件触发:
flux.track("conversion", { rev:'REVENUE' })
这将依赖cookies和当前页面URL来确定用户是谁 -- 即他们的访客ID。对于该访客,最近创建的offer点击将被转化。
只有在之前已经包含了我们的通用JS代码片段,这个事件才能成功。
您可以使用这段代码手动触发事件,例如通过按钮点击、表单提交等。如果您想在页面加载时触发转化,请按原样包含此代码,但要在我们的通用代码片段之后。
如果您想在某些点击、提交等之后触发转化事件,请参阅这份文档,其中详细说明了如何使用一些基本的事件监听器。
附加参数
如果可用,可以将额外的数据注入到转化事件中。所有属性都应该作为字符串传递。
转化事件中可用以下参数:
rev
-- 收入,可选,以美元和美分表示,例如12.99。如果省略,将使用转化offer的默认值。这必须作为字符串传递,所以应该用引号括起来。tx
-- 交易ID,可选p
-- 页面ID,可选,应该归属转化的offer(页面)的ID。通常不是当前页面,而是之前的页面。如果省略,将转化用户会话中最近的offer页面浏览vid
-- 访客ID。这通常存在于URL或cookies中,但也可以直接注入hit
-- 要转化的offer浏览的点击ID。这通常不是当前页面,而是之前的页面。如果知道这个,您可能已经有了所有需要的信息来进行更可靠的服务器到服务器postback调用。如果您发送hit,则不应发送vid,反之亦然,因为它们是相互竞争的用户标识符(hit更具体,将被使用)。
例如,交易ID和已知页面ID(与转化相关的offer的):
flux.track("conversion", { rev:'REVENUE', tx:'OPTIONAL_TRANSACTION_ID' p:'PAGE_ID' })
如果系统可以直接注入hit或访客ID,这也可以做到,以使跟踪更可靠:
flux.track("conversion", { rev:'REVENUE', tx:'OPTIONAL_TRANSACTION_ID', vid:'VID', p:'PAGE_ID' })
也可以发送hit属性,尽管通常如果您知道hit ID,您可以直接调用postback URL。
如果已知hit ID和VID,您可以选择发送其中一个而不是两个都发送。
在JS请求中覆盖转化时间很少见,但可以如下所示:
flux.track("conversion", { rev:'REVENUE', conversion_time: "unix_timestamp" })
我们建议尽可能使用unix时间戳,尽管有些其他格式也可以解析。
API请求和响应
发送的API请求将类似于浏览事件的请求,例如:
如果成功,响应将包含一个转化ID、时间戳,并显示转化的点击ID,以及一些事件上下文: