LiveRamp - Onboarding连接 liveramp-onboarding
使用LiveRamp - Onboarding连接将受众从Adobe Real-time Customer Data Platform载入LiveRamp Connect。
用例 use-cases
为了帮助您更好地了解您应如何以及何时使用LiveRamp - Onboarding目标，以下是Adobe Experience Platform客户可以使用此目标解决的示例用例。
作为营销人员，我希望将受众从Adobe Experience Platform发送到将身份载入到LiveRamp Connect中，以便我使用Ramp ID标识符可以在移动设备、打开Web、社交和CTV平台上定位用户。
先决条件 prerequisites
LiveRamp - Onboarding连接使用LiveRamp的SFTP存储导出文件。
在将数据从Experience Platform发送到LiveRamp - Onboarding之前，您需要您的LiveRamp凭据。 请联系您的LiveRamp代表以获取凭据（如果尚未获取）。
支持的身份 supported-identities
LiveRamp - Onboarding支持激活标识，如基于PII的标识符、已知标识符和自定义ID，如官方LiveRamp文档中所述。
在激活工作流的映射步骤中，必须将目标映射定义为自定义属性。
支持的受众 supported-audiences
此部分介绍哪些类型的受众可以导出到此目标。
导出类型和频率 export-type-frequency
有关目标导出类型和频率的信息，请参阅下表。
连接到目标 connect
要连接到此目标，请按照目标配置教程中描述的步骤操作。 在配置目标工作流中，填写下面两个部分中列出的字段。
验证目标 authenticate
要验证到目标，请填写必填字段并选择 连接到目标。
使用密码的SFTP身份验证
-
端口：用于LiveRamp - Onboarding存储位置的端口。 使用与您所在地理位置对应的端口，如下所述：
- NA：使用端口
22 - AU：使用端口
2222
- NA：使用端口
-
用户名： LiveRamp - Onboarding存储位置的用户名。
-
密码： LiveRamp - Onboarding存储位置的密码。
-
PGP/GPG加密密钥：或者，您可以附加RSA格式的公钥以向导出的文件添加加密。 查看下图中的加密密钥格式正确示例。
-
子密钥ID：如果提供加密密钥，则还必须提供加密 子密钥ID。 请参阅LiveRamp 加密文档以了解如何获取子密钥ID。
使用SSH密钥身份验证的 SFTP
-
端口：用于LiveRamp - Onboarding存储位置的端口。 使用与您所在地理位置对应的端口，如下所述：
- EU：使用端口
4222
- EU：使用端口
-
用户名： LiveRamp - Onboarding存储位置的用户名。
-
SSH密钥：用于登录到LiveRamp - Onboarding存储位置的私有SSH密钥。 私钥必须采用Base64编码的字符串格式，且不得受密码保护。
- 若要将您的SSH密钥连接到LiveRamp - Onboarding服务器，您必须通过LiveRamp的技术支持门户提交票证，并提供您的公钥。 请参阅LiveRamp文档中的详细信息。
-
PGP/GPG加密密钥：或者，您可以附加RSA格式的公钥以向导出的文件添加加密。 查看下图中的加密密钥格式正确示例。
-
子密钥ID：如果提供加密密钥，则还必须提供加密 子密钥ID。 请参阅LiveRamp 加密文档以了解如何获取子密钥ID。
填写目标详细信息 destination-details
要配置目标的详细信息，请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。
- 名称：将来用于识别此目标的名称。
- 描述：可帮助您将来识别此目标的描述。
- 区域： LiveRamp SFTP存储实例的地理区域。
- 文件夹路径： LiveRamp
uploads子文件夹的路径，该子文件夹将托管导出的文件。uploads前缀会自动添加到文件夹路径中。 LiveRamp建议为Adobe Real-Time CDP中的投放创建一个专用的子文件夹，以将文件与其他任何现有的馈送分开，并确保所有自动化运行顺利。- 例如，如果要将文件导出到
uploads/my_export_folder，请在 文件夹路径 字段中键入my_export_folder。
- 例如，如果要将文件导出到
- 压缩格式：选择Experience Platform应用于导出文件的压缩类型。 可用选项为 GZIP 或 无。
启用警报 enable-alerts
您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请阅读有关使用UI订阅目标警报的指南。
完成提供目标连接的详细信息后，选择 下一步。
激活此目标的受众 activate
有关将受众激活到此目标的说明，请阅读将受众数据激活到批处理配置文件导出目标。
计划中 scheduling
在计划步骤中，为每个受众创建一个导出计划，其设置如下所示。
- 文件导出选项： 导出完整文件。 目标LiveRamp当前不支持增量文件导出。
- 频率：每日
- 日期：根据需要选择导出开始时间和结束时间。
导出的文件名当前不可由用户配置。 导出到LiveRamp - Onboarding目标的所有文件都会根据以下模板自动命名：
%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%
例如，名为Luma的组织的导出文件的名称可能类似于以下内容：
Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv
映射属性和身份 map
在 映射 步骤中，您可以选择要为配置文件导出哪些属性和身份。
在 映射 步骤中，目标字段 映射定义了导出的CSV文件中的列标头名称。 您可以为 目标字段 提供自定义名称，以将导出文件中的CSV列标题更改为所需的任何友好名称。
-
在 映射 步骤中，选择 添加新映射。 您将在屏幕上看到一个新映射行。
-
在 选择源字段 窗口中，选择 选择属性 类别并选择要映射的XDM属性，或选择 选择身份命名空间 类别并选择要映射到目标的身份。
-
在 选择目标字段 窗口中，输入要映射选定源字段的属性名称。 此处定义的属性名称将在导出的CSV文件中反映为列标题。
也可以直接在 目标字段 中输入属性名称。
添加所有所需映射后，选择 下一步 并完成激活工作流。
导出的数据/验证数据导出 exported-data
您的数据将导出到您配置的LiveRamp - Onboarding存储位置，即CSV文件。
导出的文件最大行数为1000万。 如果所选受众超过1000万行，则Experience Platform每次投放生成多个文件。 如果您希望超过单个文件限制，请联系您的LiveRamp代表，让他们为您配置批量摄取。
将文件导出到LiveRamp - Onboarding目标时，Platform为每个合并策略ID生成一个CSV文件。
例如，我们来考虑以下受众：
- 受众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部分描述了源自分段服务的受众，而CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e描述了作为自定义上传导入到Platform中的受众。
由于Platform为每个合并策略ID生成一个CSV文件，因此它还为每个合并策略ID生成单独的数据流运行。
这意味着数据流运行页面中的 激活的身份 和 接收的用户档案 指标将使用相同合并策略的每个受众组进行聚合，而不是针对每个受众显示。
由于正在为使用相同合并策略的受众组生成数据流运行，因此受众名称不会显示在监视仪表板中。
将导出的数据上传到LiveRamp upload-to-liveramp
将数据成功导出到LiveRamp - Onboarding存储后，必须将数据上传到LiveRamp平台。
有关如何将文件从LiveRamp - Onboarding存储上传到LiveRamp受众的更多信息，请参阅以下文档： 将第一个文件上传到受众时的注意事项。
数据使用和治理 data-usage-governance
在处理您的数据时，所有Adobe Experience Platform目标都符合数据使用策略。 有关Adobe Experience Platform如何实施数据治理的详细信息，请阅读数据治理概述。
其他资源 additional-resources
有关如何配置LiveRamp - Onboarding存储的更多详细信息，请参阅官方文档。
Changelog changelog
此部分捕获此目标连接器的功能和重要文档更新。
| table 0-row-3 1-row-3 2-row-3 layout-auto | ||
|---|---|---|
| 发行月份 | 更新类型 | 描述 |
| 2024 年 3 月 | 功能和文档更新 |
|
| 2023 年 7 月 | 初始版本 | 发布了初始目标版本和文档。 |