rapidsms-xray 0.5.9b0

安装

请注意：在撰写本文时，ubuntu安装了一个旧的， redis的不兼容版本（在引入bitop和 位计数命令）。 您可以使用以下p p a安装最新版本：

sudo add-apt-repository ppa:chris-lea/redis
sudo apt-get update
sudo apt-get install redis-server

使用pip安装必要的python需求：

pip install -r requirements/base.txt

在您的rapidsms项目中，将settings.py添加到您安装的应用程序中 将xray.context_processors.web_实验添加到模板环境处理器中

在您的rapidsms项目urls.py中，将xray的url添加到urlpatterns：

(r'^xray/', include('xray.urls')),

您可能需要运行django的collectStatic来确保x光的静态资产是 可用：

django-admin.py collectstatic

实验

rapidsms x光使用Cleaver 用于分割测试实验。请注意，Rapidsms X射线目前使用 解理器的自定义分叉等待redisbackend的上游合并（它将 通过python setup.py install或pip install-r requirements/base.txt正确安装。

要进行Web拆分测试实验，请将您的实验添加到 你的应用程序的context_processors.py使实验选择 在请求上下文中可用。你不必把你的实验放在 Context_处理器–这只是一个方便的位置，因此它们都可以放在一个地方。

见xray/context_processors.py 以及thousand/templates/thousand/index.html例如用法。

要进行短信拆分测试实验，请将实验添加到app.py或handler中，然后 确保experiments应用程序列在您的设置中。py的INSTALLED_APPSxray/app.py将处理在路由器的 filter阶段，因此可以在随后的任何传入阶段中进行实验。

请注意，网络和短信分别处理实验参与 分割测试（特别是，对于未登录的web参与者身份是基于cookie的 对登录用户使用并基于用户id，而sms参与者身份 基于手机号码）-即，不能对网络实验参与者进行评分 通过短信转换事件，反之亦然。

有关用法示例，请参见xray/app.py。

事件

Rapidsms X射线使用bitmapist 用于事件跟踪和队列分析。

要使用、导入并实例化xray.events.tracker，然后调用 My_Tracker.web_event或My_Tracker.sms_event带有事件名称和 用户的切割器标识。xray.rolodex.rolodex缓存的标识信息 快速用户查找并为每个web和sms用户发出唯一整数。这些 bitmapist使用唯一整数id跟踪事件参与 用于快速、任意查询的redis位图。请参阅bitmapist文档 其他信息。 见xray/app.py 以及xray/views.py例如用法。

执行自定义事件分析时，请使用events类（使用单独的 每个时间段的web和sms*类）在xray.events而不是 bitmapist类–rapidsms xray将前缀添加到bitmapist的命名空间中 用于分隔短信息和网络事件的键和前缀。 xray.event s.tracker的事件方法添加了适当的前缀，因此您将 只有在访问位图列表或存储的数据时才需要担心它们 直接在Redis。

仪表板

Rapidsms X光包括一个总结实验和事件的仪表板 参与以及显示Experime的深入页面新台币详情及群组 活动参与分析。