You need to enable JavaScript to run this app.
导航
API说明与公共参数
最近更新时间:2025.06.13 14:01:53首次发布时间:2025.06.13 14:01:53
我的收藏
有用
有用
无用
无用

概述

DataFinder坚持严格遵守GDPR和CCPA等隐私法规,我们认为客户应该能够控制其数据,因此我们提供了简单易用的数据删除OpenAPI。您可以通过用户的user_unique_id或ssid标识创建数据删除Job,对DataFinder产品中存储的用户数据进行删除。
数据删除Job创建后的24小时内处于待办状态,此状态下您可以撤销Job。24小时后Job开始执行,此时Job已不可撤销,您可以通过 OpenAPI 随时查看 Job 的状态。
重要说明:使用此API不会阻止已删除的用户继续上报数据。如果想阻止用户进一步上报,需要您在SDK侧进行控制。

联系开通

为了保证您和用户的数据安全以及系统稳定性,目前GDPR用户数据删除功能处于灰度开放中。如果您想使用此功能,需要联系我们开通。(您可以通过服务对接的飞书/微信群或页面右下角的在线客服与我们取得联系)。

使用方法

我们为您提供了python/php/java SDK可以下载使用(请确保您每次使用的是最新SDK,如不确定请下载官方最新版本)。
Python SDK下载后在shell执行以下命令完成安装:

# python 3.x
unzip openapisdk${version}.zip
cd openapisdk${version}/pythonsdk
pip install rangersdk-${version}.tar.gz

API列表

API

说明

创建数据删除Job

创建数据删除Job

检索数据删除Job

检索数据删除Job

撤销数据删除Job

撤销数据删除Job

Job状态说明

状态

说明

PENDING

Job创建24小时内处于待办状态,此时可以撤销

STARTED

Job创建24小时后,会真正开始执行,从此便不可变更和撤销

REVOKED

Job已经被整体撤销,不会被执行

SUCCESS

Job已经执行成功

FAILURE

Job已经执行失败

业务状态码说明

http状态码总是200,以响应体中的业务状态码为准。

business code

说明

200

请求成功

400

请求参数错误或权限不足,以message报错为准

429

当前应用存在未结束的Job,不允许再次创建

FAQ

用户的哪些数据会被删除?

从我们真正开始处理某用户的数据那一刻起,该用户在此之前的事件和用户属性历史数据都会被删除。

数据删除预期完成时间是多久?

根据GDPR规定,我们处理删除请求时不会有任何不必要的延迟,在收到您的删除请求后30天内进行处理,实际完成时间取决于请求的复杂性和数据量。

如何获取数据删除Job的最新状态?

通过调用检索数据删除Job的API主动进行查询,另外我们会在Job创建成功、开始执行、撤销成功、执行完成时,通过站内信的方式通知应用的管理员、所在集团的管理员,以及Job的创建者。

删除成功后是否意味着再也查不到对应的用户数据?

不是,删除的数据范围仅限真正开始处理某用户时应用中待删除的存量数据,不涉及到后续持续上报的新增数据,如果想阻止用户进一步上报,需要您在SDK侧进行控制。

删除成功后用户再次上报数据会被识别为新用户吗?

是的,当成功地将用户数据从我们的系统中删除后,该用户再次上报数据就会被识别为新用户。如果删除过程中用户仍在持续上报数据,删除结束前基于新增数据的新用户识别可能会受到影响。

删除成功后是否会对账单计费产生影响?

不会,已经统计完成的账单不会变更。