隐私及安全
概述
Mixpanelbelieves in respecting and protecting people’s fundamental online privacy and data rights. Which is why we've built Mixpanel's analysis tools in compliance with industry best-practices and global data regulations like the GDPR and the CCPA.
访问我们的隐私中心了解我们如何遵守各种隐私准则。
将您的数据存储在欧盟
默认情况下,MixPanel通过Google Cloud Platform将用户数据存储在美国服务器上。
但是,Mixpanel还为您提供了通过我们的选择和存储客户的个人数据的选项EU Data Residency Program.
您可以在创建新项目时选择“欧盟数据居住权”选项,并在所有API调用中使用我们的欧盟子域来启用此功能。
API | Standard Server | EU Residency Server |
---|---|---|
摄入API | api.www.jy710.com |
api-eu.www.jy710.com |
查询API | www.jy710.com/api |
eu.www.jy710.com/api |
Raw Data Export API | data.www.jy710.com/api/2.0/export |
data-eu.www.jy710.com/api/2.0/export |
数据管道API | data.www.jy710.com/api/2.0/export |
data-eu.www.jy710.com/api/2.0/export |
Lexicon Schemas API | www.jy710.com/api/app/projects |
eu.www.jy710.com/api/app/projects |
Connectors API | www.jy710.com/api/app/projects |
eu.www.jy710.com/api/app/projects |
使用我们的SDK
Next you'll need to set the server location to EU when initializing the Mixpanel library. You can find instructions for the required config settings for each SDK below:
查询欧盟中的混音板数据
将服务器位置设置为欧盟后,请通知MixPanel,以便我们将您的项目集群设置为mixpanel-prod-eu
.
To do so, reach out to your Relationship Manager, Customer Success Manager, or Account Executive and they can help coordinate this change. Once the setup is complete, you can log into your account ateu.www.jy710.com
and query data in any Mixpanel report.
通过SSO登录
如果您希望IDP启动流量直接为eu.www.jy710.com, prepend "eu." to your postback URL. For example,www.jy710.com/security/login/1需要更改为eu.www.jy710.com/security/login/1.
管理个人数据
Mixpanel删除和检索API已适当,以帮助Mixpanel实施符合《通用数据保护法规》(GDPR)立法概述的要求。
GDPR Request Rate Limits
您可以将每个删除请求最多批量达到2000个不同的ID,最多可用于检索请求100。GDPR API请求的请求费率受到限制。
用户选择退出
While the following API can be used to delete or retrieve personal data as outlined by the GPDR, it is important to also opt users out of subsequent tracking. If tracking using a client-side Mixpanel library, you can opt users out of tracking using Mixpanel's opt-out methods. These are available in the following client-side libraries:
See Mixpanel’s管理个人信息guide for more information on best practices when handling personal information in Mixpanel.
验证
身份验证是通过特定于用户的OAuth令牌进行的,其范围仅包括以下删除和检索API。用户可以从他们的帐号设定通过在Mixpanel的右上方选择其缩写并选择Profile & Preferences,然后是数据和隐私选项卡。Oauth代币有一年的到期。它应在身份验证标头中通过。用户有资格生成OAuth代币,如果他们是project owner,或者如果他们是支持的项目所有者或管理员团队成员角色.
GDPR and CCPA API (v3)
以下检索和删除API调用已更新版本3,并适用于GDPR和CCPA合规性。
Create Retrieval
请求类型:POST
描述:创建数据检索作业。
端点://www.jy710.com/api/app/data-retrievals/v3.0/?token=
Parameters:
Parameter | 参数类型 | 数据类型 | 描述 |
---|---|---|---|
令牌 | URL。通过请求URL传递。 | Query String Parameter | 您的混音板project token. |
独特的_ids | 身体。以JSON BLOB格式通过。 | 弦数 | 与您要导出的数据相关联的不同ID列表。您可以添加到1999年的不同ID。 |
compliance_type | 身体。以JSON BLOB格式通过。 | String | 选择CCPA或GDPR。默认值为GDPR。 |
dipleasure_type | 身体。以JSON BLOB格式通过。 | String | 仅当Compliance_Type = CCPA时才需要。可数据,类别或来源。默认是数据. |
授权:
授权类型 | Pass As | 描述 |
---|---|---|
承载者 | 身体。以JSON BLOB格式通过。 | YourOAuth tokenfor GDPR APIs. |
示例请求:curl“ //www.jy710.com/api/appi/app/data-retrievals/v3.0/?token=591b3354bbb2b2b2b2bdd96f72f23bf56911673”:“ data”,“ dinters_ids”:[“ 1”]}'
示例返回:{“状态”:“确定”,“结果”:[{“状态”:“待处理”,“ dipleasure_type”:“ data”,“ date_requested”:“ 2020-03-09T22:28:55.078315”,“ tracking_id”:“ 1583792934719392965”,“ project_id”:1978118,“ compriance_type”:“ ccpa”,“ destination_url”:null“:null”,“ requesting_user”:“:”[电子邮件保护]“,” dimption_id_count”:1}]}
Check Status of Retrieval
请求类型:得到
描述:检查数据检索作业的状态。
端点://www.jy710.com/api/app/data-retrievals/v3.0/
返回格式:200 ok {“结果”:{“ status”:一个[“待处理”,“登台”,“开始”,“成功”,“失败”,“撤销”,“ not_found”,“ not_found”,“ unknown”,],}}
返回密钥:
Name | 类型 | 描述 |
---|---|---|
待办的 | String | 任务ID从帖子返回。 |
舞台 | String | The staging process of the retrieval task has started. The task can still be canceled during staging. |
开始 | String | 检索任务已经开始,无法取消。 |
SUCCESS | String | 检索任务已完成。 |
失败 | String | 检索任务失败了。检查原始任务输入参数并创建一个新任务。 |
REVOKED | String | 检索任务已通过删除操作取消。 |
NOT_FOUND | String | 找回任务找不到。 |
未知 | String | 找到检索任务时发生错误。 |
Parameters:
Parameter | 参数类型 | 类型 | 描述 |
---|---|---|---|
令牌 | URL。通过请求URL传递。 | Query String Parameter | 您的混音板project token. |
任务ID | URL。通过请求URL传递。 | Query String Parameter | The tracking ID shown in the response. |
授权:
授权类型 | Pass As | 描述 |
---|---|---|
承载者 | 身体。以JSON BLOB格式通过。 | YourOAuth tokenfor GDPR APIs. |
示例请求:curl“ //www.jy710.com/api/app/app/data-retrievals/v3.0/15839589613103662/?token=591b3354bb2b2b2b2b2b2b2b2b2b2b2b2b2b2b23bf23bf23bf569111673111673
示例返回:{"status": "ok", "results": {"status": "PENDING", "result": "", "distinct_ids": ["1"]}}
创建删除任务
请求类型:发布
描述: Creates a task that specifies a list of users in a particular project to delete. This will schedule a deletion job that will delete all data, including events and user profile data, for the users specified by distinct_ids. This deletion job may be canceled until it reaches the STARTED stage. A task can take up to 60 days to complete.
端点://www.jy710.com/api/app/data-deletions/v3.0/?token=
Parameters:
Parameter | 参数类型 | 类型 | 描述 |
---|---|---|---|
令牌 | URL。通过请求URL传递。 | Query String Parameter | 您的混音板project token. |
独特的_ids | 身体。以JSON BLOB格式通过。 | 弦数 | 与您要导出的数据相关联的不同ID列表。您可以添加到1999年的不同ID。 |
compliance_type | 身体。以JSON BLOB格式通过。 | String | 选择CCPA或GDPR。默认值为GDPR。 |
授权:
授权类型 | Pass As | 描述 |
---|---|---|
承载者 | 身体。以JSON BLOB格式通过。 | YourOAuth tokenfor GDPR APIs. |
示例请求:curl“ //www.jy710.com/api/app/data-deletions/v3.0/?token=591b3354bb2b2b2bdd96f72f23bf56911673”:[“ 1”]}'
示例返回:{“状态”:“确定”,“结果”:[{“状态”:“待处理”,“ dipleasure_type”:“ data”,“ date_requested”:“ 2020-03-09T22:28:55.078315”,“ tracking_id”:“ 1583792934719392965”,“ project_id”:1978118,“ compriance_type”:“ ccpa”,“ destination_url”:null“:null”,“ requesting_user”:“:”[电子邮件保护]“,” dimption_id_count”:1}]}
检查删除任务的状态
请求类型:得到
描述: Checks the status of an existing deletion task.
端点://www.jy710.com/api/app/data-deletions/v3.0/
返回格式:“结果”:{“状态”://您将获得以下一个返回的返回[“待处理”,“登台”,“启动”,“成功”,“失败”,“撤销”,“ not_found”,“ not_found”,“”未知“,”,],,}}
返回密钥:
Name | 类型 | 描述 |
---|---|---|
待办的 | String | 任务ID从帖子返回。 |
舞台 | String | 删除任务的登台过程已经开始。该任务在登台期间仍然可以取消。 |
开始 | String | 删除任务已经开始,无法取消。 |
SUCCESS | String | The deletion task is complete. |
失败 | String | The deletion task has failed. Check the original task input parameters and create a new task. |
REVOKED | String | 删除任务已通过删除操作取消。 |
NOT_FOUND | String | The deletion task cannot be found. |
未知 | String | 定位删除任务时发生错误。 |
Parameters:
Parameter | 参数类型 | 类型 | 描述 |
---|---|---|---|
令牌 | URL。通过请求URL传递。 | Query String Parameter | 您的混音板project token. |
任务ID | URL。通过请求URL传递。 | Query String Parameter | The tracking ID shown in the response. |
授权:
授权类型 | Pass As | 描述 |
---|---|---|
承载者 | 身体。以JSON BLOB格式通过。 | YourOAuth tokenfor GDPR APIs. |
示例请求:curl "//www.jy710.com/api/app/data-deletions/v3.0/35bd8477-f71f-4088-af55-c88a6fb4ad4b/?token=591b3354bb2bdd96f72f23bf56911674" -H "Authorization: Bearer vZcErNw8JCq42BZUJyWoZmDWCKBxXc" -d '{"distinct_ids":["1"]}'
示例返回:{"status": "ok", "results": {"status": "PENDING", "result": "", "distinct_ids": ["1"]}}
取消删除
请求类型:DELETE
描述: Cancels an existing deletion task. Deletion jobs can be canceled until the STARTED stage initiates.
端点://www.jy710.com/api/app/data-deletions/v3.0/?token=
返回格式:204 NoContent
或者405 methodsnotallowed
返回密钥:
Name | 类型 | 描述 |
---|---|---|
204 NoContent | Query String Parameter必需的 |
您的混音板project token. |
405 methodsnotallowed | Query String Parameter必需的 |
任务ID从帖子返回。 |
Parameters:
Parameter | 参数类型 | 类型 | 描述 |
---|---|---|---|
令牌 | URL。通过请求URL传递。 | Query String Parameter | 您的混音板project token. |
独特的_ids | 身体。以JSON BLOB格式通过。 | 弦数 | 与您要导出的数据相关联的不同ID列表。您可以添加到1999年的不同ID。 |
授权:
授权类型 | Pass As | 描述 |
---|---|---|
承载者 | 身体。以JSON BLOB格式通过。 | YourOAuth tokenfor GDPR APIs. |
示例请求:curl "//www.jy710.com/api/app/data-deletions/v3.0/?token=591b3354bb2bdd96f72f23bf56911673" -H "Authorization: Bearer vZcErNw8JCq42BZUJyWoZmDWCKBxXc" -d '{"distinct_ids":["1"]}'
示例返回:{“状态”:“ OK”,“结果”:{“ task_id”:“ 35BD8477-F71F-4088-AF55-C88A6FB4AD4A”}}
GDPR and CCPA API (v2)
以下语法仅适用于GDPR和CCPA API的版本2。
创建删除任务
请求类型:POST
创建一个任务,指定要删除特定项目中的用户列表。这将安排一个删除作业,该作业将为Dinters_ID指定的用户删除所有数据,包括事件和用户配置文件。此删除作业可能会被取消,直到达到开始
阶段。一项任务最多可能需要60天才能完成。
URI://www.jy710.com/api/app/data-deletions/v2.0/
Name | 类型 | 描述 |
---|---|---|
令牌 | 查询字符串参数 必需的 |
Mixpanel项目令牌. |
独特的_ids | JSON encoded list 必需的 |
JSON编码要删除的不同用户的列表或别名。将删除与此列表中值相关的所有数据。如果一个值是项目中创建的别名,则将在删除中提交的别名映射的独特_ID,并且与该独立_ID关联的所有数据也将被删除。在我们的帮助中心了解有关别名的更多信息.每个删除请求的限制为2000个不同的_ids,每个检索请求100。 |
返回格式:
201 Created { "results": { {"task_id": GUID} } }
返回密钥:
Name | 类型 | 描述 |
---|---|---|
task_id | string | Reference ID for the deletion task. It can be used to either get the status of or cancel a deletion task using GET or DELETE. |
例子:
$ curl //www.jy710.com/api/app/app/data-deletions/v2.0/?token= \ -h'授权:bearer '\ -h -h content -type:application/json application/json'\ -d'{“ dimption_ids”:[“ Hello”,“ world”]}'{“结果”:{“ task_id”:“ F5D3A418-A3D1-4177-8104-8104-19BB555799AF3A”}}}
Cancel a Deletion Task
请求类型:DELETE
Cancels an existing deletion task. Deletion jobs can be canceled until the开始
舞台发起。
URI://www.jy710.com/api/app/data-deletions/v2.0/task_id
Parameter | 类型 | 描述 |
---|---|---|
令牌 | 查询字符串参数 必需的 |
Mixpanel项目令牌. |
task_id | URL参数 必需的 |
任务ID从帖子返回。 |
返回格式:204 NoContent
或者405 methodsnotallowed
返回密钥:
价值 | 描述 |
---|---|
204 NoContent | Successful Cancelation. |
405 methodsnotallowed | Deletion has already begun. |
例子:
$ curl //www.jy710.com/api/app/app/data-deletions/v2.0/task_id?token= \ -h'授权:bearer '\ -x delete
Check the Status of a Deletion Task
请求类型:得到
检查现有删除任务的状态。
URI://www.jy710.com/api/app/data-deletions/v2.0/task_id
Parameter | 类型 | 描述 |
---|---|---|
令牌 | 查询字符串参数 必需的 |
Mixpanel项目令牌. |
task_id | URL参数 必需的 |
任务ID从帖子返回。 |
返回格式:
200 ok {“结果”:{“ status”:一个[“待处理”,“登台”,“开始”,“成功”,“失败”,“撤销”,“ not_found”,“ not_found”,“ unknown”,],}}
返回密钥:
Name | 类型 | 描述 |
---|---|---|
待办的 | string | 任务ID从帖子返回。 |
舞台 | string | 删除任务的登台过程已经开始。该任务在登台期间仍然可以取消。 |
开始 | string | 删除任务已经开始,无法取消。 |
SUCCESS | string | The deletion task is complete. |
失败 | string | The deletion task has failed. Check the original task input parameters and create a new task. |
REVOKED | string | 删除任务已通过删除操作取消。 |
NOT_FOUND | string | The deletion task cannot be found. |
未知 | string | 定位删除任务时发生错误。 |
例子:
$ curl //www.jy710.com/api/app/app/data-deletions/v2.0/task_id/?token= \ -h'授权:bearer '“: “待办的”}}
创建检索任务
请求类型:POST
这将安排一个检索作业,该作业将为Dinters_ID指定的用户收集事件和用户配置文件。该工作可能会被取消,直到达到最终状态为止(失败
或者SUCCESS
)。成功的工作的输出将是签名到与项目API Secret加密的ZIP文件的URL。一项任务最多可能需要60天才能完成。
URI://www.jy710.com/api/app/data-retrievals/v2.0/
Parameter | 类型 | 描述 |
---|---|---|
令牌 | 查询字符串参数 必需的 |
Mixpanel项目令牌. |
独特的_id | JSON encoded string 必需的 |
JSON encoded distinct_id or alias of the user whose data to be retrieved. All data associated with the user will be retrieved. If a value is an alias created in the project, the distinct_id that the alias maps to will be submitted in the retrieval, and all data associated with that distinct_id will be retrieved as well.在我们的帮助中心了解有关别名的更多信息. |
返回格式:
201 Created { "results": { {"task_id": GUID} } }
返回密钥:
Name | 类型 | 描述 |
---|---|---|
task_id | string | 检索任务的参考ID。可以使用GET或DELETE来获取或取消检索任务的状态。 |
例子:
$ curl //www.jy710.com/api/appi/app/data-retrievals/v2.0?token= \ -h'授权:bearer '\ -h -h pontent -type:application/json''\ -d'{“ dimption_id”:“ 2”}'{“结果”:{“ task_id”:“ 771627DE-59F5-4AE-AAE4-A0EE-A0EE-C8DCC1A1A150C8}}}
Cancel a Retrieval Task
请求类型:DELETE
取消现有的检索任务。在开始阶段开始之前,可以取消检索工作。
URI://www.jy710.com/api/app/data-retrievals/v2.0/task_id
Parameter | 类型 | 描述 |
---|---|---|
令牌 | 查询字符串参数 必需的 |
Mixpanel项目令牌. |
task_id | URL参数 必需的 |
任务ID从帖子返回。 |
返回格式:204 NoContent
或者405 methodsnotallowed
返回密钥:
价值 | 描述 |
---|---|
204 NoContent | Successful Cancelation. |
405 methodsnotallowed | 检索已经开始。 |
例子:
$ curl //www.jy710.com/api/app/data-retrievals/v2.0/task_id?token= \ -H 'Authorization: Bearer ' \ -X DELETE
Check the Status of a Retrieval Task
请求类型:得到
Checks the status of an existing retrieval task.
URI://www.jy710.com/api/app/data-retrievals/v2.0/task_id
Parameter | 类型 | 描述 |
---|---|---|
令牌 | 查询字符串参数 必需的 |
Mixpanel项目令牌. |
task_id | URL参数 必需的 |
任务ID从帖子返回。 |
返回格式:
200 ok {“结果”:{“ status”:一个[“待处理”,“登台”,“开始”,“成功”,“失败”,},}}
返回密钥:
Name | 类型 | 描述 |
---|---|---|
待办的 | string | 任务ID从帖子返回。 |
开始 | string | 检索任务已经开始,无法取消。 |
SUCCESS | string | 检索任务已完成。 |
失败 | string | 检索任务失败了。检查原始任务输入参数并创建一个新任务。 |
REVOKED | string | 检索任务已通过删除操作取消。 |
例子:
$ curl //www.jy710.com/api/app/data-retrievals/v2.0/task_id/?token= \ -h'授权:bearer “:“成功”,“结果”:“ https://storage.googleapis.com/ ?“}}}
更新 6 months ago