LiveRamp - Onboarding 连接

使用 LiveRamp - Onboarding 从Adobe Real-time Customer Data Platform连接到载入受众到 LiveRamp Connect.

用例

为了帮助您更好地了解您应该如何以及何时使用 LiveRamp - Onboarding 目标，以下是Adobe Experience Platform客户可以使用此目标解决的示例用例。

作为营销人员，我希望将受众从Adobe Experience Platform发送到以将身份载入 LiveRamp Connect 这样我就能定位移动设备、开放网络、社交和 CTV 平台，使用 Ramp ID 标识符。

先决条件

此 LiveRamp - Onboarding 连接导出文件，使用 LiveRamp的SFTP 存储。

将数据从Experience Platform发送到之前 LiveRamp - Onboarding，您需要您的 LiveRamp 凭据。 请联系您的 LiveRamp 代表获取您的凭据（如果尚未获取）。

支持的身份

LiveRamp - Onboarding 支持激活身份，如基于PII的标识符、已知标识符和自定义ID，如官方网站所述 LiveRamp文档.

在 映射步骤 在激活工作流中，必须将目标映射定义为自定义属性。

支持的受众

此部分介绍哪些类型的受众可以导出到此目标。

导出类型和频率

有关目标导出类型和频率的信息，请参阅下表。

连接到目标

要连接到此目标，请按照 目标配置教程. 在配置目标工作流中，填写下面两个部分中列出的字段。

验证目标

要向目标进行身份验证，请填写必填字段并选择 连接到目标.

使用密码的SFTP身份验证

• 用户名：您的用户名 LiveRamp - Onboarding 存储位置。
• 密码：您的密码 LiveRamp - Onboarding 存储位置。
• PGP/GPG加密密钥：（可选）您可以附加RSA格式公钥以向导出的文件添加加密。 查看下图中的加密密钥格式正确示例。
  
• 子项ID：如果提供加密密钥，则还必须提供加密 子项ID. 请参阅 LiveRamp 加密文档 以了解如何获取子键ID。

具有SSH密钥身份验证的SFTP

• 用户名：您的用户名 LiveRamp - Onboarding 存储位置。

• SSH密钥：私有 SSH 用于登录到 LiveRamp - Onboarding 存储位置。 私钥必须设置为 Base64 — 编码字符串，且不能受密码保护。

  • 连接您的 SSH 键到 LiveRamp - Onboarding 服务器，您必须通过提交票证 LiveRamp的技术支持门户，并提供您的公钥。 欲知更多信息，请参见 LiveRamp文档.

• PGP/GPG加密密钥：（可选）您可以附加RSA格式公钥以向导出的文件添加加密。 查看下图中的加密密钥格式正确示例。
  

• 子项ID：如果提供加密密钥，则还必须提供加密 子项ID. 请参阅 LiveRamp 加密文档 以了解如何获取子键ID。

填写目标详细信息

要配置目标的详细信息，请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。

• 名称：将来用于识别此目标的名称。
• 描述：可帮助您将来识别此目标的描述。
• 文件夹路径：的路径 LiveRamp uploads 将托管导出文件的子文件夹。 此 uploads 前缀会自动添加到文件夹路径中。 LiveRamp 建议为Adobe Real-Time CDP中的投放创建一个专用的子文件夹，以将文件与其他任何现有的馈送分开，并确保所有自动操作平稳运行。
  • 例如，如果要将文件导出到 uploads/my_export_folder，键入 my_export_folder 在 文件夹路径 字段。
• 压缩格式：选择Experience Platform应用于导出文件的压缩类型。 可用选项包括 GZIP 或 无.

启用警报

您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请阅读以下指南： 使用UI订阅目标警报.

完成提供目标连接的详细信息后，选择 下一个.

激活此目标的受众

读取 将受众数据激活到批量配置文件导出目标 有关将受众激活到此目标的说明。

正在计划

在 正在计划 步骤，使用下面显示的设置为每个受众创建导出计划。

• 文件导出选项： 导出完整文件. 增量文件导出 当前不支持 LiveRamp 目标。
• 频率： 每日
• 日期：根据需要选择导出开始和结束时间。

导出的文件名当前不可由用户配置。 所有导出到 LiveRamp - Onboarding 目标基于以下模板自动命名：

%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%

例如，为名为的组织导出的文件的名称 Luma 可能会与以下内容类似：

Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv

映射属性和身份

在 映射 步骤，您可以选择要为用户档案导出的属性和身份。

在 映射 步骤， 目标字段 映射定义导出的CSV文件中列标题的名称。 您可以通过提供自定义名称将导出文件中的CSV列标题更改为所需的任何友好名称 目标字段.

1. 在 映射 步骤，选择 添加新映射. 您将在屏幕上看到一个新映射行。

   

2. 在 选择源字段 窗口中，选择 选择属性 类别并选择要映射的XDM属性，或选择 选择身份命名空间 类别并选择要映射到目标的标识。

   

3. 在 选择目标字段 窗口中，输入要映射选定源字段的属性名称。 此处定义的属性名称将在导出的CSV文件中反映为列标题。

   

   也可以直接在“ ”中输入属性名称 目标字段.

   

添加所有所需映射后，选择 下一个 并完成激活工作流。

导出的数据/验证数据导出

您的数据将导出到 LiveRamp - Onboarding 您配置的存储位置，如CSV文件。

将文件导出到 LiveRamp - Onboarding 目标，平台为每个目标生成一个CSV文件 合并策略Id.

例如，我们来考虑以下受众：

• 受众A（合并策略1）
• 受众B（合并策略2）
• 受众C（合并策略1）
• 受众D（合并策略1）

Platform会将两个CSV文件导出到 LiveRamp - Onboarding：

• 一个包含受众A、C和D的CSV文件；
• 一个包含受众B的CSV文件。

导出的CSV文件包含具有选定属性和相应受众状态的配置文件，这些配置文件位于单独的列中，并具有属性名称和 audience_namespace:audience_ID 对作为列标题，如以下示例所示：

ATTRIBUTE_NAME, AUDIENCE_NAMESPACE_1_AUDIENCE_ID_1, AUDIENCE_NAMESPACE_2_AUDIENCE_ID_2,..., AUDIENCE_NAMESPACE_X_AUDIENCE_ID_X

导出文件中包含的用户档案可以与以下受众资格状态之一匹配：

• Active：用户档案当前符合受众条件。
• Expired：用户档案不再符合受众条件，而是以前符合条件。
• ""（空字符串）：个人资料从未符合受众条件。

例如，导出的CSV文件包含一个 email 属性，两个源自Experience Platform的受众 分段服务，和一个 已导入 外部受众，可能如下所示：

email,ups_aa2e3d98-974b-4f8b-9507-59f65b6442df,ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f,CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e
abc117@testemailabc.com,active,,
abc111@testemailabc.com,,,active
abc102@testemailabc.com,,,active
abc116@testemailabc.com,active,,
abc107@testemailabc.com,active,expired,active
abc101@testemailabc.com,active,active,

在上例中， ups_aa2e3d98-974b-4f8b-9507-59f65b6442df 和 ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f 部分介绍源自Segmentation Service的受众，而 CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e 描述导入到Platform as a的受众 自定义上传.

因为Platform为每个生成一个CSV文件 合并策略Id，它还会为每个合并策略ID生成单独的数据流运行。

这意味着 已激活身份 和 已接收配置文件 中的量度 数据流运行 系统会为使用相同合并策略的每个受众组聚合页面，而不是为每个受众显示页面。

由于为使用相同合并策略的一组受众生成了数据流，因此受众名称不会显示在 监视仪表板.

将导出的数据上传到LiveRamp

成功将数据导出到 LiveRamp - Onboarding 存储时，您必须将数据上传到 LiveRamp 平台。

有关如何从上传文件的更多信息 LiveRamp - Onboarding 存储到 LiveRamp 受众，请参阅以下文档： 将第一个文件上传到受众时的注意事项.

数据使用和治理

全部 Adobe Experience Platform 目标在处理您的数据时符合数据使用策略。 有关如何执行操作的详细信息 Adobe Experience Platform 实施数据管理，请阅读 数据管理概述.

其他资源

有关如何配置 LiveRamp - Onboarding 存储，请参见 官方文档.