流式摄取疑难解答指南

此文档提供有关Adobe Experience Platform上流式摄取的常见问题解答。 有关其他Platform服务(包括所有Platform API中遇到的服务)的问题和疑难解答,请参阅Experience Platform疑难解答指南

Adobe Experience Platform Data Ingestion提供RESTful API,您可以使用它将数据收录到Experience Platform中。 摄取的数据用于几乎实时地更新个别用户档案,使您能够跨多个渠道提供个性化、相关的体验。 请阅读数据摄取概述,了解有关服务和不同摄取方法的详细信息。 有关如何使用流式摄取API的步骤,请阅读流式摄取概述

常见问题解答

以下是有关流摄取的常见问题的列表答案。

我如何知道我发送的负载格式正确?

Data Ingestion 利 Experience Data Model 用(XDM)模式验证传入数据的格式。发送不符合预定义XDM模式结构的数据将导致摄取失败。 有关XDM及其在Experience Platform中的使用的详细信息,请参阅 XDM系统概述

流摄取支持两种验证模式:同步和异步。 每个验证方法处理失败数据的方式都不同。

在开 发过程中应使用同步验证。将删除失败验证的记录,并返回错误消息,说明失败的原因(例如:“XDM消息格式无效”)。

生产 中应使用异步验证。任何未通过验证的格式错误的数据将作为失败的批处理文件发送到Data Lake,稍后可在其中检索以进一步分析。

有关同步和异步验证的详细信息,请参阅流验证概述。 有关如何视图未通过验证的批的步骤,请参阅检索失败批的指南。

我是否可以在将请求有效负荷发送到Platform之前验证它?

请求负载只能在发送到Platform之后才能评估。 执行同步验证时,有效负载将返回已填充的JSON对象,而无效负载将返回错误消息。 在异步验证期间,服务会检测任何格式错误的数据并将其发送到Data Lake,以后可以在中检索它以进行分析。 有关详细信息,请参阅流验证概述

在不支持同步验证的边缘上请求同步验证时,会出现什么情况?

当请求的位置不支持同步验证时,将返回501错误响应。 有关同步验证的详细信息,请参阅流验证概述

如何确保仅从受信任的源收集数据?

Experience Platform 支持安全的数据收集。启用身份验证数据收集后,客户端必须将JSON Web Token(JWT)及其IMS组织ID作为请求标头发送。 有关如何向Platform发送已验证数据的详细信息,请参阅已验证数据收集的指南。

流数据到Real-time Customer Profile的延迟是什么?

流事件通常在60秒内反映在Real-time Customer Profile中。 实际延迟可能因数据量、消息大小和带宽限制而异。

我是否可以在同一API请求中包含多条消息?

您可以将多个消息组合到单个请求有效负荷中,并将它们流化到Platform。 正确使用时,在一个请求中对多个消息进行分组是优化数据操作的绝佳方式。 请阅读有关在请求中发送多条消息的教程以了解更多信息。

如何知道我发送的数据是否被接收?

发送到Platform(成功或以其他方式)的所有数据在数据集中保留之前都会作为批处理文件存储。 批处理状态显示在发送到的数据集中。

您可以通过使用Experience Platform用户界面检查数据集活动来验证数据是否已成功摄取。 单击左侧导航中的​Datasets​以显示列表集。 从显示的列表中选择要流式处理的数据集以打开其​Dataset activity​页面,显示选定时间段内发送的所有批。 有关使用Experience Platform监视数据流的详细信息,请参见监视流数据流的指南。

如果您的数据未能摄取,并且希望从Platform恢复,则可以通过将失败的批次的ID发送到Data Access API来检索失败的批次。 有关详细信息,请参阅检索失败批指南。

为什么我的流数据在数据湖中不可用?

批摄取可能无法到达Data Lake的原因有多种,如格式无效、缺少数据或系统错误。 要确定批处理失败的原因,必须使用Data Ingestion Service API检索批处理并视图其详细信息。 有关检索失败批的详细步骤,请参阅检索失败批指南。

如何分析为API请求返回的响应?

您可以首先检查服务器响应代码以确定您的请求是否被接受,从而解析响应。 如果返回了成功的响应代码,则可查看responses数组对象以确定摄取任务的状态。

成功的单消息API请求返回状态代码200。 成功(或部分成功)的批消息API请求返回状态代码207。

以下JSON是包含两条消息的API请求的示例响应对象:一个成功,一个失败。 成功以流方式传输的消息返回xactionId属性。 失败的消息将返回statusCode属性和包含详细信息的响应message

{
    "inletId": "9b0cb233972f3b0092992284c7353f5eead496218e8441a79b25e9421ea127f5",
    "batchId": "1565638336649:1750:244",
    "receivedTimeMs": 1565638336705,
    "responses": [
        {
            "xactionId": "1565650704337:2124:92:3"
        },
        {
            "statusCode": 400,
            "message": "inletId: [9b0cb233972f3b0092992284c7353f5eead496218e8441a
                79b25e9421ea127f5] 
                imsOrgId: [{IMS_ORG}] 
                Message has unknown xdm format"
        }
    ]
}

为什么我的已发送邮件未被Real-time Customer Profile接收?

如果Real-time Customer Profile拒绝消息,则最可能是由于身份信息不正确所致。 这可能是为身份提供无效值或命名空间的结果。

有两种身份命名空间:默认和自定义。 使用自定义命名空间时,请确保已在Identity Service中注册命名空间。 有关使用默认和自定义命名空间的详细信息,请参阅标识命名空间概述

您可以使用Experience Platform UI查看有关消息接收失败原因的更多信息。 单击左侧导航中的​Monitoring,然后视图​Streaming end-to-end​选项卡,以查看在选定时间段内流化的消息批。

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now