[Premium]{class="badge positive" title="查看Target Premium中包含的内容。"}

信息源

最近更新： 2026年10月27日

使用信息源将实体导入到Adobe Target Recommendations中。可以使用CSV文件、Google Product Search信息源格式和Adobe Analytics产品分类来发送实体。

信息源概述 concept_D1E9C7347C5D4583AA69B02E79607890

馈送允许您传递实体，或者使用页面上没有提供或不能直接从页面安全发送的信息来扩充您的mbox数据。例如，利润、销货成本(COGS)等。

信息源还允许您将详细的项目信息传递到Recommendations，例如产品ID、类别、名称、消息和其他属性。

您可以从Target产品分类文件或Google Product Search文件中选择要发送到Recommendations服务器的列。

然后，有关每个项目的这些数据段可用于：

显示设计中的值
定义标准包含规则
将项目排序为不同的收藏集
将排除项应用于推荐

可使用信息源或mbox将项目描述传递到Target。如果Target同时使用实体馈送和mbox收集数据，则最新数据将获胜。通常，最新的数据来自 mbox，因为 mbox 的查看频率更高。在极少数情况下，实体源数据和 mbox 数据的时间相同，这时使用 mbox 数据。

馈送列表（推荐 > 馈送）提供了有关您创建的任何馈送的信息。

馈送页面包含以下列：

名称：创建过程中指定的信息源的名称。要编辑信息源的名称，您必须编辑信息源本身。使用新名称保存馈送时，将刷新馈送。
状态：信息源的当前状态。
类型：类型包括CSV、Google Product Feed和Analytics分类。
项目：显示信息源中的项目数。
计划：显示馈送的更新计划：每日、每周、Every 2 Weeks或从不。
上次更新：显示上次更新信息源的日期和时间，以及更新信息源的人员姓名。

单击自定义表图标（）以选择或取消选择要显示的列。

单击信息图标（）可显示显示上次上传日期和馈送URL的卡片。

单击更多操作图标（）可访问以下操作：停用、Edit、复制和删除。

IMPORTANT

上传的实体和实体属性会在61天后过期。这意味着：

您的信息源应至少每月运行一次，以确保您的目录内容不会过期。
从信息源文件中删除项目时，不会从目录中删除该项目。要从目录中删除该项，请通过Target UI或API手动删除该项。或者，修改物料属性（如库存）以确保不考虑物料。

Source类型

可以使用CSV文件、Google Product Search信息源格式和Adobe Analytics产品分类来发送实体。

CSV section_65CC1148C7DD448FB213FDF499D35FCA

您可以使用Adobe专有的CSV上传格式创建.csv文件。该文件包含有关产品的保留属性和自定义属性的显示信息。要上传特定于您的实施的属性，请将标头行中的 CustomN 替换为您要使用的属性的名称。在下面的示例中，entity.Custom1 被替换为 entity.availability。然后，您可以将文件批量上传到 Recommendations 服务器。

与Google信息源格式相比，使用.csv格式具有以下优势：

.csv格式不需要字段映射。
.csv格式支持多值属性（请参阅下面的示例）。
.csv格式支持最多100个自定义属性。如果您需要 100 个以上的自定义属性，则可以使用指定的一组不同的自定义属性创建第二个信息源文件。

如果您的页面上没有mbox，或者希望使用网站上不可用的项目来补充显示信息，请使用批量上传方法来发送显示信息。例如，您可能想要发送不会在您的网站上发布的库存信息。

使用.csv文件、Google产品信息源或Analytics产品分类信息源上传的任何数据都会覆盖数据库中的现有实体属性值。如果您通过 mbox 请求发送价格信息，然后使用文件发送不同的价格值，则文件中的值将覆盖使用 mbox 请求设置的值。一个例外是 categoryId 实体属性，该属性会附加类别值，而不是被覆盖以符合 250 个字符限制。

IMPORTANT

在 .csv 文件中，不要用双引号 (") 引住值，除非是有意为之。如果用双引号引住值，则必须使用另一组双引号将其引住来进行转义。未转义的双引号会导致推荐信息源无法正确加载。

例如，以下语法不正确：

"Apples "Bananas" Grapes"",

以下语法正确：

"Apples ""Bananas"" Grapes""",

NOTE

无法使用空白值覆盖现有值。在其位置传递另一个值以覆盖现有值。对于售价，一种常见解决方案是传入实际的“NULL”或某种其他消息。然后，可以写入一个模板规则，以排除具有该值的项目。

成功上传产品实体约两个小时后，产品将显示在管理界面中。

以下是 .csv 文件的代码示例：

## RECSRecommendations Upload File
## RECS''## RECS'' indicates a Recommendations pre-process header. Please do not remove these lines.
## RECS
## RECSUse this file to upload product display information to Recommendations. Each product has its own row. Each line must contain 19 values and if not all are filled a space should be left.
## RECSThe last 100 columns (entity.custom1 - entity.custom100) are custom. The name 'customN' can be replaced with a custom name such as 'onSale' or 'brand'.
## RECSIf the products already exist in Recommendations then changes uploaded here will override the data in Recommendations. Any new attributes entered here will be added to the product''s entry in Recommendations.
## RECSentity.id,entity.name,entity.categoryId,entity.message,entity.thumbnailUrl,entity.value,entity.pageUrl,entity.inventory,entity.margin,entity.last_updated_by,entity.multi_english,entity.availability,entity.tax_country,entity.tax_region,entity.tax_rate,entity.product_type,entity.item_group_id,entity.color,entity.size,entity.brand,entity.gtin
na3456,RipCurl Watch with Titanium Dial,Watches & Sport,Cutting edge titanium with round case,https://example.com/s7/na3456_Viewer,425,https://example.com/shop/en-us/na3456_RipCurl,24,0.25,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Titanium,44mm,RipCurl,"075380 01050 5"
na3457,RipCurl Watch with Black Dial,Watches & Sport,Cutting edge matte black with round case,https://example.com/s7/na3457_Viewer,275,https://example.com/shop/en-us/na3457_RipCurl,24,0.27,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Black,44mm,RipCurl,"075340 01060 7"

Google section_8EFA98B5BC064140B3F74534AA93AFFF

Google Product Search信息源类型使用Google格式，而不是Adobe专有的CSV格式。您可以重用现有的Google Product Feed将产品数据导入Recommendations。

NOTE

您不需要向Google提交数据。您可以导入自己的数据和计划更新，前提是文件使用预定义的Google属性名称。

Recommendations接受遵循Google信息源规范并使用由Google🔗定义的属性的.xml、.txt和.tsv文件。指定信息源的URL或FTP位置，以便Recommendations服务器可以检索文件并生成您的目录。

NOTE

承载Google馈送的服务器必须允许POST方法。

请牢记以下要求和限制：

仍需要产品页面mbox才能在该页面上显示推荐或跟踪基于查看数的算法的产品查看。
Google信息源不支持自定义属性的多个值。

在保存并激活馈送时，馈送会运行，并且其每日运行时间比初始运行时间晚一个小时。

以下示例显示了.xml格式的Google Product Search馈送：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<feed xmlns="https://www.w3.org/2005/Atom" xmlns:ns2="https://base.google.com/ns/1.0" xmlns:ns3="https://base.google.com/cns/1.0">
    <title>Product Feed</title>
    <link href="https://example.com"/>
    <updated>2017-12-13T08:45:04.918-08:00</updated>
    <author>
        <name>Product Feed Author</name>
    </author>
    <id>https://example.com</id>
    <entry>
        <title>RipCurl Watch with Titanium Dial</title>
        <description>Cutting edge Titanium with Round case</description>
        <ns2:id>na3452</ns2:id>
        <ns2:link>https://example.com/shop/en-us/na3452_RipCurl</ns2:link>
        <ns2:availability>in stock</ns2:availability>
        <ns2:condition>NEW</ns2:condition>
        <ns2:google_product_category>Watches &amp; Sport</ns2:google_product_category>
        <ns2:gtin>075380 01050 5</ns2:gtin>
        <ns2:image_link>https://example.com/s7/na3452_Viewer</ns2:image_link>
        <ns2:mobile_link>https://m.example.com/s7/na3452_Viewer</ns2:mobile_link>
        <ns2:mpn>71050</ns2:mpn>
        <ns2:price>425</ns2:price>
        <ns2:product_review_average>5.0</ns2:product_review_average>
        <ns2:product_review_count>30</ns2:product_review_count>
        <ns2:product_type>Shop by Category > Watches </ns2:product_type>
        <ns2:brand>RipCurl</ns2:brand>
        <ns2:sale_price>375</ns2:sale_price>
        <ns2:tax>
          <ns2:country>US</ns2:country>
          <ns2:region>CA</ns2:region>
          <ns2:rate>9.25</ns2:rate>
          <ns2:tax_ship>y</ns2:tax_ship>
        </ns2:tax>
        <ns2:is_bundle>N</ns2:is_bundle>
    </entry>
    <entry>
        <title>RipCurl Watch with Black Dial</title>
        <description>Cutting edge matte black with Round case</description>
        <ns2:id>na3453</ns2:id>
        <ns2:link>https://example.com/shop/en-us/na3453_RipCurl</ns2:link>
        <ns2:availability>in stock</ns2:availability>
        <ns2:condition>NEW</ns2:condition>
        <ns2:google_product_category>Watches &amp; Sport</ns2:google_product_category>
        <ns2:gtin>075380 013450 5</ns2:gtin>
        <ns2:image_link>https://example.com/s7/na3453_Viewer</ns2:image_link>
        <ns2:mobile_link>https://m.example.com/s7/na3453_Viewer</ns2:mobile_link>
        <ns2:mpn>71050</ns2:mpn>
        <ns2:price>275</ns2:price>
        <ns2:product_review_average>4.8</ns2:product_review_average>
        <ns2:product_review_count>23</ns2:product_review_count>
        <ns2:product_type>Shop by Category > Watches </ns2:product_type>
        <ns2:brand>RipCurl</ns2:brand>
        <ns2:sale_price>249</ns2:sale_price>
        <ns2:tax>
          <ns2:country>US</ns2:country>
          <ns2:region>CA</ns2:region>
          <ns2:rate>9.25</ns2:rate>
          <ns2:tax_ship>y</ns2:tax_ship>
        </ns2:tax>
        <ns2:is_bundle>N</ns2:is_bundle>
    </entry>
</feed>

以下是Google Product Search源.tsv文件的示例代码：

id    title    description    link    price    condition    availability    image_link    tax    shipping_weight    shipping    google_product_category    product_type    item_group_id    color    size    gender    age_group    pattern    brand    gtin    mpn
na3454    RipCurl Watch with Titanium Dial    Cutting edge titanium with round case    https://example.com/shop/en-us/na3454_RipCurl    425    new    in stock    https://example.com/s7/na3452_Viewer    US:CA:9.25:y    1.5 oz    US:::0.00 USD    Watches & Sport    Shop by Category > Watches    dz1    Black    44mm    male    adult    Solid    RipCurl    075380 01050 5    DZ1437
na3455    RipCurl Watch with Black Dial    Cutting edge matte black with round case    https://example.com/shop/en-us/na3455_RipCurl    275    new    in stock    https://example.com/s7/na3452_Viewer    US:CA:9.25:y    1.5 oz    US:::0.00 USD    Watches & Sport    Shop by Category > Watches    dz1    Black    44mm    male    adult    Solid    RipCurl    075340 01060 7    DZ1446

Analytics产品分类 section_79E430D2C75443BEBC9AA0916A337E0A

Adobe Analytics产品分类是唯一可用于推荐的分类。有关此分类文件的详细信息，请参阅 Analytics组件 指南中的关于分类。推荐需要的所有信息并非都可在当前实施中使用，因此，如果要添加到分类文件，请遵循此用户指南。

IMPORTANT

在使用Analytics产品分类将实体数据导入Recommendations之前，请注意，这不是首选方法。

请注意以下事项：

更新实体属性会导致长达 24 小时的额外延迟。
Target仅支持产品分类。 Analytics产品SKU必须映射到与Recommendations entity.id相同的级别。可以使用Adobe Consulting服务来设计自定义Analytics分类。如有疑问，请联系您的客户经理。

创建信息源 steps

可创建一个信息源，以将有关产品或服务的信息插入到 Recommendations 中。

在Target界面中，单击推荐 > 信息源 > 创建信息源。
为您的信息源指定一个描述性名称。
选择Source类型。
- CSV
- Google产品信息源
- Analytics分类
有关CSV和Google产品信息源信息源类型的信息，请参阅信息源概述。您还可以下载模型CSV指南，以帮助您正确设置信息源的格式。

（视情况而定）如果您选择了 CSV 或Google产品信息源，请指定可以访问信息源的位置。

FTP：如果您选择 FTP，请提供 FTP 服务器信息、登录凭据、文件名和 FTP 目录。您可以使用带有SSL的FTP (FTPS)实现更安全的上传。

accordion
支持的FTP服务器设置
必须将 FTP 和 FTPS 设置为使用被动 FTP。对于FTPS，请将服务器配置为接受显式FTPS连接。您可以手动指定启动连接的端口（例如，`ftp://ftp.yoursite.com:2121`）。如果未指定端口，则将使用默认的 FTP 或 FTPS 端口。

+++

SFTP：输入SFTP服务器的主机名或IP地址、端口（默认值： 22）、用户名、目录和文件名。对于身份验证，请提供密码、SSH私钥或两者。

accordion

支持的SFTP服务器设置和限制

身份验证使用密码、SSH私钥或两者。至少需要一个。
客户生成并拥有密钥对。在SFTP用户的authorized_keys文件中安装公钥，然后将私钥作为PEM文本粘贴到Target中。接受的密钥类型为RSA、Ed25519和ECDSA，格式为PEM (-----BEGIN RSA PRIVATE KEY-----)、PKCS#8 (-----BEGIN PRIVATE KEY-----)或OpenSSH (-----BEGIN OPENSSH PRIVATE KEY-----)。
不支持受密码保护的私钥，无法保存信息源。
Target会存储已加密的私钥，并且不再显示。要旋转馈送，请编辑馈送并输入新键。
输入没有sftp://前缀、端口或路径的裸主机名或IP地址。将“端口”字段用于非默认端口。
首次连接时接受服务器主机密钥，无需与Adobe交换指纹。
SFTP在Target界面和Recommendations API中可用，但在旧版Recommendations Classic管理界面中不可用。 Adobe不托管SFTP端点，请使用客户托管的服务器。
SFTP服务器必须可从Internet访问，并允许来自Adobe Target下载地址的入站连接。发布此更新之前，生产IP列表必须由工程部门确认。

+++

URL：如果选择URL，请指定URL。

（视情况而定）如果您选择Analytics分类，请从下拉列表中选择报表包。
单击 下一步 箭头以显示计划选项。
选择一个更新选项：
- 每天
- 每周
- 每2周
- 从不：不计划更新。如果您不希望运行此信息源，请选择此选项。
指定要运行信息源的时间。

此选项基于浏览器中使用的时区。如果您想要使用不同时区的时间，则必须根据您所在的时区计算该时间。
单击 下一步 箭头以显示映射选项，然后指定您希望如何将数据映射到Target定义。
（可选）如果您希望信息源属于某个环境（主机组），请选择该主机组。

默认情况下，信息源属于所有主机组。这可确保此信息源中的项目可在任何环境中使用。有关更多信息，请参阅主机。
单击保存。

创建或编辑馈送后，馈送会立即运行，然后根据您的设置进行更新。馈送在数据可用之前必须同步、处理和索引。检查信息源列表中的信息源状态以了解进度。即使您关闭Target，处理过程仍会继续。

在索引过程中，产品和信息源标题显示在单个值之前，因此您可以在索引完成之前搜索产品并创建收藏集、排除项、设计和活动。

“成功”状态表示已找到文件并已正确解析该文件。其数据仅在索引后才会在Recommendations中可用，这需要一些时间，具体取决于文件大小。失败可能是由于URL或FTP信息不正确、文件缺失或解析错误所致。

信息源状态和指示器 concept_E475986720D1400999868B3DFD14A7A0

有关可能的信息源状态及其指示器的信息。

信息源状态 status

以下是信息源可能具有的几种状态：

状态

描述

正在同步

正在将信息源设置详细信息保存到Target。

同步失败

无法将信息源设置详细信息保存到Target。请重试。

没有运行的信息源

您已创建信息源，但尚未安排该信息源（频率设置为“从不”）。

已计划在 <日期和时间>** 运行

信息源尚未运行，但已计划在指定的日期和时间运行。

正在等待下载

Target正在准备下载信息源文件。

正在下载信息源文件

Target正在下载信息源文件。

正在导入项目

Target正在从信息源文件导入项目。

已在 指定时间 成功导入信息源

Target已将信息源文件导入其内容交付系统。已在内容交付系统中对项目属性进行了更改，这些更改将很快地反映在交付的推荐中。如果没有看到预期的更改，请重试并刷新包含推荐的页面。
注意：

如果对项目属性所做的更改导致项目被排除在推荐之外，则会立即反映该排除项。如果项目是新添加的，或者对属性的更改导致该项目不再从推荐中，则在下一次算法更新之前不会反映此项目，此过程将在24小时内发生。
显示此状态时，更新可能尚未反映在目录搜索 UI中。目录搜索中列出了单独的状态，指示上次更新可搜索目录的时间。

部分导入失败

以前，当所有行均未上传时，馈送仍会被标记为成功。因此，会错误地认为所有行都已上载为信息源，这表明上载成功。

以下是您可能会遇到部分信息源导入的情景：