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