文档

QT事件授权

更新时间:

在通过阿里云Quick Tracking(简称为QT)进行的埋点数据采集上报前,需要进行以下操作,Quick Audience工作空间才能顺利接收通过Quick Tracking应用上报的事件数据。

完整的Quick Tracking埋点数据采集上报,请参见Quick Tracking上报流程

步骤1:购买Quick Tracking

为使事件数据顺利互通,请购买与您的Quick Audience处于相同地域的Quick Tracking

对于公共云Quick Audience,您登录Quick Audience后,可以从浏览器显示的访问地址了解您的Quick Audience地域。公共云Quick Audience的访问地址为:

  • 张家口:quicka.aliyun.com

  • 上海:quicka-shanghai.aliyun.com

  • 深圳:quicka-shenzhen.aliyun.com

重要

由于Quick Tracking仅对张家口、上海两个地域提供服务,若您的Quick Audience地域为深圳,将无法通过Quick Tracking实现事件上报到Quick Audience。

步骤2:Quick Tracking对接Quick Audience

Quick Tracking控制台配置您的Quick Audience系统信息,使Quick Tracking与Quick Audience对接。

重要

请务必按照上一步的说明,购买与Quick Audience同一地域的Quick Tracking,以便实现同地域内对接。

操作步骤:

  1. 登录Quick Tracking控制台,进入管理控制台>系统集成页面,如下图所示。截屏2024-07-04 11

  2. 打开Quick Audience数据互通开关。

  3. 单击编辑配置,填写以下信息。

    参数

    说明

    Accesskey ID

    输入您的Quick Audience组织ID。

    获取Quick Audience组织ID:登录Quick Audience后,进入管理中心>组织管理>组织系统配置页面,复制AccessKey ID,即为此处需要的组织ID。

    OpenAPI URL

    输入您的Quick Audience开放接口的访问地址。

    公共云Quick Audience开放接口的访问地址为:

    • 张家口:quicka-public.cn-zhangjiakou.aliyuncs.com

    • 上海:quicka-public.cn-shanghai.aliyuncs.com

  4. 单击保存

步骤3:配置Quick Tracking应用

Quick Tracking应用是实现数据采集和上报的程序,应用中定义要采集的事件和事件的属性,支持APP、网站、小程序三类应用。

Quick Tracking控制台配置应用及其相关的组织(QT组织相当于QA空间,组织之间数据隔离)、事件、属性等,配置方法请参见采集管理概述

重要

Quick Tracking应用中的事件分为系统预置事件、自定义事件:

  • 配置自定义事件时,请注意以下事项:

    • 若需要在自动化营销中使用上报的数据,请向事件添加外部业务id属性,属性编码为outBizId,值类型为文本型。上报事件数据时传入该属性,数据才可用于自动化营销。

      建议交易相关事件将订单ID上报为outBizId,优惠券相关事件将优惠券ID上报为outBizId。

    • 请注意其事件编码与Quick Audience需要使用该事件的工作空间中的其他事件的事件编码不能重复,否则上报的事件数据可能不被Quick Audience接收。

  • 对于系统预置事件:

    • 由于系统预置事件中暂无外部业务id属性,因此通过系统预置事件上报的数据暂时无法用于自动化营销。

    • 若需要使用系统预置事件上报数据并用于自动化营销,您可以另行配置一个对应的自定义事件。

步骤4:空间关联Quick Tracking应用

Quick Audience组织管理员将工作空间与Quick Tracking应用关联,就是将Quick Tracking应用中的事件授权给空间,允许空间接收通过Quick Tracking应用上报的事件数据。

说明

一个Quick Tracking应用可以同时授权给多个空间。

操作步骤:

  1. 登录Quick Audience控制台,进入V4版本,单击页面右上角image,选择组织管理>QT事件授权image

  2. 页面展示各空间已授权的Quick Tracking应用,单击空间对应的编辑,页面右侧出现如下弹窗。2

  3. 在弹窗中勾选需要授权的Quick Tracking应用,可多选。

    重要

    由于QT组织之间和QA空间之间同样实施数据隔离,建议一个QT组织下的应用授权在一个QA空间下,即QT组织与QA空间进行一对一授权。

    若两个QT组织各有一个事件编码相同的事件,并且两个事件都被授权到同一个QA空间下,则QA空间将保留最晚接收到的事件元数据,较早接收到的事件元数据将被覆盖。QT组织与QA空间进行一对一授权可以避免上述情况。

  4. 单击确认,将所选应用授权给该空间。

如下图所示,应用授权后,应用中的事件将自动同步到对应空间事件中心页面的事件列表,事件来源显示为Quick Tracking,未上报数据前数据接入方式显示为-,上报后将显示为实际的数据接入方式。

image