快速入门

概述

本页介绍如何验证并开始使用Adobe Experience Platform Destination SDK。 其中包括有关如何获取Adobe I/O身份验证凭据、沙盒名称和目标创作访问控制权限的说明。

术语

本指南使用平台特定的概念，例如组织和沙盒。 请参阅 Experience Platform术语表 以了解这些术语和其他术语的定义。

获取所需的身份验证凭据

Destination SDK使用 Adobe I/O 用于身份验证的网关。 要对Destination SDK端点进行API调用，必须在API调用中提供某些标头。 与Adobe交换团队合作，为您设置对的身份验证 Adobe Developer控制台.

要成功调用Destination SDKAPI端点，请按照 Experience Platform身份验证教程. 从”开始教程生成API密钥、组织ID和客户端密钥”步骤。 Adobe交换团队将为您处理上述步骤。 完成身份验证教程将提供Destination SDKAPI调用中每个所需标头的值，如下所示：

• x-api-key: {API_KEY}，也称为客户端ID
• x-gw-ims-org-id: {ORG_ID}，也称为组织ID
• Authorization: Bearer {ACCESS_TOKEN}的问题。访问令牌的过期时间为24小时（以毫秒为单位），因此您必须刷新它。 要刷新访问令牌，请重复身份验证教程中所述的步骤。

目标所有权和沙盒

Experience Platform中的所有资源都被隔离到特定的虚拟沙盒中。 请求Destination SDK需要标头，其中指定执行操作的沙盒的名称：

• x-sandbox-name: {SANDBOX_NAME}

Adobe交换团队为您提供沙盒名称，您需要将其用于对Destination SDKAPI端点的调用。

基于角色的访问控制(RBAC)

要使用Destination SDKAPI端点，请参阅 参考文档，您需要 目标创作 访问控制权限。 与AdobeExchange团队合作，在中为您分配此权限 Adobe Admin Console.

有关详细信息，请阅读以下Experience Platform访问控制文档：

• 管理产品配置文件的权限
• Experience Platform的可用权限
• Adobe Admin Console文档

其他注意事项

• 对于产品化/公共目标，您对目标配置所做的任何更改，无论您是创建或编辑目标配置，都需要Adobe审核和批准。 只有在完成审阅后，您的更改才会反映在您的目标中。 这不适用于仅供您使用的专用目标。
• 只有属于同一组织且具有沙盒访问权限的用户才能编辑目标配置。

后续步骤

按照本文中的步骤，您获得了用于Adobe I/O的身份验证凭据、沙盒名称和目标创作访问控制权限。 接下来，您可以使用Destination SDK设置目标。

• 根据您的目标类型，阅读以下配置指南：

  • 使用Destination SDK配置流目标
  • 使用Destination SDK配置基于文件的目标

• 有关所有操作，请参阅 目标创作API文档.

• 使用 目标创作API Postman收藏集 以使用Destination SDKAPI端点配置目标。 要开始使用Postman，请参阅 导入环境和收藏集的步骤 和 有关创建Postman环境的视频指南.