Matomo核心-选择退出

本指南适用于Matomo核心开发人员。有关整合选择退出表格的资料，请参阅退出跟踪指南．

Matomo中包含了两种不同的选择退出表单实现，本指南解释了它们是如何工作的以及实现背后的原因。

背景

在4.12版本之前，Matomo包含了一个作为iFrame实现的退出表单生成器，它可以为JavaScript跟踪器设置第三方同意cookie。随着浏览器对第三方cookie的支持逐渐被淘汰，这种iFrame选择退出被一种解决方案所取代，选择退出表单可以作为网站的一部分，并设置第一方cookie。

Matomo JavaScript跟踪器包括选择退出函数_paq.push ([' optUserOut ']);而且_paq.push ([' forgetUserOptOut ']);它提供了一种简单、标准化的方式来记录用户的退出选择，然而，对于具有严格安全设置的用户来说，加载第三方跟踪JavaScript可能不可靠，并且可能不适合某些网站。

因此，提供了两个选择退出表单实现，一个尝试使用Matomo JavaScript跟踪器代码来记录选择退出，另一个实现完全自包含，不发出服务器请求，也不使用远程资源。这使得站点管理员可以灵活地选择最适合自己情况的方法。

使用Matomo JavaScript跟踪器选择退出

嵌入代码包括:

• 一个< div >使用一个id，该id将包含选择退出表单，并可以根据需要将其放置在页面的任何位置。
• 一个<脚本>标签，从CoreAdminHome加载JavaScriptoptOutJS控制器方法，将配置作为URL参数传递。

< div id = " m-opt-out " > < / div > < script src = " / index . php ?模块= CoreAdminHome&action = optOutJS&language = auto&div = m-opt-out " > < /脚本>

的optOutJS方法返回动态构建的JavaScript，以根据提供的URL参数创建退出表单。文本翻译是基于请求的或自动检测的语言在服务器端完成的。

的optOutJSJavaScript将保持非活动状态，直到DOMContentLoaded页面事件触发，此时将执行以下过程:

错误消息也将显示在内容中< div >如果cookies被禁用或连接不安全。如果指定的内容< div >是不是在那一页上找不到那么一个< div >将被添加，以便显示错误消息。

有关URL参数的说明，请参见退出跟踪指南．

使用自包含代码选择退出

自包含的选择退出嵌入代码包括:

• 一个内容< div >使用一个id，该id将包含选择退出表单，并可以根据需要将其放置在页面的任何位置。
• 一个<脚本>标签，其中包含了退出表单所需的所有JavaScript，所有设置都在一个内联对象中。

文本翻译存储为内联设置，并在生成嵌入代码时为所选语言生成。