使用 Adobe Customer Journey Analytics API 的第一步

本指南介绍 Adobe Customer Journey Analytics (CJA) API，详细讲解了数据提取、自定义解决方案以及第三方集成。其中包括访问设置、API 密钥、使用 Postman 进行测试、API 调用的分步示例，以及针对首次用户的提示。

您是否刚开始使用 API，并且想知道 Adobe Customer Journey Analytics (CJA) API 能如何帮助您？别担心！在这份适合初学者的指南中，我们将为您介绍基础要点，解析专业术语，并帮助您迈出进入令人兴奋的 CJA API 世界的第一步。

想象一下，能够以编程方式访问和分析 CJA 数据，而无需手动操作。这正是 CJA API 能帮助您做到的！

高效提取数据：通过 API 调用简化数据提取。
构建自定义解决方案：设计并实施针对特定业务需求的自动化报告管道。
无缝连接：凭借强大的集成，实现 CJA 与第三方应用程序之间的顺畅数据流。

将 API 理解成信使，它们负责将您的请求传送到 Adobe 服务器，并以整齐的封装带回结果。

做好成功准备

在进行第一次 API 调用之前，您需要设置适当的访问和权限。首先，确保您已被添加为所在组织的开发人员。然后，验证您是否拥有产品配置文件的访问权限以及相关的必要权限。

步骤 1：获取 API 密钥

登录 Adobe Developer Console。
创建新项目，并将 Customer Journey Analytics API 添加到您的项目，然后选择所需的产品配置文件。
点击 “添加到项目” 并将 Adobe Experience Platform API 也添加到项目中
设置完成后，您将能够在左侧的 “凭据” 选项卡下获取所需的全部信息。

以下是所有 API 请求所需的三个基本标头参数

访问令牌 - 用于确保只有授权用户才能访问数据，并且可以通过点击屏幕快照中突出显示的 “生成访问令牌” CTA 来生成。在 API 请求中，这被称为 Authorization 参数
客户端 ID - 也称为 API 密钥，在 API 请求中被称为 x-api-key
组织 ID - 这在 API 请求中被称为 x-gw-ims-org-id

务必保存这些凭据，它们是解锁 API 功能的钥匙！CJA API 的快速入门部分包含更详细的分步说明。

步骤 2：测试设置

使用 Postman 这一功能强大且用户友好的工具即可很好地测试 API，无需编写任何代码。启动应用程序后，您可以轻松地导入 API 凭据，并开始使用简单的 GET 请求进行试验，以验证连接和身份验证是否正常。建议您从 GET 请求开始 API 测试之旅，因为这是公认较为安全且无破坏性的，它们只是从服务器检索数据，而不会进行任何修改。这不同于其他 HTTP 方法（如 POST、PUT 或 DELETE 请求），后者可能会更改或删除服务器上的数据，因此在测试时应更加谨慎。

进行第一次 API 调用

让我们做些简单的事情：获取 CJA 帐户中可用数据视图的列表。

示例：列出数据视图

端点：
GET https://cja.adobe.io/data/dataviews

标头：

x-api-key: {API_KEY}

x-gw-ims-org-id: {IMS_ORG_ID}

Authorization: Bearer {AUTHORIZATION_TOKEN}

CURL 请求：

curl -X GET "https://cja.adobe.io/data/dataviewsexpansion=name%2Cowner%2Corganization%2Cdescription"\

-H "x-api-key: {API_KEY}" \

-H "x-gw-ims-org-id: {IMS_ORG_ID}" \

-H "Authorization: Bearer {AUTHORIZATION_TOKEN}"

您也可以在CJA API端点文档中使用 “尝试” 功能来尝试这些请求。以下是尝试上述请求的链接。