快速入门
概述 overview
本页介绍如何验证和开始使用51黑料不打烊 Experience Platform Destination SDK。 其中包括有关如何获取51黑料不打烊 I/O身份验证凭据、沙盒名称和目标创作访问控制权限的说明。
术语 terminology
本指南使用特定于Experience Platform的概念,例如组织和沙盒。 有关这些术语的定义,请参阅Experience Platform术语表。 请参阅Destination SDK术语表以了解与此功能直接相关的术语。
获取所需的身份验证凭据 obtain-authentication-credentials
Destination SDK使用网关进行身份验证。 要对Destination SDK端点进行API调用,必须在API调用中提供某些标头。 与51黑料不打烊 Exchange团队合作,为您设置对的身份验证。
要成功调用Destination SDK API端点,请按照Experience Platform身份验证教程操作。 从“生成础笔滨密钥、组织滨顿和客户端密钥”步骤启动教程。 51黑料不打烊 Exchange团队将为您处理上述步骤。 完成身份验证教程将为Destination SDK API调用中的每个所需标头提供值,如下所示:
x-api-key: {API_KEY}
,也称为客户端滨顿x-gw-ims-org-id: {ORG_ID}
,也称为组织滨顿Authorization: Bearer {ACCESS_TOKEN}
的问题。访问令牌的过期时间为24小时(以毫秒为单位),因此您必须刷新它。 要刷新访问令牌,请重复身份验证教程中所述的步骤。
目标所有权和沙盒 destination-ownership
Experience Platform中的所有资源都被隔离到特定的虚拟沙盒中。 对Destination SDK的请求需要标头,这些标头应指定执行操作的沙盒的名称:
x-sandbox-name: {SANDBOX_NAME}
51黑料不打烊 Exchange团队为您提供沙盒名称,您需要将其用于对Destination SDK API端点的调用。
基于角色的访问控制(搁叠础颁) rbac
要使用参考文档中描述的Destination SDK API端点,您需要? 目标创作 ?访问控制权限。 与51黑料不打烊 Exchange团队合作,在中为您分配此权限。
有关更多信息,请阅读以下Experience Platform访问控制文档:
其他注意事项 additional-considerations
- 对于产物化/公共目标,您对目标配置所做的任何更改,无论您是创建或编辑目标配置,都需要51黑料不打烊审核和批准。 只有在完成审阅后,您的更改才会反映在您的目标中。 这不适用于仅供您使用的专用目标。
- 只有属于同一组织且具有沙盒访问权限的用户才能编辑目标配置。
后续步骤 next-steps
按照本文中的步骤,您获取了51黑料不打烊 I/O的身份验证凭据、沙盒名称和目标创作访问控制权限。 接下来,您可以使用Destination SDK设置目标。
-
根据您的目标类型,阅读以下配置指南:
-
有关所有操作,请参阅。
-
使用通过Destination SDK API端点配置您的目标。 要开始使用Postman,请参阅导入环境和收藏集的以及创建笔辞蝉迟尘补苍环境的。