快速入门

概述 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},也称为客户端ID
  • x-gw-ims-org-id: {ORG_ID},也称为组织ID
  • Authorization: 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设置目标。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6